Fluxo de trabalho

Crie, teste, implante e revise fluxos de trabalho de projeto reutilizáveis quando o construtor estiver disponível.

Fluxo de trabalho transforma um processo repetível em etapas conectadas que o Runner pode executar com as mesmas entradas e regras novamente.

Condicional: A interface de Fluxo de trabalho existe, mas a navegação padrão do projeto atual não expõe uma entrada de Fluxo de trabalho. Use-a apenas quando o Runner exibir uma entrada de Fluxo de trabalho aprovada para seu espaço de trabalho ou o suporte do Runner fornecer um caminho aprovado. Não adivinhe ou edite uma URL para acessá-la. Se seu plano permitir apenas uma visualização, o Runner pode mostrar a página mantendo seus controles bloqueados.

Caminho de entrada

Abra a entrada Fluxo apenas quando o Runner a apresentar em seu espaço de trabalho. A página lista fluxos de trabalho para o projeto atual. Se nenhuma entrada estiver presente, use Disponibilidade de recursos ou entre em contato com o suporte em vez de tentar uma URL direta.

Antes de começar

O acesso ao Fluxo de trabalho depende do lançamento de recursos atual e do plano.
Confirme o projeto e os serviços conectados antes de testar ou implantar um fluxo de trabalho.
Uma visualização ou rascunho salvo não está ativo; implantação e ativação são ações consequentes separadas.

Lista de fluxos de trabalho

Quando não há fluxos de trabalho, selecione Criar fluxo de trabalho. Quando a lista já tem itens, use Novo fluxo de trabalho.

Controle	O que acontece depois que você o seleciona
Criar fluxo de trabalho ou Novo fluxo de trabalho	Abre Criar um fluxo de trabalho.
Fluxo de trabalho em branco	Cria um Fluxo de trabalho sem título e abre seu construtor.
Cartão de modelo	Cria um fluxo de trabalho a partir desse modelo e abre seu construtor. Se os modelos falharem ao carregar, Tentar novamente os solicita novamente.
Nome do fluxo de trabalho	Abre esse fluxo de trabalho no construtor.
Renomear	Torna o nome editável. Pressionar Enter ou clicar em outro lugar salva; Escape cancela a edição.
Fixar no topo / Desafixar	Move o fluxo de trabalho para dentro ou para fora do grupo fixado. Não executa o fluxo de trabalho.
Duplicar	Cria uma cópia e abre a cópia no construtor.
Exportar	Baixa o fluxo de trabalho como um arquivo JSON. Não implanta ou executa nada.
Excluir	Abre uma confirmação. Confirmar remove permanentemente esse fluxo de trabalho e não pode ser desfeito.

Use o menu Mais de cada linha para encontrar Renomear, Fixar no topo ou Desafixar, Duplicar, Exportar e Excluir.

Os rótulos de linha também podem mostrar se uma versão está no estado Em produção, tem um Rascunho mais recente, expõe um Endpoint ou está vinculada a um Agendamento ou Evento. Um rótulo pausado ou bloqueado por plano significa que o acionamento automático não está ativo no momento.

Trabalhar com vários fluxos de trabalho

Selecione a caixa de seleção ao lado de uma ou mais linhas. A barra de seleção mostra quantos estão selecionados e oferece:

Exportar para baixar os fluxos de trabalho selecionados.
Excluir para abrir uma confirmação em massa. Confirmar remove permanentemente cada fluxo de trabalho selecionado.
Limpar para remover a seleção sem alterar nenhum fluxo de trabalho.

Selecionar tudo seleciona os fluxos de trabalho mostrados na lista atual. Sempre reconfira a contagem antes da exclusão em massa.

Construir e salvar

A tela do construtor é onde você adiciona etapas, as conecta e configura o que cada etapa recebe e faz. Adicionar componente abre a biblioteca de componentes pesquisável. Os controles da tela ampliam, reduzem, ajustam o fluxo de trabalho à tela e organizam automaticamente as etapas conectadas.

