Mulai menggunakan plugin Power Pages untuk GitHub Copilot CLI dan Claude Code

Plugin Power Pages untuk GitHub Copilot CLI dan Claude Code menyediakan alur kerja yang dibantu AI untuk membuat, menyebarkan, dan mengelola situs aplikasi halaman tunggal (SPA) modern di Power Pages. Alih-alih membuat perancah proyek secara manual, menulis kode API boilerplate, dan mengonfigurasi izin, jelaskan apa yang Anda inginkan dalam bahasa alami, dan plugin menangani implementasi.

Plugin mendukung siklus hidup pengembangan situs penuh melalui keterampilan percakapan, dari perancah situs baru hingga menyebarkannya, menyiapkan model data Dataverse, dan mengonfigurasi autentikasi.

Important

  • Agen pengodean AI generatif, seperti GitHub Copilot CLI atau Claude Code, menggunakan keterampilan dan alur kerja plugin ini untuk menyelesaikan tugas khusus Power Pages.
  • Kode dan konfigurasi yang dihasilkan oleh agen pengodean AI dapat tidak akurat. Tinjau, uji, dan validasi semua konten yang dihasilkan sebelum Anda menyetujui atau menyebarkannya. Selalu tinjau proposal agen sebelum menyetujuinya .

Prasyarat

Sebelum memulai, verifikasi bahwa Anda memiliki perangkat lunak dan izin yang diperlukan.

Persyaratan perangkat lunak

Komponen Versi minimum Informasi selengkapnya
Node.js 18.0 atau yang lebih baru Unduh Node.js
Power Platform CLI (PAC CLI) 2.6.3 atau yang lebih baru (diperlukan untuk logika server) Menginstal PAC CLI
Azure CLI Latest Install Azure CLI
GitHub Copilot CLI atau Claude Code Latest GitHub Copilot CLI atau Claude Code
Ekstensi Visual Studio Code dan Power Platform Tools (Opsional) Latest Unduh Visual Studio Code dan Instal Alat Power Platform

Anda juga perlu:

  • Lingkungan Power Platform dengan Power Pages diaktifkan.
  • Sesi PAC CLI terautentikasi yang tersambung ke lingkungan target Anda. Jalankan pac auth create jika Anda belum tersambung.
  • Sesi Azure CLI masuk ke penyewa yang sama. Jalankan az login --allow-no-subscriptions untuk mengautentikasi.

Verifikasi autentikasi:

Verifikasi bahwa Anda diautentikasi dengan menggunakan pac auth list perintah .

pac auth list           # Should show authenticated profile

Jika Anda tidak diautentikasi, jalankan perintah ini:

pac auth create --environment <Instance url>        # Authenticate to Power Platform

Tip

Untuk mendapatkan URL instans, buka beranda Power Pages, pilih ikon Pengaturan di sudut kanan atas, lalu pilih Detail sesi.

Menginstal plugin

Instal plugin Power Pages dari marketplace. Jika Anda menggunakan GitHub Copilot CLI, lihat dokumentasi ekstensi Copilot CLI untuk langkah-langkah penginstalan yang setara. Perintah berikut menggunakan sintaks Kode Claude.

Jalankan alat penginstal untuk menyiapkan semua plugin dengan pembaruan otomatis diaktifkan:

Windows (PowerShell):

iwr https://raw.githubusercontent.com/microsoft/power-platform-skills/main/scripts/install.js -OutFile install.js; node install.js; del install.js

macOS/Linux/Windows (cmd):

curl -fsSL https://raw.githubusercontent.com/microsoft/power-platform-skills/main/scripts/install.js | node

Penginstal secara otomatis:

  • Menginstal CLI pac jika belum diinstal.
  • Mendeteksi alat yang tersedia, seperti Claude Code dan GitHub Copilot CLI.
  • Mendaftarkan marketplace plugin dan menginstal semua plugin yang tercantum.
  • Mengaktifkan pembaruan otomatis sehingga plugin tetap terkini.

Setelah penginstalan, mulai ulang Claude Code atau GitHub Copilot CLI untuk mengakses kemampuan plugin sebagai perintah garis miring di sesi agen Anda.

Menginstal dari marketplace

  1. Buka Kode Claude di terminal Anda.

  2. Tambahkan marketplace Microsoft:

    /plugin marketplace add microsoft/power-platform-skills

  3. Pasang plugin Power Pages tersebut

    /plugin install power-pages@power-platform-skills

Setelah Anda menginstal plugin, mulai ulang Claude Code atau GitHub Copilot CLI untuk mengakses kemampuan plugin sebagai perintah garis miring di sesi agen Anda.

Tip

Untuk menerima pembaruan secara otomatis ke marketplace dan keterampilan, aktifkan pembaruan otomatis. /plugin Gunakan perintah, buka Marketplace, pilih marketplace, dan aktifkan pembaruan otomatis.

Gambaran umum keterampilan

Plugin ini menyediakan keterampilan yang mencakup siklus hidup penuh situs Power Pages. Panggil setiap keterampilan dengan cara percakapan, baik sebagai perintah garis miring atau dengan menjelaskan tindakan yang Anda ingin lakukan.

