Menggunakan plug-in low-code di( Dataverse pratinjau)

[Topik ini adalah dokumentasi prarilis dan dapat berubah.]

Microsoft Dataverse menawarkan solusi canggih untuk mencapai arsitektur data yang lebih efisien dan mengurangi beban kerja sisi klien melalui plug-in low-code. Plug-in ini adalah alur kerja real-time yang dapat digunakan kembali yang menjalankan serangkaian perintah tertentu di dalamnya Dataverse, berjalan di sisi server dan dipicu oleh penanganan peristiwa yang dipersonalisasi.

Secara tradisional, plug-in dibuat sebagai kelas kustom yang dikompilasi ke dalam rakitan .NET Framework, yang kemudian diunggah dan didaftarkan di dalamnya Dataverse. Namun, dengan diperkenalkannya plug-in low-code, pengguna dapat membuat penanganan peristiwa ini dengan minimal atau tanpa pengkodean yang diperlukan, dan tanpa perlu pendaftaran manual.

Plug-in low-code disimpan dalam Dataverse database dan dapat diintegrasikan dengan mulus ke dalam Power Apps dan Power Automate. Perilaku alur kerja ditentukan menggunakan Power Fx bahasa ekspresi dan dapat langsung terhubung dengan Dataverse data bisnis dan sumber data eksternal melalui Power Platform konektor. Dengan plug-in low-code, pembuat dapat dengan cepat membangun alur kerja yang kompleks dengan keahlian pengkodean minimal, menghasilkan arsitektur data yang lebih efisien dan efisien.

Manfaat logika sisi server

Mendefinisikan logika bisnis sisi server menawarkan beberapa manfaat, termasuk:

• Peningkatan keamanan. Karena logika sisi server dijalankan di server, ini dapat membantu mencegah akses tidak sah ke data atau proses sensitif.
• Peningkatan kinerja. Dengan mengeksekusi di server, logika bisnis dapat mengurangi jumlah data yang perlu ditransfer antara klien dan server, sehingga menghasilkan waktu pemrosesan yang lebih cepat.
• Konsistensi dan keandalan. Logika sisi server memastikan bahwa aturan bisnis diterapkan secara konsisten di semua klien, mengurangi risiko kesalahan atau inkonsistensi.
• Perawatan dan peningkatan yang lebih mudah. Dengan memusatkan logika bisnis di server, menjadi lebih mudah untuk memelihara dan memperbarui, karena perubahan dapat dilakukan di satu tempat daripada harus memperbarui beberapa klien.
• Skalabilitas. Logika sisi server dapat diskalakan lebih mudah daripada logika sisi klien, memungkinkan performa yang lebih baik dan penanganan beban kerja yang lebih besar.

Plug-in kode rendah

Ada dua jenis plug-in low-code yang didukung di: Dataverse

Semua plug-in low-code memiliki properti umum berikut:

Izin plug-in

Prasyarat untuk membuat plug-in low-code

Memperbarui Dataverse akselerator

1. Ikuti petunjuk untuk melihat aplikasi berlisensi di lingkungan Anda.
2. Jika Dataverse Akselerator sudah diinstal dan pembaruan tersedia, itu ditunjukkan dalam tabel di samping item.
3. Pilih Dataverse Akselerator, lalu pilih Perbarui pada bilah perintah.

Membuat plug-in low-code instan

1. Putar Dataverse aplikasi akselerator.
2. Pilih kartu Buat plug-in instan.
3. Berikan Nama tampilan.
4. Secara opsional, tentukan parameter:
   • Pilih Parameter input baru atau Parameter output baru, lalu masukkan label dan tipe data.
   • Tambahkan lebih banyak parameter input dan output sesuai kebutuhan.
