Pular para o conteúdo principal

Nó: Script

O nó Script é uma espécie de "calculadora inteligente" dentro do fluxo de automação do Hashdata. Toda vez que alguém envia um formulário, o Script pode ler todas as respostas de uma vez e transformar esses dados em informações prontas para uso. Ele soma valores, conta quantos itens foram reprovados, calcula prazos e percentuais, monta textos automaticamente e decide se uma situação é normal, merece atenção ou exige ação imediata. Num checklist de equipamentos, por exemplo, ele identifica sozinho quais itens falharam, separa os críticos dos simples, define a prioridade e escreve a descrição da falha encontrada. Tudo isso acontece em segundos, no momento em que a resposta chega, sem que ninguém precise abrir planilha, conferir item por item ou digitar relatório.

O resultado desse cálculo vira matéria-prima para o resto do fluxo. O Script pode decidir qual caminho a automação segue, por exemplo bloquear um equipamento e acionar a manutenção, ou apenas registrar que está tudo certo. Pode preencher automaticamente uma Ordem de Serviço em PDF, montar o texto de um e-mail, escolher quem deve receber cada aviso conforme a unidade ou o responsável, e até gerar tabelas com a lista de itens pendentes para o corpo do e-mail ou do documento. Na prática, regras de negócio que antes dependiam da experiência de alguém para serem aplicadas (o que é grave, quem precisa saber, o que deve ser feito) passam a ser aplicadas sempre do mesmo jeito, em todas as unidades, com rastreabilidade completa. A equipe deixa de gastar tempo organizando informação e passa a agir sobre ela.


O nó Script executa um código escrito por você para calcular valores a partir dos dados dos nós anteriores — respostas de formulários, resultado de aprovações, saídas de outros scripts. Os resultados (texto, número, lista de e-mails ou lista de objetos) podem ser usados nos nós seguintes: no texto de e-mails, em condições, nos destinatários, no status, no conteúdo de PDFs e em outros campos de texto.

O nó roda sozinho, sem aguardar nenhuma ação externa, e avança assim que o código termina.


Quando Usar​

Use o nó Script quando um valor que o processo precisa não existe pronto em nenhum formulário. Exemplos comuns:

  1. Cálculos — somar itens, contar não conformidades, aplicar desconto, calcular prazo, percentual ou valor total a partir de várias respostas.
  2. Classificar — definir um status (por exemplo, LIBERADO, ATENÇÃO ou BLOQUEADO) e uma prioridade a partir de regras com pesos diferentes.
  3. Montar textos — compor uma mensagem, um assunto de e-mail ou a descrição de uma Ordem de Serviço com partes de respostas diferentes.
  4. Escolher destinatários — devolver uma lista de e-mails que depende das respostas (por exemplo, o gestor de cada filial).
  5. Tabelas em e-mails e PDFs — devolver uma lista de linhas (item, quantidade, valor) para aparecer como tabela no corpo do e-mail ou do PDF.
  6. Decidir o caminho — calcular um número ou um texto para usar como condição em um nó Se/Senão.
NecessidadeRecurso indicado
Mostrar a resposta de um campo num e-mail ou PDFVariável normal do workflow
Condição simples sobre uma ou poucas perguntasSe/Senão com origem Questão
Regra que combina muitos campos, com critérios diferentesScript + Se/Senão com origem Script
Valor exibido ao respondente durante o preenchimentoCampo calculado (script) do formulário
Script do workflow × campo calculado do formulário

O campo calculado roda durante o preenchimento e grava o resultado na própria resposta (por exemplo, avgByTag('r')*100 para um percentual de conformidade). O nó Script roda depois do envio, lê a resposta inteira e entrega valores para o fluxo. Os dois se complementam: o campo calculado informa quem preenche, e o Script decide o que o processo faz.

Precisa saber programar

O código é escrito em TypeScript num editor com autocomplete. Para regras simples, como mostrar a resposta de um campo, prefira as variáveis normais do workflow: o nó Script é para quando é preciso calcular.


Antes de começar: prepare o formulário​

O Script lê as respostas pelo Nome do campo de cada pergunta. Por isso, o formulário deve estar pronto antes de configurar o nó.

O formulário precisa estar pronto antes do Script

Configure todas as perguntas do formulário, com o Nome do campo preenchido, e publique o formulário antes de criar o nó Script. Assim o contexto de teste e o autocomplete já trazem todos os campos, e o script funciona como esperado desde o primeiro teste.

  1. Nome do campo em todas as perguntas usadas pelo script — no editor do formulário, em Atributos do elemento → Nome do campo. É esse nome que vira a chave da pergunta nos dados que o script recebe.
  2. Padrão de nomes — use minúsculas, sem acento, sem espaço e com número fixo de dígitos: item_01 … item_25, equipamento, horimetro. Blocos de Exibição de texto não recebem nome.
  3. Mesmo sentido em todas as respostas — em checklists de Sim/Não, escreva as perguntas de modo que "Não" sempre signifique falha. Por exemplo, "Sem vazamento de água/óleo" em vez de "Vazamento de água/óleo".
  4. Valor atribuído às opções — em Configurar seleção, ative Atribuir valor aos itens (por exemplo, Sim = 1 e Não = 0). Isso permite comparar pelo texto ou pelo valor.
  5. Comentário e foto por opção — na mesma tela, as chaves Comen. e Fotos podem ser ligadas só na opção "Não". O operador registra evidência apenas quando há falha, e o preenchimento fica mais rápido.
  6. Tags — se o formulário usa campo calculado por tag (por exemplo, avgByTag('r')), deixe a tag apenas nas perguntas que devem entrar na média. Campos numéricos, como um nível de bateria, devem ficar fora dela.
  7. Publique o formulário.
