lookupObjects (referenční dokumentace k rozhraní API klienta)

Otevře ovládací prvek vyhledávání, který vybere jednu nebo více položek.

Syntaxe

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

Parametry

Název	Typ	Povinné	Description
lookupOptions	lookupOptions	Ano	Definuje možnosti pro otevření vyhledávacího dialogového okna.
successCallback	Funkce	Ne	Funkce, která se má volat při vyvolání ovládacího prvku vyhledávání. Funkce obdrží pole objektů s následujícími vlastnostmi: - entityType:Řetězec. Typ tabulky záznamu vybraného v ovládacím prvku vyhledávání - id:Řetězec. ID záznamu vybraného v ovládacím prvku vyhledávání - name:Řetězec. Název záznamu vybraného v ovládacím prvku vyhledávání
errorCallback	Funkce	Ne	Funkce, která se má volat v případě selhání operace. Pokud uživatel operaci zruší, nepovažuje se za selhání.

lookupOptions – vlastnosti

lookupOptions má následující vlastnosti:

Název vlastnosti	Typ	Povinné	Description
allowMultiSelect	logický	Ne	Určuje, zda vyhledávání umožňuje vybrat více než jednu položku.
defaultEntityType	String	Ne	Výchozí typ tabulky, který se má použít.
defaultViewId	String	Ne	Výchozí zobrazení, které se má použít.
disableMru	logický	Ne	Určuje, zda se má zobrazit naposledy použitá položka (MRU). K dispozici pouze pro sjednocené rozhraní.
entityTypes	Array	Ano	Typy tabulek, které se mají zobrazit.
filters	Pole objektů	Ne	Slouží k filtrování výsledků. Každý objekt v poli obsahuje následující hodnoty: - filterXml:Řetězec. Element filtru FetchXML, který se má použít. - entityLogicalName:Řetězec. Typ tabulky, na který chcete tento filtr použít.
searchText	String	Ne	Označuje výchozí hledaný termín pro ovládací prvek vyhledávání. Tato hodnota je podporována pouze u sjednoceného rozhraní.
viewIds	Array	Ne	Zobrazení, která mají být k dispozici v nástroji pro výběr zobrazení. Podporují se jenom systémová zobrazení.

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)
);

Související články

Xrm.Utility