---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UniversalTaskUtils: Bereichsbezogen, global

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

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die UniversalAufgabeUtils Die Skripteinbindung stellt Methoden für die Verwaltung von Universal-Aufgaben bereit.

Mit ServiceNowUniversal-Aufgabenanwendung 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 Universal-Aufgabendatensatz anwenden. Sie können diese Methoden in Skripts und in den sichtbaren Bedingungsgeneratoren auf verwenden Registerkartenkonfiguration Formular zum Verwalten der Daten, die auf angezeigt werden Ur-Aufgabe Registerkarte. Weitere Informationen finden Sie unter [Fügen Sie auf der Seite „Standardticket" eine Registerkarte „Aufgabe" hinzu](https://www.servicenow.com/docs/access?context=config-stdtktpage-for-ut&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US).

Sie können diese Skripteinbindung sowohl in bereichsbezogenen als auch 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 „Universalaufgabe" finden Sie unter [Ur-Aufgabe](https://www.servicenow.com/docs/access?context=universal-task-landing&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US).

## UniversalTaskUtils -- ApplyTemplate(Zeichenfolge 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 Universal-Aufgabenvorlagen konfiguriert sein. Weitere Informationen finden Sie unter [Ur-Aufgabenvorlagen](https://www.servicenow.com/docs/access?context=ut-task-template-landing&version=yokohama&pubname=yokohama-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. Tabelle: Ur-Aufgabenvorlage \[sn_uni_task_template\] |
| UniTaskGr | GlideRecord | GlideRecord des Ur-Aufgabendatensatzes, 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. Rückgaben]

{#UniTskUtil-applyTemplate_S_GR__table_d3g_znf_hpb}  
Dieses Codebeispiel zeigt eine Funktion, die die Feedbackvorlage 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(Zeichenfolge parentSysId) {#ariaid-title3}

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](https://servicenow-prod.fluidtopics.net/pr75jggqt1vPfwd6tbA7gQ#c_GlideRecordScopedAPI "Der Umfang ist festgelegt GlideRecord API wird für Datenbankvorgänge verwendet.")Oder [Global](https://servicenow-prod.fluidtopics.net/PhVphXpfpHtoByvicO1vjw#c_GlideRecordAPI "Die GlideRecord API wird für Datenbankvorgänge verwendet.")Abhängig vom Umfang der aufrufenden Anwendung, um auf die zurückgegebenen Daten zuzugreifen, z. B. mithilfe von GetRowCount() Methode zum Zählen aktiver Aufgaben.
{#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. Rückgaben]

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

Überprüft, ob das angegebene übergeordnete Ticket Ur-Aufgaben enthält, die sich im Status „in Bearbeitung" oder „Abgeschlossen" befinden.
Sie können diese Methode verwenden, um zu bestimmen, ob die Registerkarte „Universalaufgabe" 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 |
|-|-|-|
| aktuell | GlideRecord | GlideRecord des übergeordneten Tickets, das überprüft werden soll. |
[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 Universal-Aufgaben zugeordnet sind, die sys_ID des übergeordneten Tickets; andernfalls null. Datentyp: Zeichenfolge |
[Tabelle : 6. Rückgaben]

{#UniTskUtil-hasTasksToShow_GR__table_lvg_43f_hpb}  
Das folgende Beispiel zeigt eine Funktion, die diese Methode aufruft, um nach Universal-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) {#ariaid-title5}

Ändert den Status aller aktiven Universal-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 der aktiven untergeordneten Universal-Aufgaben in „Abgebrochen" geändert werden soll. |
[Tabelle : 7. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Rückgaben]

{#UniTskUtil-markActChildTaskCancel_S__table_ajl_ncf_hpb}  
Dieses Codebeispiel zeigt, wie Sie diese Methode verwenden, um den 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) {#ariaid-title6}

Ändert den Status aller aktiven untergeordneten Universal-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 der aktiven untergeordneten Universal-Aufgaben in „Abgeschlossen" geändert werden soll. |
[Tabelle : 9. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 10. Rückgaben]

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


