lookupObjects (Referència de l'API del client)

Obre un control de cerca per seleccionar un o més elements.

Sintaxi

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

Paràmetres

Nom	Tipus	Necessari	Descripció
lookupOptions	lookupOptions	Sí	Defineix les opcions per obrir el diàleg de cerca.
successCallback	Function	No	Funció per cridar quan s'invoca el control de cerca. La funció rep un array d'objectes amb les següents propietats: - entityType:Corda. Tipus de taula del registre seleccionat al control de cerca. - id:Corda. ID del registre seleccionat al control de cerca. - name:Corda. Nom del registre seleccionat al control de cerca.
errorCallback	Function	No	Una funció per cridar quan l'operació falla. No es considera un fracàs si l'usuari cancel·la l'operació.

propietats lookupOptions

lookupOptions Té les propietats següents:

Nom de la propietat	Tipus	Necessari	Descripció
allowMultiSelect	booleà	No	Indica si la cerca permet seleccionar més d'un element.
defaultEntityType	String	No	El tipus de taula per defecte a utilitzar.
defaultViewId	String	No	La visualització per defecte que s'utilitzarà.
disableMru	booleà	No	Decideix si es mostra l'element utilitzat més recentment (MRU). Disponible només per a la interfície unificada.
entityTypes	Matriu	Sí	Els tipus de taula que es mostraran.
filters	Matriu d'objectes	No	S'utilitza per filtrar els resultats. Cada objecte de la matriu conté els valors següents: - filterXml:Corda. L'element de filtre FetchXML que s'ha d'aplicar. - entityLogicalName:Corda. El tipus de taula al qual s'ha d'aplicar aquest filtre.
searchText	String	No	Indica el terme de cerca per defecte per al control de cerca. Aquest valor només és compatible amb la Interfície Unificada.
viewIds	Matriu	No	Les visualitzacions estaran disponibles al selector de visualitzacions. Només s'admeten les visualitzacions del sistema.

Exemple

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

Articles relacionats

Xrm.Utility