retrieveMultipleRecords (klienta API atsauce)

Izgūst tabulas ierakstu kolekciju.

Sintakse

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

Parameters

Vārds Tips Obligāti Apraksts
entityLogicalName String Jā Izgūstamo ierakstu tabulas loģiskais nosaukums. Piemēram, account.
options String Nē OData sistēmas vaicājuma opcijas vai FetchXML vaicājums, lai izgūtu datus. Skatīt opcijas
maxPageSize Numurs Nē Norādiet pozitīvu skaitli, kas norāda, cik daudz tabulas ierakstu jāatgriež katrā lapā. Ja šo parametru nenorādāt, noklusējuma vērtība ir maksimālais limits – 5 000 ieraksti standarta tabulām un 500 elastīgajām tabulām.

Ja izgūto ierakstu skaits pārsniedz norādīto maxPageSize vērtību vai maksimālo tabulas tipa limitu, nextLink kolonnā atgrieztajā solījuma objektā ir saite ierakstu iegūšanai.
successCallback Function Nē Funkcija, kas jāizsauc, kad tiek izgūti tabulas ieraksti. Skatīt atgriezto vērtību
errorCallback Function Nē Funkcija, kas jāizsauc, ja operācija neizdodas. Tiek nodots objekts ar šādām īpašībām:
- errorCode:Skaitlis. Kļūdas kods kā pozitīvs decimālskaitlis. Piemēram, kļūdas kods, kas dokumentēts kā 0x80040333 , tiks atgriezts kā 2147746611.
- message:Virkne. Kļūdas ziņojums, kurā aprakstīta problēma.

Opcijas

Tiek atbalstītas šādas sistēmas vaicājumu opcijas: $select, , , $top$filter, un $expand$orderby.

Izmantojiet sistēmas vaicājuma $expand opciju, lai kontrolētu, kādi dati no saistītajām tabulām tiek atgriezti. Ja iekļaujat tikai navigācijas rekvizīta nosaukumu, tiek parādīti visi saistīto ierakstu rekvizīti. Jūs varat ierobežot saistīto ierakstu atgrieztās īpašības, izmantojot $select sistēmas vaicājuma opciju iekavās pēc navigācijas īpašības nosaukuma. Izmantojiet šo opciju gan vienas vērtības , gan kolekcijas vērtības navigācijas īpašumiem. Bezsaistē tiek atbalstīta tikai iebūvētā $select opcija $expand .

Lai norādītu FetchXML vaicājumu, izmantojiet fetchXml kolonnu, lai norādītu vaicājumu.

Piezīmes

Jums vienmēr jāizmanto sistēmas vaicājuma opcija, $select lai ierobežotu atgriežamās īpašības tabulas ierakstam, iekļaujot komatos atdalītu īpašību nosaukumu sarakstu. Šī prakse ir svarīga veiktspējai. Ja īpašības netiek norādītas, izmantojot $select, visas īpašības tiek atgrieztas.

Norādiet vaicājuma opcijas, kas sākas ar ?. Varat arī norādīt vairākas sistēmas vaicājuma opcijas, izmantojot & vaicājuma opciju atdalīšanu.

Kad norādāt OData vaicājuma virkni parametram options , kodējiet vaicājumu speciālajiem simboliem.

Kad norādāt FetchXML vaicājumu parametram options , nekodējiet vaicājumu.

Lai uzzinātu, kā definēt parametru options dažādiem scenārijiem, skatīt Piemēri.

Atgrieztā vērtība

Ja tas ir veiksmīgs, atgriež solījuma objektu successCallback ar šādiem rekvizītiem:

Vārds Tips Apraksts
entities JSON objektu masīvs Katrs objekts attēlo izgūto tabulas ierakstu, kas satur kolonnas un to vērtības kā key: value pārus. Tabulas ieraksta ID tiek iegūts pēc noklusējuma.
nextLink String (pēc izvēles) Ja izgūstamo ierakstu skaits ir lielāks par pieprasījuma parametrā maxPageSize norādīto vērtību, tiek atgriezts URL, lai atgrieztu nākamo ierakstu lapu.
fetchXmlPagingCookie (pēc izvēles) Operācijai, kuras retrieveMultipleRecords pamatā ir fetchXml ar peidžeru, kur kopējais ierakstu skaits ir lielāks par peidžeru vērtību, šis atribūts atgriež peidžeru sīkfailu, ko var izmantot nākamajai fetchXml operācijai, lai izgūtu nākamo ierakstu lapu.

Neatbalstītie atribūtu tipi OData vaicājumu opcijām mobilajā bezsaistē

Šie kolonnu tipi netiek atbalstīti, ja izmantojat Xrm.WebApi.retrieveMultipleRecords OData vaicājumu virkņu opcijas (piemēram, $select un $filter) mobilajā bezsaistes režīmā. Izmantojiet FetchXML, ja nepieciešams strādāt ar atribūtu tipu šajā neatbalstīto atribūtu tipu sarakstā.

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

Neatbalstītas funkcijas mobilajā bezsaistē

