Power Pages için Microsoft Power Platform CLI desteği

Microsoft Power Platform CLI (komut satırı arabirimi), geliştiricilerin ve uygulama oluşturucuların kod bileşenleri oluşturmasını sağlayan basit, tek duraklı bir geliştirici komut satırı arabirimidir.

Microsoft Power Platform CLI araçları, kurumsal geliştiricilerin ve ISV'lerin uzantılarını ve özelleştirmelerini hızlı ve etkili bir şekilde oluşturma, geliştirme, hata ayıklama ve yayımlama işlemlerini gerçekleştirebileceği kapsamlı bir uygulama yaşam döngüsü yönetimi (ALM) hikayesinin ilk adımıdır. Daha fazla bilgi için Microsoft Power Platform CLI nedir? bölümüne gidin

Bu özellik sayesinde Microsoft Power Platform CLI, Power Pages site yapılandırmasında CI/CD'yi (Sürekli Tümleştirme/Sürekli Dağıtım) etkinleştirir. Microsoft Power Platform CLI kullanarak kaynağı denetlemek ve web sitesi yapılandırmasını başka bir ortama taşımak için web sitesi yapılandırmasını kullanabilirsiniz.

Not

• Bu özellik genellikle Power Platform CLI sürüm 1.9.8'den itibaren kullanılabilir. En son sürümü yükleme hakkında bilgi edinmek için bkz. Microsoft Power Platform CLI aracını yükleme.
• Power Platform CLI sürüm 1.32 ile "pac powerpages" komutu "pac pages" olarak değiştirildi. pac cli sürüm 1.27 ile pac paportal komutu pac powerpages olarak değiştirildi. Hem powerpages hem de paportal çalışmaya devam edecek, ancak ilerleyen zamanlarda sayfaları kullanmanızı öneririz.

Web sitesi geliştirme için neden Microsoft Power Platform CLI kullanmalısınız?

Microsoft Power Platform CLI sayesinde artık web sitesi içeriğinde değişiklikler yaparak web sitesi özelleştirmesi için çevrimdışı benzeri özelliğini kullanabilirsiniz. Tüm özelleştirmeler veya değişiklikler kaydedildikten sonra web sitesi yapılandırmasını Microsoft Dataverse'e geri yükleyebilirsiniz. Microsoft Power Platform CLI kullanarak web sitesi içeriğini indirdiğinizde, içerik YAML ve HTML biçimlerinde yapılandırılır ve bu da özelleştirmeyi kolaylaştırır ve profesyonel bir geliştirme deneyimi sağlar.

Aşağıda portalların Microsoft Power Platform CLI desteğiyle yararlandığı özelliklerin ve yeteneklerin listesi sunulmuştur:

Kullanım kolaylığı

• Web sitesi verilerini yerel dosya sistemine karşıya yüklemek veya yerel dosya sisteminden indirmek için destek

• Mevcut Microsoft Power Platform CLI aracında geliştirme yapma.

Uygulama yaşam döngüsü yönetimi (ALM)

• Kuruluş içindeki web sitesi yapılandırması değişikliklerini izleme

• Yapılandırma dosyalarını kuruluşlar veya kiracılar arasında taşıma

Profesyonel geliştirme ve kurumsal destek

• "Git" gibi tüm kaynak denetimi araçlarıyla sorunsuz şekilde tümleştirmeye yardımcı olma

• CI/CD işlem hatlarının kolay kurulumu

Microsoft Power Platform CLI yükleme

Adım adım yönergeler için Microsoft Power Platform CLI yükleme bölümüne bakın.

Desteklenen tablolar

Microsoft Power Platform CLI için portal desteği aşağıdaki tablolarla sınırlıdır.

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding (yalnızca indirme)

adx_websitelanguage

adx_webtemplate

ek açıklama

Önemli

• Özel tablolar ve portal şablonuna özgü tablolar (blog, topluluk veya fikir portalı gibi) Microsoft Power Platform CLI kullanılarak özelleştirme için desteklenmez.
• Reklam (adx_ad) kayıtlarına resim dosyası ekleri Power Platform CLI kullanılarak indirilmiyor. Geçici bir çözüm olarak Görüntü URL alanını kullanın ya da bir resim dosyası içeren web dosyası kaydına Kopyala alanında bir HTML referansı ekleyin.

Portallar için Microsoft Power Platform CLI'yı yükleme ve doğrulama

Microsoft Power Platform CLI yükleme hakkında daha fazla bilgi edinmek için Microsoft Power Platform CLI yükleme makalesine gidin.

