Notă
Accesul la această pagină necesită autorizare. Puteți încerca să vă conectați sau să modificați directoarele.
Accesul la această pagină necesită autorizare. Puteți încerca să modificați directoarele.
Actualizează o înregistrare de tabel.
Sintaxă
Xrm.WebApi.updateRecord(entityLogicalName, id, data).then(successCallback, errorCallback);
Parametri
| Nume | Type | Obligatoriu | Descriere |
|---|---|---|---|
entityLogicalName |
Șir | Da | Numele logic al înregistrării pe care doriți să o actualizați. De exemplu: account. |
id |
Șir | Da | GUID-ul înregistrării de tabel pe care doriți să o actualizați. |
data |
Obiect | Da | Un obiect JSON care conține key: value perechi, unde key este proprietatea tabelului și value este valoarea proprietății pe care doriți să o actualizați.Consultați Exemple pentru a vedea cum puteți defini data obiectul pentru diverse scenarii de actualizare. |
successCallback |
Funcţie | Nu | O funcție de apelat atunci când o înregistrare este actualizată. Consultați Valoarea returnată |
errorCallback |
Funcţie | Nu | O funcție de apelat atunci când operațiunea eșuează. Se transmite un obiect cu următoarele proprietăți: - errorCode:Număr. Codul de eroare ca număr zecimal pozitiv. De exemplu, codul de eroare documentat ca 0x80040333 va fi returnat ca 2147746611.- message:Șir. Un mesaj de eroare care descrie problema. |
Valoare returnată
La succes, returnează un obiect promisiune către successCallback următoarele proprietăți:
| Nume | Type | Descriere |
|---|---|---|
entityType |
Șir | Numele logic al tabelului pentru înregistrare. |
id |
Șir | GUID-ul înregistrării. |
Exemple
Aceste exemple utilizează unele dintre aceleași obiecte de solicitare, după cum s-a demonstrat în Actualizarea și ștergerea rândurilor de tabel utilizând WEB API pentru a defini obiectul de date pentru actualizarea unei înregistrări de tabel.
| Example | Demonstrează | Exemplu de API Web |
|---|---|---|
| Actualizare de bază | Cum se actualizează valorile de coloană într-o înregistrare de cont existentă. | Actualizare de bază |
| Actualizarea asocierilor cu tabelele asociate | Cum se modifică persoana de contact principală a unui cont utilizând @odata.bind. |
Asocierea cu o proprietate de navigare cu valoare unică |
| Actualizați asocierile la tabelele asociate de tip Activitate | Cum să asociați o activitate cu o oportunitate sau să îi setați căutarea În ceea ce privește un cont. | Asocierea cu o proprietate de navigare cu valoare unică |
| Actualizați asocierile pentru proprietățile de navigare cu valoare de colecție | Cum să asociați și să dezasociați înregistrările asociate utilizând Xrm.WebApi.online.execute. |
Adăugarea unei înregistrări la o colecție și Eliminarea unei înregistrări dintr-o colecție |
Exemplu de actualizare de bază
Actualizează o înregistrare de cont existentă cu ID înregistrare = 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
}
);
Update associations to the related tables example
Pentru a actualiza asocierea la înregistrările de tabel asociate (căutări), setați valoarea proprietăților de navigare cu valoare unică utilizând @odata.bind adnotarea pentru a indica spre altă înregistrare.
Iată un exemplu de cod:
Următorul exemplu actualizează o înregistrare de cont pentru a asocia altă înregistrare de persoană de contact ca persoană de contact principală pentru cont:
// 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
}
);
Metodă perimată pentru scenariul mobil offline
Notă
În loc să utilizați @odata.bind adnotarea din exemplul precedent, obiectul de căutare perimat cu proprietăți sensibile la litere mari și mici (logicalname și id) este acceptat în continuare pentru particularizările existente. Totuși, utilizarea @odata.bind adnotării este recomandată atât pentru scenariile online, cât și pentru cele offline, în loc să utilizați acest obiect perimat.
Următorul exemplu utilizează metoda perimată pentru a actualiza o înregistrare de cont pentru a asocia altă înregistrare de contact ca persoană de contact principală pentru contul de la clienții mobili atunci când lucrați în modul 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
}
);
Update associations to the related tables of type Activity example
Pentru a actualiza asocierile la tabelele asociate de tip Activitate, setați valoarea proprietăților de navigare cu valoare unică, utilizând @odata.bind adnotarea pentru a indica spre altă înregistrare.
Update related opportunity column on task
// 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
}
);
Actualizare cu privire la coloana din activitate
// 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
}
);
Update associations for collection-valued navigation properties example
Utilizați API-ul Xrm.WebApi.online.execute pentru a asocia și a dezasocia proprietățile de navigare cu valoare de colecție. Această caracteristică nu este acceptată pentru scenariile offline pentru dispozitive mobile.