retrieveRecord (bezeroaren APIaren erreferentzia)

Taulako erregistro bat eskuratzen du.

Sintaxia

Xrm.WebApi.retrieveRecord(entityLogicalName, id, options).then(successCallback, errorCallback);

Parametroak

Izena Mota Beharrezkoa Deskribapena
entityLogicalName String Bai Eskuratu nahi duzun erregistroaren taularen izen logikoa. Adibidez: account.
id String Bai Eskuratu nahi duzun taulako erregistroaren GUID.
options String Ez OData sistemaren kontsulta-aukerak itzultzen dena kontrolatzeko. Ikusi aukerak
successCallback Function Ez Erregistro bat berreskuratzen denean deitzen zaion funtzioa. JSON objektua, berreskuratutako propietateak eta balioak funtzioari pasatuta.
errorCallback Function Ez Eragiketan akats bat gertatzen denean deitzen zaion funtzioa. Propietate hauek dituen objektu bat pasatzen da:
- errorCode: Zenbakia. Errore-kodea zenbaki hamartar positibo gisa. Adibidez, dokumentatutako errore-kodea honela 0x800403332147746611itzuliko da.
- message: String. Arazoa deskribatzen duen akats-mezua.

aukerak

Itzultzen dena kontrolatzeko, erabili $select eta OData sistemaren $expand kontsulta-aukerak datuak berreskuratzeko.

Erabili sistema-kontsulta $select aukera itzulitako propietateak mugatzeko, komaz bereizitako propietate-izenen zerrenda bat sartuta. Propietate zehatzak hautatzea praktika egoki garrantzitsua da. Propietateak ez badira zehazten $select, propietate guztiak itzuliko dira.

Erabili sistema-kontsulta $expand aukera erlazionatutako tauletako datuak itzultzen diren kontrolatzeko. Nabigazio-propietatearen izena soilik sartzen baduzu, erlazionatutako erregistroen propietate guztiak jasoko dituzu. Erlazionatutako erregistroetarako itzulitako propietateak muga ditzakezu nabigazio-propietatearen izenaren ondoren parentesi artean dagoen sistemaren kontsulta aukera erabiliz $select . Balio bakarra eta bilduma-balioa duten nabigazio-propietateetarako erabiltzen da. Lineaz kanpoko aukera $expandhabiaratua $select soilik onartzen dugu .

Zehaztu zein aukera dauden ?kontsultatzeko. Kontsulta-aukerak ere zehaztu ditzakezu, kontsulta-aukerak bereizteko & . Adibidez:

?$select=name&$expand=primarycontactid($select=contactid,fullname)

Ikus Adibideak berreskuratzeko hainbat eszenatoki aukeraren parametroa nola defini dezakezun ikusteko.

Itzuli balioa

Arrakasta izanez gero, JSON objektu bat duen promesa itzultzen du, berreskuratutako zutabeekin eta haien balioekin. Eskatutako erregistroa existitzen ez bada, errore bat itzultzen du.

Adibideak

Ikus ondorengo adibideak:

Oinarrizko berreskurapena

Kontuaren erregistro baten izena eta diru-sarrerak berreskuratzen ditu, erregistroaren IDa = 5531d753-95af-e711-a94e-000d3a11e605.

Xrm.WebApi.retrieveRecord("account", "a8a19cdd-88df-e311-b8e5-6c3be5a8b200", "?$select=name,revenue").then(
    function success(result) {
        console.log("Retrieved values: Name: " + result.name + ", Revenue: " + result.revenue);
        // perform operations on record retrieval
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Goiko adibideak honako testua bistaratzen du kontsolan: Baliteke beste balio batzuk ikustea zure datuen arabera:

Retrieved values: Name: Sample Account, Revenue: 5000000

Ondorengo adibidean erakusten da nola berreskuratu kontu erregistro baten kontaktua erregistroaren IDa = a8a19cdd-88df-e311-b8e5-6c3be5a8b200 erregistroarekin. Erlazionatutako kontaktu-erregistrorako, contactid eta fullname propietateak soilik eskuratzen ari gara.

Xrm.WebApi.retrieveRecord("account", "a8a19cdd-88df-e311-b8e5-6c3be5a8b200", "?$select=name&$expand=primarycontactid($select=contactid,fullname)").then(
    function success(result) {
        console.log("Retrieved values: Name: " + result.name + ", Primary Contact ID: " + result.primarycontactid.contactid +
                ", Primary Contact Name: " + result.primarycontactid.fullname);
        // perform operations on record retrieval
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Goiko adibideak honako testua bistaratzen du kontsolan: Baliteke beste balio batzuk ikustea zure datuen arabera:

Retrieved values: Name: Adventure Works, Primary Contact ID: 49a0e5b9-88df-e311-b8e5-6c3be5a8b200, Primary Contact Name: Adrian Dumitrascu

Xrm.WebApi.retrieveMultipleRecords
Xrm.WebApi

  • Last updated on