Nome do campo não é tag

O Nome do campo e as Tags ficam lado a lado em Atributos do elemento, mas têm funções diferentes. Uma pergunta sem Nome do campo chega ao script com uma chave gerada automaticamente (por exemplo, qt_6aedab461b8d267155213d55), mesmo que tenha uma tag com o nome desejado. Campos calculados sem nome também aparecem assim.


Configuração​

Clique sobre o nó no canvas do editor de workflow. O painel lateral tem o campo Rótulo, três abas, Inputs, Outputs e Testar, e a área Código logo abaixo delas. Os atalhos Alt+I, Alt+O e Alt+T trocam de aba; eles não funcionam enquanto você digita em um campo ou no editor de código.

  • Rótulo — é o nome do nó no canvas, no seletor de variáveis (por exemplo, "Classificar checklist → status") e nas condições do Se/Senão. Use um verbo que descreva o cálculo.
  • Configuração mínima — um input, um output declarado e a função calculateValue devolvendo esse output.

Inputs — o que o script lê​

Cada input dá ao script os dados de um nó anterior do workflow. Clique em Adicionar input e preencha:

CampoDescrição
TipoDados (padrão) entrega os dados do nó; PDF entrega o link e o nome do arquivo PDF do nó. Veja Input do tipo PDF.
Nó anteriorO nó de onde vêm os dados ("Selecione um nó anterior"). Só aparecem nós que vêm antes do Script no fluxo. Com o tipo PDF, só aparecem os nós que geram PDF.
Nome da variávelO nome pelo qual o código acessa esses dados. Veja as regras de nomes.

No código, o input chega pelo nome declarado, entre as chaves da assinatura:

function calculateValue({ checklist }: Context): Result { ... }

Se o nome no código for diferente do nome do input, o editor sublinha a variável em vermelho.

O que o script recebe depende do tipo do nó escolhido:

Nó anteriorO que o script recebe
Gatilho de formulário, Solicitar Resposta de Formulário e Solicitar AcompanhamentoA resposta do formulário, com um item por pergunta (número, texto, data, opções escolhidas etc.) e informações da resposta. O autocomplete do editor mostra os campos reais do formulário. Veja Estrutura de uma resposta de formulário.
AprovaçãoO nome do nó, o resultado da aprovação e o comentário de quem respondeu. Antes da resposta, só o nome.
Gatilho agendadoO nome do nó e o horário agendado.
Gatilho: Plano de Ação e Solicitar Plano de AçãoOs dados do plano de ação daquele nó.
Outro nó ScriptOs outputs que o outro script devolveu. É assim que um script usa o resultado de outro, inclusive listas de objetos.
Outros nós (Esperar, Enviar E-mail, Criar PDF etc.)O nome do nó e o horário em que o fluxo chegou a ele.
Nós de integração não servem como input

Webhook, Slack, Teams, Google Sheets, Excel, Google Drive e OneDrive não podem ser inputs, porque não produzem dados para o script ler.

Os dados são lidos na hora da execução

O formato dos dados reflete o que o nó anterior tem no momento em que o script roda. Se o formulário mudar depois, o dado recebido muda junto. O plano de ação é a exceção: os dados dele são guardados quando o gatilho dispara ou quando o plano pedido é criado, e uma mudança posterior no plano não chega ao script.

Estrutura de uma resposta de formulário​

Um input ligado a um gatilho de formulário chega com quatro partes:

{
"checklist": {
"formId": "6aed0730ca681f11ccb29a37",
"formName": "Check-list de Inspeção",
"response": {
"equipamento": { "name": "equipamento", "tags": [], "label": "EMP-01" },
"horimetro": { "name": "horimetro", "tags": [], "number": 1523.4 },
"item_01": { "name": "item_01", "tags": ["#r"], "label": "Sim", "number": 1 },
"item_02": { "name": "item_02", "tags": ["#r"], "label": "Não", "number": 0, "comment": "Vazamento na mangueira" }
},
"metadata": {
"SURVEY_ID": "6aedb8e058d722c8a03b78a7",
"RESPONDENT_IS_ANONYMOUS": "0",
"RESPONSE_SUBMITTED_AT": "2026-11-06 11:24:16",
"N_OF_ATTACHMENTS": 1,
"TOTAL_TIME": 312,
"NET_TIME": 287,
"RESPONDENT_USER_ID": "69b16aa871cb3030b6523e72",
"RESPONDENT_EMAIL": "operador@empresa.com"
}
}
}
ParteConteúdo
formId / formNameIdentificação do formulário.
responseUm objeto com uma chave por pergunta. A chave é o Nome do campo da pergunta.
metadataDados da coleta: ID da coleta, se a resposta é anônima, data e hora de envio (AAAA-MM-DD HH:MM:SS), número de anexos, tempos total e líquido de preenchimento, ID e e-mail do usuário que respondeu.

Cada pergunta dentro de response traz:

PropriedadeAparece emConteúdo
nameTodas as perguntasO Nome do campo.
tagsTodas as perguntasLista de tags da pergunta, ou lista vazia.
labelSeleção únicaO texto da opção escolhida (por exemplo, "Sim" ou "Não").
numberSeleção com valor atribuído, campos numéricos e campos calculadosO valor da opção (por exemplo, 1 ou 0), o número digitado ou o resultado do cálculo.
commentPerguntas que aceitam comentário, quando quem respondeu comentouO comentário, exatamente como foi escrito. Um comentário só de espaços conta como ausente: comment não aparece.
Comentário sem valor

