updateRecord (klienta API atsauce)

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

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

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.

Xrm.WebApi