Skill Command Apa fungsinya
Membuat situs /create-site Merancang kerangka situs, menerapkan arahan desain Anda, dan membangun halaman dan komponen
Meluncurkan situs /deploy-site Membangun proyek dan mengunggahnya ke Power Pages dengan menggunakan PAC CLI
Mengaktifkan situs /activate-site Menyediakan rekaman situs web dan menetapkan URL publik
Menyiapkan model data /setup-datamodel Membuat tabel, kolom, dan hubungan Dataverse
Menambahkan data sampel (opsional) /add-sample-data Mengisi tabel Dataverse dengan rekaman pengujian realistis
Mengintegrasikan API Web /integrate-webapi Menghasilkan kode klien API yang diketik, layanan, dan izin tabel
Menambahkan ringkasan AI /add-ai-webapi Mengintegrasikan API ringkasan AI generatif (ringkasan pencarian dan ringkasan data) ke halaman Anda. Menghasilkan layanan ringkasan yang diketik dengan penanganan token anti-pemalsuan, pembungkus khusus kerangka kerja, situs panggilan berkabel, dan pengaturan situs yang Summarization cocok
Mengonfigurasikan autentikasi /setup-auth Menambahkan kontrol akses masuk, keluar, dan berbasis peran. Mendukung Microsoft Entra ID, Microsoft Entra External ID, OpenID Connect, SAML 2.0, WS-Federation, akun Microsoft, Facebook, Google, dan autentikasi nama pengguna dan kata sandi lokal, termasuk konfigurasi multi-penyedia
Membuat peran web /create-webroles Menghasilkan file YAML peran web untuk manajemen akses pengguna
Menambahkan logika server /add-server-logic Menghasilkan titik akhir JavaScript sisi server yang aman untuk validasi, panggilan API eksternal, manajemen rahasia, dan operasi data
Menambahkan alur cloud /add-cloud-flow Mengintegrasikan alur cloud Power Automate yang ada ke situs Anda untuk alur kerja persetujuan, pemberitahuan, dan otomatisasi terjadwal
Mengintegrasikan backend /integrate-backend Menganalisis prototipe Anda, menentukan pendekatan yang tepat (API Web, Logika Server, atau alur cloud) untuk setiap fitur, dan mengatur urutan build lengkap
Tambahkan SEO /add-seo Menghasilkan robots.txt, sitemap.xml, dan tag meta
Jalankan tinjauan keamanan /security-review Mengatur keterampilan keamanan yang berfokus dan mengonsolidasikan setiap temuan ke dalam satu laporan HTML. Mencakup kode, dependensi, pemindaian situs yang telah diterapkan, header browser, firewall aplikasi web, izin tabel, dan konfigurasi autentikasi
Pindai kode sumber /scan-code Menjalankan analisis statis dan pemindaian dependensi pada file sumber lokal; memunculkan temuan di seluruh pola kode, paket rentan, rahasia yang dikodekan secara permanen, dan masalah lisensi
Memindai situs yang disebarkan /scan-site Memulai pemindaian keamanan sisi server terhadap situs langsung, mengambil laporan terbaru, dan mengelompokkan temuan berdasarkan tingkat keparahan
Mengelola header keamanan browser /manage-headers Memeriksa dan mengonfigurasi header keamanan HTTP yang dikirim situs ke browser - Kebijakan Keamanan Konten, perlindungan bingkai dan pembajakan klik, berbagi lintas asal, perilaku cookie, dan pengaturan situs terkait
Mengelola firewall aplikasi web /manage-firewall Memeriksa dan mengonfigurasi firewall aplikasi web (WAF) di situs produksi: memungkinkan perlindungan, menambahkan atau menghapus blok IP, blok negara, blok jalur, dan batas tarif
Izin akses tabel audit /audit-permissions Mengaudit izin tabel yang ada terhadap kode situs dan metadata Dataverse; menghasilkan laporan HTML yang dikelompokkan menurut tingkat keparahan dengan perbaikan yang disarankan
Rencana Penyebaran /plan-alm Mendeteksi status proyek, mengumpulkan strategi promosi Anda, merender rencana visual, dan mengatur keterampilan manajemen siklus hidup aplikasi (ALM) lainnya dalam urutan yang tepat
Solusi penulis /setup-solution Membuat penerbit dan solusi, menambahkan komponen Power Pages, mengklasifikasikan pengaturan situs, dan mengusulkan variabel lingkungan dan rahasia Azure Key Vault
Menyiapkan host alur /ensure-pipelines-host Menyediakan atau mendeteksi lingkungan host untuk Power Platform Pipelines
Menyiapkan alur /setup-pipeline Mendaftarkan definisi alur di Dataverse dan mengaitkan tahap promosi ke lingkungan target
Menyebarkan melalui alur /deploy-pipeline Memicu penyebaran alur untuk tahap target dengan penimpaan variabel lingkungan per tahapan
Lingkungan tautan paksa /force-link-environment Menetapkan kembali lingkungan target ke host Power Platform Pipelines yang baru saat konflik host memblokir penyebaran
Mengekspor solusi /export-solution Mengekspor solusi sebagai file ZIP terkelola atau tidak terkelola, dengan pemeriksaan kelengkapan sebelum proses ekspor
Mengimpor solusi /import-solution Mengimpor berkas ZIP solusi ke lingkungan target, secara bertahap atau langsung
Situs uji /test-site Memverifikasi situs yang disebarkan dengan pengujian berbasis browser: perayapan halaman, pemeriksaan akses berbasis peran, dan verifikasi API Web
Diagnosa penyebaran /diagnose-deployment Mencocokkan kegagalan penyebaran terhadap katalog kesalahan yang diketahui dan mengusulkan perbaikan

Alur kerja umum

Alur kerja end-to-end umum mengikuti urutan ini:

  1. /create-site : Rangka dasar, desain, dan membangun halaman
  2. /deploy-site : Unggah ke lingkungan Power Pages Anda
  3. /activate-site : Menyiapkan URL publik
  4. /setup-datamodel : Membuat tabel Dataverse
  5. /add-sample-data : Mengisi tabel dengan rekaman pengujian
  6. /integrate-webapi : Hasilkan kode klien API dan konfigurasikan izin
  7. /create-webroles : Tentukan peran akses
  8. /setup-auth : Menambahkan UI masuk, keluar, dan berbasis peran
  9. /add-server-logic : Menambahkan titik akhir sisi server yang aman
  10. /add-cloud-flow : Mengintegrasikan alur Power Automate yang ada
  11. /add-seo : Pengoptimalan mesin pencari
  12. /deploy-site : Menerapkan perubahan terakhir langsung
  13. /security-review : Jalankan tinjauan keamanan end-to-end sebelum masuk ke produksi
  14. /plan-alm : Mempromosikan situs Anda ke lingkungan pengujian dan produksi

Tip

  • Anda tidak perlu mengikuti urutan yang tepat ini. Setiap keterampilan memeriksa prasyaratnya sendiri dan memberi tahu Anda jika ada sesuatu yang hilang. Misalnya, Anda dapat menjalankan /setup-auth sebelum /integrate-webapi jika situs Anda memerlukan autentikasi terlebih dahulu.
  • Jika Anda tidak yakin pendekatan mana yang akan digunakan untuk setiap fitur, jalankan /integrate-backend alih-alih langkah 4 hingga 10 satu per satu. Ini menganalisis prototipe Anda, menentukan apakah setiap fitur membutuhkan API Web, Logika Server, atau aliran cloud, dan mengatur keterampilan dalam urutan yang benar.
  • Untuk menambahkan ringkasan pencarian dan rekaman yang dihasilkan AI, jalankan /add-ai-webapi setelah /integrate-webapi. Ini menggunakan ulang izin tabel dan pengaturan situs yang dikonfigurasi oleh /integrate-webapi, jadi jalankan setelah integrasi Web API Anda sudah siap.

