Pular para o conteúdo principal
Proton v5

Tabela de Dados

Em Recursos > Tabela de Dados a organização cria tabelas próprias, com colunas e linhas, para guardar dados que as automações leem e gravam: os pedidos criados num teste, os números de documento gerados por um robô, uma lista de clientes para usar nas execuções.

:::note Plano A Tabela de Dados depende do plano (não está no Basic). Sem o recurso, a tela mostra que a funcionalidade não está liberada no plano. :::

As tabelas​

A lista mostra cada tabela com o nome, a descrição, a quantidade de colunas e a data de criação. Adicionar cria uma tabela, com o Nome da tabela (obrigatório) e a Descrição. Os ícones do cartão editam e apagam a tabela; apagar leva junto todas as colunas e linhas.

Clicar no cartão abre a tabela.

Colunas​

Gerenciar colunas (o ícone da barra) define a estrutura:

  1. Escreva o Nome da coluna.
  2. Escolha o tipo: Text, Number, Boolean, Date, Date/Time, Select, URL ou JSON.
  3. Marque Obrigatório, se for o caso, e use Adicionar Coluna (ou Enter).

Cada coluna ganha uma Chave, gerada do nome, em minúsculas, sem acento e com _ no lugar dos espaços: "Número do Pedido" vira numero_do_pedido. É pela chave que a automação lê e grava o campo, e ela não muda depois.

Na lista de colunas dá para editar o nome, o tipo e o obrigatório, apagar e arrastar para mudar a ordem. Mudar o tipo não converte os valores já gravados.

Linhas​

Os cartões Total, Hoje, Esta semana e Este mês contam as linhas pela data de criação; clicar num deles filtra a grade, e clicar de novo volta a mostrar todas.

  • Adicionar Linha abre um campo para cada coluna, no formato do tipo (caixa de marcar para Boolean, data para Date, texto de várias linhas para JSON). Os campos obrigatórios precisam ser preenchidos.
  • Cada linha tem Editar e Apagar.
  • A grade tem busca, filtro por coluna e a escolha das colunas visíveis.
  • Exportar CSV baixa todas as linhas da tabela, das mais novas para as mais antigas.

Ler e gravar pela automação​

Endpoints da API (o ícone da barra) mostra as chamadas da API da execução para a tabela aberta, com um exemplo de corpo montado a partir das colunas e o botão Copiar:

ChamadaO que faz
POST /custom-table/{id}/rowAdiciona uma linha.
POST /custom-table/{id}/row/bulkAdiciona várias linhas de uma vez, em { "rows": [ ... ] }.
GET /custom-table/{id}/rowLista as linhas, das mais novas para as mais antigas.
PUT /custom-table/{id}/row/{rowId}Atualiza uma linha.
DELETE /custom-table/{id}/row/{rowId}Apaga uma linha.

Os caminhos são relativos ao endereço da API (https://app.protoncloud.com.br/api), e os campos da linha usam as chaves das colunas.

  • Na listagem, filter[chave]=valor traz só as linhas com aquele valor, e sortBy=chave&sortDir=asc (ou desc) muda a ordem.
  • A atualização substitui a linha inteira: mande todos os campos, não só os que mudaram.
  • A API não confere os obrigatórios nem os tipos das colunas: isso fica a cargo da automação.

Permissões e celular​

A tela tem permissões próprias no perfil: ver, criar (tabelas, colunas e linhas), editar e apagar. A automação que usa a API precisa das mesmas permissões.

A tela é feita para o computador.