lookupObjects (odkaz na klientske rozhranie API)

Otvorí ovládací prvok vyhľadávania na výber jednej alebo viacerých položiek.

Syntax

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

Parametre

Meno	Typ	Požaduje sa	Popis
lookupOptions	Object	Áno	Definuje možnosti na otvorenie dialógového okna vyhľadávania. Zobraziť vlastnosti vyhľadávaniaMožnosti
successCallback	Function	No	Funkcia, ktorá sa zavolá pri vyvolaní ovládacieho prvku vyhľadávania. Odovzdá sa pole objektov s nasledujúcimi vlastnosťami: - entityType:Povrázok. typ tabuľky záznamu vybratého v ovládacom prvku vyhľadávania. - id:Povrázok. ID záznamu vybratého v ovládacom prvku vyhľadávania. - name:Povrázok. Názov záznamu vybratého v ovládacom prvku vyhľadávania.
errorCallback	Function	No	Funkcia, ktorá sa volá v prípade zlyhania operácie. Ak používateľ operáciu zruší, nepovažuje sa to za zlyhanie.

lookupMožnosti vlastností

lookupOptions má nasledujúce vlastnosti:

Názov vlastnosti	Typ	Požaduje sa	Popis
allowMultiSelect	booleovský	No	Udáva, či vyhľadávanie umožňuje výber viac ako jednej položky.
defaultEntityType	String	No	Predvolený typ tabuľky, ktorý sa má použiť.
defaultViewId	String	No	Predvolené zobrazenie, ktoré sa má použiť.
disableMru	booleovský	No	Rozhoduje, či sa má zobraziť naposledy použitá položka (MRU). K dispozícii iba pre zjednotené rozhranie.
entityTypes	Pole	Áno	Tabuľka obsahuje typy, ktoré sa majú zobraziť.
filters	Pole objektov	No	Používa sa na filtrovanie výsledkov. Každý objekt v poli obsahuje nasledujúce hodnoty: - filterXml:Povrázok. Použije sa prvok filtra FetchXML. - entityLogicalName:Povrázok. Typ tabuľky, na ktorý sa má použiť tento filter.
searchText	String	No	Označuje predvolený hľadaný výraz pre ovládací prvok vyhľadávania. Toto je podporované len v zjednotenom rozhraní.
viewIds	Pole	No	Zobrazenia, ktoré majú byť k dispozícii vo výbere zobrazení. Podporované sú iba systémové zobrazenia.

Príklad

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

Súvisiace články

Xrm.Utility