Standart-gelişmiş veri modeli geçişine genel bakış

Microsoft Power Platform CLI geçiş yardımcı programı, mevcut bir Power Pages sitesinin desteklenen yapılandırmasını ve ilgili kayıtlarını standart veri modelinden gelişmiş veri modeline taşır ve ardından siteyi geçirilen yapılandırmayı kullanacak şekilde değiştirir.

Standart veri modeli, adx_ ön ekini kullanan tablolar arasında Power Pages site yapılandırmasını depolar. Gelişmiş veri modeli site yapılandırmasını Site Bileşeni tablosunda (powerpagecomponent) depolar ve her bileşeni bileşen türüne göre tanımlar. Geçiş yardımcı programının nasıl çalıştığını, hangi şablonları desteklediğini ve hangi özelleştirmeleri güncelleştirmeyeceğine ilişkin bilgileri anlamak, sitenin ne zaman ve nasıl taşınacaklarına karar vermenize yardımcı olur.

Gelişmiş veri modeli avantajlarını gözden geçirmek, bir siteyi geçirmeyi neden göz önünde bulundurabileceğinizi açıklar.

Şunu belirtmek önemlidir: tüm adx_* tabloları powerpagecomponent içine taşınmaz. Yalnızca sitenin yapısını ve içerik oluşturma yüzeyini tanımlayan adx_contentsnippet, adx_sitesetting, adx_weblink, adx_pagetemplate, adx_entityform, adx_entitylist, adx_webpage ve adx_webtemplate gibi adx_* meta veri tabloları, powerpagecomponent içinde birleştirilir (satır bazındaki özellikleri de içerik JSON sütununa taşınır).

İşlemsel / çalışma zamanı adx_* tabloları — çalışma zamanında son kullanıcı etkinliğini kaydedenler; örneğin adx_invitation, adx_inviteredemption, adx_portalcomment, adx_externalidentity ile varlık formu / gelişmiş form gönderimi ve günlük tabloları — powerpagecomponent içine geçirilmez; mevcut şemalarında kalır ve çalışma zamanı verilerini eskiden olduğu gibi depolamaya devam eder. Bu işlemsel tablolar için değişen şey, referans geçişi sırasında meta veri kayıtlarına yönelik lookup’ların, eski adx_* meta veri satırları yerine yeni powerpagecomponent satırlarını gösterecek şekilde yeniden yönlendirilmesidir.

Standart veri modelinde yazılan mevcut siteler adx_* tablolarda çalışmaya devam ettiğinden, gelişmiş veri modelinden yararlanmak için her sitenin geçirilmesi gerekir. Geçiş işlemi, sitenin yapılandırma meta verilerini gelişmiş veri modeli powerpagecomponent yapısına taşır, işlemsel başvuruları bu yeni meta veri kayıtlarına yeniden bağlar ve site kaydını gelişmiş veri modelinden hizmet verecek şekilde değiştirir. Burası aynı zamanda özelleştirmelerin — özel adx_* sütunları, adx_* özniteliklerini okuyan Liquid kodu, adx_* tabloları üzerinde çalışan FetchXML, eklentiler ve iş akışları — tespit edilip düzeltildiği yerdir; çünkü bu özelleştirmeler otomatik olarak aktarılmaz ve geliştirilmiş veri modeliyle çalışacak şekilde yeniden yazılmaları veya yeniden yapılandırılmaları gerekir.

Prerequisites

Geçiş yardımcı programı özellikleri

Geçiş yardımcı programı, desteklenen site yapılandırmasını ve ilgili kayıtları gelişmiş veri modeline kopyalar. Geçiş tamamlandıktan sonra etkin site gelişmiş veri modeline geçer ve normal kullanıma dönmeden önce doğrulanır.

Geçiş yardımcı programı:

  • El ile değişiklik gerektirebilecek özelleştirmelerin raporunu oluşturur.
  • Desteklenen site yapılandırmasını ve ilgili kayıtları taşır.
  • Etkin veri modeline geçmeden önce geçiş durumunu denetlemenizi sağlar.
  • Doğrulama kritik bir sorun tanımlarsa siteyi standart veri modeline geri döndürmenizi sağlar.

Important

Geçiş yardımcı programı, standart veri modeli tablolarına doğrudan bağımlı olan her özelleştirmeyi otomatik olarak güncelleştirmez. Özelleştirme raporunu gözden geçirin, etkilenen özel kodu düzeltin ve üretim kullanımından önce geçirilen siteyi test edin.

