UniversalRequestUtilsSNC : inclus dans le périmètre

L’API UniversalRequestUtilsSNC permet de gérer les cycles de vie des demandes universelles. Fourni en tant qu’enregistrement de script include.

Cette API requiert le module d’extension Demande universelle (com.snc.universal_request) et est fournie dans l’espace de noms sn_uni_req .

Pour plus d’informations, référez-vous à Universal Request.

UniversalRequestUtilsSNC : createUniversalRequest(Object copyFields)

Crée une demande universelle et renvoie l’sys_id de l’enregistrement de demande universelle nouvellement créé.

Cette méthode est appelée à l’aide du prototype UniversalRequestUtils dans l’espace de noms sn_uni_req . Par exemple, sn_uni_req. UniversalRequestUtils().createUniversalRequest(<copyFields>).

Tableau 1. Paramètres

Nom	Type	Description
Champs de copie	Objet	Objet JSON contenant les noms de champs et les valeurs à définir sur un nouvel enregistrement dans la table Demandes universelles [universal_request]. Fournissez des détails par nom de champ et valeur de champ au format { '<field_name>' : '<field_value>' }. Les champs suivants sont considérés comme les détails les plus utiles à affecter à un ticket principal. { 'assignment_group': 'String', 'assigned_to': 'String', 'contact_type': 'String', 'description': 'String', 'opened_by': 'String', 'opened_for': 'String', 'priority': 'String', 'restricted': Boolean, 'short_description': 'String' }; D’autres champs non répertoriés peuvent être éligibles pour votre cas d’utilisation . Pour obtenir une liste des champs de table et des champs connexes dans le système, consultez le dictionnaire de données. Remarque : N’incluez pas les champs primary_ticket ou sys_id dans l’objet JSON copyFields.
copyFields.assignment_group	Chaîne	Facultatif. Sys_id du groupe affecté à la ressource. Situé dans la table Groupe [sys_user_group]. Par défaut : le groupe d’affectation par défaut est défini selon les règles d’affectation.
copyFields.contact_type	Chaîne	Facultatif. Méthode par laquelle la ressource a été initialement signalée. Valeurs possibles : messagerie instantanée E-mail Téléphone Sociale Web Longueur maximale : 40
copyFields.description	Chaîne	Facultatif. Description détaillée du problème associé à la ressource. Longueur maximale : 4 000
copyFields.opened_by	Chaîne	Facultatif. Sys_id de la personne qui a initialement ouvert la ressource. Situé dans la table Utilisateur [sys_user].
copyFields.opened_for	Chaîne	Facultatif. Requis pour HR Service Delivery les tickets. sys_id de l’utilisateur pour lequel la ressource a été ouverte.
copyFields.priority	Chaîne	Facultatif. Priorité de la ressource. Spécifié sous la forme d’un nombre. Valeurs possibles : 1 : Critique 2 : Élevé 3 : Modéré 4 : Faible Par défaut : 3
copyFields.restricted	Booléen	Facultatif. Marqueur indiquant si la demande universelle a un accès restreint. Consultez la section Rôles et groupes Universal Request. Valeurs valides : true : la demande universelle n’est accessible qu’aux utilisateurs disposant du rôle sn_uni_req.sensitiveinfo_agent . Les utilisateurs disposant de ce rôle ont l’autorisation d’afficher des informations sensibles, telles que les détails du salaire. false : l’accès aux demandes universelles est illimité. Valeur par défaut : false
copyFields.short_description	Chaîne	Description succincte de la ressource. Longueur maximale : 160

Tableau 2. Renvoie

Type	Description
Chaîne	Sys_id de l’enregistrement de demande universelle nouvellement créé.

L’exemple suivant montre comment définir des champs sur une nouvelle demande universelle. Dans ce cas d’utilisation, ce code est ajouté au début du script Créer un ticket RH d’Inbound Email Actions [sysevent_in_email_action]. Si le ticket ne s’applique pas aux RH, les agents peuvent transférer le ticket au département approprié.

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;