lookupObjects (asiakkaan ohjelmointirajapinnan viittaus)

Avaa hakuohjausobjektin yhden tai useamman kohteen valitsemista varten.

Syntaksi

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

Parametrit

Nimi	Tyyppi	Pakollinen	Kuvaus
lookupOptions	Objekti	Kyllä	Määrittää valintaikkunan avaamisen vaihtoehdot. Katso hakuAsetukset-ominaisuudet
successCallback	Function	Ei	Funktio, joka kutsuu, kun hakuohjausobjekti käynnistetään. Välitetään objektimatriisi, jolla on seuraavat ominaisuudet: - entityType:Merkkijono. hakuohjausobjektissa valitun tietueen taulukkotyyppi. - id:Merkkijono. Hakuohjausobjektissa valitun tietueen tunnus. - name:Merkkijono. Hakuohjausobjektissa valitun tietueen nimi.
errorCallback	Function	Ei	Funktio, jota kutsutaan, kun toiminto epäonnistuu. Tätä ei pidetä virheenä, jos käyttäjä peruuttaa toiminnon.

lookupOptions-ominaisuudet

lookupOptions sisältää seuraavat ominaisuudet:

Ominaisuuden nimi	Tyyppi	Pakollinen	Kuvaus
allowMultiSelect	totuusarvo	Ei	Ilmaisee, salliiko haku useamman kuin yhden kohteen valitsemisen.
defaultEntityType	String	Ei	Käytettävä oletustaulukkotyyppi.
defaultViewId	String	Ei	Käytettävä oletusnäkymä.
disableMru	totuusarvo	Ei	Päättää, näytetäänkö viimeksi käytetty kohde (MRU). Käytettävissä vain Unified Interfacelle.
entityTypes	Valikoima	Kyllä	Näytettävät taulukkotyypit.
filters	Objektien joukko	Ei	Käytetään tulosten suodattamiseen. Matriisin jokainen objekti sisältää seuraavat arvot: - filterXml:Merkkijono. Käytettävä FetchXML-suodatinelementti. - entityLogicalName:Merkkijono. Taulukkotyyppi, johon tämä suodatin käytetään.
searchText	String	Ei	Ilmaisee hakuohjausobjektin oletushakutermin. Tätä tuetaan vain Unified Interfacessa.
viewIds	Valikoima	Ei	Näkymävalitstimessa käytettävissä olevat näkymät. Vain järjestelmänäkymiä tuetaan.

Esimerkki:

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

Liittyvät artikkelit

Xrm.Utility