Partajați prin

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.

Valoarea 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.

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 la 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 exemplul de adnotare de mai sus, obiectul de căutare perimat cu proprietăți sensibile la litere mari și mici (logicalname și id) este acceptat în continuare pentru particularizările de expirare. Totuși, se recomandă să utilizați @odata.bind adnotări atât pentru scenariul online, cât și 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 asocierea la tabelele asociate de tip Activitate, setați valoarea proprietăților de navigare cu valoare unică utilizând @odata.bind adnotarea la 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
   }
);

Actualizați asocierile pentru proprietățile de navigare cu valoare de colecție

API-ul Xrm.WebApi.online.execute poate fi utilizat pentru a asocia și a disocia proprietățile de navigare cu valoare de colecție. Acest lucru NU este acceptat pentru scenariile offline pentru dispozitive mobile.

Xrm.WebApi

  • Last updated on