Configurer une fonction d'action

Les fonctions d'action permettent à l'utilisateur de modifier des éléments dans la base de données. Par exemple, faire 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 > Mobile App Builder.
   Générateur d'apps mobiles s'ouvre dans un onglet de navigateur séparé 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 sélectionnez Nouveau.
4. Remplissez les champs du formulaire.

   Tableau 1. Champs des fonctions

   Champ	Description
   Propriétés
   Nom	Le nom de la fonction. Choisissez un nom facile à identifier.
   Description	Informations supplémentaires sur la fonction.
   Type	Type de fonction. Sélectionnez Élément d'action.
   Contexte	Le niveau auquel appliquer l'action. Enregistrement : l'action s'applique 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 les actions de balayage. Si la fonction d'action comprend 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 au niveau 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 situées 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 les emplacements des boutons, voir 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 n’est prise en charge que 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 charger des images. Les images sont stockées dans la table Pièces jointes [sys_attachment].
   Champ Afficher signature	Nécessite une signature de l’utilisateur avant de soumettre l’action. Les utilisateurs peuvent signer avec leur doigt 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 vers la table Images de signature [signature_image] lorsque l'action s'exécute. Lorsque cette option est sélectionnée, le formulaire de signature s'affiche sur une page distincte. 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 sur l’écran de détails actuel. Exactement un 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 exiger la confirmation de l’utilisateur avant de soumettre l’action. Aucun : ne nécessite pas de confirmation de l’utilisateur. Cette option est utilisée par défaut. Signature de tâche RH : nécessite une signature de l'utilisateur avant de soumettre l'action. Les utilisateurs peuvent signer avec leurs doigts ou taper leurs noms dans le champ de signature. Si Autoriser le téléchargement des images est sélectionné, une image de la signature est envoyée vers 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 : exige que les utilisateurs saisissent 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 saisissent une nouvelle fois 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	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 devant être remplies pour utiliser l’action. Par exemple, vous pouvez empêcher les utilisateurs de résoudre un incident comportant un état fermé, résolu ou annulé.
   Messages
   Afficher le message de confirmation	Affiche un message de confirmation pour vérifier si un utilisateur veut continuer l'action.
   Message de confirmation	Message de confirmation à afficher. Remarque : S'affiche uniquement si Afficher le message de confirmation est sélectionné.
   Étiquette Confirmation	Étiquette du bouton de confirmation de l’action. Remarque : S'affiche uniquement si Afficher le message de confirmation est sélectionné.
   Étiquette Annuler	Étiquette du bouton d’annulation de l’action. Remarque : S'affiche uniquement si Afficher le message de confirmation est sélectionné.
   Message de réussite	Texte pour un message de confirmation de réussite. Utilisez des accolades pour créer un message de réussite dynamique. Par exemple, {{numéro}} a été mis à jour avec succès.
   Message d’échec	Texte pour un message de confirmation d’échec. Utilisez des accolades pour créer un message d’échec dynamique. Par exemple, {{numéro}} n’a pas pu être mis à jour.
   Messages de confirmation
   Afficher le texte d’authentification	Nécessite une authentification de l’utilisateur avant de soumettre l’action. Si ce champ est activé, le champ Contexte doit être Enregistrement.
   Champ Authentification	Champ qui inclut le texte d’authentification que vous souhaitez afficher à l’utilisateur. Sélectionnez la table pour le champ dans la zone de données . Seuls les champs de type chaîne sont pris en charge. Remarque : S'affiche uniquement si Affiche le texte d'authentification est sélectionné.
   Étiquette Confirmation	Étiquette pour le bouton de confirmation qui apparaît en dessous du texte d’authentification. La valeur par défaut est Je suis d’accord. Remarque : S'affiche uniquement si Affiche le texte d'authentification est sélectionné.
   Fin de l'action
   Actualiser tout l'écran après l'action	Option pour que l'écran actuel s'actualise automatiquement lorsqu'une action se termine. Cette option est disponible uniquement lorsque le paramètre 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 le message Nouvelle mise à jour après que l'utilisateur a effectué 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 l'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 elle est sélectionnée, la redirection vers l'écran de destination se produit automatiquement sans interaction de l'utilisateur. Si elle n'est pas sélectionnée, la redirection se produit uniquement avec l'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 le paramètre Accéder à l'écran après une action terminée correctement est sélectionné.
   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 le paramètre Accéder à l'écran après une action terminée correctement est sélectionné.
   Passer à l'écran de destination	Spécifie l’écran vers lequel l’utilisateur est redirigé après l’achèvement de l’action. Cet écran affiche les enregistrements nouvellement créés, s'ils sont disponibles. Remarque : Cette option n'est disponible que lorsque le paramètre Accéder à l'écran après une action terminée correctement est sélectionné.
   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 : lorsque la valeur est définie 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ère sont automatiquement ignorés. used_for_deeplink : l’attribut button lorsqu’il est défini sur true détermine que le bouton est utilisé pour le lien profond. Pour plus d'informations, consultez Liens profonds pour mobile. trigger_offline_cache_download : lorsque la valeur est définie 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, tout 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 d’URL n’est pas vérifié par rapport à l’ACL pour vérifier la rétrocompatibilité.
   Accès du rôle	Limiter l’accès des utilisateurs à une action par rôle.

   Remarque :

   Bien que toutes les options dans la zone Action d’achèvement du formulaire puissent être définies, leurs actions peuvent se chevaucher. Assurez-vous de tester les paramètres afin d'obtenir 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 d'action à un emplacement, voir Associer une fonction à un emplacement dans l’application.