Desteklenen şablonlar

Aşağıdaki şablonlardan oluşturulan mevcut standart veri modeli sitelerini geçirebilirsiniz:

  • Başlangıç düzeni 1-5
  • Uygulama işleme
  • Boş sayfa
  • Programa kayıt
  • Toplantıları zamanlama ve yönetme
  • FAQ
  • Topluluk Portalı (Dynamics 365)
  • Müşteri Self-Service Portalı (Dynamics 365)
  • Çalışan Self-Service Portalı (Dynamics 365)
  • Ortak Portalı (Dynamics 365)

Note

Gelişmiş veri modeliyle yeni siteler oluşturmak ve mevcut siteleri geçirmek ayrı özelliklerdir. Bir sitenin özgün şablonu burada listelenmiyorsa, bu site için geçiş yardımcı programını çalıştırmayın.

Başlamadan önce

Ek planlama konuları:

  • Gelişmiş veri modeli ortamına geç ayarı, yeni siteler için kullanılan veri modelini denetler. Bu ayarı açmak mevcut siteleri taşımaz.
  • Geçişi ilk olarak üretim ortamının tam kopyasında çalıştırın. Geçirmeden önce özelleştirme düzeltme ve doğrulamayı tamamlayın.
  • Üretim ortamını yedeklemek için kuruluşunuzun standart yedekleme ve geri yükleme işlemini kullanın.
  • Nihai üretim geçişi ve doğrulama için bir bakım penceresi planlayın.
  • Web sitesi kimliğini, portal kimliğini, ortam URL'sini, CLI sürümünü, paket sürümlerini, geçiş başlangıç zamanını ve komut çıkış formunu geçiş kaydının bir parçası olarak kaydedin.

Ortam sırasını planlayın

Geçiş işlemi, farklı ortamları destekler ve her ortam için farklı bir mod sunar.

Çevre Önerilen mod Ne yaparsınız?
Development configurationData Yapılandırmayı taşıma, özelleştirme raporunu gözden geçirme, özelleştirmeleri düzeltme, doğrulama yapma ve yapılandırmayı bir çözüm içinde kaydetme.
Test veya UAT configurationDataReferences Test edilen çözümü geliştirmeden içeri aktarın, desteklenen ilgili kayıtları geçirin, gelişmiş veri modelini etkinleştirin ve doğrulayın.
Üretim configurationDataReferences Doğrulanmış yönetilen çözümü içeri aktarın, desteklenen ilgili kayıtları geçirin, bakım penceresi sırasında etkinleştirin ve üretim doğrulamasını tamamlayın.
Tek ortam veya basit site all Yapılandırmayı ve ilgili kayıtları yalnızca özelleştirme etkisini anladığınızda ve çok ortamlı çözüm yolunu kullanmadığınızda tek bir işlemde geçirin.

Çalışma klasörü oluşturma

Raporları, indirilen site kaynağını ve karşılaştırma dosyalarını tutmak için boş bir çalışma klasörü kullanın. Aşağıdaki örnekler bu konum için kullanılır \<OUTPUT\> .

mkdir C:\PowerPagesMigration\<site-name>
cd C:\PowerPagesMigration\<site-name>

Geçiş aşamaları

Geçiş işlemi dört aşamadan oluşur:

  1. Ön denetimler — Siteyi, kimlikleri, CLI'yı, paketleri, şablon çözümünü ve geçiş durumunu doğrulayın.
  2. Yapılandırma — Yapılandırmayı geliştirme aşamasında taşıyın veya alt ortamlarda test edilmiş yapılandırmayı içeri aktarın.
  3. Geçiş ve etkinleştirme — İlgili kayıtları geçirin, tamamlanmasını onaylayın, modelleri değiştirin ve yeniden başlatın.
  4. Doğrulama — Test davranışı, izinler, özel kod ve şablon yolculukları.

Standarttan gelişmiş veri modeline geçiş işlemini gösteren akış çizelgesinin ekran görüntüsü.

1. Aşama (Site bulma ve ön denetimler) ve 4. Aşama (Geçiş sonrası doğrulama) her site için aynı şekilde çalışır.

