Usar fluxos de estado

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura

    • Você pode criar fluxos de estado personalizados para qualquer tabela que usa estados.

    Faça com que as transições de estado ocorram em qualquer ordem ou ignore estados específicos de acordo com suas práticas de negócios. Os fluxos de estado podem gerenciar o comportamento dos campos e a visibilidade do campo em um formulário de tarefa. Os fluxos de estado também podem acionar eventos do sistema que realizam trabalhos como o envio de E-mail e notificações via SMS.

    Os administradores podem configurar fluxos de estado para:

    O plug-in de Fluxo de estado instala registros usados pela gestão de trabalho para controlar as transições de estado de pedidos de trabalho e tarefas de pedido de trabalho. Para obter informações detalhadas sobre como usar fluxos de estado da gestão de trabalho, consulte State flow customization.

    Criar e personalizar fluxos de estado requer conhecimento de script. Usuários com a função de administrador podem criar registros de fluxo de estado.

    Substituições de dicionários para fluxos de estado

    Ignorar dicionário em um fluxo de estado define o estado inicial de todos os novos registros em uma tabela específica.

    Você define uma substituição em tabelas que estendem somente uma tabela base, para que suas personalizações sejam aplicadas somente à tabela estendida.
    1. Em um registro de fluxo de estado, selecione um Estado final.

      Esse é o valor de substituição que se torna o estado inicial de todos os novos registros na tabela nomeada.

    2. Clique em Criar valor padrão.

      O sistema preenche o campo Ignorar dicionário com um valor de estado, que é o campo na tabela de tarefas afetado pela substituição. O campo Ignorar dicionário é somente leitura. Depois que a substituição é criada, o sistema oculta o botão Criar valor padrão em todos os formulários de fluxo de estado subsequentes para essa tabela.

    Eventos acionados em mudanças de estado

    Você pode configurar um fluxo de estado para acionar um evento do sistema registrado quando uma tarefa faz a transição de um estado inicial para um estado final especificado.

    Por exemplo, você pode usar eventos para acionar notificações por e-mail e criar ações de script. Quando você anexa um evento a um fluxo de estado, o sistema cria uma regra de negócio chamada Eventos de fluxo de estado para <table name> para a tabela especificada no fluxo de estado. Se você especificar um estado inicial e um estado final, a regra de negócio será executada quando o registro fizer a transição do estado inicial para o estado final. Se o fluxo de estado especificar apenas um estado final, a regra de negócio será executada sempre que esse estado final for atingido. O sistema cria uma regra de negócio para todos os fluxos de estado que contêm eventos em uma única tabela. Quando todos os eventos ou todos os fluxos de estado em uma tabela são excluídos, o sistema exclui a regra de negócio.

    Controles do campo

    Você pode definir controles para campos individuais que são impostos quando um registro faz a transição entre estados.

    As configurações na seção Controles do campo do formulário Fluxo de estado permitem que você aplique controles do campo quando o sistema detecta uma transição de estado especificada ou quando o estado final é o estado atual quando o formulário é aberto. O controle é aplicado somente aos campos existentes no formulário. Fluxos de estado não podem adicionar campos ao formulário.

    Por exemplo, você pode desejar que o campo Problema esteja visível quando um incidente for movido para o estado Aguardando problema. Se o estado do incidente mudar para Aguardando informações do usuário, oculte o campo Problema e torne o campo Solicitante obrigatório.

    Ao criar controles do campo, configure registros de fluxo de estado somente com um estado final e para criar o comportamento correto para cada estado final que você deseja controlar. Essa configuração garante que os controles do campo sejam definidos corretamente quando o usuário seleciona um novo estado e também quando o usuário retorna o campo Estado de um registro ao estado original. Somente especifique uma transição de estado completa, com um estado inicial e final, quando você quiser um comportamento específico para essa transição de estado precisa.
    Nota:
    Fluxos de estado usam client scripts para impor controles do campo. É possível que suas configurações sejam alteradas por políticas de IU existentes, que são executadas após os client scripts.
    O sistema cria os seguintes objetos, conforme necessário, para impor propriedades de campo em fluxos de estado:
    Tabela 1. Controles do campo
    Tipo Nome Descrição
    Regra de negócios Anotações de fluxo de estado para <table name> Impõe campos obrigatórios para a tabela na qual esse comportamento de campo está definido.
    Script do cliente (onLoad) <table name> fluxo de estado Define os possíveis estados e propriedades iniciais obrigatórias, somente leitura e visíveis quando um registro é carregado.
    Script do cliente (onChange) <table name> mudar o fluxo de estado Define as propriedades atualizadas obrigatórias, somente leitura e visíveis quando um registro é carregado.

    Recriar fluxos de estado

    Você pode recriar fluxos de estado quando ocorre uma incompatibilidade entre o sys_ids existente e o novo.

    Quando você usa um arquivo XML para importar um registro de fluxo de estado para uma instância, o sistema tenta corresponder os estados de entrada com os estados existentes, comparando sys_ids. Como os sys_ids de itens em uma lista de seleção podem variar entre as instâncias, o sistema pode falhar ao corresponder aos estados, mesmo que sejam idênticos.

    Quando há falha na correspondência, os estados inicial e final dos registros afetados são deixados em branco ou contêm valores numéricos. Para reparar esses registros, navegue até Fluxos de estado > Administrador > Recriar Fluxos de estado. Esse módulo executa um script que compara o valor numérico de cada item na lista de seleção do campo Estado até encontrar uma correspondência no registro de fluxo de estado importado.

    Limpeza de fluxo de estado

    Anotações de trabalho