OData v4 डेटा प्रदाता कॉन्फ़िगरेशन, आवश्यकताएँ और श्रेष्ठ प्रथाएँ

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

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

• Microsoft Dataverse चाहता है कि सभी टेबल के पास एक ID एट्रिब्‍यूट होनी चाहिए, यह ID अद्वितीय पहचानकर्ता कहलाती है और इसका मान guid होना चाहिए. आप ID कॉलम को केवल Edm.Guid डेटा प्रकार वाली बाहरी कॉलम पर मैप कर सकते हैं. आप Edm.Int32 डेटा प्रकार को Dataverse में एक युनीक आइडेंटिफ़ायर डेटा प्रकार कॉलम पर मैप नहीं कर सकते.
• निरर्थक गुण वाले OData टेबल को वर्चुअल टेबल में मैप किए गए कॉलम के साथ मेल खाने के लिए सेट किया जाना चाहिए. उदाहरण के लिए, Nullable=False गुण वाले एक OData टेबल के पास Dataverse में मैप किया गया कॉलम होना चाहिए, फ़ील्ड आवश्‍यकता एट्रिब्‍यूट व्यापार आवश्यक है पर सेट होना चाहिए.
• एकाधिक क्वेरी को पुनर्प्राप्त करने के लिए, जैसे जब आप ग्रिड में डेटा लोड करते हैं, उस समय बाह्य डेटा स्रोत से मिले डेटासेट के आकार को क्वेरी पैरामीटर का चयन और फ़ि‍ल्‍टर करते हुए नियंत्रित करें.
• यदि पहले से ही सक्षम नहीं हैं, तो सिस्टम व्यवस्थापकों को प्लग-इन ट्रेसिंग सक्षम करना चाहिए. सक्षम होने के बाद, OData समापन बिंदु की सभी त्रुटियाँ प्लग-इन ट्रेस लॉग में कैप्चर हो जाती हैं. और जानकारी: व्यवस्थापक मार्गदर्शिका: सिस्टम सेटिंग संवाद बॉक्स - अनुकूलन टैब
• आप किसी अन्य परिवेश से कनेक्ट करने के लिए OData v4 डेटा प्रदाता का उपयोग नहीं कर सकते हैं.

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

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

OData डेटा प्रकार	Dataverse डेटा प्रकार
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 डेटा प्रदाता. Dataverse में एक Odata v4 डेटा प्रदाता शामिल होता है, जिसका उपयोग उन डेटा स्रोतों से कनेक्ट करने के लिए किया जा सकता है, जो OData v4 जारी मानक का उपयोग करते हैं.
   • कस्टम डेटा प्रदाता. अगर आपने कोई डेटा प्रदाता प्लग-इन आयात किया है, तो डेटा प्रदाता वहाँ दिखाई देगा. और जानकारी: डेवलपर दस्तावेज़: वर्चुअल टेबल के साथ प्रारंभ करें

4. नया डेटा स्रोत गुण पृष्ठ पर, निम्नलिखित टेबल को पूरा करें और उसके बाद पंक्ति सहेजें.

   • नाम. डेटा स्रोत का वर्णन करने वाला एक नाम टाइप करें.
   • Uri. अगर आप OData डेटा प्रदाता का उपयोग कर रहे हैं, तो OData वेब सेवा के लिए uri दर्ज करें. उदाहरण के लिए, यदि आप Azure में होस्ट की गई वेब सेवा से कनेक्ट करने के लिए OData का उपयोग कर रहे हैं, तो URI https://contosodataservice.azurewebsites.net/odata/ जैसा दिख सकता है.
   • सेकंड में टाइमआउट. एक डेटा अनुरोध के टाइम-आउट होने से पहले वेब सेवा से प्रत्युत्तर के लिए कितनी देर प्रतीक्षा करना होगा, यह समय सेकंड में दर्ज करें. उदाहरण के लिए, टाइम-आउट होने से पहले अधिकतम तीस सेकंड तक प्रतीक्षा करने के लिए 30 दर्ज करें.
   • पृष्ठांकन मोड. क्वेरी परिणाम के पृष्ठ किस प्रकार बनेंगे, इसे नियंत्रित करने के लिए चयन करें कि क्लाइंट-साइड पेजिंग का उपयोग किया जाना है या सर्वर-साइड का पेजिंग का. डिफ़ॉल्ट मान क्लाइंट-साइड पेजिंग है. सर्वर-साइड पेजिंग से सर्वर नियंत्रित करता है कि परिणामों को $skiptoken पैरामीटर, जिसे क्वेरी स्ट्रिंग के लिए जोड़ा जाता है, के उपयोग द्वारा कैसे पृष्ठ बनाया जाता है. और जानकारी: टोकन सिस्टम क्वेरी छोड़ें विकल्प ($skiptoken)
     • इनलाइन गणना लौटाएँ. परिणाम सेट में कुल संख्या पंक्तियों को लौटाता है. इस सेटिंग का उपयोग तब अगली पृष्ठ कार्यक्षमता सक्षम करने के लिए किया जाता है, जब आप ग्रिड पर डेटा लौटाते हैं. यदि OData समाप्ति बिंदु OData $inlinecount पैरामीटर का समर्थन नहीं करता है, तो गलत मान का उपयोग करें. डिफ़ॉल्ट मान है ग़लत.
   • अनुरोध पैरामीटर. इसके बजाय, आप OData वेब सेवा से कनेक्ट करने के लिए उपयोग होने वाले कस्टम शीर्षलेख या क्वेरी स्ट्रिंग पैरामीटर भी जोड़ सकते हैं, जैसे बाहरी सेवा में प्रमाणीकरण पैरामीटर. शीर्षलेख और क्वेरी स्ट्रिंग पैरामीटर और मान के बीच में टॉगल करने के लिए क्वेरी स्ट्रिंग पर क्लिक करें. अधिकतम 10 शीर्षलेख या क्वेरी स्ट्रिंग जोड़े जा सकते हैं.

     

इसे भी देखें

ऐसे वर्चुअल टेबल बनाएँ और संपादित करें, जिनमें किसी बाहरी डेटा स्रोत का डेटा शामिल है

नोट

क्या आप हमें अपनी दस्तावेज़ीकरण भाषा वरीयताओं के बारे में बता सकते हैं? एक छोटा सर्वेक्षण पूरा करें. (कृपया ध्यान दें कि यह सर्वेक्षण अंग्रेज़ी में है)

सर्वेक्षण में लगभग सात मिनट लगेंगे. कोई भी व्यक्तिगत डेटा एकत्र नहीं किया जाता है (गोपनीयता कथन).