Configurer les valeurs de choix du champ d’état

Les champs d’état sont un sous-ensemble des 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 de numéro d’état dans les champs Script et Conditions . Vous pouvez utiliser l’outil Déboguer pour suivre l’ordre d’exécution des règles métier.
• Les nouvelles valeurs représentant des é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 de valeurs d’état inactives séparées par des points-virgules, utilisée pour déterminer si la tâche doit être définie comme 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 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 de travail. 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 les états 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 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 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 jusqu’à 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 Terminé a une valeur de 8. Tout état supérieur ou égal à 8 est considéré comme 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 telle que -1 ou -2 si vous souhaitez ajouter un nouveau type actif de champ d’état, tel que En attente.

Dépanner les états des changements et les règles métier

Les règles métier du système formulent des hypothèses sur les valeurs d’état. Vous pouvez résoudre les problèmes liés aux règles métier pour connaître leur ordre d’exécution et voir comment cela affecte les modifications que vous apportez aux valeurs des champs É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 en contient 7 OU le champ Condition en contient 7 OU le champ 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

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 Déboguer tout, résoudre un incident, puis vérifier la trace en bas du formulaire pour observer l’exécution des règles métier. Ces deux exemples de ligne montrent que le code mark_closed règle métier est entré ==> puis quitté <==.

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