Atividade de fluxo de trabalho do inicializador de fluxo paralelo

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura

    • A atividade do inicializador de fluxo paralelo inicia vários subfluxos em paralelo.

    Os fluxos de trabalho em execução em paralelo são executados simultaneamente e podem ser concluídos em qualquer ordem. A atividade pode iniciar um único subfluxo ou vários subfluxos, conforme necessário. Você pode gerenciar os valores de entrada e os valores retornados para cada subfluxo.
    Nota:
    A atividade do inicializador de fluxo paralelo espera até que todos os subfluxos sejam concluídos antes de prosseguir. Se algum subfluxo não terminar, a atividade aguardará indefinidamente.

    Não inicie um grande número de subfluxos com a atividade do inicializador de fluxo paralelo. Se usada em excesso, esta atividade pode sobrecarregar a instância. Para iniciar um número muito grande de subfluxos, considere colocar o Iniciador de Fluxo Paralelo dentro de um loop controlado por uma catraca ou outra atividade condicional e fazer com que ele faça lotes.

    Variáveis de atividade

    As variáveis de atividade determinam o comportamento inicial da atividade.

    Tabela 1. Variáveis de entrada de atividade do inicializador de fluxo paralelo
    Campo Descrição
    Configuração do inicializador de fluxo paralelo
    Nome Um nome único para a atividade.
    Fase A fase a ser exibida quando o fluxo de trabalho atinge a atividade.
    Entradas Entradas para os subfluxos serem executados. Especifique uma matriz de pares de nome: valor para cada entrada definida no fluxo de trabalho que está sendo iniciado. O nome e o tipo de dados de cada variável de entrada devem corresponder aos usados pelo subfluxo que esta atividade inicia. Para obter um exemplo detalhado, consulte Exemplo do inicializador de fluxo paralelo.
    Seleção do inicializador de fluxo paralelo
    Fluxo de trabalho O fluxo de trabalho a ser executado.
    Avançado Marque Avançadopara inserir um script que usa um objeto WorkflowCoordinator para gerenciar os subfluxos. Quando você marca Avançado, é exibida uma caixa de texto na qual é possível inserir um script que especifica um fluxo de trabalho exclusivo para cada conjunto de variáveis de entrada. Para obter mais informações, consulte Objeto WorkflowCoordinator.
    Iteração do inicializador de fluxo paralelo

    Especifique parâmetros para ajustar o desempenho de fluxos de trabalho em lote.
    Contagem Se não for especificado por um conjunto de entrada, a contagem determinará o número de subfluxos executados em paralelo a partir desta atividade. Se a opção Avançado não estiver selecionada, certifique-se de que este campo esteja preenchido com um número válido.
    Fluxos máximos O número máximo de fluxos de trabalho que esta atividade pode iniciar. Se este valor for um número inteiro positivo, ele substituirá o parâmetro máximo usado no construtor WorkflowCoordinator.
    Máximo simultâneo O número máximo de fluxos de trabalho paralelos que esta atividade pode iniciar. Se este valor for um número inteiro positivo, ele substituirá o parâmetro poolsize usado no construtor WorkflowCoordinator.
    Processo do Inicializador de Fluxo paralelo
    Fluxo do Processo concluído Para especificar um script que seja executado após a conclusão de cada subfluxo, verifique a conclusão do fluxo do processo. Se você marcar este campo, será exibida uma caixa de texto chamada Fluxo concluído, na qual é possível inserir o script a ser executado.
    Fluxo concluído O script que é executado sempre que um subfluxo é concluído. Este campo está disponível quando a opção Fluxo do processo concluído é selecionada.

    As mesmas funções e variáveis de script disponíveis em outros scripts de fluxo de trabalho, como aquelas na atividade Executar Script, estão disponíveis aqui. Para obter mais informações, consulte Valores de subfluxo concluído em scripts.

    A variável "fluxo" está disponível para este script. É um objeto que contém as seguintes informações sobre o fluxo que está sendo concluído:

    flow.output (Cadeia de caracteres): o valor que o subfluxo retorna para o primário se ele executou uma atividade de valor de retorno antes de terminar.

    flow.index (Número): o índice relativo a zero do subfluxo que foi concluído.

    flow.contextId (Cadeia de caracteres): o sys_id do contexto de fluxo de trabalho do subfluxo concluído.

    flow.inputs (Objeto): as entradas que foram passadas para o subfluxo quando seu contexto foi criado e iniciado.

    flow.status (Cadeia de caracteres): o estado final do contexto. Isso corresponde à coluna de estado no registro de contexto do subfluxo, que tem valores possíveis de execução, concluído, canceladoou com falha. (Uma vez que o fluxo foi concluído, ele não pode estar em execução neste ponto.)
    Divisão do Inicializador de Fluxo paralelo
    Processo concluído Para especificar um script que seja executado após a conclusão de todos os subfluxos, marque Processo concluído. Se você marcar este campo, será exibida uma caixa de texto chamada Script concluído, na qual é possível inserir o script a ser executado. A variável "coordenador" é disponibilizada para este script e é um objeto que permite acesso a qualquer um dos subfluxos finalizados usando o método getFlow (index). Por exemplo:
    for (var i = 0; i < coordinator.getNumFlows(); i++) 
    writeFlowResultsToTable( i, coordinator.getFlow(i) );
    Script concluído O script que é executado depois que todos os subfluxos iniciados pela atividade são concluídos. Você pode usar variáveis que contêm informações de fluxo concluídas neste script.

    A variável "coordenador" é disponibilizada para este script e é um objeto que permite acesso a qualquer um dos subfluxos finalizados usando o método getFlow (index). Por exemplo:

    for (var i = 0; i < coordinator.getNumFlows(); i++) 
    writeFlowResultsToTable( i, coordinator.getFlow(i) );
    Este campo está disponível quando a opção Processo concluído é selecionada.

    Estados

    O estado da atividade informa ao mecanismo de fluxo de trabalho o que fazer com a atividade. Para exibir o estado de uma atividade, aponte para a atividade. Uma janela pop-up mostra o Estado e o Resultado da atividade. Se a atividade estiver em um estado de erro, a janela pop-up fornecerá uma descrição resumida da falha.

    Tabela 2. Estados da atividade do Inicializador de fluxo paralelo
    Estado Descrição
    Aguardando A atividade está aguardando a conclusão de todos os subfluxos. Todos os subfluxos foram iniciados e alguns podem ter sido concluídos.
    Concluído A atividade concluiu com êxito todos os subfluxos.
    Erro A atividade encontrou um erro