updateRecord (referenca klijentskog API-ja)

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

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

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.

Xrm.WebApi