Créer une action d’interface utilisateur

Rversion finale: Australia

Mis à jour 12 mars 2026

6 minutes de lecture

Vous pouvez créer une nouvelle action d’interface utilisateur ou en modifier une 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 l’exécution d’actions d’interface utilisateur provenant d’un autre périmètre de l’application.

Procédure

Accédez à la Tous > Définition du système > Actions d'interface utilisateur.
Cliquez sur Nouveau ou ouvrez un enregistrement existant.

Définissez l’action d’interface utilisateur en complétant les champs.

Vous devrez peut-être configurer le formulaire pour voir tous les champs.

Tableau 1. Champs d’action d’interface utilisateur
Champ	Description
Nom	Texte qui apparaît sur le bouton, le lien ou l’élément de menu contextuel. Remarque : Si les champs Nom de l’action et Nom sont exactement les mêmes dans deux actions d’interface utilisateur différentes, ils seront dédupliqués lors de l’exécution pour empêcher les utilisateurs de voir deux des mêmes actions.
Table	Table dans laquelle l’action d’interface utilisateur est disponible. Par défaut, l’action d’interface utilisateur apparaît également dans 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 sur toutes les tables.
Ordre	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	Nom unique à utiliser pour faire référence à l’action d’interface utilisateur dans les scripts. Remarque : Si les champs Nom de l’action et Nom sont exactement les mêmes dans deux actions d’interface utilisateur différentes, ils seront dédupliqués lors de l’exécution pour empêcher les utilisateurs de voir deux des mêmes actions.
Actives	Une option permettant d’activer 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	Option permettant d’afficher un bouton sur les nouveaux enregistrements qui n’ont pas été insérés.
Afficher la mise à jour	Option permettant d’afficher un bouton sur les enregistrements existants.
Client	Option permettant à l’action d’interface utilisateur d’exécuter son script dans le navigateur de l’utilisateur et non sur le serveur. Lorsque cette option est activée, le champ OnClick apparaît au-dessus du champ Condition.
Bouton du formulaire	Une option permettant de placer un bouton sur un formulaire.
Menu contextuel du formulaire	Option permettant de placer un élément dans un menu contextuel de formulaire (cliquez avec le bouton droit sur l’en-tête du formulaire).
Lien du formulaire	Option permettant de mettre un lien dans la section Liens connexes d’un 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	Option permettant de placer 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 aux enregistrements. C’est pourquoi seule la première ligne est prise en compte lors de l’évaluation de la condition pour déterminer si le bouton s’affichera dans 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	Une option permettant de placer un bouton en bas d’une liste. Remarque : Les boutons de bas de liste s’affichent quelle que soit la condition et sont évalués par enregistrement lors de l’exécution.
Menu contextuel de la liste	Option permettant de placer un élément dans le menu contextuel d’un champ de liste (cliquez avec le bouton droit sur la cellule d’une liste).
Choix de la liste	Option permettant de placer un élément dans la liste de choix d’actions en 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	Option permettant de placer un lien dans la section Liens connexes en bas d’une 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.
Remplacements	Action d’interface utilisateur que cette action d’interface utilisateur remplace.
Messages	Chaînes de texte que l’action d’interface utilisateur peut utiliser comme clé pour rechercher une alternative de message localisé à partir de la table Message [sys_ui_message]. Chaque clé de message se trouve sur une ligne distincte dans le champ Messages. L’instance recherche une chaîne de message localisée chaque fois que l’action d’interface utilisateur effectue un appel getMessage (msg) où la chaîne de message correspond à une clé dans le champ Messages.
Commentaires	Contenu descriptif concernant cette action d’interface utilisateur.
Conseil	Le texte qui s’affiche lorsqu’un utilisateur pointe sur le contrôle de l’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	Une instruction conditionnelle JavaScript qui restreint l’affichage d’une action d’interface utilisateur. Les conditions s’exécutent toujours sur le serveur. Remarque : L’objet actuel n’est pas disponible pour les conditions d’un menu contextuel de liste. Si 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 pour les conditions d’action d’interface utilisateur sur un bouton de liste connexe. Par exemple, pour désactiver les boutons Nouveau et Modifier de 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 .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.
Script	Le script à exécuter lorsque l’action d’interface utilisateur est exécutée. Les noms de fonction doivent être uniques.
Espace de travail
Bouton du formulaire d’espace de travail	Une option permettant de faire apparaître l’action d’interface utilisateur sur la liste des actions d’interface utilisateur dans un espace de travail.
Menu du formulaire d’espace de travail	Option permettant d’afficher l’action d’interface utilisateur sous forme d’élément de liste dans le menu associé aux actions d’interface utilisateur dans un espace de travail.
Format de l’espace de travail configurable	Option permettant d’utiliser l’action d’interface utilisateur dans un espace de travail configurable. Si elle est décochée, l’action d’interface utilisateur s’applique dans les espaces de travail hérités.
Script client d’espace de travail	Un script à exécuter lorsque l’action d’interface utilisateur est exécutée dans les espaces de travail.
Demande un rôle
Rôle	Les rôles requis pour que l’action d’interface utilisateur s’applique. Les utilisateurs doivent avoir au moins un des rôles pour que l’action d’interface utilisateur s’applique.
Listes connexes sur la vue de formulaire
Visibilité d'action d'interface utilisateur	Vues du formulaire auxquelles l’action d’interface utilisateur s’applique. Utilisez cette option pour limiter l’action d’interface utilisateur aux vues de formulaire que vous spécifiez. Une action d’interface utilisateur est disponible pour la vue spécifiée selon les règles suivantes : S’il n’existe aucune règle de visibilité, l’action apparaît sur toutes les vues. Toute règle d’exclusion sur une vue donnée signifie que l’action n’apparaît pas sur cette vue. S’il existe au moins une règle d’inclusion, l’action s’affiche uniquement sur les vues spécifiquement incluses.
Versions	Toutes les versions de l’action d’interface utilisateur. Utilisez cette liste pour comparer les versions ou pour revenir à une version précédente.

Cliquez sur Soumettre ou Mettre à jour.

Remarque :
Si l’action d’interface utilisateur est activée pour s’exécuter 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 vers 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 );