---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# TaskStateUtil : global

# TaskStateUtil : global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture

L'include de script TaskStateUtil fournit des méthodes pour travailler avec les attributs d'état de table de type tâche.

Cet include de script est principalement utilisé par la règle métier Gestion des états actifs de la tâche pour définir le champ actif en fonction des changements d'état. Les configurations sont définies dans l'élément de dictionnaire task.state, généralement à l'aide de contournements de dictionnaire, car les valeurs d'état varient d'une table à l'autre.

Vous pouvez appeler l'include de script TaskStateUtil dans n'importe quel script serveur pour déterminer les états inactifs, travail par défaut ou états de fermeture par défaut d'une table.

Les attributs requis sont définis dans la table planned_task afin que tous les types de tâches planifiés soient pris en charge. Nous ajouterons éventuellement les attributs à d'autres types de tâches et éventuellement à la table de tâches de base. Vous êtes libre de le faire si vous souhaitez tirer parti de cette fonctionnalité maintenant.  
Ces attributs peuvent être définis sur l'élément de dictionnaire task.state ou sur un contournement de dictionnaire pour les tables de tâches étendues.{#c_TaskStateUtil__table_hv2_51h_1s__entry__2}

| 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. |
| default_close_state | Facultatif. Attribut 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. Valeur par défaut : 3, généralement Fermé terminé si l'attribut n'est pas défini. |
| default_work_state | Facultatif. Attribut 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. Valeur par défaut : 2, généralement Travail en cours si l'attribut n'est pas défini. |
[Tableau 1. Attributs connexes]

