---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UniversalTaskUtils: Bereichsbezogen, global

# UniversalTaskUtils: Bereichsbezogen, global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

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"](https://www.servicenow.com/docs/access?context=config-stdtktpage-for-ut&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US).

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](https://www.servicenow.com/docs/access?context=universal-task-landing&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US).

## UniversalTaskUtils - anwendenTemplate(String templateSysId, GlideRecord uniTaskGr) {#ariaid-title2}

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](https://www.servicenow.com/docs/access?context=ut-task-template-landing&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US).
{#UniTskUtil-applyTemplate_S_GR__table_c3g_znf_hpb__entry__3}

| 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 Datensatzes der UR-Aufgabe, auf den die Vorlage angewendet werden soll. |
[Tabelle : 1. Parameter]

{#UniTskUtil-applyTemplate_S_GR__table_c3g_znf_hpb} {#UniTskUtil-applyTemplate_S_GR__table_d3g_znf_hpb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine | Alle Fehler werden in das Systemprotokoll geschrieben. |
[Tabelle : 2. Ergebnisse]

{#UniTskUtil-applyTemplate_S_GR__table_d3g_znf_hpb}  
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) {#ariaid-title3}

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](https://www.servicenow.com/docs/g1N~QBZ9WXF6q3o57iuLTw#c_GlideRecordScopedAPI "Die bereichsbezogene GlideRecord- API wird für Datenbankvorgänge verwendet.") oder [global](https://www.servicenow.com/docs/aQw~oDpg6tKgED8LtNFyvw#c_GlideRecordAPI "Die GlideRecord- API wird für Datenbankvorgänge verwendet."), 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.
{#UniTskUtil-getActiveChildTasks_S__table_sgs_vdf_hpb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| parentSysId | Zeichenfolge | Sys_id des übergeordneten Tickets, dessen aktive untergeordnete Tickets zurückgegeben werden sollen. |
[Tabelle : 3. Parameter]

{#UniTskUtil-getActiveChildTasks_S__table_sgs_vdf_hpb} {#UniTskUtil-getActiveChildTasks_S__table_tgs_vdf_hpb__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideRecord | GlideRecord, der alle aktiven untergeordneten Aufgabendatensätze für die angegebene übergeordnete Aufgabe enthält. |
[Tabelle : 4. Ergebnisse]

{#UniTskUtil-getActiveChildTasks_S__table_tgs_vdf_hpb}  
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) {#ariaid-title4}

Ü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.
{#UniTskUtil-hasTasksToShow_GR__table_kvg_43f_hpb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| current | GlideRecord | GlideRecord des zu überprüfenden übergeordneten Tickets. |
[Tabelle : 5. Parameter]

{#UniTskUtil-hasTasksToShow_GR__table_kvg_43f_hpb} {#UniTskUtil-hasTasksToShow_GR__table_lvg_43f_hpb__entry__2}

| Typ | Beschreibung |
|-|-|
| sys_id | Wenn dem übergeordneten Ticket UR-Aufgaben zugeordnet sind, die sys_id des übergeordneten Tickets; andernfalls null. Datentyp: Zeichenfolge |
[Tabelle : 6. Ergebnisse]

{#UniTskUtil-hasTasksToShow_GR__table_lvg_43f_hpb}  
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) {#ariaid-title5}

Ändert den Status aller aktiven UR-Aufgaben unter dem angegebenen übergeordneten Ticket in „Abgebrochen".
{#UniTskUtil-markActChildTaskCancel_S__table_z3l_ncf_hpb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| parentSysId | Zeichenfolge | Sys_id des übergeordneten Tickets, dessen Status als aktive untergeordnete UR-Aufgabe in „Abgebrochen" geändert werden sollte. |
[Tabelle : 7. Parameter]

{#UniTskUtil-markActChildTaskCancel_S__table_z3l_ncf_hpb} {#UniTskUtil-markActChildTaskCancel_S__table_ajl_ncf_hpb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Ergebnisse]

{#UniTskUtil-markActChildTaskCancel_S__table_ajl_ncf_hpb}  
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) {#ariaid-title6}

Ändert den Status aller aktiven untergeordneten UR-Aufgaben, die dem angegebenen übergeordneten Ticket zugeordnet sind, in „Abgeschlossen".
{#UniTskUtil-markActChildTaskComplete_S__table_pn2_4z2_hpb__entry__3}

| 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 : 9. Parameter]

{#UniTskUtil-markActChildTaskComplete_S__table_pn2_4z2_hpb} {#UniTskUtil-markActChildTaskComplete_S__table_qn2_4z2_hpb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 10. Ergebnisse]

{#UniTskUtil-markActChildTaskComplete_S__table_qn2_4z2_hpb}  
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);