बाहरी स्रोत के डेटा से वर्चुअल इकाई बनाएं या संपादित करें

यह विषय इस पर लागू होता है Dynamics 365 Customer Engagement (on-premises). इस विषय के Power Apps संस्करण के लिए, देखें: ऐसी वर्चुअल इकाइयाँ बनाएँ और संपादित करें जिनमें बाहरी डेटा स्रोत से डेटा शामिल हो

वर्चुअल निकाय Dynamics 365 Customer Engagement (on-premises) में एक कस्टम निकाय होता है, इसकी फ़ील्ड्स में बाहरी डेटा स्रोत का डेटा होता है. आपके अनुप्रयोग में उपयोगकर्ताओं को वर्चुअल निकाय नियमित निकाय रिकॉर्ड के रूप में दिखाई देते हैं, लेकिन उनमें बाहरी डेटाबेस से स्रोत किया गया डेटा शामिल होता है, जैसे Azure SQL डेटाबेस. वर्चुअल निकायों पर आधारित रिकॉर्ड सभी क्लाइंट में उपलब्ध हैं, जिनमें Dynamics 365 Customer Engagement वेब सेवाओं का उपयोग करके विकसित कस्टम क्लाइंट भी शामिल हैं.

पूर्व में, अलग-अलग डेटा स्रोतों को एकीकृत करने के लिए आपको एक कनेक्टर बनाने की ज़रूरत होती थी, ताकि डेटा को स्थानांतरित किया जा सके या एक कस्टम प्लग-इन बनाया जा सके, क्लायंट या सर्वर पक्ष का. हालाँकि, वर्चुअल निकायों की मदद से आप सीधे किसी बाहरी डेटा स्रोत से रनटाइम पर कनेक्ट कर सकते हैं, ताकि बाहरी डेटा स्रोत का विशिष्ट डेटा परिवेश में डेटा प्रतिकृति की ज़रूरत के बिना उपलब्ध हो.

वर्चुअल निकाय तीन मुख्य घटकों से बने होते हैं, एक डेटा प्रदाता, एक डेटा स्रोत रिकॉर्ड, और एक वर्चुअल निकाय। डेटा प्रदाता में प्लग-इन और डेटा स्रोत निकाय होते हैं. डेटा स्रोत Dynamics 365 Customer Engagement (on-premises) में एक निकाय रिकॉर्ड होता है, जिसमें स्कीमा और कनेक्शन पैरामीटर को दर्शाने वाला मेटाडेटा शामिल होता है. हर एक वर्चुअल निकाय निकाय परिभाआषा के एक डेटा स्रोत को संदर्भित करता है.

Dynamics 365 Customer Engagement (on-premises) में एक OData डेटा प्रदाता होता है, जिसका उपयोग करके आप एक ऐसी OData v4 वेब सेवा से कनेक्ट कर सकते हैं, जिसकी बाहरी डेटा तक पहुँच होती है.

इसके बजाय, डेवलपर अपने डेटा प्रदाता भी बना सकते हैं. डेटा प्रदाता परिवेश में एक समाधान के रूप में स्थापित होते हैं. अधिक जानकारी: वर्चुअल संस्थाओं के साथ आरंभ करें

वर्चुअल निकाय के लाभ

• डेवलपर्स Dynamics 365 Customer Engagement वेब सेवाएँ और Customer Engagement प्लग-इन पंजीकरण उपकरण का उपयोग करके बाह्य डेटा पढ़ने के लिए प्लग-इन लागू कर सकते हैं.

• सिस्टम अनुकूलक Dynamics 365 Customer Engagement (on-premises) का उपयोग करता है, ताकि डेटा स्रोत रिकॉर्ड को कॉन्फ़िगर कर सके और ऐसे वर्चुअल निकाय बना सके, जिनका उपयोग बिना कोई कोड लिखे बाहरी डेटा तक पहुँचने के लिए किया जाता है.

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

वर्चुअल निकायों के उपयोग के लिए एक डेटा स्रोत जोड़ें

