UniversalRequestUtilsSNC – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer
  • Die UniversalRequestUtilsSNC API ermöglicht die Verarbeitung von Universal-Anforderungslebenszyklen. Wird als Skripteinbindungsdatensatz bereitgestellt.

    Diese API erfordert Universal-Anforderung Plugin „“ (com.snc.Universal_Request) und wird in bereitgestellt sn_Uni_req Namespace.

    Informationen finden Sie unter Universal-Anforderung .

    UniversalRequestUtilsSNC – createUniversalRequest(Object copyFields)

    Erstellt eine Universal-Anforderung und gibt die sys_ID des neu erstellten Universal-Anforderungsdatensatzes zurück.

    Diese Methode wird mit aufgerufen UniversalRequestUtils Prototyp in sn_Uni_req Namespace. Beispiel: sn_Uni_req.UniversalRequestUtils().createUniversalRequest(<copyFields>) .

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    CopyFields 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 gelten als die nützlichsten Details, die einem primären Ticket zugewiesen werden sollen.

    
    {
      '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 aufgelistete Felder sind möglicherweise für Ihren Anwendungsfall berechtigt. Eine Liste der Tabellenfelder und zugehörigen Felder im System finden Sie unter Data dictionary tables.

    Hinweis:
    Schließen Sie die Felder „primary_Ticket“ oder „sys_ID“ nicht in das JSON-Objekt „copyFields“ ein.
    CopyFields.assignment_Group Zeichenfolge Optional. SYS_ID der Gruppe, die der Ressource zugewiesen ist.

    Standard: Die Standardzuweisungsgruppe wird gemäß Zuweisungsregeln festgelegt.

    Tabelle: Gruppentabelle [sys_user_Group].

    CopyFields.contact_type Zeichenfolge Optional. Methode, mit der die Ressource anfänglich gemeldet wurde.
    Mögliche Werte:
    • Chat
    • E-Mail
    • Telefon
    • Social Media
    • Web

    Maximale Länge: 40

    copyFields.description Zeichenfolge Optional. Detaillierte Beschreibung des Problems, das der Ressource zugeordnet ist.

    Maximale Länge: 4.000

    CopyFields.opened_by Zeichenfolge Optional. SYS_ID der Person, die die Ressource ursprünglich geöffnet hat. Befindet sich in der Anwendertabelle [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. Siehe Universal-Anforderungsrollen und -Gruppen .

    Gültige Werte:
    • Wahr: Universal-Anforderung ist nur für Anwender mit zugänglich sn_uni_req.sensitiveinfo_agent Rolle. Anwender mit dieser Rolle haben Berechtigungen zum Anzeigen vertraulicher Informationen, z. B. Gehaltsabrechnungsdetails.
    • Falsch: Der Zugriff auf die Universal-Anforderung ist uneingeschränkt.

    Standardwert: false

    CopyFields.short_description Zeichenfolge Kurze Beschreibung der Ressource.

    Maximale Länge: 160

    Tabelle : 2. Rückgaben
    Typ Beschreibung
    Zeichenfolge SYS_ID des neu erstellten Universal-Anforderungsdatensatzes.

    Das folgende Beispiel zeigt, wie Felder für eine neue Universal-Anforderung festgelegt werden. In diesem Anwendungsfall wird dieser Code am Anfang der bereichsbezogenen Aktionen für eingehende E-Mails [sysevent_in_email_action] hinzugefügt Erstellen Sie einen HR-Fall Skript. Wenn der Fall nicht für HR gilt, können Service Desk-Mitarbeiter den Fall an die entsprechende Abteilung weiterleiten.

    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;