retrieveMultipleRecords (referință API client)

Regăsește o colecție de înregistrări de tabel.

Sintaxă

Xrm.WebApi.retrieveMultipleRecords(entityLogicalName, options, maxPageSize).then(successCallback, errorCallback);

Parametri

Nume Tipul Obligatoriu Descriere
entityLogicalName Șir Da Numele logic al tabelului pentru înregistrările pe care doriți să le regăsiți. De exemplu: account.
options Șir Nu Opțiunile de interogare a sistemului OData sau interogarea PreluareXML pentru a regăsi datele. Vedeți opțiunile
maxPageSize Număr Nu Specificați un număr pozitiv care indică numărul de înregistrări de tabel de returnat pe pagină. Dacă nu specificați acest parametru, valoarea implicită este limita maximă de 5.000 de înregistrări pentru tabele standard și 500 pentru tabele elastice.

Dacă numărul de înregistrări pe care le regăsiți este mai mare decât valoarea specificată maxPageSize sau limita maximă pentru tipul de tabel, nextLink coloana din obiectul promis returnat conține un link pentru a regăsi înregistrările.
successCallback Funcţie Nu O funcție de apelat atunci când sunt regăsite înregistrările tabelului. Consultați Valoarea returnată
errorCallback Funcţie Nu O funcție de apelat atunci când operațiunea eșuează. Se transmite un obiect cu următoarele proprietăți:
- errorCode:Număr. Codul de eroare ca număr zecimal pozitiv. De exemplu, codul de eroare documentat ca 0x80040333 va fi returnat ca 2147746611.
- message:Șir. Un mesaj de eroare care descrie problema.

Opţiuni

Sunt acceptate următoarele opțiuni de interogare de sistem: $select, $top, $filter, $expand, și $orderby.

Utilizați opțiunea de interogare de $expand sistem pentru a controla ce date din tabelele asociate sunt returnate. Dacă includeți doar numele proprietății de navigare, primiți toate proprietățile pentru înregistrările asociate. Puteți limita proprietățile returnate pentru înregistrările asociate utilizând opțiunea $select de interogare a sistemului între paranteze după numele proprietății de navigare. Utilizați această opțiune atât pentru proprietățile de navigare cu valoare unică , cât și pentru cele cu valoare de colecție . Pentru offline, se acceptă doar opțiunea imbricată $select din $expand interiorul.

Pentru a specifica o interogare FetchXML, utilizați fetchXml coloana pentru a specifica interogarea.

Notă

Trebuie să utilizați întotdeauna opțiunea $select de interogare de sistem pentru a limita proprietățile returnate pentru o înregistrare de tabel, incluzând o listă separată prin virgulă de nume de proprietăți. Această practică este importantă pentru performanță. Dacă nu specificați proprietăți utilizând $select, se returnează toate proprietățile.

Specificați opțiunile de interogare începând cu ?. De asemenea, puteți specifica mai multe opțiuni de interogare de sistem, utilizând & pentru a separa opțiunile de interogare.

Când specificați un șir de interogare OData pentru options parametru, codificați interogarea pentru caractere speciale.

Când specificați o interogare FetchXML pentru options parametru, nu codificați interogarea.

Pentru a afla cum să definiți options parametrul pentru diverse scenarii de regăsire a mai multor scenarii, consultați Exemple.

Valoare returnată

La succes, returnează un obiect promisiune către successCallback următoarele proprietăți:

Nume Tipul Descriere
entities Matrice de obiecte JSON Fiecare obiect reprezintă înregistrarea de tabel regăsită care conține coloane și valorile lor ca key: value perechi. ID-ul înregistrării tabelului este regăsit în mod implicit.
nextLink Șir (opțional) Dacă numărul de înregistrări regăsite este mai mare decât valoarea specificată în maxPageSize parametrul din solicitare, aceasta returnează URL-ul pentru a returna următoarea pagină de înregistrări.
fetchXmlPagingCookie (opțional) Pentru o operațiune bazată pe retrieveMultipleRecords preluareXml cu paginare în care numărul total de înregistrări este mai mare decât valoarea de paginare, acest atribut returnează modulul cookie de paginare care poate fi utilizat pentru o operațiune ulterioară de preluareXml pentru a regăsi următoarea pagină de înregistrări.

Tipuri de atribute neacceptate pentru opțiunile de interogare OData în dispozitive mobile offline

