UniversalRequestUtilsSNC : délimité

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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.

    UniversalRequestUtilsSNC : createUniversalRequest(Objet copyFields)

    Crée une demande universelle et renvoie le 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 primaire.

    
{
  '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.

    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.

    Par défaut : le groupe d’affectation par défaut est défini par règles d’affectation.

    Table : table du groupe [sys_user_group].
    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 les Prestation de services RH tickets. Le sys_id de l’utilisateur pour lequel la ressource a été ouverte.
    copyFields.priority Chaîne Facultatif. Priorité de la ressource. Spécifié sous forme de 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 Rôles et groupes Demande universelle.

    Valeurs valides :
    • vrai : Universal Request n’est accessible qu’aux utilisateurs disposant du rôle sn_uni_req.sensitiveinfo_agent . Les utilisateurs ayant ce rôle ont les autorisations nécessaires pour afficher des informations sensibles, telles que les détails du salaire.
    • faux : l’accès à Demande universelle 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 Actions d’e-mail entrant [sysevent_in_email_action] délimité Créer un ticket RH . 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;