--- sourceDocument: Configuration et navigation mobiles Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/mobile Release : - yokohama ft:locale : - fr-FR ft:publication_title : - Configuration et navigation mobiles Yokohama ft:clusterId : - mobile bundleId : - mobile workflow : - evelopment, Data and Analytics --- # Configurer un élément d'action # Configurer un élément d'action {#ariaid-title1} * Rversion finale: Yokohama * * Mis à jour 30 janv. 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture Pour qu'une fonction d'action fonctionne, vous devez créer un élément d'action à associer à la fonction d'action. Les éléments d'action définissent la fonction d'action et son fonctionnement. ## Avant de commencer Avant de créer un élément d'action, créez une fonction d'action. Rôle requis : admin ## Pourquoi et quand exécuter cette tâche La plupart des éléments d'action utilisent des paramètres. Utilisez des éléments d'action pour définir ce que fait une fonction d'action lorsqu'un utilisateur utilise cette fonction. Les étapes suivantes détaillent la création d'une action sans paramètres. Pour créer un élément d'action paramétré, reportez-vous à .[Configurer un élément d'action avec des paramètres](https://servicenow-prod.fluidtopics.net/I4i3KPXqXp9oPmECsASSgw "Les paramètres déterminent les informations que vous transmettez à l’action pour vous assurer que vous modifiez le bon enregistrement et pour appliquer les champs obligatoires si nécessaire. Créez un élément d’action avec des paramètres pour définir les changements apportés à une action et la façon dont les changements sont apportés.") Remarque : Les applications mobiles ServiceNow ne peuvent effectuer aucune action qui ne peut pas être effectuée dans l'interface Web de la plateforme. Par exemple, si vous utilisez des ACL pour empêcher un utilisateur de fermer un incident sans ajouter de code de résolution et de notes, l'utilisateur ne peut pas fermer un incident dans l'application sans les mêmes exigences. Gardez cela à l'esprit lors de la création d'actions afin de pouvoir ajouter les paramètres corrects. ## Procédure 1. Accédez à TousMobile systèmeGénérateur d'application mobile. Il s'ouvre Générateur d'apps mobiles dans un nouvel onglet de navigateur et affiche l'écran de sélection du périmètre de l'application. 2. Recherchez le périmètre de l'application dans lequel vous travaillez, puis sélectionnez son nom. L'écran Générateur d'apps mobiles d'accueil des catégories s'affiche. 3. Sélectionnez Fonctions dans le menu, puis sélectionnez Nouveau. 4. Sélectionnez Nouveau dans la section Élément d'action, puis renseignez les champs suivants selon vos besoins. {#sg-studio-create-action-item__table_dcb_qzh_2fb__entry__2} | Champ | Description | |-|-| | Nom | Nom attribué à l'élément d'action. Vous pouvez avoir plusieurs éléments d'action portant le même nom. Assurez-vous de choisir un nom facilement identifiable. | | Description | Plus d'informations pour vous aider à identifier l'élément d'action. | | Type | Type d'élément d'action. Vous pouvez choisir entre : * Nouveau * Mettre à jour * Supprimer * Script * MultiStep. Pour plus d'informations, consultez [Configurer les étapes d'action dans un élément d'action](https://servicenow-prod.fluidtopics.net/I4wdPd7gYjRSbGaltESXRA "Pour qu’un élément d’action puisse effectuer plusieurs processus, vous devez définir des étapes d’action distinctes."). {#sg-studio-create-action-item__ul_w1w_x13_2fb}Différents champs apparaissent sur le formulaire d'élément d'action en fonction du type d'action que vous sélectionnez. | | Table | La table à laquelle l'élément d'action s'applique, par exemple, Incident. | | Script d'exécution | Script exécuté par l'action. Ce champ s'affiche uniquement si vous sélectionnez Script comme type. Pour plus d'informations, consultez l'exemple ci-dessous. Pour utiliser une entrée provenant d'un écran de paramètres dans vos scripts, utilisez `parm_input.` Pour utiliser une variable provenant d'un écran de paramètres dans vos scripts, utilisez `parm_variable.` | | Utiliser l'enregistrement en cours en tant que condition | Indique si vous souhaitez un ensemble distinct de conditions de requête pour l'élément d'action. Si cette option est sélectionnée, le champ Query conditions (Conditions de la requête) est désactivé. Pour les actions de mise à jour ou de suppression, vous devez définir l'enregistrement que vous mettez à jour ou supprimez à l'aide d'un ID système. Le marquage de l'option Utiliser l'enregistrement en cours comme condition sur vrai vous permet de le faire sans créer de paramètre. | | Condition de la requête | Conditions de filtre qui s'appliquent à l'élément d'action. | | Définir des valeurs de champ | Déterminez les valeurs de champ d'une action. Par exemple, si vous souhaitez créer une action qui met à jour un incident avec l'état Résolu, utilisez les valeurs de champ État = Résolu. Vous pouvez également créer des éléments paramétrés à transmettre dans la valeur du champ. | | Écran du formulaire d'entrée | Sélectionnez un écran de formulaire d'entrée à utiliser pour cet élément d'action. Voir [Configurer un écran de formulaire d'entrée](https://servicenow-prod.fluidtopics.net/fwOu985E6fdzfCfyTK2QiQ "Configurez un paramètre d’entrée afin que vos utilisateurs puissent afficher une liste des enregistrements à partir de leur application mobile. Pour accéder à un enregistrement de la liste, il suffit d’appuyer sur le nom de l’enregistrement."). | [Tableau 1. Champs des éléments d'action] {#sg-studio-create-action-item__table_dcb_qzh_2fb} 5. Sélectionnez Enregistrer. ## Exemple L'exemple suivant utilise un script pour affecter une tâche à l'utilisateur actuel, à l'aide de l'objet SMTask. La première instruction `if` vérifie que l'entrée est un enregistrement `wm_task` valide et met fin au script si ce n'est pas le cas. La deuxième instruction `if` contient du code qui affecte la tâche à l'utilisateur actuel, si celui-ci en a l'autorisation, telle que déterminée par la méthode `canAssignToSelf` . Cette action a été effectuée sous forme de script plutôt que de mise à jour afin que ces vérifications puissent être incluses. (function WriteBackAction(parm_input, parm_variable) { var smTask = new global.SMTask(); var work_order_task_id = parm_variable['sys_id']; var wotGR = new GlideRecord("wm_task"); if (!wotGR.get(work_order_task_id)) { gs.error("wot_assign_to_me write-back action - failed to find work order task"); gs.addErrorMessage(gs.getMessage("Task assignment failed.")); return; } if (smTask.canAssignToSelf(wotGR)) smTask.assignToMe(gs.getUserID(), work_order_task_id); else gs.addErrorMessage(gs.getMessage("Not a valid task assignment.")); })(parm_input, parm_variable); L'exemple suivant utilise un script pour exécuter une fonctionnalité de complétion de navigation après l'exécution d'une action. Entrez `actionResult` en tant que fonction, puis définissez `setRedirectionInfo(gr.getUniqueValue(), gr.getTableName()` pour spécifier où naviguer, une fois l'action effectuée. (function WriteBackAction(parm_input, parm_variable, actionResult) {​ var gr = new GlideRecord('incident');​ gr.get(parm_variable['sys_id']);​ gr.short_description = 'Updated by Scripted Action';​ gs.addInfoMessage(gs.getMessage("This is the First success message"));​ gs.addInfoMessage(gs.getMessage("This is the Second success message"));​ gs.addInfoMessage(gs.getMessage("This is the Third success message"));​ gr.update();​ actionResult.setRedirectionInfo(gr.getUniqueValue(), gr.getTableName()); ​ })(parm_input, parm_variable, actionResult); L'exemple suivant utilise un script pour déterminer où sont stockées les pièces jointes sélectionnées par l'utilisateur dans le type d'entrée de pièce jointe. Le script joint le fichier sélectionné à un enregistrement d'incident spécifique avec le `sys_id` dans la table Incident \[incident\]. (function WriteBackAction(parm_input, parm_variable, actionResult) { var targetTableName = "incident"; var targetTableRecordSysId = "37aa099533b352102ed2923fad5c7b09"; var inputName = "input2"; // input2 stands for the input's name. The input type must be "Attachment" actionResult.addAttachment(inputName, targetTableName, targetTableRecordSysId); })(parm_input, parm_variable, actionResult); Si vous utilisez des paramètres pour l'élément d'action, vous pouvez les appeler dans le script. L'appel dans le script doit correspondre exactement au nom du paramètre. Par exemple, si le nom du paramètre est wb_wot_reject_work_note, comme dans le premier script ci-dessus, vous pouvez l'appeler dans le script en utilisant `gr.work_notes = input.wb_wot_reject_work_note ;`. ## Que faire ensuite Associez l'élément d'action à une fonction d'action, voir [Fonction d'action](https://servicenow-prod.fluidtopics.net/4Y2ltUloa1N1Gr3u5yYMAQ "Les fonctions d’action permettent à l’utilisateur de modifier quelque chose dans la base de données. Par exemple, effectuer une mise à jour ou ajouter un commentaire à un enregistrement nécessite une fonction d’action."). Associez des étapes d'action à un élément d'action, reportez-vous à la section [Configurer les étapes d'action dans un élément d'action](https://servicenow-prod.fluidtopics.net/I4wdPd7gYjRSbGaltESXRA "Pour qu’un élément d’action puisse effectuer plusieurs processus, vous devez définir des étapes d’action distinctes.").