Modèles et champs

Un modèle est la forme d'un type d'enregistrement, comme une page ou un produit. Vous le composez à partir de seize types de champ intégrés, et un modèle qui contient des enregistrements reçoit ses propres requêtes et mutations typées dans votre API.

Seize types de champ

Le texte simple est un type et le texte enrichi en est un autre, appelé prose. Les nombres sont aussi deux types : entier pour les nombres entiers et décimal pour les nombres exacts. Les autres sont booléen, date, JSON, liste, référence et geopoint, trois pour les fichiers et les médias (fichier, image et vidéo), deux sortes de choix, et un champ qui stocke la clé d'un modèle.

Un enum est une liste fixe d'options écrites sur le champ. Un select prend ses options dans les enregistrements d'un autre modèle. L'un comme l'autre peut autoriser plusieurs choix. Un geopoint est indexé quand vous le déclarez, de sorte que les enregistrements peuvent être trouvés par distance.

Entiers et décimaux

Un entier au-delà de ±2^53 est refusé. Un décimal circule sous forme de chaîne et conserve son échelle, de sorte que 19.90 reste 19.90, et un nombre JSON envoyé à un champ décimal est refusé. Le SDK remet un décimal à votre code sous son propre type exact, si bien qu'un prix ne passe jamais par la virgule flottante.

Ce que prend chaque champ

Un champ a une clé, un libellé, un texte d'aide, une valeur par défaut, un indicateur d'obligation et une politique d'accès qui nomme qui peut lire et écrire. Marquez un champ comme interrogeable et il est indexé pour le filtrage et le tri. L'index est reconstruit sur les enregistrements existants quand la modification est publiée.

Modèles d'enregistrements et modèles en ligne

Un modèle contient soit des enregistrements, soit il est en ligne. Un modèle en ligne n'a pas d'enregistrements propres, et sa clé devient un type de champ utilisable dans d'autres modèles.

Console ou code

Définissez un modèle dans la console, avec une commande CLI, ou en code, dans le fichier de config, celui de votre projet, que la CLI pousse. Modifier les champs d'un modèle crée une nouvelle version du schéma, et les versions antérieures peuvent être restaurées.

Lire le détail

La référence des types de champ liste chaque type avec ses options et la forme qu'il renvoie à la lecture.