Vai al contenuto principale

Trovare Board, Table e Column ID

Ogni pezzo di dato in una Copera Board — ogni table, ogni colonna, ogni opzione in un dropdown — ha un identificatore unico. Quando costruisci con @copera.ai/sdk, colleghi l'applicazione a table e colonne specifiche fornendo questi ID nel file config.ts. Questa guida spiega dove trovare ciascuno.

Perché gli ID contano​

Copera usa ID esadecimali di 24 caratteri per identificare in modo unico ogni risorsa nel workspace. Quando configuri l'SDK, gli stai dicendo:

  • Quale board collegare — tramite il Board ID
  • Quale table dentro quella board contiene i dati — tramite il Table ID
  • Quale colonna in quella table memorizza ogni field — tramite il Column ID

L'SDK usa questi ID per instradare ogni operazione di lettura e scrittura esattamente nel posto giusto. Se un ID è sbagliato, l'SDK non riuscirà a trovare i tuoi dati.

suggerimento

Gli ID non cambiano mai, anche se rinomini board, table o colonna in seguito. Devi trovarli e copiarli una sola volta.

Trovare il Board ID​

Il modo più semplice per trovare il Board ID è dalla barra degli indirizzi del browser.

  1. In Copera, apri la sezione Collaborate nella sidebar.

  2. Clicca sulla Board per aprirla.

  3. Guarda l'URL nel browser. Sarà simile a questo:

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

  4. Il Board ID è il segmento di 24 caratteri che compare dopo /boards/. Nell'esempio sopra è 6978de1a2d60e272dda083a1.

In alternativa, puoi trovare il Board ID tramite il dialog Board Settings:

  1. Con la Board aperta, clicca l'icona Settings (ingranaggio) nell'header della board, oppure fai clic destro sul nome della board nella sidebar.
  2. Apri Board Settings.
  3. Il Board ID è mostrato nel pannello settings.
nota

Ogni ID in Copera è esattamente 24 caratteri esadecimali (cifre 0–9 e lettere a–f). Se ciò che hai copiato sembra più corto o più lungo, verifica di aver selezionato l'intero segmento.

Trovare i Table ID​

Ogni Board può contenere più table. Le tab in alto nell'area board corrispondono a ciascuna table.

Per trovare un Table ID:

  1. Apri la Board e clicca la tab della table di cui hai bisogno.

  2. Il Table ID compare nell'URL subito dopo il Board ID:

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

    In questo esempio, 697a1f0bc3e42b8911f204d3 è il Table ID.

  3. Puoi anche fare clic destro sulla tab della table e aprire Table Settings per vedere l'ID lì.

suggerimento

Se la board ha due table — ad esempio, Users e Tickets — apri ciascuna table a turno, copiane l'ID dall'URL e etichettali chiaramente in un file di testo prima di andare avanti.

Trovare i Column ID​

I Column ID si trovano tramite il pannello column settings, che si apre quando clicchi sull'header di una colonna.

  1. Con una table aperta, clicca sull'header della colonna che vuoi identificare.
  2. Comparirà un context menu o un settings popover.
  3. Clicca Column Settings (o l'icona ingranaggio se visibile nell'header).
  4. Si apre il pannello column settings. Il Column ID è visualizzato lì — è lo stesso valore esadecimale di 24 caratteri usato ovunque in Copera.
  5. Copia il Column ID e incollalo in config.ts.

Ripeti questo processo per ogni colonna che l'applicazione deve leggere o scrivere.

suggerimento

Preferisci il terminale? La Copera CLI può elencare ogni colonna e il suo ID per una table in un solo comando:

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

L'output include l'ID di ogni colonna, che puoi incollare direttamente in config.ts.

Trovare i Select Option ID​

Quando l'applicazione deve filtrare le righe per una specifica opzione dropdown o status — ad esempio, mostrando solo i ticket con status open, o abbinando il ruolo di un utente a admin — ti serve anche l'Option ID per quel valore specifico.

Per trovare gli Option ID di una colonna Select o Status:

  1. Clicca l'header della colonna per aprire il pannello column settings.
  2. Cerca la sezione Options o Status Options nelle settings.
  3. Ogni opzione (ad esempio, "Open", "In Progress", "Closed") ha il proprio ID visualizzato accanto alla label.
  4. Copia l'ID dell'opzione specifica che l'applicazione deve referenziare.
nota

Anche gli Option ID sono stabili — non cambiano se rinomini l'opzione o la riordini. Se aggiungi nuove opzioni a una colonna in seguito, dovrai tornare a questo pannello per trovarne gli ID.

Comprendere i tipi di colonna​

Quando aggiungi Column ID a config.ts, aiuta sapere a cosa è destinato ciascun tipo di colonna. La tabella sotto descrive i tipi di colonna più usati nelle applicazioni custom costruite con l'SDK:

Column TypePurposeSDK Notes
TextFree-text fields: title, name, description, notesReads and writes plain strings
Select / StatusDropdown options: status, priority, type, roleWrites an option ID; reads the selected option
LinkRelationships between tables (e.g., ticket linked to a user row)References a row in another table by its row ID
PasswordSecure credential storage; values are hashed on saveThe SDK handles hashing automatically via authenticateTableRow
NumberNumeric data: price, quantity, scoreReads and writes JavaScript numbers
DateDate fields: due date, created date, resolved dateReads and writes ISO date strings
suggerimento

Per le colonne Select e Status usate in filtri o automazioni, ti serviranno sia il Column ID sia l'Option ID specifico del valore su cui stai facendo match.

Impostare config.ts​

Una volta raccolti tutti gli ID, apri src/config.ts nel progetto e compilali. Il file funge da single source of truth su come l'applicazione si collega alla Copera Board.

Ecco un esempio completo per un support portal con una table Users e una 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",
  },
};

Sostituisci ogni ID placeholder con gli ID reali copiati dalla Copera Board.

suggerimento

Tieni un documento di riferimento — come un file di testo o un'app di note — con tutti gli ID etichettati chiaramente. Questo rende facile aggiornare la config quando aggiungi nuove colonne, e aiuta gli assistenti di coding con IA a capire la struttura dei dati quando condividi il file con loro.

Cosa succede quando aggiungi nuove colonne​

La Copera Board può evolversi nel tempo. Se aggiungi una nuova colonna in Copera dopo il setup iniziale:

  1. Apri il pannello settings della nuova colonna e copiane il Column ID.
  2. Aggiungi il nuovo Column ID alla sezione rilevante di src/config.ts con un key name descrittivo.
  3. Aggiorna il controller o il service API che gestisce quel tipo di risorsa per leggere o scrivere la nuova colonna.

L'SDK prenderà automaticamente la nuova colonna la prossima volta che interagisce con una riga. Non servono migration di schema né cambi al database — la Board gestisce la struttura e config.ts è l'unico file da aggiornare.

Pagine correlate​

  • Primi passi — Configura la Starter Application in locale con la configurazione della Board.
  • Costruire con tool IA — Condividi config.ts con assistenti di coding con IA per accelerare lo sviluppo delle feature.
  • Boards — Approfondisci come funzionano Boards, Tables e Columns tramite la Copera Public API.