リアルタイム フォーム

このチュートリアルでは、フォームの表示中にフォーム内の値を変更する方法について説明します。このためには、[フォームを表示] アクティビティ、[フォーム トリガー] アクティビティ、[フォームの値を取得] アクティビティ、および [フォームの値を設定] アクティビティ内で [ワークフローの実行を続行] 機能を使用します。

この特定のチュートリアルでは、他のフォーム コンポーネントの値に基づいてコンテンツをフォーム内に表示または自動入力する方法を説明します。

1. Main ワークフローを作成します。[フォームを表示] および [ローカル トリガーを実行] アクティビティを追加します。
2. 調査への参加についてユーザーに同意を求めるフォーム ファイルを作成します。このファイルに「Study participation consent」という名前を付けます。

   1. ラジオ コンポーネントを追加して、調査に参加するかどうかをユーザーに尋ねます。

      ユーザーの回答を取得してフォーム データを更新できるように、プロパティ名を覚えておいてください。

   2. ラジオ コンポーネントを追加し、18 歳以上かどうかをユーザーに尋ねます。

      ユーザーの回答を取得してフォーム データを更新できるように、プロパティ名を覚えておいてください。

   3. [ ラベル/ヘッダー] コンポーネントを 2 つ追加します。そのうちの1つは、ユーザーが参加を希望し、18歳以上のときにメッセージを表示する必要があります。もう一方のコンポーネントは、ユーザーが参加したいが 18 歳を超えていない場合にメッセージを表示する必要があります。

   4. ユーザーのフル ネームを尋ねるために、テキスト フィールド コンポーネントを追加します。

   5. ユーザーの年齢を尋ねるために、数コンポーネントを追加します。

   6. ユーザーが住んでいる市区町村を尋ねるために、テキスト フィールド コンポーネントを追加します。

   7. ユーザーが住んでいる地域を、ユーザーが入力した市区町村に基づいて自動入力するために、テキスト フィールド コンポーネントを追加します。

3. ユーザーが調査への参加を望まないシナリオに対してトリガー ワークフローを作成します (if user doesn't want to participate.xaml)。

   1. 治験への参加に同意フォームに [フォーム トリガー アクティビティ] を追加します。イベントとして、最初の ラジオ コンポーネントがいつ変更されるかを選択します。

   2. [ フォームの値を取得 ] アクティビティを追加します。[研究参加同意書] を選択します。[引数] コレクションに、最初のラジオ コンポーネントのエントリを追加します。

      この例では、次のエントリを追加します。

      キー	入力	値 (Value)
      wantToParticipate (最初のラジオ コンポーネントのプロパティ名)	String	desireToParticipate (グローバル変数)

      このアクティビティにより、ユーザーが調査に参加したいかどうかを確認できます。

   3. [条件分岐 (if)] アクティビティを追加し、ユーザーが調査への参加を望まない場合の条件を設定します。

      この例では、条件「desireToParticipate = "no"」を使用します。

   4. [Then] ブロックに、[フォームを閉じる] アクティビティと [ローカル トリガーを停止] アクティビティを追加します。

      ユーザーが調査への参加を望まない場合は、フォームが閉じた後、オートメーションが閉じます。

4. 調査に参加するユーザーが 18 歳以上かどうかを尋ねるトリガー ワークフローを作成します (check if user of legal age.xaml)。

   1. 治験への参加に同意フォームに [フォーム トリガー アクティビティ] を追加します。イベントとして、2 番目の ラジオ コンポーネントが変化するタイミングを選択します。

   2. [ フォームの値を取得 ] アクティビティを追加します。[研究参加同意書] を選択します。[引数] コレクションに、2 番目のラジオ コンポーネントのエントリを追加します。

      この例では、次のエントリを追加します。

      キー	入力	値 (Value)
      areYou18OrAbove (2 番目のラジオ コンポーネントのプロパティ名)	areYou18OrAbove	ofAge

   3. [条件分岐 (if)] アクティビティを追加し、ユーザーが 18 歳以上である場合の条件を設定します。

      この例では、条件「ofAge = "yes" And desireToParticipate = "yes"」を使用します。

   4. [Then] ブロックに [フォームの値を設定] アクティビティを追加します。ここで、ユーザーに対するカスタム メッセージをラベル/ヘッダー コンポーネント内で渡します。

      この例では、次のエントリを追加します。

      キー	入力	値 (Value)
      over18 (ラベル/ヘッダー コンポーネントのプロパティ名)	String	"Awesome! Please fill in the rest of the form to enroll in the study."

   5. 前の手順と同様に、ユーザーが 18 歳以上ではなくそれ以上フォームに入力できない場合のシナリオのために、[条件分岐 (if)] アクティビティをもう 1 つ追加します。

      この例では、条件「ofAge = "no" And desireToParticipate = "yes"」を使用します。

   6. [Then] ブロックに [フォームの値を設定] アクティビティを追加します。ここで、カスタム メッセージを表示し、フォームを閉じてオートメーションを停止します。

5. ユーザーの住んでいる地域を、ユーザーが入力した市区町村に基づいて自動入力するために、トリガー ワークフローを作成します (auto fill city district.xaml)。

   1. 治験への参加に同意フォームに [フォーム トリガー アクティビティ] を追加します。[イベント] として、[ 都市 ] コンポーネントが変更されるタイミングを選択します。

   2. ユーザーが住んでいる市区町村を取得するために、次の引数エントリを使用して [フォームの値を取得] アクティビティを追加します。

      キー	入力	値 (Value)
      city (City コンポーネントのプロパティ名)	String	userCity

このチュートリアルの結果については、以下のビデオをご覧ください。

ワークフローの例

この手順に従ってチュートリアルをご自身で試してみるには、こちらのサンプル プロジェクトをご覧ください。