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

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 5 minutes de lecture
  • Configurez des actions d’interface utilisateur à personnaliser legacy workspace pour votre organisation. Les actions d’interface utilisateur comprennent des boutons personnalisés, des éléments de menu et limitent 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.

    Boutons d’action d’interface utilisateur et éléments de liste

    Chaque espace de travail est 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’effectuer d’action sur les enregistrements. Pour plus d’informations, consultez 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 plus d’informations sur chaque champ du formulaire Actions d’interface utilisateur, voir Actions d’interface utilisateur.
      Nom Nom de l’action d’interface utilisateur. Cela s’affiche dans l’interface utilisateur de l’espace de travail, par exemple, Affecter un incident à moi.
      Table Table à laquelle l’action d’interface utilisateur s’applique. Cette action d’interface utilisateur s’affiche chaque fois qu’un agent affiche un enregistrement de cette table.
      Commande Positionnement dans la liste horizontale des actions d’interface utilisateur. De gauche à droite, les numéros d’ordre vont du petit au 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 Basculez pour afficher la mise à jour dans la table.
      Client

      Basculez pour que le système vérifie les scripts côté client. La valeur par défaut est les scripts côté serveur. Utilisez l’API GlideAgentWorkspace dans un script pour ouvrir un enregistrement spécifié et un Espace de travail onglet.

      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 satisfaites pour que l’action d’interface utilisateur apparaisse, par exemple, current.isValidRecord() & current.canDelete().
      Script Script côté serveur qui implémente l’action d’interface utilisateur.
      Demande

      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 volet 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
      • Primaire : colore l’action d’interface utilisateur en bleu.
      • Destructif : colore l’action d’interface utilisateur en rouge.
      • Sans style : 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 la 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 Basculez 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
      • Primaire : colore l’action d’interface utilisateur en bleu.
      • Destructif : colore l’action d’interface utilisateur en rouge.
      • Sans style : 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, entrez le script dans le champ Script .
      Par exemple, si vous souhaitez inclure le nom de l’appelant et la description brève 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 tous les scripts clients inclus dans ce champ. Vous ne pouvez utiliser que le champ de script client de l’espace de travail 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 Portail de services et scripts clients.
      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 workspace.
    5. Dans l’onglet Espace de travail , sélectionnez : Formulaire d’espace de travail Bouton permettant d’afficher l’action d’interface utilisateur sur la ligne des actions d’interface utilisateur ou Menu du formulaire d’espace de travail pour l’afficher sous forme d’élément de liste dans la liste de menu.
      • Formulaire d’espace de travail Bouton permettant d’afficher l’action d’interface utilisateur sur la liste des actions d’interface utilisateur.
      • Formulaire d’espace de travail Menu permettant d’afficher l’action d’interface utilisateur sous forme d’é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 Formulaire d’espace de travail ou Menu de 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 Formulaire d’espace de travail ou Menu de formulaire d’espace de travail, un message d’erreur s’affiche.
        • Si un utilisateur souhaite uniquement que l’action s’affiche 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 a des limitations de script 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 Exige un rôle de la section Espace de travail, ajoutez tous 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