Troque as fontes Local File e URL do Execute Sub-workflow
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
- No relatório de migração, abra o item do Execute Sub-workflow e anote os Nodes afetados.
- Para cada Node, abra o caminho em Workflow Path ou a URL em Workflow URL e baixe o JSON do sub-workflow.
- 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.
- No ambiente de testes, execute o workflow principal e guarde os itens que o sub-workflow devolve.
- No Execute Sub-workflow, troque Source para Database e selecione o sub-workflow importado em From list.
- 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.
