Créer une fenêtre contextuelle mobile

Découvrez comment afficher des fenêtres contextuelles mobiles configurables en fonction des conditions en temps réel. Vous pouvez afficher ces fenêtres contextuelles lors de la phase de connexion à l’application mobile ou après avoir appuyé sur un bouton.

Avant de commencer

Rôle requis : admin

Avant de configurer vos fenêtres contextuelles mobiles, tenez compte des points suivants :

• Les cartes mobiles sont utilisées dans l’affichage des pop-ups. Vous pouvez concevoir l’une de vos propres cartes mobiles ou utiliser l’une des cartes de modèle fournies. Pour plus d'informations, consultez Créateur de carte mobile.
• Les types de boutons pris en charge qui déclenchent des fenêtres contextuelles sont l’élément d’action et la navigation. Pour plus d'informations, consultez Fonctions d'action.
• Tous les emplacements de boutons sont pris en charge. Par exemple, balayage, action du menu supérieur et fonction de pied de page.
• Les boutons sont pris en charge dans les sections de l’interface utilisateur suivantes, enregistrement, icône, média et contenu. Pour plus d'informations, consultez Sections de l'interface utilisateur de l'écran du lanceur.
• Les fenêtres contextuelles mobiles ne sont pas prises en charge hors connexion.

Procédure

1. Accédez à la Tout > 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 du périmètre de l'application.
   L'écran d'accueil des catégories Générateur d'apps mobiles s'affiche.
3. Sélectionnez Tous les enregistrements Mobile dans le menu.
4. Dans la liste déroulante Type d’enregistrement , sélectionnez Événement mobile [sys_sg_event], puis sélectionnez Nouveau.
5. Renseignez les champs suivants selon vos besoins :

   Tableau 1. Formulaire d’événement mobile

   Champ	Description
   Propriétés
   Nom	Nom de votre événement mobile, qui active la fenêtre contextuelle mobile.
   Description	Informations supplémentaires sur l’événement mobile.
   Actif	Indique si l’événement mobile est activé.
   Type	Type d’événement qui déclenche la fenêtre contextuelle.
   Table source	Table source de cet événement mobile.
   Enregistrement source	Déterminez la configuration de l’application mobile ou la fonction mobile comme enregistrement sur lequel cet événement se produit. Les options dépendent de la sélection effectuée dans le champ Table source .
   Action d'événement	Action qui se produit lorsque l’événement mobile est déclenché. Remarque : Il ne peut y avoir qu’une seule action par événement.

6. Sélectionnez dans le champ Type si l’événement déclenché se produit lorsque l’utilisateur se connecte ou lorsqu’un bouton est sélectionné.
   Sélectionnez un des éléments :

   • OnLogin : la fenêtre contextuelle mobile s’affiche une fois qu’un utilisateur a saisi ses informations d’identification et s’est connecté.
   • OnButtonClick : La fenêtre contextuelle mobile s’affiche lorsque l’utilisateur sélectionne une fonction de bouton spécifiée.
7. Sélectionnez dans le champ Table source la table associée au type d’événement mobile que vous avez sélectionné.
   Remarque :

   Si vous sélectionnez OnLogin comme type, la table source est Configuration de l’application mobile [sys_sg_native_client].

   Si vous sélectionnez OnButtonClick comme type, la table source est Fonction [sys_sg_button].

8. Sélectionnez Nouveau dans la zone Action d’événement pour définir ce qui se passe lorsqu’un événement est déclenché.
9. Renseignez les champs suivants, selon les besoins, pour créer des conditions dans le formulaire d’action d’événement, pour afficher ou non une fenêtre contextuelle mobile.

   Tableau 2. Formulaire Action d’événement mobile

   Champ	Description
   Propriétés
   Nom	Nom de votre action d’événement mobile.
   Paramètres
   Type	Type d’action d’événement. Sélectionnez ShowPopup.
   Type de condition	Conditions appliquées à cette action d’événement mobile. Déclaratif : ajoute un créateur de condition au formulaire. Pour plus d’informations, consultez générateur de conditions. Script : ajoute un champ de condition de script au formulaire.
   Script de condition de requête	Utilisez des scripts pour déterminer les enregistrements à renvoyer. Remarque : Ce champ s’affiche uniquement lorsque vous choisissez Script dans le champ Type de condition
   Table	La table qui contient les enregistrements à renvoyer. Remarque : Ce champ s’affiche uniquement lorsque vous choisissez Déclaratif dans le champ Type de condition .
   Condition	Définissez des conditions pour déterminer quels enregistrements sont renvoyés à partir de la table sélectionnée. Si une condition n’est pas définie, la requête renvoie tous les enregistrements. Remarque : Ce champ s’affiche uniquement lorsque vous choisissez Déclaratif dans le champ Type de condition .
   Fenêtres contextuelles	Sélectionnez la fenêtre contextuelle mobile à utiliser et la façon dont elle s’affiche.

