Configurer les valeurs de choix de champ d’état

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • Les champs d’état sont un sous-ensemble des champs de liste de choix. Gardez les informations suivantes à l’esprit 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 de numéro d’état sur les champs Script et Conditions . Vous pouvez utiliser l’outil Débogage pour tracer l’ordre d’exécution de la règle métier.
    • Les nouvelles valeurs représentant des états inactifs doivent avoir une valeur supérieure à 8.

    Vous pouvez définir n’importe lequel 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 connexes
    Attribut Définition
    close_states Liste de valeurs d’état inactives séparées par des points-virgules, qui permet d’identifier si la tâche doit être définie sur active ou inactive. Il s’agit d’un attribut obligatoire pour utiliser la fonctionnalité TaskStateUtil.
    default_close_state Attribut facultatif permettant de définir la valeur d’é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 fonctionnement 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 modifications d’état

    Suivez ces exemples pour modifier les états des incidents et des demandes de changement.

    Avant de commencer

    Rôle requis : administrateur

    Procédure

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

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

    4. Naviguez à nouveau vers Définition du système > Listes de choix.
    5. En haut de la liste, créez un filtre de liste comme celui-ci :
      • Table : change_request
      • Élément : phase_state
    6. Appliquez le filtre.

      Notez que l’état Complet a une valeur de 8. Tout état supérieur ou égal à 8 est supposé inactif. Par conséquent, vous devez utiliser un nombre entier positif supérieur à 8 si vous souhaitez ajouter un nouveau type d’état 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.

    Dépanner les états de changement et les règles métier

    Les règles métier du système émettent des hypothèses sur les valeurs d’état. Vous pouvez dépanner les règles métier pour voir l’ordre dans lequel elles s’exécutent et voir comment cela affecte les modifications que vous apportez aux valeurs de champ État .

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. Accédez à la Tout > 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 de script en contient 7 OU le champ Condition en contient 7 OU le champ de script en contient 6 OU le champ Condition en contient 6 ET le champ Table est incident ET le champ Actif est vrai.

    Que faire ensuite

    Reportez-vous à la section 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 vérifier la trace au bas du formulaire pour observer l’exécution des règles métier. Ces deux exemples de ligne montrent que le code de règle métier mark_closed est saisi ==> puis quitté <==.

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