Белешка
Приступ овој страници захтева ауторизацију. Можете покушати да се пријавите или промените директоријуме.
Приступ овој страници захтева ауторизацију. Можете покушати да промените директоријуме.
Ажурира запис табеле.
Синтакса
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
}
);
Ажурирајте асоцијације за навигационе особине у вредности колекције
Кстрм .ВебАпи .онлине.екецуте АПИ може да се користи за повезивање и раздвајање навигационих својстава вредности колекције. Ово НИЈЕ подржано за мобилне оффлине сценарије.