Membangun situs Power Pages Anda

Panduan ini mencakup siklus hidup penuh membangun situs Power Pages dengan plugin, mulai dari pembangunan kerangka awal hingga penyebaran. Setiap langkah menjelaskan apa yang Anda katakan dan apa yang dilakukan plugin sebagai respons.

Langkah 1: Buat situs Anda

Jelaskan situs yang Anda inginkan dalam bahasa alami: untuk apa, halaman apa yang dibutuhkannya, dan preferensi desain apa pun seperti skema warna, gaya tata letak, atau font. Jalankan /create-site atau cukup jelaskan situs Anda dan plugin mengenali niatnya.

Jika Anda tidak menentukan kerangka kerja, plugin meminta Anda untuk memilih satu (React, Vue, Angular, atau Astro), maka:

  1. Membangun kerangka proyek dari sebuah templat dan menerapkan nama situs, warna, dan token desain Anda.
  2. Menginstal dependensi, memulai server pengembangan, dan membuka pratinjau browser langsung.
  3. Membangun setiap halaman, komponen, dan rute yang Anda minta dengan gambar yang relevan.
  4. Membuat commit git pada tonggak penting sehingga Anda memiliki riwayat putar kembali bawaan.

Langkah 2: Sebarkan situs Anda

Jalankan /deploy-site untuk mengunggah situs Anda ke Power Pages. Plugin:

  1. Memverifikasi bahwa PAC CLI diinstal dan sesi autentikasi Anda aktif.
  2. Mengonfirmasi lingkungan target dengan Anda sebelum melanjutkan.
  3. Menjalankan build produksi dan mengunggah output yang dikompilasi.
  4. Membuat direktori artefak penyebaran jika belum ada.

Note

Jika lingkungan Anda memblokir lampiran file tertentu, plugin mendeteksi masalah dan memberikan instruksi untuk mengatasinya.

Langkah 3: Aktifkan situs Anda

Jalankan /activate-site untuk membuat situs dapat diakses secara publik. Plugin:

  1. Menyarankan subdomain berdasarkan nama situs Anda dan memungkinkan Anda mengkustomisasinya.
  2. Menyediakan rekaman situs web melalui API Power Platform.
  3. Melakukan polling hingga situs ditayangkan dan menghasilkan URL publik.

Pada titik ini, Anda memiliki situs kerja di URL publik. Langkah-langkah yang tersisa menambahkan data, autentikasi, dan SEO. Lewati langkah apa pun yang tidak berlaku untuk situs Anda.

Langkah 4: Siapkan model data Anda

Jalankan /setup-datamodel untuk membuat tabel Dataverse yang dibutuhkan situs Anda. Jika Anda sudah memiliki diagram ER atau skema tertentu, berikan secara langsung alih-alih meminta agen menganalisis kode Anda.

Plugin ini menelurkan agen Arsitek Model Data yang:

  1. Menganalisis kode situs Anda untuk menentukan data apa yang diperlukan halaman dan komponen.
  2. Mengkueri lingkungan Dataverse Anda untuk tabel yang sudah ada untuk menghindari duplikat.
  3. Mengusulkan model data dengan tabel, kolom, jenis data, dan hubungan, yang divisualisasikan sebagai diagram ER.

Anda meninjau dan menyetujui proposal. Plugin tidak membuat apa pun sampai Anda mengonfirmasi. Setelah disetujui, plugin membuat tabel dan kolom melalui panggilan API dan menyimpan file manifes yang digunakan Langkah 5 dan 6.

Langkah 5: Tambahkan data sampel (Opsional)

Jalankan /add-sample-data untuk mengisi tabel Anda dengan rekaman pengujian. Langkah ini memerlukan model data dari Langkah 4.

Plugin melakukan tindakan berikut:

  1. Membaca manifest untuk memahami tabel, kolom, dan relasi Anda.
  2. Menghasilkan nilai yang sesuai secara kontekstual untuk setiap jenis kolom, seperti email realistis, tanggal yang masuk akal, dan jumlah mata uang yang diformat.
  3. Menyisipkan rekaman dalam urutan dependensi (tabel induk sebelum tabel anak) dan menyegarkan token autentikasi secara otomatis selama penyisipan massal.

Langkah 6: Integrasikan dengan Dataverse Web API

Jalankan /integrate-webapi untuk mengganti data tiruan dengan kueri Dataverse secara langsung. Langkah ini memerlukan model data dari Langkah 4.

Plugin melakukan tindakan berikut:

  1. Memindai basis kode Anda untuk komponen perangkat lunak yang menggunakan data tiruan, panggilan pengambilan data sementara, atau array yang dikodekan secara tetap. Ini memetakan komponen ini ke tabel Dataverse Anda.
  2. Menelurkan agen Integrasi API Web untuk setiap tabel yang menghasilkan:
    • Klien API terpadu dengan manajemen token anti-pemalsuan dan logika percobaan ulang.
    • Jenis entitas TypeScript dan pemeta domain.
    • Lapisan layanan CRUD.
    • Pola spesifik framework seperti React hooks, Vue composables, atau Angular services.
  3. Menciptakan agen Permissions Architect yang mengusulkan izin pada tabel dan pengaturan situs.

Anda meninjau dan menyetujui proposal perizinan. Plugin tidak membuat file konfigurasi apa pun sampai Anda mengonfirmasi.

Menambahkan ringkasan yang dihasilkan AI (Opsional)

Jalankan /add-ai-webapi untuk menambahkan ringkasan AI generatif di atas integrasi Web API Anda. Fitur ini menghubungkan dua API pratinjau ringkasan ke halaman detail catatan dan daftar Anda:

  • API ringkasan pencarian: Mengembalikan ringkasan hasil pencarian yang dikondensasi AI, dengan kutipan.
  • API ringkasan data: Mengembalikan ringkasan per rekaman atau insight tingkat daftar untuk tabel Dataverse.

