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	procurarOpções	Yes	Define as opções para abrir a caixa de diálogo de pesquisa.
successCallback	Função	Não	Uma função para chamar quando o controle de pesquisa é invocado. A função recebe um array de objetos com as seguintes propriedades: - entityType: Fio. Tipo de tabela do registo selecionado no controlo de pesquisa. - id: Fio. ID do registro selecionado no controle de pesquisa. - name: Fio. 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 utilizador 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: Fio. O elemento de filtro FetchXML a ser aplicado. - entityLogicalName: Fio. 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. Este valor é 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
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