--- sourceDocument: Capacidades da Now Platform da Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Capacidades da Now Platform da Yokohama ft:clusterId : - platcap bundleId : - platcap workflow : - Platform --- # Atividade de fluxo de trabalho do inicializador de fluxo paralelo # Atividade de fluxo de trabalho do inicializador de fluxo paralelo {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura A atividade do inicializador de fluxo paralelo inicia vários subfluxos em paralelo.{#r_ParallelFlowLauncher__wf-parallel-flow-activity-shortdesc} 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. {#r_ParallelFlowLauncher__table_rvx_lj1_hr__entry__2} | 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](https://servicenow-prod.fluidtopics.net/Ufor5T4Nfd5Yc_DCFlbhiw "Este exemplo mostra como usar a atividade do Inicializador de fluxo paralelocom uma matriz de valores de entrada e com um objeto WorkflowCoordinator."). | | 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](https://servicenow-prod.fluidtopics.net/_6lDiAJyJ01b1bJdXfJRcg "Um objeto WorkflowCoordinator especifica quais subfluxos executar e as variáveis de entrada a serem passadas para esses subfluxos."). | | 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](https://servicenow-prod.fluidtopics.net/QjqW64VeepL7e35mNP8nzw "A atividade do Inicializador de fluxo paralelo expõe variáveis adicionais que você pode usar 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. | [Tabela 1. Variáveis de entrada de atividade do inicializador de fluxo paralelo] {#r_ParallelFlowLauncher__table_rvx_lj1_hr} ## 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. {#r_ParallelFlowLauncher__table_lsz_hfy_jr__entry__2} | 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 | [Tabela 2. Estados da atividade do Inicializador de fluxo paralelo] {#r_ParallelFlowLauncher__table_lsz_hfy_jr} * **[Objeto WorkflowCoordinator](https://servicenow-prod.fluidtopics.net/_6lDiAJyJ01b1bJdXfJRcg)** Um objeto WorkflowCoordinator especifica quais subfluxos executar e as variáveis de entrada a serem passadas para esses subfluxos. * **[Valores de subfluxo concluído em scripts](https://servicenow-prod.fluidtopics.net/QjqW64VeepL7e35mNP8nzw)** A atividade do Inicializador de fluxo paralelo expõe variáveis adicionais que você pode usar em scripts. * **[Exemplo de Inicializador de fluxo paralelo](https://servicenow-prod.fluidtopics.net/Ufor5T4Nfd5Yc_DCFlbhiw)** Este exemplo mostra como usar a atividade do Inicializador de fluxo paralelocom uma matriz de valores de entrada e com um objeto WorkflowCoordinator.