UniversalRequestUtilsSNC : Bereichsbezogen

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.

UniversalRequestUtilsSNC – createUniversalRequest(ObjectcopyFields)

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> ) .

Tabelle : 1. Parameter

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. 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. 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. Standardwert: false
„copyFields.short_description“	Zeichenfolge	Kurze Beschreibung der Ressource. Maximale Länge: 160

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Sys_id des neu erstellten Universal-Anforderungs-Datensatzes.

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;