lookupObjects (klient-API-reference)

Åbner et opslagskontrolelement for at vælge et eller flere elementer.

Syntaks

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

Parametre

Navn Type Obligatorisk Beskrivelse
lookupOptions lookupOptions Ja Definerer indstillingerne for åbning af opslagsdialogboksen.
successCallback Funktion Nej En funktion, der skal kaldes, når opslagskontrolelementet aktiveres. Funktionen modtager en matrix af objekter med følgende egenskaber:
- entityType:Streng. Tabeltype for den post, der er valgt i opslagskontrolelementet.
- id:Streng. Id'et for den post, der er valgt i opslagskontrolelementet.
- name:Streng. Navnet på den post, der er valgt i opslagskontrolelementet.
errorCallback Funktion Nej En funktion, der skal kaldes, når handlingen mislykkes. Det betragtes ikke som en fejl, hvis brugeren annullerer handlingen.

lookupOptions properties

lookupOptions har følgende egenskaber:

Egenskabsnavn Type Obligatorisk Beskrivelse
allowMultiSelect Boolean Nej Angiver, om opslaget tillader valg af mere end ét element.
defaultEntityType String Nej Den standardtabeltype, der skal bruges.
defaultViewId String Nej Den standardvisning, der skal bruges.
disableMru Boolean Nej Beslutter, om det senest anvendte element skal vises.
Kun tilgængelig for Unified Interface.
entityTypes Array Ja De tabeltyper, der skal vises.
filters Matrix af objekter Nej Bruges til at filtrere resultaterne. Hvert objekt i matrixen indeholder følgende værdier:
- filterXml:Streng. Det FetchXML-filterelement, der skal anvendes.
- entityLogicalName:Streng. Den tabeltype, dette filter skal anvendes på.
searchText String Nej Angiver standardsøgeordet for opslagskontrolelementet. Denne værdi understøttes kun på Unified Interface.
viewIds Array Nej De visninger, der skal være tilgængelige i visningsvælgeren. Det er kun systemvisninger, der understøttes.

Eksempel

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

  • Sidst opdateret den