Configurar valores de opção de campo de estado

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura
  • Os campos de estado são um subconjunto dos campos da lista de seleção. Lembre-se das informações a seguir ao configurar valores de opção para o campo de estado.

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

    Você pode definir qualquer um dos seguintes atributos 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 que estão inativos, usada para identificar se a tarefa deve ser definida como ativa ou inativa. Este é um atributo necessário para usar a funcionalidade TaskStateUtil.
    default_close_state Atributo opcional para definir o valor do estado de fechamento padrão se você quiser definir regras de negócio que fecham automaticamente uma tarefa. O padrão é 3, normalmente Encerrado e Concluído se o atributo não estiver definido.
    default_work_state Atributo opcional para definir o valor do estado de trabalho padrão se você quiser definir regras de negócio que definem automaticamente uma tarefa como 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é Todos > Definição do Sistema > Listas de Seleção.
    2. Na parte superior da lista, crie um filtro de lista como o seguinte:
      • Tabela: incidente
      • Elemento: incident_state
    3. Execute o filtro.

      Observe que o estado Encerrado tem um valor de 7 e o estado Resolvido 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 quiser adicionar um novo tipo de estado inativo. Use um valor negativo como -1 ou -2 se quiser adicionar um novo tipo ativo de campo de estado, como Aguardando fornecedor.

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

      Observe que o estado Concluído 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 quiser adicionar um novo tipo de estado inativo, como Cancelado. Use um valor negativo como -1 ou -2 se quiser adicionar um novo tipo ativo de campo de estado, como Pendente.

    Solução de problemas de estados de mudança e regras de negócio

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

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

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

      O campo Script contém 7 OU o campo Condição contém 7 OU o campo Script contém 6 OU o campo Condição contém 6 E o campo Tabela é incidente E o campo Ativo é 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, resolver um incidente e verificar 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 é inserido ==> e, em seguida, encerrado <==.

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