Configurer des décorateurs de champ dans Espace de travail configurable

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 6 minutes de lecture

    • Ajoutez un décorateur de champ, ou une icône, qui effectue une action lorsqu’il est sélectionné à côté d’un champ. Par exemple, ajoutez une icône dans un champ de référence qui ouvre un enregistrement utilisateur dans un onglet.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Un décorateur de champ est une icône qui est ajoutée à un champ dans le composant de formulaire . Un agent peut sélectionner l’icône pour effectuer une action. Espace de travail Prend en charge jusqu’à trois décorateurs par champ.

    L’objectif de la configuration des décorateurs de champ est de permettre aux agents d’effectuer des opérations sur une page qui, autrement, nécessiteraient l’ouverture de pages supplémentaires. Par exemple, au lieu d’ouvrir une autre page pour afficher l’enregistrement de l’utilisateur nommé dans un incident, l’agent peut sélectionner le décorateur de champ Action d’espace de travail dans le champ Appelant pour ouvrir l’enregistrement utilisateur dans un onglet.


    Sélectionnez le décorateur de champ pour ouvrir l’enregistrement utilisateur.

    L’action de champ, Ouvrir l’enregistrement, doit exister en tant que définition d’action d’espace de travail avant de créer une affectation d’action. L’icône, icon-user, doit être une icône disponible dans votre instance.

    Procédure

    1. Accédez à la Tous > Expérience d'espace de travail > Actions et composants > Décorateurs de champ.
    2. Sélectionnez Nouveau.
    3. Renseignez les champs du formulaire.

      Le formulaire suivant ajoute une icône de décorateur de champ aux champs URL. Lorsqu’un agent sélectionne l’icône, l’URL s’ouvre.

      Tableau 1. Formulaire Affectation d’action
      Champ Description
      Étiquette de l'action Nom du décorateur de champ, par exemple, Ouvrir une URL.
      Nom de l’action Nom qui apparaît pour cet enregistrement dans la liste des affectations d’actions : Expérience d'espace de travail > Actions et composants > Décorateurs de champ, par exemple, open_a_url.
      Remarque :
      Le nom de l’action est unique pour implémenter et identifier les remplacements. S’il existe plusieurs décorateurs avec le même nom d’action (même vide), le système suppose qu’il s’agit de doublons et n’affiche que le premier, en fonction de l’ordre.
      Implémenté en tant que
      • L’action du client UXF est la charge utile à répartir vers l’événement interne lorsque l’action est déclenchée (par exemple, l’ouverture d’un modal ou la navigation vers un onglet).
      • Script client pour écrire et exécuter des scripts clients à l’aide des API g_form et g_list .
      • Script serveur à exécuter lorsque l’action est déclenchée.
      Remarque :
      Le composant d’interface utilisateur et l’action client ne sont des sélections valides que pour la version héritée Espace de travail et ne fonctionnent pas avec les espaces de travail configurables.
      Spécifier l'action du client Sélectionnez l’icône de loupe ( icône de loupe) et sélectionnez l’action à effectuer. Pour ouvrir une URL, sélectionnez Ouvrir l’URL. Ce champ s’affiche uniquement lorsqu’il est implémenté en tantqu’action du client UXF. Vous ne pouvez pas ajouter d’actions personnalisées à cette liste.
      Le décorateur s'applique à Le type de champ signifie que le décorateur apparaît pour tous les champs de ce type (par exemple, tous les champs de référence). Un champ spécifique signifie que le décorateur s’affiche uniquement à côté du champ spécifique que vous sélectionnez (par exemple, Affecté à).
      Type de champ Sélectionnez le type de champ dans lequel vous souhaitez que le décorateur de champ apparaisse, par exemple, Référence. Le type de champn’apparaît que lorsque le décorateur s’applique à est Type de champ.
      Nom de champ Sélectionnez le champ dans lequel vous souhaitez que le décorateur de champ s’affiche. Les choix des champs dépendent de la valeur de Table. Par exemple, sélectionnez Affecté à. Ce champ n’apparaît que lorsque le décorateur s’applique à un champ spécifique.
      Remarque :
      Seul un sous-ensemble de types de champs prend en charge les décorateurs de champ. Bien que vous puissiez sélectionner n’importe quel champ dans une table, le type doit être pris en charge.
      Icône Icône sélectionnable qui apparaît dans le champ spécifié par Type de champ ou Nom de champ qui lance l’action.
      Info-bulle Texte qui s’affiche lorsqu’un agent passe la souris sur l’icône.
      Description Description de cette action.
      Application Application à laquelle ce composant s’applique. Global signifie que le composant s’applique à toutes les applications.
      Table Table à laquelle ce composant est lié. Lorsqu’un enregistrement de cette table s’ouvre, le décorateur de champ apparaît dans le champ Spécifié par Type de champ ou Nom de champ. La valeur par défaut est Global. Vous pouvez conserver la valeur par défaut afin que l’icône de décorateur de champ apparaisse pour tout enregistrement ouvert dont le champ est spécifié par Type de champ. Si vous spécifiez une table, ce n’est que lorsque les enregistrements de cette table sont ouverts que l’icône du décorateur de champ apparaît.
      Vue Vue de formulaire où le décorateur doit apparaître. S’il n’est pas renseigné, le décorateur apparaît sur toutes les vues de formulaire.
      Expérience restreinte Sélectionnez cette option si vous souhaitez que le décorateur apparaisse uniquement dans des expériences d’espace de travail spécifiques. Si vous sélectionnez cette option, vous devez choisir les expériences pour lesquelles le décorateur doit apparaître. Pour ce faire, vous pouvez sélectionner les configurations d’action correspondantes dans la liste connexe Configurations d’action .
      Actif Basculez pour que ce décorateur de champ apparaisse (sélectionné) ou non.
      Ordre Nombre entier qui régit le placement de cette icône dans la liste des décorateurs de champ d’un champ. Plus le nombre est bas, plus il est à gauche dans la liste. La pratique typique consiste à faire de ces nombres des centaines, par exemple, 100, 200, 300 et 400, afin de pouvoir placer de nouvelles icônes entre les icônes existantes à l’avenir.
    4. Cliquez avec le bouton droit de la souris sur la bannière supérieure et sélectionnez Enregistrer.
    5. Facultatif : Dans l’onglet de liste connexe Exclusion d’action , sélectionnez Nouveau pour exclure toutes les tables et tables enfants de l’héritage de ce décorateur.
      1. Renseignez les champs du formulaire.
        Tableau 2. Formulaire Exclusion d’action
        Champ Description
        Affectation d'action Sélectionnez l’icône de loupe Icône de loupe et sélectionnez une affectation d’action, qui spécifie l’affectation d’action.
        Table Table associée à ce décorateur.
        Exclure cette table Activez cette option pour empêcher cette table d’hériter de ce composant à partir de ses tables parentes.
        Exclure toutes les tables enfants Activez cette option pour empêcher les tables enfants de Table d’hériter de ce décorateur de champ.
      2. Sélectionnez Envoyer.
    6. Sous Liens connexes, sélectionnez Vue avancée.
      Remarque :
      Jusqu’à présent, vous n’avez pas spécifié l’URL que vous souhaitez ouvrir lorsqu’un agent sélectionne l’icône de décorateur de champ. Il s’agit de la tâche que vous effectuez dans la vue avancée.
    7. Dans l’onglet Attributs d’actions , sous la Carte de charge utile. Sélectionnez l’attribut d’action que vous souhaitez définir.
    8. Dans le champ de valeur, entrez l’URL à ouvrir.
    9. Facultatif : Dans l’onglet Conditions , spécifiez les conditions du décorateur de champ.
      1. Sélectionnez Conditions de script pour entrer un script qui masque le décorateur de champ.
      2. Remarque :
        Cette configuration accède à tous les champs et donne la possibilité d’évaluer les conditions côté client sans avoir à enregistrer le formulaire. Les conditions du client ne donnent accès qu’à un sous-ensemble de champs.
        Sélectionnez Conditions client scriptées pour spécifier les conditions sur le client qui afficheraient ou masqueraient le décorateur de champ.
      3. Sélectionnez Conditions client pour spécifier les conditions sur le client qui afficheraient ou masqueraient le décorateur de champ.
      4. Sélectionnez Conditions d’enregistrement pour spécifier un champ et une valeur, dans un enregistrement ouvert, que le décorateur de champ n’affiche pas.
      5. Sélectionnez Rôles requis pour spécifier les rôles nécessaires pour afficher le décorateur de champ.
    10. Remarque :
      Dans l’onglet Paramètres de confirmation .
      Sélectionnez Confirmation requise pour afficher une fenêtre contextuelle qui demande à l’agent de confirmer l’action effectuée par le décorateur de champ.
    11. Sélectionnez Mettre à jour.