Partilhar 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 Objeto Yes Define as opções para abrir a caixa de diálogo de pesquisa. Consulte as propriedades lookupOptions
successCallback Função Não Uma função para chamar quando o controle de pesquisa é invocado. Uma matriz de objetos com as seguintes propriedades é passada:
- entityType: String. Tipo de tabela do registro selecionado no controle de pesquisa.
- id: String. ID do registro selecionado no controle de pesquisa.
- name: String. Nome do registro selecionado no controle de pesquisa.
errorCallback Função Não Uma função para chamar quando a operação falhar. Não é considerado uma falha se o usuário cancelar a operação.

propriedades 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 deseja exibir o item usado mais recentemente (MRU).
Disponível apenas 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: String. O elemento de filtro FetchXML a ser aplicado.
- entityLogicalName: String. O tipo de tabela ao qual aplicar este filtro.
searchText String Não Indica o termo de pesquisa padrão para o controle de pesquisa. Isso é suportado apenas na Interface Unificada.
viewIds Array Não Os modos de exibição a serem disponibilizados no seletor de modos de exibição. Apenas as vistas do sistema são suportadas.

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