Board-, Tabellen- und Spalten-IDs finden

Jedes Datenelement in einem Copera Board — jede Tabelle, jede Spalte, jede Dropdown-Option — hat eine eindeutige Kennung. Beim Bauen mit dem @copera.ai/sdk verbinden Sie Ihre Anwendung mit bestimmten Tabellen und Spalten, indem Sie diese IDs in Ihrer config.ts angeben. Dieser Leitfaden erklärt, wo Sie jede finden.

Warum IDs wichtig sind

Copera verwendet 24-stellige hexadezimale IDs, um jede Ressource in Ihrem Workspace eindeutig zu identifizieren. Wenn Sie das SDK konfigurieren, sagen Sie ihm:

• Welches Board verbinden — über die Board-ID
• Welche Tabelle in diesem Board Ihre Daten hält — über die Tabellen-ID
• Welche Spalte in dieser Tabelle jedes Feld speichert — über die Spalten-ID

Das SDK nutzt diese IDs, um jede Lese- und Schreiboperation genau an den richtigen Ort zu leiten. Ist eine ID falsch, findet das SDK Ihre Daten nicht.

tipp

IDs ändern sich nie, auch wenn Sie Board, Tabelle oder Spalte später umbenennen. Sie müssen sie nur einmal finden und kopieren.

Board-ID finden

Der einfachste Weg zur Board-ID ist die Adresszeile des Browsers.

1. In Copera den Abschnitt Collaborate in der Sidebar öffnen.

2. Auf Ihr Board klicken, um es zu öffnen.

3. Die URL im Browser ansehen. Sie sieht ungefähr so aus:

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

4. Die Board-ID ist das 24-stellige Segment nach /boards/. Im Beispiel oben ist es 6978de1a2d60e272dda083a1.

Alternativ finden Sie die Board-ID im Dialog Board Settings:

1. Mit geöffnetem Board auf das Settings-Icon (Zahnrad) im Board-Header klicken oder den Board-Namen in der Sidebar rechtsklicken.
2. Board Settings öffnen.
3. Die Board-ID wird im Einstellungs-Panel angezeigt.

hinweis

Jede ID in Copera ist genau 24 hexadezimale Zeichen (Ziffern 0–9 und Buchstaben a–f). Wenn das Kopierte kürzer oder länger wirkt, prüfen Sie, ob Sie das volle Segment markiert haben.

Tabellen-IDs finden

Jedes Board kann mehrere Tabellen enthalten. Die Tabs oben im Board-Bereich entsprechen den einzelnen Tabellen.

So finden Sie eine Tabellen-ID:

1. Board öffnen und den Tab der gewünschten Tabelle anklicken.

2. Die Tabellen-ID erscheint in der URL direkt nach der Board-ID:

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

   In diesem Beispiel ist 697a1f0bc3e42b8911f204d3 die Tabellen-ID.

3. Sie können auch den Tabellen-Tab rechtsklicken und Table Settings öffnen, um die ID dort zu sehen.

tipp

Hat Ihr Board zwei Tabellen — z. B. Users und Tickets — öffnen Sie jede nacheinander, kopieren Sie die ID aus der URL und beschriften Sie sie klar in einer Textdatei, bevor Sie weitermachen.

Spalten-IDs finden

Spalten-IDs finden Sie im Spalten-Einstellungspanel, das sich beim Klick auf einen Spaltenkopf öffnet.

1. Mit geöffneter Tabelle auf den Spaltenkopf der gewünschten Spalte klicken.
2. Ein Kontextmenü oder Settings-Popover erscheint.
3. Column Settings anklicken (oder das Zahnrad-Icon im Header, falls sichtbar).
4. Das Spalten-Einstellungspanel öffnet sich. Die Column ID wird dort angezeigt — derselbe 24-stellige Hex-Wert wie überall in Copera.
5. Spalten-ID kopieren und in Ihre config.ts einfügen.

Wiederholen Sie das für jede Spalte, die Ihre Anwendung lesen oder schreiben soll.

tipp

Lieber Terminal? Die Copera CLI listet jede Spalte und ihre ID einer Tabelle in einem Befehl:

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

Die Ausgabe enthält die ID jeder Spalte, die Sie direkt in config.ts einfügen können.

Select-Options-IDs finden

Wenn Ihre Anwendung Zeilen nach einer bestimmten Dropdown- oder Status-Option filtern soll — z. B. nur Tickets mit Status open oder die Rolle eines Benutzers mit admin abgleichen — brauchen Sie auch die Option ID für diesen Wert.

