Dukungan portal untuk Microsoft Power Platform CLI

Catatan

Mulai 12 Oktober 2022, portal Power Apps menjadi Power Pages. Informasi selengkapnya: Microsoft Power Pages kini tersedia secara umum (blog)
Kami akan segera memigrasikan dan menggabungkan dokumentasi portal Power Apps dengan dokumentasi Power Pages.

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, lihat Apa itu Microsoft Power Platform CLI?

Dengan fitur ini, Microsoft Power Apps portal mendukung Microsoft Power Platform CLI untuk mengaktifkan CI/CD (Continuous Integration/Continuous Deployment) konfigurasi portal. Anda sekarang dapat memeriksa konfigurasi portal untuk kontrol sumber dan memindahkan konfigurasi portal 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 cara menginstal versi terbaru, lihat Menginstal Microsoft Power Platform CLI.

Mengapa menggunakan Microsoft Power Platform CLI untuk pengembangan portal?

Dengan dukungan portal untuk Microsoft Power Platform CLI, Anda sekarang dapat menggunakan kemampuan seperti offline untuk penyesuaian portal dengan membuat perubahan pada konten portal. Dan setelah semua penyesuaian atau perubahan disimpan, unggah ke portal. Bila Anda mengunduh konten portal 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 portal ke/dari sistem file lokal

• Build pada alat Microsoft Power Platform CLI yang ada.

Manajemen siklus hidup aplikasi (ALM)

• Melacak perubahan konfigurasi portal 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 yang tercantum di bawah.

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.

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	Description	Contoh
daftar	Mencantumkan semua situs web portal dari lingkungan Dataverse saat ini.	pac paportal list
Unduh	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: ID situs web portal untuk diunduh (alias: -id) - timpa : (Opsional) benar - untuk menimpa konten yang ada, salah - gagal jika folder sudah memiliki konten situs web (alias: -o)	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
unggah	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	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"

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

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

Bila Anda mengunduh konten situs web menggunakan perintah CLI unduhan pac paportal, bersamaan dengan mengunduh konten situs, konten tersebut juga akan 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 PAC CLI membaca file manifes lingkungan yang ada dan memperbarui entri yang dihapus di lingkungan, atau membuat file manifes 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 hanya akan dibaca bila terhubung ke lingkungan yang sama (URL lingkungan cocok dengan nama file), untuk menghindari perubahan yang tidak disengaja.

Menghapus file manifes pelacakan (yml.erf)

File ini digunakan untuk melacak rekaman yang dihapus dari lingkungan.

Bila konten situs web diunduh dengan perintah unduh pac paportal, ini akan menambahkan rekaman yang dihapus dari file manifes lingkungan (org-url-manifest.yml) ke file manifest.yml. Jadi, bila Anda mengunggah konten situs web menggunakan perintah pac paportal maka file akan dihapus dari lingkungan (bahkan ke lingkungan yang berbeda). File ini tidak dihapus, dan akan digunakan terlepas dari lingkungan mana Anda terhubung.

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 Power Platform VS Code VS Code Extension untuk mendapatkan manfaat bahasa Liquid bawaan dari IntelliSense, bantuan penyelesaian kode, petunjuk, dan berinteraksi dengan CLI menggunakan Terminal Terintegrasi VS Code Microsoft Power Platform . Informasi selengkapnya: Menggunakan ekstensi Visual Studio Code (Pratinjau)

Pertimbangan tambahan

• 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

Lihat juga

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