openForm (क्लाइंट API संदर्भ)

निकाय प्रपत्र या त्वरित बनाएँ प्रपत्र खोलता है.

नोट

किसी मुख्य प्रपत्र को संवाद के रूप में खोलने के लिए, इसके बजाय navigateTo विधि का उपयोग करें. अधिक जानकारी: क्लाइंट API का उपयोग करके संवाद में मुख्य फ़ॉर्म खोलें

सिंटैक्स

Xrm.Navigation.openForm(entityFormOptions, formParameters).then(successCallback, errorCallback);

पैरामीटर

नाम	प्रकार	आवश्यक	विवरण
entityFormOptions	ऑब्जेक्ट	हां	फॉर्म खोलने के लिए फॉर्म विकल्प। entityFormOptions ऑब्जेक्ट देखें
formParameters	ऑब्जेक्ट	नहीं	एक शब्दकोश ऑब्जेक्ट जो प्रपत्र में अतिरिक्त पैरामीटर पास करता है. अमान्य पैरामीटर एक त्रुटि के कारण होते हैं। किसी प्रपत्र में पैरामीटर्स पास करने के बारे में जानकारी के लिए, किसी प्रपत्र में पास किए गए पैरामीटर्स का उपयोग करके स्तंभ मान सेट करना और कस्टम क्वेरीस्ट्रिंग पैरामीटर्स को स्वीकार करने के लिए प्रपत्र कॉन्फ़िगर करना देखें.
successCallback	फ़ंक्शन	नहीं	त्वरित निर्माण प्रपत्र में रिकॉर्ड सहेजे जाने पर निष्पादित करने के लिए एक फ़ंक्शन. यह फ़ंक्शन किसी ऑब्जेक्ट को पैरामीटर के रूप में स्वीकार करता है। ऑब्जेक्ट में प्रदर्शित या बनाए गए रिकॉर्ड की पहचान करने के लिए निम्न गुणों के साथ एक savedEntityReference सरणी है: - entityType: तालिका का तार्किक नाम। - id: रिकॉर्ड के लिए एक GUID मान का एक स्ट्रिंग प्रतिनिधित्व। - name: प्रदर्शित या बनाए गए रिकॉर्ड का प्राथमिक स्तंभ मान। नोट: - successCallback जब आप किसी मौजूदा या नए रिकॉर्ड के लिए कोई फॉर्म खोलते हैं तो फ़ंक्शन निष्पादित नहीं होता है। - फ़ंक्शन केवल successCallback तभी निष्पादित होता है जब आप एक त्वरित क्रिएट फॉर्म में एक रिकॉर्ड सहेजते हैं जिसे ओपनफॉर्म विधि का उपयोग करके खोला गया था।
errorCallback	फ़ंक्शन	नहीं	ऑपरेशन विफल होने पर निष्पादित करने के लिए एक फ़ंक्शन।

entityFormOptions ऑब्जेक्ट

ऑब्जेक्ट में निम्न मान हैं:

