Formulaires en temps réel

La fonctionnalité Formulaires en temps réel (Real Time Forms) vous permet de modifier les valeurs du formulaire que vous utilisez sans fermer le formulaire. Cela signifie que les variables liées aux champs de formulaire que vous utilisez peuvent être facilement modifiées sans avoir besoin de fermer le workflow, puis de le réexécuter.

Pour tirer parti de cette fonctionnalité, faites glisser et déposez les activités souhaitées dans le bloc Faire de l'activité Créer un formulaire . Configurez les champs et les boutons du formulaire à lier aux activités du bloc Faire .

Utiliser des formulaires en temps réel

Les activités du bloc Do s'exécutent sur les champs du formulaire, à la fois en lecture et en écriture de données. Ces activités sont déclenchées à chaque clic sur un bouton ou, éventuellement, lorsque le formulaire est ouvert. Pendant l'exécution des activités, le formulaire reste ouvert et modifiable pour l'utilisateur final.

Déclenchement du bloc Do

Pour déclencher les activités dans le bloc Faire du formulaire, utilisez les boutons.

Par défaut, un bouton déclenche la boucle Do (Do), puis ferme le formulaire.

Pour déclencher la boucle Do et garder le formulaire ouvert avec des valeurs actualisées, ajoutez une propriété personnalisée à l'onglet Clé de champ sur le bouton souhaité avec la paire clé-valeur closeOnSubmit-false.

Pour voir quel bouton a été utilisé dans un formulaire, analysez la propriété BoutonSélectionné de l'objet de sortie.

Mise à jour des valeurs de formulaire

Les valeurs du formulaire peuvent être mises à jour en modifiant les variables correspondantes dans le bloc Faire .

Tutoriel

Créons un formulaire simple contenant deux composants : Nom d'utilisateur et Ville:

1. Faites glisser et déposez l’activité Créer un formulaire ( Create Form) dans votre workflow de séquence.

2. Ouvrez le panneau Variables et créez deux variables globales, une pour chaque composant.

   
   

   

   
   

3. Dans la propriété FormFieldsCollection de l'activité Create Form , ajoutez un argument In/Out de type String pour chaque composant et référencez-les aux variables globales précédemment créées. De cette façon, les composants sont générés automatiquement dans le formulaire.

   
   

   

   
   
   Pour utiliser la fonctionnalité Formulaires en temps réel (Real Time Forms), créez des boutons dans le formulaire qui ne ferment pas le formulaire après un clic (par exemple, un bouton Mettre à jour) :
4. Ouvrez le Concepteur de formulaires.
5. Faites glisser et déposez un composant Button .
6. Accédez à l'onglet Clé de champ (Field Key) du composant de bouton. Sous Propriétés personnalisées ( Custom Properties), ajoutez closeOnSubmit comme clé et définissez la valeur sur false.

   Faites attention au nom que vous avez défini pour la clé de champ. Ce nom est utilisé pour lier le composant dans le formulaire et il est sensible à la casse.

   Une fois ce bouton créé, vous pouvez utiliser des activités telles que Si pour modifier les valeurs en temps réel dans le formulaire ou la base de données derrière le formulaire.
7. Pour suivre le bouton sur lequel l'utilisateur professionnel a cliqué, créez une variable pour la stocker : dans le panneau Propriétés de l'activité Créer un formulaire ( Create Form ) > Catégorie de sortie ( Output category) > Champ Bouton Sélectionné ( SelectedButton ), cliquez sur pour créer une variable pour le bouton. Vous pouvez également utiliser le raccourci clavier CTRL + K pour créer la variable. La variable est également ajoutée au panneau Variables du workflow de séquence.
8. Nommez votre variable de bouton (par exemple, btn).
   
   

   

   
   
   Pour utiliser des boutons spécifiques à un formulaire dans l'activité Si , référencez-les à l'aide de l'expression btn = " ... " . Assurez-vous d'utiliser la syntaxe correcte en fonction du langage de programmation que vous avez choisi (C# ou VB.NET).

   Dans cet exemple, pour surveiller le bouton Mettre à jour (Update) dans le formulaire.

9. Faites glisser et déposez l’activité If dans le bloc Do de l’activité Create Form .
10. Dans le champ Condition (Condition), saisissez l'expression : btn = "{button_field_key_name}" si vous utilisez VB.NET et btn == "{button_field_key_name}" si vous utilisez C#. Remplacez la valeur {button_field_key_name} par celle que vous avez définie à l'étape 6.

    Par la suite, vous pouvez créer des règles pour cette condition.

    Par exemple, une fois que vous avez cliqué sur le bouton Mettre à jour (Update), vous souhaitez afficher Database Updated dans le champ Nom d'utilisateur :
    • Dans la section Activité If (If) > Alors ( Then ), faites glisser et déposez l’activité Assign (Assign).
    • Dans le champ À (To) de l'activité Assign (Assign), saisissez la variable globale utilisée pour référencer le champ Username du formulaire.
    • Dans le champ Valeur , entrez "Database Updated".
      
      

      

      
      

    L'exécution du formulaire vous permet désormais d'apporter des modifications en temps réel, sans avoir à fermer et rouvrir le formulaire.

Exemple de workflow

Pour vérifier le workflow dans son intégralité ou pour vous y référer ultérieurement, téléchargez l' exemplearchivé