नोट
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप साइन इन करने या निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
तालिका रिकॉर्ड अद्यतन करता है.
सिंटैक्स
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 का उपयोग करके तालिका पंक्तियों को अद्यतन करें और हटाएँ ।
| उदाहरण | दर्शाता | वेब एपीआई उदाहरण |
|---|---|---|
| मूल अद्यतन | किसी मौजूदा खाता रिकॉर्ड पर स्तंभ मानों का अद्यतन करने के लिए कैसे. | मूल अद्यतन |
| संबंधित तालिकाओं के लिए संबद्धताओं को अद्यतन करें | इसका उपयोग करके @odata.bindकिसी खाते का प्राथमिक संपर्क कैसे बदलें. |
एकल-मूल्यवान नेविगेशन प्रॉपर्टी के साथ संबद्ध करें |
| गतिविधि प्रकार की संबंधित तालिकाओं के लिए संबद्धताओं को अद्यतन करें | किसी कार्य को किसी अवसर के साथ कैसे संबद्ध करें या किसी खाते के संबंध में लुकअप कैसे सेट करें. | एकल-मूल्यवान नेविगेशन प्रॉपर्टी के साथ संबद्ध करें |
| संग्रह-मूल्यवान नेविगेशन गुणों के लिए संबद्धता अद्यतन करें | का उपयोग करके Xrm.WebApi.online.executeसंबंधित रिकॉर्ड को कैसे संबद्ध और अलग करें। |
किसी संग्रह में कोई रिकॉर्ड जोड़ना और किसी संग्रह से कोई रिकॉर्ड निकालना |
मूल अद्यतन उदाहरण
रिकॉर्ड 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 का उपयोग करें। यह सुविधा मोबाइल ऑफ़लाइन परिदृश्यों के लिए समर्थित नहीं है.