वर्चुअल निकाय के लिए उपयोग करने हेतु डेवलपर डेटा प्रदाता के रूप में एक कस्टम प्लग-इन बनाते हैं. वैकल्पिक रूप से, आप दिए गए OData v4 डेटा प्रदाता का उपयोग कर सकते हैं. अधिक जानकारी: OData v4 डेटा प्रदाता कॉन्फ़िगरेशन, आवश्यकताएं, और सर्वोत्तम अभ्यास

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

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

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

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

   • OData v4 डेटा प्रदाता. Dynamics 365 Customer Engagement (on-premises) में एक OData डेटा प्रदाता होता है, जिसका उपयोग OData v4 वेब सेवाओं के साथ किया जा सकता है. अधिक जानकारी: OData v4 डेटा प्रदाता कॉन्फ़िगरेशन, आवश्यकताएं, और सर्वोत्तम अभ्यास

डेटा स्रोत में एक सुरक्षित फ़ील्ड जोड़ें

आप डेटा स्रोत के लिए फ़ील्ड्स उसी तरीके से बनाते हैं, जैसे आप किसी अन्य निकाय के लिए बनाते हैं. एन्क्रिप्ट या संवेदनशील डेटा के लिए, डेटा स्रोत गुप्त एट्रिब्यूट को डेटा स्रोत के कस्टम फ़ील्ड पर सक्षम करें. उदाहरण के लिए, डेटाबेस कनेक्शन स्ट्रिंग वाले फ़ील्ड को सुरक्षित करना.

नोट

डेटा स्रोत गुप्त एट्रिब्यूट केवल डेटा स्रोत प्रपत्र में जोड़े गए फ़ील्ड्स के साथ उपलब्ध है.

एक वर्चुअल निकाय बनाएँ

आप Customer Engagement में किसी भी अन्य निकाय की तरह ही एक वर्चुअल निकाय बनाते हैं, जिसमें यहाँ वर्णित कुछ अतिरिक्त विशेषताएँ शामिल होती हैं.

नोट

यद्यपि आप डेटा स्रोत के रूप में कोई नहीं का चयन करके एक वर्चुअल इकाई बना सकते हैं, लेकिन डेटा प्राप्त करने के लिए एक वर्चुअल इकाई को डेटा स्रोत की आवश्यकता होती है। अधिक जानकारी: वर्चुअल इकाइयों के लिए उपयोग करने हेतु डेटा स्रोत जोड़ें

1. सेटिंग्‍स>अनुकूलन>सिस्टम अनुकूलित करें पर जाएँ.

2. समाधान एक्सप्लोरर में एक नया निकाय बनाएँ. ऐसा करने के लिए, बाएँ नेविगेशन फलक में निकाय चुनें, और फिर नयाचुनें.

3. एंटिटी डेफ़िनिशन के जनरलटैब पर, वर्चुअल एंटिटी का चयन करें, और फिर डेटा स्रोत ड्रॉप डाउन सूची में, वह डेटा स्रोत चुनें जिसे आप चाहते हैं।

   

4. निकाय परिभाषा पर निम्नलिखित आवश्यक फ़ील्ड पूरा करें.

   • बाह्य नाम. तालिका के नाम को उस बाहरी डेटा स्रोत में दर्ज करें, जिस पर यह निकाय मैप होता है.

   • बाह्य संग्रह नाम. तालिका के बहुवचन नाम को उस बाहरी डेटा स्रोत में दर्ज करें, जिस पर यह निकाय मैप होता है.

     यहाँ मूवी नामक एक वर्चुअल इकाई का उदाहरण दिया गया है जो दस्तावेज़ फ़ाइलों तक पहुँचने के लिए Azure Cosmos DB डेटा प्रदाता का उपयोग करती है।

   

   महत्त्वपूर्ण

   एक्सेस टीम्स, क्यूज़ और त्वरित निर्माण जैसे कई विकल्प वर्चुअल निकायों के साथ उपलब्ध नहीं हैं। अधिक जानकारी: वर्चुअल इकाइयों का उपयोग करते समय ध्यान रखने योग्य बातें

   अतिरिक्त रूप से आवश्यक और वैकल्पिक गुणों को पूरा करें, जैसे आवश्यकतानुसार प्रदर्शन और बहुवचन नाम. इन गुणों के बारे में अधिक जानकारी के लिए, देखें इकाइयां बनाएं और संपादित करें।

