Öğretici: Microsoft Power Platform CLI'yı Power Pages ile kullanma

Bu eğitimde, örnek bir web sitesinin yapılandırmasını güncellemek için Microsoft Power Platform CLI'yi kullanmaya nasıl başlayacağınızı öğreneceksiniz.

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 web sitelerini listele

Önceki adımda bağlandığınız Dataverse ortamındaki kullanılabilir Power Pages web sitelerini listelemek için pac powerpages list komutunu kullanın.

pac powerpages list

3. Adım. Web sitesi içeriğini indir

pac powerpages download komutunu kullanarak bağlı Dataverse ortamından web sitesi içeriğini indirin.

pac powerpages download --path [PATH] -id [WebSiteId-GUID] --modelVersion [DataModel]

Örnek

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

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

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

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

Ö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:

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

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

pac powerpages upload --path [Folder-location] --modelVersion [ModelVersion]

Örnek

pac powerpages upload --path C:\pac-portals\downloads\custom-portal\ --modelVersion 2

Yükleme yalnızca değiştirilen içerikler 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 powerpages upload komutunu kullanın:

   pac powerpages upload --path "C:\portals\starter-portal" --deploymentProfile dev --modelVersion 2

   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

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

1. Power Pages tasarım stüdyosunda Eşitle'yi seçin.

2. Değişikliği görmek için web sayfasına göz atın.

   

3. Daha önce açıklanan dağıtım profili örneğini kullandıysanız YAML pasajı, değeri aşağıdaki ekran görüntüsünde gösterildiği gibi günceller.

   

   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
• Visual Studio Code uzantısını kullanma