Em geral uma pergunta com comentário também tem valor, porque o formulário não aceita enviar só o comentário. A exceção é a troca do tipo da pergunta com descarte dos valores que não se convertem: a resposta antiga fica só com o comentário e chega ao script como { name, tags, comment }, sem label nem number.

O comentário chega só ao nó Script do workflow. O campo calculado (Script ou Fórmula) do formulário não recebe o comentário das respostas.

Veja o formato exato de qualquer campo

Para conferir como chega um tipo de pergunta, crie um output de texto chamado estrutura e devolva JSON.stringify(checklist, null, 2). Insira esse output num e-mail de teste enviado só para você: ele traz a resposta completa, exatamente como o script a recebe. Remova o output do e-mail quando o fluxo estiver validado.

Leia as respostas com segurança

Uma pergunta não respondida pode não existir em response, e uma pergunta sem comentário não traz comment. Use sempre ?. e ?? ao ler os campos, por exemplo: respostas["horimetro"]?.number ?? 0 ou respostas["item_02"]?.comment ?? ''.

Input do tipo PDF​

Com o tipo PDF, o script recebe o PDF do nó anterior em vez dos dados dele. A variável tem dois campos, ambos texto:

  • url — o endereço do PDF.
  • fileName — o nome do arquivo.

Servem como nó anterior: Gatilho de formulário, Gatilho: Plano de Ação, Solicitar Resposta de Formulário, Solicitar Acompanhamento, Solicitar Plano de Ação, Criar PDF e Histórico do Fluxo. Nos outros, o input fica com o erro "Este nó não gera PDF" e o workflow não publica.

  • Nos nós Criar PDF e Histórico do Fluxo, o script recebe o PDF que o próprio nó já gerou.
  • Nos demais, o PDF é gerado a cada execução do script, o que aumenta o tempo dela. O editor mostra um aviso quando isso acontece. Se outro nó da mesma execução já gerou o PDF desse nó (por exemplo, um e-mail com a resposta anexada), ele é reaproveitado: o PDF é gerado uma vez só.
  • Se o nó escolhido não rodou nesta execução (por exemplo, o outro lado de uma condição), url e fileName chegam vazios, e o histórico do Script registra o aviso de nó que não rodou.
  • Se a geração do PDF falhar, o script não roda com um link vazio: a instância fica com status Falhou, como na falha ao ler o formulário (veja Quando o nó anterior não rodou).

Um e-mail mostra um texto simples como texto, não como link. Para o link ficar clicável, devolva o endereço no formato [rótulo](url) em um output do tipo Texto:

return { pdf: '[Abrir PDF](' + pdf.url + ')' };

Aqui pdf é o nome da variável do input e também o nome do output. Devolver só pdf.url faz o e-mail mostrar o endereço sem link. No editor, ao digitar pdf., a sugestão Link Markdown do PDF insere essa expressão pronta. O formato [rótulo](url) está explicado em Link e tabela no corpo do e-mail e do PDF.

Outputs — o que o script devolve​

Cada output é um valor que o script entrega para os nós seguintes. Clique em Adicionar output, escolha o Tipo e dê um nome. Existem quatro tipos:

TipoO que éOnde pode ser usado
TextoUma frase ou palavra. Uma data devolvida como texto chega ao destino como texto no formato ISO (por exemplo, 2026-03-01T10:00:00.000Z).Textos em geral (e-mails, status, nome de arquivo, conteúdo de PDF) e condições.
NúmeroUm número válido. NaN e infinito são recusados.Textos em geral e condições.
Lista de e-mailsUma lista de endereços de e-mail.Destinatários dos nós de e-mail ("Adicionar de um nó Script").
Lista de objetosUma tabela: cada item da lista é uma linha, e você declara os atributos (colunas), cada um do tipo Texto ou Número.Só no corpo de um e-mail ou de um PDF, como tabela, ou como input de outro nó Script.

Todo output declarado precisa voltar no resultado do script, com o tipo declarado. Se faltar um, vier com tipo diferente, ou se uma linha de uma lista não tiver algum atributo, o nó falha e a mensagem diz qual output ou linha causou a falha. O que o script devolver além dos outputs declarados é descartado.

  • O nome do output deve ser idêntico à chave usada no return. Uma chave sem output declarado fica sublinhada em vermelho no editor.
  • A ordem dos outputs na lista não importa.
  • Se o nome declarado for diferente do devolvido, o teste mostra, por exemplo: O output descicao não tem o tipo declarado (recebido: undefined).
Lista de objetos só no corpo do e-mail e do PDF

A lista de objetos aparece como tabela no corpo dos cinco nós de e-mail: Aprovação, Enviar E-mail, Solicitar Resposta de Formulário, Solicitar Acompanhamento e Solicitar Plano de Ação, e no conteúdo do Criar PDF. Ela não funciona no assunto, no status, no nome do arquivo do PDF, nem em Slack, Teams, webhook, planilha ou Drive.

Código​

O código tem uma regra fixa de estrutura: a função calculateValue precisa ser a primeira coisa do código, com a assinatura abaixo. Funções e constantes auxiliares vão depois dela, nunca antes.

function calculateValue({ pedido, aprovacao }: Context): Result {
const total = calcularTotal(pedido);
return { total, resumo: `Total: ${total}` };
}

