Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Microsoft Power Platform komentorivikäyttöliittymän siirto-apuohjelma siirtää olemassa olevan Power Pages sivuston tukeman määrityksen ja siihen liittyvät tietueet vakiotietomallista parannettuun tietomalliin ja vaihtaa sitten sivuston käyttämään siirrettyä määritystä.
Vakiotietomalli tallentaa Power Pages sivuston määritykset taulukoihin, joissa käytetään adx_ etuliitettä. Parannettu tietomalli tallentaa sivuston määritykset Sivuston osa - taulukkoon (powerpagecomponent) ja tunnistaa kunkin komponentin sen komponenttityypin mukaan. Kun ymmärrät, miten siirtotyökalu toimii ja mitä malleja se tukee ja mitä mukautuksia se ei päivitä automaattisesti, voit päättää, milloin ja miten sivusto siirretään.
Parannettujen tietomallien etujen tarkastelu selittää, miksi voit harkita sivuston siirtämistä.
On tärkeää huomata, että kaikki adx_*-taulukot eivät siirry kohteeseen powerpagecomponent. Vain metatiedot adx_* -taulukot – ne, jotka kuvaavat sivuston rakennetta ja luontipintaa, kuten adx_webpage, adx_webtemplate, adx_sitesettingadx_contentsnippet, adx_pagetemplate, adx_weblinkadx_entityformja adx_entitylist – yhdistetään taulukoihin powerpagecomponent (rivikohtaisia ominaisuuksia siirrettyinä sisällön JSON-sarakkeeseen).
Tapahtuma- ja suorituspalvelun adx_* -taulukoita – niitä, jotka sieppaavat loppukäyttäjän toimintaa suorituksen aikana, kuten adx_invitation, adx_inviteredemption, adx_portalcomment, adx_externalidentityja entiteettilomakkeen tai lisälomakkeen lähetys- ja lokitaulukoita – ei siirretä - powerpagecomponenttaulukoihin, vaan ne pysyvät olemassa olevissa rakenteet ja säilyttävät suorituspalvelutietoja aiempaan tapaan. Näissä tapahtumataulukoissa kuitenkin tehdään muutoksia siihen, että niiden haut metatietotietueisiin luodaan uudelleen viittaukset siirtämisen aikana niin, että ne osoittavat uusiin powerpagecomponent riveihin vanhojen metatietojen adx_* rivien sijaan.
Vakiotietomallissa luodut olemassa olevat sivustot toimivat edelleen adx_*-taulukoissa, joten kukin sivusto on siirrettävä, jotta parannettu tietomalli voidaan hyödyntää. Siirto siirtää sivuston määritysten metatiedot parannettuun tietomallin powerpagecomponent muotoon, luo tapahtumaviittaukset uudelleen näihin uusiin metatietotietueisiin ja kääntää sivuston tietueen parannetusta tietomallista palvelemiseksi. Myös siellä mukautukset – mukautetut adx_* sarakkeet, Liquid-määrite, joka lukee adx_* määritettä, FetchXML yli adx_* taulukot, laajennukset ja työnkulut, tuodaan pintaan ja korjataan, koska nämä mukautukset eivät siirry automaattisesti ja ne on kirjoitettava uudelleen tai jäsenneltävä uudelleen, jotta ne toimivat parannetun tietomallin kanssa.
Edellytykset
- Microsoft Power Platform CLI-versio2.11.2 tai uudempi, joka suorittaa sivuston lataus-, siirto-, tila-, aktivointi- ja palautuskomennot. Jos haluat lisätietoja, katso Viimeisimmän Power Platform -komentorivikäyttöliittymän asentaminen.
- Dataverse-perusportaalipaketti
CDSBasePortal9.3.2607.x tai uudempi, joka tarjoaa vaaditut perusportaaliosat. - Power Pages Core -paketti
PowerPages_Core1.0.2605.x tai uudempi, joka tarjoaa vaaditut Power Pages suorituksenaikaiset osat. Power Pages ratkaisun päivittäminen. - Järjestelmänvalvoja-, Dynamics 365-järjestelmänvalvojan tai Power Platform -järjestelmänvalvojan rooli, jota tarvitaan aktiivisen tietomallin vaihtamiseen tai palautamiseen.
- Power Platformin komentorivikäyttöliittymän Power Pages tunteminen.
- Taustatoiminnot käytössä, jos ympäristö on hallintatilassa.
Siirto-apuohjelman ominaisuudet
Siirto-apuohjelma kopioi tuetun sivuston määrityksen ja siihen liittyvät tietueet parannetusta tietomallista. Kun siirto on valmis, aktiivinen sivusto siirtyy parannettuun tietomalliin ja vahvistetaan ennen kuin se palaa normaaliin käyttöön.
Siirto-apuohjelma:
- Luo raportin mukautuksista, jotka saattavat edellyttää manuaalisia muutoksia.
- Siirtää tuetun sivuston määrityksen ja siihen liittyvät tietueet.
- Voit tarkistaa siirron tilan ennen aktiivisten tietomallien vaihtamista.
- Voit palauttaa sivuston vakiotietomalliin, jos vahvistus tunnistaa kriittisen ongelman.
Tärkeää
Siirto-apuohjelma ei päivitä automaattisesti kaikkia mukautuksia, jotka riippuvat suoraan vakiotietomallitaulukoista. Tarkista mukautusraportti, korjaa mukautettu koodi, ja testaa siirretty sivusto ennen tuotantokäyttöä.
Tuetut mallit
Voit siirtää seuraavista malleista luodut olemassa olevat vakiotietomallisivustot:
- Aloitusasettelu 1–5
- Hakemusten käsittely
- Tyhjä sivu
- Ohjelmaan rekisteröityminen
- Kokouksien aikataulutus ja hallinta
- usein kysytyt kysymykset
- Yhteisöportaali (Dynamics 365)
- Customer Self-Service Portal (Dynamics 365)
- Employee Self-Service Portal (Dynamics 365)
- Kumppaniportaali (Dynamics 365)
Muistio
Uusien sivustojen luominen parannetulla tietomallilla ja olemassa olevien sivustojen siirtäminen ovat erillisiä ominaisuuksia. Jos sivuston alkuperäistä mallia ei ole lueteltu tässä, älä suorita kyseisen sivuston siirto-apuohjelmaa.
Ennen aloittamista
Muita suunnitteluun liittyviä seikkoja:
- Vaihda parannettuihin tietomalliympäristöihin -asetuksella hallitaan uusissa sivustoissa käytettyä tietomallia. Asetuksen ottaminen käyttöön ei siirrä olemassa olevia sivustoja.
- Suorita siirto ensin tuotantoympäristön täydellisessä kopiossa. Viimeistele mukautuksen korjaus ja vahvistus ennen siirtämistä.
- Käytä organisaatiosi vakiovarmuuskopiointi- ja palautusprosessia tuotantoympäristön varmuuskopiointiin.
- Suunnittele ylläpitoikkuna lopullista tuotantovalitsinta ja vahvistusta varten.
- Tallenna sivuston tunnus, portaalin tunnus, ympäristön URL-osoite, CLI-versio, pakettiversiot, siirron alkamisaika ja komentotulostelomake osana siirtotietuetta.
Ympäristön järjestyksen suunnitteleminen
Siirtäminen tukee eri ympäristöjä, joissa on eri tila kullekin ympäristölle.
| Ympäristö | Suositeltu tila | Mitä teet? |
|---|---|---|
| Kehittäminen | configurationData |
Siirrä määritys, tarkista mukautusraportti, korjaa mukautukset, vahvista ja sieppaa määritys ratkaisuun. |
| Testi tai käyttäjähyväksyntätestaus | configurationDataReferences |
Tuo testattu ratkaisu kehityksestä, siirrä tuetut liittyvät tietueet, aktivoi parannettu tietomalli ja vahvista. |
| Tuotanto | configurationDataReferences |
Tuo vahvistettu hallittu ratkaisu, siirrä tuetut liittyvät tietueet, aktivoi ylläpitoikkunan aikana ja tee tuotannon vahvistus loppuun. |
| Yksittäinen ympäristö tai yksinkertainen sivusto | all |
Määritysten ja liittyvien tietueiden siirtäminen yhdellä toiminnolla vain, kun ymmärrät mukautuksen vaikutuksen etkä käytä moniympäristöratkaisun polkua. |
Työkansion luominen
Tyhjän työkansion avulla voit säilyttää raportteja, ladattua sivustolähdettä ja vertailutiedostoja. Seuraavissa esimerkeissä käytetään \<OUTPUT\> tätä sijaintia.
mkdir C:\PowerPagesMigration\<site-name>
cd C:\PowerPagesMigration\<site-name>
Muuttovaiheet
Siirtymisprosessissa on neljä vaihetta:
- Ennakkotarkistukset : tarkista sivusto, tunnukset, komentorivikäyttöliittymä, paketit, malliratkaisu ja siirron tila.
- Määritys : siirrä määritykset kehitys- tai tuontitestattuihin määrityksiin jatkojalostusympäristöissä.
- Siirtäminen ja aktivointi – Liittyvien tietueiden siirtäminen, täydentämisen vahvistaminen, mallien vaihtaminen ja uudelleen käynnistäminen.
- Validate : testaa toimintaa, käyttöoikeuksia, mukautettua koodia ja mallisijainteja.
Vaihe 1 (Sivuston etsintä ja ennakkotarkistukset) ja Vaihe 4 (siirron jälkeinen vahvistus) suoritetaan samalla tavalla jokaisessa sivustossa.
Vaihe 2 ja Vaihe 3 ovat ratakohtaisia – niiden rakenne riippuu siirtotavasta, joka määrittää radan ympäristötyypin perusteella.
Luontiraitaa (tila configurationData tai all) käytetään kehitys- ja yhden ympäristön asetuksissa. Itse metatiedot siirretään paikallisesti, ja mukautukset tarkistetaan ja korjataan vakiotietomallin lähteen avulla ennen tapahtumaviittausten siirtämistä.
Jatkoraitaa (tilaconfigurationDataReferences) käytetään testi-, UAT- ja tuotantoympäristöissä, joissa määritysten metatietojen oletetaan saapuneen ALM-ratkaisun tuonnin kautta Dev-kohteesta. Tässä vaiheessa siirtyvät vain transaktioviittaukset. Kaikki mukautukseen liittyvät havainnot viittaavat siihen, että kyse on aiemmassa vaiheessa olevasta ALM-puutteesta eikä työstä, joka pitäisi tehdä paikallisesti.
Vaihe 1: ennakkotarkistukset
Varmista Power Platform -komentorivikäyttöliittymän versio osoitteesta
pac --version. Jos versiosi on aiempi kuin vaadittu versio, asenna tai päivitä Microsoft Power Platform CLI ennen jatkamista.Todenna kohdeympäristöön.
- Suorita
pac auth list. - Suorita
pac auth who.
- Suorita
Vahvista, että aktiivinen todennusprofiili osoittaa sivuston sisältävään ympäristöön. Jos haluat valita toisen profiilin tai luoda profiilin, käytä tai
pac auth selectpac auth create -u "https://contoso.crm.dynamics.com".Asenna parannetut tietomalliratkaisut malliasi varten jollakin seuraavista menetelmistä:
- Luo malliisi perustuva sivusto hallintakeskuksessa, kun parannetun tietomallin (EDM) asetus on käytössä.
- Komentorivikäyttöliittymän avulla voit asentaa komennon
pac application install --application-name "PowerPages_PartnerPortal_V2"
Etsi sivusto ja tallenna sen tunnisteet kohteella
pac pages list -v.Tallenna seuraavassa taulukossa näkyvät arvot.
Arvo Käytetään: Sivuston tunnus Kaikki migrate-datamodelkomennot.Portaalin tunnus Siirrytään parannettuun tietomalliin ja palautetaan vakiotietomalliin. Kutsumanimi ja URL-osoite Vahvista, että valitsit oikean sivuston hallintakeskuksessa. Tietomallin versio Tämän on oltava Standard. Jos se on jo Laajennettu, siirtoa ei tarvita. Tärkeää
Portaalitunnus ei ole Power Pages sovellustunnus. Jos komentorivikäyttöliittymä ei näytä portaalin tunnusta, se on käytettävissä Power Platform -hallintakeskuksessa kohdassa Resurssit>Power Pages sivustojen>sivuston tiedot tai liitetty
/_services/aboutsivuston URL-osoitteeseen, kun se on kirjautunut sisään vaadituilla sivuston käyttöoikeuksilla.Tarkista aiempi tai keskeneräinen siirto seuraavalla komennolla:
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatusTila Merkitys Toiminto NotStarted tai ei seurantaa Mitään siirtoa ei ole aloitettu. Jatka pakettitarkistuksia. Palautettu Aiempi siirto peruutettiin. Tarkista, miksi se kumottiin, ja jatka sitten, kun olet valmis. Valmis Siirto on valmis, mutta sivustoa ei ehkä ole vaihdettu. Vahvista aktiivinen tietomalli. Jos se on edelleen vakiomuotoinen, jatka aktivointia. Käynnissä Siirtoa käsitellään edelleen. Jatka tilan tarkistusta. Älä aloita uutta siirtoa samalle sivustolle. Epäonnistui Siirrossa ilmeni virhe. Kerää komennon tuloste ja ympäristön tiedot, korjaa syy ja yritä uudelleen vasta, kun virhe on ymmärretty. Muistio
Jos siirto kestää odotettua kauemmin, tarvitset sivuston tunnuksen, ympäristötunnuksen, komentorivikäyttöliittymäversion, pakettiversiot, komentotulosteen ja siirron aloitusajan, ennen kuin otat yhteyttä Microsoft tukeen. Aktiivista siirtoa ei pidä palauttaa, ellei tuki tai hyväksytty toimintaohje kehota siihen.
Varmista pakolliset ensimmäisen osapuolen paketit palvelussa
pac solution list --includeSystemSolutions.- Varmista, että
CDSBasePortalPowerPages_Coresivuston mallin -, - ja EDM-ratkaisut on asennettu vaadittuihin versioihin.
- Varmista, että
Jos paketti puuttuu tai on vanhentunut, päivitä se Power Platform -hallintakeskuksesta:
- Avaa kohdeympäristö.
- Siirry kohtaan Resurssit>Dynamics 365 sovellukset.
- Etsi tarvittava paketti.
- Valitse Asenna tai Päivitä.
- Odota, että toiminto on suoritettu loppuun, ja suorita
pac solution list --includeSystemSolutionssitten uudelleen.
Muistio
Jos EDM-malliratkaisu ei ole käytettävissä suoraa asennusta varten, vastaavan EDM-ratkaisun asentaa vastaavan EDM-ratkaisun luomalla tilapäisen parannetun tietomallisivuston samassa ympäristössä, jossa sama malli on. Voit poistaa väliaikaisen sivuston, kun ratkaisu on vahvistettu.
Luo mukautusraportti palvelulla
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". Raportin luominen ei muuta sivustoa.Avaa luotu CSV-tiedosto ja tarkista jokainen kohde, joka viittaa vakiotietomallitaulukoihin. Määritä omistaja- ja vahvistusvaihe jokaiselle vaaditulle korjaamiselle ennen tuotannon siirtoa.
Mukautusluokka Suunnitelma Adx_ metatietotaulukoiden mukautetut sarakkeet Siirrä mukautetut tiedot tuettuun mukautettuun taulukkoon, joka liittyy powerpage-component-funktioon. Yhteydet adx_ metatietotaulukoihin Luo yhteys uudelleen tuetun parannetun tietomallitaulukon avulla. Liquid- tai FetchXML-viittaukset adx_ taulukoihin Päivitä koodi käyttämään tuettuja Liquid-objekteja, virtuaalitaulukoita tai powerpage-täydennystä. adx_ taulukoiden työnkulut ja laajennukset Muodosta logiikka uudelleen ja rekisteröi se tuettuihin parannettuihin tietomallitaulukoihin. Muistio
Mukautusraportti ei todista, että kaikki sivuston toiminta toimii siirron jälkeen. vahvistusta tarvitaan edelleen.
Valitse siirtotila määrittääksesi, mitä apuohjelma siirtää yhdellä toiminnolla.
Tila Mitä se siirtää Käyttötilanne configurationData Tuetut sivuston määrityksen metatiedot, kuten sivut, verkkomallit, katkelmat, asetukset, lomakkeet, luettelot, verkkoroolit ja taulukon käyttöoikeudet. Kehitystyö, jossa korjataan määritys ja siirretään se ratkaisujen kautta. määritystietoviittaukset Tuetut tietueet, jotka viittaavat siirrettyihin sivuston määrityksiin. Testaus, käyttömukautuminen ja tuotanto sen jälkeen, kun sivuston määritys saapuu ratkaisun tuonnin kautta. kaikki sekä määritys että tuetut liittyvät tietueet. Yksittäinen ympäristö tai yksinkertainen siirto, joka ei käytä ratkaisupohjaisen ympäristön sekvenssiä.
Vaihe 2: Sivuston määrittäminen
Sisällön tuottamisen seuranta: kehitys tai yksittäinen ympäristö
Lataa SDM-perustasoon suorittamalla
pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm". Komento luo sivustolle nimetyn alikansion. Tallenna kansio, joka sisältää suoraan kohteenwebsite.yml.Siirrä sivuston määritys suorittamalla
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData. Jos haluat yhden toiminnon polun, korvaaconfigurationDatakohteellaall.Tarkista siirron tila suorittamalla
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus. Seuraavan PowerShell-silmukan avulla voit tarkistaa tilan kerran minuutissa enintään 30 minuutin ajan:$webSiteId = "<WEBSITE_ID>" for ($i = 1; $i -le 30; $i++) { $output = pac pages migrate-datamodel ` --webSiteId $webSiteId ` --checkMigrationStatus 2>&1 | Out-String if ($output -match "Completed|Failed|Reverted") { Write-Host $output break } Write-Host "Attempt $i/30 - migration is still running." Start-Sleep -Seconds 60 }Jos silmukka päättyy, kun tila on edelleen Running, tarkistusta jatketaan kohdasta
--checkMigrationStatus. Pitkäkestoinen operaatio ei välttämättä ole epäonnistunut toiminto.Korjaa ilmoitetut mukautukset käyttämällä mukautusraporttia ja tämän artikkelin ohjeita, niin että ne päivittävät asialliset FetchXML-, Liquid-, mukautetut sarakkeet, suhteet, työnkulut ja laajennukset. Testaa jokainen muutettu osa uudelleen. Jos päivität ladatun lähteen, lataa sivuston kansio, joka sisältää
website.ymlsuoraan suorittamalla kohteenpac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1.
Tuotantoketjun loppuraita: testi, käyttömukautuminen tai tuotanto
Tuo ratkaisu, joka sisältää siirretyn ja korjaavan sivuston määrityksen. Käytä Power Platform -hallintakeskusta tai vakiintunutta käyttöönottoputkea.
pac solution import --path "<PATH_TO_SOLUTION_ZIP>" --activate-plugins true --publish-changes trueVahvista, että sivuston määritykset ovat olemassa, avaamalla Power Pages -hallintasovelluksen kohdeympäristössä. Sivustotietue ja odotettu määritys on oltava olemassa, ennen kuin liittyvät tietueet siirretään.
Vaihe 3: Liittyvät tietueet ja aktivointi
Siirrä tuetut liittyvät tietueet. Jos olet jo käyttänyt
--mode allkohdetta , ohita tämä vaihe. Tarkista tila, kunnes se raportoi Valmis.pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationDataReferences pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatusKun siirron tila raportoi onnistuneesta suorittamisesta, vaihda aktiivinen sivusto parannettuun tietomalliin. Vakiotietomallin verkkosivustotietue on aktivoitu, ja vastaava parannetun tietomallin sivustotietue muuttuu aktiiviseksi.
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"Käynnistä sivusto uudelleen.
- Avaa Power Platform -hallintakeskus.
- Siirry ympäristöön ja valitse sitten Resurssit>Power Pages sivustot.
- Valitse sivusto.
- Valitse Käynnistä uudelleen. Jos uudelleenkäynnistys ei ole käytettävissä, poista sivuston aktivointi ja aktivoi se.
- Odota, että toiminto päättyy ennen vahvistusta.
Vahvista aktiivinen tietomalli käyttämällä yhtä tai useampaa näistä menetelmistä:
- Valitse Power Platform -hallintakeskuksessa sivusto ja varmista, että tietomallissa näkyy Parannettu.
- Avaa sivuston Asennus-työtila Power Pages design studiossa ja vahvista näytetty tietomalli.
- Vahvista, että lisämääritykset avataan Power Pages Management -sovelluksessa.
- Suorita
pac pages list -vja vahvista tietomallin versio.
Vihje
Sivuston URL-osoite ja visualisoinnin rakenne eivät muutu vain siksi, että aktiivinen tietomalli on muuttunut. Voit tarkistaa siirron käyttämällä näitä tarkistuksia – ei sivuston ulkoasua.
Vaihe 4: siirretyn sivuston vahvistaminen
Viimeistele vahvistus ennen kuin avaat tuotantosivuston uudelleen käyttäjille. Käytä testitilejä kullekin tärkeälle käyttäjätyypille ja verkkoroolille ja tallenna jokaisen tärkeän testin tulokset.
| Alue | Vahvistettavat asiat |
|---|---|
| Sivut ja sisältö | Aloitussivu, edustava sisältösivut, verkkomallit, sisältökatkelmat, verkkotiedostot, siirtyminen, uudelleenohjaukset ja monikielinen sisältö. |
| Authentication | Sisäänkirjautuminen, uloskirjautuminen, rekisteröinti, kutsut, ulkoiset identiteetintarjoajat ja käytön estämiseen liittyvät käyttökokemukset. |
| Valtuutus | Verkkoroolit, taulukon käyttöoikeudet, sarakkeen käyttöoikeudet ja sivun käyttöoikeussäännöt sallivat ja estävät odotetut toiminnot. |
| Lomakkeet ja luettelot | Peruslomakkeet, monivaiheiset lomakkeet, luettelot, lomakkeiden metatiedot, lähetykset, liittyvät tietueet ja sivuston käyttämät verkkolomakeistunnot. |
| Dynamics 365 mallimatkat | Toteutuksessa käytetyt tärkeimmät asiakas-, työntekijä-, yhteisö- tai kumppanimatkat, mukaan lukien mallikohtaiset sivut ja käyttöoikeusmallit. |
| Mukautettu koodi | Liquid, FetchXML, JavaScript, laajennukset, työnkulut ja integroinnit, jotka on tunnistettu mukauttamisraportissa. |
| Sivuston asetukset ja tiedostot | Sivuston asetukset, kuvat, liitteet, SVG-tiedostot ja muut verkkotiedostot latautuvat oikein. |
| Tiedot ja viittaukset | Tärkeät tietuemäärät ja tuetut liittyvät tietueet osoittavat oikeaan siirrettyyn sivuston osaan. |
| Hallinta ja ALM | Sivusto avautuu Power Pages Managementissa, ja sen voi lisätä ratkaisuihin, viedä sisään ja tuoda ratkaisuista odotetulla tavalla. |
Tarkista selaimen diagnostiikka
Avaa selaimen kehittäjätyökalut testattaessa edustavia sivuja. Tutki:
- Konsolivirheet, joissa mainitaan
adx\_, entiteetit, Liquid tai FetchXML. - HTTP 401 tai 403 -vastaukset ovat peräisin osoitteesta
\_api, mikä voi tarkoittaa käyttöoikeutta tai verkkorooliongelmaa. - HTTP 500 -vastaukset voivat tarkoittaa Liquid-, FetchXML-, laajennus- tai integrointivirhettä.
Siirron valmistumisen ehdot
Harkitse siirtoa valmiiksi vain, kun sivusto näyttää parannetun tietomallin, tärkeät liiketoimintasijainnit läpäisevät, odotettu suojaustoiminta vahvistetaan ja jokainen paljon vaikuttava mukautushavainto on ratkaistu tai hyväksytty.
Tuotannon siirtojakso
Vähennä siirtoriskiä käyttämällä seuraavaa tuotantojaksoa:
- Luo harjoitusympäristöstä täysi kopio tuotantoympäristöstä.
- Vahvista kopioidun ympäristön CLI:n, paketin ja mallin ratkaisun edellytykset.
- Luo ja tarkista mukautusraportti.
- Määritysten siirtäminen kopioidussa kehitysympäristössä.
- Korjaa mukautukset ja sieppaa vahvistettu sivuston määritys hallittuun ratkaisuun.
- Tuo ratkaisu harjoitusympäristöön, siirrä tuetut liittyvät tietueet, aktivoi parannettu tietomalli ja täytä täydellinen tarkistusluettelo.
- Toista harjoitukset, kunnes kaikki tärkeät testit läpäisevät.
- Ajoittaa tuotannon ylläpitotoimien ikkuna, ilmoittaa vahvistuksen ja peruutuksen päätöspisteistä sekä varmuuskopioida tuotannon.
- Tuotantopaketin ja malliratkaisun edellytysten vahvistaminen uudelleen.
- Tuo vahvistettu hallittu ratkaisu tuotantoon.
- Suorita
configurationDataReferences, tarkista siirron tila, vaihda aktiivista tietomallia ja käynnistä sivusto uudelleen. - Suorita tuotannon tarkistusluettelo ja palauta sivusto normaaliin käyttöön vasta kriittisten testien hyväksymisen jälkeen.
Siirretyn sivuston kumoaminen vakiotietomalliin
Jos vahvistus tunnistaa kriittisen ongelman aktivoinnin jälkeen, aktivoi vakiotietomallisivuston tietue uudelleen seuraavalla komennolla:
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"
Kun komento on valmis:
- Käynnistä sivusto uudelleen Power Platform -hallintakeskuksesta.
- Vahvista, että sivusto näyttää aktiivisten tietojen mallina standardin .
- Suorita sivuston tärkeät vahvistustestit uudelleen.
- Säilytä siirtoraportti, virhetiedot ja korjaushuomautukset ennen toisen siirron yrittämistä.
Tärkeää
Suunnittele palautuspäätös ennen tuotannon siirtoa. Tarkista parannetun tietomallin kytkimen jälkeen tehdyt muutokset ennen peruuttamista, koska vakiomuotoiset ja parannetut sivustotietueet ovat erillisiä tietueita.
Vianmääritys
| Viesti tai oire | Todennäköinen syy | Toiminto |
|---|---|---|
pac powerpages migrate-datamodel ei tunnisteta |
Komento käyttää väärää nimitilaa tai vanhentunutta komentorivikäyttöliittymää. | Päivitä Power Platform CLI ja käytä pac pages migrate-datamodel. |
CDSBasePortal tai PowerPages_Core ei ole luettelossa |
Järjestelmäratkaisut eivät sisälly komentotulosteeseen tai pakettia ei ole asennettu. | Suorita pac solution list --includeSystemSolutions. Asenna tai päivitä puuttuva paketti Power Platform -hallintakeskuksesta. |
| Sivustoa ei tueta siirtämisessä | Alkuperäistä mallia ei tueta, pakettiversiot eivät ole riittäviä tai vastaava EDM-malliratkaisu puuttuu. | Vahvista mallikelpoisuus, pakettiversiot ja malliratkaisuviittauksen EDM-ratkaisu. |
Tuntematon argumentti --webSiteId välitettiin lle pac pages upload |
Latauskomento ei hyväksy sivuston tunnus-argumenttia. | Poista argumentti. Sivusto tunnistetaan kohteesta website.yml. |
| Lataaminen kohdistaa väärään sivustoon tai ei löydä sivustoa | Polku osoittaa rivityskansioon sivuston kansion sijaan. | Käytä alikansiota, joka sisältää suoraan website.yml. |
Portaalin tunnuksella näytetään Unknown tai N/A |
Sivusto on passiivinen tai asennettu komentorivikäyttöliittymä ei palauta arvoa. | Hanki portaalin tunnus Power Platform -hallintakeskuksesta tai sivuston /_services/about sivulta. Älä käytä sovellustunnusta. |
Siirtoraportit Completed , mutta sivusto näkyy edelleen Standard |
Aktiivista tietomallia ei vaihdettu, tai käytettiin väärää portaalitunnusta. | Suorita aktivointikomento sivuston tunnuksella ja oikealla portaalitunnuksella, käynnistä sivusto uudelleen ja vahvista se. |
Tila pysyy Running |
Siirto käsittelee suuren tietomäärän, tai se on estetty. | Jatka tilan tarkistusta. Kerää ympäristön, paketin, komentorivikäyttöliittymän, aloitusajan ja komennon tiedot, ennen kuin ota yhteyttä tukeen. Älä aloita toista siirtoa. |
Tila on Failed |
Paketin, mallin, mukauttamisen, tietojen tai palvelun virhe pysäytti toiminnon. | Tallenna koko komentotuloste, korjaa tunnistettu syy ja yritä uudelleen vasta, kun olet tarkistanut epäonnistuneen siirron tilan. |
| Sivusto avautuu, mutta käyttäjät eivät voi käyttää odotettuja tietoja. | Verkkoroolit, taulukon käyttöoikeudet tai mukautetut kyselyt eivät toimi odotetusti siirtämisen jälkeen. | Tarkista verkkoroolit, taulukon käyttöoikeudet, sarakkeen käyttöoikeudet, FetchXML-, Liquid- ja selainverkkovirheet. |
Huomioitavaa sivuston mukautuksissa
Mukautusraportti tunnistaa suorat riippuvuudet vakiotietomallin taulukoihin. Tee pakollinen korjaus kokonaan ennen tuotantokäyttöä.
Mukautetut sarakkeet metatietotaulukoissa
Jos vakiotietomallitaulukko, kuten adx_webpage sisältää mukautetun sarakkeen, luo mukautettu taulukko mukautettujen tietojen tallentamista varten ja lisää haku kohteeseen powerpagecomponent. Siirrä mukautetut arvot uuteen taulukkoon ja päivitä koodi, joka lukee tai kirjoittaa sarakkeen.
Mukautettujen taulukoiden ja metatietotaulukoiden väliset suhteet
Luo uudelleen mukautettuja suhteita, jotka osoittavat adx_ taulukoihin, niin että ne osoittavat asianmukaiseen parannettuun tietomallitaulukkoon. Yleensä powerpagecomponent. Riippuvaisten lomakkeiden, näkymien, laajennusten, työnkulkujen ja integroinnit päivittäminen.
Liquid-viittaukset metatietotaulukoihin
Korvaa suora entities['adx_*'] käyttö tuetussa Liquid-objektissa, jossa sellainen on. Käytä esimerkiksi Liquid-objektia sen sijaan, että weblinks kyselet adx_weblinkset suoraan tai liittyvät taulukot. Tarkista kukin käyttö, koska palautettu objekti ja käytettävissä olevat määritteet voivat olla erilaisia.
FetchXML-viittaukset metatietotaulukoihin
Korvaa suorat adx_ entiteettiviittaukset vastaavalla virtuaalitaulukolla tai kyselyllä powerpagecomponent ja suodata powerpagecomponenttype
Vakiotietomallin esimerkki:
<fetch>
<entity name="adx_webpage">
<attribute name="adx_name" />
<filter>
<condition attribute="adx_partialurl" operator="eq" value="home" />
</filter>
</entity>
</fetch>
Parannetun tietomallin esimerkki:
<fetch>
<entity name="powerpagecomponent">
<attribute name="name" />
<filter type="and">
<condition attribute="powerpagecomponenttype" operator="eq" value="2" />
<condition attribute="partialurl" operator="eq" value="home" />
</filter>
</entity>
</fetch>
Mukautetut työnkulut ja laajennukset
Refaktoroi adx_-taulukoihin rekisteröity mukautettu työnkulku ja laajennusohjelmalogiikka. Rekisteröi päivitetty logiikka asianmukaiseen parannettuun tietomallitaulukkoon ja käytä parannettua rakennetta ja määritteitä. Testaa luomisen, päivittämisen, poistamisen ja suojauksen toimintaa ei-tuotantoympäristössä.
Komentoviite
| Käyttötarkoitus | Komento |
|---|---|
| Tarkista CLI-versio | pac --version |
| Todennusprofiilien luettelo | pac auth list |
| Todennusprofiilin luominen | pac auth create -u "<ENV_URL>" |
| Luetteloi sivustot ja tunnisteet | pac pages list -v |
| Järjestelmäratkaisujen luetteloiminen | pac solution list --includeSystemSolutions |
| Siirron tilan tarkistaminen | pac pages migrate-datamodel --webSiteId "<ID>" --checkMigrationStatus |
| SDM-lähteen lataaminen | pac pages download --webSiteId "<ID>" --modelVersion 1 --path "<OUT>\site-sdm" |
| Lataa EDM-lähde | pac pages download --webSiteId "<ID>" --modelVersion 2 --path "<OUT>\site-edm" |
| Luo mukautusraportti | pac pages migrate-datamodel --webSiteId "<ID>" --siteCustomizationReportPath "<OUT>" |
| Määrityksen siirtäminen | pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationData |
| Liittyvien tietueiden siirtäminen | pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationDataReferences |
| Siirrä molemmat luokat | pac pages migrate-datamodel --webSiteId "<ID>" --mode all |
| Lataa sivuston lähde | pac pages upload --path "<SITE_ROOT>" --modelVersion 1 |
| Aktivoi EDM | pac pages migrate-datamodel --webSiteId "<ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>" |
| Palaa SDM:ään | pac pages migrate-datamodel --webSiteId "<ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>" |
Sivuston osan tyyppiviittaus
Kun teet kyselyn powerpagecomponent, käytä seuraavia arvoja powerpagecomponenttype-suodattimessa .
| Komponentti | Arvo | Komponentti | Arvo |
|---|---|---|---|
| Julkaisutila | 1 | Verkkosivu | 2 |
| Verkkotiedosto | 3 | Verkkolinkkijoukko | 4 |
| Verkkolinkki | 5 | Sivumalli | 6 |
| Sisältökatkelma | 7 | Verkkomalli | 8 |
| Sivuston asetus | 9 | Verkkosivun Käyttöoikeuksien hallinnan sääntö | 10 |
| Verkkorooli | 11 | Sivuston käyttöoikeus | 12 |
| Sivustomerkintä | 13 | Peruslomake | 15 |
| Peruslomakkeen metatiedot | 16 | List | 17 |
| Taulukon käyttöoikeus | 18 | Lisälomake | 19 |
| Lisälomakevaihe | 20 | Lisälomakkeen metatiedot | 21 |
| Kyselysijoittelu | 24 | Mainossijoittelu | 26 |
| Bottikuluttaja | 27 | Sarakeoikeusprofiili | 28 |
| Sarakeoikeus | 29 | Uudelleenohjaus | 30 |
| Julkaisutilan siirtämisääntö | 31 | Pikalinkki | 32 |
| Pilvityönkulku | 33 | Käyttökokemuksen osa | 34 |
EDM-malliratkaisun viittaus
Vahvista pac solution list --includeSystemSolutions suorittamalla, että sivuston mallin parannettu tietomalliratkaisu on asennettu.
| Malli | EDM-ratkaisun yksilöivä nimi |
|---|---|
| Aloitusasettelu 1 | DefaultPortalTemplate_V2 |
| Aloitusasettelu 2 | PowerPages_BlankDesign002_V2 |
| Aloitusasettelu 3 | PowerPages_BlankDesign003_V2 |
| Aloitusasettelu 4 | PowerPages_BlankDesign004_V2 |
| Aloitusasettelu 5 | PowerPages_BlankDesign005_V2 |
| Tyhjä sivu | PowerPages_BlankTemplate_V2 |
| usein kysytyt kysymykset | PowerPages_FAQ_V2 |
| Hakemusten käsittely | PowerPages_BuildingPermit_V2 |
| Ohjelmaan rekisteröityminen | PowerPages_ProgramRegistration_V2 |
| Kokouksien aikataulutus ja hallinta | PowerPages_BookMeeting_V2 |
| Yhteisöportaali (Dynamics 365) | PowerPages_CommunityPortal_V2 |
| Customer Self-Service Portal (Dynamics 365) | PowerPages_CustomerPortal_V2 |
| Employee Self-Service Portal (Dynamics 365) | PowerPages_ESSPortal_V2 |
| Kumppaniportaali (Dynamics 365) | PowerPages_PartnerPortal_V2 |