lookupObjects (referencia de la API de cliente)

Abre un control de búsqueda para seleccionar uno o varios elementos.

Sintaxis

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

Parámetros

Nombre. Type Obligatorio Description
lookupOptions lookupOptions Sí Define las opciones para abrir el cuadro de diálogo de búsqueda.
successCallback Function No Una función para llamar cuando se llama al control de búsqueda. La función recibe una matriz de objetos con las siguientes propiedades:
- entityType: Cadena. Tipo de tabla del registro seleccionado en el control de búsqueda.
- id: Cadena. Identificador del registro seleccionado en el control de búsqueda.
- name: Cadena. Nombre del registro seleccionado en el control de búsqueda.
errorCallback Function No Una función a la que se llama cuando la operación tiene error. No se considera un error si el usuario cancela la operación.

Propiedades lookupOptions

lookupOptions tiene las siguientes propiedades:

Nombre de la propiedad Type Obligatorio Description
allowMultiSelect Booleana No Indica si la búsqueda permite que se seleccione más de un elemento.
defaultEntityType Cadena No El tipo de tabla predeterminado a utilizar.
defaultViewId Cadena No La vista predeterminada que se usa.
disableMru Booleana No Decide si mostrar un el elemento (MRU) usado más recientemente.
Disponible solo en la interfaz unificada.
entityTypes Matriz Sí Los tipos de tabla a mostrar.
filters Matriz de objetos No Usado para filtrar los resultados. Cada objeto de la matriz contiene los siguientes valores:
- filterXml: Cadena. El elemento de filtro FetchXML que se aplicará.
- entityLogicalName: Cadena. El tipo de tabla al que aplicar este filtro.
searchText Cadena No Indica el término de búsqueda predeterminado para el control de búsqueda. Este valor solo se admite en la interfaz unificada.
viewIds Matriz No Las vistas que están disponibles en el selector de vistas. Se admiten únicamente vistas del sistema.

Ejemplo

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

Xrm.Utility

  • Se actualizó por última vez el