Configure valores de opção de campo de estado

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Os campos de estado são um subconjunto dos campos da lista de seleção. Lembre-se das seguintes informações ao configurar valores de opção para o campo estado.

    • Use um valor negativo para adicionar um novo campo de estado ativo.
    • PESQUISE e estude as regras de negócios que usam um filtro de número de estado no Script e. Condições campos. Você pode usar a ferramenta Depuração para rastrear a ordem de execução da regra de negócio.
    • Os novos valores que representam estados inativos devem ter um valor acima de 8.

    Você pode definir qualquer um dos atributos a seguir para um campo de estado configurando o dicionário. Se os atributos não estiverem definidos, o sistema usará os valores padrão. A API TaskStateUtil usa os seguintes atributos. Para obter mais informações sobre a API TaskStateUtil, consulte TaskStateUtil .

    Tabela 1. Atributos relacionados
    Atributo Definição
    close_states Lista delimitada por ponto e vírgula de valores de estado inativos, usada para identificar se a tarefa deve ser definida como ativa ou inativa. Este é um atributo obrigatório para usar a funcionalidade TaskStateUtil.
    default_close_state Atributo opcional para definir o valor de estado do estado de fechamento padrão se você quiser definir regras de negócios que encerram automaticamente uma tarefa. O padrão é 3, normalmente Encerrado concluído se o atributo não estiver definido.
    default_work_state Atributo opcional para definir o valor de estado do estado de trabalho padrão se você quiser definir regras de negócios que definem automaticamente uma tarefa para trabalho. O padrão é 2, normalmente Trabalho em andamento se o atributo não estiver definido.

    Exemplos de modificação de estado

    Siga estes exemplos para modificar os estados de incidentes e solicitações de mudança.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Definição do Sistema > Listas de Seleção.
    2. Na parte superior da lista, crie um filtro de lista como este:
      • Tabela : incidente
      • Elemento : incident_state
    3. Execute o filtro.

      Observe que Encerrado o estado tem um valor de 7 e o. Resolvido o estado tem um valor de 6 . Qualquer estado maior ou igual a. 7 é considerado inativo. Portanto, você deve usar um número inteiro positivo maior que 7 se você quiser adicionar um novo tipo inativo de estado. Use um valor negativo como -1 ou -2 se você quiser adicionar um novo campo de estado de tipo ativo, como Aguardando fornecedor .

    4. Navegue novamente até Definição do Sistema > Listas de Seleção.
    5. Na parte superior da lista, crie um filtro de lista como este:
      • Tabela : change_request
      • Elemento : phase_state
    6. Execute o filtro.

      Observe que Concluído o estado tem um valor de 8 . Qualquer estado maior ou igual a. 8 é considerado inativo. Portanto, você deve usar um número inteiro positivo maior que 8 se você quiser adicionar um novo tipo inativo de estado, como Cancelado . Use um valor negativo como -1 ou -2 se você quiser adicionar um novo campo de estado de tipo ativo, como Pendente .

    Problemas de estados de mudança e regras de negócios

    As regras de negócio no sistema fazem suposições sobre valores de estado. Você pode solucionar problemas de regras de negócios para ver a ordem em que elas são executadas e ver como isso afeta as mudanças feitas Estado valores de campo.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Definição do Sistema > Regras de negócio.
    2. Construa um filtro como este para exibir os scripts e condições que pertencem ao resolved incident_state de 6 ou ao valor closed incident_state de 7:

      . Script O campo contém 7 OU Condição O campo contém 7 OU Script O campo contém 6 OU Condição O campo contém 6 E o. Tabela O campo é Incidente E Ativo o campo é verdadeiro.

    O que Fazer Depois

    Consulte Depurar regra de negócio para obter informações sobre como rastrear a ordem de execução da regra de negócio. Você pode clicar em Depurar tudo , resolva um incidente e verifique o rastreamento na parte inferior do formulário para observar a execução das regras de negócio. Esses dois exemplos de linha mostram que o código de regra de negócio mark_closed foi inserido . e saiu . .

    
    ==> 'mark_closed' on incident
    <== 'mark_closed' on incident