2. Aşama ve 3. Aşama, ize göre dallanır; bunların şekli, izi ortam türünden türeten geçiş moduna bağlıdır.

Oluşturma Yolu (configurationData veya all modunda) Dev ve tek ortamlı kurulumlar için kullanılır. Meta verinin kendisi yerel olarak taşınır ve işlemsel referanslar taşınmadan önce özelleştirmeler taranır ve standart veri modeli kaynağına göre düzeltilir.

Alt Akış Yolu (modu configurationDataReferences), yapılandırma meta verilerinin Dev’den ALM çözümü içe aktarması yoluyla geldiğinin varsayıldığı Test, UAT ve Üretim ortamlarında kullanılır. Bu hatta yalnızca işlemsel referanslar taşınır. Özelleştirmeyle ilgili herhangi bir bulgu, yerelde yapmanız gereken bir çalışmadan ziyade üst akıştaki bir ALM açığına işaret eder.

1. Aşama: Ön denetimler

  1. Power Platform CLI sürümünüzü pac --version ile kontrol edin. Sürümünüz gerekli sürümden daha eskiyse devam etmeden önce Microsoft Power Platform CLI'yi yükleyin veya güncelleştirin.

  2. Hedef ortamda kimlik doğrulaması yapın.

    1. pac auth list'i çalıştırın.
    2. pac auth who'i çalıştırın.

  3. Etkin kimlik doğrulama profilinin siteyi içeren ortamı işaret ettiğini onaylayın. Başka bir profil seçmek veya profil oluşturmak için pac auth create -u "https://contoso.crm.dynamics.com" ya da pac auth select kullanın.

  4. Aşağıdaki yöntemlerden birini kullanarak şablonunuz için Gelişmiş Veri modeli çözümlerini yükleyin:

    1. Yönetim merkezinde gelişmiş veri modeli (EDM) bayrağı etkinleştirilmiş olarak şablonunuzun bir sitesini sağlayın.
    2. KOMUTUyla yüklemek için CLI'yi kullanın pac application install --application-name "PowerPages_PartnerPortal_V2"

  5. Siteyi bulun ve tanımlayıcılarını pac pages list -v ile kaydedin.

  6. Aşağıdaki tabloda gösterilen değerleri kaydedin.

    Value Kullanım amacı
    Web Sitesi Kimliği Tüm migrate-datamodel komutları.
    Portal Kimliği Gelişmiş veri modeline geçme ve standart veri modeline geri dönme.
    Kolay ad ve URL Yönetim merkezinde doğru siteyi seçtiğinizden emin olun.
    Veri modeli sürümü Standart olmalıdır. Zaten Gelişmişse, geçiş gerekli değildir.

    Important

    Portal kimliği Power Pages uygulama kimliği değildir. CLI portal kimliğini göstermiyorsa, Power Platform yönetim merkezinde Kaynaklar>Power Pages siteler>Site ayrıntıları altında bulunabilir veya gerekli web sitesi erişim izinleriyle oturum açarken site URL'sine eklenir/_services/about.

  7. Aşağıdaki komutla önceki veya devam eden bir geçişi denetleyin:

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus
    Statü Anlamı Action
    NotStarted veya tracker yok Geçiş başlatılmadı. Paket denetimlerine devam edin.
    Geri alındı Önceki bir geçiş geri alındı. Neden geri alındığını gözden geçirin ve hazır olduğunuzda devam edin.
    Tamamlandı Geçiş tamamlandı, ancak site değiştirilmemiş olabilir. Etkin veri modelini onaylayın. Hala Standart ise etkinleştirmeye devam edin.
    Koşmak Geçiş işlemi devam ediyor. Durumu denetlemeye devam edin. Aynı site için başka bir geçiş başlatmayın.
    Failed Geçiş bir hatayla karşılaştı. Komut çıkışını ve ortam ayrıntılarını toplayın, nedeni düzeltin ve yalnızca hata anlaşıldıktan sonra yeniden deneyin.

    Note

    Bir geçiş beklenenden daha uzun süre Running durumunda kalırsa, Microsoft desteğine başvurmadan önce web sitesi kimliği, ortam kimliği, CLI sürümü, paket sürümleri, komut çıktısı ve geçişin başlangıç zamanı elinizde bulunmalıdır. Destek veya onaylı bir runbook tarafından belirtilmediği sürece etkin bir geçiş sıfırlanmamalıdır.

  8. Gerekli birinci taraf paketlerini pac solution list --includeSystemSolutions ile doğrulayın.

    1. CDSBasePortal, PowerPages_Core ve sitenin şablonuna yönelik EDM çözümlerinin gerekli sürümlerde yüklü olduğunu doğrulayın.

  9. Bir paket eksikse veya güncel değilse Power Platform yönetim merkezinden güncelleştirin:

    1. Hedef ortamı açın.
    2. Resources>Dynamics 365 apps adresine gidin.
    3. Gerekli paketi bulun.
    4. Yükle veyaYükselt'i seçin.
    5. İşlemin tamamlanmasını bekleyin ve yeniden çalıştırın pac solution list --includeSystemSolutions .

    Note

    Şablon EDM çözümü doğrudan yükleme için kullanılamıyorsa, aynı şablonla aynı ortamda geçici bir gelişmiş veri modeli sitesi oluşturmak eşleşen EDM çözümünü yükler. Çözüm onaylandıktan sonra geçici siteyi silebilirsiniz.

  10. ile pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>"özelleştirme raporunu oluşturun. Raporun oluşturulması siteyi değiştirmez.

  11. Oluşturulan CSV dosyasını açın ve standart veri modeli tablolarına başvuran her öğeyi gözden geçirin. Üretim geçişi öncesinde gerekli her düzeltme için bir sahip ve doğrulama adımı atayın.

    Özelleştirme kategorisi Plan
    adx_ meta veri tablolarındaki özel sütunlar Özel verileri powerpagecomponent ile ilgili desteklenen bir özel tabloya taşıyın.
    adx_ meta veri tablolarına ilişkiler desteklenen gelişmiş veri modeli tablosuyla ilişkiyi yeniden oluşturun.
    adx_ tablolarına yönelik Liquid veya FetchXML başvuruları Desteklenen Liquid nesnelerini, sanal tabloları veya powerpagecomponent'i kullanmak için kodu güncelleştirin.
    adx_ tablolardaki iş akışları ve eklentiler Mantığı yeniden yapılandırın ve desteklenen gelişmiş veri modeli tablolarına göre kaydedin.

    Note

    Özelleştirme raporu, geçiş sonrasında tüm site davranışlarının çalıştığını kanıtlamaz; doğrulama hala gereklidir.

  12. Yardımcı programın tek bir işlemde hangi geçişi yaptığını belirlemek için geçiş modunu seçin.

    Mode Taşıdığı öğeler Kullanılacağı zaman
    yapılandırma verileri Sayfalar, web şablonları, kod parçacıkları, ayarlar, formlar, listeler, web rolleri ve tablo izinleri gibi desteklenen site yapılandırma meta verileri. Geliştirme; burada yapılandırmayı düzelttiğiniz ve bunu çözümler arasında ilerlettiğiniz yerdir.
    configurationDataReferences Taşınmış site yapılandırmasına atıfta bulunan desteklenen kayıtlar. Site yapılandırması bir çözüm içeri aktarma yoluyla geldikten sonra test, UAT ve üretim.
    all Hem yapılandırma hem de desteklenen ilişkili kayıtlar. Çözüm tabanlı ortam dizisini kullanmayan tek bir ortam veya basit bir geçiş.