As alterações são salvas automaticamente; não há um botão Salvar separado. A seta Voltar conclui um salvamento pendente antes de retornar à lista de fluxos de trabalho.

Estado de salvamento	O que fazer
Salvando…	Aguarde antes de fechar a página ou implantar.
Salvo	A alteração mais recente da tela está armazenada.
Falha ao salvar	Selecione Tentar novamente após verificar a conexão.
Conflito — as suas alterações não foram guardadas	Uma versão salva é mais recente. Recarregar descarta as edições locais conflitantes e carrega a versão salva.

O painel inferior contém Ambiente de teste e Execuções. No Ambiente de teste, complete as entradas de texto, produto ou mídia necessárias antes de executar. O controle de execução permanece indisponível enquanto as entradas necessárias estão faltando. Os resultados aparecem na área de saída.

O menu Mais do construtor também fornece Exportar JSON e Importar JSON…. Exportar baixa a tela atual. Importar substitui imediatamente a tela atual e dispara salvamento automático sem confirmação, portanto exporte um backup e verifique o arquivo selecionado antes de importar.

Escolha o teste certo

Os testes podem ter consequências muito diferentes.

Controle	O que acontece depois que você o seleciona
Simular	Abre um diálogo de simulação. Use dados de amostra gerados ou cole JSON, depois selecione Executar simulação. Ações do lado de escrita, como e-mails, postagens do Slack e alterações de loja, são simuladas.
Teste em direto	Abre um diálogo de teste ao vivo. Use dados gerados, JSON colado ou um evento recente quando disponível. Executar teste em direto faz chamadas reais de API e pode enviar mensagens ou alterar serviços conectados. A execução é marcada como um teste no histórico.
Ignorar esperas	Durante um teste ao vivo, pula períodos de espera configurados para que o teste possa continuar mais cedo. Não remove outros efeitos reais.
Executar fluxo de trabalho	Inicia o fluxo de trabalho configurado imediatamente e abre Execuções. Suas etapas podem ter efeitos reais; revise cada etapa e entrada primeiro.
Parar	Solicita que a execução atual seja interrompida. O trabalho já concluído não é revertido.
Cache	Em uma reexecução, pula nós elegíveis cujas entradas não foram alteradas para que você possa se concentrar no trabalho alterado a jusante.

Use Simulação para verificar ramificação e fluxo de dados. Use Teste em direto apenas quando efeitos colaterais reais são aceitáveis nas contas conectadas.

Os dois testes usam o acionador escolhido, mesmo antes da implantação. Para um acionador Agendamento ou Uma vez, o teste inicia a execução como se o acionador disparasse naquele momento, para que você possa testar um fluxo de trabalho de execução única antes da data agendada.

Revisar histórico de execução

Abra Execuções no painel inferior para ver execuções anteriores. Filtre a lista com Ao vivo, Teste ou Todas as execuções, depois selecione uma execução para inspecionar seus resultados de nó, saída, tempo e erros. Os status incluem Concluído, Falhou, Em execução e Cancelado.

Se a lista disser Nenhuma execução ainda, o fluxo de trabalho atual não tem execução registrada. Iniciar outra execução não é uma correção para uma falha; abra a execução com falha primeiro e leia seu erro.

Alguns nós com falha elegíveis oferecem Tentar novamente a partir de “nó”. Isso inicia uma nova tentativa imediatamente, sem outra confirmação. As ações a jusante podem ser executadas novamente, portanto verifique as mensagens ou alterações de loja já produzidas pela execução com falha primeiro.

Implantar e ativar

Selecione Implantar para abrir Implantar fluxo de trabalho. Revise o resumo de alterações, compatibilidade de contrato de API, resultados de validação e changelog opcional antes de continuar.

Você pode opcionalmente vincular o fluxo de trabalho implantado a um evento, um agendamento recorrente ou uma execução única. Apenas um desses tipos de acionador pode ser selecionado por vez. Uma execução única precisa de uma data e hora no futuro, inseridas no seu próprio fuso horário.

