मानक डेटा मॉडल साइटों को उन्नत डेटा मॉडल में माइग्रेट करें (पूर्वावलोकन)

[यह विषय पूर्व-रिलीज़ दस्तावेज़ है और इसमें परिवर्तन हो सकता है।]

इस लेख में जानें कि अपनी मौजूदा मानक डेटा मॉडल साइट को उन्नत डेटा मॉडल में कैसे माइग्रेट करें।

पूर्वावश्यकताएँ

• अपनी साइटों को उन्नत डेटा मॉडल में माइग्रेट करने के लिए आपको संस्करण 1.31.6 या उच्चतर के साथ CLI स्थापित करना होगा। Microsoft Power Platform अधिक जानकारी: नवीनतम Power Platform CLI स्थापित करें
• Dataverse आधार पोर्टल पैकेज 9.3.2307.x या उच्चतर. 
• Power Pages कोर पैकेज 1.0.2309.63 या उच्चतर. अधिक जानकारी: समाधान को अपडेट करें Power Pages
• आपको यह समझना होगा कि माइग्रेशन चरणों को पूरा करने के लिए Power Platform CLI का उपयोग कैसे करें। Power Pages यदि आप Power Platform CLI in Power Pages से परिचित नहीं हैं, तो आप इस Power Platform CLI ट्यूटोरियल की समीक्षा करना चाह सकते हैं और PAC CLI कमांड के साथ काम करने के लिए संदर्भ ले सकते हैं। Power Pages

चरण 1. मौजूदा मानक साइट मेटाडेटा के लिए अनुकूलन डाउनलोड करें और जांचें

1. कमांड प्रॉम्प्ट खोलें.

2. माइग्रेशन के लिए वेबसाइट रिकॉर्ड डाउनलोड करने के लिए अपने Dataverse पर्यावरण के लिए संगठन को प्रमाणित करने के लिए निम्नलिखित कमांड का उपयोग करें। Power Platform

   pac auth create -u [Dataverse URL]

   उदाहरण

   pac auth create -u https://contoso-org.crm.dynamics.com

   अधिक जानकारी: pac auth create

3. वर्तमान संगठन में वेबसाइटों की सूची बनाने के लिए निम्नलिखित कमांड का उपयोग करें।

   pac powerpages list

   अधिक जानकारी: pac पावरपेज सूची

4. अनुकूलन रिपोर्ट डाउनलोड करने के लिए निम्नलिखित आदेश का उपयोग करें.

   pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]

   उदाहरण

   pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"

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

चरण 2. साइट डेटा को मानक से उन्नत डेटा मॉडल में माइग्रेट करें

अपने साइट डेटा को उन्नत डेटा मॉडल में माइग्रेट करने के लिए निम्नलिखित कमांड का उपयोग करें।

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]

मोड के 3 मान हो सकते हैं:

• configurationData: वेबसाइट के लिए मेटाडेटा माइग्रेट करें. अधिक जानकारी: कॉन्फ़िगरेशन डेटा संग्रहीत करने के लिए तालिकाओं की सूची

• configurationDataReferences: वेबसाइट के लिए लेनदेन संबंधी डेटा को माइग्रेट करें। अधिक जानकारी: गैर-कॉन्फ़िगरेशन डेटा संग्रहीत करने के लिए तालिकाओं की सूची

• सभी: दोनों प्रकार के डेटा को माइग्रेट करें।

उदाहरण

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all

माइग्रेशन टूल समाधानों का सत्यापन करता है. यदि उल्लिखित टेम्पलेट के लिए संबंधित उन्नत डेटा मॉडल समाधान के बिना कोई मानक डेटा मॉडल समाधान मौजूद है, तो एक चेतावनी प्रदर्शित होती है: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

कार्यक्रम पंजीकरण और बैठकों का शेड्यूल और प्रबंधन जैसे विशिष्ट टेम्पलेट्स हैं, जिनके लिए उन्नत डेटा मॉडल पैकेजों के मिलान की आवश्यकता होती है ताकि यह सुनिश्चित किया जा सके कि माइग्रेट की गई वेबसाइट ठीक से काम करती है। इन उन्नत डेटा मॉडल पैकेजों को प्राप्त करने के लिए, आपको संबंधित टेम्पलेट के लिए एक नई साइट बनानी होगी (पर्यावरण उन्नत डेटा मॉडल के लिए सक्षम होना चाहिए) ताकि माइग्रेशन के लिए उन्नत डेटा मॉडल संगत समाधान प्रदान किया जा सके।

