Tutorial: Menggunakan CLI Microsoft Power Platform dengan portal

Dalam contoh tutorial ini, Anda akan melihat cara memulai Microsoft Power Platform CLI untuk memperbarui konfigurasi portal sampel.

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. 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 otentikasi untuk masuk ke lingkungan.

Langkah 2. Cantumkan portal yang tersedia

Gunakan perintah daftar pac paportal untuk mencantumkan portal Power Apps yang tersedia dalam lingkungan Dataverse yang tersambung ke langkah sebelumnya.

pac paportal list

Langkah 3. Unduh konten portal

Unduh konten situs web portal dari lingkungan Dataverse yang tersambung menggunakan perintah unduh pac paportal.

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

Contoh

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

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

Langkah 4. Ubah konten portal

Ubah konfigurasi menggunakan Visual Studio Code dan simpan perubahan Anda.

Contohnya, halaman portal default menampilkan teks seperti ini:

Teks ini dapat dilihat dari html halaman web:

Anda dapat mengubah teks ini dan menyimpan perubahan:

Langkah 5. Unggah perubahan

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

pac paportal upload --path [Folder-location]

Contoh

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

Pengunggahan hanya terjadi untuk konten yang telah diubah. Di contoh ini, karena perubahan dibuat pada halaman web, konten hanya diunggah untuk tabel adx_webpage.

Mengunggah perubahan menggunakan profil penyebaran

Saat bekerja dengan beberapa lingkungan berbeda, Anda dapat mempertimbangkan 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 contoh 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 mengunggah perubahan ke lingkungan yang berbeda menggunakan file YAML profil penyebaran, otentikasikan ke organisasi target lebih dulu.

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

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

   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" ke lainnya (seperti QA untuk "qa.deployment.yml", atau Uji untuk "test.deployment.yml") jika Anda telah menggunakan nama file yang berbeda untuk file YAML penyebaran.

Langkah 6. Konfirmasikan perubahan

Untuk mengkonfirmasi perubahan yang dilakukan pada halaman web portal:

1. Kosongkan cache sisi server, atau gunakan Sinkronisasi Konfigurasi menggunakan Studio portal Power Apps.

2. Telusuri halaman web portal untuk melihat perubahan.

   

3. Jika Anda telah menggunakan contoh profil penyebaran yang telah dijelaskan sebelumnya, data cuplikan YAML akan memperbarui nilai seperti ditunjukkan di bawah.

   

   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

Menggunakan ekstensi Visual Studio Code

Baca juga

• Microsoft Power Platform CLI
• Menggunakan ekstensi Visual Studio Code (Pratinjau)