Saltar al contenido principal

Cómo encontrar los IDs de Board, Tabla y Columna

Cada elemento de datos en un Board de Copera — cada tabla, cada columna, cada opción de un desplegable — tiene un identificador único. Al construir con el @copera.ai/sdk, conectas tu aplicación a tablas y columnas específicas proporcionando estos IDs en tu archivo config.ts. Esta guía explica dónde encontrar cada uno.

Por qué importan los IDs​

Copera usa IDs hexadecimales de 24 caracteres para identificar de forma única cada recurso de tu workspace. Al configurar el SDK, le estás indicando:

  • A qué board conectarse — mediante el Board ID
  • Qué tabla dentro de ese board contiene tus datos — mediante el Table ID
  • Qué columna de esa tabla almacena cada campo — mediante el Column ID

El SDK usa estos IDs para enrutar cada operación de lectura y escritura exactamente al lugar correcto. Si algún ID es incorrecto, el SDK no podrá encontrar tus datos.

consejo

Los IDs nunca cambian, incluso si renombras el board, la tabla o la columna más adelante. Solo necesitas encontrarlos y copiarlos una vez.

Cómo encontrar tu Board ID​

La forma más fácil de encontrar el Board ID es desde la barra de direcciones del navegador.

  1. En Copera, abre la sección Collaborate en la barra lateral.

  2. Haz clic en tu Board para abrirlo.

  3. Mira la URL en tu navegador. Se verá similar a esto:

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

  4. El Board ID es el segmento de 24 caracteres que aparece después de /boards/. En el ejemplo anterior es 6978de1a2d60e272dda083a1.

Como alternativa, puedes encontrar el Board ID a través del diálogo de Board Settings:

  1. Con el Board abierto, haz clic en el ícono de Settings (engranaje) en el encabezado del board, o haz clic derecho en el nombre del board en la barra lateral.
  2. Abre Board Settings.
  3. El Board ID se muestra en el panel de configuración.
nota

Cada ID en Copera tiene exactamente 24 caracteres hexadecimales (dígitos 0–9 y letras a–f). Si lo que copiaste se ve más corto o más largo, verifica que hayas seleccionado el segmento completo.

Cómo encontrar los Table IDs​

Cada Board puede contener varias tablas. Las pestañas en la parte superior del área del board corresponden a cada tabla.

Para encontrar un Table ID:

  1. Abre tu Board y haz clic en la pestaña de la tabla que necesitas.

  2. El Table ID aparece en la URL inmediatamente después del Board ID:

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

    En este ejemplo, 697a1f0bc3e42b8911f204d3 es el Table ID.

  3. También puedes hacer clic derecho en la pestaña de la tabla y abrir Table Settings para ver el ID allí.

consejo

Si tu board tiene dos tablas — por ejemplo, Users y Tickets — abre cada tabla por turnos, copia su ID desde la URL y etiquétalas claramente en un archivo de texto antes de continuar.

Cómo encontrar los Column IDs​

Los Column IDs se encuentran a través del panel de configuración de la columna, que se abre al hacer clic en el encabezado de una columna.

  1. Con una tabla abierta, haz clic en el encabezado de columna de la columna que quieres identificar.
  2. Aparecerá un menú contextual o un popover de configuración.
  3. Haz clic en Column Settings (o en el ícono de engranaje si es visible en el encabezado).
  4. Se abre el panel de configuración de la columna. El Column ID se muestra allí — es el mismo valor hexadecimal de 24 caracteres que se usa en todo Copera.
  5. Copia el Column ID y pégalo en tu config.ts.

Repite este proceso para cada columna que tu aplicación necesite leer o escribir.

consejo

¿Prefieres la terminal? El Copera CLI puede listar cada columna y su ID para una tabla en un solo comando:

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

La salida incluye el ID de cada columna, que puedes pegar directamente en config.ts.

Cómo encontrar los IDs de las opciones de Select​