function calcularTotal(pedido: Context['pedido']): number {
// funções auxiliares ficam depois de calculateValue
return 0;
}
  • Entre as chaves da assinatura, liste os nomes dos inputs que o script usa (pedido, aprovacao).
  • A função devolve um objeto, com uma chave para cada output declarado.
  • Context e Result são tipos gerados automaticamente a partir dos inputs e outputs configurados no painel.
  • try/catch, throw e Error são liberados: use-os para tratar situações esperadas e devolver um valor padrão.
  • Recursos comuns do JavaScript funcionam normalmente: ?., ??, template strings, filter, map, join, Number, String, JSON.stringify e constantes declaradas no fim do código.
  • Palavras bloqueadas, que impedem salvar o código: async, await, import, importScripts, eval, then, prototype, __proto__, setTimeout, setInterval, constructor, fetch e XMLHttpRequest. Elas também não podem ser usadas como nomes de variáveis ou propriedades. O script não acessa a internet, arquivos nem temporizadores.
  • O código pode ter até 100.000 caracteres.
  • Um erro de sintaxe é apontado com a linha em que ocorre, e o workflow não pode ser publicado enquanto o código não compilar.
O código é compilado no salvamento automático

O código é compilado quando o rascunho é salvo, o que acontece sozinho a cada 30 segundos ou ao fechar o painel do nó. Se aparecer o aviso "Código ainda não compilado", aguarde o salvamento automático; se o aviso continuar, corrija os erros de sintaxe.

Padrões recomendados de código​

// Acesso seguro à resposta do formulário
const respostas: any = (checklist as any)?.response ?? {};
const meta: any = (checklist as any)?.metadata ?? {};

// Leitura de um número, com valor padrão
const horimetro = Number(respostas["horimetro"]?.number ?? 0);

// Sim/Não robusto: aceita o texto ou o valor da opção
function ehNao(resp: any): boolean {
if (!resp) return false;
const label = String(resp.label ?? "").trim().toLowerCase();
return label === "não" || label === "nao" || resp.number === 0;
}
  • Separe a configuração da lógica — listas de itens, pesos, limites e cadastros ficam em constantes no fim do código (por exemplo, ITENS e LIMITE_BATERIA). Para mudar a regra, basta editar a constante.
  • Quebras de linha — use \n nos textos. No resultado do teste elas aparecem literalmente como \n; no e-mail e no PDF viram quebras de linha.
  • Valores de status — prefira valores em maiúsculas (BLOQUEADO, LIBERADO). As condições comparam o texto exato.

Regras de nomes​

NomeRegraPor quê
Input (nome da variável) e OutputSó letras sem acento, números e _; começa com letra; até 60 caracteres; não pode ser palavra reservada do JavaScript (como class ou return) nem uma das palavras bloqueadas do código (como then).O nome vira uma variável do código e uma chave usada nos textos ({{script...}}). Acento, hífen ou espaço quebrariam as duas coisas.
Atributo de uma lista de objetosLivre (pode ter espaço no meio e acento), exceto os caracteres , " & < > }, e sem espaço no início nem no fim.Esses caracteres atrapalham a lista de colunas da tabela do e-mail (,), o texto HTML (& < > ") e o fechamento da variável (}). Nomes iguais na mesma lista também não são aceitos.

Dois inputs, ou dois outputs, não podem ter o mesmo nome.


Usando os resultados nos nós seguintes​

Os outputs aparecem no grupo Script do seletor de variáveis dos campos de texto, e em dois outros lugares:

  • Textos — no assunto e no corpo dos nós de e-mail, no status do nó Definir Status e no nome do arquivo e no conteúdo do Criar PDF. O valor entra no texto no lugar da variável.
  • Condições — em uma regra com o tipo Script (nó, output, operador e valor). Servem outputs de tipo Texto ou Número. Na seta que sai do próprio Script, a regra também pode usar os outputs desse mesmo Script. Se o output mudar de tipo ou for removido depois, a regra mostra "O output mudou de tipo ou foi removido. Revise o output, o operador e o valor desta regra."
  • Destinatários — nos nós de e-mail, Adicionar de um nó Script usa um output do tipo E-mails. Endereços repetidos ou inválidos são ignorados, e o que foi descartado fica registrado no histórico.

Seletor de variáveis​

Toda variável entra pelo ícone de etiqueta, no editor de texto ou à direita do campo. O seletor mostra uma árvore com busca:

  • Nó Script — pelo rótulo, com um item por output (por exemplo, Classificar checklist → status, prioridade, descricao).
  • Formulário — a pasta Metadados (dados da coleta) e a pasta Perguntas (cada pergunta pelo enunciado).

No editor, a variável inserida aparece como uma pílula azul. Uma variável inexistente aparece como uma pílula vermelha.

Insira as variáveis sempre pelo seletor

Texto digitado ou colado no formato {{nome}} não vira variável: ele aparece como pílula vermelha e impede a publicação do workflow. Apague as pílulas vermelhas e insira as variáveis pelo ícone de etiqueta.

Usuário respondente traz o ID

Nos Metadados, a variável Usuário respondente traz o ID interno do usuário (por exemplo, 69b16aa871cb3030b6523e72). Para identificar quem respondeu num e-mail ou numa Ordem de Serviço, use o e-mail do respondente.

Condições no Se/Senão​

  1. Em Condições, escolha a origem Script (as outras são Questão e Metadado da Coleta).
  2. Em Nó Script, selecione o nó pelo rótulo.
  3. Escolha o output, o operador (por exemplo, igual a) e o valor (por exemplo, BLOQUEADO).
  4. Pressione Tab ou clique fora do campo de valor para registrá-lo. Enquanto isso não acontece, o campo mostra "Informe o complemento".
Conecte as duas saídas do Se/Senão

As saídas Verdadeiro e Falso precisam estar conectadas para o workflow publicar. Quando o caminho Falso não tem ação, ligue-o a um nó Definir Status (por exemplo, "Sem falha crítica").

  • Um texto no formato [rótulo](url), em um output do tipo Texto, vira um link clicável no corpo do e-mail e no conteúdo do PDF (somente endereços http e https). No assunto e nos outros campos, o texto aparece como foi escrito.
  • Uma lista de objetos vira uma tabela no corpo do e-mail e no conteúdo do PDF, com uma coluna por atributo. O seletor de variáveis sempre inclui a lista de colunas, na ordem em que você as selecionar. Uma lista vazia mostra só o cabeçalho.

