Bagikan melalui

Dukungan Microsoft Power Platform CLI untuk Power Pages

  • Artikel

Microsoft Power Platform CLI (Antarmuka Baris Perintah) adalah antarmuka baris perintah pengembang satu atap sederhana yang memberdayakan pengembang dan pembuat aplikasi untuk membuat komponen kode.

Alat Microsoft Power Platform CLI adalah langkah pertama menuju kisah manajemen siklus hidup aplikasi (ALM) yang komprehensif, yang memungkinkan pengembang perusahaan dan ISV membuat, membangun, men-debug, serta mempublikasikan ekstensi dan penyesuaian mereka secara cepat dan efisien. Untuk informasi selengkapnya, buka Apa itu Microsoft Power Platform CLI?

Dengan fitur ini, memungkinkan Microsoft Power Platform CLI CI/CD (Integrasi Kontinu/Penyebaran Kontinu) konfigurasi situs Power Pages. Anda sekarang dapat memeriksa konfigurasi situs Web untuk mengontrol sumber dan memindahkan konfigurasi situs web ke lingkungan apa pun menggunakan Microsoft Power Platform CLI.

Catatan

  • Fitur ini umumnya tersedia mulai dari Power Platform CLI versi 1.9.8. Untuk mempelajari tentang menginstal versi terbaru, buka Menginstal Microsoft Power Platform CLI.
  • Dimulai dengan Power Platform CLI versi 1.27, perintah diubah pac paportal menjadi pac powerpages. paportal terus bekerja, tetapi kami sarankan untuk menggunakan powerpages ke depan. Artikel ini akan segera diperbarui untuk digunakan powerpages sebagai gantinya paportal.

Mengapa menggunakan Microsoft Power Platform CLI untuk pengembangan situs web?

Dengan Microsoft Power Platform CLI, Anda sekarang dapat menggunakan kemampuan seperti offline untuk penyesuaian situs web dengan membuat perubahan pada konten situs web. Dan setelah semua penyesuaian atau perubahan disimpan, Anda dapat mengunggah konfigurasi situs web kembali ke Microsoft Dataverse. Bila Anda mengunduh konten situs web menggunakan Microsoft Power Platform CLI, konten terstruktur dalam format YAML dan HTML akan memudahkan penyesuaian, sehingga memungkinkan pengalaman pro-pengembangan.

Berikut adalah daftar fitur dan kemampuan yang dimanfaatkan portal dengan dukungan untuk Microsoft Power Platform CLI:

Kemudahan penggunaan

  • Dukungan untuk mengunduh/mengunggah data konfigurasi situs web ke/dari sistem file lokal

  • Build pada alat Microsoft Power Platform CLI yang ada.

Manajemen siklus hidup aplikasi (ALM)

  • Melacak perubahan konfigurasi situs web dalam organisasi

  • Memindahkan file konfigurasi di seluruh organisasi, atau penyewa

Dukungan pro-pengembangan dan perusahaan

  • Membantu mengintegrasikan dengan lancar dengan alat kontrol sumber, seperti "git"

  • Konfigurasi alur CI/CD dengan mudah

Instal Microsoft Power Platform CLI

Untuk petunjuk langkah demi langkah, lihat Menginstal Microsoft Power Platform CLI.

Tabel yang didukung

Dukungan portal untuk Microsoft Power Platform CLI terbatas pada tabel berikut.

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding (hanya unduhan)

adx_websitelanguage

adx_webtemplate

anotasi

Penting

  • Tabel kustom dan tabel khusus template portal (seperti blog, komunitas, atau portal ide) tidak didukung untuk penyesuaian menggunakan Microsoft Power Platform CLI.
  • Lampiran file gambar ke rekaman iklan (adx_ad) tidak diunduh menggunakan CLI Power Platform. Sebagai solusi, gunakan bidang URL Gambar atau dengan menambahkan referensi HTML pada bidang Salin ke rekaman file web yang berisi file gambar.

Menginstal dan memverifikasi Microsoft Power Platform CLI untuk portal

Untuk mempelajari tentang cara menginstal Microsoft Power Platform CLI, buka Instal Microsoft Power Platform CLI.

Setelah menginstal Microsoft Power Platform CLI, buka arahan perintah dan jalankan pac untuk memverifikasi bahwa output berisi "paportal" - perintah untuk portal Power Apps.

Konfirmasikan perintah paportal di Microsoft Power Platform CLI.

Perintah Microsoft Power Platform CLI untuk portal

Perintah Microsoft Power Platform CLI untuk portal adalah "paportal".

Bagian berikut memberikan rincian lain tentang properti yang berbeda dari perintah "paportal".

Parameter

Nama Properti Deskripsi Contoh
list Mencantumkan semua situs web portal dari lingkungan Dataverse saat ini.

Anda dapat menambahkan parameter v untuk menunjukkan apakah situs menggunakan model data standar atau yang disempurnakan		 pac paportal list
Unduh Unduh konten situs web portal dari lingkungan Dataverse saat ini. Ini memiliki parameter berikut:
- path: Jalur tempat konten situs web diunduh (alias: -p)
- webSiteId: ID situs web portal untuk diunduh (alias: -id)
- overwrite(Opsional) benar - untuk menimpa konten yang ada, salah - gagal jika folder sudah memiliki konten situs web (alias: -o)
- modelVersion: 1 atau 2 untuk menunjukkan apakah data situs yang akan diunduh menggunakan model data standar (1) atau yang disempurnakan(2).		 pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
upload Unggah konten situs web portal ke lingkungan Dataverse saat ini. Ini memiliki parameter berikut:
- path: Jalur tempat konten situs web akan disimpan (alias: -p)
- deploymentProfile: Mengunggah data portal dengan rincian lingkungan yang ditentukan melalui variabel profil pada file deployment-profiles/[profile-name].deployment.yaml
- modelVersion: 1 atau 2 untuk menunjukkan apakah data situs yang akan diunggah menggunakan model data standar (1) atau yang disempurnakan(2).		 pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Gunakan profil penyebaran