नाम	प्रकार	आवश्यक	विवरण
entityName	तार	हां	प्रपत्र प्रदर्शित करने के लिए तालिका का तार्किक नाम.
entityId	तार	नहीं	प्रपत्र प्रदर्शित करने के लिए तालिका रिकॉर्ड की आईडी.
formId	तार	नहीं	प्रदर्शित किए जाने वाले प्रपत्र आवृत्ति की ID.
cmdbar	बूल	नहीं	इंगित करता है कि आदेश पट्टी प्रदर्शित करनी है या नहीं. यदि आप इस पैरामीटर को निर्दिष्ट नहीं करते हैं, तो कमांड बार डिफ़ॉल्ट रूप से प्रदर्शित होता है। पैरामीटर को सत्य के रूप में पारित करने openInNewWindow की आवश्यकता है।
createFromEntity	लुकअप	नहीं	एक रिकॉर्ड निर्दिष्ट करता है जो मैप किए गए स्तंभ मानों के आधार पर डिफ़ॉल्ट मान प्रदान करता है. लुकअप ऑब्जेक्ट में निम्न स्ट्रिंग गुण होते हैं: entityType, , idऔर name (वैकल्पिक)।
openInNewWindow	बूल	नहीं	इंगित करता है कि प्रपत्र को नई विंडो में प्रदर्शित करना है या नए टैब में. यदि आप ऊँचाई या चौड़ाई के लिए मान निर्दिष्ट true करते हैं और निर्दिष्ट नहीं करते हैं, तो प्रपत्र एक नए टैब में प्रदर्शित होता है. किसी प्रपत्र को नई विंडो या नए टैब में खोलने से प्रपत्र का रेंडरिंग उसी टैब पर प्रपत्र खोलने की तुलना में धीमा हो जाता है; इसके बजाय मुख्य प्रपत्र संवाद में कोई प्रपत्र खोलने पर विचार करें. यह गुण वर्तमान में त्वरित बनाएँ प्रपत्रों के लिए समर्थित नहीं है, क्योंकि उन्हें किसी नई विंडो या टैब में नहीं खोला जा सकता है.
height	संख्या	नहीं	पिक्सेल में प्रदर्शित होने वाली प्रपत्र विंडो की ऊँचाई. पैरामीटर को सत्य के रूप में पारित करने openInNewWindow की आवश्यकता है।
width	संख्या	नहीं	पिक्सेल में प्रदर्शित होने वाली प्रपत्र विंडो की चौड़ाई. पैरामीटर को सत्य के रूप में पारित करने openInNewWindow की आवश्यकता है।
navbar	तार	नहीं	नियंत्रित करता है कि नेविगेशन पट्टी प्रदर्शित की जाए या नहीं और साइटमैप में परिभाषित क्षेत्रों और उपक्षेत्रों का उपयोग करके अनुप्रयोग नेविगेशन उपलब्ध है या नहीं. मान्य मान हैं: on, , offया .entity openInNewWindow पैरामीटर को सत्य के रूप में पास करने की आवश्यकता है। - on: नेविगेशन बार प्रदर्शित होता है। यह डिफ़ॉल्ट व्यवहार है यदि नेवबार पैरामीटर का उपयोग नहीं किया जाता है। - off: नेविगेशन बार प्रदर्शित नहीं होता है। लोग अन्य उपयोगकर्ता इंटरफ़ेस तत्वों या पीछे और आगे बटन का उपयोग करके नेविगेट कर सकते हैं। - entity: किसी प्रपत्र पर, केवल संबंधित तालिकाओं के लिए नेविगेशन विकल्प उपलब्ध होते हैं. संबंधित तालिका पर नेविगेट करने के बाद, मूल रिकॉर्ड पर लौटने की अनुमति देने के लिए नेविगेशन बार में एक बैक बटन प्रदर्शित होता है।
relationship	ऑब्जेक्ट	नहीं	प्रपत्र पर संबंधित रिकॉर्ड्स प्रदर्शित करने के लिए कोई संबंध ऑब्जेक्ट निर्धारित करें. संबंध ऑब्जेक्ट देखें
selectedStageId	तार	नहीं	व्यवसाय प्रक्रिया आवृत्ति में चयनित चरण की आईडी.
useQuickCreateForm	बूल	नहीं	इंगित करता है कि त्वरित निर्माण प्रपत्र खोलना है या नहीं. त्वरित निर्माण प्रपत्र प्रदर्शित करने के लिए तालिका में त्वरित निर्माण की अनुमति दें विकल्प सक्षम होना चाहिए और आपको अपने अनुप्रयोग में तालिका और त्वरित निर्माण प्रपत्र भी जोड़ना होगा. यदि आप का मान useQuickCreateFormनिर्दिष्ट नहीं करते हैं, तो डिफ़ॉल्ट पर सेट falseहै।

संबंध वस्तु

ऑब्जेक्ट में निम्न मान हैं।

नाम	प्रकार	विवरण
attributeName	तार	संबंध के लिए उपयोग किए जाने वाले स्तंभ का नाम.
name	तार	संबंध के लिए उपयोग किए जाने वाले स्तंभ का नाम.
navigationPropertyName	तार	संबंध के लिए उपयोग किए जाने वाले स्तंभ का नाम.
relationshipType	संख्या	संबंध प्रकार। निम्न मानों में से कोई एक निर्दिष्ट करें: - 0:OneToMany - 1:कई से कई
roleType	संख्या	रिश्ते में भूमिका का प्रकार। निम्न मानों में से कोई एक निर्दिष्ट करें: - 1:संदर्भ - 2:एसोसिएशन इकाई

टिप्पणी

आप तालिका को खोलने के लिए या त्वरित प्रपत्र बनाने के बजाय deprecated Xrm.Utility.openEntityForm और Xrm.Utility.openQuickCreate विधियों का उपयोग करना चाहिए।

