Formulaires en temps réel

Ce tutoriel montre comment modifier les valeurs dans un formulaire pendant l'affichage du formulaire. Cela peut être réalisé à l'aide de la fonctionnalité Continue workflow execution (Continuer l'exécution du workflow) dans les activités Show Form activity (Afficher le formulaire) et Form trigger activityet des activités Get Form Values (Obtenir les valeurs du formulaire) et Set Form Values (Définir les valeurs du formulaire).

Ce tutoriel spécifique montre comment afficher ou remplir automatiquement du contenu dans un formulaire, en fonction des valeurs d'autres composants du formulaire.

1. Créez le workflow principal . Ajoutez Afficher le formulaire ( Show Form) et une activité Exécuter les déclencheurs locaux (Run Local Triggers ).
2. Créez un fichier formulaire qui demande aux utilisateurs leur consentement à participer à une étude. Nommez-la comme Consentement à la participation à l’ étude (Study participation consent).
   1. Ajoutez un composant Radio , demandant à l'utilisateur s'il souhaite participer à l'étude.
      Mémorisez le nom de la propriété pour récupérer la réponse de l’utilisateur, puis mettre à jour les données du formulaire.
   2. Ajoutez un composant Radio , en demandant à l'utilisateur s'il a 18 ans ou plus.
      Mémorisez le nom de la propriété pour récupérer la réponse de l’utilisateur, puis mettre à jour les données du formulaire.
   3. Ajoutez deux composants Libellé/En-tête . L'un d'eux doit afficher un message lorsque l'utilisateur souhaite participer et qu'il a plus de 18 ans. L'autre composant doit afficher un message lorsque l'utilisateur souhaite participer, mais n'a pas plus de 18 ans.
   4. Ajoutez un composant Champ de texte (Text Field ) pour demander le nom complet de l'utilisateur.
   5. Ajoutez un composant Nombre (Number) pour demander l'âge de l'utilisateur.
   6. Ajoutez un composant Champ de texte (Text Field ) pour demander la ville où réside l'utilisateur.
   7. Ajoutez un composant Champ de texte (Text Field ) pour remplir automatiquement le quartier dans lequel habite l'utilisateur, en fonction de la ville fournie.
3. Créez un workflow de déclencheur pour le scénario dans lequel un utilisateur ne souhaite pas participer à l'étude (si l'utilisateur ne souhaite pas participer.xaml).
   1. Ajoutez une activité de déclencheur de formulaire pour le formulaire de consentement de participation à l’étude . En tant qu'événement, choisissez quand le premier composant Radio change.
   2. Ajoutez une activité Obtenir les valeurs du formulaire (Get Form Values) . Sélectionnez le formulaire de consentement de participation à l'étude . Dans la collection Arguments , ajoutez une entrée pour le premier composant Radio .
      Pour cet exemple, ajoutez l'entrée suivante :

      Clé (Key)	Saisie de texte	Valeur (Value)
      wantToParticipate (le nom de la propriété du premier composant Radio )	String	desireToParticipate (variable globale)

      Cette activité vous permet de savoir si l’utilisateur souhaite participer ou non à l’étude.
   3. Ajoutez une activité Si (If) et définissez la condition s'il est vrai que l'utilisateur ne veut pas participer à l'étude.
      Pour cet exemple, utilisez la condition suivante : desireToParticipate = "no"
   4. Dans le bloc Puis (Then), ajoutez une activité Close Form et une activité Stop Local Triggers .
      Cela ferme le formulaire, puis l'automatisation si l'utilisateur ne souhaite pas participer à l'étude.
4. Créez un workflow de déclencheur pour vérifier si l'utilisateur qui souhaite participer à l'étude a 18 ans ou plus (cochez si user of légal age.xaml).
   1. Ajoutez une activité de déclencheur de formulaire pour le formulaire de consentement de participation à l’étude . En tant qu'événement, choisissez quand le deuxième composant Radio change.
   2. Ajoutez une activité Obtenir les valeurs du formulaire (Get Form Values) . Sélectionnez le formulaire de consentement de participation à l'étude . Dans la collection Arguments , ajoutez une entrée pour le deuxième composant Radio .
      Pour cet exemple, ajoutez l'entrée suivante :

      Clé (Key)	Saisie de texte	Valeur (Value)
      areYou18OrAbove (le nom de la propriété du deuxième composant Radio )	areYou18OrAbove	ofAge

   3. Ajoutez une activité Si (If) et définissez la condition s'il est vrai que l'utilisateur a 18 ans ou plus.
      Pour cet exemple, utilisez la condition suivante : ofAge = "yes" And desireToParticipate = "yes"
   4. Dans le bloc Puis (Then), ajoutez une activité Définir les valeurs de formulaire ( Set Form Values) , dans laquelle vous transmettez un message personnalisé à l'attention de l'utilisateur, à l'intérieur d'un composant Libellé/En-tête.
      Pour cet exemple, ajoutez l'entrée suivante :

      Clé (Key)	Saisie de texte	Valeur (Value)
      over18 (le nom de la propriété d'un composant Libellé /En-tête )	String	« Super ! Veuillez remplir le reste du formulaire pour vous inscrire à l’étude. »

   5. Comme pour les étapes précédentes, ajoutez une autre activité Si (If) pour le scénario lorsque l’utilisateur n’a pas 18 ans ou plus et ne peut plus remplir le formulaire.
      Pour cet exemple, utilisez la condition suivante : ofAge = "no" And desireToParticipate = "yes".
   6. Dans le bloc Puis (Then), ajoutez une activité Définir les valeurs du formulaire ( Set Form Values) où vous affichez le message personnalisé, puis fermez le formulaire et arrêtez l'automatisation.
5. Créez un workflow de déclencheur pour remplir automatiquement le quartier dans lequel réside l'utilisateur en fonction de la ville saisie (remplissage automatique ville district.xaml).
   1. Ajoutez une activité de déclencheur de formulaire pour le formulaire de consentement de participation à l’étude . En tant qu'événement, choisissez quand le composant Ville (City ) change.
   2. Ajoutez une activité Obtenir les valeurs de formulaire ( Get Form Values) pour obtenir la ville où réside l'utilisateur, à l'aide de l'entrée d'argument suivante :

      Clé (Key)	Saisie de texte	Valeur (Value)
      city (le nom de la propriété du composant Ville )	String	userCity

Découvrez le résultat de ce tutoriel dans la vidéo ci-dessous :

Exemple de workflow

Pour suivre les étapes et essayer vous-même le tutoriel, consultez l'exemple de projet ici.