Piezīmes
Lai piekļūtu šai lapai, ir nepieciešama autorizācija. Varat mēģināt pierakstīties vai mainīt direktorijus.
Lai piekļūtu šai lapai, ir nepieciešama autorizācija. Varat mēģināt mainīt direktorijus.
Atjaunina tabulas ierakstu.
Sintakse
Xrm.WebApi.updateRecord(entityLogicalName, id, data).then(successCallback, errorCallback);
Parametrus
| Vārds | Tips | Obligāti | Apraksts |
|---|---|---|---|
entityLogicalName |
String | Jā | Atjaunināmā ieraksta tabulas loģiskais nosaukums. Piemēram, account. |
id |
String | Jā | Atjaunināmā tabulas ieraksta GUID. |
data |
Objektu | Jā | JSON objekts, kas satur key: value pārus, kur key ir tabulas rekvizīts un value tā rekvizīta vērtība, kuru vēlaties atjaunināt.Skatiet sadaļu Piemēri , lai uzzinātu, kā var definēt data objektu dažādiem atjaunināšanas scenārijiem. |
successCallback |
Funkcija | Nē. | Funkcija, kas jāizsauc, kad tiek atjaunināts ieraksts. Skatīt atgriezto vērtību |
errorCallback |
Funkcija | Nē. | Funkcija, kas jāizsauc, ja operācija neizdodas. Tiek nodots objekts ar šādām īpašībām: - errorCode:Skaitlis. Kļūdas kods kā pozitīvs decimālskaitlis. Piemēram, kļūdas kods, kas dokumentēts kā 0x80040333 , tiks atgriezts kā 2147746611.- message:Virkne. Kļūdas ziņojums, kurā aprakstīta problēma. |
Atgrieztā vērtība
Ja tas ir veiksmīgs, atgriež solījuma objektu successCallback ar šādiem rekvizītiem:
| Vārds | Tips | Apraksts |
|---|---|---|
entityType |
String | Tabulas loģiskais ieraksta nosaukums. |
id |
String | Ieraksta GUID. |
Piemēri
Šajos piemēros tiek izmantoti daži no tiem pašiem pieprasījuma objektiem, kā parādīts sadaļā Tabulas rindu atjaunināšana un dzēšana, izmantojot Web API , lai definētu datu objektu tabulas ieraksta atjaunināšanai.
| Piemērs | Parāda | Web API piemērs |
|---|---|---|
| Pamata atjauninājums | Kā atjaunināt kolonnu vērtības esošā konta ierakstā. | Pamata atjauninājums |
| Atjaunināt asociācijas uz attiecīgajām tabulām | Kā mainīt konta galveno kontaktpersonu, izmantojot @odata.bind. |
Saistīt ar vienas vērtības navigācijas īpašību |
| Atjaunināt asociācijas uz saistītajām tabulām tipa Aktivitāte | Kā saistīt darbu ar iespēju vai iestatīt tā izskatu kontam. | Saistīt ar vienas vērtības navigācijas īpašību |
| Atjaunināt asociācijas kolekcijas vērtību navigācijas īpašumiem | Kā saistīt un atdalīt saistītos ierakstus, izmantojot Xrm.WebApi.online.execute. |
Pievienot ierakstu kolekcijai un izņemt ierakstu no kolekcijas |
Pamata atjauninājuma piemērs
Atjaunina esošu konta ierakstu ar ieraksta ID = . 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
}
);
Atjaunināt asociācijas uz saistīto tabulu piemēru
Lai atjauninātu asociāciju uz saistītajiem tabulas ierakstiem (meklējumiem), iestatiet vienas vērtības navigācijas īpašību vērtību, izmantojot @odata.bind anotāciju, lai norādītu uz citu ierakstu.
Šeit ir koda piemērs:
Tālāk sniegtajā piemērā tiek atjaunināts konta ieraksts, lai saistītu citu kontaktpersonas ierakstu kā uzņēmuma galveno kontaktpersonu.
// 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
}
);
Novecojusi metode Mobile Offline scenārijam
Piezīmes
Tā vietā, lai izmantotu iepriekšējā piemēra anotāciju @odata.bind , novecojušais meklēšanas objekts ar reģistrjutīgām īpašībām (logicalname un id) joprojām tiek atbalstīts esošajām pielāgošanām. Tomēr anotāciju @odata.bind ieteicams izmantot gan tiešsaistes, gan bezsaistes situācijās, nevis izmantot šo novecojušo objektu.
Tālāk sniegtajā piemērā tiek izmantota novecojusi metode, lai atjauninātu konta ierakstu, lai saistītu citu kontaktpersonas ierakstu kā primāro kontaktpersonu kontam no mobilajiem klientiem, strādājot bezsaistes režīmā.
// 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
}
);
Atjaunināt asociācijas ar saistītajām tabulām pēc tipa Aktivitātes piemērs
Lai atjauninātu asociācijas ar saistītajām tabulām tipa Activity, iestatiet vienas vērtības navigācijas īpašību vērtību, izmantojot @odata.bind anotāciju, lai norādītu uz citu ierakstu.
Saistītās iespējas kolonnas atjaunināšana uzdevumā
// 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
}
);
Atjaunināt uzdevuma kolonnu Attiecībā uz
// 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
}
);
Asociācijas atjaunināšana kolekcijas vērtību navigācijas īpašību piemērs
Izmantojiet Xrm.WebApi.online.execute API, lai sasaistītu un atdalītu kolekcijas vērtību navigācijas īpašības. Šī funkcija nav atbalstīta mobilajās bezsaistes situācijās.