UniversalTaskUtils: Bereichsbezogen, Global

Die UniversalTaskUtils Die Skripteinbindung stellt Methoden für die Verwaltung universeller Aufgaben bereit.

Mit ServiceNow Anwendung „Universal-Aufgabe“ können Service Desk-Mitarbeiter Aufgaben für Mitarbeiter erstellen. Beispielsweise können Service Desk-Mitarbeiter zusätzliche Informationen anfordern oder eine Aktion anfordern, um ein übergeordnetes Ticket oder eine Anforderung zu lösen. Universal-Aufgaben sind für jeden Tickettyp verfügbar, der die Tabelle „Aufgabe“ [Aufgabe] erweitert.

Mit dieser Skripteinbindung können Sie den Status aktiver Universal-Aufgaben in „Abgeschlossen“ oder „Abgebrochen“ ändern, alle aktiven Universal-Aufgaben für eine angegebene übergeordnete Aufgabe abrufen, überprüfen, ob eine übergeordnete Universal-Aufgabe untergeordnete Elemente hat, und Vorlagen auf einen Datensatz für eine Universal-Aufgabe anwenden. Sie können diese Methoden in Skripts und in den sichtbaren Bedingungsgeneratoren auf verwenden Registerkartenkonfiguration Formular zum Verwalten der Daten, die im angezeigt werden Universal-Aufgabe Registerkarte. Weitere Informationen finden Sie unter Fügen Sie auf der Seite „Standardticket“ eine Registerkarte „Aufgabe“ hinzu .

Sie können diese Skripteinbindung sowohl in bereichsbezogenen als auch in globalen Anwendungen verwenden. Die Anwendung „Universal-Aufgabe“ (sn_Uni_Task) muss auf der zugehörigen Instanz installiert sein, um Zugriff auf diese Skripteinbindung zu haben. Sie müssen immer angeben sn_Uni_Task Namespace beim Aufrufen von Methoden in dieser API.

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

UniversalTaskUtils – ApplyTemplate(Zeichenfolge templateSysId, GlideRecord uniTaskGr)

Wendet die angegebene Vorlage für Universal-Aufgaben auf den angegebenen Datensatz für die Universal-Aufgabe an.

Bevor Sie diese Methode verwenden können, müssen in Ihrer Instanz Vorlagen für Universal-Aufgaben konfiguriert sein. Weitere Informationen finden Sie unter Vorlagen für Ur-Aufgaben .

Tabelle : 1. Parameter

Name	Typ	Beschreibung
templateSysId	Zeichenfolge	SYS_ID der Ur-Aufgabenvorlage, die auf den angegebenen Ur-Aufgabendatensatz angewendet werden soll. Tabelle: Vorlage für Universal-Aufgaben [sn_Uni_Task_template]
UniTaskGr	GlideRecord	GlideRecord des Datensatzes der Universal-Aufgabe, auf den die Vorlage angewendet werden soll.

Tabelle : 2. Rückgaben

Typ	Beschreibung
Keine	Alle Fehler werden in das Systemprotokoll geschrieben.

Dieses Codebeispiel zeigt eine Funktion, die die Feedbackvorlage erwirbt 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(Zeichenfolge parentSysId)

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

Sie können dann verwenden GlideRecord API, Bereichsbezogen Oder Global Abhängig vom Umfang der aufrufenden Anwendung, um auf die zurückgegebenen Daten zuzugreifen, z. B. mit GetRowCount() Methode zum Zählen aktiver Aufgaben.

Tabelle : 3. Parameter

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

Tabelle : 4. Rückgaben

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 verwendet GetRowCount() Um die Anzahl der aktiven untergeordneten Aufgaben abzurufen.

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

Überprüft, ob das angegebene übergeordnete Ticket über Universal-Aufgaben verfügt, die sich im Status „in Bearbeitung“ oder „Abgeschlossen“ befinden.

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

Tabelle : 5. Parameter

Name	Typ	Beschreibung
current	GlideRecord	GlideRecord des übergeordneten Tickets, das überprüft werden soll.

Tabelle : 6. Rückgaben

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

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

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

UniversalTaskUtils – markActiveChildTasksCancelled(Zeichenfolge parentSysId)

Ändert den Status aller aktiven Universal-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 Universal-Aufgaben in „Abgebrochen“ geändert werden soll.

Tabelle : 8. Rückgaben

Typ	Beschreibung
Keine

Dieses Codebeispiel zeigt, wie Sie diese Methode verwenden, um die status aller Universal-Aufgaben zu aktualisieren, die der angegebenen übergeordneten Aufgabe zugeordnet sind, auf „Abgebrochen“ zu ändern.

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

UniversalTaskUtils – markActiveChildTasksCompleted(Zeichenfolge parentSysId)

Ändert den Status aller aktiven untergeordneten Universal-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 Universal-Aufgaben in „Abgeschlossen“ geändert werden soll.

Tabelle : 10. Rückgaben

Typ	Beschreibung
Keine

Dieses Codebeispiel zeigt, wie Sie diese Methode verwenden, um die status aller Universal-Aufgaben zu aktualisieren, die der angegebenen übergeordneten Aufgabe zugeordnet sind, auf „Abgeschlossen“ zu ändern.

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