Renderizadores de fase do fluxo de trabalho

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 8 min. de leitura
  • Os renderizadores de fase do fluxo de trabalho determinam como um fluxo de trabalho exibe as fases em um campo de fluxo de trabalho.

    Existem vários renderizadores disponíveis.
    Nota:
    A maioria dos fluxos de trabalho deve usar o renderizador voltado para fluxo de trabalho. Esse renderizador é usado por padrão para todos os fluxos de trabalho. Use um renderizador de fase diferente somente após uma consideração cuidadosa e para atender a requisitos específicos de exibição das fases.

    Orientado por fluxo de trabalho

    Use o renderizador voltado para fluxo de trabalho o máximo possível. Esse renderizador exibe ícones para fases usando o estado de fase controlado pelo fluxo de trabalho. Os ícones são exibidos de maneira significativa em muitas situações. O renderizador pode exibir fases de um fluxo de trabalho principal e de subfluxos. A ordem dos ícones é determinada pelo caminho esperado do fluxo de trabalho em execução. Conforme o fluxo de trabalho progride, as fases nos caminhos que o fluxo de trabalho não percorreu são removidas da exibição. As fases de caminhos diferentes do caminho esperado não são incluídas, a menos que o fluxo de trabalho siga esse caminho.

    O campo Ordem das fases na guia Fases tem duas opções:
    • Computado usa o caminho do fluxo de trabalho real na ordem.
    • Especificado pelo usuário usa a ordem especificada na coluna Ordem do registro de fases do fluxo de trabalho.
    Nota:
    Se o contexto do fluxo de trabalho de um item de solicitação tiver sido excluído, as fases desse item de solicitação não poderão mais ser renderizadas. Esse histórico de fase é armazenado no contexto de fluxo de trabalho.

    Fluxo principal

    O renderizador de fluxo principal exibe ícones para fases definidas somente no fluxo de trabalho principal. Use esse renderizador quando você não quiser expor os detalhes dos subfluxos. Por exemplo, um único fluxo de trabalho principal pode executar vários subfluxos para lidar com detalhes de implementação. As fases nesses subfluxos não fornecem informações úteis para o usuário que inicia o fluxo de trabalho, mas são úteis ao editar o subfluxo. Neste cenário, o uso do renderizador de fluxo principal proporciona a melhor experiência do usuário. O campo de fase exibe o processo de alto nível do fluxo de trabalho sem expor detalhes desnecessários.
    O campo Ordem das fases na guia Fases tem duas opções:
    • Computado usa o caminho do fluxo de trabalho real na ordem.
    • Especificado pelo usuário usa a ordem especificada na coluna Ordem do registro de fases do fluxo de trabalho.

    Lineares

    A renderização linear exibe todos os ícones de fase do fluxo de trabalho principal e todos os subfluxos em um único campo de fluxo de trabalho de uma lista ou um formulário. Ela exibe ícones em uma sequência linear, sejam quais forem os caminhos que o fluxo de trabalho segue à medida que é executado. Este renderizador usa fases definidas no fluxo de trabalho principal e em todos os subfluxos que o fluxo principal iniciar. Os ícones aparecem na ordem especificada pelo usuário. As fases ignoradas não são exibidas.

    Use esse renderizador quando as fases do fluxo de trabalho precisarem ser exibidas em uma ordem consistente e os detalhes reais da execução do fluxo de trabalho forem menos importantes. Por exemplo, um fluxo de trabalho pode revisitar ou reverter para fases anteriores com base em uma ou mais Condition Workflow activities. A exibição desses loops no campo de fase não fornece informações úteis para o usuário. Neste cenário, o uso do renderizador linear proporciona a melhor experiência do usuário. O campo de fase exibe o processo predefinido, incluindo fases de subfluxos, em uma ordem consistente.

    Por exemplo, você pode criar um fluxo de trabalho de catálogo de serviços que usa um subfluxo para concluir a entrega do item solicitado. As imagens a seguir ilustram o fluxo principal e o subfluxo para solicitar suprimentos com a identidade visual corporativa.
    Figura 1. Fluxo principal linear
    Figura 2. Subfluxo linear

    O renderizador linear exibe todas essas fases em um campo de fluxo de trabalho. O fluxo de trabalho primário especifica as fases Aguardando aprovação, Execução e Concluído. O subfluxo especifica as fases Entrega, Aguardando tarefa e Entrega OK.

    Barra de andamento

    O renderizador da barra de andamento exibe uma única barra de andamento em vez de uma sequência de ícones de fase. Esse renderizador é particularmente útil quando você deseja exibir o andamento geral do fluxo de trabalho como um percentual. Cada fase do fluxo de trabalho controla uma porcentagem igual da barra de andamento. Por exemplo, se um fluxo de trabalho tiver dez fases, o atingimento de cada fase fará com que o campo de fluxo de trabalho exiba um adicional de 10% na barra de andamento. Os nomes das fases não aparecem na barra de andamento.

    O renderizador da barra de andamento propicia uma maneira de exibir o status de um fluxo de trabalho que tem um grande número de fases. Outras opções de renderização podem oferecer uma experiência do usuário melhor na renderização de menos de quatro fases em um único fluxo de trabalho.

    O campo Ordem das fases na guia Fases tem duas opções:
    • Computado usa o caminho do fluxo de trabalho real na ordem.
    • Especificado pelo usuário usa a ordem especificada na coluna Ordem do registro de fases do fluxo de trabalho.
    Figura 3. Barra de andamento do campo de fluxo de trabalho

    Legado

    O renderizador legado exibe fases da mesma forma que as versões anteriores a Dublin. Quando uma instância é atualizada a partir de uma versão anterior a Dublin, todos os fluxos de trabalho existentes são definidos para usar o renderizador legado. Sempre que possível, use um renderizador de fase diferente. Se você quiser que seu fluxo de trabalho mantenha o comportamento anterior a Dublin, use a opção Legado. O renderizador legado às vezes atribui dados incorretos e/ou relata dados incorretos do campo de fase do fluxo de trabalho. Se possível, recomendamos que todos os fluxos de trabalho usem o renderizador voltado para fluxo de trabalho.

    Com o renderizador legado, você pode criar e fazer referência a um conjunto personalizado de ícones de campo de fluxo de trabalho, definindo o atributo de ícones para uma nova inclusão de script. Por exemplo, se quiser usar a inclusão de script WorkflowIconsSCR para definir quais ícones usar, adicione o atributo icons=WorkflowIconsSCR ao campo Atributos da entrada de dicionário do campo de fluxo de trabalho. Para usar o comportamento de exibição de ícone padrão, use o atributo icons=WorkflowIconsStages.

    O renderizador legado funciona com todas as tabelas, exceto Item solicitado [sc_req_item]. Nesse caso, use o renderizador de item solicitado.

    Item solicitado

    O renderizador de item solicitado funciona da mesma maneira que o renderizador legado, mas se destina ao uso com a tabela Item solicitado [sc_req_item].

    O renderizador de fase padrão é usado somente no Now Mobile.

    Seleção de um renderizador de fase

    Na maioria dos casos, deve ser usado o renderizador voltado para fluxo de trabalho padrão. Se você tiver requisitos específicos para exibir fases, poderá selecionar um renderizador de fase diferente.

    Antes de Iniciar

    Considere o seguinte ao selecionar um renderizador de fase:
    • Use o renderizador voltado para fluxo de trabalho, se possível. Esse é o renderizador padrão que deve ser usado na maioria dos casos.
    • Use o renderizador legado somente se sua instância foi atualizada de uma versão anterior a Dublin e você deseja que o fluxo de trabalho mantenha o comportamento anterior a Dublin.

    Para usar renderização linear, de fluxo principal ou de barra de andamento, é preciso atender aos requisitos a seguir.

    Tabela 1. Requisitos para renderizador linear e de barra de andamento
    Renderizador Requisitos
    Lineares
    • O fluxo de trabalho primário e todos os subfluxos precisam modificar o mesmo registro atual.
    • Nas propriedades de todos os subfluxos, o valor do campo Fase de todos os subfluxos precisa corresponder ao do fluxo de trabalho primário.
    • O fluxo primário e todos os subfluxos precisam conter as mesmas fases. Use um conjunto de fases para garantir que o fluxo primário e todos os subfluxos tenham as mesmas fases.
    • Na tela de fluxo de trabalho, cada fluxo de trabalho precisa apenas das fases usadas diretamente por esse fluxo de trabalho. Não é necessário adicionar fases de subfluxos a atividades no fluxo primário ou fases do fluxo primário a atividades nos subfluxos.
    Fluxo principal
    • O fluxo de trabalho contém subfluxos.
    • Você não quer ou não precisa revelar os detalhes sobre os subfluxos.
    Barra de andamento
    • As propriedades do fluxo de trabalho precisam ter um valor de Ordenação de fases igual a Definido pelo usuário.
    • O fluxo de trabalho precisa conter fases.
    • Como os nomes das fases não aparecem em um campo de fluxo de trabalho durante o uso do renderizador da barra de andamento, você pode simplificar esses nomes para representar uma porcentagem do fluxo de trabalho. Por exemplo, se um processo tiver quatro etapas principais, nomeie as fases do fluxo de trabalho como 25%, 50%, 75% e 100%. Insira o valor numérico de cada fase, como 25, nos campos Valor e Ordem.

    Por Que e Quando Desempenhar Esta Tarefa

    Para selecionar um renderizador de fase:

    Procedimento

    1. Navegar até Tudo > Fluxo de trabalho > Editor de fluxo de trabalho.
    2. Abra e submeta o fluxo de trabalho ao check-out.
    3. Na barra de título, clique no ícone do menu e selecione Propriedades.
    4. Na caixa de diálogo "Propriedades do fluxo de trabalho", clique na guia Fases.
    5. Na lista Renderização da fase, selecione um renderizador de fase.
      • Se você estiver usando dois fluxos de trabalho para atualizar dois campos de fluxo de trabalho exclusivos em um único registro, ambos os fluxos precisarão usar um renderizador não legado. Você pode selecionar um renderizador de fase diferente para cada fluxo de trabalho, mas não selecione Legado para nenhum deles.
      • Se você quiser usar o renderizador linear, selecione Linear nas propriedades do fluxo de trabalho primário e de todos os subfluxos.
    6. Clique em Atualizar.