Tabla de Datos

En Recursos > Tabla de Datos la organización crea tablas propias, con columnas y filas, para guardar datos que las automatizaciones leen y graban: los pedidos creados en una prueba, los números de documento generados por un robot, una lista de clientes para usar en las ejecuciones.

:::note Plan La Tabla de Datos depende del plan (no está en Basic). Sin el recurso, la pantalla indica que la funcionalidad no está habilitada en el plan. :::

Las tablas

La lista muestra cada tabla con el nombre, la descripción, la cantidad de columnas y la fecha de creación. Añadir crea una tabla, con el Nombre de la tabla (obligatorio) y la Descripción. Los íconos de la tarjeta editan y eliminan la tabla; al eliminarla se van también todas sus columnas y filas.

Al hacer clic en la tarjeta se abre la tabla.

Columnas

Gestionar columnas (el ícono de la barra) define la estructura:

1. Escribe el Nombre de la columna.
2. Elige el tipo: Text, Number, Boolean, Date, Date/Time, Select, URL o JSON.
3. Marca Obligatorio, si corresponde, y usa Agregar Columna (o Enter).

Cada columna recibe una Clave, generada a partir del nombre, en minúsculas, sin acentos y con _ en lugar de los espacios: "Número del Pedido" se convierte en numero_del_pedido. La automatización lee y graba el campo por la clave, y la clave no cambia después.

En la lista de columnas puedes editar el nombre, el tipo y si es obligatoria, eliminarla y arrastrarla para cambiar el orden. Cambiar el tipo no convierte los valores ya grabados.

Filas

Las tarjetas Total, Hoy, Esta semana y Este mes cuentan las filas por la fecha de creación; al hacer clic en una se filtra la grilla, y al hacer clic de nuevo se vuelven a mostrar todas.

• Agregar Fila abre un campo para cada columna, en el formato del tipo (casilla de verificación para Boolean, fecha para Date, texto de varias líneas para JSON). Los campos obligatorios deben completarse.
• Cada fila tiene Editar y Eliminar.
• La grilla tiene búsqueda, filtro por columna y la elección de las columnas visibles.
• Exportar CSV descarga todas las filas de la tabla, de las más nuevas a las más antiguas.

Leer y grabar desde la automatización

Endpoints de la API (el ícono de la barra) muestra las llamadas de la API de ejecución para la tabla abierta, con un ejemplo de cuerpo armado a partir de las columnas y el botón Copiar:

Llamada	Qué hace
POST /custom-table/{id}/row	Agrega una fila.
POST /custom-table/{id}/row/bulk	Agrega varias filas a la vez, en { "rows": [ ... ] }.
GET /custom-table/{id}/row	Lista las filas, de las más nuevas a las más antiguas.
PUT /custom-table/{id}/row/{rowId}	Actualiza una fila.
DELETE /custom-table/{id}/row/{rowId}	Elimina una fila.

Las rutas son relativas a la dirección de la API (https://app.protoncloud.com.br/api), y los campos de la fila usan las claves de las columnas.

• En el listado, filter[clave]=valor trae solo las filas con ese valor, y sortBy=clave&sortDir=asc (o desc) cambia el orden.
• La actualización reemplaza la fila entera: envía todos los campos, no solo los que cambiaron.
• La API no verifica los campos obligatorios ni los tipos de las columnas: eso queda a cargo de la automatización.

Permisos y celular

La pantalla tiene permisos propios en el perfil: ver, crear (tablas, columnas y filas), editar y eliminar. La automatización que usa la API necesita los mismos permisos.

La pantalla está pensada para la computadora.