Aller au contenu principal

Créer une table

Objectif​

Créer une nouvelle table — qui stocke des enregistrements — dans un environnement, prête à recevoir des champs.

Prérequis​

  • Vous êtes connecté avec un rôle de créateur (ou d’administrateur de la plateforme).
  • Vous connaissez l’environnement cible.
  • Vous connaissez le préfixe de l’éditeur propriétaire (par exemple par). Le nom logique de la table doit commencer par ce préfixe.

Étapes​

  1. Dans la barre latérale gauche, choisissez l’environnement dans lequel vous travaillez et la solution à laquelle appartient la table, à l’aide des sélecteurs d’environnement et de solution. Ils définissent votre contexte de travail pour toutes les pages de création ; le préfixe de l’éditeur propriétaire apparaît en dessous (par exemple par_), et chaque table de la solution est placée dans cet espace de noms.
  2. Ouvrez Tables depuis la navigation de la barre latérale.
  3. Saisissez un nom d’affichage (par exemple Invoice). C’est le libellé lisible, au singulier.
  4. Saisissez un nom logique qui commence par le préfixe de l’éditeur de la solution suivi d’un trait de soulignement — par exemple par_invoice. Le nom logique doit être en minuscules, n’utiliser que des lettres, des chiffres et des traits de soulignement, et rester raisonnablement court.
  5. Définissez éventuellement un nom d’affichage au pluriel (par exemple Invoices). Si vous le laissez vide, la plateforme en déduit un à partir du nom d’affichage.
  6. Définissez éventuellement une clé d’icône (par exemple briefcase) issue du jeu d’icônes de la plateforme. L’icône apparaît à côté de la table dans la navigation d’une application ; laissez-la vide pour le symbole par défaut.
  7. Sélectionnez Créer la table.
  8. La nouvelle table apparaît dans la liste des tables de l’environnement, avec un unique champ de nom principal déjà créé. Sélectionnez le nom de la table pour gérer ses champs, ses formulaires et ses vues.

Ce qui se passe en coulisses​

La table est stockée sous forme de métadonnées propres à cet environnement. Un champ de nom principal (un champ texte servant de libellé à chaque enregistrement) est créé automatiquement, et la table de données est construite sur-le-champ dans l’espace de données isolé de cet environnement — elle existe avant même que l’écran ne réponde, prête à recevoir des enregistrements. La table est placée dans l’espace de noms du préfixe de l’éditeur, de sorte que les tables de différents éditeurs n’entrent jamais en conflit.

Dépannage​

  • « … must be lower snake-case and start with the publisher prefix. » — le nom logique doit commencer par {prefix}_ et ne contenir que des lettres minuscules, des chiffres et des traits de soulignement.
  • « … is not a valid publisher prefix. » — le préfixe doit être un court identifiant en minuscules (une lettre suivie d’au plus sept lettres ou chiffres).
  • « An entity named … already exists in this environment. » — choisissez un autre nom logique ; les noms logiques des tables sont uniques au sein d’un environnement.

Scénarios associés​