Langkah ini dibangun pada model data dari Langkah 4 dan integrasi API Web dari Langkah 6. Plugin melakukan tindakan berikut:

  1. Memindai kode Anda untuk titik integrasi ringkasan dan mengonfirmasi halaman target, tabel, dan API yang akan digunakan.
  2. Mendelegasikan prasyarat API Web yang hilang—izin tabel, daftar kolom, dan peran web—ke /integrate-webapi dan /create-webroles, sehingga ada satu sumber kebenaran untuk izin.
  3. Membuat agen Integrasi API Web AI yang menghasilkan layanan ringkasan bertipe (aiSummaryService.ts) dengan penanganan token anti-pemalsuan, pembungkus khusus framework (hook React, composable Vue, atau layanan Angular), dan situs pemanggilan yang sudah terhubung pada halaman target.
  4. Memunculkan agen Arsitek Pengaturan API Web AI yang membuat pengaturan situs Summarization untuk perintah dan batasan konten.

Anda meninjau dan menyetujui proposal. Plugin tidak menghasilkan kode atau membuat pengaturan hingga Anda mengonfirmasi.

Note

API ringkasan masih dalam pratinjau dan bergantung pada kontrol tingkat administrator dan tingkat situs agar diaktifkan. Jika ringkasan tidak muncul setelah penyebaran, konfirmasikan bahwa fitur diaktifkan melalui pengaturan situs dan kontrol admin yang relevan. Untuk informasi selengkapnya, lihat Gambaran umum API peringkasan data dan Pencarian Power Pages dengan AI generatif.

Langkah 7: Membuat peran web

Jalankan /create-webroles untuk menentukan peran akses pengguna. Plugin:

  1. Memeriksa lingkungan Anda untuk peran web yang sudah ada guna menghindari duplikasi.
  2. Menghasilkan definisi peran dengan pengidentifikasi unik.
  3. Memberlakukan bahwa setiap situs memiliki paling banyak satu peran anonim dan satu peran yang diautentikasi.

Langkah 8: Menyiapkan autentikasi

Jalankan /setup-auth untuk menambahkan kontrol akses masuk, keluar, dan berbasis peran ke situs Anda. Plugin mendukung penyedia identitas berikut, dan Anda dapat mengonfigurasi satu penyedia atau beberapa pada saat yang sama.

Provider Paling cocok untuk
Microsoft Entra External ID (disarankan untuk situs yang menghadap pelanggan) Situs publik dan portal pelanggan dengan pendaftaran layanan mandiri.
Microsoft Entra ID Portal karyawan internal atau situs mitra business-to-business (B2B). Power Pages mengonfigurasi penyewa induk situs secara otomatis, sehingga Anda tidak perlu memasukkan informasi penyewa.
Microsoft, Facebook, Google Masuk dengan akun sosial untuk pengguna konsumen.
Otentikasi lokal. Masuk nama pengguna dan kata sandi. Tidak direkomendasikan dan dikonfigurasi hanya ketika Anda secara eksplisit memintanya.

Untuk informasi selengkapnya tentang penyedia yang didukung, termasuk protokol dan pertimbangan konfigurasi, lihat Gambaran umum autentikasi di Power Pages.

Plugin:

  1. Menganalisis situs Anda (tujuan, halaman, audiens) dan mengusulkan default yang masuk akal. Misalnya, plugin mengusulkan Microsoft Entra External ID dengan pendaftaran terbuka untuk situs yang menghadap pelanggan, atau Microsoft Entra ID dengan pendaftaran khusus undangan untuk portal internal. Anda menerima rekomendasi atau memilih penyedia Anda sendiri.
  2. Untuk setiap penyedia, memandu Anda melalui setiap langkah prasyarat di pusat admin penyedia identitas, seperti membuat tenant, mendaftarkan aplikasi, membuat alur pengguna, dan mencatat ID klien serta URI pengalihan. Plugin memvalidasi setiap nilai yang Anda tempelkan kembali ke dalam percakapan, dan menghitung URI pengalihan yang tepat untuk situs Anda sehingga nilai yang ditempelkan ke pendaftaran aplikasi cocok dengan nilai yang ditulis ke pengaturan situs.
  3. Menanyakan bagaimana data profil pengguna harus dialirkan dari penyedia identitas ke rekaman kontak Dataverse (pemetaan klaim), apakah akan disinkronkan pada setiap login atau hanya saat login pertama, dan apakah login eksternal akan ditautkan secara otomatis ke kontak yang sudah ada berdasarkan email.
  4. Menghasilkan layanan autentikasi, deklarasi jenis, utilitas otorisasi berbasis peran (hasRole, RequireAuth, RequireRole), hook penjaga sesi tetap aktif yang mencegah sesi SPA kedaluwarsa secara diam-diam, dan komponen UI masuk dan keluar yang terintegrasi dengan tata letak situs Anda. Plugin ini menggunakan pola-pola framework Anda secara konsisten, seperti hook React, composable Vue, layanan Angular, atau komponen Astro.
  5. Ketika lebih dari satu penyedia dikonfigurasi, sistem akan menghasilkan halaman /login yang dirender dalam tata letak pilihan Anda: baris horizontal, tumpukan vertikal, sorotan utama, atau dengan tab.
  6. Menulis pengaturan situs yang cocok di bawah .powerpages-site/site-settings/ untuk setiap penyedia, mode pendaftaran, pemetaan klaim, dan fitur opsional.

Plugin juga mengonfigurasi fitur opsional berikut saat Anda mengaktifkannya:

  • Syarat dan ketentuan: Halaman SPA /terms yang harus disetujui pengguna sebelum menyelesaikan proses masuk, serta pengaturan situs dan cuplikan konten yang sesuai.
  • halaman profil Pengguna: Halaman /user-profile SPA tempat pengguna yang masuk mengedit informasi kontak mereka melalui POWER PAGES Web API.
  • Keluar terfederasi: Juga mengeluarkan pengguna dari penyedia identitas saat mereka keluar dari situs, untuk skenario perangkat bersama atau skenario yang diatur.

Tip

Untuk menambahkan penyedia identitas kedua ke situs yang ada, jalankan /setup-auth lagi. Plugin mendeteksi konfigurasi yang sudah ada dan menawarkan penambahan penyedia baru tanpa menimpa penyedia yang sudah ada. Pendekatan ini berguna untuk skenario bertahap, seperti memulai dengan Microsoft Entra External ID dan kemudian menambahkan Google untuk login sosial.

