Iniciar um fluxo de trabalho starting-a-workflow
Um workflow é sempre iniciado manualmente. Ao ser iniciado, ele pode permanecer inativo dependendo das informações especificadas por meio de um scheduler (consulte Scheduler) ou de um agendamento de atividade.
Ações relacionadas à execução do fluxo de trabalho de direcionamento (iniciar, parar, pausar etc.) são processos assíncronos: a ordem é registrada e entrará em vigor assim que o servidor estiver disponível para aplicá-la.
A barra de ferramentas permite iniciar e controlar a execução do workflow.
A lista de opções disponíveis no menu Actions e no menu de contexto estão detalhadas abaixo.
Barra de ferramentas Ações actions-toolbar
Os botões da barra de ferramentas são detalhados nesta seção. O botão Actions dá acesso às opções de execução adicionais para atuar em fluxos de trabalho selecionados. Você também pode usar o menu File > Actions ou clicar com o botão direito do mouse em um fluxo de trabalho e selecionar Actions.
-
Start
Essa ação permite iniciar a execução de um workflow: um workflow Concluído, Em edição ou Pausado altera o status para Iniciado. Em seguida, o motor de workflow manipula a execução desse workflow. Se o workflow tiver sido pausado, ele será retomado, caso contrário, o workflow será iniciado desde o início e as atividades iniciais serão ativadas.
Iniciar é um processo assíncrono: a solicitação é salva e processada o mais rápido possível por um servidor de workflow.
-
Pause
Esta ação define o status do workflow como Pausado. Nenhuma atividade é ativada até que o workflow seja retomado. No entanto, as operações em andamento não são interrompidas.
-
Stop
Esta ação interrompe um workflow sendo executado no momento. O status da instância é definido como Concluído. Se possível, as operações em andamento são interrompidas. Importações e queries SQL são canceladas imediatamente.
note important IMPORTANT A interrupção de um workflow é um processo assíncrono: a solicitação é registrada e, em seguida, o servidor ou servidores de workflow cancelam as operações em andamento. A interrupção de uma instância de fluxo de trabalho pode demorar, especialmente se o fluxo de trabalho estiver em execução em vários servidores, em que cada um deles deve assumir o controle para cancelar as tarefas em andamento. Para evitar problemas, aguarde a conclusão da operação de interrupção e não execute várias solicitações de interrupção no mesmo fluxo de trabalho. -
Unconditional stop
Essa opção altera o status do fluxo de trabalho para Finished. Essa ação só deve ser usada como último recurso se o processo de interrupção normal falhar após alguns minutos. Use apenas a interrupção incondicional se tiver certeza de que não há tarefas de workflow em andamento.
note caution CAUTION A interrupção incondicional é restrita aos usuários administradores. -
Restart
Essa ação interrompe e depois retoma o workflow. Na maioria dos casos, é possível reiniciar mais rápido. Também é útil automatizar a reinicialização quando a interrupção leva um determinado tempo: isso ocorre porque o comando 'Parar' não está disponível quando o workflow está sendo interrompido.
As ações Start / Pause / Stop / Restart também estão disponíveis por meio dos ícones de execução na barra de ferramentas. Para obter mais informações, consulte esta seção.
Observe que a ação Reiniciar não limpa as variáveis da instância do fluxo de trabalho como as ações Execução, Parar e Iniciar (a limpeza das variáveis da instância ocorre a partir da ação Iniciar). Ao reiniciar um fluxo de trabalho, as variáveis da instância ainda estão disponíveis para uso com valores preservados. Para configurá-las, você pode:
-
Executar as ações Parar e Iniciar.
-
Adicionar o código Javascript abaixo no final da execução do fluxo de trabalho:
code language-none var wkf = xtk.workflow.load(instance.id) wkf.variables='<variables/>' wkf.save()
-
-
Purge history
Essa ação permite limpar o histórico do workflow. Para obter mais informações, consulte Limpeza de logs.
-
Start in simulation mode
Essa opção permite iniciar o fluxo de trabalho no modo de simulação em vez do modo real. Isso significa que ao habilitar esse modo, somente as atividades que não afetam o banco de dados ou o sistema de arquivos serão executadas (por exemplo, Query, Union, Intersection, etc.). Atividades que têm impacto (por exemplo, Export, Import, etc.) assim como as posteriores (na mesma ramificação) não são executadas.
-
Execute pending tasks now
Essa ação permite iniciar todas as tarefas pendentes assim que possível. Para iniciar uma tarefa específica, clique com o botão direito do mouse na atividade e selecione Execute pending task(s) now.
-
Save as template
Essa ação cria um novo modelo de fluxo de trabalho com base no fluxo de trabalho selecionado. Você precisa especificar a pasta onde ele será salvo (no campo Folder).
As opções Mass update of selected lines e Merge selected lines são opções genéricas de plataforma disponíveis em todos os menus Actions. Para obter mais informações, consulte esta seção.
Práticas recomendadas de execução de workflows workflow-execution-best-practices
É recomendável não agendar um fluxo de trabalho para execução por mais de 15 minutos, pois isso pode atrapalhar o desempenho geral do sistema e criar bloqueios no banco de dados.
Evite deixar os fluxos de trabalho no estado pausado. Se criar um fluxo de trabalho temporário, certifique-se de que ele será concluído corretamente e não permanecerá no estado paused. Se estiver pausado, isso significa que é preciso manter as tabelas temporárias e, portanto, aumentar o tamanho do banco de dados. Atribua supervisores de workflow nas propriedades do workflow para enviar um alerta quando um workflow falhar ou for pausado pelo sistema.
Para evitar workflows no estado pausado:
- Verifique seus workflows regularmente para garantir que não haja erros inesperados.
- Mantenha seus workflows o mais simples possível, por exemplo, dividindo grandes workflows em vários workflows diferentes. É possível usar as atividades External signal para acionar a execução com base na execução de outros fluxos de trabalho.
- Evite desabilitar atividades com fluxos nos fluxos de trabalho, deixando threads abertos e levando a muitas tabelas temporárias que podem consumir muito espaço. Não mantenha as atividades nos estados Do not enable ou Enable but do not execute em seus fluxos de trabalho.
Interromper fluxos de trabalho não utilizados. Os fluxos de trabalho que continuam em execução mantêm conexões com o banco de dados.
Use a interrupção incondicional apenas nos casos mais raros. Esta opção é restrita aos usuários administradores. Não utilize esta ação regularmente. Não executar um encerramento limpo nas conexões geradas pelos workflows com o banco de dados afeta o desempenho.
Não execute várias solicitações de interrupção no mesmo fluxo de trabalho. A interrupção de um workflow é um processo assíncrono: a solicitação é registrada e, em seguida, o servidor ou servidores de workflow cancelam as operações em andamento. A interrupção de uma instância de fluxo de trabalho pode demorar, especialmente se o fluxo de trabalho estiver em execução em vários servidores, em que cada um deles deve assumir o controle para cancelar as tarefas em andamento. Para evitar problemas, aguarde a conclusão da operação de interrupção e evite interromper um fluxo de trabalho várias vezes.
Menu de contexto right-click-menu
Quando uma ou mais atividades de workflow forem selecionadas, você pode clicar com o botão direito do mouse para agir em sua seleção.
As seguintes opções estão disponíveis no menu de contexto:
Open: esta opção permite acessar as propriedades da atividade.
Display logs: essa opção permite exibir o log de execução da tarefa para a atividade selecionada. Consulte Exibir logs.
Execute pending task(s) now: essa ação permite iniciar tarefas pendentes assim que possível.
Workflow restart from a task: essa opção permite reiniciar o fluxo de trabalho usando os resultados armazenados anteriormente para essa atividade.
Cut/Copy/Paste/Delete: essas opções permitem recortar, copiar, colar e excluir atividades.
Copy as bitmap: essa opção permite capturar a tela de todas as atividades.
Normal execution / Enable but do not execute / Do not enable: essas opções também estão disponíveis na guia Advanced das propriedades da atividade. Maiores detalhes em Execution.
Save / Cancel: permite salvar ou cancelar as alterações feitas em um fluxo de trabalho.
O menu de contexto também é detalhado nesta seção.