lookupObjects (Ügyfél API-referencia)

Megnyitja a keresési vezérlőt egy vagy több elem kijelöléséhez.

Szemantika

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

Paraméterek

Név Típus Kötelező Description
lookupOptions lookupOptions Igen Meghatározza a keresési párbeszédpanel megnyitásának beállításait.
successCallback Funkció Nem A keresési vezérlő meghívásakor meghívandó függvény. A függvény az alábbi tulajdonságokkal rendelkező objektumtömböt kap:
- entityType:Húr. A keresési vezérlőben kijelölt rekord táblatípusa.
- id:Húr. A keresési vezérlőben kijelölt rekord azonosítója.
- name:Húr. A keresési vezérlőben kijelölt rekord neve.
errorCallback Funkció Nem A művelet sikertelensége esetén meghívandó függvény. Nem minősül hibának, ha a felhasználó megszakítja a műveletet.

lookupOptions tulajdonságai

lookupOptions a következő tulajdonságokkal rendelkezik:

Tulajdonság neve Típus Kötelező Description
allowMultiSelect logikai Nem Azt jelzi, hogy a keresés lehetővé teszi-e több elem kijelölését.
defaultEntityType Lánc Nem A használni kívánt alapértelmezett táblázattípus.
defaultViewId Lánc Nem A használni kívánt alapértelmezett nézet.
disableMru logikai Nem Dönti el, hogy a legutóbb használt (MRU) elem jelenjen-e meg.
Csak egyesített felületen érhető el.
entityTypes Array Igen A megjelenítendő táblázattípusok.
filters Objektumok tömbje Nem Az eredmények szűrésére szolgál. A tömb minden objektuma a következő értékeket tartalmazza:
- filterXml:Húr. Az alkalmazni kívánt FetchXML szűrőelem.
- entityLogicalName:Húr. Az a táblatípus, amelyre alkalmazni szeretné ezt a szűrőt.
searchText Lánc Nem A keresési vezérlő alapértelmezett keresési kifejezését jelzi. Ez az érték csak az egyesített felületen támogatott.
viewIds Array Nem A nézetválasztóban elérhető nézetek. Csak a rendszernézetek támogatottak.

Example

//define data for lookupOptions
const 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(
  (success) => console.log(success),
  (error) => console.log(error)
);

Xrm.Utility