Šādas funkcijas mobilajā bezsaistē netiek atbalstītas:

  • Grupēšanas un apvienošanas iezīmes

Atbalstītas filtru operācijas katram atribūtu tipam mobilajā bezsaistē, izmantojot FetchXML

Strādājot ar FetchXML, visiem atribūtu tipiem tiek atbalstītas šādas darbības:

  • Vienāds (eq)
  • Nav vienāds (neq)
  • Null (null)
  • Nav nulle (not-null)

Šajā tabulā ir uzskaitītas citas darbības, kas tiek atbalstītas katram atribūta tipam:

Atribūta tips Atbalstītās darbības
BigInt, decimāldaļa, dubultā, vesels skaitlis Lielāks par (gt)
Lielāks par vai vienāds (gte)
Mazāk nekā (lt)
Mazāks par vai vienāds ar (lte)
Būls, klients Sadaļā (in)
Nav (not-in)
Entītijas nosaukums, atlases saraksts, valsts, statuss Patīk (like)
Nav patīk (not-like)
Sākas ar (begins-with)
Nesākt ar (not-begin-with)
Beidzas ar (ends-with)
Nebeidzas ar (not-end-with)
Sadaļā (in)
Nav (not-in)
Guid, uzmeklēšana Sadaļā (in)
Nav (not-in)
Vienāds ar lietotāja ID (eq-userid)
Nav vienāds ar lietotāja ID (ne-userid)
Nauda Lielāks par (gt)
Lielāks par vai vienāds (gte)
Mazāk nekā (lt)
Mazāks par vai vienāds ar (lte)
Sadaļā (in)
Nav (not-in)
Īpašnieks Sadaļā (in)
Nav (not-in)
Vienāds ar lietotāja ID (eq-userid)
Nav vienāds ar lietotāja ID (ne-userid)
Vienāds ar lietotāju vai darba grupu (eq-useroruserteams)
String Patīk (like)
Nav patīk (not-like)
Sākas ar (begins-with)
Nesākt ar (not-begin-with)
Beidzas ar (ends-with)
Nebeidzas ar (not-end-with)
Datums un laiks Uz vai pēc (on-or-after)
Ieslēgts (on)
Uz vai pirms (on-or-before)
Šodien (today)
Rīt (tomorrow)
Vakar (yesterday)
Nākamās septiņas dienas (next-seven-days)
Pēdējās septiņas dienas (last-seven-days)
Nākamnedēļ (next-week)
Pagājušajā nedēļā (last-week)
Šonedēļ (this-week)
Nākamais mēnesis (next-month)
Pagājušajā mēnesī (last-month)
Šajā mēnesī (this-month)
Nākamais gads (next-year)
Pagājušajā gadā (last-year)
Šogad (this-year)
Pēdējās X dienas (last-x-days)
Nākamās X dienas (next-x-days)
Pēdējās X nedēļas (last-x-weeks)
Nākamās X nedēļas (next-x-weeks)
Pēdējie X mēneši (last-x-months)
Nākamie X mēneši (next-x-months)
Pēdējie X gadi (last-x-years)
Nākamie X gadi (next-x-years)
Lielāks par (gt)
Lielāks par vai vienāds (gte)
Mazāk nekā (lt)
Mazāks par vai vienāds (lte)

Piemēri

Jūs varat izmantot retrieveMultipleRecords metodi, lai sasniegtu lielāko daļu scenāriju un piemēru, kas minēti vaicājumu datos, izmantojot Web API. Daži piemēri ir uzskaitīti nākamajā sadaļā.

Pamata izgūšana vairākos

Šajā piemērā tiek vaicāts kontu tabulas kopai un tiek izmantotas opcijas un $select sistēmas vaicājums$top, lai atgrieztu rekvizītu nosaukums pirmajiem trim kontiem:

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

Pamata izgūšana ar FetchXML

Šajā piemērā tiek vaicāts entītijai, account izmantojot 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
    }
);

Izgūt vai filtrēt pēc uzmeklēšanas rekvizītiem

Lielākajai daļai vienas vērtības navigācijas īpašību ir aprēķināta, tikai lasāma īpašība, kas izmanto šādu nosaukumu konvenciju: _<name>_value kur ir <name> vienas vērtības navigācijas īpašības nosaukums. Filtrēšanas nolūkos varat izmantot arī konkrētās vienas vērtības navigācijas īpašības vērtību. Tomēr šīs sintakses opcijas nav atbalstītas mobilajiem klientiem bezsaistes režīmā. Izmantojiet vienas vērtības navigācijas īpašības nosaukumu gan izgūšanai, gan filtrēšanai. Turklāt bezsaistes režīms neatbalsta navigācijas īpašību salīdzināšanu ar null.

Papildinformācija: Uzmeklēšanas rekvizīti

Šeit ir koda piemēri abiem scenārijiem:

Tiešsaistes scenārijam (izveidots savienojums ar serveri)