Note

Otorisasi sisi klien (RequireAuth, RequireRole, hasRole) hanya untuk pengalaman pengguna. Ini mengontrol apa yang dilihat pengguna. Izin akses tabel di sisi server yang dikonfigurasi oleh /integrate-webapi benar-benar menegakkan keamanan.

Langkah 9: Menambahkan logika server

Jalankan /add-server-logic untuk menambahkan titik akhir sisi server yang aman ke situs Anda. Gunakan Logika Server saat situs Anda memerlukan logika yang tidak dapat berjalan di browser, seperti panggilan API eksternal, validasi sisi server, manajemen rahasia, atau operasi data lintas entitas.

Important

Dukungan logika server memerlukan PAC CLI versi 2.6.3 atau yang lebih baru. Gunakan skrip penginstalan cepat untuk memperbarui ke versi terbaru.

Jelaskan apa yang Anda butuhkan dalam bahasa biasa, dan plugin:

  1. Menelurkan agen Arsitek Logika Server yang menganalisis kasus penggunaan Anda dan mengklasifikasikan kompleksitasnya.
  2. Mengusulkan desain titik akhir, konfigurasi keamanan, dan izin tabel yang diperlukan untuk tinjauan Anda.
  3. Setelah Anda menyetujui, menghasilkan titik akhir JavaScript sisi server di /_api/serverlogics/<name>.
  4. Membuat layanan sisi klien yang diketik untuk memanggil titik akhir dari komponen Anda.
  5. Memperbarui komponen Anda untuk memanggil layanan baru.
  6. Mengonfigurasi penetapan peran web dan izin tabel untuk titik akhir.

Anda meninjau dan menyetujui proposal. Tidak ada kode yang dihasilkan sampai Anda mengonfirmasi.

Kasus penggunaan umum:

Note

Jalankan /add-server-logic sekali per kasus penggunaan. Misalnya, jika situs Anda memerlukan titik akhir validasi inventaris dan titik akhir pencarian global, jalankan keterampilan dua kali.

Langkah 10: Mengintegrasikan alur cloud

Jalankan /add-cloud-flow untuk mengintegrasikan alur cloud Power Automate yang ada ke situs Anda. Keterampilan ini menghubungkan situs Power Pages Anda ke alur yang sudah Anda buat di Power Automate. Ini tidak membuat alur cloud baru.

Plugin:

  1. Mendaftarkan alur cloud yang sudah ada dengan situs Anda.
  2. Menghasilkan kode sisi klien untuk memicu alur dari halaman Anda.
  3. Menangani status alur kerja asinkron dan pola panggilan balik.
  4. Menghubungkan pertukaran data antara halaman dan alur.

Gunakan /add-cloud-flow untuk alur kerja persetujuan, pemberitahuan email, pekerjaan terjadwal, dan otomatisasi berbasis peristiwa yang lebih baik ditangani oleh Power Automate daripada oleh titik akhir sisi server.

Alternatif: Gunakan /integrate-backend untuk merencanakan lapisan layanan lengkap

Jika Anda tidak yakin fitur mana yang memerlukan Api Web, Logika Server, atau alur cloud, jalankan /integrate-backend alih-alih menjalankan langkah 4 hingga 10 secara manual. Kemampuan ini bertindak sebagai orkestrator yang:

  1. Menganalisis prototipe Anda untuk mengidentifikasi semua fitur yang memerlukan lapisan layanan.
  2. Mengklasifikasikan setiap fitur ke dalam pendekatan yang tepat: API Web untuk CRUD standar, Logika Server untuk validasi sisi server dan API eksternal, atau alur cloud untuk alur kerja persetujuan dan otomatisasi.
  3. Mengusulkan rencana eksekusi berurutan dengan semua keterampilan, dependensi, dan konfigurasi.
  4. Setelah Anda menyetujui, atur keterampilan dalam urutan yang benar.

Rencana ini tetap, dapat dilanjutkan, dan dapat diedit. Hentikan setelah setiap langkah untuk meninjau kode yang dihasilkan atau menguji situs, dan lanjutkan dari tempat terakhir Anda dengan menjalankan /integrate-backend lagi.

Langkah 11: Tambahkan SEO

Jalankan /add-seo untuk mengoptimalkan situs Anda untuk mesin pencari. Plugin:

  1. Menemukan rute dari konfigurasi router kerangka kerja Anda.
  2. Menghasilkan arahan mesin pencari dan peta situs untuk semua rute yang ditemukan.
  3. Menambahkan tag meta: viewport, pengkodean karakter, deskripsi, Open Graph, Twitter Card, dan referensi ikon.

Langkah 12: Sebarkan situs akhir

Jika Anda melakukan langkah-langkah opsional, jalankan /deploy-site lagi untuk mendorong perubahan secara langsung. Plugin ini menjalankan build produksi dan mengunggah situs beserta semua artefak penyebaran (izin tabel, pengaturan situs, peran web, file logika server) ke lingkungan Power Pages Anda.

Langkah 13: Jalankan tinjauan keamanan

Jalankan /security-review untuk melakukan peninjauan keamanan menyeluruh pada situs Anda sebelum diluncurkan ke produksi. Keterampilan ini mengatur keterampilan keamanan yang berfokus dan mengonsolidasikan setiap temuan ke dalam satu laporan HTML di docs/security-review-<timestamp>.html.

Plugin mengajukan satu pertanyaan dengan bahasa yang mudah dipahami tentang tujuan Anda dan memilih sekumpulan keterampilan terfokus yang paling sesuai:

Maksud Apa yang diperiksa
Kode dan konfigurasi Kode sumber, dependensi, izin tabel, dan konfigurasi autentikasi. Hanya berfungsi pada file lokal - tidak diperlukan penyebaran.
Kesiapan rilis (disarankan) Tinjauan penuh sebelum menerbitkan. Menjalankan setiap keterampilan yang berfokus: kode dan dependensi, pemindaian situs yang disebarkan, header keamanan browser, firewall aplikasi web, izin tabel, dan autentikasi.
Situs yang dipublikasikan Hanya memindai situs live yang telah disebarkan. Berguna untuk pemantauan berkelanjutan dari situs yang diterbitkan.

