TaskStateUtil : global

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture

    • L’API TaskStateUtil se trouve dans le script include de l’utilitaire de gestion des états des tâches et est utilisée pour travailler avec les attributs d’état de table de type tâche.

    Cette API est principalement utilisée par la règle métier Gestion active des états des tâches 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.

    L’API TaskStateUtil peut être appelée par n’importe quel script serveur pour déterminer les états inactifs, le 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é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.
    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.

    TaskStateUtil : ATTR_DEFAULT_WORK

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

    Tableau 2. 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 3. 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 4. Champ
    Nom Type Description
    ATTR_INACTIVE_STATES Chaîne Identifie les états inactifs. Valeur : close_states

    TaskStateUtil : getDefaultCloseState

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

    La valeur d’état fermé par défaut est de 3 si l’attribut default_close_state n’a pas été spécifié.

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    Tableau 6. 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 de 2 si l’attribut default_work_state n’a pas été spécifié.

    Tableau 7. Paramètres
    Nom Type Description
    Aucun
    Tableau 8. 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 9. Paramètres
    Nom Type Description
    Aucun
    Tableau 10. 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 11. Paramètres
    Nom Type Description
    État Chaîne Valeur d’état à vérifier.
    Tableau 12. 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 règle métier doit être exécutée mark closed ou non.

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

    Tableau 15. Paramètres
    Nom Type Description
    Aucun
    Tableau 16. 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 si la règle métier doit être exécutée task reopener 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 : setDefaultWorkState(String defaultWorkState)

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

    Tableau 19. Paramètres
    Nom Type Description
    defaultWorkState Chaîne La valeur à utiliser pour l’état de travail par défaut.
    Tableau 20. Renvoie
    Type Description
    Utilitaire d’état des tâches Auto-référence pour permettre le chaînage de méthodes.

    TaskStateUtil : SYSTEM_DEFAULT_CLOSE

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

    Tableau 21. 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 sur la table Tâche.

    Tableau 22. Champ
    Nom Type Description
    SYSTEM_DEFAULT_WORK Entier La valeur de l’état de travail par défaut est Travail en cours sur 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 23. 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 : TaskStateUtil(tâche GlideRecord)

    Crée un objet TaskStateUtil.

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