Créer une action d’interface utilisateur

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

    • Vous pouvez créer une nouvelle action d’interface utilisateur ou modifier une action existante.

    Avant de commencer

    Rôle requis : ui_action_admin ou admin

    Pourquoi et quand exécuter cette tâche

    Vous pouvez ajouter des actions d’interface utilisateur aux tables et aux vues de base de données qui sont dans le même champ d’application que l’action d’interface utilisateur et aux tables qui autorisent les actions d’interface utilisateur d’un autre périmètre de l’application à s’exécuter sur elles.

    Procédure

    1. Accédez à la Tous > Définition du système > Actions d'interface utilisateur.
    2. Cliquez sur Nouveau ou ouvrez un enregistrement existant.
    3. Définissez l’action d’interface utilisateur en complétant les champs.
      Vous devrez peut-être configurer le formulaire pour afficher tous les champs.
      Tableau 1. Champs Action d’interface utilisateur
      Champ Description
      Nom Définit le texte qui apparaît sur le bouton, le lien ou l’élément de menu contextuel.
      Table Définit la table sur laquelle l’action d’interface utilisateur est disponible. Par défaut, l’action d’interface utilisateur s’affiche également sur les tables qui étendent la table sélectionnée (par exemple, les actions de tâche apparaissent dans la table Incident).

      Sélectionnez Global pour rendre l’action disponible dans toutes les tables.
      Ordre Définit l’ordre dans lequel l’action d’interface utilisateur apparaît. L’ordre s’applique aux boutons de gauche à droite et aux actions de menu de haut en bas.
      Nom de l’action Définit un nom à utiliser pour faire référence à l’action d’interface utilisateur dans les scripts.
      Actif Active l’action d’interface utilisateur lorsqu’elle est sélectionnée. Pour désactiver une action d’interface utilisateur, décochez la case.
      Afficher l'insertion Affiche un bouton sur les nouveaux enregistrements qui n’ont pas été insérés.
      Afficher la mise à jour Affiche un bouton sur les enregistrements existants.
      Client L’action d’interface utilisateur exécute son script dans le navigateur de l’utilisateur, et non sur le serveur. Lorsqu’il est activé, le champ OnClick s’affiche au-dessus du champ Condition.
      Bouton du formulaire Met un bouton sur un formulaire.
      Menu contextuel du formulaire Place un élément dans un menu contextuel de formulaire (cliquez avec le bouton droit sur l’en-tête du formulaire).
      Lien du formulaire Place un lien dans la section Liens connexes d’un formulaire.
      Bouton de bannière de la liste Place un bouton dans la bannière d’une liste.
      Remarque :
      Les boutons de bannière de liste ne sont pas destinés à prendre en charge des conditions spécifiques à un enregistrement. Ainsi, seule la première ligne est prise en compte lors de l’évaluation de la condition pour déterminer si le bouton s’affichera pour la liste. N’utilisez pas de conditions spécifiques à l’enregistrement (par exemple, current.getValue('state') === 'closed') dans les actions d’interface utilisateur du bouton de bannière de liste.
      Bouton de bas de liste Place un bouton au bas d’une liste.
      Remarque :
      Les boutons de bas de liste s’affichent indépendamment de la condition et sont évalués par enregistrement lors de l’exécution.
      Menu contextuel de la liste Place un élément dans un menu contextuel de champ de liste (cliquez avec le bouton droit sur une cellule d’une liste).
      Choix de la liste Place un élément dans la liste de choix d’actions au bas d’une liste.
      Remarque :
      Les boutons de bas de liste, comme les actions de choix de liste, s’affichent indépendamment de la condition et sont évalués par enregistrement lors de l’exécution.
      Lien de la liste Place un lien dans la section Liens connexes au bas d’une liste.
      Remplacements Spécifie une action d’interface utilisateur que cette action d’interface utilisateur remplace.
      Commentaires Fournit un contenu descriptif concernant cette action d’interface utilisateur.
      Conseil Définit le texte qui s’affiche lorsqu’un utilisateur pointe sur le contrôle d’action d’interface utilisateur.
      Onclick Nom de la fonction JavaScript à exécuter lorsque l’action d’interface utilisateur est exécutée. La fonction est définie dans le champ Script .
      Condition Définit les conditions qui limitent l’apparition d’une action d’interface utilisateur. Consulter Utilisation du créateur de condition pour personnaliser les actions d’interface utilisateur pour Espace de travail d'agent pour voir des exemples.
      Script Définit le script à exécuter lorsque l’action d’interface utilisateur est exécutée.
      Listes connexes dans la vue de formulaire :
      Visibilité d'action d'interface utilisateur Spécifie d’autres vues du formulaire auxquelles l’action d’interface utilisateur s’applique. Utilisez cette option pour restreindre l’action d’interface utilisateur aux vues de forme que vous spécifiez.
      Versions Affiche toutes les versions de l’action d’interface utilisateur. Utilisez cette liste pour comparer des versions ou revenir à une version précédente.
    4. Cliquez sur Envoyer ou Mettre à jour.
      Remarque :
      Si l’exécution de l’action d’interface utilisateur est activée côté client, enveloppez-la dans une fonction. Sinon, le contenu du champ Script s’exécute lorsque la page se charge.

    Exemple

    Dans le cadre d’un script d’action d’interface utilisateur, vous pouvez rediriger un utilisateur vers une URL. Par exemple, vous pouvez ajouter des liens à un formulaire ou ouvrir un nouvel enregistrement après sa création à partir d’une action d’interface utilisateur. Pour rediriger un utilisateur vers une URL à partir d’une action d’interface utilisateur, utilisez cette syntaxe dans le champ Script pour définir le lien de redirection :
    action.setRedirectURL ( 'http://www.mysite.com/mypage.htm' );
    Pour diriger un utilisateur vers un enregistrement, utilisez cette syntaxe, où new_record est le nom de variable pour le GlideRecord :
    action.setRedirectURL (new_record );

    Utilisation du créateur de condition pour personnaliser les actions d’interface utilisateur pour Espace de travail d'agent

    Configurez les actions d’interface utilisateur en ajoutant des conditions à un formulaire Action d’interface utilisateur.

    Utilisation du créateur de condition d’action d’interface utilisateur

    La condition suivante est configurée pour le bouton Fermer l’incident :

    Énoncé de condition

    Pour que cette action apparaisse sur un formulaire, ces conditions doivent être évaluées comme vraies :
    • current.incident_state doit être égal à 6 : l’incident doit déjà avoir l’état Résolu.
    • gs.hasRole("itil_admin"): l’utilisateur actuel doit avoir le rôle itil_admin.

    OU cette condition doit être évaluée comme vraie :

    gs.getUserID() == current.caller_id: l’utilisateur actuel est l’utilisateur qui a demandé le changement.
    Remarque :
    • L’objet actuel n’est pas disponible pour les conditions d’un menu contextuel de liste. L’option de menu contextuel Liste est sélectionnée. Toute utilisation de current sur ces actions est ignorée.
    • Vous pouvez référencer l’enregistrement parent des conditions d’action d’interface utilisateur sur un bouton de liste connexe. Par exemple, pour désactiver les boutons Nouveau et Modifier sur la liste connexe CI affectés pour les changements fermés, copiez les actions d’interface utilisateur M2M globales dans la table task_ci et ajoutez une condition de parent.active.
    • Si vous laissez vide l’un des champs que vous spécifiez dans votre instruction de condition, cette condition est définie par défaut sur true.

    Restreindre les actions d’interface utilisateur basées sur les vues de formulaire

    Vous pouvez restreindre les actions d’interface utilisateur afin qu’elles n’apparaissent que sur des vues de formulaire spécifiées.

    Utilisez la liste connexe Visibilité de l’action d’interface utilisateur sur le formulaire Action d’interface utilisateur pour restreindre une action d’interface utilisateur par vue. Une action d’interface utilisateur est disponible pour la vue spécifiée selon les règles suivantes :
    1. S’il n’existe aucune règle de visibilité, l’action s’affiche sur toutes les vues.
    2. Toute règle d’exclusion sur une vue donnée signifie que l’action n’apparaît pas dans cette vue.
    3. S’il existe au moins une règle d’inclusion, l’action s’affiche uniquement sur les vues qui sont spécifiquement incluses.
    Exemple : afficher une action partout sauf dans la vue Gestion des coûts
    Ajoutez une règle d’exclusion pour la vue Gestion des coûts.
    Figure 1. Exemple de vue d’action d’interface utilisateur d’exclusion
    Exemple de vue d’action d’interface utilisateur d’exclusion
    Exemple : affichez une action dans les vues Routine et ITIL, mais nulle part ailleurs
    Ajoutez des règles d’inclusion pour les vues Routine et ITIL.
    Figure 2. Exemples de vues d’actions d’interface utilisateur d’inclusion
    Exemples de vues d’actions d’interface utilisateur d’inclusion