Fases de fluxo e subfluxo

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 6 min. de leitura
  • Comunique a fase atual de uma solicitação, fluxo ou subfluxo com um usuário final.

    Ao configurar fases em Workflow Studio, você pode:

    • Adicionar fases a um fluxo ou subfluxo
    • Mude rótulos e nomes de fases.
    • Configure a duração estimada de uma fase.
    • Importe uma cópia de um conjunto de fases predefinido da tabela Conjuntos de fases. Para saber mais sobre conjuntos de fases, consulte Conjuntos de fases de fluxo de trabalho. Quaisquer mudanças feitas na cópia não afetam o registro do conjunto de fases original.

    Você pode exibir as fases de um fluxo ou subfluxo nos detalhes de execução.

    Exibição de fases em um campo de fase

    Um campo de fase armazena e exibe o estado da fase e os detalhes sobre um registro específico conforme a execução de um fluxo ou um subfluxo. Por exemplo, a tabela Catálogo de serviços usa o campo Fase para indicar o andamento de uma solicitação conforme ela é processada.

    Os campos de fase exibem:

    • Detalhes da fase para o registro específico que acionou o fluxo ou que foi usado como uma entrada de subfluxo. Por exemplo, o estado atual de um item solicitado Catálogo de serviços específico.
    • Nomes de fase e estados definidos no fluxo ou subfluxo associado. Se o fluxo associado chamar outro fluxo, as fases definidas no fluxo secundário não serão exibidas.
    • Detalhes da fase de fluxos ou subfluxos que foram iniciados. Se um fluxo ou subfluxo não estiver em execução para um registro, esse registro não terá detalhes de campo de fase.

    Os ícones de estado nos campos de fase não podem ser modificados. Limite o número de fases e o tamanho do nome de cada fase para evitar que o texto e os ícones sejam quebrados em várias linhas.

    Nota:
    Adicione apenas um campo de fase por tabela. Se houver mais de um campo de fase, o sistema exibirá somente as fases do primeiro campo de fase definido na entrada do dicionário da tabela.

    Campo de fase e tipos de gatilho

    A associação de um fluxo a um campo de fase depende do tipo de gatilho de fluxo.

    Tipo de gatilho de fluxo Requisitos
    Registro

    Para um campo de fase relatar fases em um fluxo baseado em registro, deve estar presente um campo de fase na mesma tabela que o registro-gatilho. quando um fluxo tem fases, Workflow Studio comunica o status de cada fase de volta para a tabela de acionamento e exibe o estado da fase atual como um ícone. Se houver mais de um campo de fase na tabela, somente o primeiro campo de fase definido na definição do dicionário da tabela será usado.

    Nota:
    Evite criar fases para vários fluxos que são acionados na mesma tabela. Um campo de fase exibe somente as fases do fluxo final a ser executado. Adicione condições diferentes a cada fluxo para garantir que as fases de um fluxo não substituam outro fluxo.
    Catálogo de serviços Se estiver usando o Catálogo de serviços gatilho, o fluxo deve ser associado ao item Catálogo de serviços por meio do campo Fluxo. Remova todos os fluxos de trabalho associados ao item limpando os campos Fluxo de trabalho e Plano de execução. O campo Fase exibe o estado da fase atual em qualquer exibição de lista da tabela Itens solicitados [sc_req_item].
    Nota:
    Embora seja possível adicionar fases a um fluxo que tem um gatilho programado, as fases nunca são exibidas para um usuário final porque não há um registro de gatilho associado para o campo de fase. Somente adicione fases a fluxos e subfluxos que tenham um gatilho ou um registro de entrada.

    Estados de fase

    Durante a execução do fluxo ou subfluxo, cada fase pode estar em um de seis estados.

    Estado Descrição
    Pendente Esta fase ainda não foi iniciada.
    Em andamento Esta fase está em execução.
    Omitido Esta fase foi ignorada e não foi executada. Normalmente, esse estado é atingido quando um bloco de lógica de fluxo condicional não é executado.
    Concluir Esta fase está concluída.
    Cancelado(a) Esta fase foi cancelada.
    Erro

    Esta fase atingiu uma condição de erro.

    Ao projetar um fluxo ou subfluxo, você pode definir manualmente para relatar um estado de Erro. Para definir um estado de Erro:
    • O fluxo ou subfluxo deve ter pelo menos uma fase definida.
    • O erro só pode ser definido dentro de uma fase. Quando uma condição de erro é atingida, o estágio atual é definido como Erro.
    • O erro só pode ser definido dentro de um bloco de lógica de fluxo condicional.

    Cada fase pode ter seus próprios rótulos de estado personalizados. Por exemplo, suponha que você tenha um fluxo com duas fases. A Fase 1 pode ter o estado Pendente com o rótulo Aguardando e a Fase 2 pode ter um estado Pendente com um rótulo de Ainda não iniciado. Workflow Studio fornece opções para gerar os estados padrão ou estados de aprovação.

    Propriedades do sistema

    Você pode usar essas propriedades do sistema para configurar como um fluxo ou subfluxo exibe detalhes de aprovação.

    com.glide.hub.flow_engine.stage_display.show_approvers
    Mostre ou oculte a lista de aprovadores atribuídos a uma fase de um campo de fase. Defina o valor como verdadeiro para mostrar a lista de aprovadores atribuídos a uma fase. Defina o valor como falso para ocultar a lista de aprovadores atribuídos a uma fase.
    • Tipo: verdadeiro | falso
    • Valor padrão: verdadeiro
    • Local: adicionar à tabela [sys_properties] de propriedades do sistema
    com.glide.hub.flow_engine.stage_display.show_approvers_limit
    Especifique o número máximo de aprovadores a serem exibidos em um campo de fase como um valor inteiro. Definir este valor acima de 10 pode causar erros de renderização em uma exibição de lista. O campo de fase de um registro pode se tornar tão grande que a lista não pode exibir registros adicionais na lista.
    • Tipo: inteiro
    • Valor padrão: 5
    • Local: adicionar à tabela [sys_properties] de propriedades do sistema

    Diretrizes gerais

    Siga estas diretrizes gerais ao criar fluxos ou subfluxos com fases.
    Evite definir fases que dependem de uma lógica de fluxo "Para cada"
    O Flow Designer evita que você adicione fases em um bloco Para cada. Você só pode adicionar fases antes ou depois de um bloco Para cada.
    Evite criar fases para os mesmos registros em diferentes fluxos ou subfluxos
    Um campo de fase sempre exibe as informações de fase fornecidas pelo último fluxo ou subfluxo a ser executado no registro de uma tabela. Se vários fluxos ou subfluxos forem executados nos mesmos registros, as fases definidas em um fluxo ou subfluxo poderão, em princípio, substituir as fases de outro fluxo ou subfluxo. Para evitar que vários fluxos ou subfluxos substituam as fases um do outro, defina um gatilho exclusivo ou condições de início para cada fluxo ou subfluxo.
    Evite atualizar campos de fase de fora de um fluxo ou subfluxo
    Se você gerenciar fases com um fluxo ou subfluxo, evite atualizar diretamente os campos de fase do registro de fora do fluxo ou subfluxo. Atualizar manualmente o valor de um campo de fase pode produzir resultados inesperados ou indesejados.
    Certifique-se de que cada fluxo em uma tabela tenha condições de gatilho exclusivas
    Adicionar condições de gatilho exclusivas a cada fluxo garante que os fluxos sejam executados somente sob essas condições e evita que as fases de um fluxo substituam as fases de outro fluxo. A especificação de condições de gatilho exclusivas facilita a solução de problemas de fluxos, limitando o número de execuções de fluxo que podem produzir mudanças de registro.
    Usar fases de erro para se comunicar com o usuário
    O estado de erro de fluxo não afeta a execução do fluxo. Um fluxo continua em execução mesmo se atingir uma fase de erro. Use um bloco de lógica de fluxo condicional para definir a fase de erro e comunicar ao usuário que o estado da fase atual é Erro. Por exemplo, se uma aprovação não for aprovada dentro do limite necessário, convém comunicar um erro ao usuário.
    Use a fase de erro para interromper o processamento de um fluxo
    Use um bloco de lógica de fluxo condicional para identificar quando um fluxo entra na fase de erro. Use a lógica de fluxo para interromper o processamento do fluxo ou realizar algum tipo de ação de correção. Por exemplo, você pode mudar o estado ou a atribuição do registro quando um fluxo atinge um estado de erro.