Tutorial: Gunakan Microsoft Power Platform CLI dengan Power Pages

Dalam tutorial ini, anda belajar cara mula menggunakan Microsoft Power Platform CLI untuk mengemas kini konfigurasi tapak web sampel.

Nota

• Tutorial ini memfokuskan pada perintah Microsoft Power Platform CLI yang diperlukan untuk penggunaan Power Pages. Untuk maklumat lanjut tentang perintah yang digunakan dalam Power Platform CLI, baca Perintah biasa.
• Bermula dengan Power Platform CLI versi 1.27, pac paportal arahan ditukar kepada pac powerpages. paportal terus berfungsi, tetapi kami mengesyorkan menggunakan powerpages pada masa hadapan. Artikel ini tidak lama lagi akan dikemas kini untuk digunakan powerpages bukan paportal.

Muat turun dan pasang Visual Studio Code

Untuk menyambung kepada portal Power Apps dan untuk menggunakan perintah Microsoft Power Platform CLI, gunakan Visual Studio Code dan terminal bersepadu. Terminal bersepadu memudahkan anda untuk connect dengan persekitaran Dataverse dan untuk memuat turun, mengubah dan memuat naik konfigurasi portal. Anda juga boleh menggunakan Windows PowerShell sebaliknya.

Langkah 1. Sahkan

Sebelum anda connect, menyenarai, memuat turun atau memuat naik sebarang perubahan untuk portal Power Apps anda mesti mengesahkan persekitaran Dataverse terlebih dahulu. Untuk maklumat lanjut mengenai pengesahan menggunakan Microsoft Power Platform CLI, pergi ke pac auth.

Untuk pengesahan, buka Windows PowerShell dan jalankan perintah pac auth create menggunakan URL persekitaran Dataverse anda:

pac auth create -u [Dataverse URL]

Contoh

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

Ikuti gesaan pengesahan untuk daftar masuk ke persekitaran.

Langkah 2. Senaraikan tapak web tersedia

Gunakan perintah senarai paportal pac untuk menyenaraikan tapak web Power Pages tersedia dalam persekitaran Dataverse anda sambungkan dalam langkah sebelumnya.

pac paportal list

Langkah 3. Muat turun kandungan tapak web

Muat turun kandungan tapak web daripada persekitaran Dataverse yang disambungkan menggunakan perintahmuat turun paportal pac.

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

Contoh

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

Untuk parameter id gunakan WebSiteId dikembalikan daripada output langkah sebelumnya.

Nota

• Gunakan modelVersion1 atau 2 untuk menunjukkan sama ada data tapak yang akan dimuat naik akan menggunakan model data standard (1) atau dipertingkatkan(2).
• Jalankan pac powerpages list -v perintah untuk melihat model data yang digunakan untuk laman web anda. Untuk mendapatkan butiran lanjut, pergi ke model data yang dipertingkatkan.

Langkah 4. Ubah kandungan tapak web

Tukar konfigurasi menggunakan Visual Studio Code dan simpan perubahan anda.

Nota

Pastikan anda mengemas kini hanya jadual yang disokong untuk kegunaan Power Platform CLI. Untuk maklumat lanjut, lihat Jadual disokong.

Contohnya, halaman portal lalai menunjukkan teks seperti ini:

Teks ini boleh dilihat dari HTML halaman web:

Anda boleh mengubah teks ini dan menyimpan perubahan:

Tip

Anda boleh mengubah lokasi laluan folder dalam PowerShell/terminal bersepadu ke lokasi yang dimuat turun dam masukkan "kod." untuk membuka folder terus dalam Visual Studio Code.

Langkah 5. Muat naik perubahan

Nota