Setelah Anda mengonfirmasi, plugin menjalankan keterampilan yang berfokus pada pencocokan secara paralel dan menulis temuan mereka ke satu laporan:

  • /scan-code: Menjalankan analisis statis (opengrep) dan pemindaian dependensi (trivy) pada file sumber lokal. Menampilkan pola kode, paket yang rentan, rahasia yang dikodekan secara permanen, dan masalah lisensi. Jika salah satu dari kedua alat tersebut tidak terinstal, fitur ini menyediakan tinjauan kode manual sebagai alternatif.
  • /scan-site: Memulai pemindaian keamanan sisi server terhadap situs langsung dan mengambil laporan terbaru. Durasi pemindaian tergantung pada ukuran situs - situs kecil selesai dalam hitungan menit, situs besar dapat memakan waktu berjam-jam. Temuan dikelompokkan menurut tingkat keparahan. Memerlukan situs yang sudah disebarkan.
  • /manage-headers: Memeriksa header keamanan HTTP yang dikonfigurasi di bawah .powerpages-site/site-settings/: Kebijakan Keamanan Konten, X-Frame-Options, CORS, cookie SameSite, dan pengaturan terkait. Mengidentifikasi nilai yang hilang atau lemah dan mengusulkan default yang direkomendasikan.
  • /manage-firewall: Memeriksa firewall aplikasi web (WAF) untuk situs produksi, termasuk status aturan terkelola dan aturan kustom (blok IP, blok negara, blok jalur, batas tarif). Hanya tersedia di situs produksi di wilayah yang didukung; fitur ini mendeteksi dan melaporkan masalah terkait kelayakan.
  • /audit-permissions: Mengaudit izin tabel yang ada berdasarkan kode situs dan metadata Dataverse. Menampilkan izin yang hilang, peran yang terlalu permisif, izin yang tidak digunakan, dan masalah skema YAML.

Laporan terkonsolidasi mengelompokkan temuan menurut bagian, terbuka di browser default Anda, dan menyertakan panduan remediasi bahasa biasa. Melalui chat, plugin kemudian menawarkan untuk memandu proses perbaikan - pilih temuan, dan plugin akan menjalankan skill terfokus yang sesuai secara interaktif untuk menerapkan perubahan tersebut.

Note

Tinjauan keamanan tidak pernah menerapkan perubahan secara otomatis. Setiap keterampilan yang difokuskan berjalan dalam mode tinjauan baca-saja selama eksekusi terkonsolidasi. Untuk menerapkan perbaikan, plugin memanggil skill yang sesuai secara interaktif setelah Anda memilih tindakan.

Tip

Anda juga dapat menjalankan skill tertentu secara terpisah:

  • Jalankan /scan-code selama pengembangan untuk menangkap masalah tingkat kode lebih awal.
  • Jalankan /manage-headers untuk memperbaiki kesalahan Kebijakan Keamanan Konten tertentu atau menyiapkan CORS.
  • Jalankan /manage-firewall untuk menambahkan batas tarif pada halaman masuk atau memblokir lalu lintas menurut negara.
  • Jalankan /audit-permissions setelah mengubah izin tabel untuk memverifikasi bahwa mereka masih cocok dengan kode situs.
  • Jalankan kembali /security-review dengan tujuan Situs yang Disebarkan untuk memantau situs produksi dari waktu ke waktu.

Memverifikasi situs Anda

Setelah Anda menyelesaikan keterampilan, verifikasi situs Power Pages Anda berfungsi dengan benar.

  1. Buka Power Pages.
  2. Temukan situs Anda di daftar Situs aktif .
  3. Pratinjau situs Anda di desktop dengan menggunakan opsi Pratinjau .
  4. Uji fungsionalitas.

Mempromosikan situs Anda di seluruh lingkungan

Setelah situs Anda berfungsi di lingkungan pengembangan Anda, gunakan keterampilan manajemen siklus hidup aplikasi (ALM) untuk mempromosikannya ke lingkungan pengujian dan produksi. Plugin mengemas situs Anda sebagai solusi Power Platform, mengidentifikasi nilai yang bervariasi di seluruh lingkungan, dan menyebarkan solusi melalui Alur Power Platform atau melalui ekspor dan impor manual.

Untuk menggunakan keterampilan ALM, Anda juga memerlukan setidaknya satu lingkungan Power Platform target (pengujian, produksi, atau keduanya). Untuk menggunakan alur Azure Key Vault opsional untuk rahasia, Anda juga memerlukan izin untuk membuat brankas kunci di langganan Azure Anda.

Merencanakan penyebaran

Jalankan /plan-alm untuk memulai. /plan-alm adalah titik masuk untuk ALM dan mengatur keterampilan ALM lainnya, jadi Anda biasanya tidak menjalankannya secara langsung. Plugin:

  1. Mendeteksi status proyek, solusi, dan lingkungan target Anda saat ini.
  2. Menanyakan tentang strategi promosi Anda (Alur Power Platform atau ekspor dan impor manual), tahap target, dan batasan apa pun yang akan diterapkan.
  3. Menghasilkan rencana visual di docs/alm-plan.html yang menunjukkan setiap tindakan yang akan dilakukan.
  4. Menunggu persetujuan Anda sebelum menjalankan keterampilan hilir apa pun.

Rencana disimpan ke disk, sehingga setiap skill downstream membaca dari dan menulis ke rencana tersimpan yang sama. Jika fase gagal, jalankan /plan-alm lagi dan dilanjutkan dari tempat fase berhenti.

Menulis solusi

Jalankan /setup-solution untuk mengemas situs Anda sebagai solusi Power Platform. Plugin:

  1. Membuat penerbit dan solusi, lalu menambahkan komponen Power Pages Anda: situs, peran web, titik akhir logika server, pendaftaran alur cloud, dan pengaturan penyedia OAuth.
  2. Mengklasifikasikan setiap pengaturan situs berdasarkan sensitivitas dan mengusulkan variabel lingkungan untuk nilai yang bervariasi di seluruh lingkungan.
  3. Menawarkan untuk menyediakan Azure Key Vault dan menyimpan nilai jenis kredensial, seperti string koneksi dan kunci API, di dalam Azure Key Vault tersebut.
  4. Berjalan dalam mode sinkronisasi ketika solusi sudah ada untuk situs Anda, untuk mendamaikan komponen tanpa membuat solusi baru.