5. Masukkan Power Fx ekspresi di editor Ekspresi .
   • Referensi parameter input dalam rumus dengan nama label.
   • Parameter keluaran harus direferensikan di dalam tanda kurung keriting, seperti { Out: "Return value" }.
   • Tabel referensi Dataverse menggunakan fungsi pengumpulan data, seperti Filter() dan LookUp().
   • Jika cakupan diatur ke entitas, gunakan ThisRecord untuk mengakses nilai kolom di baris tabel yang terkait dengan eksekusi plug-in, seperti ThisRecord.'Account Name'.

   Tip

   Perhatikan intellisense di kotak Ekspresi . Merah yang digarisbawahi tidak valid. Kuning berlekuk-lekuk berarti logika Anda mungkin terpengaruh oleh batasan delegasi. Hindari masalah delegasi dengan menggunakan fungsi yang dapat didelegasikan.

6. Secara opsional, perluas Opsi tingkat lanjut untuk memodifikasi solusi, cakupan, atau deskripsi.
7. Pilih Simpan.
8. Uji plug-in low-code instan Anda.

Contoh: Hitung jumlah dua bilangan bulat.

• Buat dua parameter input, X dan ( Y keduanya jenis bilangan bulat), dan satu parameter output, Z (jenis string).
• Gunakan rumus berikut: {Z: X + Y }

Membuat plug-in low-code otomatis

1. Putar Dataverse aplikasi akselerator.
2. Pilih kartu Buat plug-in otomatis.
3. Berikan nilai-nilai berikut:
   • Nama: Masukkan nama untuk plug-in, seperti Validasi input.
   • Tabel: Pilih tabel untuk mengaitkan plug-in, seperti Akun.
   • Jalankan aturan plug-in ini saat baris berada. Tentukan peristiwa data yang memanggil plug-in.
4. Masukkan Power Fx ekspresi di editor Ekspresi .
   • Tabel referensi Dataverse menggunakan fungsi pengumpulan data, seperti Filter() dan LookUp().
   • Gunakan ThisRecord untuk mengakses nilai kolom di baris tabel yang terkait dengan eksekusi plug-in, seperti ThisRecord.'Account Name'.
5. Secara opsional, perluas Opsi lanjutan untuk memodifikasi tahapan (saat ini harus dijalankan) dan solusi tempat plug-in disimpan.
6. Pilih Simpan.
7. Uji plug-in low-code otomatis Anda.

Menggunakan Power Platform konektor di plug-in low-code

Power Platform konektor dapat digunakan dalam plug-in low-code untuk dengan mudah mengintegrasikan data dan fungsionalitas dari sistem di luar Dataverse, seperti SQL Server, Salesforce, dan SharePoint, tanpa perlu pengkodean yang rumit atau pengembangan khusus.

Prasyarat untuk menggunakan konektor dalam plug-in low-code

Menggunakan tindakan konektor di plug-in low-code

Anda dapat dengan mudah menggunakan konektor dan konektor kustom dari dalam formula plug-in Power Fx kode rendah.

1. Buat koneksi ke konektor yang ingin Anda gunakan.
2. Tambahkan referensi koneksi ke koneksi di Dataverse lingkungan.
3. Di editor ekspresi plug-in Power Fx kode rendah, ketik nama referensi koneksi (nama internal dengan awalan dan garis bawah, seperti new_connectorName, bukan nama tampilan).
4. Intellisense menunjukkan tindakan yang tersedia. Pilih tindakan yang Anda inginkan, lalu masukkan parameter yang diperlukan.

Sebelum menggunakan konektor di plug-in low-code, tinjau dokumentasi konektor untuk memastikan bahwa Anda meneruskan parameter input dan output dengan benar.

Informasi lebih lanjut: contoh

Menguji plug-in low-code

Menguji plug-in instan

1. Dari layar Beranda, pilih plug-in instan dari daftar, lalu pilih Uji di bilah perintah. Anda juga dapat membuka layar ini dari editor plug-in instan di bilah perintah setelah disimpan.

2. Berikan nilai untuk parameter input apa pun yang ditentukan dalam plug-in kode rendah, lalu pilih Jalankan.

Perhatikan tanggapannya.

