Poznámka
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete sa skúsiť prihlásiť alebo zmeniť adresáre.
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete skúsiť zmeniť adresáre.
Aktualizuje záznam tabuľky.
Syntax
Xrm.WebApi.updateRecord(entityLogicalName, id, data).then(successCallback, errorCallback);
Parametre
| Meno | Typ | Požaduje sa | Description |
|---|---|---|---|
entityLogicalName |
String | Áno | Logický názov tabuľky záznamu, ktorý chcete aktualizovať. Napríklad: account. |
id |
String | Áno | IDENTIFIKÁTOR GUID záznamu tabuľky, ktorý chcete aktualizovať. |
data |
Namietať | Áno | Objekt JSON obsahujúci key: value páry, čo key je vlastnosť tabuľky a value je hodnotou vlastnosti, ktorú chcete aktualizovať.Pozrite si časť Príklady a zistite, ako môžete definovať data objekt pre rôzne scenáre aktualizácie. |
successCallback |
Function | No | Funkcia na volanie pri aktualizácii záznamu. Zobraziť vrátenú hodnotu |
errorCallback |
Function | No | Funkcia, ktorá sa volá v prípade zlyhania operácie. Odovzdá sa objekt s nasledujúcimi vlastnosťami: - errorCode:Číslo. Kód chyby ako kladné desatinné číslo. Napríklad kód chyby zdokumentovaný ako 0x80040333 sa vráti ako 2147746611.- message:Povrázok. Chybové hlásenie popisujúce problém. |
Vrátená hodnota
Po úspešnom dokončení vráti objekt sľubu successCallback s nasledujúcimi vlastnosťami:
| Meno | Typ | Description |
|---|---|---|
entityType |
String | Logický názov tabuľky záznamu. |
id |
String | Identifikátor GUID záznamu. |
Príklady
Tieto príklady používajú niektoré rovnaké objekty požiadavky, ako je to znázornené v téme Aktualizácia a odstránenie riadkov tabuľky pomocou webového rozhrania API na definovanie údajového objektu na aktualizáciu záznamu tabuľky.
| Example | Ukazuje | Príklad webového rozhrania API |
|---|---|---|
| Základná aktualizácia | Ako aktualizovať hodnoty stĺpcov v existujúcom zázname konta. | Základná aktualizácia |
| Aktualizácia priradení k súvisiacim tabuľkám | Zmena primárneho kontaktu konta pomocou funkcie @odata.bind. |
Priradenie k vlastnosti navigácie s jednou hodnotou |
| Aktualizovať priradenia k súvisiacim tabuľkám typu Aktivita | Zistite, ako priradiť úlohu k príležitosti alebo nastaviť jej vyhľadávanie v súvislosti s kontom. | Priradenie k vlastnosti navigácie s jednou hodnotou |
| Aktualizujte priradenia pre vlastnosti navigácie s hodnotami z kolekcie | Priradenie a zrušenie priradenia súvisiacich záznamov pomocou funkcie Xrm.WebApi.online.execute. |
Pridanie záznamu do kolekcie a Odstránenie záznamu z kolekcie |
Príklad základnej aktualizácie
Aktualizuje existujúci záznam konta s ID záznamu = 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
}
);
Aktualizácia priradení k súvisiacej tabuľke
Ak chcete aktualizovať priradenie k záznamom súvisiacej tabuľky (vyhľadávania), nastavte hodnotu vlastností navigácie s jednou hodnotou pomocou @odata.bind komentára tak, aby odkazla na iný záznam.
Tu je príklad kódu:
Nasledujúci príklad aktualizuje záznam konta a priradí iný záznam kontaktu ako primárny kontakt pre konto:
// 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
}
);
Zastaraná metóda pre scenár mobilnej offline
Poznámka
Namiesto použitia @odata.bind komentára v predchádzajúcom príklade je zastaraný objekt vyhľadávania s vlastnosťami rozlišujúcimi veľké a malé písmená (logicalname a id) stále podporovaný pre existujúce prispôsobenia. Používanie komentára @odata.bind sa však odporúča pre online aj offline scenáre namiesto používania tohto zastaraného objektu.
Nasledujúci príklad používa zastaranú metódu na aktualizáciu záznamu konta na priradenie iného záznamu kontaktu ako primárneho kontaktu pre konto z mobilných klientov pri práci v režime offline:
// 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
}
);
Aktualizácia priradení k súvisiacim tabuľkám typu Aktivita
Ak chcete aktualizovať priradenia k súvisiacim tabuľkám typu Aktivita, nastavte hodnotu vlastností navigácie s jednou hodnotou pomocou @odata.bind komentára na odkazovanie na iný záznam.
Aktualizácia stĺpca súvisiacej príležitosti v úlohe
// 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
}
);
Aktualizácia stĺpca Súvisiace v úlohe
// 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
}
);
Príklad aktualizovania priradení pre vlastnosti navigácie s hodnotami z kolekcie
Rozhranie API Xrm.WebApi.online.execute použite na priradenie a zrušenie priradenia vlastností navigácie s hodnotou kolekcie. Táto funkcia nie je podporovaná pre scenáre v režime offline pre mobilné zariadenia.