किसी विशेष व्यवसाय प्रक्रिया को प्रदर्शित करने के लिए setActiveProcess का उपयोग करें और प्रपत्र पर किसी विशेष व्यवसाय प्रक्रिया आवृत्ति को प्रदर्शित करने के लिए setActiveProcessInstance का उपयोग करें।

उदाहरण

उदाहरण 1: मौजूदा रिकॉर्ड के लिए कोई प्रपत्र खोलें

निम्न नमूना कोड किसी मौजूदा संपर्क रिकॉर्ड को प्रदर्शित करने के लिए कोई संपर्क प्रपत्र खोलता है:

var entityFormOptions = {};
entityFormOptions["entityName"] = "contact";
entityFormOptions["entityId"] = "00aa00aa-bb11-cc22-dd33-44ee44ee44ee";

// Open the form.
Xrm.Navigation.openForm(entityFormOptions).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

उदाहरण 2: नए रिकॉर्ड के लिए कोई प्रपत्र खोलें

निम्न नमूना कोड एक नया रिकॉर्ड बनाने के लिए कुछ पूर्व-पॉपुलेटेड मानों के साथ एक संपर्क प्रपत्र खोलता है:

var entityFormOptions = {};
entityFormOptions["entityName"] = "contact";

// Set default values for the Contact form
var formParameters = {};
formParameters["firstname"] = "Sample";
formParameters["lastname"] = "Contact";
formParameters["fullname"] = "Sample Contact";
formParameters["emailaddress1"] = "contact@adventure-works.com";
formParameters["jobtitle"] = "Sr. Marketing Manager";
formParameters["donotemail"] = "1";
formParameters["description"] = "Default values for this record were set programmatically.";

// Set lookup column
formParameters["preferredsystemuserid"] = "3493e403-fc0c-eb11-a813-002248e258e0"; // ID of the user.
formParameters["preferredsystemuseridname"] = "Admin user"; // Name of the user.
// End of set lookup column

// Open the form.
Xrm.Navigation.openForm(entityFormOptions, formParameters).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

उदाहरण 3: नए रिकॉर्ड के लिए कोई प्रपत्र खोलें (जटिल लुकअप)

निम्न नमूना कोड एक नया रिकॉर्ड बनाने के लिए कुछ पूर्व-पॉप्युलेटेड मानों (एक जटिल लुकअप सहित) के साथ एक गतिविधि प्रपत्र खोलता है:

var entityFormOptions = {};
entityFormOptions["entityName"] = "email";

// Set default values for the Contact form
var formParameters = {};
formParameters["subject"] = "Sample";
formParameters["description"] = "Default values for this record were set programmatically.";

// Set lookup column
formParameters["regardingobjectid"] = "3493e403-fc0c-eb11-a813-002248e258e0"; // ID of the user.
formParameters["regardingobjectidname"] = "Admin user"; // Name of the user.
formParameters["regardingobjectidtype"] = "systemuser"; // Table name. 
// End of set lookup column

// Open the form.
Xrm.Navigation.openForm(entityFormOptions, formParameters).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

उदाहरण 4: एक त्वरित निर्माण प्रपत्र खोलें

निम्न नमूना कोड कुछ पूर्व-पॉप्युलेटेड मानों के साथ एक त्वरित संपर्क फ़ॉर्म खोलता है:

var entityFormOptions = {};
entityFormOptions["entityName"] = "contact";
entityFormOptions["useQuickCreateForm"] = true;

// Set default values for the Contact form
var formParameters = {};
formParameters["firstname"] = "Sample";
formParameters["lastname"] = "Contact";
formParameters["fullname"] = "Sample Contact";
formParameters["emailaddress1"] = "contact@adventure-works.com";
formParameters["jobtitle"] = "Sr. Marketing Manager";
formParameters["donotemail"] = "1";
formParameters["description"] = "Default values for this record were set programmatically.";

// Set lookup column
formParameters["preferredsystemuserid"] = "3493e403-fc0c-eb11-a813-002248e258e0"; // ID of the user.
formParameters["preferredsystemuseridname"] = "Admin user"; // Name of the user.
formParameters["preferredsystemuseridtype"] = "systemuser"; // Table name.
// End of set lookup column

// Open the form.
Xrm.Navigation.openForm(entityFormOptions, formParameters).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

संबंधित आलेख

Xrm.Navigation