Napomena
Za pristup ovoj stranici potrebna je autorizacija. Možete se pokušati prijaviti ili promijeniti direktorije.
Za pristup ovoj stranici potrebna je autorizacija. Možete pokušati promijeniti direktorije.
Ažurira zapis tablice.
Sintaksa
Xrm.WebApi.updateRecord(entityLogicalName, id, data).then(successCallback, errorCallback);
Parametara
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
entityLogicalName |
String | Jest | Logički naziv tablice zapisa koji želite ažurirati. Na primjer: account. |
id |
String | Jest | GUID zapisa tablice koji želite ažurirati. |
data |
Objekt | Jest | JSON objekt koji key: value sadrži parove keyvalue , pri čemu je svojstvo tablice i vrijednost svojstva koje želite ažurirati.Pogledajte primjere da biste vidjeli kako definirati objekt data za različite scenarije ažuriranja. |
successCallback |
Function | No | Funkcija za pozivanje kada se zapis ažurira. Pogledajte povratnu vrijednost |
errorCallback |
Function | No | Funkcija za pozivanje kada operacija ne uspije. Prosljeđuje se objekt sa sljedećim svojstvima: - errorCode:Broj. Kôd pogreške kao pozitivan decimalni broj. Primjerice, kôd pogreške dokumentiran kao 0x80040333 će se vratiti kao 2147746611.- message:Gudački. Poruka o pogrešci koja opisuje problem. |
Povratna vrijednost
Nakon uspjeha vraća objekt obećanja sljedećim successCallback svojstvima:
| Ime | Tip | Opis |
|---|---|---|
entityType |
String | Logički naziv tablice zapisa. |
id |
String | GUID zapisa. |
Primjeri
U ovim se primjerima koriste neki od istih objekata zahtjeva kao što je pokazano u odjeljku Ažuriranje i brisanje redaka tablice pomoću web-API-ja za definiranje podatkovnog objekta za ažuriranje zapisa tablice.
| Primjer | Pokazuje | Primjer WEB API-ja |
|---|---|---|
| Osnovno ažuriranje | Kako ažurirati vrijednosti stupaca na postojećem zapisu računa. | Osnovno ažuriranje |
| Ažuriranje pridruživanja povezanim tablicama | Promjena primarnog kontakta računa pomoću značajke @odata.bind. |
Pridruživanje navigacijskom svojstvu s jednom vrijednošću |
| Ažuriranje pridruživanja povezanim tablicama vrste Aktivnost | Kako pridružiti zadatak poslovnoj prilici ili ga postaviti u vezi s pretraživanjem na račun. | Pridruživanje navigacijskom svojstvu s jednom vrijednošću |
| Ažuriranje pridruživanja za navigacijska svojstva s vrijednostima zbirke | Kako povezati i razdruživati povezane zapise pomoću Xrm.WebApi.online.execute. |
Dodavanje zapisa u zbirku iuklanjanje zapisa iz zbirke |
Primjer osnovnog ažuriranja
Ažurira postojeći zapis računa s ID-om zapisa = 5531d753-95af-e711-a94e-000d3a11e605.
// define the data to update a record
var data =
{
"name": "Updated Sample Account ",
"creditonhold": true,
"address1_latitude": 47.639583,
"description": "This is the updated description of the sample account",
"revenue": 6000000,
"accountcategorycode": 2
}
// update the record
Xrm.WebApi.updateRecord("account", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
function success(result) {
console.log("Account updated");
// perform operations on record update
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
Primjer ažuriranja pridruživanja povezanim tablicama
Da biste ažurirali pridruživanje povezanim zapisima tablice (pretraživanja), @odata.bind postavite vrijednost svojstava navigacije s jednom vrijednošću tako da pomoću primjedbe pokažete na drugi zapis.
Evo primjera koda:
U sljedećem se primjeru ažurira zapis računa da bi se drugi zapis kontakta pridružio kao primarni kontakt za račun:
// define the data to update a record
var data =
{
"primarycontactid@odata.bind": "/contacts(61a0e5b9-88df-e311-b8e5-6c3be5a8b200)"
}
// update the record
Xrm.WebApi.updateRecord("account", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
function success(result) {
console.log("Account updated");
// perform operations on record update
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
Zastarjela metoda za scenarij za izvanmrežni rad na mobilnim uređajima
Napomena
Umjesto korištenja primjedbe @odata.bind u prethodnom primjeru, zastarjeli objekt pretraživanja sa svojstvima koja razlikuju velika i mala slova (logicalnameidi ) i dalje je podržan za postojeće prilagodbe. No preporučuje se korištenje primjedbe @odata.bind za mrežne i izvanmrežne scenarije umjesto korištenja tog zastarjelog objekta.
U sljedećem se primjeru koristi zastarjela metoda za ažuriranje zapisa računa radi pridruživanja drugog zapisa kontakta kao primarnog kontakta za račun iz mobilnih klijenata prilikom rada u izvanmrežnom načinu rada:
// define the data to update a record
var data =
{
"primarycontactid":
{
"logicalname": "contact",
"id": "61a0e5b9-88df-e311-b8e5-6c3be5a8b200"
}
}
// update the record
Xrm.WebApi.offline.updateRecord("account", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
function success(result) {
console.log("Account updated");
// perform operations on record update
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
Ažuriranje pridruživanja povezanim tablicama vrste Primjer aktivnosti
Da biste ažurirali pridruživanja povezanim tablicama vrste Aktivnost, @odata.bind postavite vrijednost svojstava navigacije s jednom vrijednošću pomoću primjedbe koja pokazuje na drugi zapis.
Ažuriranje povezanog stupca prilike u zadatku
// define the data to update a record
var data =
{
"new_relatedopportunities_task@odata.bind": "/opportunities(61a0e5b9-88df-e311-b8e5-6c3be5a8b200)"
}
// update the record
Xrm.WebApi.updateRecord("task", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
function success(result) {
console.log("Task updated");
// perform operations on record update
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
Ažuriraj vezano uz stupac zadatka
// define the data to update a record
var data =
{
"regardingobjectid_account_task@odata.bind": "/accounts(61a0e5b9-88df-e311-b8e5-6c3be5a8b200)"
}
// update the record
Xrm.WebApi.updateRecord("task", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
function success(result) {
console.log("Task updated");
// perform operations on record update
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
Update associations for collection-valued navigation properties example
Pomoću Xrm.WebApi.online.execute API-ja povežite i razdružite navigacijska svojstva s vrijednostima zbirke. Ta značajka nije podržana za mobilne izvanmrežne scenarije.