埋め込みリストの関係性データアイテムを構成する

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:4分
  • レコード画面内の埋め込みリストに表示される情報を制御できるように、関係性データアイテムを構成します。

    始める前に

    必要なロール:admin

    このタスクについて

    埋め込みリストを作成するには、関係性データアイテムが必要です。埋め込みリストは、レコード画面に埋め込むことができるリストです。モバイルの埋め込みリストの詳細については、「レコード画面の埋め込みリスト」を参照してください。

    手順

    1. 移動先 すべて > システムモバイル > モバイルアプリビルダー.
      モバイルアプリビルダー が新しいブラウザータブで開き、アプリケーションスコープ選択画面が表示されます。
    2. 作業しているアプリケーションスコープを検索し、アプリケーションスコープの名前を選択します。
      モバイルアプリビルダー カテゴリのホーム画面が表示されます。
    3. メニューから [データ] カテゴリを選択し、[新規] を選択します。
    4. [関係性データアイテム] アイコンを選択し、[続行] を選択します。
    5. 必要に応じて次のフィールドに入力します。
      表 : 1. 関係性データアイテムフィールド
      フィールド 説明
      プロパティセクション:
      名前 データアイテムのタイトル。同じ名前の複数のデータアイテムを持つことができます。簡単に見つけることができるように、この名前は一意のものにしてください。
      説明 データアイテムに関する追加の詳細情報 (オプション)
      データセクション:
      テーブル データアイテムで情報をプルするテーブル。このテーブルは、親レコード画面にリストとして埋め込まれているレコードのテーブルです。
      注:
      デフォルトでは、カスタムテーブルは利用できません。subscription.custom_table.enforce_entitlement システムプロパティを変更して、この動作を変更できます。この変更を行う詳細については、「モバイルデータアイテムのカスタムテーブルへのアクセスを許可または制限する」を参照してください。
      グループごと メニューから選択したフィールドに基づいてクエリ結果をグループ化します。
      関連するテーブル このデータアイテムのレコードが関連付けられているテーブル。たとえば、タスクレコード画面に埋め込まれたタスク SLA レコードリストでは、[関連するテーブル] の値が [タスク] テーブルになります。
      関係 [テーブル] フィールド内のテーブルと [関連するテーブル] フィールドで選択されたテーブル間の関係。
      条件タイプ データアイテムが使用する条件のタイプを決定します。次から選択します。
      宣言
      宣言的な条件を使用し、条件ビルダーでデータアイテムの条件を作成します。
      スクリプト化
      スクリプトを使用して、データアイテムの条件を決定します。このオプションを選択すると、このフィールドの下にスクリプトを入力するためのテキストウィンドウが表示されます。
      エンコードされたクエリを追加
      このオプションは、チャート画面に対してデータアイテムを作成する場合にのみ使用してください。そのデータアイテムタイプの詳細については、「チャート画面用にエンコードされたクエリデータアイテムの構成」を参照してください。
      条件 データアイテムを準拠させるための一連の条件。条件ビルダーを使用して条件を作成できます。
      注:
      このフィールドは、[条件タイプ] フィールドで [宣言] を選択した場合にのみ使用できます。
      ソート基準 リストのソート方法を設定できるフィールドをフォームに追加できるようにします。条件ビルダーで、リストをソートするフィールドを選択します。たとえば、[発信者] を選択します。次に、[昇順] または [降順] を選択して、リストの順序を決定します。
      注:
      このフィールドは、[条件タイプ] フィールドで [宣言] を選択した場合にのみ使用できます。
      パラメーター
      注:
      [パラメーター] フィールドは、関係性データアイテムには使用できません。
    6. オプション: [条件タイプ] フィールドで [スクリプト化済み] を選択した場合は、[クエリ条件スクリプト] フィールド内で作成する必要があります。

      スクリプト化された条件は、インスタンスがデータアイテムをフィルタリングするために使用するクエリ文字列を返す必要があります。input 変数を使用して、現在のレコードから情報にアクセスします。

      (function getQueryString(input) {
      	var queryString = '';
      	if(input.company) {
      		  queryString += "company="+input.company;
      	 }
      	if(input.location) {
      	  queryString += "^location="+input.location;
      	 }
              queryString += "^EQ^ORDERBYDESCsys_updated_on";
      	 return queryString; 
       })(input);

      この例では、input 変数を使用して、現在のレコードの会社と場所に一致するレコードのデータアイテムをフィルタリングします。次に、テキスト ^EQ^ORDERBYDESCsys_updated_on をクエリに追加します。これにより、[更新日時] フィールドによってデータアイテムレコードがソートされます。

      注:
      入力変数は、SubmittedForm オブジェクトまたは ParameterData オブジェクトで渡された値へのモバイルスクリプトアクセスを提供します。
    7. [Save (保存)] を選択します。

    次のタスク

    関係性データアイテムを作成した後、この新しく作成されたデータアイテムを使用してリスト画面を作成します。詳細については、「リスト画面の構成」を参照してください。