Öğretici: Portallarla Microsoft Power Platform CLI kullanma

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.

Bu öğretici örneğinde, örnek portal yapılandırmasını güncelleştirmek için Microsoft Power Platform CLI kullanmaya başlama yöntemini göreceksiniz.

Not

• Power Platform CLI'yı Power Pages ile de kullanabilirsiniz. Daha fazla bilgi: Power Pages nedir
• Bu öğretici, Power Apps portalları kullanımı için gerekli Microsoft Power Platform CLI komutlarına odaklanır. Power Platform CLI'da kullanılan komutlar hakkında daha fazla bilgi için Yaygın komutlar bölümünü okuyun.

Visual Studio Code'u indirme ve yükleme

Power Apps portallarına bağlanmak ve Microsoft Power Platform CLI komutlarını kullanmak için Visual Studio Code ve tümleşik terminali kullanma. Tümleştirilmiş terminal, Dataverse ortamına bağlanmayı ve portal yapılandırmasını indirmeyi, değiştirmeyi ve karşıya yüklemeyi kolaylaştırır. Bunun yerine Windows PowerShell'i de kullanabilirsiniz.

Adım 1. Kimliği doğrula

Power Apps portalı için değişiklikleri bağlama, listeleme, indirme veya yükleme işlemlerini gerçekleştirmeden önce Dataverse ortamında kimliğinizi doğrulamanız gerekir. Microsoft Power Platform CLI kullanarak kimlik doğrulaması hakkında daha fazla bilgi için pac auth sayfasına gidin.

Kimlik doğrulaması yapmak için Windows PowerShell'i açın ve Dataverse ortam URL'nizi kullanarak pac auth oluştur komutunu çalıştırın:

pac auth create -u [Dataverse URL]

Örnek

pac auth create -u https://contoso-org.crm.dynamics.com

Ortamda oturum açmak için kimlik doğrulaması istemlerini izleyin.

2. Adım. Kullanılabilir portalları listele

Önceki adımda bağlandığınız Dataverse ortamındaki kullanılabilir Power Apps portallarını listelemek için pac paportal listele komutunu kullanın.

pac paportal list

3. Adım. Portal içeriklerini indirme

Bağlı Dataverse ortamından pac paportal indir komutunu kullanarak portal web sitesi içeriğini indirin.

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Örnek

pac paportal download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

id parametresi için önceki adımın çıkış işleminden döndürülen WebSiteId değerini kullanın.

4. Adım. Portallar içeriğini değiştir

Visual Studio Code'u kullanarak yapılandırmayı değiştirin ve değişikliklerinizi kaydedin.

Not

Power Platform CLI ile kullanılmak üzere yalnızca desteklenen tabloları güncelleştirdiğinizden emin olun. Daha fazla bilgi için bkz. Desteklenen tablolar.

Örneğin, varsayılan portal sayfası şuna benzer bir metin görüntüler:

Bu metin, web sayfası html satırında görünür:

Bu metni değiştirebilir ve değişiklikleri kaydedebilirsiniz:

İpucu

PowerShell/tümleşik terminalinin klasör yolu konumunu indirilen konuma değiştirebilir ve “code .” ifadesini girerek klasörü doğrudan Visual Studio Code'da açabilirsiniz.

Adım 5. Değişiklikleri yükle

Not

• Birden çok ortama yükleme yapıyorsanız, dağıtım profili kullanarak değişikliklerin nasıl karşıya yükleneceğini öğrenmek için dağıtım profilini kullanarak değişiklikleri karşıya yükleme makalesine bakın.
• Hedef ortamın en fazla ek boyutunun kaynak ortamınızla aynı veya daha fazla boyuta ayarlandığından emin olun.
• Dosyaların maksimum boyutu, ortam sistem ayarları iletişim kutusundaki sistem ayarları e-posta sekmesinde yer alan Maksimum dosya boyutu ayarına göre belirlenir.

Gerekli değişiklikleri yaptıktan sonra pac paportal yükle komutunu kullanarak bunları karşıya yükleyin:

