Apps ユーザーガイド

デリバリー:

最終更新日時 2025年6月26日

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
市町村
メール
名前
電話番号
プラン
ステート
郵便番号

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

Use the Function: Fetch function to retrieve multiple entity records. Additionally, use the Query builder to filter the retrieved records. In this example, we apply a filter to the Customer entity, so the search only returns customers from the state of Washington.

Refer to The Fetch function for more details.

注:

If you want to retrieve a single record, use the FetchOne function instead.

既存のアプリケーションを開くか、新しいアプリケーションを作成します。
[表] コントロールをアプリに追加します。
1. [コントロールを追加] を選択します。
2. [表示] を選択します。
3. [表] コントロールをアプリ内の領域にドラッグします。
アプリにエンティティを追加します。
1. キャンバスの上部から [任意に追加] アイコンを選択します。
2. [エンティティ] を選択します。
3. テナントを選択します。
4. アプリに追加するエンティティを選択し、[追加] をクリックします。
エンティティを [表] コントロールにバインドします。
1. プロパティ パネルの [全般] タブで、[データソース] の横にあるその他のリソースを選択するボタンを選択します。
2. [クエリビルダー] を選択します。
3. 使用するエンティティを選択し、[条件を追加] を選択します。
4. ドロップダウンメニューからフィールドを選択し、演算子 (= など) を選択します。
5. レコードのフィルター処理に使用する文字列を引用符で囲んで入力します。
  たとえば、ワシントン州の顧客レコードのみが必要な場合は、"WA" を値として追加します。
[式エディター] を使用して、特定の条件でフィルターを適用します。
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"})})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. [表示] を選択します。
3. [表] コントロールをアプリ内の領域にドラッグします。
アプリにエンティティを追加します。
1. キャンバスの上部から [任意に追加] アイコンを選択します。
2. [エンティティ] を選択します。
3. テナントを選択します。
4. アプリに追加するエンティティを選択し、[追加] をクリックします。
エンティティを [表] にバインドし、並べ替えルールを適用します。
1. プロパティ パネルの [全般] タブで、[データソース] の横にあるその他のリソースを選択するボタンを選択します。
2. [クエリビルダー] を選択します。
3. [その他の設定] を選択します。
4. [フィールドで並べ替え] に、並べ替えの基準にするフィールド (例: Name) を追加します。
5. [昇順で並べ替え] フィールドは、既定で [true] に設定されています。結果を降順に並べ替えるには、フィールドを選択して「False」と入力します。
アプリをプレビューまたは実行します。

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