नोट
इस पृष्ठ तक पहुंच के लिए प्राधिकरण की आवश्यकता होती है। आप साइन इन करने या निर्देशिकाएँ बदलने का प्रयास कर सकते हैं।
इस पृष्ठ तक पहुंच के लिए प्राधिकरण की आवश्यकता होती है। आप निर्देशिकाएँ बदलने का प्रयास कर सकते हैं।
तालिका रिकॉर्ड अद्यतन करता है.
सिंटैक्स
Xrm.WebApi.updateRecord(entityLogicalName, id, data).then(successCallback, errorCallback);
पैरामीटर्स
| नाम | प्रकार | आवश्य | या क़िस्म |
|---|---|---|---|
entityLogicalName |
तार | हाँ | उस रिकॉर्ड का तालिका तार्किक नाम जिसे आप अद्यतन करना चाहते हैं. उदाहरण के लिए: account. |
id |
तार | हाँ | तालिका रिकॉर्ड का GUID जिसे आप अद्यतन करना चाहते हैं. |
data |
वस्तु | हाँ | एक JSON ऑब्जेक्ट जिसमें जोड़े होते key: value हैं, जहां key तालिका की संपत्ति है और value यह उस संपत्ति का मूल्य है जिसे आप अपडेट करना चाहते हैं।यह देखने के लिए उदाहरण देखें कि आप विभिन्न अद्यतन परिदृश्यों के लिए ऑब्जेक्ट को data कैसे परिभाषित कर सकते हैं। |
successCallback |
फ़ंक्शन | नहीं | रिकॉर्ड अपडेट होने पर कॉल करने के लिए एक फ़ंक्शन। रिटर्न वैल्यू देखें |
errorCallback |
फ़ंक्शन | नहीं | ऑपरेशन विफल होने पर कॉल करने के लिए एक फ़ंक्शन। निम्न गुणों के साथ एक ऑब्जेक्ट पास किया जाता है: - errorCode:संख्या। त्रुटि कोड एक धनात्मक दशमलव संख्या के रूप में। उदाहरण के लिए, के रूप में 0x80040333 प्रलेखित त्रुटि कोड के रूप में 2147746611लौटाया जाएगा।- message:तार। समस्या का वर्णन करने वाला एक त्रुटि संदेश. |
वापसी मान
सफलता पर, निम्नलिखित गुणों के साथ एक वादा ऑब्जेक्ट successCallback लौटाता है:
| नाम | प्रकार | या क़िस्म |
|---|---|---|
entityType |
तार | रिकॉर्ड की तालिका तार्किक नाम. |
id |
तार | रिकॉर्ड का GUID। |
उदाहरण
ये उदाहरण कुछ उसी अनुरोध ऑब्जेक्ट का उपयोग करते हैं जैसा कि तालिका रिकॉर्ड को अद्यतन करने के लिए डेटा ऑब्जेक्ट को परिभाषित करने के लिए वेब API का उपयोग करके तालिका पंक्तियों को अद्यतन करें और हटाएँ ।
मूल अद्यतन
रिकॉर्ड 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
}
);
संबंधित तालिकाओं के लिए संबद्धताओं को अद्यतन करें
संबंधित तालिका रिकॉर्ड्स (लुकअप) से संबद्धता का अद्यतन करने के लिए, एनोटेशन का @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 का उपयोग संग्रह-मूल्यवान नेविगेशन गुणों को संबद्ध और असंबद्ध करने के लिए किया जा सकता है। यह मोबाइल ऑफ़लाइन परिदृश्यों के लिए समर्थित नहीं है.