2. Aşama: Site yapılandırması

İçerik oluşturma yolu: Geliştirme veya tek bir ortam

  1. pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm" komutunu çalıştırarak bir SDM temelini indirin. Bu komut, site için adlandırılmış bir alt klasör oluşturur. website.yml öğesini doğrudan içeren klasörü kaydedin.

  2. pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData komutunu çalıştırarak site yapılandırmasını taşıyın. Tek işlem yolunu istiyorsanız, configurationData yerine all yazın.

  3. komutunu çalıştırarak pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatusgeçiş durumunu denetleyin. Dakikada bir kez 30 dakikaya kadar durumu denetlemek için aşağıdaki PowerShell döngüsünü kullanın:

    $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
}

    Döngü, durum hâlâ Çalışıyor ise sona ererse, denetim --checkMigrationStatus ile sürer. Uzun süre çalışan bir işlem, başarısız bir işlem olmayabilir.

  4. Etkilenen FetchXML, Liquid, özel sütunlar, ilişkiler, iş akışları ve eklentileri güncelleştirmek için özelleştirme raporunu ve bu makaledeki yönergeleri kullanarak bildirilen özelleştirmeleri düzeltin. Değiştirilen her bileşeni yeniden test edin. İndirilen kaynağı güncellerseniz, website.yml komutunu çalıştırarak pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1 öğesini doğrudan içeren site klasörünü yükleyin.

