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ın tek bir yerde kod bileşenleri oluşturmasını destekleyen basit 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.27'den itibaren pac paportal komutu pac powerpages olarak değiştirilmiştir. paportal çalışmaya devam eder ancak ileriye yönelik olarak powerpages kullanmanızı öneririz. Bu makalede yakında paportal yerine powerpages kullanılacak şekilde güncelleştirilecektir.

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; böylece özelleştirme kolaylaşır ve profesyonel geliştirme deneyimi sunulur.

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 şablona özel tablolar (ör. blog, topluluk veya fikirler portalı), Microsoft Power Platform CLI kullanarak özelleştirme için desteklenmez.
• Reklam (adx_ad) kayıtlarına resim dosyası ekleri, Power Platform CLI kullanılarak indirilmez. Geçici bir çözüm olarak Görüntü URL alanını kullanın veya bir görüntü dosyası içeren bir web dosyası kaydına Kopyala alanında bir HTML referansı ekleyin.

Portallar için Microsoft Power Platform CLI'ı 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 yüklendikten sonra, bir komut istemi açın ve çıktıda "paportal" (Power Apps portalları komutu) öğesinin yer aldığını 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ı	Tanım	Örnek
listele	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 paportal list
indir	Portal web sitesi içeriğini geçerli Dataverse ortamından indirin. Aşağıdaki parametrelere sahiptir: - yol: 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: İndirilecek site verilerinin standart (1) mi yoksa gelişmiş veri modelini (2) mi kullandığını belirtmek için 1 veya 2.	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
yükle	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.yaml dosyasındaki profile variables aracılığıyla tanımlanan ortam ayrıntılarını içeren porta verilerini karşıya yükleyin - modelVersion: Yüklenecek site verilerinin standart (1) mi yoksa gelişmiş veri modelini (2) mi kullandığını belirtmek için 1 veya 2.	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

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 paportal 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 yaygın komutlar makalesine gidin.

Bildirim dosyaları

Eğer pac portal download CLI komutunu kullanarak web sitesi içeriğini indirdiğinizde, site içeriğini indirmenin yanı sıra iki bildirge dosyası oluşturur;

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

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

Ortam bildirim dosyası pac paportal indir komutu her çalıştırıldığında 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 yüklemek pac portal yükle 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.

Web sitesi içeriği pac paportal download komutuyla indirildiğinde, bu işlem, ortam bildirim dosyasından (org-url-manifest.yml) silinen kayıtları manifest.yml dosyaya ekler. Dolayısıyla, pac paportal upload komutunu kullanarak web sitesi içeriğini yüklediğinizde, dosyalar ortamdan (farklı bir ortama bile) silinir. 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çeriği kayıtlarını silmek ve PAC CLI kullanarak başka bir ortamdaki aynı içerik kayıtlarını da silmek için web sitesi kaydı içeriğini silmeden önce ve sonrapac paportal indir komutunu kullanmanız gerekir. manifest.yml bu değişiklikleri izleyecek ve pac paportal yükle komutu çalıştırıldığında hedef ortamdaki ilgili kayıtları kaldıracaktır.

Visual Studio Code uzantısını kullanma

IntelliSense yerleşik Liquid dili, kod tamamlama desteği, ipuçları ve VS Code Tümleşik Terminali kullanarak Microsoft Power Platform CLI ile etkileşimden yararlanmak için VS Code uzantısı Power Platform VS Code Uzantısı'ndan da yararlanabilirsiniz. Daha fazla bilgi: Portallar için Visual Studio Code uzantısını (önizleme) kullanma

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. Bunlardan biri web sayfasının adıyla, diğeri aynı adın karma kod ön eki almış haliyle oluşturulur. Ö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
• Portallar için Visual Studio Code uzantısını (önizleme) kullanma