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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 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 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 d’action d’interface utilisateur.

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

    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’agir 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 Tous > 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, 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 un incident.
      Table Table à laquelle l’action d’interface utilisateur s’applique. Chaque fois qu’un agent affiche un enregistrement à partir 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 de commande 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 Activez/désactivez 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. Par défaut, il s’agit de scripts côté serveur. Utilisez l’API GlideAgentWorkspace dans un script pour ouvrir un enregistrement et Espace de travail un onglet spécifiés.

      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 apparaisse, 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 Activez/désactivez cette option pour afficher l’action d’interface utilisateur sous la forme d’un bouton dans le panneau de formulaire.
      Menu contextuel du formulaire Activez/désactivez cette option pour afficher l’action d’interface utilisateur sous forme d’onglet dans le menu Éléments connexes.
      Lien du formulaire Activez/désactivez cette option pour afficher l’action d’interface utilisateur sous forme de lien dans le panneau de formulaire.
      Style du formulaire
      • Primaire : colore l’action d’interface utilisateur en bleu.
      • Destructif (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 Activez/désactivez cette option pour afficher l’action d’interface utilisateur sous forme de bouton dans la bannière de liste.
      Bouton de bas de liste Activez/désactivez cette option pour afficher l’action d’interface utilisateur sous la forme d’un bouton au bas de la liste des enregistrements.
      Menu contextuel de la liste Activez/désactivez cette option 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 Activez/désactivez cette option 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 (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, 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 tous 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 Service Portal 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 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 sous la forme d’un élément de liste dans la liste de menus.
      • Formulaire Espace de travail Bouton permettant d’afficher l’action d’interface utilisateur dans la liste des actions d’interface utilisateur.
      • Menu de formulaire d’espace de travail permettant d’afficher l’action d’interface utilisateur sous la forme d’un élément de liste dans le menu associé aux actions d’interface utilisateur.
      • 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 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 sauvegarder 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 de l’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