Tablas y campos
Las columnas de una tabla son un conjunto cerrado de seis tipos, cada uno convertido al entrar, más los índices que hacen que una fila se pueda encontrar.
Una tabla se define una sola vez, en Xuda Studio, y todos los lugares que muestran sus datos, la cuadrícula de Studio, la pestaña Datos del panel, un programa Get Data o una llamada directa a la API, leen las mismas definiciones de campos.
Esta página trata los campos tal como los encuentras al crear y explorar una tabla. Para la lista completa de propiedades, los índices y cómo un programa Get Data o Set Data apunta a una tabla, consulta Tabla en Building Blocks.
Seis tipos de campo, nada más
Cada campo de una tabla es exactamente uno de seis tipos. Studio muestra cada uno con su propio icono en la
cabecera de la cuadrícula en lugar de una insignia de texto, ya que una columna es estrecha y un id de campo como
ORD_Total ya ocupa casi todo el ancho:
No hay un séptimo tipo, ni forma de añadir uno propio. Un campo que no encaja en estos seis,
un bloque de texto enriquecido, un archivo, una relación con otra tabla, se modela como un string (un id,
una ruta, un blob codificado en JSON) o un array/object de ellos; no existe un tipo de columna
de primera clase aparte para nada de eso en una tabla.
Qué hace realmente cada tipo con un valor
Tanto dbs_create como dbs_update convierten el valor que envías según el tipo declarado del campo antes de
almacenarlo, así que conviene saber exactamente qué hace cada conversión en lugar de suponer un significado
familiar:
string
Todo lo que no sea ya una cadena se convierte con una conversión de cadena simple. Un valor en blanco o
ausente se almacena como "".
number
Se almacena Number(value). Un valor que no se interpreta como un número finito pasa a 0
en lugar de rechazar la escritura. Un valor en blanco o ausente también se almacena como 0.
boolean
Solo una lista fija de tokens se lee como true (Y, 1, true, TRUE, ON, YES), y otra
lista fija como false (N, 0, false, FALSE, OFF, NO); todo lo demás, incluido un valor
en blanco, se almacena como false.
object
Una cadena se interpreta como JSON5; un valor que ya tiene forma de objeto se almacena tal cual. Un valor en
blanco o ausente, o una cadena que no se interpreta, se almacena como {}.
array
Una cadena se interpreta primero como JSON5 y, si eso falla, se evalúa como un literal de JavaScript; un valor
que ya tiene forma de array se almacena tal cual. Un valor en blanco o ausente, o una cadena que ninguna de las
dos interpretaciones maneja, se almacena como [].
date
No hay un tratamiento específico de fechas al entrar: la cadena que envíes se almacena exactamente como se envió.
Elige un formato, ISO 8601 (2026-09-25T00:00:00.000Z) es el valor por defecto más seguro, ya que nada
en la plataforma normaliza un campo de fecha por ti, y una tabla con formatos mezclados se ordena y filtra
de forma incoherente.
Enviar un valor que no puede convertirse en un número válido para un campo number no hace fallar la llamada,
almacena 0 en silencio. Valida tú mismo un valor numérico antes de escribirlo si un 0 fuera incorrecto.
Poner nombre a los campos
No hay una regla de nomenclatura obligatoria más allá de que los ids de campo sean únicos en la tabla, pero todas
las tablas que ya hay en un proyecto de Xuda siguen una convención: prefija cada campo con un código corto de la
propia tabla, de modo que ORD - Orders produce ORD_Id, ORD_Total, ORD_Status. Así los nombres de campo no
resultan ambiguos cuando una consulta, una expresión o un archivo de importación tiene que referirse a varias
tablas a la vez.
Marcar un campo como obligatorio
Un campo lleva un indicador de obligatorio que estableces al definirlo, junto con su tipo y su comentario, para dejar constancia de que una fila no está pensada para guardarse sin un valor ahí.
Las tablas tienen su propio estado activo/archivado
Aparte de que una fila concreta se archive (eliminación lógica, consulta Consultar datos mediante la API), una tabla en sí puede estar activa o archivada como nodo de Studio. La pestaña Datos del panel lista las tablas de un proyecto como tarjetas, que se pueden alternar entre Activas y Archivado, y cada tarjeta muestra el nombre de la tabla y su número actual de filas. Archivar una tabla aquí es una acción de Studio sobre el nodo, y es una operación distinta de archivar filas dentro de ella.