Dijeli putem

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.

Osnovno ažuriranje

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 pomoću primjedbe 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 gore navedenog @odata.bind primjera opaske, zastarjeli objekt pretraživanja sa svojstvima koja razlikuju velika i mala slova (logicalnameidi ) i dalje je podržan za izvlačenje prilagodbi. No umjesto korištenja tog zastarjelog @odata.bind objekta preporučuje se korištenje primjedbe i za scenarij na mreži i za izvanmrežni rad.

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živanje povezanim tablicama vrste Aktivnost, @odata.bind postavite vrijednost svojstava navigacije s jednom vrijednošću pomoću primjedbe 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
   }
);

Ažuriranje pridruživanja za navigacijska svojstva s vrijednostima zbirke

API Xrm.WebApi.online.execute može se koristiti za pridruživanje i razdruživanje navigacijskih svojstava s vrijednostima zbirke. To NIJE podržano za mobilne izvanmrežne scenarije.

Xrm.WebApi

  • Last updated on