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
| 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);});
Artículos relacionados
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).