OData v4 डाटा प्रदाता कॉन्फ़िगरेशन और सर्वोत्तम तरीके

यह विषय इस पर लागू होता है Dynamics 365 Customer Engagement (on-premises). इस विषय के Power Apps संस्करण के लिए, देखें: OData v4 डेटा प्रदाता कॉन्फ़िगरेशन

इस विषय में यह वर्णन किया गया है कि कैसे OData v4 डेटा प्रदाता को कॉन्‍फ़ि‍गर किया जाता है, साथ ही एक OData v4 वेब सेवा के साथ कनेक्‍ट करने के लिए OData v4 डेटा प्रदाता का उपयोग करने के लिए आवश्यकताएँ और अनुशंसित श्रेष्ठ प्रथाएँ क्‍या-क्‍या हैं.

OData v4 डेटा प्रदाता श्रेष्ठ प्रथाएँ

• आपकी आवृत्ति के लिए आवश्यक है कि सभी निकाय के पास एक ID एट्रिब्यूट हो. इस ID को युनीक आइडेंटिफ़ायर के रूप में जाना जाता है और मान को guid होना चाहिए. आप ID फ़ील्‍ड को केवल EDM.Guid डेटा प्रकार वाले बाह्य फ़ील्ड पर मैप कर सकते हैं. आप EDM.Int32 डेटा प्रकार को एक युनीक आइडेंटिफ़ायर डेटा प्रकार पर मैप नहीं कर सकते.

• नल योग्‍य गुण वाले OData निकायों को वर्चुअल निकाय में मैप किए गए फ़ील्ड के साथ मेल खाने के लिए सेट किया जाना चाहिए. उदाहरण के लिए, Nullable=False वाली OData निकाय प्रॉपर्टी में फ़ील्ड आवश्यकता विशेषता के साथ मैप किया गया फ़ील्ड होना चाहिए जिसे व्यवसाय आवश्यक पर सेट किया गया हो.

• एकाधिक क्वेरी को पुनर्प्राप्त करने के लिए, जैसे जब आप ग्रिड में डेटा लोड करते हैं, उस समय बाह्य डेटा स्रोत से मिले डेटासेट के आकार को क्वेरी पैरामीटर का चयन और फ़ि‍ल्‍टर करते हुए नियंत्रित करें.

• यदि पहले से ही सक्षम नहीं हैं, तो सिस्टम व्यवस्थापकों को प्लग-इन ट्रेसिंग सक्षम करना चाहिए. सक्षम होने के बाद, OData समापन बिंदु की सभी त्रुटियाँ प्लग-इन ट्रेस लॉग में कैप्चर हो जाती हैं. अधिक जानकारी: सिस्टम सेटिंग संवाद बॉक्स - अनुकूलन टैब

डेटा प्रकार मैपिंग

निम्न तालिका में उपयुक्त डेटा प्रकारों के साथ OData निकाय डेटा मॉडल (EDM) डेटा प्रकार की मैपिंग की सूची दी गई है.

OData डेटा प्रकार	डेटा प्रकार
Edm.Boolean	दो विकल्प
Edm.DateTime	दिनांक और समय
Edm.DateTimeOffset	दिनांक और समय
Edm.Decimal	दशमलव संख्‍या या मुद्रा
Edm.Double	फ़्लोटिंग पाइंट संख्या
Edm.Guid	युनीक आइडेंटिफ़ायर
Edm.Int32	पूर्णांक
Edm.Int64	पूर्णांक
Edm.String	पाठ की एकल पंक्ति या पाठ की एकाधिक पंक्तियाँ

OData EDM डेटा प्रकार जो वर्चुअल निकाय के साथ मैपिंग के लिए समर्थित नहीं हैं

• Edm.Binary

• Edm.Time

• Edm.Float

• Edm.Single

• Edm.Int16

• Edm.Byte

• Edm.SByte

V4 OData डेटा प्रदाता का उपयोग कर डेटा स्रोत जोड़ें

प्रक्रिया आपको बताती है कि वर्चुअल निकाय डेटा स्रोत के रूप में उपयोग करने के लिए किसी आउट-ऑफ़-बॉक्स OData डेटा प्रदाता का उपयोग कैसे करें.

1. सेटिंग्स>प्रशासन>वर्चुअल निकाय डेटा स्रोत पर जाएं.

