Sdílet prostřednictvím


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 Object Ano Definuje možnosti pro otevření vyhledávacího dialogového okna. Zobrazit vlastnosti lookupOptions
successCallback Funkce Ne Funkce, která se má volat při vyvolání ovládacího prvku vyhledávání. Předá se 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í. To je podporováno 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
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