Standard adatmodell-webhelyek áttelepítése továbbfejlesztett adatmodellbe (előzetes verzió)
[Ez a témakör kiadás előtti dokumentáció, amely a későbbiekben változhat.]
Ebből a cikkből megtudhatja, hogyan migrálhatja át meglévő szabványos adatmodell-webhelyét továbbfejlesztett adatmodellbe.
Fontos
- Ez a funkció egy előzetes verzió.
- Az előzetes funkciókat nem célszerű termelési környezetben használni, és előfordulhat, hogy korlátozott funkcionalitással rendelkeznek. Ezek a funkciók a hivatalos kiadás előtt érhetők el, hogy az ügyfelek korán megismerkedhessenek velük, és visszajelzést adhassanak róluk.
Előfeltételek
- A webhelyek továbbfejlesztett adatmodellbe való áttelepítéséhez telepítenie Microsoft Power Platform kell a CLI-t az 1.31.6-os vagy újabb verzióval. További információ: A legújabb Power Platform CLI telepítése
- Dataverse Alapportál csomag 9.3.2307.x vagy újabb.
- Power Pages Alapcsomag 1.0.2309.63 vagy újabb. További információ: A Power Pages megoldás frissítése
- Meg kell értenie, hogyan használhatja Power Platform a CLI-t Power Pages a migrálási lépések befejezéséhez. Ha nem ismeri a CLI-t Power Platform , tekintse át ezt Power Pagesa CLI-oktatóanyagot Power Platform , és hivatkozzon a PAC CLI-parancsokra a munkához . Power Pages
1. lépés Töltse le és ellenőrizze a meglévő szabványos webhely-metaadatok testreszabását
Nyisson meg egy parancssorablakot.
A következő paranccsal hitelesítheti magát a Dataverse környezet szervezetében Power Platform , hogy letöltse a webhelyrekordot az áttelepítéshez.
pac auth create -u [Dataverse URL]
Példa
pac auth create -u https://contoso-org.crm.dynamics.com
További információ: pac auth create
A következő paranccsal hozza létre az aktuális szervezet webhelyeinek listáját.
pac powerpages list
További információ: pac powerpages lista
A testreszabási jelentés letöltéséhez használja a következő parancsot.
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]
Példa
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"
Ha bármilyen testreszabást talál a letöltött jelentésben, kövesse a jelentés útmutatását a továbbfejlesztett adatmodellbe való áttelepítés utáni javításhoz. További információ: A webhelyek testreszabásának szempontjai webhelyek normál adatmodellről bővített adatmodellre történő áttelepítésekor
2. lépés A helyadatok áttelepítése normál adatmodellből továbbfejlesztett adatmodellbe
A következő paranccsal migrálhatja webhelyadatait a bővített adatmodellbe.
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]
A módnak 3 értéke lehet:
configurationData: migrálja a webhely metaadatait. További információ: A konfigurációs adatok tárolására szolgáló táblák listája
configurationDataReferences: migrálja a tranzakciós adatokat a webhelyhez. További információ: Nem konfigurációs adatok tárolására szolgáló táblák listája
Mind: Mindkét adattípus áttelepítése.
Példa
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all
Az áttelepítési eszköz ellenőrzi a megoldásokat. Ha van olyan szabványos adatmodell-megoldás, amely nem rendelkezik megfelelő továbbfejlesztett adatmodell-megoldással az említett sablonhoz, figyelmeztetés jelenik meg: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template
Vannak speciális sablonok, például a Programregisztráció és az Értekezletek ütemezése és kezelése, amelyek továbbfejlesztett adatmodell-csomagok egyeztetését igénylik az áttelepített webhely megfelelő működésének biztosítása érdekében. A bővített adatmodell-csomagok beszerzéséhez létre kell hoznia egy új helyet a megfelelő sablonhoz (a környezetet engedélyezni kell a bővített adatmodell számára), hogy továbbfejlesztett adatmodell-kompatibilis megoldásokat biztosítson az áttelepítéshez.
Az áttelepítéshez támogatott sablonok
A következő sablonokkal rendelkező webhelyek migrálása támogatott:
- Kezdő elrendezés 1–5
- Alkalmazás feldolgozása
- Üres oldal
- Programregisztráció
- Értekezletek ütemezése és kezelése
3. lépés Az áttelepítés állapotának ellenőrzése
A következő paranccsal ellenőrizheti webhelye áttelepítési állapotát:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus
Példa
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus
Feljegyzés
Ha webhelyének áttelepítése a vártnál tovább tart, annak oka lehet az adatok mennyisége. Ha a parancssor bezárul, nyisson meg egy új parancssort, és az ebben a lépésben található paranccsal ellenőrizze a webhely állapotát.
4. lépés A hely adatmodelljének verziója sikeres adatáttelepítés után
Használja a következő parancsot frissítési hely adatmodell-verziója:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]
Feljegyzés
- A portálazonosítót úgy találhatja meg, hogy felkeresi a webhelyet, és a webhely URL-címéhez hozzáfűzi a "/_services/about" szót. A beállítások megtekintéséhez a felhasználónak webes szerepkörrel kell rendelkeznie, amelyhez minden webhely-hozzáférési engedély hozzá van rendelve.
- A webhelyadatmodell verziójának frissítése után a szabványos adatmodellhez csatolt webhelyrekord inaktiválódik. Ehelyett a webhely most a bővített adatmodellhez társított webhelyrekordra hivatkozik.
- A felhasználónak az alábbi szerepkörök bármelyikével rendelkeznie kell az áttelepítési parancs vagy
updateDatamodelVersion
argumentumokkal történőrevertToStandardDataModel
végrehajtásához. Mivel ez rendszergazdai műveletet hajt végre, hogy webhelyét enahance adatmodellre váltsa, vagy fordítva.
Példa
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e
Áttelepített hely visszaállítása bővített adatmodellről szabványos adatmodellre
A következő paranccsal visszaállíthat egy szabványos adatmodell-webhelyet továbbfejlesztett adatmodellre a migrálás után:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]
Feljegyzés
Amikor egy áttelepített webhelyet visszaállít a bővített adatmodellről a szabványos adatmodellre, a bővített adatmodellhez társított webhelyrekord inaktiválódik, és a szabványos adatmodell webhelyrekordja újraaktiválódik.
Példa
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e
Éles hely áttelepítése standardról továbbfejlesztett adatmodellre
A termelési hely áttelepítése előtt javasoljuk, hogy készítse el a termelési hely teljes másolatát. Azt is javasoljuk, hogy a termelési hely áttelepítését munkaidőn kívül végezze.
Az alábbi lépésekkel migrálhatja az éles webhelyet a továbbfejlesztett adatmodellbe:
- Próbálja ki a migrálást a webhelyen a másolt környezetben a PAC CLI
migrate-datamodel
paranccsal. - Helykonfigurációs adatok hozzáadása felügyelt megoldás és éles környezet importálása.
- A PAC CLI-parancsokkal migrálhatja a nem konfigurációs adatokat, és befejezheti azokat az adatmodell verziójának frissítésével az éles környezethez.
Feljegyzés
A migráláshoz a forrás és az éles webhely azonosítója megegyezik.
A webhely testreszabásának szempontjai a webhelyek normál adatmodellről bővített adatmodellre történő áttelepítésekor
Ez a szakasz útmutatást nyújt a webhely standard adatmodellről továbbfejlesztett adatmodellre való áttelepítésének testreszabásához.
Az adx metaadattáblázataiban ötféle webhely-testreszabás létezik:
- Egyéni oszlopok az adx metaadattábláiban
- Az egyéni táblák és az adx-táblák közötti kapcsolat
- Adx-táblahivatkozások folyékony kódú kódrészlet
- Adx-táblahivatkozások a fetch xml-ben
- Egyéni munkafolyamat és beépülő modulok adx táblákon
Feljegyzés
A testreszabással kapcsolatos összes javítás a továbbfejlesztett adatmodellbe való migrálás után lesz elvégezve.
Egyéni oszlopok az adx metaadattábláiban
A testreszabás javított adatmodellben való javításához hozzon létre kapcsolatot a rendszertáblák és az új egyéni tábla között, és telepítse át az adatokat az új táblába.
Szabványos adatmodell: A tábla adx_webpage
egyéni oszlopot contoso_pagetype
tartalmaz.
Továbbfejlesztett adatmodell: Hozzon létre egy új táblát névvel ellátva contoso_webpage
. Ez magában foglal egy nevű contoso_pagetype
oszlopot és egy keresőoszlopot contoso_webpage_id
, amely a következőhöz powerpagescomponent
van társítva. Használja az Adatmunkaterületet táblák létrehozásához.
Az egyéni táblák és az adx-táblák közötti kapcsolat
A testreszabás javított adatmodellben való javításához hozzon létre kapcsolatot az egyéni táblák és a rendszertáblák között.
Standard adatmodell: A táblának adx_webpage
van egy nevű adx_webpage_contoso_pagelogs
kapcsolata a contoso_pagelogs
táblával.
Továbbfejlesztett adatmodell: Hozzon létre egy új kapcsolatot a powerpagecomponent_contoso_pagelogs
táblával együtt contoso_webpage
. Használja az Adatmunkaterületet táblák létrehozásához.
Adx-táblahivatkozások folyékony kódú kódrészlet
A bővített adatmodell testreszabásának javításához cserélje le a folyékony kódban lévő adx-táblahivatkozásokat továbbfejlesztett adatmodellbeli virtuális táblák mspp-hivatkozásaira. Másik lehetőségként használhatja a Helyösszetevő (logikai név powerpagecomponent
) táblát és az Összetevőtípus (logikai név powerpagecomponenttype
) attribútumot a megfelelő hivatkozások lekéréséhez.
Standard adatmodell:entities
a folyékony címke a webhivatkozások kódban lévő értékeinek elérésére {% assign app_weblinks= entities['adx_weblinks'] %}
szolgál.
Továbbfejlesztett adatmodell: Ahelyett, hogy folyadékcímkén keresztüli entities
webhivatkozásokat használna, használja a megfelelő folyékony objektumokat. entities[adx_weblinks]
közvetlenül. Ebben az esetben entities['adx_weblinks']
helyettesíthető folyékony tárgyral weblinks
.
Adx-táblahivatkozások a fetch xml-ben
A bővített adatmodell testreszabásának javításához cserélje le az adx-táblahivatkozásokat a fetch xml-ben a továbbfejlesztett adatmodell virtuális táblák közvetlen hivatkozásaira. Másik lehetőségként használhatja a Helyösszetevő (logikai név powerpagecomponent
) táblát és az Összetevőtípus (logikai név powerpagecomponenttype
) attribútumot a megfelelő hivatkozások lekéréséhez.
Szabványos adatmodell: A tábla neve adx_webrole
a lekéréses XML-lekérdezésben használatos.
{% fetchxml app_webroles %}
<fetch>
<entity name='adx_webrole'>
<attribute name='adx_name'/>
<entity>
</fetch>
{% endfetchxml %}
Továbbfejlesztett adatmodell: Használja a Helyösszetevő (logikai név powerpagecomponent
) attribútumot az Összetevőtípus (logikai név powerpagecomponenttype
) attribútummal együtt a megfelelő hivatkozások lekéréséhez.
{% fetchxml app_webroles %}
<fetch>
<entity name='powerpagecomponent'>
<attribute name='adx_name'/>
<filter type='and'>
<condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
<entity>
</fetch>
{% endfetchxml %}
Helyösszetevő típusa és értékei
Összetevő típusa | Érték |
---|---|
Közzétételi állapot | 0 |
Weboldal | 2 |
Webfájl | 3 |
Hivatkozáskészlet | 4 |
Webhivatkozás | 5 |
Lapsablon | 6 |
Tartalomrészlet | 7 |
Webes sablon | 8 |
Webhelybeállítás | 9 |
Weboldal hozzáférés-vezérlési szabálya | 10 |
Webes szerepkör | 11 |
Webhelyelérés | 12 |
Helyjelző | 13 |
Alapűrlap | 15 |
Alapűrlap metaadatai | 16 |
List | 17 |
Táblaengedély | 18 |
Speciális űrlap | 19 |
Speciálisűrlap-lépés | 20 |
Speciális űrlap metaadatai | 21 |
Szavazás-elhelyezés | 24 |
Hirdetés-elhelyezés | 26 |
Robotot használó ügyfél | 27 |
Oszlopengedélyezési profil | 28 |
Oszlopengedély | 29 |
Átirányítás | 30 |
Közzétételi állapot átmeneti szabálya | 31 |
Parancsikon | 32 |
Felhőfolyamat | 33 |
Felhasználóifelület-összetevő | 34 |
Egyéni munkafolyamat és beépülő modulok adx táblákon
A továbbfejlesztett adatmodellben a testreszabás javításához a munkafolyamatot és a beépülő modul logikáját újra kell bontani és regisztrálni kell a webhely megfelelő táblázatában.
Ha például egy felhasználó regisztrálta a munkafolyamatot/beépülő modult az Elsődleges entitás Weblap (logikai név ) táblaként adx_webpage
a szabványos adatmodellben, akkor a munkafolyamaton/beépülő modulon belüli kódot módosítani kell a Webhelyösszetevő (logikai név ) táblára powerpagecomponent
és annak attribútumaira a továbbfejlesztett adatmodellhez.
Ismert problémák
Az áttelepítési parancs csak 5K rekordok kötegét dolgozza fel a szabványos adatmodellből a továbbfejlesztett adatmodellbe.