So finden Sie Option-IDs für eine Select- oder Status-Spalte:

1. Spaltenkopf klicken, um das Spalten-Einstellungspanel zu öffnen.
2. Den Abschnitt Options oder Status Options in den Einstellungen suchen.
3. Jede Option (z. B. „Open“, „In Progress“, „Closed“) hat eine eigene ID neben ihrem Label.
4. Die ID der Option kopieren, die Ihre Anwendung referenzieren soll.

hinweis

Option-IDs sind ebenfalls stabil — sie ändern sich nicht, wenn Sie die Option umbenennen oder umsortieren. Wenn Sie später neue Optionen hinzufügen, kehren Sie zu diesem Panel zurück, um ihre IDs zu finden.

Spaltentypen verstehen

Wenn Sie Spalten-IDs in Ihre config.ts eintragen, hilft es zu wissen, wofür jeder Spaltentyp gedacht ist. Die Tabelle unten beschreibt die Spaltentypen, die in Custom-Apps mit dem SDK am häufigsten vorkommen:

Spaltentyp	Zweck	SDK-Hinweise
Text	Freitextfelder: Titel, Name, Beschreibung, Notizen	Liest und schreibt plain Strings
Select / Status	Dropdown-Optionen: Status, Priorität, Typ, Rolle	Schreibt eine Options-ID; liest die gewählte Option
Link	Beziehungen zwischen Tabellen (z. B. Ticket mit User-Zeile verknüpft)	Referenziert eine Zeile in einer anderen Tabelle über ihre Zeilen-ID
Password	Sichere Credential-Speicherung; Werte werden beim Speichern gehasht	Das SDK hasht automatisch über authenticateTableRow
Number	Numerische Daten: Preis, Menge, Score	Liest und schreibt JavaScript-Zahlen
Date	Datumsfelder: Fälligkeit, Erstelldatum, Erledigungsdatum	Liest und schreibt ISO-Datumsstrings

tipp

Für Select- und Status-Spalten in Filtern oder Automatisierungen brauchen Sie sowohl die Spalten-ID als auch die spezifische Options-ID des Werts, gegen den Sie matchen.

config.ts einrichten

Sobald Sie alle IDs gesammelt haben, öffnen Sie src/config.ts in Ihrem Projekt und tragen Sie sie ein. Die Datei ist die Single Source of Truth dafür, wie Ihre Anwendung mit Ihrem Copera Board verbunden ist.

Vollständiges Beispiel für ein Support-Portal mit Users- und Tickets-Tabelle:

// 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",
  },
};

Ersetzen Sie jede Platzhalter-ID durch die echten IDs, die Sie aus Ihrem Copera Board kopiert haben.

tipp

Halten Sie ein Referenzdokument — z. B. eine Textdatei oder eine Notizen-App — mit allen klar beschrifteten IDs. So aktualisieren Sie die Config leicht, wenn Sie neue Spalten hinzufügen, und KI-Coding-Assistenten verstehen Ihre Datenstruktur, wenn Sie die Datei teilen.

Was passiert, wenn Sie neue Spalten hinzufügen

Ihr Copera Board kann sich mit der Zeit weiterentwickeln. Wenn Sie nach dem ersten Setup eine neue Spalte in Copera hinzufügen:

1. Einstellungspanel der neuen Spalte öffnen und die Spalten-ID kopieren.
2. Die neue Spalten-ID mit einem beschreibenden Key-Namen im passenden Abschnitt von src/config.ts eintragen.
3. Den API-Controller oder Service, der diesen Ressourcentyp handhabt, aktualisieren, um die neue Spalte zu lesen oder zu schreiben.

Das SDK übernimmt die neue Spalte automatisch beim nächsten Kontakt mit einer Zeile. Keine Schema-Migrationen oder Datenbankänderungen nötig — Ihr Board hält die Struktur, und config.ts ist die einzige Datei, die aktualisiert werden muss.

Verwandte Seiten

• Erste Schritte — Starter Application lokal mit Ihrer Board-Konfiguration einrichten.
• Mit KI-Tools bauen — Teilen Sie Ihre config.ts mit KI-Coding-Assistenten, um Feature-Entwicklung zu beschleunigen.
• Boards — Mehr darüber, wie Boards, Tabellen und Spalten über die Copera Public API funktionieren.