Compartilhar via

lookupObjects (referência da API do cliente)

Abre um controle de pesquisa para selecionar um ou mais itens.

Sintaxe

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

Parâmetros

Nome Tipo Obrigatório Description
lookupOptions Object Yes Define as opções para abrir a caixa de diálogo de pesquisa. Ver as propriedades de lookupOptions
successCallback Função Não Uma função a ser chamada quando o controle de pesquisa é invocado. Uma matriz de objetos com as seguintes propriedades é passada:
- entityType:Corda. tipo de tabela do registro selecionado no controle de pesquisa.
- id:Corda. ID do registro selecionado no controle de pesquisa.
- name:Corda. Nome do registro selecionado no controle de pesquisa.
errorCallback Função Não Uma função a ser chamada quando a operação falhar. Não será considerada uma falha se o usuário cancelar a operação.

Propriedades de lookupOptions

lookupOptions tem as seguintes propriedades:

Nome da propriedade Tipo Obrigatório Description
allowMultiSelect booleano Não Indica se a pesquisa permite que mais de um item seja selecionado.
defaultEntityType String Não O tipo de tabela padrão a ser usado.
defaultViewId String Não O modo de exibição padrão a ser usado.
disableMru booleano Não Decide se o item MRU (usado mais recentemente) deve ser exibido.
Disponível somente para Interface Unificada.
entityTypes Array Yes Os tipos de tabela a serem exibidos.
filters Matriz de objetos Não Usado para filtrar os resultados. Cada objeto na matriz contém os seguintes valores:
- filterXml:Corda. O elemento de filtro FetchXML a ser aplicado.
- entityLogicalName:Corda. O tipo de tabela ao qual aplicar esse filtro.
searchText String Não Indica o termo de pesquisa padrão para o controle de pesquisa. Isso só tem suporte na Interface Unificada.
viewIds Array Não As exibições a serem disponibilizadas no seletor de exibição. Há suporte apenas para exibições do sistema.

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

Xrm.Utility

  • Last updated on