UniversalTaskUtils : champ d’application, global

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

Avec l’application Universal Task, les agents peuvent créer des tâches pour les ServiceNow 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 changer 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 visibles sur le formulaire de 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 lors de l’appel de méthodes dans cette API.

Pour plus d’informations sur l’application Tâche universelle, consultez 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 en savoir plus, reportez-vous à la section 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é. Situé dans la 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 actives, sous la forme d’un GlideRecord, pour le ticket parent spécifié.

Vous pouvez ensuite utiliser l’API GlideRecord , délimitée ou globale selon la portée de l’application appelante, pour accéder aux données renvoyées, par exemple en utilisant 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 le sys_id actuel, 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é comporte des tâches universelles à l’état Travail en cours ou Terminé.

Vous pouvez utiliser cette méthode pour déterminer s’il convient d’afficher l’onglet Tâche universelle pour un demandeur dans une configuration de ticket standard uniquement si des tâches sont en cours 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, la sys_id du ticket parent ; Dans le cas contraire, il est 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é en « 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é en « 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 parent spécifiée à terminer.

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