Configurer les valeurs de choix du champ d’état

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture

    • Les champs d’état sont un sous-ensemble de champs de liste de choix. Gardez à l’esprit les informations suivantes lorsque vous configurez des valeurs de choix pour le champ État.

    • Utilisez une valeur négative pour ajouter un nouveau champ d’état actif.
    • Recherchez et étudiez les règles métier qui utilisent un filtre numérique d’état sur les champs Script et Conditions . Vous pouvez utiliser l’outil de débogage pour suivre l’ordre d’exécution de la règle métier.
    • Les nouvelles valeurs représentant les états inactifs doivent avoir une valeur supérieure à 8.

    Vous pouvez définir l’un des attributs suivants pour un champ d’état en configurant le dictionnaire. Si les attributs ne sont pas définis, le système utilise les valeurs par défaut. L’API TaskStateUtil utilise les attributs suivants. Pour plus d’informations sur l’API TaskStateUtil, consultez TaskStateUtil.

    Tableau 1. Attributs associés
    Attribut Définition
    close_states Liste délimitée par des points-virgules des valeurs d’état inactives, utilisée pour identifier si la tâche doit être définie sur actif ou inactif. Il s’agit d’un attribut obligatoire pour utiliser la fonctionnalité TaskStateUtil.
    default_close_state Attribut facultatif pour définir la valeur d’état de l’état de fermeture par défaut si vous souhaitez définir des règles métier qui ferment automatiquement une tâche. La valeur par défaut est 3, généralement Fermé terminé si l’attribut n’est pas défini.
    default_work_state Attribut facultatif pour définir la valeur d’état de l’état de travail par défaut si vous souhaitez définir des règles métier qui définissent automatiquement une tâche pour travailler. La valeur par défaut est 2, généralement Travail en cours si l’attribut n’est pas défini.

    Exemples de modification d’état

    Suivez ces exemples pour modifier l’état des incidents et des demandes de changement.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Définition du système > Listes de choix.
    2. En haut de la liste, créez un filtre de liste comme suit :
      • Table : incident
      • Élément : incident_state
    3. Appliquez le filtre.

      Notez que l’état Fermé a une valeur de 7 et l’état Résolu a une valeur de 6. Tout état supérieur ou égal à 7 est supposé inactif. Par conséquent, vous devez utiliser un entier positif supérieur à 7 si vous souhaitez ajouter un nouvel état de type inactif. Utilisez une valeur négative comme -1 ou -2 si vous souhaitez ajouter un nouveau champ d’état de type actif, tel que En attente du fournisseur.

    4. Accéder à nouveau à Définition du système > Listes de choix.
    5. En haut de la liste, créez un filtre de liste comme suit :
      • Tableau : change_request
      • Élément : phase_state
    6. Appliquez le filtre.

      Notez que l’état Terminé a une valeur de 8. Tout état supérieur ou égal à 8 est supposé inactif. Par conséquent, vous devez utiliser un entier positif supérieur à 8 si vous souhaitez ajouter un nouvel état de type inactif, tel que Annulé. Utilisez une valeur négative comme -1 ou -2 si vous souhaitez ajouter un nouveau champ d’état de type actif, tel que En attente.

    Résoudre les problèmes liés aux états de changement et aux règles métier

    Les règles métier du système font des hypothèses sur les valeurs d’état. Vous pouvez résoudre les problèmes liés aux règles métier pour voir leur ordre d’exécution et voir comment cela affecte les changements que vous apportez aux valeurs du champ État .

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Définition du système > Règles métier.
    2. Construisez un filtre comme celui-ci pour afficher les scripts et les conditions qui se rapportent à la incident_state résolue de 6 ou à la valeur de incident_state fermée de 7 :

      Le champ Script contient 7 OU le champ Condition contient 7 OU le champ Script contient 6 OU le champ Condition contient 6 ET le champ Table est incident ET le champ Actif est vrai.

    Que faire ensuite

    Voir Déboguer une règle métier pour plus d’informations sur la façon de tracer l’ordre d’exécution des règles métier. Vous pouvez cliquer sur Tout déboguer, résoudre un incident, puis consulter la trace en bas du formulaire pour observer l’exécution des règles métier. Ces deux exemples de lignes montrent que le code de la règle métier mark_closed est entré ==> puis quitté <==.

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