Microsoft Power Platform CLI için portal desteği
Not
12 Ekim 2022 tarihi itibarıyla Power Apps portalları, Power Pages olarak adlandırılmıştır. Daha fazla bilgi: Microsoft Power Pages genel kullanıma sunuldu (blog)
Yakında Power Apps portalları belgelerini taşıyıp Power Pages belgeleri ile birleştireceğiz.
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 bkz. Microsoft Power Platform CLI nedir?
Bu özellik sayesinde Microsoft Power Apps portalları, portal yapılandırmasında CI/CD (Sürekli Tümleştirme/Sürekli Dağıtım) etkinleştirmek için Microsoft Power Platform CLI'yı destekler. Microsoft Power Platform CLI kullanarak kaynağı denetlemek ve portal yapılandırmasını başka bir ortama taşımak için portal yapılandırmasını şimdi denetim yapabilirsiniz.
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.
Portal geliştirme için neden Microsoft Power Platform CLI kullanmalısınız?
Microsoft Power Platform CLI için portal desteği sayesinde artık portal içeriğinde değişiklikler yaparak portal özelleştirmesi için çevrimdışı benzeri özelliğini kullanabilirsiniz. Tüm özelleştirmeler veya değişiklikler kaydedildikten sonra bunları portala yükleyin. Microsoft Power Platform CLI kullanarak portal 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ığı
Portal 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 portal 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ğıda listelenen 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. | pac paportal list |
| indir | Portal web sitesi içeriğini geçerli Dataverse ortamından indirin. Aşağıdaki parametrelere sahiptir: - path: Web sitesi içeriğinin indirileceğ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) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| 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 profil değişkenleri aracılığıyla tanımlanan ortam ayrıntılarını içeren porta verilerini karşıya yükleyin |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
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" adıyla (<profileTag>.deployment.yml) 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
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ı
pac paportal indir CLI komutunu kullanarak web sitesi içeriği indirdiğinizde, site içeriğni indirmenin yanı sıra iki bildirim dosyası da oluşturulur;
- 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 bildirim dosyası, yanlışlıkla değişiklik yapılmasını önlemek üzere, aynı ortama (dosya adıyla eşleşen ortam URL'si) bağlandığında salt okunur olur.
İ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 indir komutuyla indirildiğinde ortam bildirim dosyasından (org-url-manifest.yml) silinen kayıtlar manifest.yml dosyasına eklenir. Böylece, pac paportal yükle komutunu kullanarak web sitesi içeriğini yüklediğinizde dosyalar ortamdan silinir (hatta farklı bir ortama bile). Bu dosya silinmez ve bağlandığınız ortamdan bağımsız olarak kullanılır.
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
Dikkat edilecek diğer 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