Règle : Soumettre une action

Propriétés et options de configuration de la règle Soumettre une action, qui enregistre et soumet les entrées utilisateur d'un formulaire à une action définie dans Action Center.

Utilisez la règle Soumettre une action pour enregistrer et soumettre les modifications apportées par un utilisateur lorsqu'il remplit un formulaire ou qu'une certaine interaction de l'IU.

Important :

Cette règle ne devient disponible pour la sélection qu'après avoir ajouté une définition d'action à votre application.

Schéma des actions

Cette section affiche le nom de la définition d'action utilisée dans votre application.

Remarque :

Comme une seule définition d'action par application est autorisée, ce champ est automatiquement renseigné.

Remplacement d’entrée

Dans cette section, vous pouvez définir des valeurs pour les arguments d'entrée de l'action.

En cliquant sur le champ Remplacement d’entrée, vous ouvrez le panneau Ressources , qui affiche les paramètres d'entrée ou de sortie disponibles de l'action sélectionnée.

Sélectionnez les paramètres et définissez-les sur les valeurs de vos commandes d'entrée d'application.

Les propriétés d'action, qu'il s'agisse de paramètres d'entrée ou d'entrée/de sortie, sont accessibles à l'aide de la syntaxe suivante :

ActionProperties.<action_property_name>

L'expression de valeur d'une commande d'application a la syntaxe suivante :

<Apps_MainPage_name>.<input_control_name>.value

Par exemple : vous avez le paramètre d'entrée « nom » dans votre action « voter par application ». Vous avez une commande de texte dans votre application appelée « text1 ». Pour lier le paramètre d'entrée à la valeur de contrôle dans Apps :

1. Sélectionnez le paramètre d’entrée « name » dans le panneau Ressources . Il doit remplir le champ avec l’expression suivante :

   ActionProperties.Voting_app.name
   

2. Dans le champ Saisir une valeur , définissez la valeur suivante sur le paramètre « nom » :

   MainPage.text1.Value
   

Remarque :

Vous pouvez ajouter de nombreux remplacements d'entrée comme nombre de paramètres d'entrée de votre action.

Important :

Vous devez appliquer le remplacement d'entrée pour tous les paramètres d'action que vous souhaitez enregistrer temporairement ou envoyer lors de la soumission de l'action.

Résultat des actions

Dans cette section, vous pouvez configurer le résultat de la réalisation de l’action.

Les options de résultat sont définies dans le schéma de définition de votre action.

En cas d’erreur

Dans cette section, vous pouvez définir les règles à exécuter lorsque la soumission de l’action rencontre une erreur.

Par exemple : pour suivre l'échec, vous pouvez ajouter une règle Afficher le message (Show Message). Vous pouvez ensuite indiquer le titre, le message et le type d'erreur.

Propriétés de sortie de la règle

• Erreur : fait référence au message d'erreur affiché si la tâche échoue.

Résolution des problèmes

Users can submit the form without filling in required fields

Marking a field as required does not block the Submit Action rule. This applies to the Required property of an input control and to required properties in the action definition. The button stays available until you configure its Disabled property.

The following example uses a form with Name and Comment textboxes on MainPage. The button that runs the Submit Action rule stays disabled until users fill in both textboxes.

1. Set the Required property of the Name and Comment textboxes to True.
2. Add both textboxes to a Container control, for example Container1.
3. Select the button that runs the Submit Action rule.
4. In the Disabled property, enter the following expression:

   Not MainPage.Container1.IsValid
   

The container is valid only when every control inside it is valid, so the button becomes available once users fill in both textboxes.

To check individual controls instead of a container, combine them with OrElse. OrElse stops at the first invalid control and skips the rest:

(Not MainPage.Name.IsValid) OrElse (Not MainPage.Comment.IsValid)

The submit button stays disabled after users fill in the form

The expression in the Disabled property of the button still evaluates to true. Check the following causes:

Origine	Résolution
The expression is missing Not. The button is disabled while Disabled is true, so MainPage.Container1.IsValid disables the button once the form becomes valid.	Add Not before the check, for example Not MainPage.Container1.IsValid.
The expression references the wrong container or control.	Check that each name in the expression matches the container or the controls users fill in.
A control inside the container, or a control in the expression, is still invalid. One invalid control keeps the expression true.	Check that every control has a value that passes its validation.