lookupObjects (referință API client)

Deschide un control de căutare pentru a selecta unul sau mai multe elemente.

Sintaxă

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

Parametri

Nume Tip Obligatoriu Descriere
lookupOptions căutareopții Da Definește opțiunile pentru deschiderea casetei de dialog de căutare.
successCallback Funcţie Nu O funcție de apelat atunci când este invocat controlul de căutare. Funcția primește o matrice de obiecte cu următoarele proprietăți:
- entityType:Șir. Tipul de tabel al înregistrării selectate în controlul de căutare.
- id:Șir. ID-ul înregistrării selectate în controlul de căutare.
- name:Șir. Numele înregistrării selectate în controlul de căutare.
errorCallback Funcţie Nu O funcție de apelat atunci când operațiunea eșuează. Nu este considerat o eroare dacă utilizatorul anulează operațiunea.

proprietăți căutareOpțiuni

lookupOptions are următoarele proprietăți:

Nume proprietate Tip Obligatoriu Descriere
allowMultiSelect Boolean Nu Arată dacă căutarea permite selectarea mai multor elemente.
defaultEntityType Șir Nu Tipul implicit de tabel de utilizat.
defaultViewId Șir Nu Vizualizarea implicită de utilizat.
disableMru Boolean Nu Decide dacă să se afișeze elementul cel mai recent utilizat(MRU).
Disponibil doar pentru interfață unificată.
entityTypes Vector Da Tipurile de tabel de afișat.
filters Matrice de obiecte Nu Utilizat pentru a filtra rezultatele. Fiecare obiect din matrice conține următoarele valori:
- filterXml:Șir. Elementul filtru FetchXML de aplicat.
- entityLogicalName:Șir. Tipul de tabel la care se aplică acest filtru.
searchText Șir Nu Indică termenul de căutare implicit pentru controlul de căutare. Această valoare este acceptată doar în interfața unificată.
viewIds Vector Nu Vizualizările care vor fi disponibile în selectorul de vizualizări. Doar vizualizările de sistem sunt acceptate.

Exemplu

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