updateRecord (bezeroaren APIaren erreferentzia)

Taulako erregistro bat eguneratzen du.

Sintaxia

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

Parametroak

Eman izena	Mota	Beharrezkoa	Deskribapenak
entityLogicalName	String	Yes	Eguneratu nahi duzun erregistroaren taularen izen logikoa. Adibidez: account.
id	String	Yes	Eguneratu nahi duzun taulako erregistroaren GUID.
data	Objektua	Yes	Bikoteak dituen key: value JSON objektua, non key taularen propietatea den eta value eguneratu nahi duzun propietatearen balioa den. Ikus Adibideak objektua nola definitu data dezakezun eguneratze agertoki desberdinetarako.
successCallback	Function	Ez	Erregistro bat eguneratzen denean deitzen zaion funtzioa. Ikusi itzulitako balioa
errorCallback	Function	Ez	Eragiketan akats bat gertatzen denean deitzen zaion funtzioa. Propietate hauek dituen objektu bat pasatzen da: - errorCode: Zenbakia. Errore-kodea zenbaki hamartar positibo gisa. Adibidez, dokumentatutako errore-kodea honela 0x800403332147746611itzuliko da. - message: String. Arazoa deskribatzen duen akats-mezua.

Itzuli balioa

Arrakasta izanez gero, promesa-objektu bat honako propietate hauekin itzultzen du successCallback :

Eman izena	Mota	Deskribapenak
entityType	String	Erregistroaren taularen izen logikoa.
id	String	Erregistroaren GUID.

Adibideak

Adibide hauek eskaera objektu berberak erabiltzen dituzte Eguneratu eta ezabatu taulako errenkadak Web APIa erabiliz taula erregistro bat eguneratzeko datu-objektua definitzeko.

Oinarrizko eguneraketa

Lehendik dagoen kontuaren erregistroa eguneratzen du erregistroaren IDarekin = 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
    }
);

Eguneratu erlazionatutako taulen asoziazioak

Erlazionatutako taulako erregistroekin (bilaketak) asoziazioa eguneratzeko, ezarri balio bakarreko nabigazio-propietateen balioa beste erregistro baten oharpena erabiliz @odata.bind .

Hona hemen kodearen adibidea:

Ondorengo adibideak kontuaren erregistro bat eguneratzen du, beste kontaktu-erregistro bat kontuaren kontaktu nagusi gisa asoziatzeko:

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

Mugikorretarako lineaz kanpoko agertokirako metodo zaharkitua

Oharra

Goiko anotazio-adibidea erabili @odata.bind beharrean, maiuskulak eta minuskulak bereizten dituen ( eta id) propietateaklogicalname dituen bilaketa-objektu zaharkitua oraindik onartzen da lehendik dauden pertsonalizazioetarako. Hala ere, gomendatzen da oharpena erabiltzea @odata.bind lineako eta lineaz kanpoko agertokietarako, objektu zaharkitu hau erabili beharrean.

Ondorengo adibideak metodo zaharkitua erabiltzen du kontuaren erregistro bat eguneratzeko, beste kontaktu-erregistro bat bezero mugikorretatik kontuaren kontaktu nagusi gisa asoziatzeko, lineaz kanpoko moduan lan egitean:

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

Eguneratu Jarduera motako erlazionatutako taulen asoziazioak

Jarduera motako erlazionatutako taulekin asoziazioa eguneratzeko, ezarri balio bakarreko nabigazio-propietateen balioa beste erregistro baterako oharpena erabiliz @odata.bind .

Eguneratu erlazionatutako aukeraren zutabea zereginean

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

Eguneratu zereginaren zutabeari dagokionez

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

Eguneratu bildumaren balioen nabigazio-propietateen elkarteak

Xrm.WebApi.online.execute APIa erabil daiteke bildumaren balioen nabigazio-propietateak asoziatzeko eta desasoziatzeko. Hau ez da onartzen mugikorretarako lineaz kanpoko agertokietan.

Erlazionatutako artikuluak

Xrm.WebApi