lookupObjects (asiakkaan ohjelmointirajapinnan viittaus)

Avaa hakuohjausobjektin yhden tai useamman kohteen valitsemista varten.

Syntaksi

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

Parametrit

Nimi Tyyppi Pakollinen Kuvaus
lookupOptions lookupOptions Kyllä Määrittää valintaikkunan avaamisen vaihtoehdot.
successCallback Function Ei Funktio, joka kutsuu, kun hakuohjausobjekti käynnistetään. Funktio vastaanottaa objektimatriisin, jolla on seuraavat ominaisuudet:
- entityType:Merkkijono. Hakuohjausobjektissa valitun tietueen taulukkotyyppi.
- id:Merkkijono. Hakuohjausobjektissa valitun tietueen tunnus.
- name:Merkkijono. Hakuohjausobjektissa valitun tietueen nimi.
errorCallback Function Ei Funktio, jota kutsutaan, kun toiminto epäonnistuu. Sitä ei pidetä virheenä, jos käyttäjä peruuttaa toiminnon.

lookupOptions-ominaisuudet

lookupOptions sisältää seuraavat ominaisuudet:

Ominaisuuden nimi Tyyppi Pakollinen Kuvaus
allowMultiSelect totuusarvo Ei Ilmaisee, salliiko haku useamman kuin yhden kohteen valitsemisen.
defaultEntityType String Ei Käytettävä oletustaulukkotyyppi.
defaultViewId String Ei Käytettävä oletusnäkymä.
disableMru totuusarvo Ei Päättää, näytetäänkö viimeksi käytetty kohde (MRU).
Käytettävissä vain Unified Interfacelle.
entityTypes Valikoima Kyllä Näytettävät taulukkotyypit.
filters Objektien joukko Ei Käytetään tulosten suodattamiseen. Matriisin jokainen objekti sisältää seuraavat arvot:
- filterXml:Merkkijono. Käytettävä FetchXML-suodatinelementti.
- entityLogicalName:Merkkijono. Taulukkotyyppi, johon tämä suodatin käytetään.
searchText String Ei Ilmaisee hakuohjausobjektin oletushakutermin. Tätä arvoa tuetaan vain Unified Interfacessa.
viewIds Valikoima Ei Näkymävalitstimessa käytettävissä olevat näkymät. Vain järjestelmänäkymiä tuetaan.

Esimerkki:

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

  • Viimeksi päivitetty