---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/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


---

# UniversalRequestUtilsSNC : Bereichsbezogen

# UniversalRequestUtilsSNC : Bereichsbezogen {#ariaid-title1}

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

Die UniversalRequestUtilsSNC -API ermöglicht die Verarbeitung von Lebenszyklen von Universal-Anforderungen. Bereitgestellt als Skripteinbindungsdatensatz.
Diese API erfordert das Plugin Universal-Anforderung (com.snc.universal_request) und wird im Namespace `sn_uni_req` bereitgestellt.

Weitere Informationen finden Sie unter [Universal-Anforderung](https://www.servicenow.com/docs/access?context=ur-landing-limitedaccess&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US).

## UniversalRequestUtilsSNC -- createUniversalRequest(ObjectcopyFields) {#ariaid-title2}

Erstellt eine Universal-Anforderung und gibt die sys_id des neu erstellten Universal-Anforderungs-Datensatzes zurück.
Diese Methode wird mit dem UniversalRequestUtils -Prototypen im Namespace `sn_uni_req aufgerufen`. Beispiel: `sn_uni_req.UniversalRequestUtils().createUniversalRequest(`\<copyFields\> ) .
{#URUS-createUniversalRequest_O__table_agv_xrd_gnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| kopierenFelder | Objekt | JSON-Objekt mit Feldnamen und -werten, die für einen neuen Datensatz in der Tabelle „Universal-Anforderungen" \[universal_request\] festgelegt werden sollen. Geben Sie Details nach Feldname und Feldwert im Format `{ ' an.`\<field_name\> „: "\<field_value\> ' } . Die folgenden Felder sind die nützlichsten Details, die einem primären Ticket zugewiesen werden können. { 'assignment_group': 'String', 'assigned_to': 'String', 'contact_type': 'String', 'description': 'String', 'opened_by': 'String', 'opened_for': 'String', 'priority': 'String', 'restricted': Boolean, 'short_description': 'String' }; Andere nicht aufgeführte Felder sind möglicherweise für Ihren Anwendungsfall geeignet. Eine Liste der Tabellenfelder und zugehörigen Felder im System finden Sie unter [Data dictionary tables](https://www.servicenow.com/docs/access?context=c_DataDictionaryTables&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Hinweis: Nehmen Sie die Felder primary_ticket oder sys_id nicht in das JSON-Objekt „copyFields" auf. |
| „copyFields.assignment_group" | Zeichenfolge | Optional. Sys_id der Gruppe, die der Ressource zugewiesen ist. Befindet sich in der Tabelle „Gruppe" \[sys_user_group\]. Standard: Die Standardzuweisungsgruppe wird gemäß Zuweisungsregeln festgelegt. |
| „copyFields.contact_type" | Zeichenfolge | Optional. Methode, mit der die Ressource ursprünglich gemeldet wurde. Mögliche Werte: * Chat * E-Mail * Telefon * Social * Web Maximale Länge: 40 |
| „copyFields.description" | Zeichenfolge | Optional. Detaillierte Beschreibung des mit der Ressource verknüpften Problems. Maximale Länge: 4.000 |
| „copyFields.opened_by" | Zeichenfolge | Optional. Sys_id der Person, die die Ressource zum ersten Mal geöffnet hat. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. |
| „copyFields.opened_for" | Zeichenfolge | Optional. Erforderlich für 'HR-Servicebereitstellung Fälle. Die sys_id des Anwenders, für den die Ressource geöffnet wurde. |
| „copyFields.priority" | Zeichenfolge | Optional. Priorität der Ressource. Als Zahl angegeben. Mögliche Werte: * 1: Kritisch * 2: Hoch * 3: Mittel * 4: Niedrig Standard: 3 |
| „copyFields.restricted" | Boolean | Optional. Kennzeichnung, die angibt, ob der Zugriff auf die Universal-Anforderung eingeschränkt ist. Weitere Informationen finden Sie unter [Rollen und Gruppen für Universal-Anforderung](https://www.servicenow.com/docs/access?context=ur-roles&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US). Gültige Werte: * „wahr": Die Universal-Anforderung ist nur für Benutzer mit der Rolle `„sn_uni_req.sensitiveinfo_agent"` zugänglich. Anwender mit dieser Rolle sind berechtigt, vertrauliche Informationen anzuzeigen, z. B. Gehaltsabrechnungsdetails. * „falsch": Der Zugriff auf die Universal-Anforderung ist unbeschränkt. {#URUS-createUniversalRequest_O__ul_ghk_csg_knb} Standardwert: false |
| „copyFields.short_description" | Zeichenfolge | Kurze Beschreibung der Ressource. Maximale Länge: 160 |
[Tabelle : 1. Parameter]

{#URUS-createUniversalRequest_O__table_agv_xrd_gnb} {#URUS-createUniversalRequest_O__table_bgv_xrd_gnb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Sys_id des neu erstellten Universal-Anforderungs-Datensatzes. |
[Tabelle : 2. Ergebnisse]

{#URUS-createUniversalRequest_O__table_bgv_xrd_gnb}  
Das folgende Beispiel zeigt, wie Felder in einer neuen Universal-Anforderung festgelegt werden. In diesem Anwendungsfall wird dieser Code am Anfang des Skripts „Aktionen für eingehende E-Mails" \[sysevent_in_email_action\] im Bereich „ HR-Fall erstellen " hinzugefügt. Wenn HR nicht zutrifft, können Service Desk-Mitarbeiter den Fall an die entsprechende Abteilung übertragen.

    var copiedFields = {
      'opened_for': "<user_sys_id>",    
      'short_description': email.subject,
      'restricted': false,
      'priority': '1'
    };

    // createUniversalRequest() must be called to create the universal request prior to creating the child case

    var ur = new sn_uni_req.UniversalRequestUtils().createUniversalRequest(copiedFields);
    current.universal_request = ur;