Microsoft Power Platform CLI'yi yükledikten sonra bir komut istemi açın ve çıktının Power Apps portalları için komut olan "paportal"ı içerdiğini doğrulamak için pac komutunu çalıştırın.

Portallar için Microsoft Power Platform CLI komutları

Portallar için Microsoft Power Platform CLI komutu "paportal" komutudur.

Aşağıdaki bölümlerde, "paportal" komutunun farklı özellikleri hakkında ek ayrıntılar sağlanmaktadır.

Parametreler

Özellik Adı	Veri Akışı Açıklaması	Örnek
list	Geçerli Dataverse ortamındaki tüm portal web sitelerini listeler. Sitenin standart ve gelişmiş veri modellerinden hangisini kullandığını belirtmek için -v parametresini ekleyebilirsiniz	pac pages list
download	Portal web sitesi içeriğini geçerli Dataverse ortamından indirin. Aşağıdaki parametrelere sahiptir: - path: Web sitesi içeriğinin indirildiği yol (diğer ad: -p) - webSiteId: İndirilecek portal web sitesi kimliği (diğer ad: -id) - overwrite: (İsteğe bağlı) mevcut içeriğin üzerine yazmak için doğru, klasörde zaten web sitesi içeriği olması durumunda başarısız olması için yanlış (diğer ad: -o) - modelVersion: 1 veya 2 indirilecek site verilerinin standart (1) veya gelişmiş veri modelini (2) kullanıp kullanmadiğini belirtmek için.	pac pages download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
upload	Portal web sitesi içeriğini geçerli Dataverse ortamına yükleyin. Aşağıdaki parametreye sahiptir: - path: Web sitesi içeriğinin depolandığı yol (diğer ad: -p) - deploymentProfile: Deployment-profiles/[profile-name].deployment.yamldosyasındaki profil değişkenleri aracılığıyla tanımlanan ortam ayrıntılarıyla portal verilerini karşıya yükleyin - modelVersion: 1 veya 2 karşıya yüklenecek site verilerinin standart (1) veya gelişmiş veri modelini (2) kullanıp kullanmadiğini belirtmek için. - forceUploadAll: Tüm yerel dosyaları ortama iletir. Uzak durumun bozuk, uyumsuz olduğunu veya son indirmenin farklı bir daldan geldiğini düşünüyorsanız bunu kullanın.	pac pages upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Not

