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ąžinama 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.

Pavyzdys Rodo Žiniatinklio API pavyzdys
Pagrindinis naujinimas Kaip atnaujinti esamo abonemento įrašo stulpelių reikšmes. Pagrindinis naujinimas
Susijusių lentelių susiejimų naujinimas Kaip pakeisti paskyros pagrindinį kontaktą naudojant @odata.bind. Susieti su vienos reikšmės naršymo ypatybe
Naujinti susiejimus su susijusiomis lentelėmis, kurių tipas Veikla Kaip susieti užduotį su galimybe arba nustatyti jos peržvalgą paskyroje. Susieti su vienos reikšmės naršymo ypatybe
Atnaujinti rinkinio reikšmių naršymo ypatybių susiejimus Kaip susieti ir atsieti susijusius įrašus naudojant Xrm.WebApi.online.execute. Įrašo įtraukimas į rinkinį ir įrašo šalinimas iš rinkinio

Pagrindinio naujinimo pavyzdys

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

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 , kad nukreiptumėte į 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 naudodę komentarą @odata.bind ankstesniame pavyzdyje, nebenaudojamas peržvalgos objektas su didžiąsias ir mažąsias raides skiriaiomis ypatybėmis (logicalname ir id) vis dar palaikomas esamiems tinkinimams. Tačiau komentarą @odata.bind rekomenduojama naudoti 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
    }
);

Norėdami atnaujinti susiejimus su susijusiomis lentelėmis, kurių tipas Veikla, nustatykite vienos reikšmės naršymo ypatybių reikšmę naudodami komentarą @odata.bind , kad nukreiptumėte į 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
   }
);

Update associations for collection-valued navigation properties example

Naudokite Xrm.WebApi.online.execute API, kad susietumėte ir atsietumėte rinkinio reikšmių naršymo ypatybes. Ši funkcija nepalaikoma mobiliojo ryšio neprisijungus scenarijuose.

Xrm.WebApi

  • Paskutinį kartą atnaujinta