Sokongan portal untuk Microsoft Power Platform CLI

Nota

Berkuat kuasa pada 12 Oktober 2022, portal Power Apps ialah Power Pages. Maklumat lanjut: Microsoft Power Pages kini tersedia secara umum (blog)
Kami akan memindahkan dan menggabungkan dokumentasi portal Power Apps dengan dokumentasi Power Pages tidak lama lagi.

Microsoft Power Platform CLI (Antara Muka Baris Perintah) adalah pembangun antara muka baris perintah yang ringkas dan sehenti, yang memberi kuasa kepada pembangun dan pembuat aplikasi untuk mencipta komponen kod.

Peralatan Microsoft Power Platform CLI ialah langkah pertama ke arah pengurusan kitar hayat aplikasi (ALM) yang komprehensif di mana pembangun perusahaan dan ISVs boleh mencipta, membina, menyahpepijat dan menerbitkan sambungan dan penyesuaian mereka dengan pantas dan berkesan. Untuk maklumat lanjut, lihat Apakah itu Microsoft Power Platform CLI?

Dengan ciri ini, Microsoft Power Apps portal menyokong Microsoft Power Platform CLI untuk membolehkan CI/CD (Integrasi Berterusan/Penggunaan Berterusan) konfigurasi portal. Anda kini boleh menyemak konfigurasi portal untuk mengawal sumber dan mengalihkan konfigurasi portal ke mana-mana persekitaran menggunakan Microsoft Power Platform CLI.

Nota

Ciri ini secara amnya tersedia bermula dengan Power Platform CLI versi 1.9.8. Untuk mengetahui tentang memasang versi terkini, lihat Pasang Microsoft Power Platform CLI.

Mengapa menggunakan Microsoft Power Platform CLI untuk pembangunan portal?

Dengan sokongan portal untuk Microsoft Power Platform CLI, anda kini boleh menggunakan keupayaan seperti luar talian untuk penyesuaian portal dengan membuat perubahan pada kandungan Portal. Dan setelah semua penyesuaian atau perubahan disimpan, muat naik ia ke portal. Apabila anda memuat turun kandungan portal menggunakan Microsoft Power Platform CLI, kandungan format berstruktur dalam YAML dan HTML menjadikan ia mudah untuk disesuaikan, mendayakan pengalaman pro-pembangunan.

Berikut ialah senarai ciri dan keupayaan yang dimanfaatkan oleh portal daripada dengan sokongan untuk Microsoft Power Platform CLI:

Kemudahan penggunaan

• Sokongan untuk muat turun/muat naik data portal kepada/dari sistem fail tempatan

• Bina pada alat Microsoft Power Platform CLI sedia ada.

Pengurusan kitaran hayat aplikasi (ALM)

• Jejaki perubahan pada konfigurasi portal dalam organisasi

• Alih fail konfigurasi merentas organisasi atau penyewa

Pro-dev dan sokongan perusahaan

• Membantu sepadukan dengan lancar dengan sebarang alat kawalan sumber seperti "git"

• Sediakan talian paip CI/CD dengan mudah

Pemasangan Microsoft Power Platform CLI

Untuk arahan langkah demi langkah, rujuk Pasang CLI Microsoft Power Platform.

Jadual yang disokong

Sokongan portal untuk Microsoft Power Platform CLI adalah terhad kepada jadual yang disenaraikan 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 muat turun)

adx_websitelanguage

adx_webtemplate

anotasi

Penting

• Jadual tersuai dan templat portal-jadual tertentu (seperti blog, komuniti atau portal idea) tidak disokong untuk penyesuaian menggunakan Microsoft Power Platform CLI.
• Lampiran fail imej pada rekod iklan (adx_ad) tidak dimuat turun menggunakan CLI Power Platform. Sebagai penyelesaian, gunakan medan URL Imej atau dengan menambah rujukan HTML dalam medan Salin pada rekod fail web yang mengandungi fail imej.

Pasang dan sahkan Microsoft Power Platform CLI untuk portal

Untuk mengetahui tentang memasang Microsoft Power Platform CLI pergi ke Pasang Microsoft Power Platform CLI.

Selepas memasang CLI Microsoft Power Platform, buka gesaan perintah dan jalankan pac untuk mengesahkan bahawa output mengandungi "paportal" - perintah untuk portal Power Apps.

Perintah Microsoft Power Platform CLI untuk portal

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

Bahagian berikut memberikan butiran lanjut tentang sifat berbeza perintah "paportal".

Parameter

Nama Sifat	Description	Contoh
senarai	Senaraikan semua tapak web portal daripada persekitaran Dataverse semasa.	pac paportal list
muat turun	Muat turun kandungan tapak web portal daripada persekitaran Dataverse semasa. Ia mempunyai parameter yang berikut: - laluan: Laluan yang mana kandungan tapak web akan dimuat turun (alias: -p) - webSiteId : ID tapak web portal untuk muat turun (alias:-ID) - tulis ganti : (Pilihan) benar - untuk tulis ganti kandungan sedia ada; palsu - untuk gagal jika folder sudah mempunyai kandungan tapak web (alias:-o)	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
muat naik	Muat turun kandungan tapak web portal kepada persekitaran Dataverse semasa. Ia mempunyai parameter yang berikut: - laluan: Laluan yang mana kandungan tapak web akan disimpan (alias: -p) -deploymentProfile: Muat naik data portal dengan butiran persekitaran yang ditakrifkan melalui pemboleh ubah profil dalam fail profil pelaksanaan/[profil-Name].deployment.yaml	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"