Anda meninjau dan menyetujui proposal. Plugin tidak membuat konfigurasi apa pun sampai Anda mengonfirmasi.

Tip

Jika solusi Anda terlalu besar atau terjerat untuk disebarkan dengan andal, plugin merekomendasikan pemisahan dan mengusulkan tempat untuk membaginya. Konfirmasikan pemisahan sebelum perubahan berlaku.

Menyebarkan dengan Alur Power Platform

Jika Anda memilih Power Platform Pipelines sebagai strategi promosi Anda, plugin menjalankan kemampuan berikut:

  1. /ensure-pipelines-host menyediakan atau mendeteksi lingkungan host untuk Power Platform Pipelines. Skill ini memilih opsi berbiaya paling rendah yang tersedia untuk tenant Anda: host platform gratis, aplikasi Pipelines di lingkungan yang sudah ada, atau host kustom.
  2. /setup-pipeline mendaftarkan definisi alur di Dataverse, mengonfigurasi tahap yang Anda pilih, dan mengikat setiap tahap ke lingkungan target.
  3. /deploy-pipeline memicu penyebaran untuk satu tahap, menerapkan penggantian variabel lingkungan per tahap melalui deploymentSettings.json, dan melacak status dalam ledger penyebaran.

Jika penyebaran gagal karena lingkungan target sudah ditautkan ke host Power Platform Pipelines yang berbeda, plugin dapat menjalankan /force-link-environment untuk menetapkannya ulang. Tindakan ini memerlukan persetujuan eksplisit Anda dan dapat dibalik.

Menyebarkan dengan ekspor dan impor manual

Jika Anda memilih jalur manual, plugin akan berjalan:

  1. /export-solution untuk mengekspor solusi sebagai ZIP terkelola atau tidak dikelola, dengan pemeriksaan kelengkapan sebelum ekspor.
  2. /import-solution untuk mengimpor ZIP ke lingkungan target, baik dengan memverifikasi dependensi terlebih dahulu maupun secara langsung.

Mengaktifkan dan memvalidasi situs yang disebarkan

Setelah berhasil diterapkan di lingkungan target, plugin:

  1. Menjalankan /activate-site untuk menyiapkan URL publik di lingkungan target.
  2. Menjalankan /test-site untuk memverifikasi penyebaran. Plugin tersebut menggunakan browser untuk merayapi halaman-halaman representatif, menjalankan pemeriksaan akses berbasis peran, memverifikasi panggilan /_api/, dan mengambil bentuk respons dari endpoint /_api/serverlogics/. Keterampilan melaporkan hasilnya sebagai PASS, WARNINGS, atau FAIL, dengan detail setiap pemeriksaan yang ditautkan dari rencana.

Jika langkah gagal, plugin akan berjalan /diagnose-deployment. Keterampilan ini mencocokkan kegagalan dengan katalog galat penerapan yang telah diketahui, seperti manifes usang, dependensi yang hilang, konflik host, JavaScript yang diblokir, atau autentikasi yang kedaluwarsa, lalu mengusulkan perbaikan yang konkret. Plugin tidak pernah menerapkan perbaikan tanpa persetujuan Anda.

Note

Setiap keterampilan ALM membaca dari dan menulis ke artefak pada disk: manifes solusi, data rencana, ledger alur, ledger penyebaran, dan hasil pengujian. Orkestrasi dapat diulang dan dapat diaudit. Untuk melihat apa yang terjadi pada langkah apa pun, periksa artefak.

Tips dan praktik terbaik

Tips berikut membantu Anda mendapatkan hasil maksimal dari plugin dan agen pengkodian AI saat membangun situs Power Pages.

Periksa output terminal dari alat yang hilang pada saat pertama kali dijalankan

Plugin menyediakan kemampuan dan alur kerja, tetapi agen pengodean AI - GitHub Copilot CLI atau Claude Code - mengeksekusi perintah sebenarnya pada komputer Anda. Saat Anda menggunakan alat-alat ini untuk pertama kalinya, perhatikan output terminal dengan cermat. Agen pengodian AI menjalankan perintah dan skrip di belakang layar, dan beberapa perintah ini bergantung pada alat yang mungkin tidak diinstal pada komputer Anda. Jika langkah gagal, output terminal biasanya menunjukkan alat atau perintah mana yang tidak dapat ditemukannya.

Jika Anda melihat kesalahan seperti command not found atau is not recognized, instal alat yang hilang dan picu ulang alur kerja. Agen pengodean AI melanjutkan dari tempat terakhir setelah alat tersedia.

Meninjau proposal agen sebelum menyetujui

Agen coding AI menyajikan proposal, seperti proposal dari Arsitek Model Data dan Arsitek Izin, sebelum melakukan perubahan. Kode dan konfigurasi yang dihasilkan oleh agen pengodean AI dapat tidak akurat, jadi tinjau, uji, dan validasi setiap proposal dan semua kode yang dihasilkan sebelum Anda menyetujui atau menyebarkannya.

  • Proposal model data: Periksa apakah nama tabel, jenis kolom, dan hubungan cocok dengan kebutuhan bisnis Anda. Lebih mudah untuk menyesuaikan proposal daripada mengganti nama kolom setelah data sudah disisipkan.
  • Proposal izin: Verifikasi bahwa setiap peran memiliki tingkat akses yang benar (membuat, membaca, memperbarui, menghapus) untuk setiap tabel. Izin tabel yang terlalu permisif adalah risiko keamanan umum.
  • Kode yang dihasilkan: Baca kode yang dihasilkan dan uji situs secara lokal sebelum Anda menyebarkan. Kode yang dihasilkan AI dapat berisi kesalahan atau masalah keamanan.

Tempelkan kesalahan langsung dengan konteks

Ketika terjadi kegagalan, apakah itu kesalahan pada build, kegagalan penyebaran, atau pengecualian runtime di browser, salinlah output kesalahan penuh. Tempelkan bersama dengan deskripsi singkat tentang apa yang Anda lakukan. Semakin banyak konteks yang Anda berikan, semakin cepat perbaikannya.

Contoh: Kesalahan build

I ran npm run build and got this error. Fix it.

error TS2339: Property 'jobTitle' does not exist on type 'JobPosting'.

  src/components/JobCard.tsx:24:31
    24   <Text>{posting.jobTitle}</Text>

Tip