Aşağı Akış İzi: Test, UAT veya üretim

  1. Geçirilen ve düzeltilen site yapılandırmasını içeren çözümü içeri aktarın. Power Platform yönetim merkezini veya yerleşik dağıtım işlem hattınızı kullanın.

    pac solution import --path "<PATH_TO_SOLUTION_ZIP>" --activate-plugins true --publish-changes true

  2. hedef ortamda Power Pages Yönetim uygulamasını açarak site yapılandırmasının mevcut olduğunu onaylayın. İlgili kayıtlar taşınmadan önce site kaydının ve beklenen yapılandırmanın mevcut olması gerekir.

  1. Desteklenen ilgili kayıtları geçirme. --mode all’ı zaten kullandıysanız bu adımı atlayın. Tamamlandı raporuna kadar durumu denetleyin.

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationDataReferences
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus

  2. Geçiş durumu başarıyla tamamlanmasını bildirdikten sonra etkin siteyi gelişmiş veri modeline geçin. Standart veri modeli web sitesi kaydı devre dışı bırakılır ve buna karşılık gelen gelişmiş veri modeli web sitesi kaydı etkin hale gelir.

    pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"

  3. Siteyi yeniden başlatın.

    1. Power Platform yönetim merkezini açın.
    2. Ortama gidin ve ardından Kaynaklar>Power Pages siteleri seçin.
    3. Siteyi seçin.
    4. Yeniden Başlat'ı seçin. Yeniden Başlat kullanılamıyorsa, siteyi devre dışı bırakın ve etkinleştirin.
    5. Doğrulamadan önce işlemin tamamlanmasını bekleyin.

  4. Şu yöntemlerden birini veya daha fazlasını kullanarak etkin veri modelini onaylayın:

    1. Power Platform yönetim merkezinde siteyi seçin ve Veri modelininGelişmiş olarak gösterildiğini onaylayın.
    2. Sitenin Kurulum çalışma alanını Power Pages design studio'da açın ve görüntülenen veri modelini onaylayın.
    3. gelişmiş yapılandırmanın Power Pages Yönetimi uygulamasında açıldığını onaylayın.
    4. Veri modeli sürümünü çalıştırın pac pages list -v ve onaylayın.

    Tip

    Yalnızca etkin veri modeli değiştiği için site URL'si ve görsel tasarımı değişmez. Geçişi doğrulamak için sitenin görünümünü değil, bu denetimleri kullanın.

4. Aşama: Geçirilen siteyi doğrulama

Üretim sitesini kullanıcılara yeniden açmadan önce doğrulamayı tamamlayın. Her önemli kullanıcı türü ve web rolü için test hesaplarını kullanın ve her kritik testin sonucunu kaydedin.

Alan Doğrulanması gerekenler
Sayfalar ve içerik Giriş sayfası, temsili içerik sayfaları, web şablonları, içerik parçacıkları, web dosyaları, gezinti, yeniden yönlendirmeler ve çok dilli içerik.
Authentication Oturum açma, oturum kapatma, kayıt, davetler, dış kimlik sağlayıcıları ve erişim reddedilen deneyimler.
Authorization Web rolleri, tablo izinleri, sütun izinleri ve sayfa erişim kuralları beklenen eylemlere izin verir ve reddeder.
Formlar ve listeler Site tarafından kullanılan temel formlar, çok adımlı formlar, listeler, form meta verileri, gönderimler, ilgili kayıtlar ve web formu oturumları.
Dynamics 365 şablon yolculukları Şablona özgü sayfalar ve erişim desenleri de dahil olmak üzere uygulamanız tarafından kullanılan ana müşteri, çalışan, topluluk veya iş ortağı yolculukları.
Özel kod Özelleştirme raporunda tanımlanan Liquid, FetchXML, JavaScript, eklentiler, iş akışları ve tümleştirmeler.
Site ayarları ve dosyaları Site ayarları, görüntüler, ekler, SVG dosyaları ve diğer web dosyaları doğru şekilde yüklenir.
Veriler ve referanslar Önemli kayıt sayıları ve desteklenen ilişkili kayıtlar, doğru taşınan site bileşenlerini işaret eder.
Yönetim ve ALM Site, Power Pages Yönetimi’nde açılır ve beklendiği şekilde çözümlere eklenebilir, çözümler içinde dışa aktarılabilir ve çözümlerden içe aktarılabilir.

