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

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

構文

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

パラメーター

lookupOptions: オブジェクト。 検索ダイアログを開くためのオプションを定義します。 次のプロパティがあります。

プロパティ名 種類​​ 必須出席者 内容
allowMultiSelect Boolean 無効 検索で複数のアイテムを選択できるかどうかを指定します。
defaultEntityType String 無効 使用するデフォルトのテーブル タイプ。
defaultViewId String 無効 使用する既定のビュー。
disableMru Boolean 無効 最近使用した (MRU) アイテムを表示するかどうかを判断します。
統一インターフェイスでのみ使用できます。
entityTypes 配列 有効 表示するテーブルの種類。
フィルター オブジェクトの配列 無効 結果をフィルター処理するのに使用します。 配列の各オブジェクトには、以下の値が含まれています:
  • filterXml: 文字列。 適用する FetchXML フィルター要素。
  • entityLogicalName: 文字列。 このフィルターを適用するテーブル タイプです。
searchText String 無効 ルックアップ コントロールの既定の検索語句を示します。 これは、統一インターフェイスでのみサポートされます。
showBarcodeScanner Boolean 無効 検索コントロールがモバイル クライアントでバーコード スキャナーを表示するかどうかを示します。
viewIds Array 無効 ビュー ピッカーで使用できるビュー。 システム ビューのみサポートされます。

successCallback: 関数。 検索コントロールが呼び出された場合に呼び出す関数。 次のプロパティを持つオブジェクトの配列が渡されます。

  • entityType: 文字列。 ルックアップ コントロールで選択されたレコードのテーブル タイプです。
  • id: 文字列。 検索コントロールで選択されたレコードの ID。
  • name: 文字列。 検索コントロールで選択されたレコードの名前。

errorCallback: 関数。 検索コントロールをキャンセルしたか、または処理が失敗したときに呼び出す関数。

//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 分かかります。 個人データは収集されません (プライバシー ステートメント)。