माइग्रेशन के लिए समर्थित टेम्पलेट

निम्नलिखित टेम्पलेट्स वाली साइटें माइग्रेशन के लिए समर्थित हैं:

• स्टार्टर लेआउट 1-5
• एप्लिकेशन संसाधन
• रिक्त पृष्ठ
• प्रोग्राम पंजीकरण
• मीटिंग्स शेड्यूल और प्रबंधित करें

चरण 3. माइग्रेशन स्थिति सत्यापित करें

अपनी साइट की माइग्रेशन स्थिति सत्यापित करने के लिए निम्नलिखित कमांड का उपयोग करें:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus

उदाहरण

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus

चरण 4. सफल डेटा माइग्रेशन के बाद साइट डेटा मॉडल संस्करण अपडेट करें

निम्नलिखित कमांड का उपयोग करके साइट डेटा मॉडल संस्करण अपडेट करें:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]

उदाहरण

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e

माइग्रेट की गई साइट को उन्नत डेटा मॉडल से मानक डेटा मॉडल में वापस लाएं

माइग्रेशन के बाद मानक डेटा मॉडल साइट को उन्नत डेटा मॉडल में वापस लाने के लिए निम्नलिखित कमांड का उपयोग करें:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]

उदाहरण

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e

किसी उत्पादन साइट को मानक से उन्नत डेटा मॉडल में माइग्रेट करें

किसी उत्पादन साइट को माइग्रेट करने से पहले, हम उत्पादन साइट की पूरी प्रतिलिपि बनाने की अनुशंसा करते हैं। हम यह भी अनुशंसा करते हैं कि उत्पादन स्थल का स्थानांतरण गैर-व्यावसायिक घंटों के दौरान किया जाए।

अपने उत्पादन साइट को उन्नत डेटा मॉडल पर माइग्रेट करने के लिए इन चरणों का उपयोग करें:

1. PAC CLI migrate-datamodel कमांड का उपयोग करके कॉपी किए गए वातावरण में साइट पर माइग्रेशन का प्रयास करें।
2. प्रबंधित समाधान में साइट कॉन्फ़िगरेशन डेटा जोड़ें और इसे उत्पादन वातावरण में आयात करें।
3. गैर-कॉन्फ़िगरेशन डेटा को माइग्रेट करने के लिए PAC CLI कमांड का उपयोग करें और उत्पादन के लिए डेटा मॉडल संस्करण को अपडेट करके इसे समाप्त करें।

मानक से उन्नत डेटा मॉडल में साइटों को माइग्रेट करते समय साइट अनुकूलन के लिए विचार

यह अनुभाग मानक से उन्नत डेटा मॉडल में साइट माइग्रेशन के लिए अनुकूलन को ठीक करने के लिए मार्गदर्शन प्रदान करता है।

ADX मेटाडेटा तालिकाओं पर साइट अनुकूलन के पांच प्रकार हैं:

• ADX मेटाडेटा तालिकाओं पर कस्टम कॉलम
• कस्टम टेबल और ADX टेबल के बीच संबंध
• लिक्विड में ADX तालिका संदर्भ कोड स्निपेट
• फ़ेच xml में ADX तालिका संदर्भ
• ADX टेबल पर कस्टम वर्कफ़्लो और प्लगइन्स

ADX मेटाडेटा तालिकाओं पर कस्टम कॉलम

उन्नत डेटा मॉडल में इस अनुकूलन को ठीक करने के लिए, सिस्टम तालिकाओं और नई कस्टम तालिका के बीच संबंध बनाएं और डेटा को नई तालिका में माइग्रेट करें।

मानक डेटा मॉडल: तालिका adx_webpage में contoso_pagetypeके रूप में एक कस्टम कॉलम शामिल है।

उन्नत डेटा मॉडल: contoso_webpage नामक एक नई तालिका बनाएँ. इसमें contoso_pagetype नामक एक कॉलम और contoso_webpage_id लुकअप कॉलम शामिल होगा जो powerpagescomponent से संबद्ध है। तालिका निर्माण के लिए डेटा कार्यक्षेत्र का उपयोग करें.

