Compartir vía

lookupObjects (referencia de la API de cliente)

  • Artículo

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

Sintaxis

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

Parámetros

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

Xrm.Utility

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).