Menguji plug-in otomatis

Menguji plug-in otomatis dengan memanggil peristiwa data. Amati apakah plug-in berhasil berjalan dengan memvalidasi perubahan yang diharapkan yang ditentukan dalam rumus.

Mengintegrasikan plug-in low-code

Memanggil plug-in instan dari aplikasi kanvas atau halaman kustom

1. Di Dataverse aplikasi Akselerator :
   1. Pilih plug-in instan dalam daftar.
   2. Pilih Salin cuplikan kode di bilah perintah.
   3. Tempel dan simpan rumus yang disalin ke editor teks atau notepad (di suatu tempat yang dapat Anda rujuk kembali dengan mudah).
2. Dalam Power Apps:
   1. Buat atau edit aplikasi kanvas (atau halaman kustom) di Power Apps studio.
   2. Di navigasi kiri, di bawah tab Sumber Data, pilih + Sumber data baru, dan cari opsi Lingkungan dari Dataverse konektor.
   3. Masukkan komponen berikut ke dalam kanvas:
   • Tambahkan kontrol input yang sesuai dengan tipe data setiap parameter, seperti Input teks untuk teks atau angka, beralih untuk boolean.
   • Jika cakupan plug-in terikat ke tabel, tambahkan kotak kombo yang terkait dengan tabel yang sama sehingga Anda dapat memilih input.
   • Tambahkan tombol untuk memanggil plug-in.
3. Tempelkan rumus plug-in yang Anda salin ke properti tombol OnSelect .
4. Petakan setiap parameter Value input untuk mereferensikan kontrol input yang sesuai:
   • Jika rumusnya Environment.new_CalculateSum({ X: Value, Y: Value });, itu bisa ditulis ulang sebagai: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
   • Jika rumus terikat, ganti dengan Environment nama tampilan tabel untuk mengakses plug-in.
5. Jika parameter output ditentukan untuk plug-in kode rendah:
   1. Tangkap respons dalam a Set() atau UpdateContext() rumus: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Tampilkan variabel dalam label. Atau, gunakan Notify() rumus untuk menampilkan data dalam pemberitahuan.
6. Putar aplikasi dan pilih perintah pada bilah perintah untuk menjalankan plug-in kode rendah.

Pelajari lebih lanjut cara memanggil Dataverse tindakan langsung dari Power Fx aplikasi kanvas.

Memanggil plug-in instan dari Power Automate alur cloud

1. Dalam alur cloud, tambahkan tindakan baru dari Microsoft Dataverse konektor.
2. Pilih tindakan yang disebut Melakukan tindakan yang tidak terikat atau Lakukan tindakan terikat.
3. Pilih plug-in Anda (memiliki nama unik dengan awalan).
4. Berikan nilai untuk semua parameter input (jika ada).

Memanggil plug-in instan dari Dataverse API Web

Ikuti langkah-langkah untuk tindakan yang tidak terikat atau Fungsi yang terikat ke bagian tabel di dokumentasi Memanggil API kustom dari API Web (tergantung pada cakupan plug-in yang sesuai).

Mendapatkan bantuan dengan plug-in low-code

Jika Anda mengalami masalah saat membuat atau menjalankan plug-in low-code, buka tips ini untuk masalah umum yang dapat terjadi: Microsoft Dataverse Tips plug-in low-code dan masalah umum

Menghubungi Bantuan + dukungan

Untuk masalah dengan Dataverse penginstalan solusi Akselerator atau plug-in low-code yang tidak tercakup dalam Microsoft Dataverse tips plug-in low-code dan masalah yang diketahui, seperti kesalahan yang tidak terdokumentasi yang diterima, gunakan pengalaman Bantuan + dukungan dan sertakan informasi berikut:

• Jenis Masalah-Web Dataverse API dan SDK
• Subtipe Masalah- Kit akselerator untuk Dataverse

Contoh plug-in low-code yang dapat Anda buat