Implantar fluxo de trabalho publica uma versão com as configurações selecionadas.
Ativar e implantar aparece quando uma nova vinculação de evento, agendamento ou execução única tornaria a automação ativa. Confirmar publica a versão e permite que acionadores futuros sejam executados automaticamente com efeitos reais.

Um erro de salvamento, conflito não resolvido ou problema de validação pode bloquear a implantação. Resolva-o em vez de selecionar Implementar repetidamente.

O status de produção mostra Não implantado, Rascunho mais recente ou Em produção, mais o acionador. Antes da primeira implementação, é o acionador escolhido (Evento, Agendamento, Uma vez ou Manual) ou Sem acionador. Depois de uma implementação, é Manual quando não há acionador vinculado; caso contrário, o estado da vinculação, como Ativo, Agendado, Concluído ou Pausado. Abrir uma vinculação existente oferece controles consequentes:

Pausar interrompe acionadores automáticos mas mantém o fluxo de trabalho e a vinculação.
Retomar gatilho permite que a vinculação retida seja acionada novamente.
Remover gatilho exclui permanentemente a vinculação mas não exclui o fluxo de trabalho.

Cada ação abre uma confirmação e pode incluir um motivo. Remover a marca de uma vinculação existente durante a implantação pausa essa vinculação em vez de removê-la permanentemente.

Histórico de versão e reversão

Selecione Histórico de versões para abrir o painel Histórico de versões.

Ação	Resultado
Revisar reversão	Abre Reverter para esta versão?. Confirmar reversão faz a versão implantada selecionada substituir a versão implantada atual. Isso pode alterar o que as execuções futuras fazem, mas não substitui a tela de rascunho atual.
Restaurar no Histórico de Rascunho	Substitui a tela atual pelo rascunho salvo selecionado após confirmação. Alterações de tela não salvas ou mais recentes podem ser perdidas.

Adicione um motivo de reversão opcional para que outros membros do espaço de trabalho entendam a alteração. Revise a tela restaurada e o estado de implantação antes de iniciar outra execução.

Lista de verificação de operação segura

Confirme que você está no projeto e fluxo de trabalho corretos.
Aguarde Salvo antes de testar ou implantar.
Complete e revise cada entrada necessária.
Comece com Executar simulação quando possível.
Use Teste em direto ou Executar fluxo de trabalho apenas quando seus efeitos de serviço conectado são aceitáveis.
Inspecione Execuções e saídas antes de implantar.
Trate Ativar e implantar, reversão, restauração e exclusão como ações consequentes que exigem uma revisão final.

Solução de problemas

Problema	Próxima etapa
Nenhuma entrada Fluxo é visível	Isso é esperado na navegação padrão. Não adivinhe uma URL; veja Disponibilidade de recursos ou pergunte ao suporte do Runner se seu espaço de trabalho tem uma entrada aprovada.
Os controles são bloqueados por uma visualização de plano	Siga a mensagem do plano na tela ou pergunte a um proprietário do espaço de trabalho sobre o acesso.
A lista de modelos falha	Selecione Tentar novamente ou crie um Fluxo de trabalho em branco.
O botão Executar está indisponível	Complete cada entrada necessária e corrija qualquer valor inválido.
O conflito de salvamento aparece	Decida se a versão salva deve vencer antes de selecionar Recarregar, porque as edições locais conflitantes são descartadas.
A execução falha	Abra-a em Execuções, mantenha o erro e as entradas visíveis e evite iniciar execuções idênticas repetidamente.
A implantação está bloqueada	Resolva as mensagens de salvamento, conflito, contrato ou validação mostradas no diálogo de implantação.

Confira o resultado antes da próxima etapa

Após salvar, reabra o mesmo fluxo de trabalho e confirme se suas etapas e entradas estão presentes. Um fluxo de trabalho salvo está pronto para revisão, mas não necessariamente foi executado. Quando o seu espaço de trabalho expõe controlos de teste ou implantação, inspecione o estado de execução resultante e a saída antes de passar para a implantação. Uma execução com falha precisa que sua entrada ou etapa com falha seja corrigida antes de outra tentativa.