Următoarele tipuri de coloane nu sunt acceptate atunci când utilizați Xrm.WebApi.retrieveMultipleRecords cu opțiunile șirului de interogare OData (cum $select ar fi și $filter) în modul offline mobil. Utilizați FetchXML dacă trebuie să lucrați cu un tip de atribut în această listă de tipuri de atribute neacceptate.

  • MultiSelectPicklist
  • File
  • Image
  • ManagedProperty
  • CalendarRules
  • PartyList
  • Virtual

Caracteristici neacceptate în mediul mobil offline

Următoarele caracteristici nu sunt acceptate în mediul mobil offline:

  • Caracteristici de grupare și agregare

Operațiuni de filtrare acceptate pentru fiecare tip de atribut din mobil offline, utilizând FetchXML

Următoarele operațiuni sunt acceptate pentru toate tipurile de atribute atunci când lucrați cu FetchXML:

  • Este egal cu (eq)
  • Nu este egal cu (neq)
  • Nul (null)
  • Nu este nul (not-null)

Următorul tabel listează mai multe operațiuni acceptate pentru fiecare tip de atribut:

Tip atribut Operațiuni acceptate
BigInt, zecimal, dublu, întreg Mai mare decât (gt)
Mai mare sau egal cu (gte)
Mai mic decât (lt)
Mai mic sau egal cu (lte)
Boolean, client În (in)
Nu este în (not-in)
EntityName, Selector, Stare, Stare Like (like)
Nu îmi place (not-like)
Începe cu (begins-with)
Nu începe cu (not-begin-with)
Se termină cu (ends-with)
Nu se termină cu (not-end-with)
În (in)
Nu este în (not-in)
GUID, Căutare În (in)
Nu este în (not-in)
Este egal cu ID-ul de utilizator (eq-userid)
Nu este egal cu ID-ul de utilizator (ne-userid)
Money Mai mare decât (gt)
Mai mare sau egal cu (gte)
Mai mic decât (lt)
Mai mic sau egal cu (lte)
În (in)
Nu este în (not-in)
Proprietar În (in)
Nu este în (not-in)
Este egal cu ID-ul de utilizator (eq-userid)
Nu este egal cu ID-ul de utilizator (ne-userid)
Este egal cu utilizatorul sau echipa (eq-useroruserteams)
Șir Like (like)
Nu îmi place (not-like)
Începe cu (begins-with)
Nu începe cu (not-begin-with)
Se termină cu (ends-with)
Nu se termină cu (not-end-with)
DateTime La Sau după (on-or-after)
La (on)
La sau înainte (on-or-before)
Astăzi (today)
Mâine (tomorrow)
Ieri (yesterday)
Următoarele șapte zile (next-seven-days)
Ultimele șapte zile (last-seven-days)
Săptămâna viitoare (next-week)
Săptămâna trecută (last-week)
Săptămâna aceasta (this-week)
Luna următoare (next-month)
Luna trecută (last-month)
Luna aceasta (this-month)
Anul următor (next-year)
Anul trecut (last-year)
Anul acesta (this-year)
Ultimele X zile (last-x-days)
Următoarele X zile (next-x-days)
Ultimele X săptămâni (last-x-weeks)
Următoarele X săptămâni (next-x-weeks)
Ultimele X luni (last-x-months)
Următoarele X luni (next-x-months)
Ultimii X ani (last-x-years)
Următorii X ani (next-x-years)
Mai mare decât (gt)
Mai mare sau egal (gte)
Mai mic decât (lt)
Mai mic sau egal (lte)

Exemple

Puteți utiliza metoda retrieveMultipleRecords pentru a obține majoritatea scenariilor și exemplelor menționate în Datele de interogare utilizând API-ul web. Unele dintre exemple sunt listate în secțiunea următoare.

Regăsire de bază multiplă

Acest exemplu interoghează setul de tabele de conturi și utilizează $select opțiunile de interogare de sistem pentru $top a returna proprietatea nume pentru primele trei conturi:

