Standart veri modeli sitelerini gelişmiş veri modeline geçirme (önizleme)
[Bu konu yayın öncesi belgesine dahildir ve değiştirilebilir.]
Bu makalede mevcut standart veri modeli sitenizin gelişmiş veri modeline nasıl geçirileceğini öğrenin.
Önemli
- Bu, bir önizleme özelliğidir.
- Önizleme özellikleri, üretimde kullanıma yönelik değildir ve sınırlı işlevselliğe sahip olabilir. Bu özellikler, müşterilerin erken erişim elde etmesi ve geri bildirim sağlaması amacıyla resmi sürümden önce kullanıma sunulur.
Önkoşullar
- Sitelerinizi gelişmiş veri modeline geçirmek için sürüm 1.31.6 veya üstü ile Microsoft Power Platform CLI yüklemelisiniz. Daha fazla bilgi: En son Power Platform CLI'yı yükleme
- Dataverse temel portal paketi 9.3.2307.x veya üstü.
- Power Pages Temel paketi 1.0.2309.63 veya üstü. Daha fazla bilgi: Power Pages çözümü güncelleştirme
- Geçiş adımlarını tamamlamak için Power Pages platformunda Power Platform CLI'yi nasıl kullanacağınızı anlamanız gerekir. Power Pages platformunda Power Platform CLI'ya aşina değilseniz, bu Power Platform CLI öğreticisini gözden geçirmek ve Power Pages ile çalışmaya için PAC CLI komutlarına başvurmak isteyebilirsiniz.
1. Adım. Var olan standart site meta verileri için özelleştirmeyi indirme ve denetleme
Komut istemi açın.
Aşağıdaki komutu kullanarak, geçiş için web sitesi kaydını indirmek üzere Power Platform ortamınızda Dataverse kuruluşunun kimliğini doğrulayın.
pac auth create -u [Dataverse URL]
Örnek
pac auth create -u https://contoso-org.crm.dynamics.com
Daha fazla bilgi: pac auth oluşturma
Geçerli kuruluşta web sitelerinin listesini oluşturmak için aşağıdaki komutu kullanın.
pac powerpages list
Daha fazla bilgi: pac powerpages listesi
Özelleştirme raporunu indirmek için aşağıdaki komutu kullanın.
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]
Örnek
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"
İndirilen raporda herhangi bir özelleştirme bulursanız, gelişmiş veri modeline geçiş sonrası bunu düzeltmek için rapordaki yönergeleri izleyin. Daha fazla bilgi: Siteleri standarttan gelişmiş veri modeline geçirirken site özelleştirmeyle ilgili dikkate alınacak noktalar
2. Adım. Site verilerini standarttan gelişmiş veri modeline geçirme
Site verilerinizi gelişmiş veri modeline geçirmek için aşağıdaki komutu kullanın.
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]
Mod 3 değer içerebilir:
configurationData: web sitesi için meta verileri geçir. Daha fazla bilgi: Yapılandırma verilerini depolamak için tabloların listesi
configurationDataReferences: web sitesi için işlem verilerini geçir. Daha fazla bilgi: Yapılandırma dışı verileri depolamak için tabloların listesi
tümü: her iki veri türünü de taşı.
Örnek
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all
Geçiş aracı çözümleri doğrular. Bahsedilen şablon için ilgili gelişmiş veri modeli çözümü olmadan standart veri modeli çözümü varsa, bir uyarı görüntülenir: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template
Taşınan web sitesinin düzgün çalışmasını sağlamak için geliştirilmiş veri modeli paketlerinin eşleştirilmesi gereken Program kaydı ve Toplantıları Planla ve Yönet gibi belirli şablonlar vardır. Bu gelişmiş veri modeli paketlerini elde etmek için, ilgili şablon (gelişmiş veri modeli için ortam etkinleştirilmelidir) için geçişe yönelik gelişmiş veri modeli uyumlu çözümler sağlayacak yeni bir site oluşturmalısınız.
Geçiş için desteklenen şablonlar
Geçiş için aşağıdaki şablonlara sahip siteler desteklenir:
- Başlangıç düzeni 1-5
- Uygulama işleme
- Boş sayfa
- Programa kaydolma
- Toplantıları zamanlama ve yönetme
3. Adım. Geçiş durumunu doğrulama
Sitenizin geçiş durumunu doğrulamak için aşağıdaki komutu kullanın:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus
Örnek
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus
Not
Site geçişiniz beklenenden daha uzun sürüyorsa, veri hacminden kaynaklanabilir. Komut isteminiz kapanırsa yeni bir komut istemi açın ve sitenin durumunu doğrulamak için bu adımdaki komutu kullanın.
4. Adım. Başarılı veri geçişinden sonra site veri modeli sürümünü güncelleştirme
Aşağıdaki komut güncelleştirme sitesi veri modeli sürümünü kullanın:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]
Not
- Portal kimliğini, web sitesinin URL'sine ekli "/_services/about" seçeneği ile web sitesine giderek bulabilirsiniz. Bu seçenekleri görüntüleyebilmek için kullanıcının tüm web sitesi erişim izinlerinin atanmış olduğu bir web rolüne sahip olması gerekir.
- Site veri modeli sürümü güncelleştirildikten sonra, standart veri modeline bağlı web sitesi kaydı devre dışı bırakılır. Bunun yerine, site artık gelişmiş veri modeliyle ilişkili web sitesi kaydına başvuracaktır.
- Kullanıcının
updateDatamodelVersion
veyarevertToStandardDataModel
argümanlarıyla geçiş komutunu yürütmek için aşağıdaki rollerden herhangi birine sahip olması gerekir. Bu işlem, sitenizi gelişmiş veri modeline geçirmek ya da tersini yapmak için yönetici eylemi gerçekleştirecektir.
Örnek
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e
Geçirilen siteyi gelişmiş veri modelinden standart veri modeline geri döndürme
Standart veri modeli sitesini geçişten sonra gelişmiş veri modeline geri döndürmek için aşağıdaki komutu kullanın:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]
Not
Taşınan bir siteyi gelişmiş veri modelinden standart veri modeline geri döndürdüğünüzde, gelişmiş veri modeliyle ilişkili web sitesi kaydı devre dışı bırakılır ve standart veri modelinin web sitesi kaydı yeniden etkinleştirilir.
Örnek
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e
Üretim sitesini standarttan gelişmiş veri modeline geçirme
Bir üretim sitesinin geçişini yapmadan önce, üretim sitesinin tam kopyasını oluşturmanızı öneririz. Ayrıca üretim sitesini taşımanın çalışma saatleri dışında yapılmasını öneririz.
Üretim sitenizi gelişmiş veri modeline geçirmek için bu adımları kullanın:
- PAC CLI
migrate-datamodel
komutunu kullanarak kopyalanan ortamda sitede taşımayı deneyin. - Yönetilen çözüme site yapılandırma verileri ekleyin ve üretim ortamına içe aktarın.
- Yapılandırma dışı veri geçişi yapmak için PAC CLI komutlarını kullanın ve üretime yönelik veri modeli sürümünü güncelleştirerek bunu tamamlayın.
Not
Geçiş için kaynak ve üretim web sitesi kimliği aynıdır.
Siteleri standarttan gelişmiş veri modeline geçirirken site özelleştirmeyle ilgili dikkate alınacak noktalar
Bu bölüm standarttan gelişmiş veri modeline bir site geçişi için özelleştirmeyi düzelen rehberlik sağlar.
Adx meta veri tablolarında beş tür site özelleştirmesi vardır:
- Adx meta veri tablolarındaki özel sütunlar
- Özel tablolar ve adx tablolar arasındaki ilişki
- Liquid kod parçacığındaki adx tablo başvuruları
- Fetch xml'de adx tablosu başvuruları
- Adx tablolarındaki özel iş akışı ve eklentiler
Not
Tüm özelleştirmeyle ilgili düzeltmeler geliştirilmiş veri modeline geçişten sonra yapılacaktır.
Adx meta veri tablolarındaki özel sütunlar
Bu özelleştirmeyi gelişmiş veri modelinde düzeltmek için sistem tabloları ve yeni özel tablo arasında bir ilişki oluşturun ve verileri yeni tabloya geçirin.
Standart veri modeli: Tablo adx_webpage
, contoso_pagetype
gibi özel bir sütun içerir.
Gelişmiş veri modeli: contoso_webpage
aslı yeni bir tablo oluşturun. Bu, contoso_pagetype
adı verilen bir sütunu ve powerpagescomponent
ile ilişkili contoso_webpage_id
arama sütununu içerir. Tablo oluşturma için Veri çalışma alanı'ndan faydalanın.
Özel tablolar ve adx tablolar arasındaki ilişki
Bu özelleştirmeyi gelişmiş veri modelinde düzeltmek için özel tablolar ve sistem tabloları arasında bir ilişki oluşturun.
tandart veri modeli:: adx_webpage
tablosunun adx_webpage_contoso_pagelogs
tablosuyla contoso_pagelogs
isimli bir ilişkisi vardır.
Gelişmiş veri modeli: contoso_webpage
tablosıyla powerpagecomponent_contoso_pagelogs
isimli yeni bir ilişki yarat. Tablo oluşturma için Veri çalışma alanı'ndan faydalanın.
Liquid kod parçacığındaki adx tablo başvuruları
Bu özelleştirmeyi gelişmiş bir veri modelinde düzeltmek için liquid koddaki adx tablosu başvurularını gelişmiş veri modeli sanal tabloları mspp başvurularıyla değiştirin. Alternatif olarak, karşılık gelen başvuruları almak içinBileşen Türü (mantıksal adı powerpagecomponenttype
) özniteliği ile birlikte Site Bileşeni (mantıksal adı powerpagecomponent
) tablosunu kullanabilirsiniz.
Standart veri modeli:entities
Liquid etiketi {% assign app_weblinks= entities['adx_weblinks'] %}
kodundaki weblinks değerlerine ulaşmak için kullanılır.
Gelişmiş veri modeli: entities
Liquid etiketi yoluyla weblinks kullanmak yerine ilgili Liquid nesneleri kullanın.
entities[adx_weblinks]
doğrudan. Bu durumda entities['adx_weblinks']
, weblinks
Liquid nesnesiyle değiştirilebilir.
Fetch xml'de adx tablosu başvuruları
Bu özelleştirmeyi gelişmiş bir veri modelinde düzeltmek için FetchXML'deki adx tablosu başvurularını gelişmiş veri modeli sanal tabloları doğrudan başvurularıyla değiştirin. Alternatif olarak, karşılık gelen başvuruları almak içinBileşen Türü (mantıksal adı powerpagecomponenttype
) özniteliği ile birlikte Site Bileşeni (mantıksal adı powerpagecomponent
) tablosunu kullanabilirsiniz.
Standart veri modeli: Tablo adı adx_webrole
, FetchXML sorgusunda kullanılır.
{% fetchxml app_webroles %}
<fetch>
<entity name='adx_webrole'>
<attribute name='adx_name'/>
<entity>
</fetch>
{% endfetchxml %}
Gelişmiş veri modeli: Alternatif olarak, karşılık gelen başvuruları almak için Bileşen Türü (mantıksal adı powerpagecomponenttype
) özniteliği ile birlikte Site Bileşeni (mantıksal adı powerpagecomponent
) tablosunu kullanın.
{% fetchxml app_webroles %}
<fetch>
<entity name='powerpagecomponent'>
<attribute name='adx_name'/>
<filter type='and'>
<condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
<entity>
</fetch>
{% endfetchxml %}
Site bileşeni türü ve değerleri
Bileşen Türü | Değer |
---|---|
Yayın Durumu | Kategori 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 |
Temel Form | 15 |
Temel Form Meta Verileri | 16 |
List | 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 |
Yeniden Yönlendir | 30 |
Yayımlama Durumu Geçiş Kuralı | 31 |
Kısayol | 32 |
Bulut Akışı | 33 |
UX Bileşeni | 34 |
Adx tablolarındaki özel iş akışı ve eklentiler
Bu özelleştirmeyi gelişmiş veri modelinde düzeltmek için iş akışı ve eklenti mantığının sitenin ilgili tablosunda yeniden ele alınması ve yeniden kaydedilmesi gerekir.
Örneğin, bir kullanıcı iş akışını/eklentisini standart veri modelinde Birincil Varlık kısmına Web Sayfası (mantıksal adı adx_webpage
) tablosu olarak kaydettiyse, sonrasında iş akışı/eklenti içindeki kod Site Bileşeni (mantıksal adı powerpagecomponent
) tablosuna ve öznitelikleri geliştirilmiş veri modeline değiştirilmelidir.
Bilinen sorunlar
Geçiş komutu yalnızca standart veri modelinden gelişmiş veri modeline kadar toplu 5K kayıtlarının toplu işini işliyor.