Dicas para os editores de e-mail e de PDF​

  • Os editores são de texto formatado: títulos, negrito, cores, alinhamento, listas, imagens, tabelas e variáveis. O botão Carregar modelo (exemplo) mostra um modelo pronto com esses recursos.
  • No e-mail, o clipe da barra anexa os PDFs gerados por nós anteriores, como o do Criar PDF.
  • Ao clicar numa tabela, aparece uma barra para inserir e remover linhas e colunas, mesclar e dividir células e excluir a tabela.
  • Tabelas coladas uma logo após a outra se unem numa só. Separe cada tabela com uma linha de texto, como o título da seção.
  • No PDF gerado, as tabelas aparecem sem bordas. Para formulários como uma Ordem de Serviço, prefira um campo por linha, no formato Rótulo: valor, com linhas pontilhadas para o que será preenchido à mão.
  • Textos de várias linhas vindos do Script (como uma descrição de serviço) ficam melhores num parágrafo próprio, fora de tabela.
  • O nome do arquivo do PDF também aceita variáveis, e a extensão .pdf é adicionada automaticamente.
Texto digitado pelo usuário é seguro

Textos vindos de respostas de formulário, ao entrarem no e-mail ou no PDF por um script, não executam código nem formatação indevida: o conteúdo é mostrado como texto.


Testar o script​

