Бөлісу құралы:

updateRecord (Клиент API сілтемесі)

Кесте жазбасын жаңарту.

Синтаксис

Xrm.WebApi.updateRecord(entityLogicalName, id, data).then(successCallback, errorCallback);

Параметрлер

РаT� Түр Талап етіледі Сипаттама
entityLogicalName String Иә Жаңартқыңыз келетін жазбаның кестенің логикалық атауы. Мысалы: account.
id String Иә Жаңартқыңыз келетін кесте жазбасының GUID.
data Нысан Иә Жұптарды қамтитын key: value JSON нысаны, мұндағы key - кестенің сипаты және value жаңартқыңыз келетін қасиеттің мәні.
Әр түрлі жаңарту сценарийлері үшін нысанды қалай анықтауға data болатындығын көру үшін Мысалдарды қараңыз.
successCallback Function Жоқ Жазба жаңартылғанда қоңырау шалу функциясы. Қайтаратын мәнді қараңыз
errorCallback Function Жоқ Операция істен шыққанда қоңырау шалу функциясы. Келесі қасиеттері бар нысан беріледі:
- errorCode: Сан. Қате коды оң ондық сан ретінде. Мысалы, құжатталған 0x80040333 қате коды ретінде 2147746611қайтарылады.
- message: Жол. Ақауды сипаттайтын қате туралы хабар.

Қайтаратын мән

Сәттілік кезінде келесі қасиеттері бар уәде нысанын successCallback қайтарады:

РаT� Түр Сипаттама
entityType String Кестенің логикалық атауы.
id String Есепті шығару.

Мысалдар

Бұл мысалдар кесте жазбасын жаңарту үшін деректер нысанын анықтау үшін веб-API арқылы кесте жолдарын жаңарту және жою бөлімінде көрсетілгендей бірдей сұрау нысандарын пайдаланады.

Негізгі жаңарту

Бұрыннан бар тіркелгі жазбасын жазба идентификаторы = 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
    }
);

Байланысты кесте жазбаларына (іздеулерге) байланыстырымды жаңарту үшін басқа жазбаға аннотацияны пайдаланып @odata.bind бір мәнді шарлау сипаттарының мәнін орнатыңыз.

Міне, код мысалы:

Келесі мысалда тіркелгі жазбасын тіркелгі үшін негізгі контакт ретінде басқа контакт жазбасын байланыстыру үшін тіркелгі жазбасын жаңартады:

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

Мобильді офлайн сценарийіне арналған ескірген әдіс

Ескертпе

Жоғарыдағы аннотация үлгісін пайдаланудың @odata.bind орнына, регистрге сезімтал қасиеттері (logicalname және id) бар ескірген іздеу нысаны реттеулерді іске асыру үшін әлі де қолдау көрсетіледі. Алайда, бұл ескірген нысанды пайдаланудың орнына онлайн және офлайн сценарий үшін аннотацияны қолдану @odata.bind ұсынылады.

Келесі мысалда офлайн режимінде жұмыс істеген кезде мобильді клиенттерден тіркелгі үшін негізгі контакт ретінде басқа контакт жазбасын байланыстыру үшін тіркелгі жазбасын жаңарту үшін ескірген әдіс пайдаланылады:

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

Әрекет түріндегі байланысты кестелерге байланысты байланысты кестелерге байланысты байланысты басқа жазбаға түсініктеме арқылы бір мәнді шарлау сипаттарының @odata.bind мәнін орнатыңыз.

Тапсырмадағы байланысты мүмкіндіктер бағанын жаңарту

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

Тапсырмадағы бағанға қатысты жаңарту

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

Жинақтық мәнді шарлау сипаттары үшін бірлестіктерді жаңарту

Xrm.WebApi.online.execute API жиынтық мәнді шарлау сипаттарын байланыстыру және ажырату үшін пайдалануға болады. Бұл мобильді офлайн сценарийлер үшін қолдау көрсетілмейді .

Xrm.WebAPI

  • Last updated on