Configurer des actions personnalisées sur des champs d’enregistrement dans legacy workspace

Configurez l’utilisation d’une valeur dans un champ de référence pour effectuer une action. Par exemple, ajoutez une icône dans un champ avec un numéro de téléphone pour composer ce numéro de téléphone. Vous pouvez également ajouter 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

Un décorateur de champ est une icône ajoutée à un champ de référence dans le volet Formulaire sur laquelle un agent peut cliquer pour effectuer une action. Workspace prend en charge jusqu’à trois décorateurs par champ.

L’objectif de la configuration des décorateurs de champ d’action d’espace de travail est de permettre aux agents d’effectuer sur une page des actions 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 clique simplement sur le décorateur de champ Action d’espace de travail dans le champ Appelant pour ouvrir l’enregistrement utilisateur dans un onglet.

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 nouvelle 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.
   Une liste des décorateurs de champ existants s’affiche.
2. Cliquez sur Nouveau.
3. Renseignez les champs du formulaire.

   La table suivante ajoute une icône de décorateur de champ aux champs URL. Lorsque les agents cliquent sur 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. Vous pouvez utiliser des accolades doubles, {{}}, pour insérer des valeurs dans le texte lors de l’exécution, par exemple, {{count}}. Par exemple, vous pouvez afficher le nombre d’enregistrements qu’un agent sélectionne à l’aide d’accolades.
   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.
   Implémenté en tant que	L’action du client est la seule sélection valide pour les décorateurs de champ. Le décorateur de champ apparaît sous forme d’icône dans un champ, un formulaire, une liste ou une liste connexe. Lorsque vous cliquez dessus, le décorateur effectue une action, comme appeler un numéro de téléphone, ouvrir un enregistrement, mettre à jour du contenu ou ouvrir une URL. Le composant d’interface utilisateur est un élément d’interface utilisateur que vous pouvez placer dans de nombreuses zones de Espace de travail. L’action du client répartit une action spécifiée dans Spécifier l’action du client. Les scripts serveur effectuent des actions sur le serveur en modifiant les enregistrements de base de données, telles que leur ajout, leur suppression ou leur modification.
   Spécifier l'action du client	Cliquez sur l’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 tant qu’action client. Vous ne pouvez pas ajouter d’actions personnalisées à cette liste.
   Spécifier le composant d'interface utilisateur	Cliquez sur l’icône de loupe ( ) et sélectionnez le composant à ajouter. Ce champ s’affiche uniquement lorsqu’il est implémenté en tant que composant d’interface utilisateur.
   Le décorateur s'applique à	Le type de champ signifie que le décorateur apparaît pour tous les champs de ce type. Un champ spécifique signifie que le décorateur s’affiche uniquement lorsque le champ que vous spécifiez est ouvert. De nombreux champs spécifiques sont du même type de champ. Par exemple, sélectionnez Type de champ pour appliquer cette icône de décorateur de champ à tous les champs URL.
   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. De nombreux champs sont de type Référence. Autre exemple, pour composer un numéro de téléphone, sélectionnez Numéro de téléphone. Ce champ, Type de champ , n’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 Date. Ce champ n’apparaît que lorsque le décorateur s’applique àun champ spécifique.
   Icône	Icône cliquable 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 quand et quand l’agent passe une souris sur l’icône.
   Description	Brève description de ce composant.
   Application	Application à laquelle ce composant s’applique. Global signifie que le composant s’applique à toutes les applications.
   Espace de travail	Espace de travail auquel appartient ce composant, par exemple, Agent Workspace, ITSM, CSM, etc.
   Table	Table à laquelle ce composant est lié. Lorsqu’un enregistrement de cette table s’ouvre, le décorateur de champ apparaît dans le(s) champ(s) spécifié(s) 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, l’icône de décorateur de champ peut apparaître uniquement lorsque les enregistrements de cette table sont ouverts.
   Vue	Un ensemble de configurations visuelles. Cette valeur correspond généralement à Espace de travail.
   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.
   Des liens connexes s’affichent.
5. Facultatif : Dans l’onglet Exclusion d’action , cliquez sur Nouveau pour empêcher les tables enfants d’hériter de ce composant dans le panneau latéral contextuel, ou cette table héritant des composants d’une table parente.
   Les composants du panneau latéral contextuel s’affichent en fonction des enregistrements ouverts dans Agent Workspace. Les tables enfants héritent de ces composants par défaut. Vous pouvez éviter que cela ne se produise.
   1. Renseignez les champs du formulaire.

      Tableau 2. Formulaire Exclusion d’action

      Champ	Description
      Affectation d'action	Cliquez sur l’icône de loupe ( ) et sélectionnez une affectation d’action, qui spécifie l’affectation d’action.
      Table	Table associée à ce composant. L’icône de ce composant s’affiche dans le panneau latéral contextuel à chaque ouverture Espace de travail d’un enregistrement à partir de cette table.
      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. Cliquez sur Envoyer.
6. Sous Liens connexes, cliquez sur Vue avancée.
   Jusqu’à présent, vous n’avez pas spécifié l’URL que vous souhaitez ouvrir lorsqu’un agent clique sur l’icône du décorateur de champ. Il s’agit de la tâche à effectuer dans la vue avancée.
7. Dans l’onglet Attributs d’action , dans la carte de charge utile, sélectionnez l’attribut d’action que vous souhaitez définir.
   Dans cet exemple, sélectionnez url.
8. Dans le champ de valeur, entrez l’URL à ouvrir.
9. Facultatif : Dans l’onglet Conditions , dans Condition de script, entrez un script qui peut masquer le décorateur de champ.
10. Facultatif : Dans l’onglet Conditions , dans Conditions client, spécifiez les conditions sur le client qui masqueraient le décorateur de champ.

    Les conditions du client sont réévaluées chaque fois qu’un agent apporte un changement à une liste d’enregistrements. Par exemple, vous pouvez masquer le bouton pour une action de liste jusqu’à ce qu’un agent sélectionne un ou plusieurs enregistrements dans une liste. La condition du client est alors « le nombre est supérieur à zéro », où nombre est le nombre d’enregistrements sélectionnés.

11. Facultatif : Sous l’onglet Conditions , dans Conditions d’enregistrement, spécifiez un champ et une valeur de sorte que si un enregistrement ouvert possède un champ avec cette valeur, l’icône de décorateur de champ n’apparaisse pas.
12. Facultatif : Dans l’onglet Conditions , dans Rôles requis, spécifiez les rôles qu’un agent doit avoir pour voir le décorateur de champ.
13. Facultatif : Dans l’onglet Paramètres de confirmation , cochez la case Confirmation requise si vous souhaitez afficher une fenêtre contextuelle demandant à l’agent de confirmer l’action effectuée par le décorateur de champ.
14. Cliquez sur Mettre à jour.

Résultats

L’icône de décorateur de champ apparaît dans tous les champs d’enregistrement de type de référence pour toutes les tables que vous avez spécifiées dans Table. Un clic sur une icône ouvre l’URL spécifiée dans la carte de charge utile.