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.

Pamata atjauninājums

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

Saistīto tabulu saistību atjaunināšana

Lai atjauninātu saistību ar saistītajiem tabulas ierakstiem (uzmeklēšanas), iestatiet vienas vērtības navigācijas rekvizītu vērtību, @odata.bind izmantojot anotāciju citam ierakstam.

Š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 @odata.bind iepriekš minēto anotācijas piemēru, novecojušais uzmeklēšanas objekts ar reģistrjutīgiem rekvizītiem (logicalname un id) joprojām tiek atbalstīts esošajiem pielāgojumiem. Tomēr ir ieteicams izmantot @odata.bind anotāciju gan tiešsaistes, gan bezsaistes scenārijam, 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
    }
);

Saistību atjaunināšana saistītajām tabulām ar tipu Darbība

Lai atjauninātu saistību ar saistītajām tabulām ar tipu Activity, iestatiet vienas vērtības navigācijas rekvizītu vērtību, izmantojot anotāciju, @odata.bind 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
   }
);

Kolekcijas vērtību navigācijas rekvizītu saistību atjaunināšana

Xrm.WebApi.online.execute API var izmantot, lai saistītu un atsaistītu kolekcijas vērtību navigācijas rekvizītus. Tas NETIEK atbalstīts Mobile Offline scenārijos.

Saistītie raksti

Xrm.WebApi