retrieveMultipleRecords (odkaz na rozhranie API klienta)

Načíta kolekciu záznamov tabuľky.

Syntax

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

Parametre

Meno Typ Požaduje sa Popis
entityLogicalName String Áno Logický názov tabuľky záznamov, ktoré chcete načítať. Napríklad: account.
options String Nie Možnosti dotazu systému OData alebo dotaz FetchXML na načítanie údajov. Pozrite si tému Možnosti
maxPageSize Číslo Nie Zadajte kladné číslo, ktoré udáva počet záznamov tabuľky, ktoré sa majú vrátiť na stranu. Ak tento parameter nezadáte, predvolená hodnota je maximálny limit 5 000 záznamov pre štandardné tabuľky a 500 pre elastické tabuľky.

Ak je počet záznamov, ktoré načítate, vyšší ako zadaná maxPageSize hodnota alebo maximálny limit pre typ tabuľky, nextLink stĺpec vo vrátenom objekte sľubu obsahuje prepojenie na načítanie záznamov.
successCallback Function Nie Funkcia, ktorá sa zavolá pri načítavaní záznamov tabuľky. Zobraziť vrátenú hodnotu
errorCallback Function Nie Funkcia, ktorá sa volá v prípade zlyhania operácie. Odovzdá sa objekt s nasledujúcimi vlastnosťami:
- errorCode:Číslo. Kód chyby ako kladné desatinné číslo. Napríklad kód chyby zdokumentovaný ako 0x80040333 sa vráti ako 2147746611.
- message:Povrázok. Chybové hlásenie popisujúce problém.

Možnosti

Podporované sú nasledujúce možnosti systémového dotazu: $select, $top, $filter, $expanda $orderby.

Pomocou možnosti systémového $expand dotazu môžete kontrolovať, ktoré údaje zo súvisiacich tabuliek sa vrátia. Ak zahrniete len názov vlastnosti navigácie, získate všetky vlastnosti súvisiacich záznamov. Vlastnosti vrátené pre súvisiace záznamy môžete obmedziť pomocou možnosti systémového $select dotazu v zátvorkách za názvom vlastnosti navigácie. Túto možnosť použite pre vlastnosti navigácie s jednou hodnotou aj s hodnotou kolekcie . V režime offline je podporovaná len vnorená $select možnosť v rámci režimu $expand .

Ak chcete zadať dotaz FetchXML, použite tento fetchXml stĺpec na zadanie dotazu.

Nota

Vždy musíte použiť možnosť systémového $select dotazu na obmedzenie vlastností vrátených pre záznam tabuľky zahrnutím čiarkami oddeleného zoznamu názvov vlastností. Tento postup je dôležitý pre výkon. Ak nezadáte vlastnosti pomocou $select, vrátia sa všetky vlastnosti.

Zadajte možnosti dotazu začínajúce reťazcom ?. Môžete tiež zadať viacero možností systémového dotazu pomocou na & oddelenie možností dotazu.

Keď pre options parameter zadáte reťazec dotazu OData, zakódujte dotaz pre špeciálne znaky.

Keď pre options parameter zadáte dotaz FetchXML, nekódujte ho.

Informácie o definovaní parametra options pre rôzne scenáre načítania nájdete v časti Príklady.

Vrátená hodnota

Po úspešnom dokončení vráti objekt sľubu successCallback s nasledujúcimi vlastnosťami:

Meno Typ Popis
entities Pole objektov JSON Každý objekt predstavuje načítaný záznam tabuľky obsahujúci stĺpce a ich hodnoty ako key: value páry. ID záznamu tabuľky sa predvolene načíta.
nextLink String (voliteľné) Ak je počet načítaných záznamov vyšší ako hodnota zadaná v maxPageSize parametri v požiadavke, vráti sa URL adresa, ktorá vráti nasledujúcu stránku záznamov.
fetchXmlPagingCookie (voliteľné) Pre operáciu založená na retrieveMultipleRecords jazyku fetchXml so stránkovaním, kde je celkový počet záznamov väčší ako hodnota stránkovania, tento atribút vráti stránkovací súbor cookie, ktorý možno použiť na následnú operáciu jazyka fetchXml na načítanie ďalšej stránky záznamov.

Nepodporované typy atribútov pre možnosti dotazu OData v mobilnom režime offline

Nasledujúce typy stĺpcov nie sú podporované, ak používate Xrm.WebApi.retrieveMultipleRecords s možnosťami reťazca dotazu OData (napríklad $select a $filter) v režime mobilnej offline. Jazyk FetchXML použite, ak potrebujete pracovať s typom atribútu v tomto zozname nepodporovaných typov atribútov.

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

Nepodporované funkcie v mobilnej režime offline

Nasledujúce funkcie nie sú podporované v režime mobile offline:

  • Funkcie zoskupenia a agregácie

