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	lookupOptions	Yes	Define as opções para abrir a caixa de diálogo de pesquisa.
successCallback	Função	Não	Uma função a ser chamada quando o controle de pesquisa é invocado. A função recebe uma matriz de objetos com as seguintes propriedades: - 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. Esse valor 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
const 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(
  (success) => console.log(success),
  (error) => console.log(error)
);

Artigos relacionados

Xrm.Utility