• Jika anda memuat naik ke berbilang persekitaran, lihat muat naik perubahan menggunakan profil pelaksanaan untuk mengetahui cara memuat naik perubahan menggunakan profil pelaksanaan.
• Pastikan bahawa saiz lampiran maksimum persekitaran sasaran ditetapkan pada saiz yang sama atau lebih besar daripada persekitaran sumber anda.
• Saiz maksimum fail ditentukan oleh tetapan Saiz fail maksimum dalam tab e-mel tetapan sistem dalam kotak dialog tetapan sistem persekitaran.

Selepas membuat perubahan yang diperlukan, muat naiknya menggunakan perintah pac paportal upload:

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

Contoh

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

Nota

Pastikan laluan untuk kandungan portal yang anda masukkan adalah betul. Secara lalai, folder yang dinamakan oleh portal (nama mesra) dicipta dengan kandungan portal telah dimuat turun. Contohnya, jika nama mesra portal adalah custom-portal, laluan untuk perintah di atas (--path) hendaklah C:\pac-portals\downloads\custom-portal.

Muat naik hanya berlaku untuk kandungan yang diubah. Dalam contoh ini, sejak perubahan dibuat pada halaman web, kandungan dimuat naik hanya untuk jadual adx_webpage.

Muat naik perubahan menggunakan profil pelaksanaan

Apabila bekerja dengan berbilang persekitaran yang berbeza, anda mungkin mempertimbangkan untuk menggunakan profil penggunaan untuk memastikan perubahan dimuat naik ke persekitaran yang betul menggunakan profil penggunaan.

1. Cipta folder yang bernama deployment-profiles di dalam folder yang mengandungi kandungan portal. Contohnya, jika kandungan portal yang dimuat turun berada dalam "starter-portal", folder profil pelaksanaan sepatutnya berada di dalam folder ini.

   

2. Dalam folder profil pelaksanaan, cipta fail YAML pelaksanaan yang mengandungi perubahan khusus persekitaran. Contohnya, persekitaran pembangunan boleh digelar "dev.deployment.yml".

   

3. Edit fail YAML pelaksanaan menggunakan Visual Studio Code dengan format berikut:

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

   Contohnya, sampel kod YAML berikut mengemas kini nilai untuk "Akhiran Tajuk Pelayar" daripada "Portal Tersuai" lalai kepada "Portal Tersuai (Dev)".

   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. Untuk memuat naik perubahan kepada persekitaran berbeza menggunakan fail YAML profil pelaksanaan, pengesahan kepada organisasi sasaran terlebih dahulu.

5. Selepas disahkan dan disambungkan kepada persekitaran yang betul, gunakan perintah pac paportal upload untuk memuat naik kandungan:

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

   Nota

   Dalam contoh di atas, nama profil pelaksanaan yang digunakan ialah "dev" selepas mengikuti langkah sebelumnya untuk mencipta profil pelaksanaan dev. Ubah nama daripada "dev" kepada nama yang lain (seperti QA untuk "qa.deployment.yml", atau Ujian untuk "test.deployment.yml") jika anda telah menggunakan nama fail yang berlainan untuk fail YAML anda.

Langkah 6. Sahkan perubahan

Untuk mengesahkan perubahan yang dibuat kepada halaman web:

1. Pilih Segerak dalam studio reka bentuk Power Pages.

2. Untuk melihat perubahan, layari ke halaman web.

   

3. Jika anda menggunakan contoh profil penggunaan yang dijelaskan sebelum ini, cebisan YAML mengemas kini nilai seperti yang ditunjukkan dalam tangkapan skrin berikut.

   

   Akhiran tajuk pelayar yang dikemas kini melalui perubahan di atas menunjukkan perubahan apabila anda membuka portal dalam pelayar:

   

Kesimpulan tutorial. Anda boleh mengulangi langkah di atas dan mengubah kandungan portal untuk jadual disokong yang lain.

Langkah-langkah berikutnya

Gunakan sambungan Visual Studio Code

Lihat juga

• Microsoft Power Platform CLI
• Gunakan sambungan Visual Studio Code