2. क्रिया टूलबार पर, नया चुनें.

3. डेटा प्रदाता चुनें संवाद बॉक्स में, निम्न डेटा स्रोतों में से चुनें, और फिर ठीक चुनें.

   • OData v4 डेटा प्रदाता. आपके परिवेश में एक Odata v4 डेटा प्रदाता शामिल होता है, जिसका उपयोग उन डेटा स्रोतों से कनेक्ट करने के लिए किया जा सकता है, जो OData v4 जारी मानक का उपयोग करते हैं.

   • कस्टम डेटा प्रदाता. अगर आपने कोई डेटा प्रदाता प्लग-इन आयात किया है, तो डेटा प्रदाता वहाँ दिखाई देगा. अधिक जानकारी: वर्चुअल संस्थाओं के साथ आरंभ करें

4. नए डेटा स्रोत गुण पृष्ठ पर निम्नलिखित फ़ील्ड को पूरा करें और फिर रिकॉर्ड सहेजें.

   • नाम. डेटा स्रोत का वर्णन करने वाला एक नाम टाइप करें.

   • उरी. अगर आप OData डेटा प्रदाता का उपयोग कर रहे हैं, तो OData वेब सेवा के लिए uri दर्ज करें. उदाहरण के लिए, यदि आप Azure में होस्ट की गई वेब सेवा से कनेक्ट करने के लिए OData प्रदाता का उपयोग कर रहे हैं, तो URI कुछ इस तरह दिख सकता है https://contosodataservice.azurewebsites.net/odata/

   • सेकंड में समय समाप्त. एक डेटा अनुरोध के टाइम-आउट होने से पहले वेब सेवा से प्रत्युत्तर के लिए कितनी देर प्रतीक्षा करना होगा, यह समय सेकंड में दर्ज करें. उदाहरण के लिए, टाइम-आउट होने से पहले अधिकतम तीस सेकंड तक प्रतीक्षा करने के लिए 30 दर्ज करें.

   • पृष्ठांकन मोड. क्वेरी परिणाम के पृष्ठ किस प्रकार बनेंगे, इसे नियंत्रित करने के लिए चयन करें कि क्लाइंट-साइड पेजिंग का उपयोग किया जाना है या सर्वर-साइड का पेजिंग का. डिफ़ॉल्ट मान क्लाइंट-साइड पेजिंग है. सर्वर-साइड पेजिंग से सर्वर नियंत्रित करता है कि परिणामों को $skiptoken पैरामीटर, जिसे क्वेरी स्ट्रिंग के लिए जोड़ा जाता है, के उपयोग द्वारा कैसे पृष्ठ बनाया जाता है. अधिक जानकारी: स्किप टोकन सिस्टम क्वेरी विकल्प ($skiptoken)

     • इनलाइन गिनती लौटाएं. परिणाम सेट में कुल संख्‍या रिकॉर्ड्स देता है. इस सेटिंग का उपयोग तब अगली पृष्ठ कार्यक्षमता सक्षम करने के लिए किया जाता है, जब आप ग्रिड पर डेटा लौटाते हैं. यदि OData समाप्ति बिंदु OData $inclinecount पैरामीटर का समर्थन नहीं करता, तो मान ग़लत का उपयोग करें. डिफ़ॉल्ट मान है ग़लत.

   • अनुरोध पैरामीटर. इसके बजाय, आप OData वेब सेवा से कनेक्ट करने के लिए उपयोग होने वाले कस्टम शीर्षलेख या क्वेरी स्ट्रिंग पैरामीटर भी जोड़ सकते हैं, जैसे बाहरी सेवा में प्रमाणीकरण पैरामीटर. हेडर और क्वेरी स्ट्रिंग पैरामीटर और मान के बीच टॉगल करने के लिए क्वेरी स्ट्रिंग का चयन करें। अधिकतम 10 शीर्षलेख या क्वेरी स्ट्रिंग जोड़े जा सकते हैं.

   

भी देखें

ऐसी वर्चुअल इकाइयाँ बनाएँ और संपादित करें जिनमें बाहरी डेटा स्रोत से डेटा शामिल हो
टेकनेट ब्लॉग: नई वर्चुअल इकाइयों का उपयोग करके बाहरी प्रणालियों से डेटा के साथ इंटरैक्ट करें