Aller au contenu principal

Trouver les Board, Table et Column IDs

Chaque élément de données dans un Board Copera — chaque table, chaque colonne, chaque option d'un dropdown — a un identifiant unique. Lorsque vous construisez avec le @copera.ai/sdk, vous connectez votre application à des tables et colonnes spécifiques en fournissant ces IDs dans votre fichier config.ts. Ce guide explique où trouver chacun.

Pourquoi les IDs comptent​

Copera utilise des IDs hexadécimaux de 24 caractères pour identifier de façon unique chaque ressource de votre workspace. Lorsque vous configurez le SDK, vous lui indiquez :

  • Quel board connecter — via le Board ID
  • Quelle table au sein de ce board contient vos données — via le Table ID
  • Quelle colonne dans cette table stocke chaque champ — via le Column ID

Le SDK utilise ces IDs pour router chaque opération de lecture et d'écriture exactement au bon endroit. Si un ID est incorrect, le SDK ne pourra pas trouver vos données.

astuce

Les IDs ne changent jamais, même si vous renommez plus tard le board, la table ou la colonne. Vous n'avez besoin de les trouver et de les copier qu'une seule fois.

Trouver votre Board ID​

Le moyen le plus simple de trouver le Board ID est depuis la barre d'adresse du navigateur.

  1. Dans Copera, ouvrez la section Collaborate dans la barre latérale.

  2. Cliquez sur votre Board pour l'ouvrir.

  3. Regardez l'URL dans votre navigateur. Elle ressemblera à ceci :

    https://app.copera.ai/workspace/boards/6978de1a2d60e272dda083a1/...

  4. Le Board ID est le segment de 24 caractères qui apparaît après /boards/. Dans l'exemple ci-dessus, c'est 6978de1a2d60e272dda083a1.

Vous pouvez aussi trouver le Board ID via le dialogue Board Settings :

  1. Avec le Board ouvert, cliquez sur l'icône Settings (icône engrenage) dans l'en-tête du board, ou cliquez droit sur le nom du board dans la barre latérale.
  2. Ouvrez Board Settings.
  3. Le Board ID est affiché dans le panneau de paramètres.
note

Chaque ID dans Copera fait exactement 24 caractères hexadécimaux (chiffres 0–9 et lettres a–f). Si ce que vous avez copié semble plus court ou plus long, vérifiez que vous avez sélectionné le segment complet.

Trouver les Table IDs​

Chaque Board peut contenir plusieurs tables. Les onglets en haut de la zone du board correspondent à chaque table.

Pour trouver un Table ID :

  1. Ouvrez votre Board et cliquez sur l'onglet de la table dont vous avez besoin.

  2. Le Table ID apparaît dans l'URL juste après le Board ID :

    https://app.copera.ai/workspace/boards/6978de1a2d60e272dda083a1/697a1f0bc3e42b8911f204d3/...

    Dans cet exemple, 697a1f0bc3e42b8911f204d3 est le Table ID.

  3. Vous pouvez aussi cliquer droit sur l'onglet de la table et ouvrir Table Settings pour y voir l'ID.

astuce

Si votre board a deux tables — par exemple, Users et Tickets — ouvrez chaque table à tour de rôle, copiez son ID depuis l'URL, et étiquetez-les clairement dans un fichier texte avant de continuer.

Trouver les Column IDs​

Les Column IDs se trouvent via le panneau de paramètres de colonne, qui s'ouvre lorsque vous cliquez sur un en-tête de colonne.

  1. Avec une table ouverte, cliquez sur l'en-tête de colonne de la colonne que vous voulez identifier.
  2. Un menu contextuel ou un popover de paramètres apparaîtra.
  3. Cliquez sur Column Settings (ou l'icône engrenage si visible dans l'en-tête).
  4. Le panneau de paramètres de colonne s'ouvre. Le Column ID y est affiché — c'est la même valeur hexadécimale de 24 caractères utilisée partout ailleurs dans Copera.
  5. Copiez le Column ID et collez-le dans votre config.ts.

Répétez ce processus pour chaque colonne que votre application doit lire ou écrire.

astuce

Vous préférez le terminal ? La CLI Copera peut lister chaque colonne et son ID pour une table en une commande :

copera tables get <table-id> --board <board-id> --json

La sortie inclut l'ID de chaque colonne, que vous pouvez coller directement dans config.ts.

Trouver les Select Option IDs​

Lorsque votre application doit filtrer des lignes par une option spécifique de dropdown ou de status — par exemple, n'afficher que les tickets avec le status open, ou faire correspondre le rôle d'un utilisateur à admin — vous avez aussi besoin de l'Option ID pour cette valeur spécifique.