कस्टम टेबल और ADX टेबल के बीच संबंध

उन्नत डेटा मॉडल में इस अनुकूलन को ठीक करने के लिए, कस्टम तालिकाओं और सिस्टम तालिकाओं के बीच संबंध बनाएँ.

मानक डेटा मॉडल: तालिका adx_webpage का adx_webpage_contoso_pagelogs तालिका के साथ contoso_pagelogs नाम का संबंध है।

उन्नत डेटा मॉडल: तालिका के साथ powerpagecomponent_contoso_pagelogs नाम से एक नया संबंध बनाएँ. contoso_webpage तालिका निर्माण के लिए डेटा कार्यक्षेत्र का उपयोग करें.

लिक्विड में ADX तालिका संदर्भ कोड स्निपेट

उन्नत डेटा मॉडल में इस अनुकूलन को ठीक करने के लिए, लिक्विड कोड में ADX तालिका संदर्भों को उन्नत डेटा मॉडल वर्चुअल टेबल MSPP संदर्भों से बदलें। वैकल्पिक रूप से, आप संगत संदर्भों को प्राप्त करने के लिए साइट घटक (तार्किक नाम powerpagecomponent) तालिका के साथ घटक प्रकार (तार्किक नाम powerpagecomponenttype) विशेषता का उपयोग कर सकते हैं।

मानक डेटा मॉडल:entities लिक्विड टैग का उपयोग वेबलिंक्स कोड में मानों तक पहुंचने के लिए किया जाता है। {% assign app_weblinks= entities['adx_weblinks'] %}

उन्नत डेटा मॉडल: entities लिक्विड टैग के माध्यम से वेबलिंक्स का उपयोग करने के बजाय, संबंधित लिक्विड ऑब्जेक्ट्स का उपयोग करें। entities[adx_weblinks] सीधे. इस स्थिति में entities['adx_weblinks'] को weblinks तरल वस्तु से प्रतिस्थापित किया जा सकता है।

फ़ेच xml में ADX तालिका संदर्भ

उन्नत डेटा मॉडल में इस अनुकूलन को ठीक करने के लिए, fetch xml में adx तालिका संदर्भों को उन्नत डेटा मॉडल वर्चुअल तालिकाओं के प्रत्यक्ष संदर्भों से प्रतिस्थापित करें। वैकल्पिक रूप से, आप संगत संदर्भों को प्राप्त करने के लिए साइट घटक (तार्किक नाम powerpagecomponent) तालिका के साथ घटक प्रकार (तार्किक नाम powerpagecomponenttype) विशेषता का उपयोग कर सकते हैं।

मानक डेटा मॉडल: तालिका नाम adx_webrole का उपयोग fetch xml क्वेरी के भीतर किया जाता है।

{% fetchxml app_webroles %}
<fetch>
 <entity name='adx_webrole'>
  <attribute name='adx_name'/>
 <entity>
</fetch>
{% endfetchxml %}

उन्नत डेटा मॉडल: संगत संदर्भों को पुनः प्राप्त करने के लिए साइट घटक (तार्किक नाम powerpagecomponent) को घटक प्रकार (तार्किक नाम powerpagecomponenttype) विशेषता के साथ संयोजन में उपयोग करें।

{% fetchxml app_webroles %}
<fetch>
 <entity name='powerpagecomponent'>
  <attribute name='adx_name'/>
  <filter type='and'>
   <condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
  <entity>
</fetch>
{% endfetchxml %}

साइट घटक प्रकार और मान

ADX टेबल पर कस्टम वर्कफ़्लो और प्लगइन्स

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

उदाहरण के लिए, यदि किसी उपयोगकर्ता ने मानक डेटा मॉडल में प्राथमिक इकाई को वेब पेज (तार्किक नाम adx_webpage) तालिका के रूप में पंजीकृत किया है, तो वर्कफ़्लो/प्लगइन के भीतर कोड को साइट घटक (तार्किक नाम powerpagecomponent) तालिका और उन्नत डेटा मॉडल के लिए इसकी विशेषताओं में संशोधित किया जाना चाहिए।

ज्ञात समस्याएँ

माइग्रेशन कमांड मानक डेटा मॉडल से उन्नत डेटा मॉडल तक केवल 5K रिकॉर्ड के बैच को संसाधित कर रहा है।