10. Sélectionnez ShowPopup dans le champ Type .
11. Sélectionnez Déclaratif ou Scripté dans le champ Type de condition .
    Différents champs s’affichent lorsque vous sélectionnez les conditions déclaratives ou scriptées qui s’appliquent à cet événement mobile.
12. Sélectionnez Nouveau dans le champ Fenêtres contextuelles pour déterminer à quoi ressemble la fenêtre contextuelle mobile.
13. Renseignez les champs suivants si nécessaire.

    Tableau 3. Formulaire contextuel mobile

    Champ	Description
    Propriétés
    Nom	Nom de la fenêtre contextuelle mobile.
    Appuyez à l'extérieur pour fermer	Option pour appuyer sur l’écran de votre mobile en dehors de la zone contextuelle, pour fermer la fenêtre contextuelle mobile. Remarque : Si cette option n’est pas sélectionnée, votre carte contextuelle doit contenir un bouton pour fermer la fenêtre contextuelle. Sinon, ce paramètre est ignoré.
    Flouter l'arrière-plan	Option permettant de flouter l’arrière-plan de l’écran de votre mobile. Cette option met davantage l’accent sur la fenêtre contextuelle.
    Actif	Indique si l’événement mobile est activé.
    Carte	Carte à utiliser pour la fenêtre contextuelle.

14. Sélectionnez Choisir d’utiliser une carte existante ou sélectionnez Nouveau pour en créer une dans le champ Carte .
    Pour plus d’informations sur la création de cartes, reportez-vous à la section Créateur de carte mobile.

    Remarque :

    Deux modèles de cartes contextuelles mobiles sont fournis avec le système de base. Ces modèles sont appelés Pop-up 01 et Pop-up 02.
15. Facultatif : Affectez des fonctions configurables ou des fonctions prédéfinies à un bouton sur une carte contextuelle mobile.
    Remarque :

    Pour plus d’informations sur les fonctions configurables, reportez-vous aux sections Fonctions Mobile et Configurer une action de carte à l'aide de Créateur de carte mobile. Consultez également la section Prochaines étapes de cette rubrique.
16. Sélectionnez Enregistrer.

Que faire ensuite

Vous pouvez ajouter deux types de fonctions à un bouton sur une carte contextuelle mobile, des fonctions configurables et des fonctions prédéfinies. Les fonctions configurables permettent aux développeurs de personnaliser le comportement et les fonctionnalités des fonctions. Les fonctions prédéfinies ont des fonctionnalités dédiées, spécialement conçues pour les pop-ups mobiles. Les fonctions prédéfinies suivantes sont disponibles :

• Annuler : supprime la fenêtre contextuelle sans effectuer d’action supplémentaire.
• Continuer : soumet ou poursuit la fonction d’origine à partir de laquelle la fenêtre contextuelle a été déclenchée.
• Déconnexion : déconnecte l’utilisateur de l’instance actuelle et est dirigé vers la page de liste des instances.

Pour plus d'informations, consultez Fonctions Mobile et Configurer une action de carte à l'aide de Créateur de carte mobile.

• Affecter des fonctions prédéfinies à des fenêtres contextuelles mobiles
  Utilisez des fonctions prédéfinies dans les fenêtres contextuelles mobiles pour effectuer des actions telles que fermer la fenêtre contextuelle, suivre les instructions suggérées ou vous déconnecter de l’instance.