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:
- Cálculos — somar itens, contar não conformidades, aplicar desconto, calcular prazo, percentual ou valor total a partir de várias respostas.
- Classificar — definir um status (por exemplo, LIBERADO, ATENÇÃO ou BLOQUEADO) e uma prioridade a partir de regras com pesos diferentes.
- 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.
- Escolher destinatários — devolver uma lista de e-mails que depende das respostas (por exemplo, o gestor de cada filial).
- 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.
- Decidir o caminho — calcular um número ou um texto para usar como condição em um nó Se/Senão.
| Necessidade | Recurso indicado |
|---|---|
| Mostrar a resposta de um campo num e-mail ou PDF | Variável normal do workflow |
| Condição simples sobre uma ou poucas perguntas | Se/Senão com origem Questão |
| Regra que combina muitos campos, com critérios diferentes | Script + Se/Senão com origem Script |
| Valor exibido ao respondente durante o preenchimento | Campo calculado (script) 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.
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ó.
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.
- 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.
- 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. - 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".
- 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.
- 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.
- 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. - Publique o formulário.
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
calculateValuedevolvendo 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:
| Campo | Descrição |
|---|---|
| Tipo | Dados (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ó anterior | O 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ável | O 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ó anterior | O que o script recebe |
|---|---|
| Gatilho de formulário, Solicitar Resposta de Formulário e Solicitar Acompanhamento | A 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ção | O nome do nó, o resultado da aprovação e o comentário de quem respondeu. Antes da resposta, só o nome. |
| Gatilho agendado | O nome do nó e o horário agendado. |
| Gatilho: Plano de Ação e Solicitar Plano de Ação | Os dados do plano de ação daquele nó. |
| Outro nó Script | Os 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. |
Webhook, Slack, Teams, Google Sheets, Excel, Google Drive e OneDrive não podem ser inputs, porque não produzem dados para o script ler.
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"
}
}
}
| Parte | Conteúdo |
|---|---|
formId / formName | Identificação do formulário. |
response | Um objeto com uma chave por pergunta. A chave é o Nome do campo da pergunta. |
metadata | Dados 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:
| Propriedade | Aparece em | Conteúdo |
|---|---|---|
name | Todas as perguntas | O Nome do campo. |
tags | Todas as perguntas | Lista de tags da pergunta, ou lista vazia. |
label | Seleção única | O texto da opção escolhida (por exemplo, "Sim" ou "Não"). |
number | Seleção com valor atribuído, campos numéricos e campos calculados | O valor da opção (por exemplo, 1 ou 0), o número digitado ou o resultado do cálculo. |
comment | Perguntas que aceitam comentário, quando quem respondeu comentou | O comentário, exatamente como foi escrito. Um comentário só de espaços conta como ausente: comment não aparece. |
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.
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.
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),
urlefileNamechegam 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:
| Tipo | O que é | Onde pode ser usado |
|---|---|---|
| Texto | Uma 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úmero | Um número válido. NaN e infinito são recusados. | Textos em geral e condições. |
| Lista de e-mails | Uma lista de endereços de e-mail. | Destinatários dos nós de e-mail ("Adicionar de um nó Script"). |
| Lista de objetos | Uma 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).
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.
ContexteResults ão tipos gerados automaticamente a partir dos inputs e outputs configurados no painel.try/catch,throweErrorsã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.stringifye 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,fetcheXMLHttpRequest. 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 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,
ITENSeLIMITE_BATERIA). Para mudar a regra, basta editar a constante. - Quebras de linha — use
\nnos 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
| Nome | Regra | Por quê |
|---|---|---|
| Input (nome da variável) e Output | Só 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 objetos | Livre (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.
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.
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
- Em Condições, escolha a origem Script (as outras são Questão e Metadado da Coleta).
- Em Nó Script, selecione o nó pelo rótulo.
- Escolha o output, o operador (por exemplo, igual a) e o valor (por exemplo,
BLOQUEADO). - Pressione Tab ou clique fora do campo de valor para registrá-lo. Enquanto isso não acontece, o campo mostra "Informe o complemento".
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").
Link e tabela no corpo do e-mail e do PDF
- 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çoshttpehttps). 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.
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:
- 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.
- Ajuste os valores do exemplo para o caso que quer simular. Num input de formulário, toda pergunta do exemplo traz
commentcom o texto fictícioExample comment: apague-o para simular uma resposta sem comentário. Num input do tipo PDF, o exemplo trazurlefileNamefictícios (https://example.com/document.pdfedocument.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. - Clique em Rodar. O Resultado aparece ao lado, ou a mensagem do erro, se houver.
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 comJSON.stringifyaparecem 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ó.
| Mensagem | O 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. |
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.
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
- Gatilho: Resposta de Formulário "Checklist recebido", disparando só na Criação — assim, editar uma resposta não gera nova OS.
- Script "Classificar checklist".
- Se/Senão "Falha crítica": origem Script,
statusigual aBLOQUEADO. - Saída Verdadeiro:
- Definir Status — "Bloqueado – aguardando manutenção".
- Criar PDF — modelo da OS, com as variáveis do Script.
- Enviar E-mail — para a manutenção, com
descricaono corpo e o PDF anexado.
- Saída Falso: Definir Status — "Sem falha crítica".
Regra de classificação
| Status | Condição | Prioridade |
|---|---|---|
| BLOQUEADO | Pelo menos um item crítico com "Não". | 1 |
| ATENÇÃO | Nenhum item crítico com falha, mas pelo menos um item comum com "Não" (ou bateria abaixo do limite, quando definido). | 2 |
| LIBERADO | Todos os itens com "Sim". | 3 |
Configuração do nó
- Input: nó "Checklist recebido", com a variável
checklist. - Outputs:
| Output | Tipo | Conteúdo |
|---|---|---|
status | Texto | BLOQUEADO, ATENÇÃO ou LIBERADO. |
prioridade | Número | 1, 2 ou 3. |
descricao | Texto | Descrição dos serviços, com os itens com falha. |
qtd_criticos_nc | Número | Quantidade de itens críticos com falha. |
qtd_nc | Número | Quantidade total de itens com falha. |
nivel_bateria | Número | Nível de carga informado. |
numero_os | Texto | Número da OS, gerado a partir da data e hora de envio. |
equipamento | Texto | Equipamento escolhido no formulário. |
local_instalacao | Texto | Local do equipamento, vindo do cadastro no código. |
gestor | Texto | Gestor do equipamento, vindo do cadastro no código. |
ramal | Texto | Ramal, vindo do cadastro no código. |
horimetro | Texto | Horímetro formatado (por exemplo, "1523,4 h"). |
data_checklist | Texto | Data e hora do checklist (por exemplo, "06/11/2026 10:36"). |
estrutura | Texto | Diagnó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 }
];
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.
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":
| Output | Valor |
|---|---|
status | BLOQUEADO |
prioridade | 1 |
qtd_criticos_nc | 1 |
qtd_nc | 2 |
numero_os | OS-20261106103632 |
local_instalacao | Expedição |
horimetro | 1523,4 h |
data_checklist | 06/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
descricaopor 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
statusigual aATENÇÃ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/catche devolvastatus = "ERRO"com uma descrição, para a instância seguir em frente.
Erros frequentes e solução
| O que aparece | Causa | Solução |
|---|---|---|
| Variável da assinatura sublinhada em vermelho | Input sem nome, ou com nome diferente. | Igualar o Nome da variável ao nome usado no código. |
Chave do return sublinhada em vermelho | Output não declarado. | Declarar o output com o mesmo nome e o tipo certo. |
| Valor calculado não aparece no Resultado | Output 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 teste | Pergunta 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 pergunta | Pergunta em que "Sim" indica falha. | Reescrever a pergunta para que "Não" sempre indique falha. |
| Contexto de exemplo sempre sem falhas | O 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 salva | Palavra 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 template | Variável digitada ou de campo inexistente. | Inserir pelo seletor de variáveis. |
| Solicitante aparece como código no PDF | Variável Usuário respondente, que traz o ID. | Usar o e-mail do respondente. |
| Tabelas unidas ou sem bordas no PDF | Tabelas 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 Falhou | Erro 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
- Formulário — preencher o Nome do campo de todas as perguntas usadas, padronizar o sentido das respostas, atribuir valores às opções e publicar.
- Nó — com o formulário pronto, criar o Script, conectar ao nó anterior e dar um rótulo com verbo.
- Input — escolher o nó anterior e dar um nome de variável válido.
- Diagnóstico — criar o output
estrutura(Texto) comJSON.stringify(input, null, 2), carregar o contexto e conferir seresponsetraz todos os campos. - Outputs — declarar cada output com o nome exato e o tipo correto.
- Código —
calculateValueprimeiro, leitura com?.e??, regras e cadastros em constantes no fim, sem palavras bloqueadas,try/catchnos casos previsíveis. - Testes — um contexto por cenário, incluindo campos vazios e casos extremos.
- 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.
- Publicação — resolver todas as inconsistências e fazer o primeiro teste real com um destinatário interno, com o output
estruturano corpo do e-mail. - Ajuste final — remover a
estruturados e-mails e trocar os destinatários de teste pelos definitivos.
Boas Práticas
- Dê nomes que expliquem o valor:
total_pedidoeemails_gestoresajudam mais do quexelista. - 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.