updateRecord (kliendi API viide)

Värskendab tabelikirjet.

Süntaks

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

Parameetrid

Nimi	Tüüp	Nõutav	Kirjeldus
entityLogicalName	String	Jah	Värskendatava kirje tabeli loogiline nimi. Näiteks: account.
id	String	Jah	Värskendatava tabelikirje GUID.
data	Ese	Jah	Paare sisaldav key: value JSON-objekt, kus key on tabeli atribuut ja value mis on värskendatava atribuudi väärtus. Vaadake näiteid , kuidas määratleda data objekti erinevate värskendusstsenaariumide jaoks.
successCallback	Function	Ei	Funktsioon, millele helistatakse kirje värskendamisel. Kuva tagastusväärtus
errorCallback	Function	Ei	Funktsioon, mida kutsuda, kui toiming nurjub. Edastatakse järgmiste atribuutidega objekt: - errorCode:Arv. Tõrkekood positiivse kümnendarvuna. Näiteks tagastatakse kujul dokumenteeritud 0x80040333 tõrkekood.2147746611 - message:String. Probleemi kirjeldav tõrketeade.

Tagastatav väärtus

Edu korral tagastab lubaduse objekti järgmise successCallback atribuudiga:

Nimi	Tüüp	Kirjeldus
entityType	String	Kirje loogikanimi tabelina.
id	String	Kirje GUID.

Näited

Nendes näidetes kasutatakse samu päringuobjekte, nagu on näidatud jaotises Tabeliridade värskendamine ja kustutamine veebi-API abil , et määratleda andmeobjekt tabelikirje värskendamiseks.

Põhivärskendus

Värskendab olemasoleva kontokirje kirje 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
    }
);

Seotud tabelite seoste värskendamine

Seostuvate tabelikirjete (otsingute) seose värskendamiseks määrake ühe väärtusega navigeerimisatribuutide väärtus, kasutades @odata.bind marginaali mõnele muule kirjele.

Siin on koodi näide:

Järgmises näites värskendatakse kontokirjet, et seostada konto esmase kontaktina mõni muu kontaktikirje:

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

Taunitud meetod ühenduseta mobiilsideseadme stsenaariumi jaoks

Märkus.

Ülaltoodud marginaalide näite kasutamise @odata.bind asemel toetatakse kohanduste laiendamiseks endiselt iganenud otsinguobjekti , mille tõstutundlikud atribuudid (logicalname ja id). Siiski on soovitatav kasutada @odata.bind selle iganenud objekti asemel marginaale nii võrguühendusega kui ka ühenduseta režiimis.

Järgmises näites kasutatakse iganenud meetodit kontokirje värskendamiseks, et seostada ühenduseta režiimis töötades mõni muu kontaktikirje mobiiliklientide konto esmaseks kontaktiks.

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

Seoste värskendamine seotud tabelitega, mille tüüp on Tegevus

Seoste värskendamiseks seotud tabelitega, mille tüüp on Tegevus, määrake ühe väärtusega navigeerimisatribuutide väärtus, kasutades @odata.bind marginaali mõnele muule kirjele.

Ülesande seotud võimaluseveeru värskendamine

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

Kogumisväärtusega navigeerimisatribuutide seoste värskendamine

API-t Xrm.WebApi.online.execute saab kasutada kogumisväärtusega navigeerimisatribuutide seostamiseks ja seose eemaldamiseks. Seda ei toetata ühenduseta mobiilsideseadmete korral.

Seotud artiklid

Xrm.WebApi