Dukungan Microsoft Power Platform CLI untuk Power Pages

Microsoft Power Platform CLI (antarmuka baris perintah) adalah antarmuka baris perintah pengembang tunggal 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, Microsoft Power Platform CLI memungkinkan konfigurasi CLI CI/CD (Integrasi Kontinu/Penyebaran Kontinu) 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 cara menginstal versi terbaru, buka Instal Microsoft Power Platform CLI.
• Dengan Power Platform CLI versi 1.32, perintah pac powerpages diubah menjadi pac pages. Dengan pac cli versi 1.27, perintah pac paportal diubah menjadi pac powerpages. Baik Power Pages maupun paportal akan terus berfungsi, tetapi sebaiknya gunakan halaman ke depannya.

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

• Dibangun 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 templat portal (seperti blog, komunitas, atau portal ide) tidak didukung untuk penyesuaian menggunakan Microsoft Power Platform CLI.
• Lampiran file gambar pada rekaman iklan (adx_ad) tidak diunduh menggunakan Power Platform CLI. 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.

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 pages list
download	Unduh konten situs web portal dari lingkungan Dataverse saat ini. Ini memiliki parameter berikut: - path: Jalur tempat konten situs web akan diunduh (alias: -p) - webSiteId: 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 ditingkatkan (2).	pac pages 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 detail lingkungan yang ditentukan melalui variabel profil di 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 ditingkatkan (2). - forceUploadAll: Mendorong semua file lokal ke lingkungan. Gunakan ini ketika Anda berpikir status jarak jauh rusak, tidak sinkron, atau ketika unduhan terakhir berasal dari cabang yang berbeda.	pac pages upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Catatan

• Saat Anda mengunduh portal dari Lingkungan A dan mengunggahnya ke Lingkungan B, PAC CLI melakukan unggahan lengkap. Perilaku ini terjadi karena pelacakan perubahan menggunakan File Manifes, yang tidak membawa informasi status di seluruh lingkungan.
• Unggahan Delta—di mana hanya file yang dimodifikasi yang diunggah—hanya didukung saat operasi pengunduhan dan pengunggahan terjadi dalam lingkungan yang sama. Dalam hal ini, PAC CLI mendeteksi perubahan lokal dan hanya mengunggah file yang diperbarui. Untuk mempelajari selengkapnya tentang cara kerja pelacakan perubahan, lihat Manifest Files.
• Gunakan --forceUploadAll dalam situasi ini. (Parameter ini saat ini hanya CLI. Tugas Azure DevOps belum menampilkannya.)
  • Pipeline state drift (Anda melakukan rebase atau cherry-pick commit, sehingga keadaan terakhir server tidak lagi sesuai dengan branch Anda).
  • Dugaan kegagalan delta (misalnya, hanya perubahan parsial yang muncul setelah normal upload).

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 pages 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

Ketika Anda mengunduh konten situs web menggunakan perintah CLI pac pages download, sambil mengunduh konten situs, itu juga menghasilkan dua file-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 perintah unduhan halaman pac 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.

Saat Anda menjalankan perintah pac pages upload 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 saat terhubung ke lingkungan yang sama (URL lingkungan cocok dengan nama file), untuk menghindari perubahan yang tidak disengaja.

Catatan

• File manifes 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 menggunakan perintah pac pages download, 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 halaman pac , itu akan 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 dalam satu lingkungan dan juga menghapus rekaman konten yang sama di lingkungan lain menggunakan PAC CLI, Anda harus menjalankan perintah unduhan halaman pacsebelum dan sesudah menghapus konten rekaman situs web. manifest.yml akan melacak perubahan ini dan menghapus rekaman yang sesuai di lingkungan target saat perintah unggah halaman pac 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

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