lookupObjects (Referencia da API do cliente)

Abre un control de busca para seleccionar un ou máis elementos.

Sintaxe

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

Parámetros

Nome Tipo Obrigatorio Descrición
lookupOptions Obxecto Si Define as opcións para abrir o diálogo de busca. Ver as propiedades de lookupOptions
successCallback Function Non Función para chamar cando se invoca o control de busca. Pasa unha matriz de obxectos coas seguintes propiedades:
- entityType: String. Tipo de táboa do rexistro seleccionado no control de busca.
- id: String. ID do rexistro seleccionado no control de busca.
- name: String. Nome do rexistro seleccionado no control de busca.
errorCallback Function Non Unha función a chamar cando a operación falla. Non se considera un fallo se o usuario cancela a operación.

propiedades lookupOptions

lookupOptions Posúe as seguintes propiedades:

Nome da propiedade Tipo Obrigatorio Descrición
allowMultiSelect booleano Non Indica se a procura permite seleccionar máis dun elemento.
defaultEntityType String Non O tipo de táboa predeterminado a usar.
defaultViewId String Non A vista predeterminada a usar.
disableMru booleano Non Decide se mostrar o elemento usado máis recentemente (MRU).
Dispoñible só para a interface unificada.
entityTypes Matriz Si Tipos de táboas a mostrar.
filters Matriz de obxectos Non Utilízase para filtrar os resultados. Cada obxecto da matriz contén os seguintes valores:
- filterXml: String. Elemento de filtro FetchXML a aplicar.
- entityLogicalName: String. O tipo de táboa ao que aplicar este filtro.
searchText String Non Indica o termo de busca predeterminado para o control de busca. Isto só se admite na interface unificada.
viewIds Matriz Non As vistas estarán dispoñibles no selector de vistas. Só se admiten as vistas do sistema.

Exemplo

//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