TaskStateUtil : global

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 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 d’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 identifier si la tâche doit être définie sur actif ou inactif.
    default_close_state Facultatif. Attribut 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.

    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 pour travailler.

    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é sur 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é sur la table Tâche. Valeur : 3

    TaskStateUtil : SYSTEM_DEFAULT_WORK

    La valeur de l’état de travail par défaut est Travail en cours sur 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 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

    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
    Aucun
    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 par défaut de l’état de travail est 2 si l’attribut default_work_state n’a pas été spécifié.

    Tableau 11. Paramètres
    Nom Type Description
    Aucun
    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
    Aucun
    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 si la mark closed règle métier doit être exécutée ou non.

    Tableau 17. Paramètres
    Nom Type Description
    Aucun
    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 si la task closer règle métier doit être exécutée ou non.

    Tableau 19. Paramètres
    Nom Type Description
    Aucun
    Tableau 20. Renvoie
    Type Description
    Booléen Détermine s’il y a lieu d’autoriser l’exécution de la règle métier ou non.

    TaskStateUtil : runTaskReopener

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

    Tableau 21. Paramètres
    Nom Type Description
    Aucun
    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(String 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.