Tutorial: Menggunakan Microsoft Power Platform CLI dengan Power Pages

Dalam tutorial ini, Anda mempelajari cara mulai menggunakan Microsoft Power Platform CLI untuk memperbarui konfigurasi situs web sampel.

Catatan

• Tutorial ini berfokus pada perintah Microsoft Power Platform CLI yang diperlukan untuk penggunaan Power Pages. Untuk informasi lebih lanjut tentang perintah yang digunakan di Power Platform CLI, baca perintah umum.
• Dimulai dengan Power Platform CLI versi 1.27, pac paportal perintah diubah menjadi pac pages. paportal terus berfungsi, tetapi kami sarankan untuk menggunakannya powerpages ke depannya.

Unduh dan Instal Visual Studio Code

Untuk menyambung ke portal Power Apps dan menggunakan perintah Microsoft Power Platform CLI, gunakan Visual Studio Code dan terminal terintegrasi. Terminal terintegrasi memudahkan akses ke lingkungan Dataverse dan mengunduh, mengubah, dan mengunggah konfigurasi portal. Anda juga dapat menggunakan Windows PowerShell.

Langkah 1. Lakukan autentikasi

Sebelum menghubungkan, mendaftar, mengunduh, atau mengunggah perubahan untuk portal Power Apps, Anda harus mengautentikasi ke lingkungan Dataverse lebih dulu. Untuk informasi lebih lanjut tentang autentikasi menggunakan Microsoft Power Platform CLI, buka pac auth.

Untuk mengautentikasi, buka Windows PowerShell, dan jalankan perintah pac auth create menggunakan URL lingkungan Dataverse Anda:

pac auth create -u [Dataverse URL]

Contoh

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

Ikuti petunjuk autentikasi untuk masuk ke lingkungan tersebut.

Langkah 2. Cantumkan situs web yang tersedia

Gunakan perintah daftar halaman pac untuk mencantumkan situs web Power Pages yang tersedia di lingkungan Dataverse yang Anda sambungkan di langkah sebelumnya.

pac pages list

Langkah 3. Unduh konten situs web

Unduh konten situs web dari lingkungan Dataverse yang terhubung menggunakan perintah pac pages download.

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

Contoh

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

Untuk parameter id, gunakan WebSiteId yang dihasilkan dari output langkah sebelumnya.

Catatan

• Gunakan modelVersion1 atau 2 untuk menunjukkan apakah data situs yang akan diunggah akan menggunakan model data standar (1) atau disempurnakan(2).
• Jalankan pac pages list -v perintah untuk melihat model data mana yang digunakan untuk situs Anda. Untuk detail selengkapnya, lihat model data yang ditingkatkan.

Langkah 4. Ubah konten situs web

Ubah konfigurasi menggunakan Visual Studio Code dan simpan perubahan Anda.

Catatan

Pastikan Anda hanya memperbarui tabel yang didukung untuk digunakan dengan Power Platform CLI. Untuk informasi selengkapnya, lihat tabel yang didukung.

Contohnya, halaman portal default menampilkan teks seperti ini:

Teks ini dapat dilihat dari html halaman web:

Anda dapat mengubah teks ini dan menyimpan perubahan:

Tips

Anda dapat mengubah lokasi jalur folder di PowerShell/terminal terintegrasi ke lokasi yang diunduh, dan memasukkan "code ." untuk membuka folder langsung di Visual Studio Code.

Langkah 5. Unggah perubahan

Catatan

• Jika Anda mengunggah ke beberapa lingkungan, lihat unggah perubahan menggunakan profil penyebaran untuk mempelajari cara mengunggah perubahan menggunakan profil penyebaran.
• Pastikan ukuran lampiran maksimum lingkungan target diatur ke ukuran yang sama atau lebih besar seperti lingkungan sumber Anda.
• Ukuran maksimum file ditentukan berdasarkan pengaturan ukuran file Maksimum di tab email pengaturan sistem di kotak dialog pengaturan sistem lingkungan.

Setelah membuat perubahan yang diperlukan, unggah menggunakan perintah unggah halaman pac :

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

Contoh

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

Catatan

Pastikan jalur untuk konten portal yang Anda masukkan sudah benar. Secara default, folder dengan nama portal (nama ramah) dibuat untuk menampung konten portal yang diunduh. Contohnya, jika nama akrab portal adalah custom-portal, jalur untuk perintah di atas (--path) harus C:\pac-portals\downloads\custom-portal.

Upload hanya dilakukan untuk konten yang diubah. Di contoh ini, karena perubahan dibuat pada halaman web, konten hanya diunggah untuk tabel adx_webpage.

Unggah perubahan menggunakan profil penyebaran

Saat bekerja dengan beberapa lingkungan yang berbeda, Anda dapat mempertimbangkan untuk menggunakan profil penyebaran untuk memastikan perubahan diunggah ke lingkungan yang benar menggunakan profil penyebaran.

1. Buat folder bernama deployment-profiles di dalam folder yang berisi konten portal. Misalnya, jika konten portal yang diunduh berada di dalam "starter-portal", folder profil penyebaran harus berada di dalam folder ini.

   

2. Di dalam folder profil penyebaran, buat file YAML penyebaran yang berisi perubahan khusus lingkungan. Misalnya, lingkungan pengembangan dapat disebut "dev.deployment.yml".

   

3. Edit file YAML penyebaran menggunakan Visual Studio Code dengan format berikut:

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

   Contohnya, kode YAML sampel berikut memperbarui nilai untuk "Akhiran Judul Browser" dari default "Portal Kustom" ke "Portal Kustom (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 menerapkan perubahan ke lingkungan yang berbeda menggunakan file YAML profil penyebaran, lakukan autentikasi ke organisasi target terlebih dahulu.

5. Setelah diautentikasi dan tersambung ke lingkungan yang benar, gunakan perintah unggah halaman pac untuk mengunggah konten:

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

   Catatan

   Pada contoh di atas, nama profil penyebaran yang digunakan adalah "dev" setelah mengikuti langkah-langkah sebelumnya untuk membuat profil penyebaran dev. Ubah nama dari "dev" menjadi nama lain (seperti QA untuk "qa.deployment.yml", atau Test untuk "test.deployment.yml") jika Anda menggunakan nama file yang berbeda untuk file YAML deployment Anda.

Langkah 6. Konfirmasikan perubahan

Untuk mengkonfirmasi perubahan yang dilakukan pada halaman web:

1. Pilih sinkronisasi di Studio desain Power Pages.

2. Untuk melihat perubahan, telusuri halaman web.

   

3. Jika Anda menggunakan contoh profil penyebaran yang dijelaskan sebelumnya, cuplikan YAML memperbarui nilainya seperti yang ditunjukkan pada cuplikan layar berikut.

   

   Akhiran judul browser yang diperbarui melalui perubahan di atas menunjukkan perubahan ketika Anda membuka portal di browser:

   

Ini adalah akhir dari tutorial. Anda dapat mengulangi langkah-langkah di atas dan mengubah konten portal untuk tabel lain yang didukung.

Langkah berikutnya

Gunakan ekstensi Visual Studio Code

Baca juga

• Microsoft Power Platform CLI
• Gunakan ekstensi Visual Studio Code