---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UniversalRequestUtilsSNC : inclus dans le périmètre

# UniversalRequestUtilsSNC : inclus dans le périmètre {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

L'API UniversalRequestUtilsSNC permet de gérer les cycles de vie des demandes universelles. Fourni en tant qu'enregistrement d'include de script.
Cette API nécessite 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, consultez [Demande universelle](https://www.servicenow.com/docs/access?context=ur-landing-limitedaccess&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US).

## UniversalRequestUtilsSNC : createUniversalRequest(objet copyFields) {#ariaid-title2}

Crée une demande universelle et renvoie les 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>)`.
{#URUS-createUniversalRequest_O__table_agv_xrd_gnb__entry__3}

| Nom | Type | Description |
|-|-|-|
| copyFields (en anglais seulement) | Objet | Objet JSON contenant des noms de champs et des 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 la liste des champs de table et des champs connexes dans le système, consultez le [Data dictionary tables](https://www.servicenow.com/docs/access?context=c_DataDictionaryTables&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). 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 * social * 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 Prestation de services RH 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 qui indique si la demande universelle a un accès restreint. Consultez la section [Rôles et groupes Demande universelle](https://www.servicenow.com/docs/access?context=ur-roles&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US). Valeurs valides : * vrai : Demande universelle n'est accessible qu'aux utilisateurs disposant du rôle `sn_uni_req.sensitiveinfo_agent` . Les utilisateurs disposant de ce rôle sont autorisés à afficher des informations sensibles, telles que les détails de paie. * faux : l'accès aux demandes universelles n'est pas restreint. {#URUS-createUniversalRequest_O__ul_ghk_csg_knb} Valeur par défaut : false |
| copyFields.short_description | Chaîne | Description succincte de la ressource. Longueur maximale : 160 |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Sys_id de l'enregistrement de demande universelle nouvellement créé. |
[Tableau 2. Renvoie]

{#URUS-createUniversalRequest_O__table_bgv_xrd_gnb}  
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 inclus dans le périmètre 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;