updateRecord (referință API client)

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

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

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.

Xrm.WebApi