Apps を Data Service と使用する

バックグラウンド情報

注:

• 実行時には、すべてのフィルターに対して最大 1,000 件のレコードが取得されます。
• エンティティのデータが読み込まれると、ルールの実行時にのみデータが更新されます。プロセスまたはその他の手段によるエンティティの変更は、Apps で自動的に更新されません。こうしたシナリオでは、データを明示的に更新してください。
• in 演算子は、string、number、boolean、null などのプリミティブなデータ型のみをサポートします。

in 演算子は、choice-set を使用する Data Service シナリオではサポートされません。代わりに contains 演算子を使用できますが、1 つの入力に対してのみ使用できます。

概要

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

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

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

顧客を州の名前でフィルター処理する

Fetch 関数を使用して、複数のエンティティ レコードを取得します。さらに、[クエリ ビルダー] を使用して、取得したレコードをフィルター処理します。この例では、Customer エンティティにフィルターを適用し、検索でワシントン州の顧客のみが返されるようにします。

詳しくは、「Fetch 関数」をご覧ください。

注:

単一のレコードを取得する場合は、代わりに FetchOne 関数を使用します。

1. 既存のアプリケーションを開くか、新しいアプリケーションを作成します。
2. [表] コントロールをアプリに追加します。
   1. [コントロールを追加] を選択します。
   2. [表示] を選択します。
   3. [表] コントロールをアプリ内の領域にドラッグします。
3. アプリにエンティティを追加します。
   1. キャンバスの上部から [任意に追加] アイコンを選択します。
   2. [エンティティ] を選択します。
   3. テナントを選択します。
   4. アプリに追加するエンティティを選択し、[追加] をクリックします。
4. エンティティを [表] コントロールにバインドします。
   1. プロパティ パネルの [全般] タブで、[データ ソース] の横にあるその他のリソースを選択するボタンを選択します。
   2. [クエリ ビルダー] を選択します。
   3. 使用するエンティティを選択し、[条件を追加] を選択します。
   4. ドロップダウン メニューからフィールドを選択し、演算子 (= など) を選択します。
   5. レコードのフィルター処理に使用する文字列を引用符で囲んで入力します。
      たとえば、ワシントン州の顧客レコードのみが必要な場合は、"WA" を値として追加します。
5. [式エディター] を使用して、特定の条件でフィルターを適用します。
   1. [クエリ ビルダー] で [リソースを開く] ボタンを選択し、[式エディター] を選択します。
   2. 条件を含む式を記述します。たとえば、IF 条件を使用して、アプリのメイン ページの [ドロップダウン] コントロールが空白ではなく、ユーザーが指定した値が含まれている場合にのみ、フィルターを適用できます。

      Fetch(of Customer)(  
      If(  
      MainPage.Dropdown is Nothing,  
      Nothing,  
      createFilterGroup(New QueryFilter(){addFilter("State", "contains", MainPage.Dropdown.Value)}, Nothing, 0)),  
      Nothing, Nothing, Nothing, New ExpansionFieldOption( {addExpansionFieldOption("CreatedBy", New String(){"Id","Name"}), addExpansionFieldOption("UpdatedBy", New String(){"Id","Name"})})

アプリをプレビューまたは実行すると、クエリが実行され、フィルター処理されたレコードが取得されます。

顧客を並べ替える

[クエリ ビルダー] を使用して、検索に並べ替えオプションを適用します。

1. 既存のアプリケーションを開くか、新しいアプリケーションを作成します。
2. [表] コントロールをアプリに追加します。
   1. [コントロールを追加] を選択します。
   2. [表示] を選択します。
   3. [表] コントロールをアプリ内の領域にドラッグします。
3. アプリにエンティティを追加します。
   1. キャンバスの上部から [任意に追加] アイコンを選択します。
   2. [エンティティ] を選択します。
   3. テナントを選択します。
   4. アプリに追加するエンティティを選択し、[追加] をクリックします。
4. エンティティを [表] にバインドし、並べ替えルールを適用します。
   1. プロパティ パネルの [全般] タブで、[データ ソース] の横にあるその他のリソースを選択するボタンを選択します。
   2. [クエリ ビルダー] を選択します。
   3. [その他の設定] を選択します。
   4. [フィールドで並べ替え] に、並べ替えの基準にするフィールド (例: Name) を追加します。
   5. [昇順で並べ替え] フィールドは、既定で [true] に設定されています。結果を降順に並べ替えるには、フィールドを選択して「False」と入力します。
5. アプリをプレビューまたは実行します。

   アプリをプレビューまたは実行すると、エンティティの [Name] フィールドのレコードがアルファベットの降順で [表] に表示されます。

[編集グリッド] を持つエンティティを使用する

[編集グリッド] コントロールを使用すると、アプリ内にエンティティ レコードを表示し、このコントロールを使用してエンティティに対して CRUD 操作を実行できます。

[編集グリッド] コントロールに関する詳細と実用的な例については、「Fetch を使用してエンティティ レコードを [編集グリッド] コントロール内に取得する」および「[編集グリッド] コントロールを持つエンティティを使用する」をご覧ください。