Pular para o conteúdo principal

Encontrando IDs de Board, Tabela e Coluna

Cada elemento de dados em um Copera Board — cada tabela, cada coluna, cada opção em um dropdown — possui 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 arquivo config.ts. Este guia explica onde encontrar cada um deles.

Por Que os IDs São Importantes​

A Copera utiliza IDs hexadecimais de 24 caracteres para identificar de forma única cada recurso no seu workspace. Ao configurar o SDK, você está informando a ele:

  • Qual board conectar — via o Board ID
  • Qual tabela dentro daquele board contém seus dados — via o Table ID
  • Qual coluna nessa tabela armazena cada campo — via o Column ID

O SDK usa esses IDs para direcionar cada operação de leitura e gravação ao lugar exato. Se qualquer 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 posteriormente. Você só precisa encontrá-los e copiados uma única vez.

Encontrando o Board ID​

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

  1. Na Copera, abra a seção Collaborate na barra lateral.

  2. Clique no seu Board para abri-lo.

  3. Observe a URL no seu navegador. Ela será similar a esta:

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

  4. O Board ID é o segmento de 24 caracteres que aparece após /boards/. No exemplo acima, é 6978de1a2d60e272dda083a1.

Como alternativa, você pode encontrar o Board ID pelo diálogo de configurações do Board:

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

Cada ID na Copera tem exatamente 24 caracteres hexadecimais (dígitos de 0 a 9 e letras de a a f). Se o que você copiou parece mais curto ou mais longo, verifique se selecionou o segmento completo.

Encontrando os Table IDs​

Cada Board pode conter múltiplas 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 Configurações da Tabela para ver o ID lá.

dica

Se o seu board possui duas tabelas — por exemplo, Users e Tickets — abra cada tabela por vez, copie o ID da URL e rotule-os claramente em um arquivo de texto antes de continuar.

Encontrando os 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ê deseja identificar.
  2. Um menu de contexto ou popover de configurações será exibido.
  3. Clique em Configurações da Coluna (ou no ícone de engrenagem, se estiver visível no cabeçalho).
  4. O painel de configurações da coluna abre. O Column ID é exibido lá — é o mesmo valor hexadecimal de 24 caracteres usado em todo o resto da Copera.
  5. Copie o Column ID e cole no seu config.ts.

Repita esse processo para cada coluna que sua aplicação precisar ler ou gravar.

Encontrando os IDs das Opções de Select​

Quando sua aplicação precisar filtrar linhas por uma opção específica de dropdown ou status — por exemplo, mostrando apenas tickets com status open, ou verificando se o papel de um usuário é admin — você também precisará do Option ID para aquele valor específico.

Para encontrar os Option IDs de uma coluna Select ou Status:

  1. Clique no cabeçalho da coluna para abrir o painel de configurações.
  2. Procure a seção Opções ou Opções de Status dentro das configurações.
  3. Cada opção (por exemplo, "Open", "In Progress", "Closed") possui 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 posteriormente, será necessário retornar a este painel para encontrar os IDs delas.

Entendendo os Tipos de Coluna​

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

Tipo de ColunaFinalidadeNotas para o SDK
TextCampos de texto livre: título, nome, descrição, observaçõesLê e grava strings simples
Select / StatusOpções de dropdown: status, prioridade, tipo, papelGrava um Option ID; lê a opção selecionada
LinkRelacionamentos entre tabelas (ex: ticket vinculado a um usuário)Referencia uma linha em outra tabela pelo seu row ID
PasswordArmazenamento seguro de credenciais; os valores são hasheados ao salvarO SDK gerencia o hash automaticamente via authenticateTableRow
NumberDados numéricos: preço, quantidade, pontuaçãoLê e grava números JavaScript
DateCampos de data: data de vencimento, data de criação, data de resoluçãoLê e grava strings de data no formato ISO
dica

Para colunas Select e Status usadas em filtros ou automações, você precisará tanto do Column ID quanto do Option ID específico do valor que está sendo verificado.

Configurando o config.ts​

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

Veja um exemplo completo para um portal de suporte com uma tabela de Users e uma tabela de 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 exemplo pelos IDs reais que você copiou do seu Copera Board.

dica

Mantenha um documento de referência — como um arquivo de texto ou um aplicativo de notas — com todos os seus IDs claramente rotulados. Isso facilita a atualização do config quando você adicionar novas colunas, e ajuda os assistentes de codificação com IA a entenderem sua estrutura de dados quando você compartilhar o arquivo com eles.

O Que Acontece Quando Você Adiciona Novas Colunas​

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

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

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

Páginas Relacionadas​

  • Como Começar — Configure o Starter Application localmente com a configuração do seu Board.
  • Usando IA para Construir — Compartilhe seu config.ts com assistentes de codificação com IA para acelerar o desenvolvimento de funcionalidades.
  • Visão Geral dos Boards — Saiba mais sobre como Boards, Tabelas e Colunas funcionam na Copera.