TaskStateUtil : global

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture
  • L’include de script TaskStateUtil fournit des méthodes d’utilisation des 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 remplacements de dictionnaire, car les valeurs d’état varient selon la table.

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

    Les attributs requis sont définis dans la table planned_task afin que tous les types de tâches planifiées soient pris en charge. Nous finirons par ajouter 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.
    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 déterminer si la tâche doit être définie sur actif ou inactif.
    default_close_state Facultatif. Attribut 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.

    Par défaut : 3, généralement fermé terminé si l’attribut n’est pas défini.

    default_work_state Facultatif. Attribut permettant de 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.

    Par défaut : 2, généralement Travail en cours si l’attribut n’est pas défini.

    TaskStateUtil : TaskStateUtil(tâche GlideRecord)

    Crée un objet TaskStateUtil.

    Tableau 2. Paramètres
    Nom Type Description
    tâche GlideRecord Il doit s’agir d’un GlideRecord d’une table de tâches.
    var stateUtil = new TaskStateUtil(current);

    TaskStateUtil - ATTR_DEFAULT_WORK

    Nom de l’attribut qui identifie l’état de travail par défaut.

    Tableau 3. Champ
    Nom Type Description
    ATTR_DEFAULT_WORK Chaîne Identifie l’état de travail par défaut. Valeur : default_work_state

    TaskStateUtil : ATTR_DEFAULT_CLOSE

    Nom de l’attribut qui identifie l’état de fermeture par défaut.

    Tableau 4. Champ
    Nom Type Description
    ATTR_DEFAULT_CLOSE Chaîne Identifie l’état de fermeture par défaut. Valeur : default_close_state

    TaskStateUtil - ATTR_INACTIVE_STATES

    Nom de l’attribut qui identifie les états inactifs.

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

    TaskStateUtil - SYSTEM_DEFAULT_CLOSE

    La valeur de l’état de fermeture par défaut est Fermé terminé dans la table Tâche.

    Tableau 6. Champ
    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

    TaskStateUtil - SYSTEM_DEFAULT_WORK

    La valeur de l’état de travail par défaut est Travail en cours dans la table Tâche.

    Tableau 7. Champ
    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

    TaskStateUtil - SYSTEM_INACTIVE_STATES

    Les valeurs des états inactifs par défaut : Fermé terminé, Fermé incomplet, Fermé ignoré dans la table Tâche.

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

    TaskStateUtil : getDefaultCloseState

    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é.

    Tableau 9. Paramètres
    Nom Type Description
    Néant
    Tableau 10. Renvoie
    Type Description
    Numéro Valeur d’état représentant l’état Fermé.
    var stateUtil = new TaskStateUtil(current);
    //get the close state
    var defaultCloseState =  stateUtil.getDefaultCloseState();
    current.state = defaultCloseState;

    TaskStateUtil : getDefaultWorkState()

    Renvoie la valeur de l’état de travail par défaut.

    La valeur de l’état de travail par défaut est 2 si l’attribut default_work_state n’a pas été spécifié.

    Tableau 11. Paramètres
    Nom Type Description
    Néant
    Tableau 12. Renvoie
    Type Description
    Numéro Valeur d’état représentant l’état de travail.
    var stateUtil = new TaskStateUtil(current);
    //get the work state
    var defaultWorkState =  stateUtil.getDefaultWorkState();
    current.state = defaultWorkState;

    TaskStateUtil : getInactiveStates

    Renvoie une liste des valeurs d’état inactif.

    Tableau 13. Paramètres
    Nom Type Description
    Néant
    Tableau 14. Renvoie
    Type Description
    Tableau Tableau des valeurs d’état inactives.
    var stateUtil = new TaskStateUtil(current);
    //get the inactive state values
    var inactiveStates = stateUtil.getInactiveStates();

    TaskStateUtil : isStateInactive (état de la chaîne)

    Renvoie l’état actif de l’état spécifié.

    Tableau 15. Paramètres
    Nom Type Description
    État Chaîne Valeur d’état à vérifier.
    Tableau 16. Renvoie
    Type Description
    Booléen Vrai si l’état est inactif.
    var stateUtil = new TaskStateUtil(current);
    var previousStateInactive = stateUtil.isStateInactive(previous.state);
    var currentStateInactive = stateUtil.isStateInactive(current.state);

    TaskStateUtil : runMarkClosed

    Décide s’il y a lieu d’exécuter mark closed la règle métier.

    Tableau 17. Paramètres
    Nom Type Description
    Néant
    Tableau 18. Renvoie
    Type Description
    Booléen Indique si la règle métier doit être autorisée à s’exécuter ou non.

    TaskStateUtil : runTaskCloser

    Décide s’il y a lieu d’exécuter task closer la règle métier.

    Tableau 19. Paramètres
    Nom Type Description
    Néant
    Tableau 20. Renvoie
    Type Description
    Booléen Détermine si la règle métier doit être autorisée à s’exécuter ou non.

    TaskStateUtil : runTaskReopener

    Décide s’il y a lieu d’exécuter task reopener la règle métier.

    Tableau 21. Paramètres
    Nom Type Description
    Néant
    Tableau 22. Renvoie
    Type Description
    Booléen Indique si la règle métier doit être autorisée à s’exécuter ou non.

    TaskStateUtil : setDefaultWorkState(Chaîne defaultWorkState)

    Permet à l’utilisateur de spécifier son propre état de travail par défaut.

    Tableau 23. Paramètres
    Nom Type Description
    defaultWorkState Chaîne La valeur à utiliser pour l’état de travail par défaut.
    Tableau 24. Renvoie
    Type Description
    TaskStateUtil Auto-référence pour permettre le chaînage de méthodes.