lookupObjects (クライアント API 参照)

  • [アーティクル]

検索コントロールを開いて 1 つまたは複数のアイテムを選びます。

構文

Xrm.Utility.lookupObjects(lookupOptions).then(successCallback, errorCallback)

Parameters

件名 タイプ Required Description
lookupOptions Object はい 検索ダイアログを開くためのオプションを定義します。 lookupOptions プロパティ を参照してください
successCallback Function いいえ 検索コントロールが呼び出された場合に呼び出す関数。 次のプロパティを持つオブジェクトの配列が渡されます。
- entityType: 文字列。 ルックアップ コントロールで選択されたレコードのテーブル タイプです。
- id: 文字列。 検索コントロールで選択されたレコードの ID。
- name: 文字列。 検索コントロールで選択されたレコードの名前。
errorCallback Function いいえ 処理が失敗したときに呼び出す関数。 ユーザーが操作をキャンセルしても失敗とはみなされません。

lookupOptions プロパティ

lookupOptions には、次のプロパティがあります。

プロパティ名 タイプ Required 説明
allowMultiSelect ブール型 いいえ 検索で複数のアイテムを選択できるかどうかを指定します。
defaultEntityType 文字列 いいえ 使用するデフォルトのテーブル タイプ。
defaultViewId String いいえ 使用する既定のビュー。
disableMru ブール型 いいえ 最近使用した (MRU) アイテムを表示するかどうかを判断します。
統一インターフェイスでのみ使用できます。
entityTypes Array はい 表示するテーブルの種類。
filters オブジェクトの配列 いいえ 結果をフィルター処理するのに使用します。 配列の各オブジェクトには、以下の値が含まれています:
-filterXml: 文字列。 適用する FetchXML フィルター要素。
- entityLogicalName: 文字列。 このフィルターを適用するテーブル タイプです。
searchText String いいえ ルックアップ コントロールの既定の検索語句を示します。 これは、統一インターフェイスでのみサポートされます。
viewIds 配列 いいえ ビュー ピッカーで使用できるビュー。 システム ビューのみサポートされます。

例

//define data for lookupOptions
var lookupOptions = 
{
   defaultEntityType: "account",
   entityTypes: ["account"],
   allowMultiSelect: false,
   defaultViewId:"0D5D377B-5E7C-47B5-BAB1-A5CB8B4AC10",
   viewIds:["0D5D377B-5E7C-47B5-BAB1-A5CB8B4AC10","00000000-0000-0000-00AA-000010001003"],
   searchText:"Allison",
   filters: [{filterXml: "<filter type='or'><condition attribute='name' operator='like' value='A%' /></filter>",entityLogicalName: "account"}]
};

// Get account records based on the lookup Options
Xrm.Utility.lookupObjects(lookupOptions).then(
  function(success){
console.log(success);},
function(error){console.log(error);});

Xrm.Utility

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。