updateRecord (kliento API nuoroda)

Atnaujina lentelės įrašą.

Sintaksė

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

Parametrai

Vardas, pavadinimas	Rūšis	Privalomas	Aprašą
entityLogicalName	String	Taip	Lentelės loginis įrašo, kurį norite atnaujinti, pavadinimas. Pavyzdžiui: account.
id	String	Taip	Lentelės įrašo, kurį norite atnaujinti, GUID.
data	Daiktas	Taip	JSON objektas su key: value poromis, kur key yra lentelės ypatybė ir value ypatybės, kurią norite atnaujinti, reikšmė. Žr . Pavyzdžiai , kaip galite apibrėžti objektą data įvairiems naujinimo scenarijams.
successCallback	Funkcija	No	Funkcija, kurią reikia iškviesti, kai įrašas atnaujinamas. Žr. grąžinamą reikšmę
errorCallback	Funkcija	No	Funkcija, kurią reikia iškviesti, kai operacija nepavyksta. Perduotas objektas su šiomis ypatybėmis: - errorCode:Numeris. Klaidos kodas kaip teigiamas dešimtainis skaičius. Pavyzdžiui, klaidos kodas, dokumentuotas kaip 0x80040333 bus grąžintas kaip 2147746611. - message:Eilutės. Klaidos pranešimas, apibūdinantis problemą.

Grąžinimo reikšmė

Sėkmingai grąžins pažado objektą successCallback su šiomis ypatybėmis:

Vardas, pavadinimas	Rūšis	Aprašą
entityType	String	Lentelės loginis įrašo pavadinimas.
id	String	Įrašo GUID.

Pavyzdžiai

Šiuose pavyzdžiuose naudojami kai kurie tos pačios užklausos objektai, kaip parodyta lentelės eilučių naujinimas ir naikinimas naudojant žiniatinklio API , kad būtų apibrėžtas duomenų objektas lentelės įrašui atnaujinti.

Pagrindinis naujinimas

Atnaujina esamą kliento įrašą, kurio įrašo ID = 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
    }
);

Susijusių lentelių susiejimų naujinimas

Norėdami atnaujinti susiejimą su susijusiais lentelės įrašais (peržvalgomis), nustatykite vienos reikšmės naršymo ypatybių reikšmę naudodami komentarą @odata.bind į kitą įrašą.

Štai kodo pavyzdys:

Toliau pateiktame pavyzdyje atnaujinamas kliento įrašas, kad būtų susietas kitas kontakto įrašas kaip pagrindinis kliento kontaktas:

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

Nebenaudojamas "Mobile Offline" scenarijaus metodas

Pastaba.

Užuot naudojus @odata.bind aukščiau pateiktą komentaro pavyzdį, nebenaudojamas peržvalgos objektas su didžiąsias ir mažąsias raides skiriaiomis ypatybėmis (logicalname ir id) vis dar palaikomas norint pritaikyti tinkinimus. Tačiau rekomenduojama naudoti @odata.bind komentarą tiek prisijungus, tiek neprisijungus, o ne naudojant šį uždraustą objektą.

Toliau pateiktame pavyzdyje naudojamas nebenaudojamas metodas kliento įrašui atnaujinti norint susieti kitą kontakto įrašą kaip pagrindinį paskyros kontaktą iš mobiliųjų klientų, kai dirbama atjungties režimu:

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

Naujinti susiejimus su susijusiomis lentelėmis, kurių tipas Veikla

Norėdami atnaujinti susiejimą su susijusiomis lentelėmis, kurių tipas Veikla, nustatykite vienos reikšmės naršymo ypatybių reikšmę naudodami komentarą @odata.bind į kitą įrašą.

Naujinti susijusios galimybės stulpelį užduotyje

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

Atnaujinti rinkinio reikšmių naršymo ypatybių susiejimus

Xrm.WebApi.online.execute API galima naudoti norint susieti ir atsieti rinkinio reikšmių naršymo ypatybes. Tai NEPALAIKOMA naudojant "Mobile Offline" scenarijus.

Susiję straipsniai

Xrm.WebApi