Tarayıcı tanılamalarını denetleme

Temsilci sayfalarını test ederken tarayıcı geliştirici araçlarını açın. Araştır:

  • , varlıklardan, Liquid'den veya FetchXML'den bahseden adx\_konsol hataları.
  • tarafından verilen \_apiHTTP 401 veya 403 yanıtları, bir izin veya web rolü sorununu gösterebilir.
  • Liquid, FetchXML, eklenti veya tümleştirme hatası gösterebilen HTTP 500 yanıtları.

Geçiş tamamlama ölçütleri

Geçişin yalnızca site gelişmiş veri modelini gösterdiğinde, kritik iş yolculukları geçtiğinde, beklenen güvenlik davranışı onaylandığında ve yüksek etkili özelleştirme bulgularının çözümlendiğinde veya kabul edildiğinde tamamlandığı düşünebilirsiniz.

Üretim geçiş sırası

Geçiş riskini azaltmak için aşağıdaki üretim sırasını kullanın:

  1. Prova için üretim ortamının tam kopyasını oluşturun.
  2. Kopyalanan ortamda CLI, paket ve şablon çözümü önkoşullarını onaylayın.
  3. Özelleştirme raporunu oluşturun ve gözden geçirin.
  4. Kopyalanan geliştirme ortamında yapılandırmayı taşıyın.
  5. Yönetilen bir çözümde özelleştirmeleri düzeltin ve doğrulanmış site yapılandırmasını yakalayın.
  6. Çözümü prova ortamına aktarın, desteklenen ilgili kayıtları geçirin, gelişmiş veri modelini etkinleştirin ve tam doğrulama denetim listesini tamamlayın.
  7. Tüm kritik testler geçene kadar düzeltmeyi ve provayı tekrarlayın.
  8. Üretim bakım penceresini zamanlayın, doğrulama ve geri alma karar noktalarını iletin ve üretimi yedekleyin.
  9. Üretim paketi ve şablon çözümü önkoşullarını yeniden onaylayın.
  10. Doğrulanmış yönetilen çözümü üretime aktarın.
  11. komutunu çalıştırın configurationDataReferences, geçiş durumunu denetleyin, etkin veri modeline geçin ve siteyi yeniden başlatın.
  12. Üretim doğrulama denetim listesini çalıştırın ve siteyi yalnızca kritik testler geçtikten sonra normal kullanıma döndürebilirsiniz.

Geçirilen bir siteyi standart veri modeline geri döndürme

Doğrulama etkinleştirmeden sonra kritik bir sorun tanımlarsa, standart veri modeli web sitesi kaydını yeniden etkinleştirmek için aşağıdaki komutu kullanın:

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"

Komut tamamlandıktan sonra:

  1. Siteyi Power Platform yönetim merkezinden yeniden başlatın.
  2. Sitenin etkin veri modeli olarak Standart'ın gösterildiğini onaylayın.
  3. Sitenin kritik doğrulama testlerini yeniden çalıştırın.
  4. Başka bir geçiş denemesi denemeden önce geçiş raporunu, hata ayrıntılarını ve düzeltme notlarını koruyun.

Important

Üretim geçişi öncesinde geri alma kararını planlayın. Standart ve gelişmiş web sitesi kayıtları ayrı kayıtlar olduğundan, geri dönmeden önce gelişmiş veri modeli anahtarından sonra yapılan değişiklikleri gözden geçirin.

Troubleshooting

