データ コンテキストを使用する

バックグラウンド情報

エンティティについて詳しくは、以下のガイドをご覧ください。

• データ コンテキストについて
• 関数: Filter
• 関数: Sort
• 関数: New
• 関数: Lookup
• ルール: エンティティ レコードを作成/更新
• ルール: エンティティ レコードを削除

概要

この例を開始する前に、Data Service に対する適切な権限があることを確認してください。詳細については、『Data Service ガイド』の「アクセス権を管理する」をご覧ください。

この例では、以下のフィールドを持つ、Customer というエンティティを使用します。

• Address
• 住所 2
• 市町村
• メール
• 名前
• 電話番号
• プラン
• ステート
• 郵便番号

データ コンテキストを設定する

1. 既存のアプリケーションを開くか、新しいアプリケーションを開始します。

2. 新しい表を作成します。

3. Add an entity to your app by clicking the Add any icon from the top of the canvas and selecting Entity.

   

4. 新たに作成したエンティティを表の[データ ソース] フィールドに追加して、表にバインドします。

5. メイン ページの [データ コンテキスト] フィールドに、式 =Lookup(Customer, [Name, "=", "Demo"]) を追加します。

   

6. 新しいテキストボックス コントロールを追加します。

7. テキストボックス コントロールの [既定のテキスト] フィールドに、[名前] データ コンテキストを追加します。アプリをプレビューすると、データ コンテキストを使用して設定されたテキストがテキスト ボックスに表示されます。

   

データ コンテキストをルールで使用する

[エンティティ レコードを作成/更新] ルール

データ コンテキストは、[エンティティ レコードを作成/更新] ルールを使用して既存のエンティティを更新する場合にのみ使用できます。

1. 既存のアプリケーションを開くか、新しいアプリケーションを開始します。

2. 新しい表を作成します。

3. Add an entity to your app by clicking the Add any icon from the top of the canvas and selecting Entity.

   

4. 新たに作成したエンティティを表の[データ ソース] フィールドに追加して、表にバインドします。

5. メイン ページの [データ コンテキスト] フィールドに、式 =Lookup(Customer, [Name, "=", "Demo"]) を追加します。

   

6. 新しいボタン コントロールを追加します。

7. ボタンに [エンティティ レコードを作成/更新] ルールを設定します。[新しくレコードを作成するエンティティ/更新するエンティティ レコードを選択] フィールドに、Customer-Main Page データ コンテキストを追加します。設定したデータ コンテキストがルールに追加されます。

   

[エンティティ レコードを削除] ルール

1. 既存のアプリケーションを開くか、新しいアプリケーションを開始します。

2. 新しい表を作成します。

3. Add an entity to your app by clicking the Add any icon from the top of the canvas and selecting Entity.

   

4. 新たに作成したエンティティを表の[データ ソース] フィールドに追加して、表にバインドします。

5. メイン ページの [データ コンテキスト] フィールドに、式 =Lookup(Customer, [Name, "=", "Demo"]) を追加します。

   

6. 新しいボタン コントロールを追加します。

7. ボタンに [エンティティ レコードを削除] ルールを設定します。[削除するエンティティ レコードを選択] フィールドに、Customer-Main Page データ コンテキストを追加します。このルールによって、設定したデータ コンテキストが削除されます。

   

New 関数を使用する

1. 既存のアプリケーションを開くか、新しいアプリケーションを開始します。

2. 新しい表を作成します。

3. Add an entity to your app by clicking the Add any icon from the top of the canvas and selecting Entity.

   

4. 新たに作成したエンティティを表の[データ ソース] フィールドに追加して、表にバインドします。

5. メイン ページの [データ コンテキスト] フィールドに、式 =New(Customer) を追加します。

   

6. 以下の 2 つのテキストボックス コントロールを追加します。

   • 最初のテキストボックス コントロールの [値のバインド] プロパティに、Data Context.Name を追加します。
   • 2 つ目のテキストボックス コントロールの [値のバインド] プロパティに、Data Context.City を追加します。

7. 新しいボタン コントロールを追加します。

8. ボタンに [エンティティ レコードを作成/更新] ルールを設定します。[新しくレコードを作成するエンティティ/更新するエンティティ レコードを選択] フィールドに、Customerのデータ コンテキストを追加します。これにより、データが自動的にフィールドにバインドされます。

9. 未使用のデータをフィールドから削除します。手順 6 で設定したデータは [設定する値] フィールドに保持します。

   

手順の結果

実行時、新しい顧客の名前と市区町村を 2 つのテキスト フィールドに追加し、ボタンをクリックすると、新しいエントリが表に追加されます。

異なるページのエンティティを参照する

別のページの表から選択したエンティティ フィールド値を直接参照するには、少なくとも 1 つの変数を使用する必要があります。

各フィールドに変数を作成する代わりに、[エンティティ ID] に変数を使用できます。2 番目のページで、以下の操作を実行できます。

1. コンテナー コントロールを追加します。
2. コンテナーの [データ コンテキスト] プロパティを次のように設定します。Lookup (Entity, [id, "=", myVariableID])
3. 必要なコントロールをコンテナー内に追加し、データ コンテキストで使用可能なエンティティの使用可能なフィールドにバインドします。

この場合、Lookup 関数を使用できます。この関数をエンティティ オブジェクトとして扱えるからです。つまり、コンテナー データ コンテキストで [エンティティ レコードを作成/更新] ルールを使用して、そのエンティティを更新できます。