Xrm.WebApi.retrieveMultipleRecords("account", "?$select=name&$top=3").then(
    function success(result) {
        for (var i = 0; i < result.entities.length; i++) {
            console.log(result.entities[i]);
        }                    
        // perform additional operations on retrieved records
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Basic retrieve multiple with FetchXML

Acest exemplu interoghează entitatea account utilizând preluareXML.

var fetchXml = "?fetchXml=<fetch><entity name='account'><attribute name='accountid'/><attribute name='name'/></entity></fetch>";

Xrm.WebApi.retrieveMultipleRecords("account", fetchXml).then(
    function success(result) {
        for (var i = 0; i < result.entities.length; i++) {
            console.log(result.entities[i]);
        }                    

        // perform additional operations on retrieved records
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Regăsiți sau filtrați după proprietățile de căutare

Pentru majoritatea proprietăților de navigare cu valoare unică, găsiți o proprietate calculată, doar în citire care utilizează următoarea convenție de denumire: _<name>_value unde <name> este numele proprietății de navigare cu valoare unică. În scopuri de filtrare, puteți utiliza, de asemenea, valoarea specifică a proprietății de navigare cu valoare unică. Totuși, aceste opțiuni de sintaxă nu sunt acceptate pentru clienții mobili în modul offline. Utilizați numele proprietății de navigare cu valori unice pentru regăsirea și filtrarea. De asemenea, modul offline nu acceptă compararea proprietăților de navigare la null.

Mai multe informații: Proprietăți de căutare

Iată exemple de cod pentru ambele scenarii:

Pentru scenariul online (conectat la server)

Acest exemplu interoghează setul de conturi și utilizează $select opțiunile de interogare de sistem pentru $filter a returna proprietatea nume și contactid primară pentru conturile care au o anumită persoană de contact principală:

Xrm.WebApi.retrieveMultipleRecords("account", "?$select=name,_primarycontactid_value&$filter=primarycontactid/contactid eq a0dbf27c-8efb-e511-80d2-00155db07c77").then(
    function success(result) {
        for (var i = 0; i < result.entities.length; i++) {
            console.log(result.entities[i]);
        }                    
        // perform additional operations on retrieved records
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Scenariul pentru dispozitive mobile offline

Acest exemplu interoghează setul de conturi și utilizează $select opțiunile de interogare de sistem pentru $filter a returna proprietatea nume și contactid primară pentru conturile care au o anumită persoană de contact principală atunci când lucrați în modul offline:

Xrm.WebApi.retrieveMultipleRecords("account", "?$select=name,primarycontactid&$filter=primarycontactid eq a0dbf27c-8efb-e511-80d2-00155db07c77").then(
    function success(result) {
        for (var i = 0; i < result.entities.length; i++) {
            console.log(result.entities[i]);
        }                    
        // perform additional operations on retrieved records
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Utilizarea FetchXML pentru a regăsi sau a filtra după proprietățile de căutare (scenariu online și offline)

Utilizați parametrul FetchXML în timp ce sunteți online sau offline pentru a regăsi înregistrările name și primarycontactid proprietatea pentru înregistrările contului care au o persoană de contact principală care se potrivește cu o condiție:

var fetchXml = `?fetchXml=
    <fetch>
       <entity name='account'>
          <attribute name='name'/>
          <attribute name='primarycontactid'/>
          <link-entity name='contact' from='contactid' to='primarycontactid'>
             <filter type='and'>
                <condition attribute='lastname' operator='eq' value='Contoso'/>
             </filter>
          </link-entity>
       </entity>
    </fetch>`;

Xrm.WebApi.retrieveMultipleRecords("account", fetchXml).then(
    function success(result) {
        for (var i = 0; i < result.entities.length; i++) {
            console.log(result.entities[i]);
        }                    

        // perform additional operations on retrieved records
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Specificați numărul de tabele de returnat într-o pagină

Următorul exemplu arată cum să utilizați parametrul pentru a specifica maxPageSize faptul că fiecare pagină afișează trei înregistrări.

Xrm.WebApi.retrieveMultipleRecords("account", "?$select=name", 3).then(
    function success(result) {
        for (var i = 0; i < result.entities.length; i++) {
            console.log(result.entities[i]);
        }
        console.log("Next page link: " + result.nextLink);
        // perform additional operations on retrieved records
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Acest exemplu afișează trei înregistrări și un link la pagina următoare. Iată un exemplu de ieșire din consolă în instrumentele pentru dezvoltatorii browserului:

{@odata.etag: "W/"1035541"", name: "A. Datum", accountid: "475b158c-541c-e511-80d3-3863bb347ba8"}
@odata.etag: "W/"1035541""accountid: "475b158c-541c-e511-80d3-3863bb347ba8"name: "A. Datum"__proto__: Object
VM5595:4 
{@odata.etag: "W/"947306"", name: "Adventure Works", accountid: "a8a19cdd-88df-e311-b8e5-6c3be5a8b200"}
VM5595:4 
{@odata.etag: "W/"1033754"", name: "Alpine Ski House", accountid: "aaa19cdd-88df-e311-b8e5-6c3be5a8b200"}
VM5595:6 
Next page link: [Organization URI]/api/data/v9.0/accounts?$select=name&$skiptoken=%3Ccookie%20pagenumber=%222%22%20pagingcookie=%22%253ccookie%2520page%253d%25221%2522%253e%253caccountid%2520last%253d%2522%257bAAA19CDD-88DF-E311-B8E5-6C3BE5A8B200%257d%2522%2520first%253d%2522%257b475B158C-541C-E511-80D3-3863BB347BA8%257d%2522%2520%252f%253e%253c%252fcookie%253e%22%20istracking=%22False%22%20/%3E

Utilizați partea de interogare din URL-ul din nextLink proprietate ca valoare pentru parametrul din următorul apel RetrieveMultipleRecords pentru options a solicita următorul set de înregistrări. Nu modificați și nu adăugați alte opțiuni de interogare de sistem la valoare. Pentru fiecare solicitare ulterioară pentru mai multe pagini, utilizați aceeași maxPageSize valoare utilizată în solicitarea inițială regăsiți mai multe. De asemenea, memorați în cache rezultatele returnate sau valoarea proprietății nextLink , astfel încât aplicația să poată returna paginile regăsite anterior.

De exemplu, pentru a obține următoarea pagină de înregistrări, transmiteți partea de interogare a URL-ului nextLinkoptions la parametru:

Xrm.WebApi.retrieveMultipleRecords("account", "?$select=name&$skiptoken=%3Ccookie%20pagenumber=%222%22%20pagingcookie=%22%253ccookie%2520page%253d%25221%2522%253e%253caccountid%2520last%253d%2522%257bAAA19CDD-88DF-E311-B8E5-6C3BE5A8B200%257d%2522%2520first%253d%2522%257b475B158C-541C-E511-80D3-3863BB347BA8%257d%2522%2520%252f%253e%253c%252fcookie%253e%22%20istracking=%22False%22%20/%3E", 3).then(
    function success(result) {
        for (var i = 0; i < result.entities.length; i++) {
            console.log(result.entities[i]);
        }
        console.log("Next page link: " + result.nextLink);
        // perform additional operations on retrieved records
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Această solicitare returnează următoarea pagină a setului de rezultate.

{@odata.etag: "W/"1035542"", name: "Blue Yonder Airlines", accountid: "aca19cdd-88df-e311-b8e5-6c3be5a8b200"}
VM5597:4 
{@odata.etag: "W/"1031348"", name: "City Power & Light", accountid: "aea19cdd-88df-e311-b8e5-6c3be5a8b200"}
VM5597:4 
{@odata.etag: "W/"1035543"", name: "Coho Winery", accountid: "b0a19cdd-88df-e311-b8e5-6c3be5a8b200"}
VM5597:6 
Next page link: [Organization URI]/api/data/v9.0/accounts?$select=name&$skiptoken=%3Ccookie%20pagenumber=%223%22%20pagingcookie=%22%253ccookie%2520page%253d%25222%2522%253e%253caccountid%2520last%253d%2522%257bB0A19CDD-88DF-E311-B8E5-6C3BE5A8B200%257d%2522%2520first%253d%2522%257bACA19CDD-88DF-E311-B8E5-6C3BE5A8B200%257d%2522%2520%252f%253e%253c%252fcookie%253e%22%20istracking=%22False%22%20/%3E

Important

Valoarea proprietății nextLink este codificată CU URI. Dacă URI codifică valoarea înainte de a o trimite, informațiile despre modulul cookie XML din URL provoacă o eroare.

Exemplu preluareXML (scenariu online)

Următorul exemplu vă arată cum să utilizați count parametrul din FetchXML pentru a specifica faptul că fiecare pagină afișează trei înregistrări.

Notă

Modulul cookie de paginare PreluareXML este returnat doar pentru operațiuni online retrieveMultipleRecords . (Xrm.WebApi.online). Nu este acceptat offline.

var fetchXml = "?fetchXml=<fetch count='3'><entity name='account'><attribute name='accountid'/><attribute name='name'/></entity></fetch>";

Xrm.WebApi.online.retrieveMultipleRecords("account", fetchXml).then(
    function success(result) {
        for (var i = 0; i < result.entities.length; i++) {
            console.log(result.entities[i]);
        }          

        console.log("Paging cookie: " + result.fetchXmlPagingCookie);

        // perform additional operations on retrieved records
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Acest exemplu afișează trei înregistrări și returnează un modul cookie de paginare FetchXML pentru a regăsi rezultatele paginii următoare dacă există mai multe înregistrări în setul de rezultate. Iată un exemplu de ieșire din consolă în instrumentele pentru dezvoltatorii browserului:

{
   "entities": [
      {
         "@odata.etag": "W/\"1035542\"",
         "accountid": "aca19cdd-88df-e311-b8e5-6c3be5a8b200",
         "name": "Blue Yonder Airlines"
      },
      {
         "@odata.etag": "W/\"1031348\"",
         "accountid": "aea19cdd-88df-e311-b8e5-6c3be5a8b200",
         "name": "City Power & Light"
      },
      {
         "@odata.etag": "W/\"1035543\"",
         "accountid": "b0a19cdd-88df-e311-b8e5-6c3be5a8b200",
         "name": "Coho Winery"
      }
   ],
   "fetchXmlPagingCookie": "<cookie pagenumber=\"2\" pagingcookie=\"%253ccookie%2520page%253d%25221%2522%253e%253caccountid%2520last%253d%2522%257b0748C6EC-55A8-EB11-B1B5-000D3AFEF6FA%257d%2522%2520first%253d%2522%257bFC47C6EC-55A8-EB11-B1B5-000D3AFEF6FA%257d%2522%2520%252f%253e%253c%252fcookie%253e\" istracking=\"False\" />"
}

Pentru a prelua seturi mari de rezultate cu paginare, utilizați fetchXmlPagingCookie așa cum se arată în exemplul următor.

function CreateXml(fetchXml, pagingCookie, page, count) {
  var domParser = new DOMParser();
  var xmlSerializer = new XMLSerializer();

  var fetchXmlDocument = domParser.parseFromString(fetchXml, "text/xml");

  if (page) {
    fetchXmlDocument
      .getElementsByTagName("fetch")[0]
      .setAttribute("page", page.toString());
  }

  if (count) {
    fetchXmlDocument
      .getElementsByTagName("fetch")[0]
      .setAttribute("count", count.toString());
  }

  if (pagingCookie) {
    var cookieDoc = domParser.parseFromString(pagingCookie, "text/xml");
    var innerPagingCookie = domParser.parseFromString(
      decodeURIComponent(
        decodeURIComponent(
          cookieDoc
            .getElementsByTagName("cookie")[0]
            .getAttribute("pagingcookie")
        )
      ),
      "text/xml"
    );
    fetchXmlDocument
      .getElementsByTagName("fetch")[0]
      .setAttribute(
        "paging-cookie",
        xmlSerializer.serializeToString(innerPagingCookie)
      );
  }

  return xmlSerializer.serializeToString(fetchXmlDocument);
}

function retrieveAllRecords(entityName, fetchXml, page, count, pagingCookie) {
  if (!page) {
    page = 0;
  }

  return retrievePage(entityName, fetchXml, page + 1, count, pagingCookie).then(
    function success(pageResults) {
      if (pageResults.fetchXmlPagingCookie) {
        return retrieveAllRecords(
          entityName,
          fetchXml,
          page + 1,
          count,
          pageResults.fetchXmlPagingCookie
        ).then(
          function success(results) {
            if (results) {
              return pageResults.entities.concat(results);
            }
          },
          function error(e) {
            throw e;
          }
        );
      } else {
        return pageResults.entities;
      }
    },
    function error(e) {
      throw e;
    }
  );
}

function retrievePage(entityName, fetchXml, pageNumber, count, pagingCookie) {
  var fetchXml =
    "?fetchXml=" + CreateXml(fetchXml, pagingCookie, pageNumber, count);

  return Xrm.WebApi.online.retrieveMultipleRecords(entityName, fetchXml).then(
    function success(result) {
      return result;
    },
    function error(e) {
      throw e;
    }
  );
}

var count = 3;
var fetchXml =
  '<fetch><entity name="account"><attribute name="accountid"/><attribute name="name"/></entity></fetch>';

retrieveAllRecords("account", fetchXml, null, count, null).then(
  function success(result) {
    console.log(result);

    // perform additional operations on retrieved records
  },
  function error(error) {
    console.log(error.message);
    // handle error conditions
  }
);

Utilizați opțiunea de interogare de sistem $expand din proprietățile de navigare pentru a controla datele care se returnează din tabelele asociate. Următorul exemplu vă arată cum să regăsiți persoana de contact pentru toate înregistrările contului. Pentru înregistrările de persoane de contact asociate, regăsiți doar câmpurile contactid și fullname :

Xrm.WebApi.retrieveMultipleRecords("account", "?$select=name&$top=3&$expand=primarycontactid($select=contactid,fullname)", 3).then(
    function success(result) {
        for (var i = 0; i < result.entities.length; i++) {
            console.log(result.entities[i]);
        }        
        // perform additional operations on retrieved records
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Codul precedent returnează un rezultat cu o schemă, cum ar fi:

{
   "entities": [
      {
         "@odata.etag": "W/\"1459919\"",
         "name": "Test Account",
         "accountid": "119edfac-19c6-ea11-a81a-000d3af5e732",
         "primarycontactid": {
            "contactid": "6c63a1b7-19c6-ea11-a81a-000d3af5e732",
            "fullname": "Test Contact"
         }
      }
   ]
}

Notă

Similar cu scenariul online, utilizați opțiunea de interogare de sistem $expand pentru a regăsi date din tabelele asociate offline. Totuși, relațiile mai-mulți-la-mai-mulți nu sunt acceptate în offline.

Metodă perimată pentru scenariul mobil offline

Notă

Este @odata.nextLink perimat pentru scenariile mobile offline. Deși este încă acceptat pentru particularizările existente, nu-l mai utilizați.

O operațiune de $expand offline returnează o @odata.nextLink adnotare care conține informații despre cum să ajungeți la informațiile înregistrării asociate. idUtilizați parametrii , entityTypeși options parametrii adnotării pentru a construi una sau mai multe solicitări suplimentareXrm.WebApi.offline.retrieveRecord. Următorul cod oferă un exemplu complet despre cum să procedați:

Xrm.WebApi.offline.retrieveMultipleRecords("account", "?$select=name&$top=3&$expand=primarycontactid($select=contactid,fullname)").then(function(resultSet) {
    /**
     *  resultSet has a structure like:
     *  {
     *      "entities": [
     *          {
     *              "accountid": "119edfac-19c6-ea11-a81a-000d3af5e732",
     *              "name": "Test Account",
     *              "primarycontactid@odata.nextLink": {
     *                  "API": "{Xrm.Mobile.offline}.{retrieveRecord}",
     *                  "id": "119edfac-19c6-ea11-a81a-000d3af5e732",
     *                  "entityType": "account",
     *                  "options": "?$select=accountid&$expand=primarycontactid($select=contactid,fullname)&$getOnlyRelatedEntity=true"
     *              },
     *              "primarycontactid": {}
     *          }
     *      ]
     *  }
     *
     *  Notice the empty `primarycontactid` property but an additional `primarycontactid@odata.nextLink` 
     *  annotation that lets us know how to get to the linked data that we need.
     **/

    var promises = resultSet.entities.map(function(outerItem) {
        // We do a retrieveRecord() for every item in the result set of retrieveMultipleRecords() and then
        // combine the results into the retrieveMultipleRecords() result set itself.
       return Xrm.WebApi.offline.retrieveRecord(
           outerItem["primarycontactid@odata.nextLink"].entityType, 
           outerItem["primarycontactid@odata.nextLink"].id,
           outerItem["primarycontactid@odata.nextLink"].options
        ).then(function(innerResult) {            
            if (innerResult.value.length === 0) {
                return outerItem;
            }
            outerItem.primarycontactid = innerResult.value[0];
            return outerItem;
        });
    });

    return Promise.all(promises);
}).then(function(allResults) {
    for (var i = 0; i < allResults.length; i++) {
        console.log(allResults[i]);
    }
    // perform additional operations on retrieved records
}, function(error) {
    console.error(error);
    // handle error conditions
});

Pentru mai multe exemple de regăsire a mai multor înregistrări utilizând API-ul web, consultați Interogarea datelor utilizând API-ul web.

Interogarea datelor utilizând API-ul web
Xrm.WebApi.retrieveRecord
Xrm.WebApi