Aller au contenu
Vérifié

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.

La référence complète du schéma

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.

Un nombre ne rejette jamais une écriture

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.