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	Obiect	Da	Definește opțiunile pentru deschiderea casetei de dialog de căutare. Vedeți proprietățile lookupOptions
successCallback	Funcţie	Nu	O funcție de apelat atunci când este invocat controlul de căutare. Este trecută 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. Acest lucru 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
var 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(
  function(success){
console.log(success);},
function(error){console.log(error);});

Articole asociate

Xrm.Utility