5. वर्चुअल निकाय के लिए एक या अधिक फ़ील्ड बनाएँ और जोड़ें. एक कस्टम फ़ील्ड बनाने के लिए आवश्यक मानक फ़ील्ड गुण के साथ ही, ये वैकल्पिक गुण प्रत्येक ऐसी कस्टम फ़ील्ड के लिए उपलब्ध हैं, जिसे आप वर्चुअल निकाय के लिए बनाते हैं.

   • बाह्य नाम. यह आमतौर पर उस डेटा को पहचानने के लिए अद्वितीय नाम होता है, जिसे आप फ़ील्ड में प्रदर्शित करना चाहते हैं.

   नोट

   अगर आपके द्वारा बनाया गया फ़ील्ड प्रकार OptionSet है, तो निम्नलिखित अतिरिक्त फ़ील्ड उपलब्ध होती हैं.

   • बाह्य प्रकार का नाम. यह गुण विकल्प सेट के लिए बाहरी सेवा में मान समूहों के बाहरी नाम से मैप करता है. आम तौर पर यह एक इनम या स्ट्रिंग मान वर्ग का नाम हो सकता है. बाहरी प्रकार नाम पूरी तरह से योग्य नाम की आवश्यकता होने पर उपयोग किया जा सकता है. उदाहरण के लिए, टाइप नाम OData के साथ जहां क्वेरी में पैरामीटर्स को पूरी तरह से योग्य नाम की आवश्यकता होती है, जैसे कि [टाइप नाम].[मान].
   • बाह्य मान. यह गुण विकल्प सेट आइटम के लिए बाहरी डेटा स्रोत के संबंधित मान से मैप करता है. दर्ज किया गया यह मान इस बात का निर्धारण करने के लिए उपयोग किया जाता है कि अनुप्रयोग में कौन से विकल्प सेट आइटम का उपयोग किया जाए.

   आवश्यकतानुसार अतिरिक्त गुणों को पूरा करें. इन गुणों के बारे में अधिक जानकारी के लिए, फ़ील्ड बनाएँ और संपादित करें देखें.

6. फ़ील्ड गुण पृष्ठ पर सहेजें और बंद करें चुनें.

7. समाधान एक्सप्लोरर टूलबार पर, सहेजें का चयन करें.

8. समाधान एक्सप्लोरर टूलबार पर, प्रकाशित करें का चयन करें.

9. समाधान एक्सप्लोरर बंद करें.

वर्चुअल निकायों का उपयोग करते समय विचार करने योग्य बातें

वर्चुअल निकायों में ये प्रतिबंध होते हैं.

• सभी वर्चुअल निकाय केवल पढ़ने के लिए हैं.

• मौजूदा निकायों को वर्चुअल निकायों में रूपांतरित नहीं किया जा सकता.

• डिफ़ॉल्ट रूप से, वर्चुअल निकाय में केवल नाम और Id फ़ील्ड होता है. स्थिति या निर्माण दिनांक/संशोधन दिनांक जैसी कोई भी अन्य सिस्टम प्रबंधित फ़ील्ड समर्थित नहीं है.

• वर्चुअल निकाय मुद्रा, छवि या ग्राहक डेटा प्रकारों वाली कस्टम फ़ील्ड का समर्थन नहीं करते हैं.  

• वर्चुअल निकाय ऑडिट का समर्थन नहीं करते हैं.

• वर्चुअल निकाय फ़ील्ड का उपयोग रोलअप या परिकलित फ़ील्ड में नहीं किया जा सकता है.  

• वर्चुअल निकाय गतिविधि प्रकार का निकाय नहीं हो सकता है.