Cuando tu aplicación necesita filtrar filas por una opción específica de un desplegable o estado — por ejemplo, mostrar solo los tickets con estado open, o hacer coincidir el rol de un usuario con admin — también necesitas el Option ID de ese valor específico.

Para encontrar los Option IDs de una columna de tipo Select o Status:

  1. Haz clic en el encabezado de la columna para abrir el panel de configuración de la columna.
  2. Busca la sección Options o Status Options dentro de la configuración.
  3. Cada opción (por ejemplo, "Open", "In Progress", "Closed") tiene su propio ID mostrado junto a su etiqueta.
  4. Copia el ID de la opción específica que tu aplicación necesita referenciar.
nota

Los Option IDs también son estables — no cambian si renombras la opción o la reordenas. Si agregas nuevas opciones a una columna más adelante, deberás volver a este panel para encontrar sus IDs.

Entendiendo los tipos de columna​

Cuando agregas Column IDs a tu config.ts, ayuda saber para qué está pensado cada tipo de columna. La siguiente tabla describe los tipos de columna más utilizados en aplicaciones personalizadas construidas con el SDK:

Tipo de columnaPropósitoNotas del SDK
TextCampos de texto libre: título, nombre, descripción, notasLee y escribe cadenas de texto plano
Select / StatusOpciones de desplegable: estado, prioridad, tipo, rolEscribe un option ID; lee la opción seleccionada
LinkRelaciones entre tablas (p. ej., un ticket vinculado a una fila de usuario)Referencia una fila de otra tabla por su row ID
PasswordAlmacenamiento seguro de credenciales; los valores se hashean al guardarEl SDK gestiona el hashing automáticamente mediante authenticateTableRow
NumberDatos numéricos: precio, cantidad, puntuaciónLee y escribe números de JavaScript
DateCampos de fecha: fecha de vencimiento, fecha de creación, fecha de resoluciónLee y escribe cadenas de fecha ISO
consejo

Para las columnas Select y Status usadas en filtros o automatizaciones, necesitarás tanto el Column ID como el Option ID específico del valor con el que vas a comparar.

Cómo configurar config.ts​

Una vez que hayas recopilado todos tus IDs, abre src/config.ts en tu proyecto y complétalos. El archivo actúa como la única fuente de verdad sobre cómo tu aplicación se conecta a tu Board de Copera.

Aquí tienes un ejemplo completo para un portal de soporte con una tabla Users y una tabla 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",
  },
};

Reemplaza cada ID de marcador de posición con los IDs reales que copiaste de tu Board de Copera.

consejo

Mantén un documento de referencia — como un archivo de texto o una app de notas — con todos tus IDs claramente etiquetados. Esto facilita actualizar tu config cuando agregas nuevas columnas, y ayuda a los asistentes de programación con IA a entender la estructura de tus datos cuando compartes el archivo con ellos.

Qué sucede cuando agregas nuevas columnas​

Tu Board de Copera puede evolucionar con el tiempo. Si agregas una nueva columna en Copera después de la configuración inicial:

  1. Abre el panel de configuración de la nueva columna y copia su Column ID.
  2. Agrega el nuevo Column ID a la sección correspondiente de src/config.ts con un nombre de clave descriptivo.
  3. Actualiza el controlador o servicio de la API que gestiona ese tipo de recurso para leer o escribir la nueva columna.

El SDK detectará automáticamente la nueva columna la próxima vez que interactúe con una fila. No se requieren migraciones de esquema ni cambios en la base de datos — tu Board gestiona la estructura, y config.ts es el único archivo que necesita actualizarse.

Páginas relacionadas​

  • Getting Started — Configura la Starter Application localmente con la configuración de tu Board.
  • Building with AI Tools — Comparte tu config.ts con asistentes de programación con IA para acelerar el desarrollo de funciones.
  • Boards — Aprende más sobre cómo funcionan los Boards, las Tablas y las Columnas a través de la Copera Public API.