Tombol deploymentProfile memungkinkan Anda menentukan rangkaian variabel untuk lingkungan dalam format YAML. Misalnya, Anda dapat memiliki profil penyebaran yang berbeda (seperti dev, test, prod) yang memiliki rincian skema berbeda yang ditentukan di profil.

Jika Anda membuat profil pengujian, Anda dapat membuat file dalam profil penyebaran dengan nama "test.deployment.yml" (yakni <profileTag>.deployment.yml). Dan Anda dapat menjalankan perintah dengan tag (<profileTag>) untuk menggunakan profil ini:

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

Di file ini, Anda dapat memiliki nama tabel (entitas) dengan ID tabel, daftar atribut, dan nilai yang ingin Anda kesampingkan saat mengunggah konfigurasi portal menggunakan parameter deploymentProfile.

Selain itu, Anda dapat menggunakan variabel OS untuk mengakses variabel lingkungan sistem operasi.

Berikut adalah contoh file YAML profil "test.deployment.yml" yang memiliki rincian skema unik:

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

Catatan

Untuk mempelajari tentang semua perintah yang digunakan di CLI selain portal, buka perintah Umum di Microsoft Power Platform CLI.

File manifes

Saat Anda mengunduh konten situs web menggunakan perintah CLI unduhan pac paportal, bersama dengan mengunduh konten situs, itu juga menghasilkan dua file manifes;

  • File manifes lingkungan (org-url-manifest.yml)
  • Menghapus file manifes pelacakan (yml.erf)

File manifes lingkungan (org-url-manifest.yml)

File manifes lingkungan dihasilkan setiap kali ketika perintah unduh pac paportal dijalankan.

Setelah setiap unduhan, alat CLI PAC membaca file pernyataan lingkungan yang ada dan memperbarui entri yang dihapus di lingkungan atau membuat file pernyataan lingkungan jika tidak ada.

Ketika Anda menjalankan perintah unggah pac paportal untuk mengunggah konten situs web portal. File ini membaca file manifes lingkungan dan mengidentifikasi perubahan yang dibuat sejak unduhan terakhir dan hanya mengunggah konten yang diperbarui. Hal ini membantu dalam mengoptimalkan proses pengunggahan karena hanya konten situs web yang diperbarui yang akan diunggah, bukan mengunggah semua konten pada setiap perintah pengunggahan.

File manifes lingkungan bersifat readonly ketika terhubung ke lingkungan yang sama (URL lingkungan cocok dengan nama file), untuk menghindari perubahan yang tidak disengaja.

Catatan

  • File pernyataan lingkungan tidak dirancang untuk melacak perubahan saat menyebarkan situs web ke lingkungan yang berbeda.
  • File pernyataan lingkungan dirancang untuk digunakan oleh pengembang untuk disebarkan secara lokal di lingkungan pengembang mereka dan harus ditambahkan ke daftar abaikan git.

Menghapus file manifes pelacakan (yml.erf)

File ini digunakan untuk melacak rekaman yang dihapus dari lingkungan.

Ketika konten situs web diunduh dengan perintah unduhan pac paportal, ini menambahkan catatan yang dihapus dari file manifes lingkungan (org-url-manifest.yml) ke file manifest.yml. Jadi, ketika Anda mengunggah konten situs web menggunakan perintah unggah pac paportal, itu menghapus file dari lingkungan (bahkan ke lingkungan yang berbeda). File ini tidak dihapus dan akan digunakan terlepas dari lingkungan yang tersambung. File ini harus dipertimbangkan saat mendorong perubahan ke kontrol sumber untuk mempertimbangkan menghapus item di lingkungan target.

Catatan

Untuk menghapus rekaman konten situs di satu lingkungan dan juga menghapus rekaman konten yang sama di lingkungan lain menggunakan CLI PAC, Anda harus menjalankan perintah unduh pac paportal sebelum dan setelah menghapus konten rekaman situs web. manifest.yml akan melacak perubahan ini dan menghilangkan rekaman yang sesuai di lingkungan target ketika perintah unggahan pac paportal dijalankan.

Menggunakan ekstensi Visual Studio Code

Anda juga dapat menggunakan Ekstensi VS Code Ekstensi VS Code Power Platform untuk mendapatkan manfaat bahasa Liquid built-in dari IntelliSense, asisten penyelesaian kode, mengisyaratkan, dan berinteraksi dengan Microsoft Power Platform CLI menggunakan VS Code Integrated Terminal. Informasi selengkapnya: Menggunakan ekstensi Visual Studio Code (Pratinjau)

Pertimbangan lainnya

  • Kesalahan dilaporkan jika jalur file Anda melebihi batasan panjang jalur maksimum. Informasi selengkapnya: Pembatasan panjang jalur maksimum di Windows
  • Untuk rekaman duplikat seperti nama halaman web duplikat, Microsoft Power Platform CLI membuat dua folder berbeda—satu dengan nama halaman web, dan lainnya dengan nama yang sama yang diawali dengan kode hash. Contohnya, "Halaman saya" dan "Halaman saya-kode-hash".

Langkah berikutnya

Tutorial: Menggunakan Microsoft Power Platform CLI dengan portal

Baca juga