Indicateur de progrès
Le tutoriel de l’indicateur de progrès vous montre comment créer un indicateur de progrès sur des appareils client qui indiquera à quel point un ensemble d’actions sur le serveur a progressé. Le tutoriel expliquera comment les différents composants de la fonction Indicateur de progrès devrait être utilisés ensemble. De manière générale, l’indicateur de progrès est affiché dans une sous-page de progrès qui apparaît lorsque les actions de serveur sont lancées pour être exécutées. La sous-page de progrès se ferme automatiquement quand l’exécution des actions de serveur est terminée - ou quand l’utilisateur client annule l’exécution.
Les composants de la fonction Indicateur de progrès sont comme suit :
•L’action « Progress Show Subpage » qui (i) spécifie la sous-page qui sera affichée sur le client pour indiquer le progrès des actions de serveur ; et (ii) définit, en tant que ses actions enfant, les actions de serveur à exécuter pour lequels l’’indicateur de progrès est requis.
•Une action Mise à jour Progrès, qui spécifie quelle valeur à passer à la variable $MT_Progress dynamiquement réactive.
•La variable $MT_Progress dynamique, qui, à travers sa valeur changeante, est utilisée pour indiquer le progrès des actions de serveur.
•Un événement de page appelé OnProgressUpdate, qui est déclenché par l’action Mise à jour Progrès et peut être utilisé pour mettre à jour la sous-page du progrès avec des informations sur le progrès action-serveur (par le biais de la variable $MT_Progress).
•Une action Annulation de l’envoi du progrès, qui, lorsqu’elle est déclenchée, définit de la valeur de la fonction mt-progress-cancellation() à true().
•La fonction mt-progress-cancellation(), qui peut être utilisée pour tester si le client a envoyé une requête d’annulation ou non.
Le fichier de tutoriel
Le fichier design que vous recevrez après avoir complété ce tutoriel devrait avoir l’air du fichier suivant situé dans votre dossier (Mes) Documents MobileTogether : MobileTogetherDesignerExamples\Tutorials\ProgressIndicator.
ProgressIndicator.mtd: Il s'agit du fichier de design MobileTogether achevé. Pour voir ce qu’il fait, exécutez une simulation dans MobileTogether Designer en appuyant sur F5.
Vous pouvez commencer de zéro et créer le fichier en suivant les étapes de ce tutoriel. En alternative, vous pouvez ouvrir le fichier design achevé et vous y référerez lors de la lecture de ce tutoriel.
Structure du tutoriel
Ce tutoriel est organisé dans les sections suivantes :
•La Page principale décrit les paramètres de la page principale. De manière essentielle, ceux-ci sont : (i) les définitions des actions du serveur pour lesquelles une indication de progrès est requise, et (ii) l’appel à la sous-page qui affichera le rapport de progrès.
•La Sous-page Progrès affiche comment définir les composants qui sont requis pour afficher l’indicateur de progrès sur une sous-page Progrès.