Créer une action d’interface utilisateur

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 les tables qui autorisent l’exécution d’actions d’interface utilisateur provenant d’un autre périmètre d’application.

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 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.
   Table	Table sur laquelle l’action d’interface utilisateur est disponible. Par défaut, l’action d’interface utilisateur apparaît également sur les tables qui étendent la table sélectionnée (par exemple, les actions de tâche apparaissent sur 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 référencer l’action d’interface utilisateur dans les scripts.
   Actif	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	Une 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	Option permettant de placer un bouton sur un formulaire.
   Menu contextuel du formulaire	Option permettant de placer un élément dans le menu contextuel d’un formulaire (cliquez avec le bouton droit sur l’en-tête du formulaire).
   Lien du formulaire	Option permettant de placer 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 à un enregistrement. 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’affiche 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	Option permettant de placer un bouton au 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 (clic droit sur une cellule dans 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, tels que les actions de choix de liste, s’affichent quelle que soit 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.
   Contournements	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 figure sur une ligne distincte dans le champ Messages. L’instance recherche une chaîne de messages localisée chaque fois que l’action d’interface utilisateur effectue un appel getMessage(msg) où la chaîne de msg correspond à une clé dans le champ Messages.
   Commentaires	Contenu descriptif concernant cette action d’interface utilisateur.
   Conseil	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	Instruction conditionnelle JavaScript qui limite l’apparition 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 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	Script à exécuter lorsque l’action d’interface utilisateur est exécutée. Les noms de fonctions doivent être uniques.
   Espace de travail
   Bouton du formulaire d'espace de travail	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 de faire apparaître l’action d’interface utilisateur sous la forme d’un é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	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	Les 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’y a pas de règles 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.

4. Cliquez sur Envoyer ou Mettre à jour.
   Remarque :

   Si l’action d’interface utilisateur est activée pour s’exécuter côté client, encapsulez-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 se trouve le nom de variable pour le GlideRecord :

action.setRedirectURL (new_record );