lookupObjects (klient-API-referens)

Öppnar en uppslagskontroll för att välja ett eller flera objekt.

Syntax

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

Parameterar

Namn	Typ	Krävs	Description
lookupOptions	Object	Yes	Definierar alternativen för att öppna uppslagsdialogrutan. Se egenskaper för lookupOptions
successCallback	Funktion	Nej	En funktion som ska anropas när uppslagskontrollen anropas. En matris med objekt med följande egenskaper skickas: - entityType:Sträng. tabelltyp för den post som valts i uppslagskontrollen. - id:Sträng. ID för den post som valts i uppslagskontrollen. - name:Sträng. Namnet på den post som valts i uppslagskontrollen.
errorCallback	Funktion	Nej	En funktion som ska anropas när åtgärden misslyckas. Det anses inte vara ett fel om användaren avbryter åtgärden.

egenskaper för lookupOptions

lookupOptions har följande egenskaper:

Egenskapsnamn	Typ	Krävs	Description
allowMultiSelect	Boolean	Nej	Anger om sökningen tillåter att fler än ett objekt markeras.
defaultEntityType	String	Nej	Standardtabelltypen som ska användas.
defaultViewId	String	Nej	Standardvyn som ska användas.
disableMru	Boolean	Nej	Avgör om det senast använda objektet (MRU) ska visas. Endast tillgängligt för enhetligt gränssnitt.
entityTypes	Array	Yes	Tabelltyperna som ska visas.
filters	Matris med objekt	Nej	Används för att filtrera resultatet. Varje objekt i matrisen innehåller följande värden: - filterXml:Sträng. FetchXML-filterelementet som ska tillämpas. - entityLogicalName:Sträng. Den tabelltyp som du vill använda det här filtret för.
searchText	String	Nej	Anger standardsöktermen för uppslagskontrollen. Detta stöds endast i Enhetligt gränssnitt.
viewIds	Array	Nej	Vyerna som ska vara tillgängliga i visningsväljaren. Endast systemvyer stöds.

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

Relaterade artiklar

Xrm.Utility