Sertakan nama file, perintah yang Anda jalankan, dan apa yang Anda harapkan terjadi. Plugin menggunakan konteks ini untuk menemukan masalah dan menerapkan perbaikan yang ditargetkan daripada menebak.

Bagikan kesalahan API Web dengan URL permintaan lengkap

Masalah umum setelah penyebaran adalah kesalahan 403 dari API Web Power Pages ketika kolom belum diaktifkan untuk akses API. Saat Anda mengalami kesalahan ini, tempelkan URL API lengkap dan respons kesalahan JSON lengkap. Pesan kesalahan memberi tahu Anda tabel dan kolom mana yang perlu diperbaiki, dan plugin dapat memperbarui izin tabel YAML dan pengaturan situs untuk Anda.

Contoh: Kolom tidak diaktifkan untuk API Web (403)

I'm getting a 403 error when the documents page loads. Here's the API call and the response. Fix the issue so this API works.

URL:
https://my-site.powerappsportals.com/_api/crd50_documents?$select=crd50_documentid,crd50_name,crd50_documentcategory,crd50_filetype,crd50_filesize,crd50_updateddate,crd50_description,_crd50_propertyid_value

Response:
{
  "error": {
    "code": "90040101",
    "message": "Attribute _crd50_propertyid_value in table crd50_document is not enabled for Web Api.",
    "innererror": {
      "code": "90040101",
      "message": "Attribute _crd50_propertyid_value in table crd50_document is not enabled for Web Api.",
      "type": "AttributePermissionIsMissing"
    }
  }
}

Kesalahan ini (AttributePermissionIsMissing) berarti kolom _crd50_propertyid_value pencarian ada di tabel Dataverse tetapi tidak tercantum dalam konfigurasi izin tabel untuk API Web. Plugin mengatasi kesalahan ini dengan cara menambahkan kolom yang hilang ke YAML izin tabel di .powerpages-site/table-permissions/ dan menerapkan ulang.

Note

Power Pages Web API mengharuskan setiap kolom yang dikembalikan oleh panggilan API untuk secara eksplisit tercantum dalam izin tabel. Properti pencarian (diawali dengan _ dan diakhiri dengan _value) mudah dilewatkan karena nama API mereka berbeda dari nama logis kolom di Dataverse. Saat Anda melihat AttributePermissionIsMissing, selalu pastikan untuk menambahkan kolom tersebut ke izin tabel. Jangan ubah kueri API.

Jadilah spesifik tentang apa yang Anda inginkan

Permintaan yang samar-samar menghasilkan hasil yang tidak jelas. Beri tahu plugin apa yang Anda butuhkan, termasuk preferensi tata letak, bidang data, dan perilaku.

Daripada Coba
Buat halaman untuk lowongan pekerjaan "Buat halaman daftar pekerjaan dengan bilah pencarian di bagian atas, chip filter untuk lokasi dan departemen, dan kisi kartu yang menunjukkan judul, perusahaan, rentang gaji, dan tanggal yang diposting untuk setiap pekerjaan"
"Perbaiki gaya" Tumpukan kartu pekerjaan berada secara vertikal di desktop. Buat tampilannya dalam kisi tiga kolom dengan celah 16px pada layar yang lebih lebar dari 768px"
"Tambahkan beberapa data" "Tambahkan 20 sampel posting pekerjaan di empat departemen (Teknik, Pemasaran, Penjualan, SDM) dengan judul realistis, rentang gaji antara $ 60k - $ 180k, dan tanggal yang diposting dalam 30 hari terakhir"
"Siapkan API" "Sambungkan komponen JobListings ke tabel cr_jobposting Dataverse. Ganti array hardcoded dengan panggilan API nyata yang mengambil data nama jabatan, departemen, gaji, dan tanggal posting"
"Tambahkan login" "Siapkan Microsoft Entra External ID masuk dengan pendaftaran terbuka, ditambah Google sebagai penyedia kedua. Perlihatkan sebagai baris horizontal di halaman masuk."

Menggunakan cuplikan layar untuk masalah visual

Ketika situs tidak terlihat tepat di browser, ambil cuplikan layar dan tempelkan langsung ke percakapan atau berikan jalur file. Konteks visual membantu mengidentifikasi masalah tata letak, penspasian, dan gaya yang sulit dijelaskan dalam teks.

The header overlaps the hero section on mobile. Here's a screenshot:

[paste screenshot or provide path to screenshot file]

Fix the header so it doesn't overlap. It should be a fixed header with the content starting below it.

Iterasi dalam langkah-langkah kecil

Alih-alih menjelaskan seluruh situs dalam satu perintah, bangun secara bertahap. Mulailah dengan struktur dan tata letak, lalu tambahkan fitur satu per satu. Pendekatan ini memberi Anda kesempatan untuk meninjau dan membenahi kursus di setiap langkah.

Step 1: /create-site → Get the basic scaffold and layout right
Step 2: "Add a hero section to the home page with a search bar"
Step 3: "Add a job listings page with filter and sort"
Step 4: "Add a job detail page that shows full description"
Step 5: /setup-datamodel → Create tables now that you know the data shape
Step 6: /integrate-webapi → Wire up real data

Tip

Setelah setiap langkah, periksa pratinjau browser. Jika ada yang tidak beres, perbaiki sebelum melanjutkan. Lebih mudah untuk memperbaiki masalah dalam satu komponen daripada mengurai masalah di seluruh situs.

Minta penjelasan sebelum menyetujui

Ketika Anda tidak yakin tentang perubahan yang diusulkan, terutama untuk izin, modifikasi model data, atau konfigurasi autentikasi, minta plugin untuk menjelaskan apa yang akan dilakukannya dan mengapa sebelum menyetujui.

Before you create the table permissions, explain what access each role will have and why. I want to understand the security implications.

Menjalankan keterampilan secara independen untuk pulih dari masalah

Jika suatu keterampilan gagal di tengah jalan, Anda tidak perlu memulai kembali. Setiap kemampuan berjalan secara independen dan dapat melanjutkan dari titik terakhirnya. Misalnya, jika /integrate-webapi gagal pada tabel ketiga, Anda dapat menjalankannya kembali dan mendeteksi pekerjaan yang sudah selesai.

/integrate-webapi failed while processing the cr_applications table. Here's the error: [paste error]. Resume the integration from where it stopped.

Konten terkait

  • Last updated on