Pour trouver les Option IDs d'une colonne Select ou Status :

  1. Cliquez sur l'en-tête de colonne pour ouvrir le panneau de paramètres de colonne.
  2. Cherchez la section Options ou Status Options dans les paramètres.
  3. Chaque option (par exemple, « Open », « In Progress », « Closed ») a son propre ID affiché à côté de son libellé.
  4. Copiez l'ID de l'option spécifique que votre application doit référencer.
note

Les Option IDs sont aussi stables — ils ne changent pas si vous renommez l'option ou la réordonnez. Si vous ajoutez plus tard de nouvelles options à une colonne, vous devrez revenir à ce panneau pour trouver leurs IDs.

Comprendre les types de colonnes​

Lorsque vous ajoutez des Column IDs à votre config.ts, il est utile de savoir à quoi chaque type de colonne est destiné. Le tableau ci-dessous décrit les types de colonnes les plus couramment utilisés dans les applications personnalisées construites avec le SDK :

Type de colonneRôleNotes SDK
TextChamps de texte libre : titre, nom, description, notesLit et écrit des chaînes plaines
Select / StatusOptions de dropdown : status, priorité, type, rôleÉcrit un option ID ; lit l'option sélectionnée
LinkRelations entre tables (p. ex. ticket lié à une ligne utilisateur)Référence une ligne dans une autre table par son row ID
PasswordStockage sécurisé d'identifiants ; les valeurs sont hachées à l'enregistrementLe SDK gère le hachage automatiquement via authenticateTableRow
NumberDonnées numériques : prix, quantité, scoreLit et écrit des nombres JavaScript
DateChamps de date : date d'échéance, date de création, date de résolutionLit et écrit des chaînes de date ISO
astuce

Pour les colonnes Select et Status utilisées dans des filtres ou automatisations, vous aurez besoin à la fois du Column ID et de l'Option ID spécifique de la valeur contre laquelle vous faites la correspondance.

Configurer config.ts​

Une fois que vous avez collecté tous vos IDs, ouvrez src/config.ts dans votre projet et renseignez-les. Le fichier agit comme la source unique de vérité pour la façon dont votre application se connecte à votre Board Copera.

Voici un exemple complet pour un portail de support avec une table Users et une table Tickets :

// apps/base-application-api/src/config.ts

export const COPERA_CONFIG = {
  boardId: "6978de1a2d60e272dda083a1",

  usersTable: {
    usersTableId: "697a1f0bc3e42b8911f204d3",
    nameColumnId: "697a1f0bc3e42b8911f204d4",
    identifierColumnId: "697a1f0bc3e42b8911f204d5",
    passwordColumnId: "697a1f0bc3e42b8911f204d6",
    roleColumnId: "697a1f0bc3e42b8911f204d7",
  },

  ticketsTable: {
    ticketsTableId: "697b3a2dc4f53c9a22e315e4",
    titleColumnId: "697b3a2dc4f53c9a22e315e5",
    detailsColumnId: "697b3a2dc4f53c9a22e315e6",
    userColumnId: "697b3a2dc4f53c9a22e315e7",
    statusColumnId: "697b3a2dc4f53c9a22e315e8",
    requestTypeColumnId: "697b3a2dc4f53c9a22e315e9",
  },
};

Remplacez chaque ID de placeholder par les IDs réels que vous avez copiés depuis votre Board Copera.

astuce

Gardez un document de référence — comme un fichier texte ou une app de notes — avec tous vos IDs clairement étiquetés. Cela facilite la mise à jour de votre config lorsque vous ajoutez de nouvelles colonnes, et aide les assistants de code IA à comprendre votre structure de données lorsque vous partagez le fichier avec eux.

Que se passe-t-il lorsque vous ajoutez de nouvelles colonnes​

Votre Board Copera peut évoluer dans le temps. Si vous ajoutez une nouvelle colonne dans Copera après la configuration initiale :

  1. Ouvrez le panneau de paramètres de la nouvelle colonne et copiez son Column ID.
  2. Ajoutez le nouveau Column ID à la section pertinente de src/config.ts avec un nom de clé descriptif.
  3. Mettez à jour le contrôleur ou service API qui gère ce type de ressource pour lire ou écrire la nouvelle colonne.

Le SDK prendra automatiquement en compte la nouvelle colonne la prochaine fois qu'il interagira avec une ligne. Aucune migration de schéma ni changement de base de données n'est requis — votre Board gère la structure, et config.ts est le seul fichier qui doit être mis à jour.

Pages associées​

  • Premiers pas — Configurez la Starter Application en local avec la configuration de votre Board.
  • Construire avec des outils IA — Partagez votre config.ts avec des assistants de code IA pour accélérer le développement de fonctionnalités.
  • Boards — En savoir plus sur le fonctionnement des Boards, Tables et Columns via la Copera Public API.