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 profiter de cette fonctionnalité, glissez et déposez les activités souhaitées à l’intérieur du bloc Faire de l’activité Créer un formulaire . Configurez les champs et les boutons du formulaire pour qu'ils soient liés aux activités dans le bloc Faire .

Utiliser des formulaires en temps réel

Activities in the Do block execute against the fields of the form, both reading and writing data. These activities are triggered any time a button is clicked or, optionally, when the form is opened. While activities are being executed, the form remains open and editable for the end-user.

Déclenchement du bloc Do

To trigger the activities in the Do block of the form, use buttons.

By default, a button triggers the Do loop and then closes the form.

To trigger the Do loop and keep the form open with refreshed values, add a custom property to the Field Key tab on the desired button with the key-value pair closeOnSubmit-false.

To see which button was used on a form, parse the SelectedButton property of the output object.

Mise à jour des valeurs de formulaire

Values on the form can be updated by changing the corresponding variables within the Do block.

Tutoriel

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

1. Drag and drop the Create Form activity in your sequence workflow.

2. Open the Variables panel and create two global variables, one for each component.

   

3. In the FormFieldsCollection property of the Create Form activity, add an In/Out argument of type String for each component, and reference them to the previously created global variables. In this way, the components are autogenerated in the form.

   

   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. Drag and drop a Button component.

6. Accédez à l'onglet Clé de champ du composant de bouton. Sous Propriétés personnalisées, ajoutez closeOnSubmit en tant que 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 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 que l'utilisateur professionnel clique, créez une variable pour la stocker : Dans le panneau Propriétés de l'activité Créer un formulaire > Catégorie de sortie > champ BoutonSélectionné , cliquez sur Créer une variable pour le bouton. Comme alternative, utilisez 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 en utilisant l’expression btn = " ... " . Veillez à 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 du formulaire.

9. Drag and drop the If activity in the Do block of the Create Form activity.

10. Dans le champ 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 le bouton Mettre à jour est cliqué, vous souhaitez afficher Database Updated dans le champ Nom d'utilisateur :

    • In the If activity > Then section, drag and drop the Assign activity.
    • In the To field of the Assign activity, enter the global variable used to reference the Username field of the form.
    • In the Value field, enter "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 complet ou pour avoir une référence future, téléchargez l’ exemplearchivé