Podporované operácie filtrovania podľa typu atribútu v mobilnej režime offline pomocou jazyka FetchXML

Pri práci s jazykom FetchXML sú podporované nasledujúce operácie pre všetky typy atribútov:

  • Rovná sa (eq)
  • Nerovná sa (neq)
  • Hodnota Null (null)
  • Not Null (not-null)

Nasledujúca tabuľka obsahuje zoznam ďalších operácií podporovaných pre každý typ atribútu:

Typ atribútu Podporované operácie
BigInt, Decimal, Double, Integer Väčšie ako (gt)
Väčšie ako alebo rovná sa (gte)
Menšie ako (lt)
Menšie ako alebo rovná sa (lte)
Booleovská hodnota, zákazník In (in)
Nie je in (not-in)
EntityName, Picklist, State, Status Páči sa mi to (like)
Nie ako (not-like)
Začína na (begins-with)
Nezačína sa na (not-begin-with)
Končí na (ends-with)
Nekončí sa na (not-end-with)
In (in)
Nie je in (not-in)
Guid, Lookup In (in)
Nie je in (not-in)
Rovná sa IDENTIFIKÁCIA používateľa (eq-userid)
Nerovná sa ID používateľa (ne-userid)
Peniaze Väčšie ako (gt)
Väčšie ako alebo rovná sa (gte)
Menšie ako (lt)
Menšie ako alebo rovná sa (lte)
In (in)
Nie je in (not-in)
Vlastník In (in)
Nie je in (not-in)
Rovná sa IDENTIFIKÁCIA používateľa (eq-userid)
Nerovná sa ID používateľa (ne-userid)
Rovná sa používateľovi alebo tímu (eq-useroruserteams)
String Páči sa mi to (like)
Nie ako (not-like)
Začína na (begins-with)
Nezačína sa na (not-begin-with)
Končí na (ends-with)
Nekončí sa na (not-end-with)
Dátum a čas Dňa alebo neskôr (on-or-after)
Zapnuté (on)
On alebo Before (on-or-before)
Dnes (today)
Zajtra (tomorrow)
Včera (yesterday)
Nasledujúcich sedem dní (next-seven-days)
Posledných sedem dní (last-seven-days)
Budúci týždeň (next-week)
Posledný týždeň (last-week)
Tento týždeň (this-week)
Nasledujúci mesiac (next-month)
Posledný mesiac (last-month)
Tento mesiac (this-month)
Nasledujúci rok (next-year)
Minulý rok (last-year)
Tento rok (this-year)
Posledných X dní (last-x-days)
Nasledujúcich X dní (next-x-days)
Posledné X týždne (last-x-weeks)
Nasledujúce X týždne (next-x-weeks)
Posledné X mesiace (last-x-months)
Nasledujúcich X mesiacov (next-x-months)
Posledné X roky (last-x-years)
Nasledujúce X roky (next-x-years)
Väčšie ako (gt)
Väčšie ako alebo rovná sa (gte)
Menšie ako (lt)
Menšie ako alebo rovná sa (lte)

Príklady

Na dosiahnutie väčšiny scenárov a príkladov uvedených v časti Údaje dotazu pomocou webového rozhrania API môžete použiť metódu retrieveMultipleRecords. Niektoré z príkladov sú uvedené v nasledujúcej časti.

Základné načítanie viacerých

Tento príklad dotazuje množinu tabuľky kont a používa možnosti systémových $select$top dotazov na vrátenie vlastnosti názvu prvých troch kont:

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
    }
);

Základné načítanie viacerých pomocou jazyka FetchXML

Tento príklad dotazuje entitu account pomocou jazyka fetchXML.

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
    }
);

Načítanie alebo filtrovanie podľa vlastností vyhľadávania

Vo väčšine vlastností navigácie s jednou hodnotou nájdete vypočítanú vlastnosť iba na čítanie, ktorá používa nasledujúcu konvenciu pomenovania: _<name>_value kde <name> je názov vlastnosti navigácie s jednou hodnotou. Na účely filtrovania môžete použiť aj konkrétnu hodnotu vlastnosti navigácie s jednou hodnotou. Tieto možnosti syntaxe však nie sú podporované pre mobilných klientov v režime offline. Na načítanie aj filtrovanie použite názov vlastnosti navigácie s jednou hodnotou. Režim offline tiež nepodporuje porovnanie vlastností navigácie s hodnotou null.

Ďalšie informácie: Vlastnosti vyhľadávania

Tu sú príklady kódu pre oba scenáre:

Scenár online (pripojený k serveru)

Tento príklad dotazuje množinu tabuliek kont a používa $select$filter možnosti systémových dotazov na vrátenie názvu a vlastnosti primarycontactid pre kontá, ktoré majú konkrétny primárny kontakt:

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
    }
);

