lookupObjects (referencia de la API de cliente)

Abre un control de búsqueda para seleccionar uno o varios elementos.

Sintaxis

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

Parámetros

Nombre.	Type	Obligatorio	Description
lookupOptions	Objecto	Sí	Define las opciones para abrir el cuadro de diálogo de búsqueda. Consulte Propiedades lookupOptions
successCallback	Function	No	Una función para llamar cuando se llama al control de búsqueda. Se pasa una matriz de objetos con las siguientes propiedades: - entityType: Cadena. tipo de tabla del registro seleccionado en el control de búsqueda. - id: Cadena. Identificador del registro seleccionado en el control de búsqueda. - name: Cadena. Nombre del registro seleccionado en el control de búsqueda.
errorCallback	Function	No	Una función a la que se llama cuando la operación tiene error. No se considera un fallo si el usuario cancela la operación.

Propiedades lookupOptions

lookupOptions tiene las siguientes propiedades:

Nombre de la propiedad	Type	Obligatorio	Description
allowMultiSelect	Booleana	No	Indica si la búsqueda permite que se seleccione más de un elemento.
defaultEntityType	Cadena	No	El tipo de tabla predeterminado a utilizar.
defaultViewId	String	No	La vista predeterminada que se usa.
disableMru	Booleana	No	Decide si mostrar un el elemento (MRU) usado más recientemente. Disponible solo en la interfaz unificada.
entityTypes	Matriz	Sí	Los tipos de tabla a mostrar.
filters	Matriz de objetos	No	Usado para filtrar los resultados. Cada objeto de la matriz contiene los siguientes valores: -filterXml: Cadena. El elemento de filtro FetchXML que se aplicará. - entityLogicalName: Cadena. El tipo de tabla al que aplicar este filtro.
searchText	String	No	Indica el término de búsqueda predeterminado para el control de búsqueda. Solo se admite en la Interfaz unificada.
viewIds	Matriz	No	Las vistas que están disponibles en el selector de vistas. Se admiten únicamente vistas del sistema.

Ejemplo

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

Artículos relacionados

Xrm.Utility