İleti veya belirti Olası neden Action
pac powerpages migrate-datamodel tanınmıyor Komut yanlış ad alanını veya güncel olmayan bir CLI'yi kullanıyor. Power Platform CLI'sini güncelleştirin ve kullanın pac pages migrate-datamodel.
CDSBasePortal veya PowerPages_Core listede yok Sistem çözümleri komut çıkışına dahil edilmedi veya paket yüklü değil. pac solution list --includeSystemSolutions'i çalıştırın. Eksik paketi Power Platform yönetim merkezinden yükleyin veya yükseltin.
Web sitesi geçiş için desteklenmiyor Özgün şablon desteklenmiyor, paket sürümleri yetersiz veya eşleşen EDM şablonu çözümü eksik. Şablon çözümü başvurusunda listelenen şablon uygunluğu, paket sürümleri ve EDM çözümünü onaylayın.
pac pages upload için bilinmeyen bir bağımsız değişken --webSiteId iletildi Yükleme komutu web sitesi kimliği bağımsız değişkenini kabul etmez. Argümanı atla. Site, website.yml konumundan tanımlanır.
Yükleme yanlış siteyi hedefliyor veya siteyi bulamıyor Yol, site klasörü yerine sarmalayıcı klasörünü gösterir. Website.yml dosyasını doğrudan içeren alt klasörü kullanın.
Portal kimliği Unknown veya N/A olarak görünür Site etkin değil veya yüklü CLI değeri döndürmüyor. Power Platform yönetim merkezinden veya sitenin /_services/about sayfasından portal kimliğini alın. Uygulama kimliğini kullanmayın.
Taşıma, Completed olarak raporlanıyor, ancak site hâlâ Standard gösteriyor. Etkin veri modeline geçiş yapmadı veya yanlış portal kimliği kullanıldı. Etkinleştirme komutunu web sitesi kimliği ve doğru portal kimliğiyle çalıştırın, ardından siteyi yeniden başlatın ve doğrulayın.
Durum devam ediyor Running Geçiş büyük miktarda veriyi işliyor veya engelleniyor. Durumu denetlemeye devam edin. Desteğe başvurmadan önce ortam, paket, CLI, başlangıç zamanı ve komut ayrıntılarını toplayın. İkinci bir geçiş başlatmayın.
Durum Failed Paket, şablon, özelleştirme, veri veya hizmet hatası işlemi durdurdu. Tam komut çıkışını kaydedin, tanımlanan nedeni düzeltin ve yalnızca başarısız geçiş durumunu gözden geçirdikten sonra yeniden deneyin.
Site açılır, ancak kullanıcılar beklenen verilere erişemez Web rolleri, tablo izinleri veya özel sorgular geçiş sonrasında beklendiği gibi davranmaz. Web rollerini, tablo izinlerini, sütun izinlerini, FetchXML, Liquid ve tarayıcı ağ hatalarını gözden geçirin.

Site özelleştirmeleri için dikkat edilmesi gerekenler

Özelleştirme raporu, standart veri modeli tablolarındaki doğrudan bağımlılıkları tanımlar. Üretim kullanımından önce gerekli düzeltmeyi tamamlayın.

Meta veri tablolarındaki özel sütunlar

adx_webpage gibi standart bir veri modeli tablosu özel bir sütun içeriyorsa, özel verileri depolamak için özel bir tablo oluşturun ve powerpagecomponent öğesine bir arama alanı ekleyin. Özel değerleri yeni tabloya geçirin ve sütunu okuyan veya yazan kodu güncelleştirin.

Özel tablolar ve meta veri tabloları arasındaki ilişkiler

adx_ tablolarını işaret eden özel ilişkileri, uygun geliştirilmiş veri modeli tablosunu, çoğunlukla powerpagecomponent tablosunu, işaret edecek şekilde yeniden oluşturun. Bağımlı formları, görünümleri, eklentileri, akışları ve tümleştirmeleri güncelleştirin.

Meta veri tablolarına Liquid referansları

Doğrudan entities['adx_*'] erişimi, varsa desteklenen bir Liquid nesnesiyle değiştirin. Örneğin, adx_weblinkset veya ilgili tabloları doğrudan sorgulamak yerine Liquid nesnesini kullanınweblinks. Döndürülen nesne ve kullanılabilir öznitelikler farklı olabileceğinden her kullanımı gözden geçirin.

Meta veri tablolarına yönelik FetchXML başvuruları

Doğrudan adx_ varlık başvurularını karşılık gelen powerpagecomponent sanal tablo veya sorguyla değiştirin ve powerpagecomponenttype ölçütüne göre filtreleyin

Standart veri modeli örneği:

<fetch>
  <entity name="adx_webpage">
    <attribute name="adx_name" />
    <filter>
      <condition attribute="adx_partialurl" operator="eq" value="home" />
    </filter>
  </entity>
</fetch>

Gelişmiş veri modeli örneği:

