नोट
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप साइन इन करने या निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
कोई तालिका रिकॉर्ड बनाता है.
सिंटैक्स
Xrm.WebApi.createRecord(entityLogicalName, data).then(successCallback, errorCallback);
पैरामीटर
| नाम | प्रकार | आवश्य | विवरण |
|---|---|---|---|
entityLogicalName |
तार | हाँ | उस तालिका का तार्किक नाम जिसे आप बनाना चाहते हैं. उदाहरण के लिए: account. |
data |
वस्तु | हाँ | एक JSON ऑब्जेक्ट जो नए तालिका रिकॉर्ड के लिए स्तंभों और मानों को परिभाषित करता है। उदाहरण देखें |
successCallback |
फ़ंक्शन | नहीं | रिकॉर्ड बनाए जाने पर कॉल करने के लिए एक फ़ंक्शन। रिटर्न वैल्यू देखें |
errorCallback |
फ़ंक्शन | नहीं | ऑपरेशन विफल होने पर कॉल करने के लिए एक फ़ंक्शन। निम्न गुणों के साथ एक ऑब्जेक्ट पास किया जाता है: - errorCode:संख्या। त्रुटि कोड एक धनात्मक दशमलव संख्या के रूप में। उदाहरण के लिए, के रूप में 0x80040333 प्रलेखित त्रुटि कोड के रूप में 2147746611लौटाया जाएगा।- message:तार। समस्या का वर्णन करने वाला एक त्रुटि संदेश. |
मान देता है
सफलता पर, निम्नलिखित गुणों के साथ एक वादा ऑब्जेक्ट successCallback लौटाता है:
| नाम | प्रकार | विवरण |
|---|---|---|
entityType |
तार | नए रिकॉर्ड की तालिका तार्किक नाम. |
id |
तार | नए रिकॉर्ड का GUID। |
उदाहरण
ये उदाहरण निम्न आलेख के रूप में एक ही अनुरोध ऑब्जेक्ट का उपयोग करें: वेब API का उपयोग कर कोई तालिका पंक्ति बनाएँ। आलेख दिखाता है कि तालिका रिकॉर्ड बनाने के लिए डेटा ऑब्जेक्ट को कैसे परिभाषित किया जाए.
| उदाहरण | दर्शाता | वेब एपीआई उदाहरण |
|---|---|---|
| बुनियादी निर्माण | स्तंभ मानों के साथ खाता रिकॉर्ड कैसे बनाएं. | बुनियादी निर्माण |
| प्राथमिक रिकॉर्ड के साथ संबंधित तालिका रिकॉर्ड बनाएँ | एक कार्रवाई में खाता और संबंधित संपर्क, अवसर और कार्य रिकॉर्ड कैसे बनाएं. | एक कार्रवाई में संबंधित तालिका पंक्तियाँ बनाएँ |
| नए रिकॉर्ड्स बनाते समय तालिकाओं को संबद्ध करना | किसी मौजूदा संपर्क के साथ नए खाते को कैसे संबद्ध करें @odata.bind. |
बनाने पर तालिका पंक्तियों को संबद्ध करें |
मूल उदाहरण बनाएं
एक नमूना खाता रिकॉर्ड बनाता है.
// define the data to create new account
var data =
{
"name": "Sample Account",
"creditonhold": false,
"address1_latitude": 47.639583,
"description": "This is the description of the sample account",
"revenue": 5000000,
"accountcategorycode": 1,
"opendeals_date": new Date("2024-02-03T00:00:00Z")
}
// create account record
Xrm.WebApi.createRecord("account", data).then(
function success(result) {
console.log("Account created with ID: " + result.id);
// perform operations on record creation
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
नोट
प्राथमिक छवि के साथ रिकॉर्ड बनाना ऑफ़लाइन मोड के लिए समर्थित नहीं है. आप केवल ऑनलाइन मोड में बनाएँ का उपयोग करके प्राथमिक छवियाँ सेट कर सकते हैं। आप बनाएँ का उपयोग करके अन्य छवि स्तंभ सेट नहीं कर सकते. प्राथमिक छवियों के बारे में अधिक जानें
प्राथमिक रिकॉर्ड उदाहरण के साथ संबंधित तालिका रिकॉर्ड बनाएँ
आप एक दूसरे से संबंधित तालिकाओं को नेविगेशन गुण मानों के रूप में परिभाषित करके बना सकते हैं। इस पैटर्न को डीप इंसर्ट के रूप में जाना जाता है। इस उदाहरण में, आप प्राथमिक संपर्क रिकॉर्ड और एक संबद्ध अवसर रिकॉर्ड के साथ एक नमूना खाता रिकॉर्ड बनाएँ।
नोट
एकल निर्माण कार्रवाई में संबंधित तालिका रिकॉर्ड्स बनाना ऑफ़लाइन मोड के लिए समर्थित नहीं है.
// define data to create primary and related table records
var data =
{
"name": "Sample Account",
"primarycontactid":
{
"firstname": "John",
"lastname": "Smith"
},
"opportunity_customer_accounts":
[
{
"name": "Opportunity associated to Sample Account",
"Opportunity_Tasks":
[
{ "subject": "Task associated to opportunity" }
]
}
]
}
// create account record
Xrm.WebApi.createRecord("account", data).then(
function success(result) {
console.log("Account created with ID: " + result.id);
// perform operations on record creation
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
नए रिकॉर्ड्स उदाहरण बनाते समय तालिकाओं को संबद्ध करें
नए तालिका रिकॉर्ड्स को मौजूदा तालिका रिकॉर्ड्स से संबद्ध करने के लिए, एनोटेशन का उपयोग करके @odata.bind एकल-मान वाले नेविगेशन गुणों का मान सेट करें.
नोट
एकल-मान वाले नेविगेशन गुणों के नाम हमेशा LogicalName लुकअप विशेषता के समान नहीं होते हैं. सुनिश्चित करें कि आप वेब एपीआई $metadata सेवा दस्तावेज़ में तत्व के विशेषता NavigationProperty मान का उपयोग कर Name रहे हैं। अधिक जानकारी के लिए, वेब API नेविगेशन गुण देखें.
यहां एक कोड उदाहरण दिया गया है:
निम्न उदाहरण एक खाता रिकॉर्ड बनाता है और इसे किसी मौजूदा संपर्क रिकॉर्ड से संबद्ध करता है ताकि बाद वाले को नए खाता रिकॉर्ड के लिए प्राथमिक संपर्क के रूप में सेट किया जा सके:
var data =
{
"name": "Sample Account",
"primarycontactid@odata.bind": "/contacts(465b158c-541c-e511-80d3-3863bb347ba8)"
}
// create account record
Xrm.WebApi.createRecord("account", data).then(
function success(result) {
console.log("Account created with ID: " + result.id);
// perform operations on record creation
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
मोबाइल ऑफ़लाइन परिदृश्य के लिए बहिष्कृत विधि
नोट
पहले दिखाए गए @odata.bind एनोटेशन उदाहरण का उपयोग करने के बजाय, केस-संवेदी गुणों ( औरlogicalname ) idके साथ बहिष्कृत लुकअप ऑब्जेक्ट अभी भी मौजूदा अनुकूलन के लिए समर्थित है। हालाँकि, इस बहिष्कृत ऑब्जेक्ट का उपयोग करने के बजाय ऑनलाइन और ऑफ़लाइन दोनों परिदृश्यों के लिए एनोटेशन का @odata.bind उपयोग करें।
निम्न उदाहरण खाता रिकॉर्ड बनाने के लिए बहिष्कृत विधि का उपयोग करता है और ऑफ़लाइन मोड में कार्य करते समय मोबाइल क्लाइंट से नए खाता रिकॉर्ड के लिए प्राथमिक संपर्क के रूप में बाद वाले को सेट करने के लिए इसे किसी मौजूदा संपर्क रिकॉर्ड से संबद्ध करता है:
var data =
{
"name": "Sample Account",
"primarycontactid":
{
"logicalname": "contact",
"id": "465b158c-541c-e511-80d3-3863bb347ba8"
}
}
// create account record
Xrm.WebApi.offline.createRecord("account", data).then(
function success(result) {
console.log("Account created with ID: " + result.id);
// perform operations on record creation
},
function (error) {
console.log(error.message);
// handle error conditions
}
);
संबंधित आलेख
वेब API का उपयोग करके एक तालिका पंक्ति बनाएँ
एक्सआरएम.वेबएपीआई