UniversalRequestUtilsSNC : dans le champ d’application

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 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, reportez-vous à Demande universelle.

    UniversalRequestUtilsSNC : createUniversalRequest(Object 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 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 la section 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 selon les règles d’affectation.

    Table : Table de 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

    Valeur 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 disposant de ce rôle ont l’autorisation d’afficher des informations sensibles, telles que les détails de salaire.
    • faux : l’accès à la demande universelle n’est pas restreint.

    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 champ d’application Actions d’e-mail entrant [sysevent_in_email_action] Script 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;