lookupObjects (Klient-API-referanse)

Åpner en oppslagskontroll for å velge ett eller flere elementer.

Syntaks

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

Parametere

Navn	Type	Kreves	Bekrivelse
lookupOptions	Object	Ja	Definerer alternativene for åpning av oppslagsdialogboksen. Se egenskaper for lookupOptions
successCallback	Function	Nei	En funksjon som skal ringes opp når oppslagskontrollen aktiveres. En matrise med objekter med følgende egenskaper sendes: - entityType:Streng. tabelltype for posten som er valgt i oppslagskontrollen. - id:Streng. ID for posten som er valgt i oppslagskontrollen. - name:Streng. Navnet på posten som er valgt i oppslagskontrollen.
errorCallback	Function	Nei	En funksjon som skal kalles når operasjonen mislykkes. Det anses ikke som en feil hvis brukeren avbryter operasjonen.

egenskaper for lookupOptions

lookupOptions har følgende egenskaper:

Egenskapsnavn	Type	Kreves	Bekrivelse
allowMultiSelect	boolsk	Nei	Angir om oppslaget tillater at mer enn ett element kan velges.
defaultEntityType	Streng	Nei	Standard tabelltype som skal brukes.
defaultViewId	Streng	Nei	Standardvisningen som skal brukes.
disableMru	boolsk	Nei	Bestemmer om det sist brukte elementet (MRU) skal vises. Bare tilgjengelig for Enhetlig grensesnitt.
entityTypes	Matrise	Ja	Tabelltypene som skal vises.
filters	Matrise av objekter	Nei	Brukes til å filtrere resultatene. Hvert objekt i matrisen inneholder følgende verdier: - filterXml:Streng. FetchXML-filterelementet som skal brukes. - entityLogicalName:Streng. Tabelltypen du vil bruke dette filteret på.
searchText	Streng	Nei	Angir standard søkeord for oppslagskontrollen. Dette støttes bare på Enhetlig grensesnitt.
viewIds	Matrise	Nei	Visningene som skal være tilgjengelige i visningsvelgeren. Bare systemvisninger støttes.

Eksempel

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

Relaterte artikler

Xrm.Utility