createRecord (क्लाइंट एपीआई संदर्भ)

कोई तालिका रिकॉर्ड बनाता है.

सिंटैक्स

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

पैरामीटर

नाम	प्रकार	आवश्य	विवरण
entityLogicalName	तार	हाँ	उस तालिका का तार्किक नाम जिसे आप बनाना चाहते हैं. उदाहरण के लिए: account.
data	वस्तु	हाँ	एक JSON ऑब्जेक्ट जो नए तालिका रिकॉर्ड के लिए स्तंभों और मानों को परिभाषित करता है। उदाहरण देखें
successCallback	फ़ंक्शन	नहीं	रिकॉर्ड बनाए जाने पर कॉल करने के लिए एक फ़ंक्शन। रिटर्न वैल्यू देखें
errorCallback	फ़ंक्शन	नहीं	ऑपरेशन विफल होने पर कॉल करने के लिए एक फ़ंक्शन। निम्न गुणों के साथ एक ऑब्जेक्ट पास किया जाता है: - errorCode:संख्या। त्रुटि कोड एक धनात्मक दशमलव संख्या के रूप में। उदाहरण के लिए, के रूप में 0x80040333 प्रलेखित त्रुटि कोड के रूप में 2147746611लौटाया जाएगा। - message:तार। समस्या का वर्णन करने वाला एक त्रुटि संदेश.

वापसी मान

सफलता पर, निम्नलिखित गुणों के साथ एक वादा ऑब्जेक्ट successCallback लौटाता है:

नाम	प्रकार	विवरण
entityType	तार	नए रिकॉर्ड की तालिका तार्किक नाम.
id	तार	नए रिकॉर्ड का GUID।

उदाहरण

ये उदाहरण एक ही अनुरोध ऑब्जेक्ट में प्रदर्शित के रूप में एक तालिका रिकॉर्ड बनाने के लिए डेटा ऑब्जेक्ट को परिभाषित करने के लिए वेब API का उपयोग कर एक तालिका पंक्ति बनाएँ का उपयोग करें।

बुनियादी निर्माण

एक नमूना खाता रिकॉर्ड बनाता है.

// 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 लुकअप विशेषता के समान नहीं होते हैं. आपको सुनिश्चित करना चाहिए कि आप वेब API $metadata सेवा दस्तावेज़ में तत्व के NavigationProperty विशेषता मान का उपयोग कर Name रहे हैं। अधिक जानकारी: Web 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 का उपयोग करके एक तालिका पंक्ति बनाएँ
एक्सआरएम.वेबएपीआई