Делите путем


упдатеРецорд (референца клијентског АПИ-ја)

Ажурира запис табеле.

Синтакса

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

Параметре

Име Тип Потребно Опис
entityLogicalName String Да Табела логичко име записа који желите да ажурирате. На пример: account
id String Да ГУИД записа табеле који желите да ажурирате.
data Објекат Да ЈСОН објекат који садржи key: value парове, где key је особина табеле и value вредност особине коју желите да ажурирате.
Погледајте Примери да видите како можете дефинисати data објекат за различите сценарије ажурирања.
successCallback Function Не Функција за позивање када се ажурира запис. Погледајте повратну вредност
errorCallback Function Не Функција за позивање када операција не успе. Објекат са следећим особинама је прошао:
- errorCode:Број. Код грешке као позитиван децимални број. На пример, код грешке документован као 0x80040333 ће бити враћен као 2147746611.
- message:Ниске. Порука о грешци која описује проблем.

Повратна вредност

На успех, враћа објекат обећања на следећим successCallback својствима:

Име Тип Опис
entityType String Табела логичко име записа.
id String ГУИД записа.

Примери

Ови примери користе неке од истих објеката захтева као што је приказано у Ажурирање и брисање редова табеле помоћу Веб АПИ-ја за дефинисање објекта података за ажурирање записа табеле.

Основно ажурирање

Ажурира постојећи запис рачуна са ИД записа = 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
    }
);

Да бисте ажурирали асоцијацију на сродне записе табеле (претраге), подесите вредност једновредних навигационих својстава користећи напомену @odata.bind на други запис.

Ево примера кода:

Следећи пример ажурира запис налога да повеже други запис контакта као примарни контакт за налог:

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

Застарела метода за мобилни оффлине сценарио

Белешка

Уместо коришћења @odata.bind примера напомена изнад, застарели објекат претраге са особинама осетљивим на велика и мала слова ( logicalname и id) је и даље подржан за постојеће прилагођавања. Међутим , препоручује се да се @odata.bind користи напомена и за онлине и оффлине сценарио уместо коришћења овог застарелог објекта.

Следећи пример користи застарели метод за ажурирање записа налога за повезивање другог записа контакта као примарног контакта за налог од мобилних клијената када се ради у оффлине режиму:

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

Да бисте ажурирали асоцијацију на сродне табеле типа Активност, подесите вредност једновредних навигационих својстава користећи напомену @odata.bind на други запис.

Ажурирајте колону повезаних прилика на задатку

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

Ажурирање У вези колоне на задатку

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

Ажурирајте асоцијације за навигационе особине у вредности колекције

Кстрм .ВебАпи .онлине.екецуте АПИ може да се користи за повезивање и раздвајање навигационих својстава вредности колекције. Ово НИЈЕ подржано за мобилне оффлине сценарије.

Српскохрватски / српскохрватски