Tutorial: Menggunakan komponen kode himpunan data

Dalam tutorial ini, Anda akan membuat komponen sampel menggunakan Power Apps component framework. Power Apps component framework ini memberdayakan pengembang dan pembuat aplikasi profesional untuk membuat komponen kode untuk aplikasi berdasarkan model dan kanvas. Komponen kode ini dapat memberikan pengalaman yang disempurnakan bagi pengguna yang menggunakan data pada formulir, tampilan, dan dasbor. Informasi lebih lanjut: Menggunakan komponen kode di Power Pages

Catatan

  • Tutorial ini didasarkan pada tutorial Power Apps component framework yang ada dan memandu Anda melalui komponen kontrol kisi Power Apps (pratinjau) pada daftar dan subkisi pada halaman kosong. Anda juga dapat menggunakan komponen yang ada, menambahkannya ke halaman web lain untuk tutorial ini. Dalam hal ini, pastikan untuk menggunakan komponen dan halaman web bila mengikuti langkah-langkah dalam tutorial ini. Untuk mempelajari komponen kode yang didukung di portal, lihat Menggunakan komponen kode di portal

Dalam tutorial ini, Anda akan mempelajari cara:

  • Membuat komponen sampel menggunakan Power Apps component framework
  • Mengemas komponen ke lingkungan Microsoft Dataverse
  • Mengonfigurasikan Power Pages untuk menambahkan komponen ke halaman web
  • Kunjungi halaman web Power Pages Anda untuk berinteraksi dengan komponen

Prasyarat

  • Versi portal 9.4.9.xx atau yang lebih tinggi. 
  • Paket portal dasar Dataverse 9.3.2209.x atau yang lebih tinggi. 

Langkah 1 – Membuat komponen pertama Anda

Selesaikan tutorial Buat komponen pertama Anda.

Catatan

Di akhir Buat komponen pertama Anda, Anda akan memiliki komponen bernama TSLinearInputComponent yang dikemas dan diunggah ke lingkungan Dataverse Anda.

Langkah 2 – Menambahkan komponen kode ke tampilan atau subkisi dalam aplikasi berdasarkan model

Untuk menambahkan komponen Anda ke tabel akun, tampilan, dan subkisi, ikuti langkah-langkah di sini Mengonversikan tampilan dan subkisi ke kisi yang dapat diedit (pratinjau) 

Langkah 3 - Tambahkan komponen kode ke daftar dan subkisi di portal

Pada langkah ini, Anda akan membuat daftar baru di aplikasi portal Management, lalu menambahkan komponen ke daftar yang dibuat. Anda juga dapat menggunakan daftar yang ada. 

Langkah 3.1 - Tambahkan komponen kode ke daftar

Berikut adalah kerangka langkah-langkah cara menambahkan kontrol ke komponen daftar.

  1. Buka aplikasi aplikasi Manajemen Portal.

  2. Di panel kiri, dalam Konten, pilih daftar. 

  3. Pilih baru

  4. Masukkan nama. Contohnya,Daftar akun dengan komponen kode

  5. Untuk Nama tabel, pilih tabel yang telah ditambahkan komponen kodenya sebelumnya dalam tutorial ini. 

  6. Pilih situs web portal. 

  7. Tambahkan tampilan dalam kisi pengaturan sebelumnya. 

    Tambahkan tampilan dalam kisi pengaturan lanjutan.

  8. Pilih Gunakan komponen kode yang dikonfigurasi sebagai Ya 

    Menggunakan komponen kode.

Anda kini dapat menambahkan komponen daftar ke halaman. Lihat Menambahkan daftar untuk rincian tentang menambahkan daftar ke halaman web.

Langkah 3.2 - Tambahkan komponen kode ke subkisi

Kontrol juga dapat diaktifkan pada subkisi.

  1. Buka aplikasi aplikasi Manajemen Portal.

  2. Di panel kiri, dalam Konten, pilih Formulir dasar

  3. Pilih formulir dasar yang Anda buat pada langkah sebelumnya. 

  4. Pilih Terkait

  5. Pilih Metadata Formulir Dasar. 

  6. Pilih Metadata Formulir Dasar Baru

  7. Pilih jenis sebagai Subkisi

  8. Pilih Nama Subkisi

    Menambahkan komponen kode ke subkisi.

  9. Untuk Gaya Kontrol, pilih Komponen Kode

    Pilih gaya kontrol.

Formulir harus ditambahkan ke halaman web. Lihat Menambahkan formulir untuk rincian tentang menambahkan komponen formulir ke halaman web.

Tambahkan komponen kode berbasis dataset menggunakan tag liquid

Komponen kode berbasis himpunan data dapat ditambahkan menggunakan tag template liquid codecomponent. Kunci untuk membuat keterangan komponen kode yang harus dimuat diteruskan dalam menggunakan atribut nama. Kuncinya bisa berupa GUID (yang merupakan ID komponen kode), atau nama komponen kode yang diimpor ke Microsoft Dataverse. 

Lihat ikhtisar Liquid untuk perincian penggunaan Liquid dengan Power Pages.

Nilai properti yang diperkirakan komponen kode harus diteruskan sebagai pasangan kunci/nilai yang dipisahkan oleh ":" (tanda titik dua), dengan kunci adalah nama properti dan nilainya adalah nilai string JSON. 

{% codecomponent name: <ID or name> <property1:value> <property2:value> %}

Contohnya, untuk menambahkan komponen kode yang memperkirakan parameter input bernama controlValue dengan tag template Liquid:

{% codecomponent name:abc_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value>%}

Untuk informasi lebih lanjut, lihat tag template Liquid untuk komponen kode.

Pembatasan

Konfigurasi filter tindakan dan metadata pada daftar dan subkisi tidak didukung dengan kontrol kisi Power Apps.

Baca juga

Menggunakan komponen kode di Power Pages