pac paportal upload --path [Folder-location]

Örnek

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Not

Girdiğiniz portal içeriği yolunun doğru olduğundan emin olun. Varsayılan olarak, indirilen portal içerikleriyle portal tarafından adlandırılan bir klasör (kolay ad) oluşturulur. Örneğin, portalın kolay adı custom-portal ise yukarıdaki komutun yolu (--path), C:\pac-portals\downloads\custom-portal olmalıdır.

Yükleme, yalnızca değiştirilen içerik için gerçekleşir. Bu örnekte, değişiklik bir web sayfasında yapıldığından içerik yalnızca adx_webpage tablosu için yüklenir.

Dağıtım profili kullanarak değişiklikleri karşıya yükle

Birden çok farklı ortamla çalışırken, değişikliklerin dağıtım profili kullanılarak doğru ortama yüklendiğinden emin olmak için dağıtım profilleri kullanmayı düşünebilirsiniz.

1. Portal içeriğini içeren klasörün içinde dağıtım profilleri adlı bir klasör oluşturun. Örneğin, karşıdan yüklenen portal içeriği "starter-portal" içindeyse, dağıtım profilleri klasörü bu klasörün içinde olmalıdır.

   

2. Dağıtım profilleri içinde, ortama özgü değişiklikleri içeren bir dağıtım YAML dosyası oluşturun. Örneğin, geliştirme ortamına "dev.deployment.yml" adı verilebilir.

   

3. Aşağıdaki biçimdeki bir Visual Studio Code kullanarak dağıtım YAML dosyasını düzenleyin:

   <table-name>:
   - <record-id>: <GUID>
     <column-name>: <Name>
     <column-value>: <Value>
   

   Örneğin, aşağıdaki örnek YAML kodu, "Tarayıcı Başlık Soneki" değerini varsayılan "Özel Portal" kaynağından "Özel Portal (Geliştirme)" olarak güncelleştirir.

   adx_contentsnippet:
       - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
         adx_name: Browser Title Suffix # Setting name
         adx_value:   · Custom Portal (Dev) # Setting value
   

4. Bir dağıtım profili YAML dosyası kullanarak değişiklikleri farklı bir ortama yüklemek için öncelikle hedef kuruluşa kimlik doğrulaması yapın.

5. Kimlik doğrulaması yapıldıktan ve doğru ortama bağlandıktan sonra içeriği yüklemek için pac paportal yükle komutunu kullanın:

   pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile dev

   Not

   Yukarıdaki örnekte, bir geliştirme dağıtım profili oluşturmak için yukarıdaki adımlar uygulandıktan sonra kullanılan dağıtım profili adı "geliştirme" olarak kullanılır. Dağıtım YAML dosyanız için farklı bir dosya adı kullandıysanız "geliştirme" adından farklı bir ad kullanın ("qa.deployment.yml" için QA veya "test.deployment.yml" için Test gibi).

Adım 6. Değişiklikleri onaylayın

Portal web sayfasında yapılan değişiklikleri onaylamak için:

1. Sunucu tarafı önbelliğini temizleyin veya Power Apps portalları Stüdyosunu kullanarak Eşitleme Yapılandırması'nı kullanın.

2. Değişikliği görmek için portal web sayfasına gidin.

   

3. Daha önce açıklanan bir dağıtım profili örneği kullandıysanız YAML parçacığı değeri aşağıda gösterildiği şekilde güncelleştirir.

   

   Yukarıdaki değişiklik aracılığıyla güncelleştirilmiş tarayıcı başlığı soneki, portalı bir tarayıcıda açtığınızda değişikliği gösterir:

   

Bununla birlikte öğretici sonuna gelinmiştir. Yukarıdaki adımları tekrarlayabilir ve diğer desteklenen tablolar için portal içeriğini değiştirebilirsiniz.

Sonraki adımlar

Visual Studio Code uzantısını kullanma

Ayrıca bkz.

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