Ir para o conteúdo
Promovaweb

Troque as fontes Local File e URL do Execute Sub-workflow

Revisado em

Antes de começar

Fazer cada Execute Sub-workflow que lia o sub-workflow de um arquivo local ou de uma URL chamar o mesmo sub-workflow pelo banco da instância ou pelo JSON no próprio Node.

  • Lista de Nodes afetados no relatório de migração.
  • Acesso ao arquivo JSON ou à URL de cada sub-workflow.
  • Instância de testes com cópia da sua instância.

O n8n 3.0 retira as opções Local File e URL do parâmetro Source do Execute Sub-workflow. Elas só existiam nas versões 1.1 e anteriores do Node. Um Node que ainda usa uma delas falha com erro. Na v3, o sub-workflow vem do banco da instância, pela fonte Database, ou do JSON colado no próprio Node, pela fonte Define Below.

Qual fonte usar no lugar

Situação Fonte nova
O sub-workflow é mantido junto com a instância Database, depois de importar o JSON
O sub-workflow é um trecho fixo, que raramente muda Define Below, com o JSON colado no Node

Nas versões 1.1 e anteriores do Node, a opção Define Below aparece com o nome Parameter. A fonte Database é a mais simples de manter: o sub-workflow fica visível na lista de workflows, ganha histórico de versões e pode ser editado no editor.

Procedimento

  1. No relatório de migração, abra o item do Execute Sub-workflow e anote os Nodes afetados.
  2. Para cada Node, abra o caminho em Workflow Path ou a URL em Workflow URL e baixe o JSON do sub-workflow.
  3. Importe o JSON na instância com Import from File, no menu do editor, ou pela CLI. Confira que o sub-workflow começa pelo Execute Sub-workflow Trigger.
  4. No ambiente de testes, execute o workflow principal e guarde os itens que o sub-workflow devolve.
  5. No Execute Sub-workflow, troque Source para Database e selecione o sub-workflow importado em From list.
  6. Execute de novo e compare os itens devolvidos com os que você guardou.

Com From list, o Node mostra os campos de entrada que o sub-workflow espera, prontos para mapear. Os campos não aparecem quando o trigger do sub-workflow está no modo Accept all data.

Quando a URL era atualizada por outro sistema

Alguns workflows usavam a fonte URL para buscar, a cada execução, a versão mais nova de um sub-workflow publicado fora do n8n. Esse comportamento não tem equivalente direto. Para manter a atualização automática, crie um workflow que busca o JSON com o HTTP Request e atualiza o sub-workflow pela API do n8n. O Execute Sub-workflow continua apontando para o mesmo workflow no banco.

O que conferir depois

  • Modo de execução. Mantenha o Mode que o Node já usava: Run once with all items ou Run once for each item.
  • Espera pelo resultado. Confira a opção Wait for Sub-Workflow Completion. Desligada, o workflow principal segue sem esperar a resposta do sub-workflow.
  • Arquivos antigos. Depois da troca, o n8n não lê mais o arquivo local nem a URL. Guarde o JSON junto do backup, porque a versão em uso fica no banco.

Confira o resultado

O workflow principal executa o sub-workflow pela fonte nova e recebe os mesmos itens de volta que recebia com Local File ou URL.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.