UniversalTaskUtils : dans le champ d’application, global

L’include de script UniversalTaskUtils fournit des méthodes de gestion des tâches universelles.

Avec l’application ServiceNow Tâche universelle, les agents peuvent créer des tâches pour les employés. Par exemple, les agents peuvent demander des informations supplémentaires ou demander une action pour résoudre un ticket ou une demande parent. Les tâches universelles sont disponibles pour tout type de ticket qui étend la table Tâche [task].

À l’aide de cet include de script, vous pouvez modifier l’état des tâches universelles actives sur « Terminé » ou « Annulé », obtenir toutes les tâches universelles actives pour une tâche parente spécifiée, vérifier si une tâche universelle parente a des enfants et appliquer des modèles à un enregistrement de tâche universelle. Vous pouvez utiliser ces méthodes dans les scripts et dans les créateurs de conditions Visualisable du formulaire Configuration de l’onglet pour gérer les données qui apparaissent dans l’onglet Tâche universelle . Pour plus d’informations, consultez l’onglet Ajouter une tâche sur la page Ticket standard.

Vous pouvez utiliser cet include de script dans les applications incluses dans le périmètre et globales. L’application Tâche Universelle (sn_uni_task) doit être installée sur l’instance associée pour avoir accès à cet include de script. Vous devez toujours spécifier l’espace de noms sn_uni_task lorsque vous appelez des méthodes dans cette API.

Pour plus d’informations sur l’application Tâche universelle, voir Tâche universelle.

UniversalTaskUtils : applyTemplate(String, templateSysId, GlideRecord, uniTaskGr)

Applique le modèle de tâche universelle spécifié à l’enregistrement de tâche universelle spécifié.

Avant de pouvoir utiliser cette méthode, des modèles de tâches universelles doivent être configurés dans votre instance. Pour plus d’informations, voir Modèles de tâches universelles.

Tableau 1. Paramètres

Nom	Type	Description
templateSysId	Chaîne	Sys_id du modèle de tâche universelle à appliquer à l’enregistrement de tâche universelle spécifié. Table : Modèle de tâche universelle [sn_uni_task_template]
uniTaskGr	GlideRecord	GlideRecord de l’enregistrement de tâche universelle auquel appliquer le modèle.

Tableau 2. Renvoie

Type	Description
Aucun	Toutes les erreurs sont écrites dans le journal système.

Cet exemple de code montre une fonction qui acquiert, puis applique, le modèle de commentaire.

(function executeRule(current, previous /*null when async*/) {
  var templateGr = new GlideRecord('sn_uni_task_template');
  templateGr.get('name','Feedback Template');
  var templateSysId = templateGr.getValue('sys_id');
  new sn_uni_task.UniversalTaskUtils().applyTemplate (templateSysId,current);
})(current, previous);

UniversalTaskUtils : getActiveChildTasks(String parentSysId)

Renvoie les enregistrements de tâches enfants actifs, sous la forme d’un GlideRecord, pour le ticket parent spécifié.

Vous pouvez ensuite utiliser l’API GlideRecord , incluse dans le périmètre ou global selon le périmètre de l’application appelante, pour accéder aux données renvoyées, par exemple à l’aide de la méthode getRowCount() pour compter les tâches actives.

Tableau 3. Paramètres

Nom	Type	Description
parentSysId	Chaîne	Sys_id du ticket parent dont les tickets enfants actifs doivent être renvoyés.

Tableau 4. Renvoie

Type	Description
GlideRecord	GlideRecord qui contient tous les enregistrements de tâches enfants actifs pour la tâche parente spécifiée.

L’exemple suivant montre une fonction qui obtient toutes les tâches enfants actives pour la sys_id actuelle, puis utilise getRowCount() pour obtenir le nombre de tâches enfants actives.

(function executeRule(current, previous /*null when async*/) {
  var gr_ActiveTasks = new sn_uni_task.UniversalTaskUtils().getActiveChildTasks(current.sys_id);
  var count = gr_ActiveTasks.getRowCount();
})(current, previous);

UniversalTaskUtils : hasTasksToShow(GlideRecord actuel)

Vérifie si le ticket parent spécifié a des tâches universelles qui sont à l’état Travail en cours ou Terminé.

Vous pouvez utiliser cette méthode pour déterminer s’il faut afficher l’onglet Tâche universelle à un demandeur dans une configuration de ticket standard uniquement s’il existe des tâches qui sont en cours de résolution ou terminées.

Tableau 5. Paramètres

Nom	Type	Description
current	GlideRecord	GlideRecord du ticket parent à vérifier.

Tableau 6. Renvoie

Type	Description
sys_id	Si des tâches universelles sont associées au ticket parent, le sys_id du ticket parent ; sinon nul. Type de données : chaîne

L’exemple suivant montre une fonction qui appelle cette méthode pour vérifier les tâches universelles.

(function executeRule(current, previous /*null when async*/) {
  var sysId = new sn_uni_task.UniversalTaskUtils().hasTasksToShow(current);           
})(current, previous);

UniversalTaskUtils : markActiveChildTasksCancelled(String parentSysId)

Modifie l’état de toutes les tâches universelles actives sous le ticket parent spécifié sur « Annulé ».

Tableau 7. Paramètres

Nom	Type	Description
parentSysId	Chaîne	Sys_id du ticket parent dont l’état des tâches universelles enfants actives doit être changé sur « Annulé ».

Tableau 8. Renvoie

Type	Description
Aucun

Cet exemple de code montre comment utiliser cette méthode pour mettre à jour les états de toutes les tâches universelles associées à la tâche parente spécifiée à annuler.

(function executeRule(current, previous /*null when async*/) {
  new sn_uni_task.UniversalTaskUtils().markActiveChildTasksCancelled(current.sys_id);
})(current, previous);

UniversalTaskUtils : markActiveChildTasksCompleted(String parentSysId)

Modifie l’état de toutes les tâches universelles enfants actives associées au ticket parent spécifié sur « Terminé ».

Tableau 9. Paramètres

Nom	Type	Description
parentSysId	Chaîne	Sys_id du ticket parent dont l’état des tâches universelles enfants actives doit être changé sur « Terminé ».

Tableau 10. Renvoie

Type	Description
Aucun

Cet exemple de code montre comment utiliser cette méthode pour mettre à jour les états de toutes les tâches universelles associées à la tâche parente spécifiée sur terminé.

(function executeRule(current, previous /*null when async*/) {
  new sn_uni_task.UniversalTaskUtils().markActiveChildTasksCompleted(current.sys_id);
})(current, previous);