A aba Testar, ao lado de Inputs e Outputs, roda o script sem disparar o workflow. Ela só aparece para quem pode editar o workflow:

  1. Clique em Carregar contexto de exemplo. O campo Contexto é preenchido com um exemplo para cada input, no formato real do nó escolhido, usando os formulários que estão na tela.
  2. Ajuste os valores do exemplo para o caso que quer simular. Num input de formulário, toda pergunta do exemplo traz comment com o texto fictício Example comment: apague-o para simular uma resposta sem comentário. Num input do tipo PDF, o exemplo traz url e fileName fictícios (https://example.com/document.pdf e document.pdf): o teste não gera nenhum PDF. Se você adicionar ou renomear um input depois, as chaves que faltam são acrescentadas ao contexto ao rodar, sem perder o que você já editou.
  3. Clique em Rodar. O Resultado aparece ao lado, ou a mensagem do erro, se houver.
Simule cada cenário editando o contexto

O contexto de exemplo vem com valores padrão: a primeira opção de cada pergunta e números fixos. Para testar uma falha, edite o JSON diretamente. Por exemplo, para marcar o item 22 como "Não":

"item_22": { "name": "item_22", "tags": ["#r"], "label": "Não", "number": 0 }

Se um campo novo do formulário ainda não aparecer no exemplo, acrescente-o à mão no contexto. Guarde um contexto para cada cenário (liberado, atenção, bloqueado) e rode todos a cada mudança no código.

Pontos de atenção:

  • O teste usa o código que está na tela, sem precisar salvar o rascunho antes. Erros de sintaxe, de assinatura ou palavras bloqueadas aparecem no Resultado.
  • O teste e a execução real têm o mesmo limite de 10 segundos por execução, e 64 MB de memória. Estourar o tempo mostra "O script excedeu o limite de 10 segundos".
  • O servidor aceita 2 testes ao mesmo tempo. Se houver mais, aparece "Há testes demais em andamento. Aguarde alguns segundos e tente de novo": basta tentar de novo. Os testes nunca atrasam os scripts dos workflows em execução, que têm suas próprias vagas.
  • Se o Contexto não for um JSON válido, aparece "O contexto informado não é um JSON válido." Confira vírgulas, aspas e se o texto colado está completo.
  • O Contexto pode ter até 256 KB. Acima disso aparece "O contexto do teste passa do limite de 256 KB", e o teste nem começa.
  • Os atalhos de teclado, como Cmd+A ou Ctrl+A, agem na caixa em que o cursor está. Clique dentro do Contexto ou do Código antes de selecionar tudo.
  • No Resultado, quebras de linha aparecem como \n, e textos gerados com JSON.stringify aparecem com \". É só a forma de exibição.

Publicação​

Ao clicar em Publicar, o editor valida o workflow inteiro e lista as inconsistências encontradas. Os nós com pendência ficam com a borda vermelha no canvas, e o aviso aparece no topo do painel do nó.

MensagemO que fazer
"IF/ELSE sem transição Falso configurada"Conectar a saída Falso do Se/Senão a um nó.
"Um template usa uma variável inexistente ou uma sintaxe não suportada. Blocos e helpers só valem para saídas de SCRIPT (script.*); nas demais variáveis, use apenas as inseridas pelo seletor de variáveis"Apagar as pílulas vermelhas e inserir as variáveis pelo seletor. Aparece uma mensagem por variável.
"Este nó não gera PDF"Escolher, no input do tipo PDF, um nó que gera PDF.
"Código ainda não compilado"Aguardar o salvamento automático ou corrigir a sintaxe.
Confira o salvamento antes de continuar

O topo do editor mostra "Rascunho salvo às…". Se aparecer "Salvamento automático pausado", corrija o campo pendente (por exemplo, um valor de condição ainda não registrado) e clique em Tentar novamente antes de adicionar novos nós. Se um nó for excluído por engano, o botão Desfazer da barra do editor o recupera.


Quando o script falha​

Se o script ultrapassar 10 segundos ou 64 MB, lançar um erro não tratado, devolver um output com tipo errado, ou devolver um resultado maior que 256 KB, o nó falha. Com isso:

  • A instância fica com status Falhou, e o responsável pelo workflow recebe um e-mail avisando, com o link para ver os eventos.
  • O erro aparece no histórico da instância, com a causa (por exemplo, qual output ou linha estava errado).
  • Os dados de entrada do script não são enviados para ferramentas de monitoramento de erros nem registrados no log do servidor, porque podem conter respostas de formulários.
Trate o que é esperado

Use try/catch para casos previsíveis (campo vazio, divisão por zero) e devolva um valor padrão. Assim a instância segue em frente em vez de falhar.


Quando o nó anterior não rodou​

O workflow só garante que existe um caminho do nó anterior até o Script, não que o nó já rodou. Isso acontece, por exemplo, quando o Script lê um nó do outro lado de um Se/Senão, ou quando uma aprovação ainda não foi respondida.

Nesses casos o dado chega vazio (o input chega como um objeto sem dados, o texto aparece em branco; num input do tipo PDF, url e fileName chegam vazios, e nenhum PDF é gerado para esse nó; um nó que começou e falhou também conta como não rodado), e o nó que leu o dado mostra no histórico da instância o aviso "Dados vazios de nós que não rodaram antes", com o nome de cada nó. O workflow não falha por isso: trate o caso vazio no código.

Um nó de plano de ação pode ter rodado e mesmo assim entregar um objeto vazio: quando o plano não pôde ser lido, ou quando o problema ou a ação que dispararam o fluxo foram removidos antes de o workflow guardar os dados. Nesse caso o histórico mostra o aviso "Dados indisponíveis de nós que rodaram antes", com o nome do nó, e o workflow também segue em frente.

Isso é diferente de uma falha ao ler o formulário ou a resposta, ou ao gerar o PDF de um input PDF (por exemplo, uma indisponibilidade momentânea do banco de dados ou do armazenamento de arquivos): nesse caso o script não roda com dados vazios. A instância fica com status Falhou, o responsável pelo workflow recebe o e-mail de aviso, e o erro aparece no histórico como falha do script.


Exemplo completo: checklist de inspeção com Ordem de Serviço​

Um checklist de inspeção de empilhadeiras com itens de Sim/Não, dos quais alguns são críticos. Se algum item crítico falhar, o equipamento é bloqueado e uma Ordem de Serviço em PDF é enviada à manutenção.

Fluxo​

  1. Gatilho: Resposta de Formulário "Checklist recebido", disparando só na Criação — assim, editar uma resposta não gera nova OS.
  2. Script "Classificar checklist".
  3. Se/Senão "Falha crítica": origem Script, status igual a BLOQUEADO.
  4. Saída Verdadeiro:
    1. Definir Status — "Bloqueado – aguardando manutenção".
    2. Criar PDF — modelo da OS, com as variáveis do Script.
    3. Enviar E-mail — para a manutenção, com descricao no corpo e o PDF anexado.
  5. Saída Falso: Definir Status — "Sem falha crítica".

Regra de classificação​

StatusCondiçãoPrioridade
BLOQUEADOPelo menos um item crítico com "Não".1
ATENÇÃONenhum item crítico com falha, mas pelo menos um item comum com "Não" (ou bateria abaixo do limite, quando definido).2
LIBERADOTodos os itens com "Sim".3

Configuração do nó​

  • Input: nó "Checklist recebido", com a variável checklist.
  • Outputs:
OutputTipoConteúdo
statusTextoBLOQUEADO, ATENÇÃO ou LIBERADO.
prioridadeNúmero1, 2 ou 3.
descricaoTextoDescrição dos serviços, com os itens com falha.
qtd_criticos_ncNúmeroQuantidade de itens críticos com falha.
qtd_ncNúmeroQuantidade total de itens com falha.
nivel_bateriaNúmeroNível de carga informado.
numero_osTextoNúmero da OS, gerado a partir da data e hora de envio.
equipamentoTextoEquipamento escolhido no formulário.
local_instalacaoTextoLocal do equipamento, vindo do cadastro no código.
gestorTextoGestor do equipamento, vindo do cadastro no código.
ramalTextoRamal, vindo do cadastro no código.
horimetroTextoHorímetro formatado (por exemplo, "1523,4 h").
data_checklistTextoData e hora do checklist (por exemplo, "06/11/2026 10:36").
estruturaTextoDiagnóstico: a resposta completa. Remover dos e-mails após validar.

Código​

function calculateValue({ checklist }: Context): Result {
const respostas: any = (checklist as any)?.response ?? {};
const meta: any = (checklist as any)?.metadata ?? {};

// Classificação
const naoConformes = ITENS.filter(item => ehNaoConforme(respostas[item.id]));
const criticosNC = naoConformes.filter(item => item.critico);

const nivelBateria = Number(respostas["item_18"]?.number ?? 0);
const bateriaBaixa = LIMITE_BATERIA !== null && nivelBateria < LIMITE_BATERIA;

const status = criticosNC.length > 0 ? "BLOQUEADO"
: (naoConformes.length > 0 || bateriaBaixa) ? "ATENÇÃO"
: "LIBERADO";

const prioridade = status === "BLOQUEADO" ? 1 : status === "ATENÇÃO" ? 2 : 3;

// Descrição dos serviços
const cabecalho = status === "BLOQUEADO"
? "BLOQUEIO AUTOMÁTICO: Falha Crítica Detectada"
: status === "ATENÇÃO" ? "ATENÇÃO: Falha não crítica detectada" : "";

const linhas = naoConformes.map(item => `- ${item.num} - ${item.nome}`);
if (bateriaBaixa) linhas.push(`- 18 - Nível da carga da bateria (${nivelBateria}%)`);

const descricao = linhas.length
? `${cabecalho}\n\nITENS DO CHECKLIST COM FALHA:\n${linhas.join("\n")}`
: "Nenhuma não conformidade registrada.";

// Identificação da OS
const equipamento = String(respostas["equipamento"]?.label ?? "").trim();
const cadastro = CADASTRO[equipamento] ?? { local: "", gestor: "", ramal: "" };

const enviadoEm = String(meta.RESPONSE_SUBMITTED_AT ?? ""); // "2026-11-06 10:36:32"
const numero_os = enviadoEm ? "OS-" + enviadoEm.replace(/\D/g, "") : "";

const horimetroNum = respostas["horimetro"]?.number;
const horimetro = horimetroNum !== undefined && horimetroNum !== null && horimetroNum !== ""
? `${String(horimetroNum).replace(".", ",")} h`
: "";

return {
status,
prioridade,
descricao,
qtd_criticos_nc: criticosNC.length,
qtd_nc: naoConformes.length,
nivel_bateria: nivelBateria,
numero_os,
equipamento,
local_instalacao: cadastro.local,
gestor: cadastro.gestor,
ramal: cadastro.ramal,
horimetro,
data_checklist: formatarData(enviadoEm),
estrutura: JSON.stringify(checklist, null, 2)
};
}

function ehNaoConforme(resp: any): boolean {
if (!resp) return false;
const label = String(resp.label ?? "").trim().toLowerCase();
return label === "não" || label === "nao" || resp.number === 0;
}

function formatarData(dataHora: string): string {
// "2026-11-06 10:36:32" -> "06/11/2026 10:36"
const m = dataHora.match(/^(\d{4})-(\d{2})-(\d{2})\s+(\d{2}):(\d{2})/);
return m ? `${m[3]}/${m[2]}/${m[1]} ${m[4]}:${m[5]}` : dataHora;
}

const LIMITE_BATERIA: number | null = null; // ex.: 20 para exigir no mínimo 20%

// Cadastro dos equipamentos: a chave deve ser IDÊNTICA ao texto da opção no formulário
const CADASTRO: Record<string, { local: string; gestor: string; ramal: string }> = {
"EMP-01": { local: "Expedição", gestor: "Nome do Gestor", ramal: "1234" },
"EMP-02": { local: "Câmara fria", gestor: "Nome do Gestor", ramal: "1235" }
};

const ITENS = [
{ id: "item_01", num: 1, nome: "Vazamento de água/óleo", critico: true },
{ id: "item_02", num: 2, nome: "Mangueiras", critico: false },
{ id: "item_03", num: 3, nome: "Pintura geral", critico: false },
{ id: "item_04", num: 4, nome: "Material preso nas rodas", critico: false },
{ id: "item_05", num: 5, nome: "Rodas dianteiro-traseira", critico: false },
{ id: "item_06", num: 6, nome: "Correntes da torre", critico: true },
{ id: "item_07", num: 7, nome: "Cinto de segurança", critico: true },
{ id: "item_08", num: 8, nome: "Extintor de incêndio", critico: false },
{ id: "item_09", num: 9, nome: "Sistema de climatização", critico: false },
{ id: "item_10", num: 10, nome: "Acrílico/vidro de proteção", critico: false },
{ id: "item_11", num: 11, nome: "Pedais/Joystick/Comandos", critico: true },
{ id: "item_12", num: 12, nome: "Buzina e farol", critico: true },
{ id: "item_13", num: 13, nome: "Freio e volante", critico: true },
{ id: "item_14", num: 14, nome: "Retrovisores", critico: false },
{ id: "item_15", num: 15, nome: "Giro Flex", critico: false },
{ id: "item_16", num: 16, nome: "Alarme de marcha ré", critico: false },
{ id: "item_17", num: 17, nome: "Código de erro no painel", critico: false },
{ id: "item_19", num: 19, nome: "Luz de freio", critico: false },
{ id: "item_20", num: 20, nome: "Luz de advertência painel", critico: false },
{ id: "item_21", num: 21, nome: "Direção", critico: true },
{ id: "item_22", num: 22, nome: "Torre", critico: true },
{ id: "item_23", num: 23, nome: "Pedal de aproximação", critico: true },
{ id: "item_24", num: 24, nome: "Proteções de segurança", critico: false },
{ id: "item_25", num: 25, nome: "Pedal de segurança ou timão", critico: true }
];
Cadastro dentro do código

O operador escolhe só o equipamento no formulário. O local, o gestor e o ramal vêm da constante CADASTRO, o que evita erros de digitação e deixa o checklist mais rápido. A chave de cada equipamento precisa ser idêntica ao texto da opção no formulário, inclusive espaços, hífens e barras.

Nomes da lista descrevem a falha

Na constante ITENS, os nomes descrevem a falha ("Vazamento de água/óleo"), e não a pergunta do formulário ("Sem vazamento de água/óleo"). Assim a descrição da OS fica clara para quem vai executar o serviço.

Resultado do teste​

Com o equipamento EMP-01, o horímetro 1523.4 e os itens 3 e 22 marcados como "Não":

OutputValor
statusBLOQUEADO
prioridade1
qtd_criticos_nc1
qtd_nc2
numero_osOS-20261106103632
local_instalacaoExpedição
horimetro1523,4 h
data_checklist06/11/2026 10:36

descricao:

BLOQUEIO AUTOMÁTICO: Falha Crítica Detectada

ITENS DO CHECKLIST COM FALHA:
- 3 - Pintura geral
- 22 - Torre

Evoluções possíveis​

  • Tabela de itens na OS — troque descricao por um output Lista de objetos (atributos Item, Descrição, Crítico). A OS no PDF e no e-mail passa a mostrar uma tabela.
  • Destinatários por unidade — devolva um output Lista de e-mails com o responsável de cada equipamento e use-o em Adicionar de um nó Script.
  • Caminho de atenção — na saída Falso, adicione um segundo Se/Senão com status igual a ATENÇÃO, para pedir manutenção programada com Solicitar Plano de Ação.
  • Execução e liberação digitais — depois do e-mail, use Solicitar Resposta de Formulário para a manutenção registrar o serviço, Aprovação para o gestor validar e um segundo Criar PDF para gerar a OS fechada.
  • Mais segurança — envolva o cálculo em try/catch e devolva status = "ERRO" com uma descrição, para a instância seguir em frente.

Erros frequentes e solução​

O que apareceCausaSolução
Variável da assinatura sublinhada em vermelhoInput sem nome, ou com nome diferente.Igualar o Nome da variável ao nome usado no código.
Chave do return sublinhada em vermelhoOutput não declarado.Declarar o output com o mesmo nome e o tipo certo.
Valor calculado não aparece no ResultadoOutput não declarado: o que não está declarado é descartado.Declarar o output na aba Outputs.
"O output X não tem o tipo declarado (recebido: undefined)"Nome do output diferente da chave do return.Corrigir um dos dois nomes.
"calculateValue is not defined"Área Código vazia ou sem a função.Colar o código completo, começando por calculateValue.
response vazio ou sem um campo no contexto de testePergunta sem Nome do campo, ou formulário não publicado.Preencher o Nome do campo e publicar o formulário antes de criar o Script; se preciso, acrescentar o campo à mão no contexto.
Campo chega com chave qt_...Pergunta sem Nome do campo (o nome foi colocado em Tags).Preencher o Nome do campo e remover a tag.
Classificação invertida numa perguntaPergunta em que "Sim" indica falha.Reescrever a pergunta para que "Não" sempre indique falha.
Contexto de exemplo sempre sem falhasO exemplo usa valores padrão.Editar o contexto manualmente.
"Código ainda não compilado"Rascunho ainda não salvo.Aguardar o salvamento automático; se continuar, corrigir a sintaxe.
Código não salvaPalavra bloqueada (then, fetch, async…).Remover ou renomear.
"O script excedeu o limite de 10 segundos"Cálculo pesado ou repetição sem fim.Simplificar a lógica.
"O contexto informado não é um JSON válido."Vírgula ou aspas fora do lugar, ou texto colado incompleto.Corrigir o JSON ou colar o bloco inteiro de novo.
"Informe o complemento" (Se/Senão)Valor da condição não registrado.Pressionar Tab ou clicar fora do campo.
"IF/ELSE sem transição Falso configurada"Saída Falso sem conexão.Conectar a saída Falso a um nó.
Pílula vermelha num templateVariável digitada ou de campo inexistente.Inserir pelo seletor de variáveis.
Solicitante aparece como código no PDFVariável Usuário respondente, que traz o ID.Usar o e-mail do respondente.
Tabelas unidas ou sem bordas no PDFTabelas coladas em sequência; o PDF não desenha bordas.Separar com uma linha de texto ou usar um campo por linha.
"O output mudou de tipo ou foi removido…"Output alterado depois de usado numa condição.Revisar a regra da condição.
Instância com status FalhouErro não tratado, tipo errado, limite de tempo, memória ou tamanho, ou falha ao ler os dados.Ver o histórico da instância e tratar os casos previsíveis com try/catch.

Roteiro passo a passo​

  1. Formulário — preencher o Nome do campo de todas as perguntas usadas, padronizar o sentido das respostas, atribuir valores às opções e publicar.
  2. Nó — com o formulário pronto, criar o Script, conectar ao nó anterior e dar um rótulo com verbo.
  3. Input — escolher o nó anterior e dar um nome de variável válido.
  4. Diagnóstico — criar o output estrutura (Texto) com JSON.stringify(input, null, 2), carregar o contexto e conferir se response traz todos os campos.
  5. Outputs — declarar cada output com o nome exato e o tipo correto.
  6. Código — calculateValue primeiro, leitura com ?. e ??, regras e cadastros em constantes no fim, sem palavras bloqueadas, try/catch nos casos previsíveis.
  7. Testes — um contexto por cenário, incluindo campos vazios e casos extremos.
  8. Nós seguintes — variáveis sempre pelo seletor (pílula azul), as duas saídas do Se/Senão conectadas, valores de condição idênticos aos devolvidos pelo código.
  9. Publicação — resolver todas as inconsistências e fazer o primeiro teste real com um destinatário interno, com o output estrutura no corpo do e-mail.
  10. Ajuste final — remover a estrutura dos e-mails e trocar os destinatários de teste pelos definitivos.

Boas Práticas​

  • Dê nomes que expliquem o valor: total_pedido e emails_gestores ajudam mais do que x e lista.
  • Declare só os inputs que usa: o script recebe só o que você configurou, e isso deixa o autocomplete mais limpo.
  • Prepare o formulário primeiro: Nome do campo preenchido em todas as perguntas e formulário publicado antes de criar o Script.
  • Teste antes de publicar: use Carregar contexto de exemplo, ajuste os valores com casos extremos (campo vazio, lista vazia, todos os itens com falha) e rode.
  • Mantenha o script curto: cada script deve calcular um conjunto de valores. Para etapas diferentes, encadeie dois nós Script.
  • Separe regra e configuração: listas, pesos, limites e cadastros em constantes facilitam ajustes sem mexer na lógica.
  • Combine com o nó Definir Status: um status em cada caminho ajuda a saber, no painel de instâncias, em que etapa a instância está e qual decisão o Script tomou.