Conecta-seEntrar na plataforma

Tabela

Criar e usar tabelas de dados definidas pela própria equipe.

Lógica e processamentoRecurso internoConexão: Sem conexão externa obrigatória

O que faz

Crie e gerencie tabelas de dados personalizadas. Armazene, consulte e manipule dados estruturados dentro dos fluxos. "Consultar linhas" retorna todas as linhas que atendem ao filtro quando o limite não é informado e falha se o resultado passar de 5 MB.

Quando usar: Use quando o seu fluxo precisar criar e usar tabelas de dados definidas pela própria equipe.

Exemplo de situação: Processar os dados antes de seguir para a próxima etapa.

Antes de começar

Conexão necessária: Sem conexão externa obrigatória.

Nenhuma conta externa é obrigatória para usar este bloco.

Passo a passo

  1. Adicione Tabela ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Nenhuma conta externa é obrigatória para usar este bloco.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Para configurar o gatilho

  1. Selecione a tabela a monitorar
  2. Escolha se o gatilho dispara quando linhas são inseridas, atualizadas ou excluídas
  3. Para atualizações, se quiser, selecione colunas específicas a monitorar
  4. O fluxo será disparado automaticamente quando o evento acontecer

Operações

OperaçãoO que faz
Consultar linhasConsulta linhas com o bloco Tabela.
Inserir linhaInsere linha com o bloco Tabela.
Inserir ou atualizar linhaInsere ou atualizar linha com o bloco Tabela.
Inserir linhas em loteInsere linhas em lote com o bloco Tabela.
Atualizar linhas por filtroAtualiza linhas por filtro com o bloco Tabela.
Excluir linhas por filtroExclui linhas por filtro com o bloco Tabela.
Atualizar linha por IDAtualiza linha por ID com o bloco Tabela.
Excluir linha por IDExclui linha por ID com o bloco Tabela.
Buscar linha por IDBusca linha por ID com o bloco Tabela.
Ler esquemaLê esquema com o bloco Tabela.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Consultar linhas · Inserir linha · Inserir ou atualizar linha · Inserir linhas em lote · Atualizar linhas por filtro · Excluir linhas por filtro · Atualizar linha por ID · Excluir linha por ID · Buscar linha por ID · Ler esquema
    Padrão:
    Consultar linhas

  • Tabela

    Obrigatório

    Selecione uma tabela.

    Exemplo:
    (escolha na lista do campo)

  • ID da tabela

    ObrigatórioEm campos adicionais

    Informe o ID da tabela.

    Exemplo:
    id-do-recurso

  • ID da linha

    Obrigatório conforme a operação

    Informa o identificador exato do recurso na plataforma conectada.

    Aparece em:
    Buscar linha por ID, Atualizar linha por ID, Excluir linha por ID
    Exemplo:
    id-do-recurso

  • Dados

    Obrigatório conforme a operação

    Informa dados estruturados ou código no formato exigido pelo campo.

    Aparece em:
    Inserir linha, Inserir ou atualizar linha, Atualizar linha por ID, Atualizar linhas por filtro
    Exemplo:
    { "chave": "valor" }

  • Coluna de correspondência

    Selecione uma coluna única.

    Aparece em:
    Inserir ou atualizar linha
    Exemplo:
    (escolha na lista do campo)

  • Coluna de correspondência

    Em campos adicionais

    Informe o ID da coluna.

    Aparece em:
    Inserir ou atualizar linha

  • Dados das linhas (lista JSON)

    Obrigatório conforme a operação

    Informa dados estruturados ou código no formato exigido pelo campo.

    Aparece em:
    Inserir linhas em lote
    Exemplo:
    { "chave": "valor" }

  • Modo do filtro

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Atualizar linhas por filtro, Excluir linhas por filtro
    Opções:
    Visual · Editor
    Padrão:
    Visual

  • Condições do filtro

    Obrigatório conforme a operação

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Atualizar linhas por filtro, Excluir linhas por filtro
    Exemplo:
    status = 'ativo'

  • Filtro

    Obrigatório conforme a operação

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Atualizar linhas por filtro, Excluir linhas por filtro
    Exemplo:
    status = 'ativo'

  • Modo de entrada

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Consultar linhas
    Opções:
    Visual · Editor
    Padrão:
    Visual

  • Condições do filtro

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Consultar linhas
    Exemplo:
    status = 'ativo'

  • Ordem

    Define a ordem das linhas retornadas: escolha a coluna e se a ordem é crescente ou decrescente; dá para adicionar mais colunas como critério de desempate.

    Aparece em:
    Consultar linhas

  • Ordenação

    Informa dados estruturados ou código no formato exigido pelo campo.

    Aparece em:
    Consultar linhas
    Exemplo:
    { "chave": "valor" }

  • Limite de resultados

    Deixe vazio para todas as linhas (falha acima de 5 MB).

    Aparece em:
    Consultar linhas, Atualizar linhas por filtro, Excluir linhas por filtro
    Exemplo:
    10

  • Posição inicial

    Define um valor numérico, quantidade ou limite da operação.

    Aparece em:
    Consultar linhas
    Padrão:
    0

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <tabela.success>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<tabela.success>booleanIndica se a operação foi concluída com sucesso.
<tabela.row>jsonDados de uma linha.
<tabela.operation>stringOperação realizada (insert ou update).
<tabela.rows>arrayLista de linhas.
<tabela.rowCount>numberLinhas retornadas (consulta) ou total de linhas na tabela (ler esquema).
<tabela.totalCount>numberTotal de linhas que atendem ao filtro.
<tabela.insertedCount>numberNúmero de linhas inseridas.
<tabela.updatedCount>numberNúmero de linhas atualizadas.
<tabela.updatedRowIds>arrayIDs das linhas atualizadas.
<tabela.deletedCount>numberNúmero de linhas excluídas.
<tabela.deletedRowIds>arrayIDs das linhas excluídas.
<tabela.name>stringNome da tabela.
<tabela.columns>arrayDefinição das colunas (cada uma com o seu ID fixo).
<tabela.columnCount>numberNúmero de colunas.
<tabela.maxRows>numberMáximo de linhas por tabela no plano do espaço de trabalho.
<tabela.message>stringMensagem de status da operação.

Exemplo de uso

Objetivo: Processar os dados antes de seguir para a próxima etapa.

InícioTabelapróxima etapa
Operação
Consultar linhas
Tabela
(escolha na lista do campo)
Modo de entrada
Visual
Condições do filtro
status = 'ativo'
Ordenação
{ "chave": "valor" }

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <tabela.success>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.

Blocos relacionados