UniversalRequestUtilsSNC : inclus dans le périmètre

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 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>).

    Tableau 1. Paramètres
    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.

    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.

    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.

    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 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;