Saltar al contenido principal

Encontrar los IDs de Board, Tabla y Columna

Cada pieza de datos en un Copera Board — cada tabla, cada columna, cada opción de un menú desplegable — tiene un identificador único. Cuando construyes 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 espacio de trabajo. Cuando configuras 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, aunque renombres el board, la tabla o la columna más adelante. Solo necesitas encontrarlos y copiarlos una vez.

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. Será similar a esta:

    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.

Alternativamente, puedes encontrar el Board ID a través del diálogo de Configuración del Board:

  1. Con el Board abierto, haz clic en el icono de Configuración (icono de 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, comprueba que seleccionaste el segmento completo.

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 turno, copia su ID de la URL y etiquétalas claramente en un archivo de texto antes de continuar.

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 icono de engranaje si está 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 usado en todos los demás lugares de 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.

Encontrar los IDs de opción de Select​

Cuando tu aplicación necesita filtrar filas por una opción específica de un menú desplegable o de 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 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 necesite referenciar.
nota

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

Entender los tipos de columna​

Cuando añades Column IDs a tu config.ts, ayuda saber para qué está pensado cada tipo de columna. La tabla siguiente describe los tipos de columna más usados 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 menú desplegable: estado, prioridad, tipo, rolEscribe un ID de opción; 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 cifran al guardarEl SDK gestiona el cifrado automáticamente a través de 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 estás comparando.

Configurar config.ts​

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

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 Copera Board.

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 configuración cuando añades 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é ocurre cuando añades nuevas columnas​

Tu Copera Board puede evolucionar con el tiempo. Si añades 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. Añade 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 maneja la estructura, y config.ts es el único archivo que necesita actualizarse.

Páginas relacionadas​

  • Primeros pasos — Configura la Starter Application en local con la configuración de tu Board.
  • Construir con IA — Comparte tu config.ts con asistentes de programación con IA para acelerar el desarrollo de funciones.
  • Resumen de Boards — Aprende más sobre cómo funcionan los Boards, las Tablas y las Columnas en Copera.