Šajā piemērā tiek vaicāts kontu tabulas kopai un tiek izmantotas sistēmas $select vaicājuma opcijas, $filter lai atgrieztu nosaukumu un primāro rekvizītu ContactID kontiem, kuriem ir noteikta primārā kontaktpersona:

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

Mobile Offline scenārijam

Šis piemērs vaicā kontu tabulas kopu un izmanto un sistēmas vaicājuma opcijas, $select$filter lai atgrieztu nosaukumu un primāro kontaktID īpašību kontiem, kuriem ir konkrēts primārais kontakts, strādājot bezsaistes režīmā:

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

FetchXML izmantošana, lai izgūtu vai filtrētu pēc uzmeklēšanas rekvizītiem (tiešsaistes un bezsaistes scenārijs)

Izmantojiet šo parametru FetchXML tiešsaistē vai bezsaistē, lai iegūtu name un primarycontactid īpašību kontu ierakstiem, kuru primārais kontakts atbilst konkrētam nosacījumam:

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

Lappusē atgriezamo tabulu skaita norādīšana

Nākamais piemērs parāda, kā izmantot parametru maxPageSize , lai norādītu, ka katrā lapā tiek rādīti trīs ieraksti.

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

Šajā piemērā redzami trīs ieraksti un saite uz nākamo lapu. Šeit ir piemērs izvades no konsoles pārlūkprogrammas izstrādātāju rīkos:

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

Izmantojiet vaicājuma daļu URL īpašībā nextLink kā parametra vērtību options nākamajā retrieveMultipleRecords izsaukumā, lai pieprasītu nākamo ierakstu kopu. Nemaini un nepievieno papildu sistēmas vaicājumu opcijas vērtībai. Katram nākamajam pieprasījumam pēc papildu lapām izmantojiet to pašu maxPageSize vērtību, ko izmantojāt sākotnējā vairākkārtējā pieprasījumā. Tāpat kešojiet atgrieztos rezultātus vai īpašības vērtību nextLink , lai jūsu lietotne varētu atgriezt iepriekš iegūtās lapas.

Piemēram, lai iegūtu nākamo ierakstu lapu, nodod vaicājuma daļu nextLink no URL options parametram:

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

Šis pieprasījums atgriež nākamo rezultātu kopas lapu.

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

Svarīgi

Īpašuma vērtība nextLink ir kodēta URI. Ja jūs URI kodējat vērtību pirms tās nosūtīšanas, XML sīkdatņu informācija URL izraisa kļūdu.

FetchXML piemērs (tiešsaistes scenārijs)

Nākamais piemērs parāda, kā izmantot parametru count FetchXML, lai norādītu, ka katra lapa rāda trīs ierakstus.

Piezīmes

FetchXML peidžeru sīkfails tiek atgriezts tikai tiešsaistes retrieveMultipleRecords operācijām. (Xrm.WebApi.online). Tas nav atbalstīts bezsaistē.

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

Šis piemērs attēlo trīs ierakstus un atgriež FetchXML lapu sīkfailu, lai iegūtu nākamās lapas rezultātus, ja rezultātu kopā ir vairāk ierakstu. Šeit ir piemērs izvades no konsoles pārlūkprogrammas izstrādātāju rīkos:

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

Lai iegūtu lielas rezultātu kopas ar lapošanu, izmantojiet fetchXmlPagingCookie to, kas parādīts nākamajā piemērā.

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

Izmantojiet $expand sistēmas vaicājuma opciju navigācijas īpašībās, lai kontrolētu datus, kas atgriežas no saistītajām tabulām. Nākamais piemērs parāda, kā iegūt kontaktinformāciju visiem konta ierakstiem. Saistītajiem kontaktu ierakstiem jūs iegūstat tikai un contactidfullname laukus:

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

Iepriekšējais kods atgriež rezultātu ar shēmu, piemēram:

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

Piezīmes

Līdzīgi kā tiešsaistes scenārijā, izmantojiet $expand sistēmas vaicājuma opciju, lai izgūtu datus no saistītajām tabulām bezsaistē. Tomēr attiecības ar daudziem netiek atbalstītas klātienē.

Novecojusi metode Mobile Offline scenārijam

Piezīmes

Mobile @odata.nextLink Offline scenārijos tas ir novecojis. Lai gan tas joprojām tiek atbalstīts esošajām pielāgošanām, vairs to nelieto.

Bezsaistes $expand operācija atgriež anotāciju, @odata.nextLink kurā ir informācija par to, kā piekļūt saistītā ieraksta informācijai. Izmantojiet idšīs anotācijas , entityType, un options parametrus, lai izveidotu vienu vai vairākus papildu Xrm.WebApi.offline.retrieveRecord pieprasījumus. Nākamais kods sniedz pilnīgu piemēru, kā to izdarīt:

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

Lai iegūtu vairāk piemēru vairāku ierakstu iegūšanai, izmantojot Web API, skatiet sadaļu Vaicājuma dati, izmantojot Web API.

Datu vaicājums, izmantojot tīmekļa API
Xrm.WebApi.retrieveRecord
Xrm.WebApi