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
komutupac powerpages
olarak değiştirilmiştir.paportal
çalışmaya devam eder ancak ileriye yönelik olarakpowerpages
kullanmanızı öneririz. Bu makalede yakındapaportal
yerinepowerpages
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 sonra pac 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