• कई ऐसी सुविधाएँ, जो निकाय तालिका पंक्तियों को प्रभावित करती हैं, उन्हें वर्चुअल निकायों के साथ सक्षम नहीं किया जा सकता. उदाहरण में कतार, ज्ञान प्रबंधन, SLA, डुप्लिकेट डिटेक्शन, ट्रैकिंग परिवर्तन, मोबाइल ऑफलाइन क्षमता, फ़ील्ड सुरक्षा, प्रासंगिकता खोज, Dynamics 365 Customer Engagement (on-premises) वेब पोर्टल समाधानों के लिए पोर्टल और वर्चुअल निकायों के बीच N:N संबंध शामिल हैं.

• वर्चुअल निकायों का स्वामित्व संगठन के पास होता है और ये पंक्ति-स्तरीय अनुप्रयोगों के लिए Commond Data Service सुरक्षा अवधारणाओं का समर्थन नहीं करते. हमारा सुझाव है कि आप बाहरी डेटा स्रोत के लिए अपना खुद का सुरक्षा मॉडल लागू करें.

• हमारा सुझाव है कि उन्नत फ़ील्ड में वर्चुअल निकायों का उपयोग करके समय आप एकल डेटा स्रोत को लक्षित करें. उदाहरण के लिए, एक ऐसी उन्नत खोज बनाना समर्थित नहीं है, जो अंततः Dataverse स्थानीय डेटा और वर्चुअल निकाय बाहरी डेटा को संयुक्त करती हो.

• फ़ील्ड मेटाडेटा गुण, जिनका सत्यापन अद्यतन करने पर होता है, वे वर्चुअल निकायों पर लागू नहीं किए जाते. उदाहरण के लिए, वर्चुअल निकाय फ़ील्ड पर मौजूद पूर्णांक संख्या वाले फ़ील्ड को न्यूनतम मान शून्य पर सेट किया जा सकता है. हालांकि, चूंकि मान किसी बाहरी डेटा स्रोत से आ रहा है, इसलिए वर्चुअल निकाय से पुनर्प्राप्त करने पर क्वेरी शून्य से कम मान देगी. न्यूनतम मान गुण क्वेरी में निहित नहीं है. यदि 0 से बड़ा मान वांच्छित हैं, तो आपको अभी भी मानों को फ़िल्टर करना पड़ सकता है.

• वर्चुअल निकाय परिवर्तन ट्रैकिंग का समर्थन नहीं करते हैं और उन्हें Customer Engagement सुविधा, जैसे कि डेटा निर्यात सेवा का उपयोग करके सिंक्रनाइज़ नहीं किया जा सकता है.

• व्यवसाय प्रक्रिया प्रवाह वर्चुअल निकायों के साथ समर्थित नहीं हैं. अधिक जानकारी: जब कोई उपयोगकर्ता व्यवसाय प्रोसेस फ़्लो सक्रिय करता है तो अप्रत्याशित त्रुटि प्राप्त होती है

जब कोई उपयोगकर्ता व्यवसाय प्रोसेस फ़्लो को सक्रिय करता है तो अनपेक्षित त्रुटि प्राप्त होती है

जब कोई उपयोगकर्ता व्यवसाय प्रोसेस फ़्लो को सक्रिय करने का प्रयास करता है, तो उन्हें एक "अप्रत्याशित त्रुटि" संदेश प्राप्त हो सकता है. लॉग फ़ाइल को देखने पर निम्न लॉग प्रविष्टि प्रदर्शित होती है.

ErrorCode: 0x80040216 Message: System.Web.HttpUnhandledException: Exception of type 'System.Web.HttpUnhandledException' मिला. ---> Microsoft.Crm.CrmException: व्यवसाय प्रोसेस फ़्लो को वर्चुअल एंटिटी के लिए सक्षम नहीं किया जा सकता

यह समस्या इसलिए होती है क्योंकि वर्चुअल निकाय व्यवसाय प्रक्रिया प्रवाह का समर्थन नहीं करते हैं.

भी देखें

OData v4 डेटा प्रदाता आवश्यकताएँ और सर्वोत्तम अभ्यास
इकाइयाँ बनाएँ और संपादित करें
फ़ील्ड बनाएँ और संपादित करें