ルール: アクションを送信

[アクションを送信] ルールのプロパティと設定オプション。フォームのユーザー入力を保存して、Action Center で定義されたアクションに送信します。

[アクションを送信] ルールを使用すると、フォームや特定の UI 操作の完了にあたってユーザーが加えた変更を保存して送信できます。

重要:

このルールは、アクションの定義をアプリに追加した後にのみ選択できるようになります。

アクション スキーマ

このセクションには、アプリで使用されているアクションの定義の名前が表示されます。

注:

アプリごとに許可されるアクションの定義は 1 つのみであるため、このフィールドは自動的に入力されます。

入力の上書き

このセクションでは、アクションの入力引数の値を設定できます。

[入力の上書き] フィールドをクリックすると [リソース] パネルが開き、選択したアクションで利用可能な入力または入力/出力パラメーターが表示されます。

パラメーターを選択し、アプリの入力コントロールの値に設定します。

アクションのプロパティには、プロパティが入力パラメーターか入出力パラメーターかにかかわらず、次の構文を使用してアクセスできます。

ActionProperties.<action_property_name>

アプリ コントロールの値の式には、次の構文が含まれます。

<Apps_MainPage_name>.<input_control_name>.value

例:「Voting App」アクションに「name」という入力パラメーターがあります。アプリ内に「text1」というテキスト コントロールがあります。入力パラメーターを Apps のコントロール値にバインドするには、以下の手順に従います。

1. [ リソース ] パネルから入力パラメーター「name」を選択します。フィールドに次の式を入力する必要があります。

   ActionProperties.Voting_app.name
   

2. [値を入力] フィールドで、次の値を「name」パラメーターに設定します。

   MainPage.text1.Value
   

注:

[入力の上書き] は、アクションの入力パラメーターの数と同じだけ追加できます。

重要:

一時的に保存が必要か、またはアクションの送信時に送信が必要なすべてのアクション パラメーターに対して、入力の上書きを適用する必要があります。

アクションの結果

このセクションでは、アクションを完了するための結果を設定できます。

結果のオプションは、アクションの定義スキーマで定義されます。

エラー発生時

このセクションでは、アクションの送信中にエラーを検出したときに実行するルールを定義できます。

例: 失敗を追跡するために、[メッセージを表示] ルールを追加できます。その際、エラーのタイトル、メッセージ、種類を指定できます。

ルールの出力プロパティ

• エラー - ジョブが失敗した場合に表示されるエラー メッセージを参照します。

トラブルシューティング

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:

原因	解決方法
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.