{#c_TaskStateUtil__table_hv2_51h_1s}

## TaskStateUtil : TaskStateUtil(tâche GlideRecord) {#ariaid-title2}

Crée un objet TaskStateUtil.
{#r_TaskStateUtilTaskStateUtil_GlideRecord__table_j52_1ch_1s__entry__3}

| Nom | Type | Description |
|-|-|-|
| tâche | GlideRecord | Il doit s'agir d'un GlideRecord d'une table de tâches. |
[Tableau 2. Paramètres]

{#r_TaskStateUtilTaskStateUtil_GlideRecord__table_j52_1ch_1s}  

    var stateUtil = new TaskStateUtil(current);

## TaskStateUtil : ATTR_DEFAULT_WORK {#ariaid-title3}

Nom de l'attribut qui identifie l'état de travail par défaut.
{#r_TaskStateUtil-ATTR_DEFAULT_WORK__table_lk2_qgk_xs__entry__3}

| Nom | Type | Description |
|-|-|-|
| ATTR_DEFAULT_WORK | Chaîne | Identifie l'état de travail par défaut. Valeur : default_work_state |
[Tableau 3. Champ]

{#r_TaskStateUtil-ATTR_DEFAULT_WORK__table_lk2_qgk_xs}

## TaskStateUtil : ATTR_DEFAULT_CLOSE {#ariaid-title4}

Nom de l'attribut qui identifie l'état de fermeture par défaut.
{#r_TaskStateUtil-ATTR_DEFAULT_CLOSE__table_och_chk_xs__entry__3}

| Nom | Type | Description |
|-|-|-|
| ATTR_DEFAULT_CLOSE | Chaîne | Identifie l'état de fermeture par défaut. Valeur : default_close_state |
[Tableau 4. Champ]

{#r_TaskStateUtil-ATTR_DEFAULT_CLOSE__table_och_chk_xs}

## TaskStateUtil : ATTR_INACTIVE_STATES {#ariaid-title5}

Nom de l'attribut qui identifie les états inactifs.
{#r_TaskStateUtil-ATTR_INACTIVE_STATES__table_cbk_g2k_xs__entry__3}

| Nom | Type | Description |
|-|-|-|
| ATTR_INACTIVE_STATES | Chaîne | Identifie les états inactifs. Valeur : close_states |
[Tableau 5. Champ]

{#r_TaskStateUtil-ATTR_INACTIVE_STATES__table_cbk_g2k_xs}

## TaskStateUtil : SYSTEM_DEFAULT_CLOSE {#ariaid-title6}

La valeur de l'état de fermeture par défaut est Fermé terminé dans la table Tâche.
{#r_TaskStateUtil-SYSTEM_DEFAULT_CLOSE__table_ldn_3hk_xs__entry__3}

| Nom | Type | Description |
|-|-|-|
| SYSTEM_DEFAULT_CLOSE | Entier | La valeur de l'état de fermeture par défaut est Fermé terminé dans la table Tâche. Valeur : 3 |
[Tableau 6. Champ]

{#r_TaskStateUtil-SYSTEM_DEFAULT_CLOSE__table_ldn_3hk_xs}

## TaskStateUtil : SYSTEM_DEFAULT_WORK {#ariaid-title7}

La valeur de l'état de travail par défaut est Travail en cours dans la table Tâche.
{#r_TaskStateUtil-SYSTEM_DEFAULT_WORK__table_n1l_phk_xs__entry__3}

| Nom | Type | Description |
|-|-|-|
| SYSTEM_DEFAULT_WORK | Entier | La valeur de l'état de travail par défaut est Travail en cours dans la table Tâche. Valeur : 2 |
[Tableau 7. Champ]

{#r_TaskStateUtil-SYSTEM_DEFAULT_WORK__table_n1l_phk_xs}

## TaskStateUtil : SYSTEM_INACTIVE_STATES {#ariaid-title8}

Les valeurs des états inactifs par défaut : Fermé terminé, Fermé incomplet, Fermé ignoré dans la table Tâche.
{#r_TaskStateUtil-SYSTEM_INACTIVE_STATES__table_p4w_yhk_xs__entry__3}

| Nom | Type | Description |
|-|-|-|
| SYSTEM_INACTIVE_STATES | Tableau de nombres entiers | Valeurs des états inactifs par défaut : Fermé terminé, Fermé incomplet, Fermé ignoré dans la table Tâche. Valeur : 3, 4, 7 |
[Tableau 8. Champ]

{#r_TaskStateUtil-SYSTEM_INACTIVE_STATES__table_p4w_yhk_xs}

## TaskStateUtil : getDefaultCloseState {#ariaid-title9}

Renvoie la valeur de l'état fermé par défaut.
La valeur par défaut de l'état fermé est 3 si l'attribut default_close_state n'a pas été spécifié.
{#r_TaskStateUtilGetDefaultCloseState__table_nft_hgh_1s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 9. Paramètres]

{#r_TaskStateUtilGetDefaultCloseState__table_nft_hgh_1s} {#r_TaskStateUtilGetDefaultCloseState__table_oft_hgh_1s__entry__2}

| Type | Description |
|-|-|
| Numéro | Valeur d'état représentant l'état fermé. |
[Tableau 10. Renvoie]

{#r_TaskStateUtilGetDefaultCloseState__table_oft_hgh_1s}  

    var stateUtil = new TaskStateUtil(current);
    //get the close state
    var defaultCloseState =  stateUtil.getDefaultCloseState();
    current.state = defaultCloseState;

## TaskStateUtil : getDefaultWorkState() {#ariaid-title10}

Renvoie la valeur de l'état de travail par défaut.
La valeur par défaut de l'état de travail est 2 si l'attribut default_work_state n'a pas été spécifié.
{#r_TaskStateUtilGetDefaultWorkState__table_cjr_22h_1s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 11. Paramètres]

{#r_TaskStateUtilGetDefaultWorkState__table_cjr_22h_1s} {#r_TaskStateUtilGetDefaultWorkState__table_djr_22h_1s__entry__2}

| Type | Description |
|-|-|
| Numéro | Valeur d'état représentant l'état de fonctionnement. |
[Tableau 12. Renvoie]

{#r_TaskStateUtilGetDefaultWorkState__table_djr_22h_1s}  

    var stateUtil = new TaskStateUtil(current);
    //get the work state
    var defaultWorkState =  stateUtil.getDefaultWorkState();
    current.state = defaultWorkState;

## TaskStateUtil : getInactiveStates {#ariaid-title11}

Renvoie une liste des valeurs d'état inactives.
{#r_TaskStateUtilGetInactiveStates__table_jtf_zgh_1s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 13. Paramètres]

{#r_TaskStateUtilGetInactiveStates__table_jtf_zgh_1s} {#r_TaskStateUtilGetInactiveStates__table_ktf_zgh_1s__entry__2}

| Type | Description |
|-|-|
| Tableau | Tableau de valeurs d'état inactives. |
[Tableau 14. Renvoie]

{#r_TaskStateUtilGetInactiveStates__table_ktf_zgh_1s}  

    var stateUtil = new TaskStateUtil(current);
    //get the inactive state values
    var inactiveStates = stateUtil.getInactiveStates();

## TaskStateUtil : isStateInactive (état de la chaîne) {#ariaid-title12}

Renvoie l'état actif de l'état spécifié.
{#r_TaskStateUtilIsStateInactive_String__table_bzq_ndh_1s__entry__3}

| Nom | Type | Description |
|-|-|-|
| État | Chaîne | Valeur d'état à vérifier. |
[Tableau 15. Paramètres]

{#r_TaskStateUtilIsStateInactive_String__table_bzq_ndh_1s} {#r_TaskStateUtilIsStateInactive_String__table_czq_ndh_1s__entry__2}

| Type | Description |
|-|-|
| Booléen | Vrai si l'état est inactif. |
[Tableau 16. Renvoie]

{#r_TaskStateUtilIsStateInactive_String__table_czq_ndh_1s}  

    var stateUtil = new TaskStateUtil(current);
    var previousStateInactive = stateUtil.isStateInactive(previous.state);
    var currentStateInactive = stateUtil.isStateInactive(current.state);

## TaskStateUtil : runMarkClosed {#ariaid-title13}

Décide si la règle métier doit être exécutée mark closed ou non.
{#r_TaskStateUtilrunMarkClosed__table_xvr_nbq_2s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 17. Paramètres]

{#r_TaskStateUtilrunMarkClosed__table_xvr_nbq_2s} {#r_TaskStateUtilrunMarkClosed__table_yvr_nbq_2s__entry__2}

| Type | Description |
|-|-|
| Booléen | Indique si la règle métier doit être autorisée à s'exécuter ou non. |
[Tableau 18. Renvoie]

{#r_TaskStateUtilrunMarkClosed__table_yvr_nbq_2s}

## TaskStateUtil : runTaskCloser {#ariaid-title14}

Décide si la règle métier doit être exécutée task closer ou non.
{#r_TaskStateUtil-runTaskCloser__table_ad5_rrj_xs__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 19. Paramètres]

{#r_TaskStateUtil-runTaskCloser__table_ad5_rrj_xs} {#r_TaskStateUtil-runTaskCloser__table_bd5_rrj_xs__entry__2}

| Type | Description |
|-|-|
| Booléen | Détermine s'il convient d'autoriser ou non l'exécution de la règle métier. |
[Tableau 20. Renvoie]

{#r_TaskStateUtil-runTaskCloser__table_bd5_rrj_xs}

## TaskStateUtil : runTaskReopener {#ariaid-title15}

Décide si la règle métier doit être exécutée task reopener ou non.
{#r_TaskStateUtilrunTaskReopener__table_ldl_4bq_2s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 21. Paramètres]

{#r_TaskStateUtilrunTaskReopener__table_ldl_4bq_2s} {#r_TaskStateUtilrunTaskReopener__table_mdl_4bq_2s__entry__2}

| Type | Description |
|-|-|
| Booléen | Indique si la règle métier doit être autorisée à s'exécuter ou non. |
[Tableau 22. Renvoie]

{#r_TaskStateUtilrunTaskReopener__table_mdl_4bq_2s}

## TaskStateUtil : setDefaultWorkState(String defaultWorkState) {#ariaid-title16}

Permet à l'utilisateur de spécifier son propre état de travail par défaut.
{#r_TSU-setDefaultWorkState_S__table_g1l_jcq_2s__entry__3}

| Nom | Type | Description |
|-|-|-|
| defaultWorkState | Chaîne | La valeur à utiliser pour l'état de travail par défaut. |
[Tableau 23. Paramètres]

{#r_TSU-setDefaultWorkState_S__table_g1l_jcq_2s} {#r_TSU-setDefaultWorkState_S__table_h1l_jcq_2s__entry__2}

| Type | Description |
|-|-|
| TaskStateUtil | Auto-référence pour permettre le chaînage de méthodes. |
[Tableau 24. Renvoie]

{#r_TSU-setDefaultWorkState_S__table_h1l_jcq_2s}