UniversalTaskUtils: Bereichsbezogen, global

Die UniversalTaskUtils -Skripteinbindung bietet Methoden zum Verwalten UR-Aufgaben.

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

Mit dieser Skripteinbindung 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 untergeordnete Elemente aufweist, und Vorlagen auf eine UR-Aufgabe anwenden Datensatz Sie können diese Methoden in Skripts und in den Sichtbaren Bedingungsgeneratoren im Konfigurationsformular für Registerkarten 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 Skripteinbindung sowohl in bereichsbezogenen als auch in globalen Anwendungen verwenden. Die Anwendung „UR-Aufgabe“ (sn_uni_task) muss auf der zugehörigen Instanz installiert sein, um auf diese Skripteinbindung zugreifen zu können. Sie müssen immer den Namespace sn_uni_task angeben, wenn Sie Methoden in dieser API aufrufen.

Weitere Informationen zur Anwendung der UR-Aufgabe finden Sie unter UR-Aufgabe.

UniversalTaskUtils - anwendenTemplate(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. Einzelheiten 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. Tabelle: UR-Aufgabenvorlage [sn_uni_task_template]
uniTaskGr	GlideRecord	GlideRecord des Datensatzes der UR-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 Feedback-Vorlage abruft 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 für das angegebene übergeordnete Ticket in Form eines GlideRecord zurück.

Anschließend können Sie die GlideRecord- API ( bereichsbezogen oder global, je nach 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. 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 getRowCount() verwendet, 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 current)

Überprüft, ob das angegebene übergeordnete Ticket UR-Aufgaben im Status „In Bearbeitung“ oder „Abgeschlossen“ aufweist.

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 Bearbeitung oder abgeschlossen sind.

Tabelle : 5. Parameter

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

Tabelle : 6. Rückgaben

Typ	Beschreibung
sys_id	Wenn dem übergeordneten Ticket UR-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 – markierenAktiveChildTasksCancelled(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 als aktive untergeordnete UR-Aufgabe in „Abgebrochen“ geändert werden sollte.

Tabelle : 8. Rückgaben

Typ	Beschreibung
Keine

Dieses Codebeispiel zeigt, wie mit dieser Methode der Status aller UR-Aufgaben, die der angegebenen übergeordneten Aufgabe zugeordnet sind, auf „Abgebrochen“ aktualisiert wird.

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

UniversalTaskUtils – markierenAktiveChildTasksCompleted(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 für aktive untergeordnete UR-Aufgaben in „Abgeschlossen“ geändert werden sollte.

Tabelle : 10. Rückgaben

Typ	Beschreibung
Keine

Dieses Codebeispiel zeigt, wie mit dieser Methode der Status aller UR-Aufgaben, die der angegebenen übergeordneten Aufgabe zugeordnet sind, auf „Abgeschlossen“ aktualisiert wird.

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