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 opcao em um dropdown — possui um identificador unico. Ao construir com o @copera.ai/sdk, voce conecta sua aplicacao a tabelas e colunas especificas fornecendo esses IDs no arquivo config.ts. Este guia explica onde encontrar cada um deles.

Por Que os IDs Sao Importantes​

A Copera utiliza IDs hexadecimais de 24 caracteres para identificar de forma unica cada recurso no seu workspace. Ao configurar o SDK, voce esta informando a ele:

  • Qual board conectar — via o Board ID
  • Qual tabela dentro daquele board contem 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 operacao de leitura e gravacao ao lugar exato. Se qualquer ID estiver incorreto, o SDK nao conseguira encontrar seus dados.

dica

Os IDs nunca mudam, mesmo que voce renomeie o board, a tabela ou a coluna posteriormente. Voce so precisa encontra-los e copiados uma unica vez.

Encontrando o Board ID​

A forma mais facil de encontrar o Board ID e pela barra de endereco do navegador.

  1. Na Copera, abra a secao Collaborate na barra lateral.

  2. Clique no seu Board para abri-lo.

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

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

  4. O Board ID e o segmento de 24 caracteres que aparece apos /boards/. No exemplo acima, e 6978de1a2d60e272dda083a1.

Como alternativa, voce pode encontrar o Board ID pelo dialogo de configuracoes do Board:

  1. Com o Board aberto, clique no icone de Configuracoes (icone de engrenagem) no cabecalho do board, ou clique com o botao direito no nome do board na barra lateral.
  2. Abra Configuracoes do Board.
  3. O Board ID e exibido no painel de configuracoes.
observação

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

Encontrando os Table IDs​

Cada Board pode conter multiplas tabelas. As abas no topo da area do board correspondem a cada tabela.

Para encontrar um Table ID:

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

  2. O Table ID aparece na URL imediatamente apos o Board ID:

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

    Neste exemplo, 697a1f0bc3e42b8911f204d3 e o Table ID.

  3. Voce tambem pode clicar com o botao direito na aba da tabela e abrir Configuracoes da Tabela para ver o ID la.

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 sao encontrados pelo painel de configuracoes da coluna, que abre quando voce clica no cabecalho de uma coluna.

  1. Com uma tabela aberta, clique no cabecalho da coluna que voce deseja identificar.
  2. Um menu de contexto ou popover de configuracoes sera exibido.
  3. Clique em Configuracoes da Coluna (ou no icone de engrenagem, se estiver visivel no cabecalho).
  4. O painel de configuracoes da coluna abre. O Column ID e exibido la — e 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 aplicacao precisar ler ou gravar.

Encontrando os IDs das Opcoes de Select​

Quando sua aplicacao precisar filtrar linhas por uma opcao especifica de dropdown ou status — por exemplo, mostrando apenas tickets com status open, ou verificando se o papel de um usuario e admin — voce tambem precisara do Option ID para aquele valor especifico.

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

  1. Clique no cabecalho da coluna para abrir o painel de configuracoes.
  2. Procure a secao Opcoes ou Opcoes de Status dentro das configuracoes.
  3. Cada opcao (por exemplo, "Open", "In Progress", "Closed") possui seu proprio ID exibido ao lado do seu rotulo.
  4. Copie o ID da opcao especifica que sua aplicacao precisa referenciar.
observação

Os Option IDs tambem sao estaveis — eles nao mudam se voce renomear a opcao ou reordena-la. Se voce adicionar novas opcoes a uma coluna posteriormente, sera necessario retornar a este painel para encontrar os IDs delas.

Entendendo os Tipos de Coluna​

Ao adicionar Column IDs ao seu config.ts, e util saber para que cada tipo de coluna e destinado. A tabela abaixo descreve os tipos de coluna mais comumente usados em aplicacoes personalizadas construidas com o SDK:

Tipo de ColunaFinalidadeNotas para o SDK
TextCampos de texto livre: titulo, nome, descricao, observacoesLe e grava strings simples
Select / StatusOpcoes de dropdown: status, prioridade, tipo, papelGrava um Option ID; le a opcao selecionada
LinkRelacionamentos entre tabelas (ex: ticket vinculado a um usuario)Referencia uma linha em outra tabela pelo seu row ID
PasswordArmazenamento seguro de credenciais; os valores sao hasheados ao salvarO SDK gerencia o hash automaticamente via authenticateTableRow
NumberDados numericos: preco, quantidade, pontuacaoLe e grava numeros JavaScript
DateCampos de data: data de vencimento, data de criacao, data de resolucaoLe e grava strings de data no formato ISO
dica

Para colunas Select e Status usadas em filtros ou automacoes, voce precisara tanto do Column ID quanto do Option ID especifico do valor que esta sendo verificado.

Configurando o config.ts​

Apos coletar todos os seus IDs, abra src/config.ts no seu projeto e preencha-os. O arquivo atua como a unica fonte de verdade para como sua aplicacao 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 voce copiou do seu Copera Board.

dica

Mantenha um documento de referencia — como um arquivo de texto ou um aplicativo de notas — com todos os seus IDs claramente rotulados. Isso facilita a atualizacao do config quando voce adicionar novas colunas, e ajuda os assistentes de codificacao com IA a entenderem sua estrutura de dados quando voce compartilhar o arquivo com eles.

O Que Acontece Quando Voce Adiciona Novas Colunas​

Seu Copera Board pode evoluir ao longo do tempo. Se voce adicionar uma nova coluna na Copera apos a configuracao inicial:

  1. Abra o painel de configuracoes da nova coluna e copie seu Column ID.
  2. Adicione o novo Column ID a secao relevante do src/config.ts com um nome de chave descritivo.
  3. Atualize o controller ou servico da API que trata aquele tipo de recurso para ler ou gravar a nova coluna.

O SDK automaticamente considerara a nova coluna na proxima vez que interagir com uma linha. Nenhuma migracao de esquema ou alteracao no banco de dados e necessaria — seu Board gerencia a estrutura, e config.ts e o unico arquivo que precisa ser atualizado.

Paginas Relacionadas​

  • Como Comecar — Configure o Starter Application localmente com a configuracao do seu Board.
  • Usando IA para Construir — Compartilhe seu config.ts com assistentes de codificacao com IA para acelerar o desenvolvimento de funcionalidades.
  • Visao Geral dos Boards — Saiba mais sobre como Boards, Tabelas e Colunas funcionam na Copera.