Scenár pre mobilné režimy offline

Tento príklad dotazuje množinu tabuliek kont a používa $select$filter možnosti systémových dotazov na vrátenie názvu a vlastnosti primarycontactid pre kontá, ktoré majú konkrétny primárny kontakt pri práci v režime 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
    }
);

Načítanie alebo filtrovanie pomocou jazyka FetchXML podľa vlastností vyhľadávania (scenár online a offline)

Použite parameter počas režimu FetchXML online alebo offline na načítanie name vlastnosti a primarycontactid pre záznamy konta, ktoré majú primárny kontakt, ktorý spĺňa podmienku:

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
    }
);

Zadanie počtu tabuliek, ktoré sa majú vrátiť na strane

V nasledujúcom príklade maxPageSize je uvedené, ako používať parameter na určenie, že každá strana zobrazí tri záznamy.

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
    }
);

Tento príklad zobrazuje tri záznamy a prepojenie na nasledujúcu stránku. Tu je príklad výstupu z konzoly v nástrojoch vývojárov prehliadača:

{@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

Použite časť dotazu v URL adrese vo nextLink vlastnosti ako hodnotu options parametra v ďalšom volaní na načítanie hodnoty retrieveMultipleRecords a požiadajte o ďalšiu množinu záznamov. Nemeňte ani nepridávajte k hodnote žiadne ďalšie možnosti systémových dotazov. Pre každú nasledujúcu požiadavku na viac strán použite rovnakú hodnotu, ktorú maxPageSize ste použili v pôvodnej žiadosti na načítanie viacerých strán. Do vyrovnávacej pamäte tiež zadajte vrátené výsledky alebo hodnotu nextLink vlastnosti, takže aplikácia môže vrátiť predtým načítané stránky.

Ak chcete napríklad získať ďalšiu stránku záznamov, odovzdajte časť nextLink dotazu URL adresy do parametra options :

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
    }
);

Táto žiadosť vráti nasledujúcu stranu množiny výsledkov.

{@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

Dôležité

Hodnota nextLink vlastnosti je kódovaná použitím identifikátora URI. Ak URI kódujete hodnotu pred odoslaním, informácie XML v URL adrese spôsobia chybu.

Príklad jazyka FetchXML (online scenár)

V nasledujúcom príklade je uvedené, ako používať parameter v jazyku count FetchXML na určenie toho, že každá strana zobrazuje tri záznamy.

Nota

Stránkovací súbor cookie FetchXML sa vráti len pre online retrieveMultipleRecords operácie. (Xrm.WebApi.online). Nie je podporovaný 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
    }
);

V tomto príklade sa zobrazujú tri záznamy a vráti stránkovací súbor cookie FetchXML, ktorý načíta výsledky ďalšej stránky v prípade, že sa v množine výsledkov nachádza viac záznamov. Tu je príklad výstupu z konzoly v nástrojoch vývojárov prehliadača:

{
   "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\" />"
}

Ak chcete načítať veľké množiny výsledkov so stránkovaním, použite metódu fetchXmlPagingCookie ako je znázornené v nasledujúcom príklade.

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
  }
);

Pomocou možnosti systémového dotazu $expand vo vlastnostiach navigácie môžete ovládať údaje, ktoré sa vrátia zo súvisiacich tabuliek. Nasledujúci príklad ukazuje, ako načítať kontakt pre všetky záznamy konta. V prípade súvisiacich záznamov kontaktov načítate iba contactid polia a 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
    }
);

Predchádzajúci kód vráti výsledok so schémou, ako napríklad:

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

Nota

Podobne ako v prípade online môžete načítať údaje zo súvisiacich tabuliek v režime offline pomocou možnosti $expand systémového dotazu. Vzťahy typu many-to-many však nie sú podporované v režime offline.

Zastaraná metóda pre scenár mobilnej offline

Nota

Je @odata.nextLink zastaraný pre mobilné offline scenáre. Hoci je v prípade existujúcich prispôsobení naďalej podporovaný, už ju nepoužívajte.

Operácia offline $expand vráti @odata.nextLink komentár obsahujúci informácie o tom, ako sa dostať k informáciám súvisiaceho záznamu. idPomocou parametrov , entityTypea options tohto komentára vytvorte jednu alebo viacero ďalších Xrm.WebApi.offline.retrieveRecord požiadaviek. Nasledujúci kód obsahuje úplný príklad toho, ako na to:

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
});

Ďalšie príklady načítania viacerých záznamov pomocou webového rozhrania API nájdete v téme Údaje dotazu pomocou webového rozhrania API.

Dotazovanie údajov pomocou webového rozhrania API
Xrm.WebApi.retrieveRecord
Xrm.WebApi