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

バックグラウンド情報

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

概要

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

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

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

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

既存のアプリケーションを開くか、新しいアプリケーションを開始します。
新しい表を作成します。
アプリの名前の横にあるをクリックし、[エンティティ] を選択して、アプリにエンティティを追加します。
新たに作成したエンティティを表の[データソース] フィールドに追加して、表にバインドします。
メインページの [データコンテキスト] フィールドに、式 =Lookup(Customer, [Name, "=", "Demo"]) を追加します。
新しいテキストボックスコントロールを追加します。
テキストボックスコントロールの [既定のテキスト] フィールドに、[名前] データコンテキストを追加します。アプリをプレビューすると、データコンテキストを使用して設定されたテキストがテキストボックスに表示されます。

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

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

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

既存のアプリケーションを開くか、新しいアプリケーションを開始します。
新しい表を作成します。
アプリの名前の横にあるをクリックし、[エンティティ] を選択して、アプリにエンティティを追加します。
新たに作成したエンティティを表の[データソース] フィールドに追加して、表にバインドします。
メインページの [データコンテキスト] フィールドに、式 =Lookup(Customer, [Name, "=", "Demo"]) を追加します。
新しいボタンコントロールを追加します。
ボタンに [エンティティレコードを作成/更新] ルールを設定します。[新しくレコードを作成するエンティティ/更新するエンティティレコードを選択] フィールドに、Customer-Main Page データコンテキストを追加します。設定したデータコンテキストがルールに追加されます。

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

既存のアプリケーションを開くか、新しいアプリケーションを開始します。
新しい表を作成します。
アプリの名前の横にあるをクリックし、[エンティティ] を選択して、アプリにエンティティを追加します。
新たに作成したエンティティを表の[データソース] フィールドに追加して、表にバインドします。
メインページの [データコンテキスト] フィールドに、式 =Lookup(Customer, [Name, "=", "Demo"]) を追加します。
新しいボタンコントロールを追加します。
ボタンに [エンティティレコードを削除] ルールを設定します。[削除するエンティティレコードを選択] フィールドに、Customer-Main Page データコンテキストを追加します。このルールによって、設定したデータコンテキストが削除されます。

New 関数を使用する

既存のアプリケーションを開くか、新しいアプリケーションを開始します。
新しい表を作成します。
アプリの名前の横にあるをクリックし、[エンティティ] を選択して、アプリにエンティティを追加します。
新たに作成したエンティティを表の[データソース] フィールドに追加して、表にバインドします。
メインページの [データコンテキスト] フィールドに、式 =New(Customer) を追加します。
以下の 2 つのテキストボックスコントロールを追加します。
- 最初のテキストボックスコントロールの [値のバインド] プロパティに、Data Context.Name を追加します。
- 2 つ目のテキストボックスコントロールの [値のバインド] プロパティに、Data Context.City を追加します。
新しいボタンコントロールを追加します。
ボタンに [エンティティレコードを作成/更新] ルールを設定します。[新しくレコードを作成するエンティティ/更新するエンティティレコードを選択] フィールドに、Customerのデータコンテキストを追加します。これにより、データが自動的にフィールドにバインドされます。
未使用のデータをフィールドから削除します。手順 6 で設定したデータは [設定する値] フィールドに保持します。

手順の結果

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

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

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

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

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

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