Pular para o conteúdo principal

Encontrando Board, Table e Column IDs

Cada pedaço de dado em um Copera Board — cada tabela, cada coluna, cada opção em um dropdown — tem um identificador único. Ao construir com o @copera.ai/sdk, você conecta sua aplicação a tabelas e colunas específicas fornecendo esses IDs no seu arquivo config.ts. Este guia explica onde encontrar cada um.

Por Que os IDs Importam​

O Copera usa IDs hexadecimais de 24 caracteres para identificar de forma única cada recurso do seu workspace. Quando você configura o SDK, está dizendo a ele:

  • Qual board conectar — pelo Board ID
  • Qual tabela dentro desse board guarda seus dados — pelo Table ID
  • Qual coluna dessa tabela armazena cada campo — pelo Column ID

O SDK usa esses IDs para rotear cada operação de leitura e escrita exatamente para o lugar certo. Se algum ID estiver incorreto, o SDK não conseguirá encontrar seus dados.

dica

Os IDs nunca mudam, mesmo que você renomeie o board, a tabela ou a coluna mais tarde. Você só precisa encontrá-los e copiá-los uma vez.

Encontrando Seu Board ID​

A maneira mais fácil de encontrar o Board ID é pela barra de endereço do navegador.

  1. No Copera, abra a seção Collaborate na sidebar.

  2. Clique no seu Board para abri-lo.

  3. Olhe a URL no seu navegador. Ela será parecida com esta:

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

  4. O Board ID é o trecho de 24 caracteres que aparece depois de /boards/. No exemplo acima, é 6978de1a2d60e272dda083a1.

Como alternativa, você pode encontrar o Board ID pelo diálogo de Board Settings:

  1. Com o Board aberto, clique no ícone de Settings (ícone de engrenagem) no cabeçalho do board, ou clique com o botão direito no nome do board na sidebar.
  2. Abra Board Settings.
  3. O Board ID é mostrado no painel de configurações.
observação

Todo ID no Copera tem exatamente 24 caracteres hexadecimais (dígitos 0–9 e letras a–f). Se o que você copiou parecer mais curto ou mais longo, verifique se selecionou o trecho completo.

Encontrando Table IDs​

Cada Board pode conter várias tabelas. As abas no topo da área do board correspondem a cada tabela.

Para encontrar um Table ID:

  1. Abra seu Board e clique na aba da tabela que você precisa.

  2. O Table ID aparece na URL imediatamente após o Board ID:

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

    Neste exemplo, 697a1f0bc3e42b8911f204d3 é o Table ID.

  3. Você também pode clicar com o botão direito na aba da tabela e abrir Table Settings para ver o ID lá.

dica

Se o seu board tiver duas tabelas — por exemplo, Users e Tickets — abra cada tabela por vez, copie o ID dela da URL e identifique-as claramente em um arquivo de texto antes de prosseguir.

Encontrando Column IDs​

Os Column IDs são encontrados pelo painel de configurações da coluna, que abre quando você clica no cabeçalho de uma coluna.

  1. Com uma tabela aberta, clique no cabeçalho da coluna que você quer identificar.
  2. Um menu de contexto ou popover de configurações aparecerá.
  3. Clique em Column Settings (ou no ícone de engrenagem, se visível no cabeçalho).
  4. O painel de configurações da coluna abre. O Column ID é exibido ali — é o mesmo valor hexadecimal de 24 caracteres usado em todo o resto do Copera.
  5. Copie o Column ID e cole-o no seu config.ts.

Repita esse processo para cada coluna que sua aplicação precisa ler ou escrever.

dica

Prefere o terminal? A Copera CLI pode listar todas as colunas e seus IDs de uma tabela em um único comando:

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

A saída inclui o ID de cada coluna, que você pode colar direto no config.ts.

Encontrando Select Option IDs​

Quando sua aplicação precisa filtrar linhas por uma opção específica de dropdown ou status — por exemplo, mostrar apenas tickets com status open, ou corresponder a role de um usuário a admin — você também precisa do Option ID daquele valor específico.

Para encontrar Option IDs de uma coluna Select ou Status:

  1. Clique no cabeçalho da coluna para abrir o painel de configurações da coluna.
  2. Procure pela seção Options ou Status Options dentro das configurações.
  3. Cada opção (por exemplo, "Open", "In Progress", "Closed") tem seu próprio ID exibido ao lado do seu rótulo.
  4. Copie o ID da opção específica que sua aplicação precisa referenciar.
observação

Os Option IDs também são estáveis — eles não mudam se você renomear a opção ou reordená-la. Se você adicionar novas opções a uma coluna mais tarde, vai precisar retornar a este painel para encontrar os IDs delas.

Entendendo os Tipos de Coluna​

Ao adicionar Column IDs ao seu config.ts, ajuda saber para que cada tipo de coluna serve. A tabela abaixo descreve os tipos de coluna mais comumente usados em aplicações customizadas construídas com o SDK:

Tipo de ColunaFinalidadeObservações do SDK
TextCampos de texto livre: título, nome, descrição, notasLê e escreve strings simples
Select / StatusOpções de dropdown: status, prioridade, tipo, roleEscreve um option ID; lê a opção selecionada
LinkRelações entre tabelas (ex.: ticket vinculado a uma linha de usuário)Referencia uma linha de outra tabela pelo seu row ID
PasswordArmazenamento seguro de credenciais; os valores são hashed ao salvarO SDK cuida do hashing automaticamente via authenticateTableRow
NumberDados numéricos: preço, quantidade, pontuaçãoLê e escreve números JavaScript
DateCampos de data: data de vencimento, data de criação, data de resoluçãoLê e escreve strings de data ISO
dica

Para colunas Select e Status usadas em filtros ou automações, você vai precisar tanto do Column ID quanto do Option ID específico do valor com o qual está fazendo a correspondência.

Configurando o config.ts​

Depois de coletar todos os seus IDs, abra src/config.ts no seu projeto e preencha-os. O arquivo funciona como a única fonte da verdade de como sua aplicação se conecta ao seu Copera Board.

Aqui está um exemplo completo para um portal de suporte com uma tabela Users e uma tabela 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",
  },
};

Substitua cada ID de placeholder pelos IDs reais que você copiou do seu Copera Board.

dica

Mantenha um documento de referência — como um arquivo de texto ou um app de notas — com todos os seus IDs identificados claramente. Isso facilita atualizar seu config quando você adicionar novas colunas, e ajuda os assistentes de código com IA a entender a estrutura dos seus dados quando você compartilha o arquivo com eles.

O Que Acontece Quando Você Adiciona Novas Colunas​

Seu Copera Board pode evoluir com o tempo. Se você adicionar uma nova coluna no Copera após a configuração inicial:

  1. Abra o painel de configurações da nova coluna e copie o Column ID dela.
  2. Adicione o novo Column ID na seção relevante de src/config.ts com um nome de chave descritivo.
  3. Atualize o controller ou serviço da API que cuida desse tipo de recurso para ler ou escrever a nova coluna.

O SDK vai automaticamente reconhecer a nova coluna na próxima vez que interagir com uma linha. Nenhuma migração de schema ou mudança no banco de dados é necessária — seu Board cuida da estrutura, e o config.ts é o único arquivo que precisa ser atualizado.

Páginas Relacionadas​

  • Primeiros Passos — Configure a Starter Application localmente com a configuração do seu Board.
  • Construindo com Ferramentas de IA — Compartilhe seu config.ts com assistentes de código com IA para acelerar o desenvolvimento de recursos.
  • Boards — Aprenda mais sobre como Boards, Tables e Columns funcionam pela Copera Public API.