Bagikan melalui

Tutorial: Menggunakan Microsoft Power Platform CLI dengan Power Pages

  • Artikel

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 powerpages. paportal terus berfungsi, tetapi kami sarankan untuk menggunakan 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. 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.

Contoh cara mengautentikasi ke lingkungan Dataverse menggunakan Microsoft Power Platform CLI

Langkah 2. Cantumkan situs web yang tersedia

Gunakan perintah pac powerpages list untuk mencantumkan situs web yang tersedia Power Pages di lingkungan yang Dataverse Anda sambungkan pada langkah sebelumnya.

pac powerpages list

Contoh daftar situs web.

Langkah 3. Unduh konten situs web

Unduh konten situs web dari lingkungan yang terhubung Dataverse menggunakan perintah unduh pac powerpages.

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

Contoh

pac powerpages 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.

Teks yang digunakan oleh pembaca layar.

Catatan

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

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 halaman portal sampel

Teks ini dapat dilihat dari html halaman web:

Visual Studio Code dengan teks yang disorot perubahannya.

Anda dapat mengubah teks ini dan menyimpan perubahan:

Memperbarui teks menggunakan Visual Studio Code.

Tip

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 pac powerpages upload :

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

Contoh

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

Memulai pengunggahan.

Catatan

Pastikan jalur untuk konten portal yang Anda masukkan sudah benar. Secara default, folder bernama portal (nama akrab) dibuat dengan 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 terjadi untuk konten yang diubah. Di contoh ini, karena perubahan dibuat pada halaman web, konten hanya diunggah untuk tabel adx_webpage.

Unggah hanya selesai untuk konten yang diubah.

Mengunggah 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.

    Folder untuk profil penyebaran

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

    YAML profil penyebaran untuk dev

  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:  &nbsp;ยท 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 terhubung ke lingkungan yang benar, gunakan perintah pac powerpages upload untuk mengunggah konten:

    pac powerpages 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" 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:

  1. Pilih sinkronisasi di Studio desain Power Pages.

  2. Untuk melihat perubahan, telusuri ke halaman web.

    Melihat konten halaman yang diperbarui.

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

    Akhiran judul browser dari aplikasi Portal Management

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

    Perubahan 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 Visual Studio ekstensi Kode

Baca juga