Configurer une fonction d’action

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.

Avant de commencer

Rôle requis : admin

Procédure

1. Accédez à la Tous > Mobile système > Gé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 le nom de l’écran d’application.
   L'écran d'accueil des catégories Générateur d'apps mobiles s'affiche.
3. Sélectionnez Fonctions dans le menu, puis Nouveau.
4. Remplissez les champs du formulaire.

   Tableau 1. Champs des fonctions

   Champ	Description
   Propriétés
   Nom	Nom de la fonction. Choisissez un nom facile à identifier.
   Description	Informations supplémentaires sur la fonction.
   Type	Type de fonction. Sélectionnez Action item (Élément d’action).
   Contexte	Niveau auquel appliquer l’action. Record (Enregistrement) : applique une action au niveau de l’enregistrement. Par exemple, utilisez cette option pour créer un bouton qui modifie l’état d’un enregistrement. Vous pouvez définir le contexte sur Enregistrement pour les actions sur un champ particulier, un enregistrement particulier ou des actions de balayage. Si la fonction d’action inclut un paramètre d’interface utilisateur avec le champ Source d’entrée défini sur Remplissage automatique, vous devez spécifier la table dans le champ Table . Global : applique une action au niveau global ou de la liste. Par exemple, utilisez cette option pour ajouter un bouton qui crée un enregistrement. N’utilisez pas le paramètre Global pour les actions qui sont dans le contexte d’un enregistrement ou les actions qui incluent un paramètre d’interface utilisateur avec le champ Source d’entrée défini sur Remplissage automatique. Pour plus d’informations sur l’emplacement des boutons, reportez-vous à la section Associer une fonction à un emplacement dans l’application.
   Disponible en mode hors connexion	Indique si cette fonction est disponible lorsque l’appareil est hors ligne. Remarque : Cette option est prise en charge uniquement sur l’application ServiceNow Agent mobile .
   Élément d'action	Élément d’action à associer à l’action. Pour plus d'informations, consultez Configurer un élément d’action.
   Paramètres
   Autoriser le téléchargement des images	Permet de télécharger des images. Les images sont stockées dans la table des pièces jointes [sys_attachment].
   Afficher le champ de signature	Nécessite une signature de l’utilisateur avant de soumettre l’action. Les utilisateurs peuvent signer avec leurs doigts ou taper leur nom dans le champ de signature. Si Autoriser le téléchargement des images est sélectionné, une image de la signature est envoyée à la table Images de signature [signature_image] lorsque l’action s’exécute. Si cette option est sélectionnée, le formulaire de signature s’affiche sur une page séparée. Pour superposer le formulaire de signature, utilisez l’option Signature dans le champ Conditions préalables .
   Utiliser la superposition	Superpose un paramètre d’entrée de texte à l’écran de détails actuel. Un seul paramètre d’entrée de texte doit être défini pour l’action. Si cette option n’est pas définie, le paramètre d’entrée s’affiche sur un écran séparé.
   Conditions préalables	Sélectionnez une option pour demander la confirmation de l’utilisateur avant de soumettre l’action. Aucun : ne nécessite pas de confirmation de l’utilisateur. Il s’agit de l’option par défaut. Signature de tâche RH : demandez la signature d’un utilisateur avant de soumettre l’action. Les utilisateurs peuvent signer avec leurs doigts ou taper leur nom dans le champ de signature. Si Autoriser le téléchargement des images est sélectionné, une image de la signature est envoyée à la table Images de signature [signature_image] lorsque l’action s’exécute. Lorsque cette option est sélectionnée, le formulaire de signature se superpose à l’écran actuel. Informations d’identification de tâche RH : demandez aux utilisateurs de saisir leurs informations d’identification avant de soumettre l’action. Cette option n’est prise en charge qu’avec l’authentification locale. Nouvelle authentification : exige que les utilisateurs authentifient à nouveau leurs informations d’identification avant d’exécuter une action. Pour plus d'informations, consultez Configurer les propriétés système de nouvelle authentification mobile.
   Données
   Table	La table à laquelle l’action s’applique. La sélection d’une table est requise si le contexte est défini sur Enregistrement. Si le contexte est défini sur Global, la sélection d’une table est facultative.
   Conditions
   Condition	Conditions qui doivent être remplies pour utiliser l’action. Par exemple, vous pouvez empêcher les utilisateurs de résoudre un incident dont l’état est Fermé, Résolu ou Annulé.
   Messages
   Afficher le message de confirmation	Affiche un message de confirmation pour vérifier si un utilisateur souhaite poursuivre l’action.
   Message de confirmation	Le message de confirmation à afficher. Remarque : S’affiche uniquement si l’option Afficher le message de confirmation est sélectionnée.
   Étiquette Confirmation	Étiquette du bouton permettant de confirmer l’action. Remarque : S’affiche uniquement si l’option Afficher le message de confirmation est sélectionnée.
   Étiquette Annuler	Étiquette du bouton permettant d’annuler l’action. Remarque : S’affiche uniquement si l’option Afficher le message de confirmation est sélectionnée.
   Message de réussite	Texte d’un message de confirmation de réussite. Utilisez des accolades pour créer un message de réussite dynamique. Par exemple, {{number}} a été mis à jour avec succès.
   Message d'échec	Texte d’un message de confirmation d’échec. Utilisez des accolades pour créer un message d’échec dynamique. Par exemple, {{number}} n’a pas pu être mis à jour.
   Messages de confirmation
   Afficher le texte de confirmation	Exigez une confirmation de l’utilisateur avant de soumettre l’action. Si ce champ est activé, le champ Contexte doit être Enregistrement.
   Champ Confirmation	Champ qui inclut le texte de confirmation que vous souhaitez afficher à l’utilisateur. Sélectionnez la table du champ dans la zone de données . Seuls les champs de chaîne sont pris en charge. Remarque : S’affiche uniquement si l’option Afficher le texte de confirmation est sélectionnée.
   Étiquette Confirmation	Étiquette du bouton de confirmation qui apparaît sous le texte de confirmation. La valeur par défaut est J’accepte. Remarque : S’affiche uniquement si l’option Afficher le texte de confirmation est sélectionnée.
   Fin de l'action
   Actualiser tout l'écran après l'action	Option pour que l’écran actuel s’actualise automatiquement lorsqu’une action est terminée. Cette option n’est disponible que lorsque le contexte est défini sur Global. Remarque : L’option d’actualisation est prise en charge pour les écrans (applets), mais pas pour les écrans de lanceur.
   Passer à l'écran précédent	Redirige l’utilisateur vers l’écran précédent après avoir effectué une action.
   Afficher l'actualisation sur l'écran précédent	Affiche un message Nouvelle mise à jour une fois que l’utilisateur a terminé l’action et est redirigé vers l’écran précédent.
   Accéder à l'écran après une action terminée correctement	Affiche des options de configuration de navigation d’écran supplémentaires une fois que l’utilisateur a terminé une action. Utilisez ce champ pour déterminer si une interaction de l’utilisateur est requise avant de naviguer vers un écran spécifié. Cette option n’est disponible que lorsqu’une table est sélectionnée dans la zone Condition du formulaire.
   Accéder à l'écran sans aucune interaction de l'utilisateur	Envoie l’utilisateur à l’écran de destination. Si cette option est sélectionnée, la redirection vers l’écran de destination se produit automatiquement sans interaction de l’utilisateur. Si cette option n’est pas sélectionnée, la redirection se produit uniquement avec une interaction de l’utilisateur sur un message de réussite. Pour définir un message de réussite, vous devez remplir les champs obligatoires de la section Messages du formulaire. Remarque : Cette option n’est disponible que lorsque l’option Accéder à l’écran après avoir réussi l’exécution de l’action est sélectionnée.
   Remplir automatiquement les paramètres d'écran	Remplit automatiquement les paramètres dans l’écran de destination. Remarque : Cette option n’est disponible que lorsque l’option Accéder à l’écran après avoir réussi l’exécution de l’action est sélectionnée.
   Passer à l'écran de destination	Spécifie l’écran vers lequel l’utilisateur est redirigé après avoir réussi l’exécution de l’action. Cet écran affiche les enregistrements nouvellement créés, le cas échéant. Remarque : Cette option n’est disponible que lorsque l’option Accéder à l’écran après avoir réussi l’exécution de l’action est sélectionnée.
   Paramètres de l'interface utilisateur	Remplit automatiquement les paramètres dans l’écran de destination. Remarque : Cette option n’est disponible que lorsque l’option Accéder à l’écran après une action terminée correctement est sélectionnée.
   Entrées groupées	Ce champ n’est pas utilisé pour configurer une fonction d’action. L’entrée groupée permet aux utilisateurs de scanner plusieurs codes-barres séquentiellement. Vous pouvez configurer des entrées groupées avec des paramètres d’interface utilisateur pour accepter plusieurs lectures de codes-barres. Pour en savoir plus sur les entrées groupées, consultez Configurer une entrée groupée pour plusieurs scans
   Attributs de bouton	Spécifie un attribut supplémentaire pour un bouton. Sélectionnez Nouveau pour configurer cette option. Vous pouvez sélectionner parmi les attributs de bouton suivants : alerts_require_dismissal : lorsqu’il est défini sur vrai, l’attribut button permet aux messages de la bannière de persister jusqu’à ce que l’utilisateur les ignore. Par défaut, les messages de bannières sont automatiquement ignorés. used_for_deeplink : lorsque la valeur est définie sur vrai , l’attribut button détermine que le bouton est utilisé pour la création de liens profonds. Pour plus d'informations, consultez Liens profonds pour mobile. trigger_offline_cache_download : lorsqu’il est défini sur vrai , l’attribut button déclenche la génération de cache hors ligne. Une fois le cache généré avec succès, son téléchargement est déclenché. check_acl_on_url_parameter_field : lorsque cet attribut de bouton est sélectionné et défini sur vrai, n’importe quel champ de la chaîne d’URL est vérifié par rapport à l’ACL (liste de contrôle d’accès). Par exemple, une chaîne comme {{meeting_id}}. Si un champ ne réussit pas cette vérification, la valeur du champ n’est pas incluse dans l’URL. Par défaut, le champ de paramètre URL n’est pas vérifié par rapport à l’ACL pour vérifier la rétrocompatibilité.
   Accès du rôle	Limitez l’accès de l’utilisateur à une action par rôle.

   Remarque :

   Bien que toutes les options dans la zone Action à remplir du formulaire puissent être définies, leurs actions peuvent se chevaucher. Assurez-vous de tester les paramètres afin que les résultats produisent les résultats attendus.
5. Sélectionnez Enregistrer.

Que faire ensuite

Après avoir créé une fonction d’action, vous devez l’associer à un emplacement spécifique dans l’application mobile. Vous pouvez ajouter une fonction d’action à un menu supérieur, à une action de balayage ou à un champ spécifique. Pour plus d’informations sur l’association de la fonction action à un emplacement, reportez-vous à la section Associer une fonction à un emplacement dans l’application.