• Bir portalı Ortam A'dan indirip Ortam B'ye yüklediğinizde, PAC CLI tam bir yükleme gerçekleştirir. Bu davranış, değişiklik izlemenin ortamlar arasında durum bilgilerini taşımayan Bildirim Dosyalarını kullanması nedeniyle oluşur.
• Delta yüklemeleri, yalnızca değiştirilen dosyaların yüklendiği bir süreçtir ve bu destek yalnızca aynı ortamda hem indirme hem de yükleme işlemleri gerçekleştirildiğinde sağlanır. Bu durumda, PAC CLI yerel değişiklikleri algılar ve yalnızca güncelleştirilmiş dosyaları karşıya yükler. Değişiklik izlemenin nasıl çalıştığı hakkında daha fazla bilgi edinmek için bkz. Bildirim Dosyaları.
• Bu durumlarda --forceUploadAll komutunu kullanın. (Bu parametre şu anda yalnızca CLI'dır. Azure DevOps görevleri henüz bunu ortaya çıkarmıyor.)
  • Ardışık düzen durum kayması (yeniden temellendirdiğiniz veya seçtiğiniz taahhütler, artık dalınıza uymuyor).
  • Delta hatasından şüphe duyulması (örneğin, normal bir upload sonrasında yalnızca kısmi değişiklikler görünür).

Dağıtım profili kullanma

deploymentProfile anahtarı, ortam için YAML biçiminde bir değişkenler kümesi tanımlamanıza olanak sağlar. Örneğin, profilde tanımlanan farklı şema ayrıntılarına sahip farklı dağıtım profillerine (geliştirme, test, üretim gibi) sahip olabilirsiniz.

Test profili oluşturuyorsanız deployment-profiles altından "test.deployment.yml" (yani <profileTag>.deployment.yml) adıyla dosya oluşturabilirsiniz. Ayrıca bu profili kullanmak için komutu etiket (<profileTag>) ile çalıştırabilirsiniz:

pac pages upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2

Bu dosyada tablo kimliği, öznitelik listesi ve deploymentProfile parametresini kullanarak portal yapılandırmasını karşıya yüklerken geçersiz kılmak istediğiniz değerleri içeren tablonun (varlık) adını kullanabilirsiniz.

Buna ek olarak, işletim sisteminin ortam değişkenlerine erişmek için OS değişkenini kullanabilirsiniz.

Aşağıda, benzersiz şema ayrıntıları olan bu "test.deployment.yml" profili YAML dosyasının bir örneği bulunmaktadır:

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

Not

Portallara ek olarak CLI'da kullanılan tüm komutlar hakkında bilgi edinmek için Microsoft Power Platform CLI'daki ortak komutlar bölümüne gidin.

Bildirim dosyaları

pac pages download CLI komutunu kullanarak web sitesi içeriğini indirdiğinizde, site içeriğini indirmenin yanı sıra iki tane manifesto dosyası da oluşturur.

• Ortam bildirim dosyası (org-url-manifest.yml)
• İzleme bildirim dosyasını sil (manifest.yml)

Ortam bildirim dosyası (org-url-manifest.yml)

Pac sayfaları indirme komutu her çalıştırıldığında ortam bildirim dosyası oluşturulur.

Her indirme işleminden sonra, PAC CLI aracı var olan ortam bildirim dosyasını okur ve ortamda silinen girişleri güncelleştirir ya da yoksa, ortam bildirim dosyasını oluşturur.

Portal web sitesi içeriğini karşıya yüklemek için pac pages upload komutunu çalıştırdığınızda. Ortam bildirim dosyasını okur ve son indirme işleminden sonra yapılan değişiklikleri tanımlar ve yalnızca güncelleştirilmiş içeriği yükler. Bu, her karşıya yükleme komutunda tüm içeriği yüklenmek yerine, yalnızca güncelleştirilmiş web sitesi içeriğini yükleyerek karşıya yükleme işleminin en iyi duruma getirilmesine yardımcı olur.

Ortam bildirimi dosyası, yanlışlıkla değişiklikleri önlemek için aynı ortama bağlandığında (ortam URL'si dosya adıyla eşleşir) salt okunurdur.

Not

• Ortam bildirim dosyası, web sitesini farklı ortamlara dağıtırken değişiklikleri izlemek için tasarlanmamıştır.
• Ortam bildirim dosyası, geliştiriciler tarafından geliştirici ortamlarında yerel olarak dağıtmada kullanmak için tasarlanmıştır ve yok sayılanlar listesini almak için eklenmelidir.

İzleme bildirim dosyasını sil (manifest.yml)

Bu dosya, ortamdan silinmiş kayıtları izlemek için kullanılır.

Pac sayfaları indirme komutuyla web sitesi içeriği indirildiğinde, bu işlem ortam bildirim dosyasından (org-url-manifest.yml) silinen kayıtları manifest.yml dosyasına ekler. Bu nedenle, pac pages upload komutunu kullanarak web sitesi içeriğini karşıya yüklediğinizde, dosyaları ortamdan siler (farklı bir ortamda olsa bile). Bu dosya silinmez ve bağlandığınız ortamdan bağımsız olarak kullanılır. Hedef ortamdaki öğeleri silmeyi düşünmek için değişiklikler kaynak denetimine aktarılırken bu dosyanın dikkate alınması gerekir.

Not

Bir ortamdaki site içerik kayıtlarını silmek ve pac CLI kullanarak aynı içerik kayıtlarını başka bir ortamda silmek için, web sitesi kayıt içeriğini silmeden önce ve sonrapac sayfaları indirme komutunu çalıştırmanız gerekir. pac pages upload komutu çalıştırıldığında manifest.yml bu değişiklikleri izler ve hedef ortamda karşılık gelen kayıtları kaldırır.

Visual Studio Code uzantısını kullanma

IntelliSense'in yerleşik Liquid dilinden, kod tamamlama yardımından, ipuçlarından yararlanmak ve VS Code Entegre Terminali'ni kullanarak Microsoft Power Platform CLI ile etkileşim kurmak için VS Code uzantısı Power Platform VS Code Uzantısı'nı da kullanabilirsiniz. Daha fazla bilgi: Visual Studio Code uzantısını kullanın (önizleme)

Diğer dikkate alınacak noktalar

• Dosya yolunuzun yol uzunluğu üst sınırını aşması durumunda bir hata bildirilir. Daha fazla bilgi: Windows'ta yol uzunluğu üst sınırı
• Yinelenen web sayfası adı gibi yinelenen kayıtlar için Microsoft Power Platform CLI iki farklı klasör oluşturur; biri web sayfasının adıyla, diğeri ise aynı adın önüne karma kodu eklenmiş olarak. Örneğin, "My-page" ve "My-page-hash-code".

Sonraki adımlar

Öğretici: Portallarla Microsoft Power Platform CLI kullanma

Ayrıca bkz.

• Microsoft Power Platform CLI
• Visual Studio Code uzantısını kullanma (önizleme)