<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>

Özel iş akışları ve eklentiler

Tablolarda adx_ kayıtlı özel iş akışını ve eklenti mantığını yeniden düzenleme. Güncelleştirilmiş mantığı uygun gelişmiş veri modeli tablosuna kaydedin ve gelişmiş şemayı ve öznitelikleri kullanın. Üretim dışı bir ortamda oluşturma, güncelleştirme, silme ve güvenlik davranışlarını test edin.

Komut Referansı

Purpose Command
CLI sürümünü denetleme pac --version
Kimlik doğrulama profillerini listeleme pac auth list
Kimlik doğrulama profili oluşturma pac auth create -u "<ENV_URL>"
Siteleri ve tanımlayıcıları listeleme pac pages list -v
Sistem çözümlerini listeleme pac solution list --includeSystemSolutions
Geçiş durumunu denetleme pac pages migrate-datamodel --webSiteId "<ID>" --checkMigrationStatus
SDM kaynağını indirme pac pages download --webSiteId "<ID>" --modelVersion 1 --path "<OUT>\site-sdm"
EDM kaynağını indirme pac pages download --webSiteId "<ID>" --modelVersion 2 --path "<OUT>\site-edm"
Özelleştirme raporu oluşturma pac pages migrate-datamodel --webSiteId "<ID>" --siteCustomizationReportPath "<OUT>"
Yapılandırmayı taşı pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationData
İlgili kayıtları geçirme pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationDataReferences
Her iki kategoriyi de taşı pac pages migrate-datamodel --webSiteId "<ID>" --mode all
Site kaynağını yükleyin pac pages upload --path "<SITE_ROOT>" --modelVersion 1
EDM'i etkinleştirme pac pages migrate-datamodel --webSiteId "<ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"
SDM'ye geri dönme pac pages migrate-datamodel --webSiteId "<ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"

Site bileşeni türü başvuru

powerpagecomponent öğesini sorguladığınızda, powerpagecomponenttype filtresinde aşağıdaki değerleri kullanın.

Component Value Component Value
Yayın Durumu 1 Web Sayfası 2
Web Dosyası 3 Web Bağlantısı Kümesi 4
Web Bağlantısı 5 Sayfa Şablonu 6
İçerik Kod Parçacığı 7 Web Şablonu 8
Site Ayarı 9 Web Sayfası Erişim Denetimi Kuralı 10
Web Rolü 11 Web Sitesi Erişimi 12
Site İşaretçisi 13 (on üç) Temel Form 15
Temel Form Meta Verileri 16 Liste 17
Tablo İzni 18 Gelişmiş Form 19
Gelişmiş Form Adımı 20 Gelişmiş Form Meta Verisi 21
Anket Yerleşimi 24 Reklam Yerleşimi 26
Bot Tüketicisi 27 Sütun İzni Profili 28
Sütun İzni 29 Redirect 30
Yayımlama Durumu Geçiş Kuralı 31 Shortcut 32
Bulut Akışı 33 UX Bileşeni 34

EDM şablon çözüm referansı

Site şablonu için gelişmiş veri modeli çözümünün yüklü olduğunu onaylamak için komutunu çalıştırın pac solution list --includeSystemSolutions .

Şablon EDM çözümünün benzersiz adı
Başlangıç düzeni 1 DefaultPortalTemplate_V2
Başlangıç düzeni 2 PowerPages_BlankDesign002_V2
Başlangıç düzeni 3 PowerPages_BlankDesign003_V2
Başlangıç düzeni 4 PowerPages_BlankDesign004_V2
Başlangıç düzeni 5 PowerPages_BlankDesign005_V2
Boş sayfa PowerPages_BlankTemplate_V2
FAQ PowerPages_FAQ_V2
Uygulama işleme PowerPages_BuildingPermit_V2
Programa kayıt PowerPages_ProgramRegistration_V2
Toplantıları zamanlama ve yönetme PowerPages_BookMeeting_V2
Topluluk Portalı (Dynamics 365) PowerPages_CommunityPortal_V2
Müşteri Self-Service Portalı (Dynamics 365) PowerPages_CustomerPortal_V2
Çalışan Self-Service Portalı (Dynamics 365) PowerPages_ESSPortal_V2
Ortak Portalı (Dynamics 365) PowerPages_PartnerPortal_V2

İlgili içerik

  • Last updated on