Gunakan profil pelaksanaan

Suis deploymentProfile membolehkan anda mentakrifkan set pemboleh ubah untuk persekitaran dalam format YAML. Contohnya, anda boleh mempunyai profil pelaksanaan yang berbeza (seperti pembangunan, ujian, pengeluaran) yang mempunyai butiran skema yang berbeza yang ditakrifkan dalam profil.

Jika anda mencipta profil ujian, anda boleh mencipta fail di bawah profil pelaksanaan dengan nama "test.deployment.yml" (iaitu, <profileTag>.deployment.yml). Dan anda boleh menjalankan perintah dengan tag (<profileTag>) untuk menggunakan profil ini:

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

Dalam fail ini, anda boleh mempunyai nama jadual (entiti) dengan ID jadual, senarai atribut dan nilai yang anda mahu atasi semasa memuat naik konfigurasi portal menggunakan parameter deploymentProfile.

Selain itu, anda boleh menggunakan pemboleh ubah OS untuk mencapai pemboleh ubah persekitaran sistem pengendalian.

Berikut ialah contoh fail YAML profil "test.deployment.yml" yang mempunyai butiran 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

Nota

Untuk mengetahui tentang semua perintah yang digunakan dalam CLI sebagai tambahan kepada portal, pergi ke Perintah umum dalam Microsoft Power Platform CLI.

Fail yang nyata

Apabila anda memuat turun kandungan laman web menggunakan perintah CLI muat turun paportal pac, bersama dengan muat turun kandungan laman web ini juga akan menjana dua fail yang nyata;

• Fail persekitaran yang nyata (org-url-manifest.yml)
• Padamkan fail penjejakan yang nyata (manifest.yml)

Fail persekitaran yang nyata (org-url-manifest.yml)

Fail persekitaran yang nyata dijana setiap kali apabila perintah muat turun paportal pac berjalan.

Selepas setiap muat turun, alat PAC CLI membaca fail manifes persekitaran sedia ada dan mengemas kini entri yang dipadamkan dalam persekitaran, atau mencipta fail manifes persekitaran jika ia tidak wujud.

Apabila anda menjalankan perintah muat naik paportal pac untuk memuat naik kandungan laman web portal. Ia membaca fail nyata persekitaran dan mengenal pasti perubahan yang dibuat sejak muat turun terakhir dan hanya muat naik kandungan yang dikemas kini. Tindakan ini membantu dalam mengoptimumkan proses muat naik kerana hanya kandungan laman web yang dikemas kini dimuat naik daripada memuat naik semua kandungan pada setiap perintah muat naik.

Fail persekitaran nyata akan dibaca hanya apabila bersambung dengan persekitaran yang sama (URL persekitaran sepadan dengan nama fail) untuk mengelakkan perubahan tidak sengaja.

Padamkan fail penjejakan yang nyata (manifest.yml)

Fail ini digunakan untuk menjejaki rekod yang telah dipadamkan daripada persekitaran.

Apabila kandungan laman web dimuat turun dengan perintah muat turun paportal pac, ini akan menambah rekod yang dipadamkan daripada fail persekitaran nyata (org-url-manifest.yml) untuk fail manifest.yml. Jadi, apabila anda memuat naik kandungan laman web menggunakan perintah muat naik paportal pac, ia akan memadamkan fail daripada persekitaran (walaupun untuk persekitaran yang berbeza). Fail ini tidak dipadamkan, dan ia akan digunakan tanpa mengira persekitaran yang anda sambungkan.

Nota

Dalam usaha untuk memadam rekod kandungan laman dalam satu persekitaran dan juga memadamkan rekod kandungan yang sama dalam persekitaran lain menggunakan CLI PAC, anda perlu menjalankan perintah muat turun paportal pac sebelum dan selepas memadamkan kandungan rekod laman web. manifest.yml akan menjejaki perubahan ini dan mengeluarkan rekod yang berkaitan dalam persekitaran sasaran apabila perintah muat naik paportal pac berjalan.

Gunakan sambungan Visual Studio Code

Anda juga boleh menggunakan sambungan VS Code VS Code Extension Power Platform untuk memanfaatkan bahasa Cecair terbina dalam daripada IntelliSense, bantuan penyelesaian kod, membayangkan, dan berinteraksi dengan CLI menggunakan Terminal Bersepadu VS Code Microsoft Power Platform . Maklumat lanjut: Gunakan sambungan Visual Studio Code (pratonton)

Pertimbangan tambahan

• Ralat telah dilaporkan jika laluan fail anda melebihi had panjang laluan maksimum. Maklumat lanjut: Had panjang laluan maksimum dalam Windows
• Untuk rekod pendua seperti nama halaman web pendua, Microsoft Power Platform CLI mencipta dua folder—yang berbeza dengan nama halaman web dan yang lain dengan nama yang sama awalan dengan kod cincangan. Sebagai contoh, "Halaman-saya" dan "Halaman-saya-kod-cincangan".

Langkah seterusnya

Tutorial: Gunakan Microsoft Power Platform CLI dengan portal

Lihat juga

• Microsoft Power Platform CLI
• Gunakan sambungan Visual Studio Code (pratonton)