UniversalTaskUtils – Scoped, Global

Die Klasse UniversalTaskUtils stellt Methoden zum Verwalten von UR-Aufgaben bereit.

Mit der Anwendung ServiceNow UR-Aufgabe können Service Desk-Mitarbeiter Aufgaben für andere Mitarbeiter erstellen. Beispielsweise können Service Desk-Mitarbeiter zusätzliche Informationen anfordern oder eine Aktion zur Lösung eines übergeordneten Tickets oder einer übergeordneten Anforderung anfordern. UR-Aufgaben sind für jeden Tickettyp verfügbar, der die Aufgabentabelle [task] erweitert.

Mit dieser API können Sie den Status aktiver UR-Aufgaben in „Abgeschlossen“ oder „Abgebrochen“ ändern, alle aktiven UR-Aufgaben für eine angegebene übergeordnete Aufgabe abrufen, überprüfen, ob eine übergeordnete UR-Aufgabe über untergeordnete Elemente verfügt, und Vorlagen auf einen UR-Aufgabendatensatz anwenden . Sie können diese Methoden in Skripts und in den Bedingungsgeneratoren für Sichtbarkeit im Formular „Registerkartenkonfiguration“ verwenden, um die Daten zu verwalten, die auf der Registerkarte „UR-Aufgabe“ angezeigt werden. Weitere Informationen finden Sie unter Registerkarte „Aufgabe hinzufügen“ auf der Seite „Standardticket“.

Sie können diese API sowohl in bereichsbezogenen als auch in globalen Anwendungen verwenden. Die Anwendung UR-Aufgabe (sn_uni_task) muss in der zugeordneten Instanz installiert sein, um Zugriff auf diese API zu erhalten. Sie müssen immer den Namespace sn_uni_task angeben, wenn Sie Methoden in dieser API aufrufen.

Weitere Informationen zur Anwendung „UR-Aufgabe“ finden Sie unter UR-Aufgabe.

UniversalTaskUtils – applyTemplate(String templateSysId, GlideRecord uniTaskGr)

Wendet die angegebene UR-Aufgabenvorlage auf den angegebenen UR-Aufgabendatensatz an.

Bevor Sie diese Methode verwenden können, müssen in Ihrer Instanz UR-Aufgabenvorlagen konfiguriert sein. Weitere Informationen finden Sie unter UR-Aufgabenvorlagen.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
templateSysId	Zeichenfolge	Sys_id der UR-Aufgabenvorlage, die auf den angegebenen UR-Aufgabendatensatz angewendet werden soll. Befindet sich in der Tabelle „UR-Aufgabenvorlage“ [sn_uni_task_template].
uniTaskGr	GlideRecord	GlideRecord des UR-Aufgabendatensatzes, auf den die Vorlage angewendet werden soll.

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Keine	Alle Fehler werden in das Systemprotokoll geschrieben.

Dieses Codebeispiel zeigt eine Funktion, die die Feedback-Vorlage erfasst und dann anwendet.

(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)

Gibt die aktiven untergeordneten Aufgabendatensätze in Form eines GlideRecord für das angegebene übergeordnete Ticket zurück.

Sie können dann die GlideRecord- API ( bereichsbezogen oder global, abhängig vom Bereich der aufrufenden Anwendung) verwenden, um auf die zurückgegebenen Daten zuzugreifen, z. B. mit der Methode getRowCount(), um aktive Aufgaben zu zählen.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
parentSysId	Zeichenfolge	Sys_id des übergeordneten Tickets, dessen aktive untergeordnete Tickets zurückgegeben werden sollen.

Tabelle : 4. Ergebnisse

Typ	Beschreibung
GlideRecord	GlideRecord, der alle aktiven untergeordneten Aufgabendatensätze für die angegebene übergeordnete Aufgabe enthält.

Das folgende Beispiel zeigt eine Funktion, die alle aktiven untergeordneten Aufgaben für die aktuelle sys_id abruft und dann getRowCount() verwendet, um die Anzahl der aktiven untergeordneten Aufgaben zu erhalten.

(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 current)

Überprüft, ob das angegebene übergeordnete Ticket UR-Aufgaben enthält, die sich im Status „In Arbeit“ oder „Abgeschlossen“ befinden.

Sie können diese Methode verwenden, um zu bestimmen, ob die Registerkarte UR-Aufgabe einer anfordernden Person in einer Standardticketkonfiguration nur angezeigt werden soll, wenn Aufgaben in Arbeit oder abgeschlossen sind.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
current	GlideRecord	GlideRecord des zu überprüfenden übergeordneten Tickets.

Tabelle : 6. Ergebnisse

Typ	Beschreibung
sys_id	Wenn UR-Aufgaben dem übergeordneten Ticket zugeordnet sind, die sys_id des übergeordneten Tickets; andernfalls NULL. Datentyp: Zeichenfolge

Das folgende Beispiel zeigt eine Funktion, die diese Methode aufruft, um nach UR-Aufgaben zu suchen.

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

UniversalTaskUtils – markActiveChildTasksCancelled(String parentSysId)

Ändert den Status aller aktiven UR-Aufgaben unter dem angegebenen übergeordneten Ticket in „Abgebrochen“.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
parentSysId	Zeichenfolge	Sys_id des übergeordneten Tickets, dessen Status der aktiven untergeordneten UR-Aufgaben in „Abgebrochen“ geändert werden soll.

Tabelle : 8. Ergebnisse

Typ	Beschreibung
Keine

Dieses Codebeispiel zeigt, wie diese Methode verwendet wird, um den Status aller UR-Aufgaben, die der angegebenen übergeordneten Aufgabe zugeordnet sind, auf „Abgebrochen“ zu aktualisieren.

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

UniversalTaskUtils – markActiveChildTasksCompleted(String parentSysId)

Ändert den Status aller aktiven untergeordneten UR-Aufgaben, die dem angegebenen übergeordneten Ticket zugeordnet sind, in „Abgeschlossen“.

Tabelle : 9. Parameter

Name	Typ	Beschreibung
parentSysId	Zeichenfolge	Sys_id des übergeordneten Tickets, dessen Status der aktiven untergeordneten UR-Aufgaben in „Abgeschlossen“ geändert werden soll.

Tabelle : 10. Ergebnisse

Typ	Beschreibung
Keine

Dieses Codebeispiel zeigt, wie diese Methode verwendet wird, um den Status aller UR-Aufgaben, die der angegebenen übergeordneten Aufgabe zugeordnet sind, auf „Abgeschlossen“ zu aktualisieren.

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