updateRecord (sklic na API odjemalca)

Posodobi zapis tabele.

Sintaksa

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

Parametrov

Ime	Vrsta	Zahtevano	Opis
entityLogicalName	String	Da	Logično ime tabele zapisa, ki ga želite posodobiti. Primer: account.
id	String	Da	GUID zapisa tabele, ki ga želite posodobiti.
data	Predmet	Da	Predmet JSON, key: value ki vsebuje pare, keyvalue kjer je lastnost tabele in je vrednost lastnosti, ki jo želite posodobiti. Glejte Primeri, če si želite ogledati, kako lahko določite data predmet za različne scenarije posodobitve.
successCallback	Function	Ne	Funkcija, ki pokliče ob posodobitvi zapisa. Glejte Vrnjena vrednost
errorCallback	Function	Ne	Funkcija, ki jo pokličete, ko operacija ne uspe. Podan je predmet s temi lastnostmi: - errorCode:Številka. Koda napake kot pozitivno decimalno število. Koda napake, dokumentirana kot 0x80040333 bo na primer vrnjena kot 2147746611. - message:Niz. Sporočilo o napaki, ki opisuje težavo.

Vrednost vračila

Ob uspehu vrne obljubni predmet s successCallback temi lastnostmi:

Ime	Vrsta	Opis
entityType	String	Logično ime tabele zapisa.
id	String	GUID zapisa.

Primeri

Ti primeri uporabljajo nekatere iste predmete zahteve, kot je prikazano v članku Posodobitev in brisanje vrstic tabele s spletnim API-jem za določanje podatkovnega predmeta za posodabljanje zapisa tabele.

Osnovna posodobitev

Posodobi obstoječi zapis računa z ID-jem 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
    }
);

Posodabljanje povezav s povezanimi tabelami

Če želite posodobiti povezavo z zapisi v povezani tabeli (iskanja), @odata.bind nastavite vrednost lastnosti krmarjenja z eno vrednostjo z uporabo opombe na drug zapis.

Tukaj je primer kode:

Ta primer posodobi zapis kupca, da poveže drug zapis stika kot primarni stik 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
    }
);

Zastarela metoda za scenarij brez povezave za mobilne naprave

opomba,

Namesto uporabe zgornjega @odata.bind primera opombe je zastarani iskalni predmet z lastnostmi , ki razlikujejo med malimi in velikimi črkami ( logicalnameidin ), še vedno podprt za exisiting customizations. Priporočamo pa, da namesto tega @odata.bind zastaranega predmeta uporabite opombo tako za scenarij s povezavo kot tudi za scenarij brez povezave.

V tem primeru je zastarana metoda uporabljena za posodobitev zapisa računa, da poveže drug zapis stika kot primarni stik za račun iz mobilnih odjemalcev, ko delate v načinu brez povezave:

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

Posodabljanje povezav do povezanih tabel vrste »Dejavnost«

Če želite posodobiti povezavo s povezanimi tabelami vrste Dejavnost, @odata.bind nastavite vrednost lastnosti krmarjenja z eno vrednostjo z opombo na drug zapis.

Update related opportunity column on task

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

Posodabljanje povezav za lastnosti krmarjenja z vrednostmi zbirke

API Xrm.WebApi.online.execute lahko uporabite za povezovanje in povezavo lastnosti krmarjenja z vrednostmi zbirke. To NI podprto za scenarije brez povezave za mobilne naprave.

Povezani članki

Xrm.WebApi