updateRecord (referenca klijentskog API-ja)

Ažurira zapis tabele.

Sintaksa

Xrm.WebApi.updateRecord(entityLogicalName, id, data).then(successCallback, errorCallback);

Parametre

Imenuj	Tip	Zahtevano	Opis
entityLogicalName	String	Da	Logičko ime tabele zapisa koji želite da ažurirate. Na primer: account.
id	String	Da	GUID zapisa tabele koji želite da ažurirate.
data	Objekat	Da	JSON objekat koji sadrži key: value parove, gde keyvalue je svojstvo tabele i predstavlja vrednost svojstva koje želite da ažurirate. Pogledajte primere da biste videli kako možete da definišete objekat za data različite scenarije ažuriranja.
successCallback	Function	Ne	Funkcija za pozivanje kada se ažurira zapis. Pogledajte povratnu vrednost
errorCallback	Function	Ne	Funkcija za pozivanje kada operacija ne uspe. Prosleđen je objekat sa sledećim svojstvima: - errorCode:Broj. Kôd greške kao pozitivan decimalni broj. Na primer, kôd greške koji je dokumentovan kao 0x80040333 će biti vraćen kao 2147746611. - message:Niske. Poruka o grešci koja opisuje problem.

Povratna vrednost

Pri uspehu vraća obećani objekat sa successCallback sledećim svojstvima:

Imenuj	Tip	Opis
entityType	String	Logičko ime tabele zapisa.
id	String	GUID zapisa.

Primeri

Ovi primeri koriste neke od istih objekata zahteva kao što je prikazano u članku Ažuriranje i brisanje redova tabele pomoću veb API-ja za definisanje objekta podataka za ažuriranje zapisa tabele.

Osnovno ažuriranje

Ažurira postojeći zapis naloga sa 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
    }
);

Ažuriranje povezivanja sa srodnim tabelama

Da biste ažurirali povezivanje sa srodnim zapisima tabele (pronalaženjima), @odata.bind podesite vrednost svojstava navigacije sa jednom vrednošću pomoću beleške sa drugim zapisom.

Evo primera koda:

Sledeći primer ažurira zapis naloga tako da drugi kontakt zapis poveže kao primarni kontakt za nalog:

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

Zastareo metod za mobilni scenario van mreže

Belešku

Umesto da koristite @odata.bind gorenavedeni primer beležaka, zastareli objekat za pronalaženje sa svojstvima koja razlikuju mala i velika slova (logicalnameidi ) i dalje je podržan za korišćenje prilagođavanja. Međutim, preporučuje se da @odata.bind koristite beleške za scenario na mreži i van mreže umesto da koristite ovaj zastareli objekat.

Sledeći primer koristi zastareli metod za ažuriranje zapisa naloga radi povezivanja drugog zapisa kontakta kao primarnog kontakta za nalog od mobilnih klijenata kada radite u režimu rada van mreže:

// 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 povezivanja sa srodnim tabelama tipa Aktivnost

Da biste ažurirali povezivanje sa srodnim tabelama tipa Aktivnost, @odata.bind postavite vrednost svojstava navigacije sa jednom vrednošću koristeći belešku sa drugim zapisom.

Ažuriraj srodnu kolonu mogućnosti za poslovanje na 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
    }
);

Update Regarding column on task

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

Ažuriranje povezivanja za svojstva navigacije vrednovanja kolekcije

API Xrm.WebApi.online.execute može da se koristi za povezivanje i uklanjanje svojstava navigacije vrednog za kolekciju. Ovo NIJE podržano za mobilne scenarije van mreže.

Srodni članci

Xrm.WebApi