Untuk beberapa contoh cara membuat plug-in low-code, buka Contoh Dataverse plug-in low-code (pratinjau)

Pembatasan

• Objek bahasa lingkungan perlu ditambahkan kembali untuk mengakses plug-in baru di dalam aplikasi kanvas yang ada. Untuk plug-in apa pun yang dibuat setelah Anda menambahkan sumber data tabel lingkungan ke aplikasi kanvas yang ada, Anda harus menghapus dan menambahkan Power Fx kembali objek bahasa lingkungan. Kemudian Anda melihat daftar plug-in yang diperbarui sebagai tindakan.

• Intellisense memerlukan notasi eksplisit dalam plug-in otomatis jika Anda ingin merujuk tabel apa pun dalam rumus. Gunakan sintaks disambiguasi berikut seperti [@Accounts], menggunakan tanda kurung siku dan simbol ( @ bukan Accounts).

• Dukungan bertingkat. Plug-in hanya dapat memanggil tindakan pihak pertama yang diterbitkan oleh Microsoft dari Power Fx ekspresi.

• Beberapa Collect skenario memerlukan Patch. Ada beberapa skenario di mana Collect() tidak berhasil. Solusinya adalah dengan menggunakan Patch() seperti yang ditunjukkan pada contoh mengisi kolom di bawah ini. Jika Anda membuat plug-in otomatis, tambahkan @ ke setiap tabel yang direferensikan dalam Power Fx rumus.

  Patch(Faxes,
      Collect(Faxes, { Subject : "Sub1" } ),
      { Regarding : First(Accounts) }
  )
  

• Saat plug-in low-code berinteraksi dengan konektor dan DLP digunakan, admin dapat memblokir pembuatan koneksi menggunakan DLP. Namun, referensi koneksi yang ada di Dataverse lingkungan terus berfungsi. Jika admin perlu memblokir semua interaksi plug-in low-code dengan konektor apa pun, mereka dapat menonaktifkan pengaturan Allowconnectorsonpowerfxactions organisasi. Pengaturan ini diaktifkan secara default dan dapat dinonaktifkan dengan metode SDK biasa (WebAPI, SDK, PowerShell, dan sebagainya). Anda dapat menonaktifkan ini menggunakan plug-in instan low-code sebagai berikut:

  Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })
  

• Plug-in yang menggunakan konektor hanya dapat menghasilkan hasil dari bidang tertentu. Karena itu, Anda perlu memetakan nilai primitif tertentu dari respons konektor ke nilai output.

Plugin low-code yang memiliki batasan konektor khusus

Jika Anda memiliki plugin low-code dengan konektor kustom, konektor kustom harus diimpor terlebih dahulu, sebelum referensi atau alur koneksi.

Jika lingkungan Anda tidak berisi konektor kustom dalam solusi, impor solusi terpisah yang hanya menyertakan konektor kustom. Lakukan impor ini sebelum Anda mengimpor solusi yang sebenarnya. Anda perlu melakukan ini terlebih dahulu karena Azure harus mendaftarkan konektor kustom sebelum komponen solusi lainnya dapat diimpor.

Jika Anda mengimpor solusi yang berisi konektor dan alur kustom, Azure tidak dapat mendaftarkan konektor kustom saat mendaftarkan referensi atau alur koneksi Anda. Ini juga berlaku untuk referensi koneksi untuk konektor kustom yang sebelumnya tidak diimpor dalam solusi terpisah. Jika Azure tidak mendaftarkan konektor kustom Anda, impor gagal, atau Anda tidak dapat memulai impor.

Informasi selengkapnya: Membuat konektor kustom dalam solusi: Batasan yang diketahui

Baca juga

Plug-in kode rendah Power Fx (pratinjau)

Gunakan prompt yang sudah dibuat sebelumnya di plug-in kode rendah di Dataverse Power Apps

Buat plug-in kode rendah otomatis dengan Power Apps (video)

Buat plug-in low-code instan dengan Power Apps (video)