Tables et champs
Les colonnes d'une table forment un ensemble fermé de six types, chacun converti à l'entrée, plus les index qui rendent une ligne retrouvable.
Une table se définit une seule fois, dans Xuda Studio, et tous les endroits qui affichent ses données, la grille de Studio, l'onglet Données du tableau de bord, un programme Get Data ou un appel direct à l'API, lisent les mêmes définitions de champs.
Cette page traite des champs tels que vous les rencontrez en créant et en parcourant une table. Pour la liste complète des propriétés, les index et la façon dont un programme Get Data ou Set Data pointe vers une table, voir Table dans Building Blocks.
Six types de champ, rien d'autre
Chaque champ d'une table est exactement de l'un de six types. Studio affiche chacun avec sa propre icône dans l'en-tête
de la grille plutôt qu'avec un badge texte, car une colonne est étroite et un identifiant de champ comme ORD_Total
occupe déjà l'essentiel de la largeur :
Il n'y a pas de septième type, ni aucun moyen d'en ajouter un personnalisé. Un champ qui ne rentre pas dans ces six,
un bloc de texte enrichi, un fichier, une relation vers une autre table, se modélise comme une string (un
identifiant, un chemin, un blob encodé en JSON) ou un array/object de ceux-ci ; il n'existe pas de type de colonne
de premier ordre distinct pour aucun de ceux-là dans une table.
Ce que chaque type fait réellement d'une valeur
dbs_create et dbs_update convertissent tous deux la valeur que vous envoyez selon le type déclaré du champ avant
de la stocker : mieux vaut donc savoir exactement ce que fait chaque conversion plutôt que de supposer un sens
familier :
string
Tout ce qui n'est pas déjà une chaîne est converti avec une conversion de chaîne simple. Une valeur vide ou absente
est stockée comme "".
number
Number(value) est stocké. Une valeur qui ne se convertit pas en nombre fini retombe sur 0 au lieu de rejeter
l'écriture. Une valeur vide ou absente est aussi stockée comme 0.
boolean
Seule une liste fixe de jetons se lit comme true (Y, 1, true, TRUE, ON, YES), et une autre liste fixe
comme false (N, 0, false, FALSE, OFF, NO) ; tout le reste, y compris une valeur vide, est stocké comme
false.
object
Une chaîne est analysée comme du JSON5 ; une valeur déjà sous forme d'objet est stockée telle quelle. Une valeur vide
ou absente, ou une chaîne qui ne s'analyse pas, est stockée comme {}.
array
Une chaîne est d'abord analysée comme du JSON5 et, en cas d'échec, évaluée comme un littéral JavaScript ; une valeur
déjà sous forme de tableau est stockée telle quelle. Une valeur vide ou absente, ou une chaîne que ni l'une ni l'autre
analyse ne gère, est stockée comme [].
date
Il n'y a pas de traitement dédié des dates à l'entrée : la chaîne que vous envoyez est stockée exactement telle
quelle. Choisissez un seul format, l'ISO 8601 (2026-09-25T00:00:00.000Z) est le choix par défaut le plus sûr,
puisque rien dans la plateforme ne normalise un champ date à votre place, et qu'une table aux formats mélangés se
trie et se filtre de façon incohérente.
Envoyer une valeur qui ne peut pas devenir un nombre valide pour un champ number ne fait pas échouer l'appel : elle
stocke silencieusement 0. Validez vous-même une valeur numérique avant de l'écrire si un 0 serait faux.
Nommer les champs
Aucune règle de nommage n'est imposée au-delà de l'unicité des identifiants de champ dans la table, mais toutes les
tables déjà présentes dans un projet Xuda suivent une convention : préfixer chaque champ avec un court code propre à la
table, de sorte que ORD - Orders produit ORD_Id, ORD_Total, ORD_Status. Cela garde les noms de champs
sans ambiguïté dès qu'une requête, une expression ou un fichier d'import doit référencer plusieurs tables à la fois.
Marquer un champ comme obligatoire
Un champ porte un indicateur obligatoire que vous définissez en le créant, à côté de son type et de son commentaire, pour consigner qu'une ligne n'est pas censée être enregistrée sans valeur à cet endroit.
Les tables ont leur propre état actif/archivé
Indépendamment de l'archivage d'une seule ligne (suppression douce, voir Interroger les données via l'API), une table elle-même peut être active ou archivée en tant que nœud Studio. L'onglet Données du tableau de bord liste les tables d'un projet sous forme de cartes, basculables entre Actives et Archivées, chaque carte affichant le nom de la table et son nombre de lignes actuel. Archiver une table ici est une action côté Studio sur le nœud : c'est une opération différente de l'archivage de lignes à l'intérieur de celle-ci.