Regel: Einreichungsaktion

Eigenschaften und Konfigurationsoptionen für die Regel Aktion einreichen, die Benutzereingaben aus einem Formular an eine definierte Aktion im Action Center speichert und übermittelt.

Verwenden Sie die Regel Aktion einreichen , um die Änderungen zu speichern und zu übermitteln, die ein Benutzer beim Ausfüllen eines Formulars oder einer bestimmten UI-Interaktion vorgenommen hat.

Wichtig:

Diese Regel wird erst zur Auswahl verfügbar, nachdem Sie Ihrer App eine Aktionsdefinition hinzugefügt haben.

Aktionsschema

In diesem Abschnitt wird der Name der Aktionsdefinition angezeigt, die in Ihrer App verwendet wird.

Hinweis:

Da nur eine Aktionsdefinition pro App zulässig ist, wird dieses Feld automatisch ausgefüllt.

Eingabe überschreiben

In diesem Abschnitt können Sie Werte für die Eingabeargumente der Aktion festlegen.

Wenn Sie auf das Feld Eingabe überschreiben klicken, wird der Bereich Ressourcen geöffnet, in dem die verfügbaren Eingabe- oder Eingabe-/Ausgabeparameter der ausgewählten Aktion angezeigt werden.

Wählen Sie die Parameter aus und legen Sie sie auf die Werte Ihrer App-Eingabesteuerelemente fest.

Auf Aktionseigenschaften, unabhängig davon, ob es sich um Eingabe- oder Eingabe-/Ausgabeparameter handelt, kann mit der folgenden Syntax zugegriffen werden:

ActionProperties.<action_property_name>

Der Wertausdruck eines App-Steuerelements hat die folgende Syntax:

<Apps_MainPage_name>.<input_control_name>.value

Beispiel: Sie haben den Eingabeparameter „name“ in Ihrer Aktion „Voting App“. Sie haben ein Textsteuerelement in Ihrer App namens „text1“. So binden Sie den Eingabeparameter an den Steuerelementwert in Apps:

1. Wählen Sie im Ressourcenbereich den Eingabeparameter "name" aus. Das Feld sollte mit dem folgenden Ausdruck ausgefüllt werden:

   ActionProperties.Voting_app.name
   

2. Legen Sie im Feld Wert eingeben den folgenden Wert für den Parameter „name“ fest:

   MainPage.text1.Value
   

Hinweis:

Sie können viele Eingabeüberschreibungen als Anzahl Ihrer Aktionseingabeparameter hinzufügen.

Wichtig:

Sie sollten die Eingabeüberschreibung für alle Aktionsparameter anwenden, die Sie vorübergehend speichern oder beim Übermitteln der Aktion senden möchten.

Ergebnis der Aktion

In diesem Abschnitt können Sie das Ergebnis für den Abschluss der Aktion konfigurieren.

Die Ergebnisoptionen werden im Definitionsschema Ihrer Aktion definiert.

Bei Fehler

In diesem Abschnitt können Sie Regeln definieren, die ausgeführt werden sollen, wenn beim Übermitteln der Aktion ein Fehler auftritt.

Beispiel: Um den Fehler nachzuverfolgen, können Sie eine Regel Nachricht anzeigen hinzufügen. Sie können dann den Titel, die Nachricht und den Typ des Fehlers angeben.

Eigenschaften der Regelausgabe

• Fehler – Verweist auf die Fehlermeldung, die angezeigt wird, wenn der Auftrag fehlschlägt.

Fehlersuche und ‑behebung

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:

Ursache	Resolution
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.