Configurer des actions d’interface utilisateur personnalisées dans legacy workspace

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 5 minutes de lecture
  • Configurez des actions d’interface utilisateur à personnaliser legacy workspace pour votre organisation. Les actions d’interface utilisateur incluent des boutons personnalisés, des éléments de menu et la limitation de l’accès aux formulaires en fonction du rôle d’un utilisateur.

    Avant de commencer

    Rôle requis : workspace_admin

    Pourquoi et quand exécuter cette tâche

    Les actions d’interface utilisateur s’affichent sous la forme de boutons de formulaire ou d’éléments de liste dans le menu Action d’interface utilisateur.

    Éléments de liste et boutons d’action d’interface utilisateur

    Chaque espace de travail est livré préconfiguré avec des actions d’interface utilisateur. Vous pouvez toutefois ajouter ou supprimer des actions d’interface utilisateur préconfigurées.

    Vous pouvez masquer les actions d’interface utilisateur pour les personnes qui n’ont pas besoin d’agir sur les enregistrements. Pour plus d’informations, voir Masquer l’onglet Détails et les actions d’interface utilisateur.

    Procédure

    1. Accédez à la Tout > Définition du système > Actions d'interface utilisateur et cliquez sur Nouveau.
    2. Renseignez les champs du formulaire.
      Remarque :
      D’autres champs que ceux de la table suivante apparaissent dans le formulaire, mais ils ne fonctionnent pas dans les espaces de travail. Pour en savoir plus sur chaque champ du formulaire Actions d’interface utilisateur, consultez Actions d’interface utilisateur.
      Nom Nom de l’action d’interface utilisateur. Cela apparaît dans l’interface utilisateur de l’espace de travail, par exemple, Affecter l’incident à moi.
      Table Table à laquelle l’action d’interface utilisateur s’applique. Chaque fois qu’un agent affiche un enregistrement de cette table, cette action d’interface utilisateur s’affiche.
      Ordre Placement dans la liste horizontale des actions d’interface utilisateur. De gauche à droite, les numéros d’ordre vont du plus petit au plus grand.
      Nom de l'action Équivalent du nom qui apparaît dans les journaux et les colonnes de table, par exemple, assign_incident_to_me
      Actif Basculez pour faire apparaître l’action d’interface utilisateur.
      Afficher l'insertion Basculez pour insérer le changement d’enregistrement dans la table.
      Afficher la mise à jour Activer/désactiver cette option pour afficher la mise à jour dans la table.
      Client

      Activez/désactivez cette option pour que le système vérifie les scripts côté client. Il s’agit par défaut de scripts côté serveur. Utilisez l’API GlideAgentWorkspace dans un script pour ouvrir un enregistrement et Espace de travail un onglet spécifié.

      Remplacements Actions d’interface utilisateur qui remplacent cette action d’interface utilisateur.
      Commentaires Description de cette action d’interface utilisateur.
      Conseil Décrit l’action d’interface utilisateur lorsque la souris survole l’action d’interface utilisateur.
      Onclick Action effectuée avec un clic de souris sur l’action d’interface utilisateur, par exemple, confirmAndDeleteFromForm().
      Condition Conditions qui doivent être remplies pour que l’action d’interface utilisateur s’affiche, par exemple, current.isValidRecord() && current.canDelete().
      Script Script côté serveur qui implémente l’action d’interface utilisateur.
      Application

      Application à laquelle ce composant s’applique. Global signifie que le composant s’applique à toutes les applications.

      Bouton du formulaire Basculez pour afficher l’action d’interface utilisateur sous forme de bouton dans le panneau de formulaire.
      Menu contextuel du formulaire Basculez pour afficher l’action d’interface utilisateur sous forme d’onglet dans le menu Éléments connexes.
      Lien du formulaire Basculez pour afficher l’action d’interface utilisateur sous forme de lien dans le volet de formulaire.
      Style du formulaire
      • Primary (Primaire) : colore l’action d’interface utilisateur en bleu.
      • Destructif (Destructeur) : colore l’action d’interface utilisateur en rouge.
      • Unstyle (Unstyled) : ne colore pas l’action d’interface utilisateur.
      Bouton de bannière de la liste Basculez pour afficher l’action d’interface utilisateur sous forme de bouton dans la bannière de liste.
      Bouton de bas de liste Basculez pour afficher l’action d’interface utilisateur sous forme de bouton en bas de la liste des enregistrements.
      Menu contextuel de la liste Basculez pour afficher l’action d’interface utilisateur en tant qu’entrée dans le menu contextuel de la liste.

      Menu contextuel

      Choix de la liste Activez/désactivez cette option pour afficher l’action d’interface utilisateur sous la forme d’une liste déroulante de choix dans la vue de liste.
      Lien de la liste Basculez pour afficher l’action d’interface utilisateur sous forme de lien dans la vue de liste.
      Style de la liste
      • Primary (Primaire) : colore l’action d’interface utilisateur en bleu.
      • Destructif (Destructeur) : colore l’action d’interface utilisateur en rouge.
      • Unstyle (Unstyled) : ne colore pas l’action d’interface utilisateur.
    3. Facultatif : Pour créer un script côté serveur qui implémente l’action d’interface utilisateur, saisissez le script dans le champ Script .
      Par exemple, si vous souhaitez inclure le nom de l’appelant et la brève description dans un incident créé à partir d’un enregistrement d’interaction, vous pouvez utiliser le script suivant qui utilise GlideRecord
      if(current.update()){
      	var inc = new GlideRecord("incident");
      	inc.newRecord();
      	inc.caller_id = current.opened_for;
      	inc.short_description = current.short_description;
      	action.openGlideRecord(inc);
      }

      Le système ignore les scripts clients inclus dans ce champ. Vous ne pouvez utiliser le champ de script client de l’espace de travail que pour les scripts clients.

    4. Facultatif : Pour créer un script côté client qui implémente l’action d’interface utilisateur, consultez Types de scripts clients et API pris en charge et Scripts clients et Portail de services.
      Remarque :
      Dans le formulaire de script client, vous devez sélectionner l’option Isoler le script pour qu’un script client fonctionne dans un legacy workspacefichier .
    5. Dans l’onglet Espace de travail , sélectionnez : Bouton de formulaire d’espace de travail pour faire apparaître l’action d’interface utilisateur sur la ligne des actions d’interface utilisateur ou Menu de formulaire d’espace de travail pour l’afficher en tant qu’élément de liste dans la liste de menu.
      • Formulaire d’espace de travail Bouton permettant de faire apparaître l’action d’interface utilisateur dans la liste des actions d’interface utilisateur.
      • Menu du formulaire d’espace de travail pour faire apparaître l’action d’interface utilisateur comme un élément de liste dans le menu associé aux actions d’interface utilisateur.
      • Le format de l’espace de travail configurable permet à l’action d’interface utilisateur d’apparaître dans les espaces de travail configurables.
        Remarque :
        Pour les nouvelles actions d’interface utilisateur, si un utilisateur sélectionne le bouton du formulaire d’espace de travail ou le menu du formulaire d’espace de travail, cette propriété est automatiquement sélectionnée.
        • Si un utilisateur tente de sélectionner le format de l’espace de travail configurable avant de sélectionner le bouton du formulaire d’espace de travail ou le menu du formulaire d’espace de travail, un message d’erreur s’affiche.
        • Si un utilisateur souhaite uniquement que l’action apparaisse dans AWS hérité (non configurable), il doit décocher cette case.
        • Si un utilisateur souhaite qu’une action d’interface utilisateur existante s’affiche dans les espaces de travail configurables, il doit cocher cette case et enregistrer l’enregistrement.
    6. Facultatif : Dans le champ Script client de l’espace de travail , créez un script client spécifique à l’espace de travail.
      Workspace présente des limitations de scripting client similaires à celles de Portail de services. Par exemple, pour ouvrir un formulaire en cliquant dessus, vous pouvez ajouter le script client suivant :
      function onClick(g_form) {
      
      }
    7. Dans l’onglet Requiert un rôle de la section Espace de travail, ajoutez les rôles auxquels vous souhaitez limiter l’accès à l’action d’interface utilisateur.
    8. Cliquez sur Envoyer ou Mettre à jour.

    Que faire ensuite