Kongsi melalui

Gunakan pemalam kod rendah dalam Dataverse (pratonton)

  • Artikel

[Topik ini ialah dokumentasi prapelancaran dan tertakluk pada perubahan.]

Microsoft Dataverse menawarkan penyelesaian yang kuat untuk mencapai seni bina data yang lebih cekap dan mengurangkan beban kerja pihak pelanggan melalui pemalam kod rendah. Pemalam ini boleh digunakan semula, aliran kerja masa nyata yang melaksanakan set arahan tertentu di dalam Dataverse, menjalankan bahagian pelayan dan dicetuskan oleh pengendali acara yang diperibadikan.

Penting

  • Ini adalah ciri pratonton.
  • Ciri pratonton bukan untuk kegunaan pengeluaran dan kefungsian mungkin terbatas. Ciri ini tersedia sebelum keluaran rasmi agar pelanggan boleh mendapat akses awal dan memberikan maklum balas.

Secara tradisinya, plug-in dicipta sebagai kelas tersuai yang disusun ke dalam pemasangan .NET Framework, yang kemudiannya dimuat naik dan didaftarkan di dalamnya Dataverse. Walau bagaimanapun, dengan pengenalan pemalam kod rendah, pengguna boleh membuat pengendali acara ini dengan pengekodan minimum atau tidak diperlukan, dan tanpa memerlukan pendaftaran manual.

Pemalam kod rendah disimpan dalam Dataverse pangkalan data dan boleh disepadukan dengan lancar ke dalam Power Apps dan Power Automate. Kelakuan aliran kerja ditakrifkan menggunakan Power Fx bahasa ungkapan dan boleh berhubung terus dengan Dataverse data perniagaan dan sumber data luaran melalui Power Platform penyambung. Dengan pemalam kod rendah, pembuat dapat membina aliran kerja yang kompleks dengan kepakaran pengekodan yang minimum, menghasilkan seni bina data yang lebih lancar dan cekap.

Faedah logik pihak pelayan

Menentukan logik perniagaan pihak pelayan menawarkan beberapa faedah, termasuk:

  • Peningkatan keselamatan. Oleh kerana logik pihak pelayan dilaksanakan pada pelayan, ia boleh membantu menghalang akses yang tidak dibenarkan kepada data atau proses sensitif.
  • Prestasi yang lebih baik. Dengan melaksanakan pada pelayan, logik perniagaan dapat mengurangkan jumlah data yang perlu dipindahkan antara klien dan pelayan, menyebabkan masa pemprosesan yang lebih cepat.
  • Konsistensi dan kebolehpercayaan. Logik pihak pelayan memastikan bahawa peraturan perniagaan digunakan secara konsisten di semua pelanggan, mengurangkan risiko kesilapan atau ketidakkonsistenan.
  • Penyelenggaraan dan peningkatan yang lebih mudah. Dengan memusatkan logik perniagaan pada pelayan, ia menjadi lebih mudah untuk mengekalkan dan mengemas kini, kerana perubahan boleh dibuat di satu tempat dan bukannya perlu mengemas kini berbilang pelanggan.
  • Skalabiliti. Logik sisi pelayan boleh diskalakan dengan lebih mudah daripada logik pihak klien, membolehkan prestasi yang lebih baik dan pengendalian beban kerja yang lebih besar.

Pemalam kod rendah

Terdapat dua jenis pemalam kod rendah yang disokong dalam Dataverse:

Jenis Pencetus Menyokong parameter Skop yang disokong
Segera Jalankan secara manual Ya Jadual dan global
Diautomatikkan Dataverse Peristiwa jadual No Table

Semua pemalam kod rendah mempunyai sifat umum berikut:

Sifat Description
Nama paparan Nama pemalam yang boleh dibaca manusia. Tidak boleh diubah setelah dibuat.
Nama Nama dalaman pemalam. Ia digunakan oleh platform untuk mengenal pasti komponen dalam operasi kod dan pangkalan data. Tidak boleh diubah setelah dibuat.
Description Digunakan untuk memberikan konteks tambahan tentang pasang masuk (tujuan, tingkah laku atau butiran penting lain).
Penyelesaian Digunakan untuk mengumpulkan komponen dan mengeksport ke persekitaran lain. Ketahui lebih lanjut tentang penyelesaian.
Ungkapan Ini adalah fungsi tersuai yang boleh digunakan untuk melaksanakan tindakan atau pengiraan, ditakrifkan menggunakan Power Fx bahasa ungkapan. Power Fx ialah bahasa formula yang digunakan dalam Power Apps aplikasi kanvas dan telah dilanjutkan untuk digunakan dalam pemalam kod rendah. Lihat fungsi yang disokong untuk butiran lanjut.

Pemalam kod rendah segera ialah logik kod tersuai yang dicetuskan secara manual oleh pengguna. Parameter input dan output tersuai boleh digunakan.

Sifat unik:

Sifat Description
Scope Digunakan untuk mengaitkan pasang masuk ke jadual tertentu. Ia boleh disetkan kepada sama ada jadual (ditunjukkan sebagai entiti) atau global, di mana skop jadual (entiti) bermaksud pemalam dicetuskan dengan konteks rekod jadual tertentu dan skop global bermakna pengendalian tidak dikaitkan dengan jadual (ketahui lebih lanjut).
Parameter Parameter membolehkan anda menyampaikan maklumat antara pemalam dan konteks yang menjalankannya, menjadikannya lebih mudah untuk mereka bentuk logik perniagaan yang boleh digunakan semula dalam situasi yang berbeza-beza.

Parameter input digunakan untuk menyediakan data kepada pasang masuk dan membolehkan anda mengawal cara fungsi berkelakuan dengan menghantar nilai berbeza yang anda tentukan dalam Power Fx formula.

Parameter output membolehkan anda mendapatkan semula hasil fungsi atau kaedah untuk kegunaan selanjutnya dalam program anda.

Jenis data yang disokong:
  • Boolean
  • String
  • Float
  • Decimal
  • TarikhMasa
  • Integer

Maklumat lanjut tentang cara menyepadukan daripada apl kanvas atau dalam Power Automate aliran awan: Menyepadukan pemalam kod rendah

Keizinan pasang masuk

Masa reka bentuk

Pembuat yang mempunyai penyesuaian sistem atau pentadbir sistem peranan keselamatan keahlian dalam Power Platform persekitaran boleh mengakses semua pemalam dalam persekitaran tersebut. Peranan keselamatan tersuai boleh digunakan untuk menyekat akses kepada pemalam kod rendah.

Masa jalankan

Apabila pasang masuk digunakan, ia mengakses data jadual yang terlibat dalam definisi pasang masuk (jadual yang merupakan sebahagian daripada formula atau jika jadual dikaitkan dengan seting pasang masuk automatik) dalam konteks pengguna yang menggunakannya.

Sambungan

Menggunakan peranan keselamatan, capaian penyambung dalam pasang masuk boleh dihadkan kepada set pengguna tertentu dalam organisasi anda. Tentukan peranan yang telah mencipta, membaca, mengemas kini atau memadam keistimewaan.

Prasyarat untuk membuat pemalam kod rendah

Nota

Kami sedang melancarkan satu set kemas kini untuk membolehkan Dataverse pemalam kod rendah. Plugin kod rendah ini menggunakan antara muka pengguna yang dibina pada Power Platform ciri halaman tersuai. Sebagai sebahagian daripada kemas kini ini, kami menggunakan persekitaran menggunakan akaun penyelenggaraan sistem. Dalam beberapa keadaan, akaun-akaun ini mempunyai kesan sampingan yang tidak dijangka untuk dibentangkan sebagai akaun pecah kaca. Kami sedang berusaha untuk membetulkan tingkah laku ini secepat mungkin. Sementara itu, aplikasi berikut mungkin muncul dalam Power Platform pusat pentadbiran:

  • Dataverse Aplikasi pemecut – < aplikasi> berpandukan model, dicipta oleh akaun pentadbir global
  • Dataverse Halaman tindakan - < aplikasi> kanvas Ini adalah halaman Tersuai di mana plugin kod rendah dibina, dicipta dengan nama pengguna yang dikaitkan dengan akaun pentadbir global.
  • Gambaran keseluruhan halaman - < aplikasi> kanvas Ini adalah halaman tersuai di mana plugin kod rendah dibina, dicipta dengan nama pengguna yang dikaitkan dengan akaun pentadbir global.
  • Pentadbir sistem atau penyesuai sistem peranan keselamatan keahlian dalam persekitaran Power Platform .
  • Akses kepada Dataverse aplikasi pemecut.

Petua

Semua persekitaran baharu mempunyai aplikasi pemecut yang Dataverse dipasang secara automatik pada 1 Oktober 2023. Jika anda sudah Dataverse memasang pemecut, anda boleh mengemas kini pemecut secara Dataverse manual.

Kemas kini pemecut Dataverse

  1. Ikut arahan untuk melihat apl berlesen dalam persekitaran anda.
  2. Dataverse Jika Pemecut telah dipasang dan kemas kini tersedia, ia ditunjukkan dalam jadual di sebelah item.
  3. Pilih Dataverse Pemecut, kemudian pilih Kemas kini pada bar perintah.

Petua

Dayakan kemas kini aplikasi auto untuk penerbit Microsoft - Power CAT untuk menerima kemas kini secara automatik apabila tersedia (tidak perlu untuk persekitaran baharu yang dicipta selepas 1 Oktober 2023).

Nota

Jika anda memasang penyelesaian Pemalam Kod Rendah untuk Penyambung sebelum ini, ia akan dipadamkan secara automatik apabila anda mengemas kini selepas 29 Jun 2023. Keupayaan akan tersedia dalam penyelesaian utama.

Buat pasang masuk kod rendah segera

  1. Mainkan apl pemecut. Dataverse
  2. Pilih kad pasang masuk segera Buat. Buat kad pasang masuk segera
  3. Berikan nama Paparan.
  4. Secara pilihan, tentukan parameter:
    • Pilih Parameter input baru atau Parameter output baru, kemudian masukkan label dan jenis data.
    • Tambah lebih banyak parameter input dan output mengikut keperluan.
  5. Power Fx Masukkan ungkapan dalam editor Ungkapan .
  • Parameter input rujukan dalam formula dengan nama label.
  • Parameter output mesti dirujuk di dalam kurungan kerinting, seperti { Out: "Return value" }.
  • Jadual rujukan Dataverse menggunakan fungsi pengumpulan data, seperti Penapis() dan LookUp().
  • Jika skop disetkan kepada entiti, gunakan ThisRecord untuk mencapai nilai lajur dalam baris jadual yang berkaitan dengan larian pasang masuk, seperti ThisRecord.'Account Name'.

Petua

Perhatikan intellisense dalam kotak Ungkapan . Merah bergaris bawah tidak sah. Squiggly kuning bermaksud logik anda mungkin dipengaruhi oleh batasan perwakilan. Elakkan isu perwakilan dengan menggunakan fungsi yang boleh dipercayai.

  1. Secara pilihan kembangkan opsyen Lanjutan untuk mengubah suai penyelesaian, skop atau perihalan.
  2. Pilih Simpan.
  3. Uji pasang masuk kod rendah segera anda.

Contoh: Kira jumlah dua integer.

  • Mencipta dua parameter input,dan X Y (kedua-dua integer jenis) dan satu parameter output, Z (rentetan jenis).
  • Gunakan formula berikut: {Z: X + Y }

Contoh pemalam segera dalam Dataverse aplikasi Pemecut

Buat pasang masuk kod rendah automatik

  1. Mainkan apl pemecut. Dataverse
  2. Pilih kad pasang masuk Cipta automatik. Buat kad pasang masuk automatik
  3. Berikan nilai berikut:
    • Nama: Masukkan nama untuk pasang masuk, seperti pengesahihan Input.
    • Jadual: Pilih jadual untuk mengaitkan pasang masuk, seperti Akaun.
    • Jalankan peraturan pemalam ini apabila baris itu. Tentukan peristiwa data yang menggunakan pasang masuk.
  4. Power Fx Masukkan ungkapan dalam editor Ungkapan .
  • Jadual rujukan Dataverse menggunakan fungsi pengumpulan data, seperti Penapis() dan LookUp().
  • Digunakan ThisRecord untuk mencapai nilai lajur dalam baris jadual yang berkaitan dengan larian pasang masuk, seperti ThisRecord.'Account Name'.
  1. Secara pilihan, kembangkan pilihan Lanjutan untuk mengubah suai peringkat (apabila ini harus dijalankan) dan penyelesaian di mana pasang masuk disimpan.
  2. Pilih Simpan.
  3. Uji pasang masuk kod rendah automatik anda.

Gunakan Power Platform penyambung dalam pemalam kod rendah

Power Platform penyambung boleh digunakan dalam pemalam kod rendah untuk mengintegrasikan data dan fungsi dengan mudah daripada sistem di luar Dataverse, seperti SQL Server, Salesforce, dan SharePoint, tanpa memerlukan pengekodan kompleks atau pembangunan tersuai.

Prasyarat untuk menggunakan penyambung dalam pemalam kod rendah

Menggunakan tindakan penyambung dalam pemalam kod rendah

Anda boleh menggunakan penyambung dan penyambung tersuai dengan mudah dari dalam palam kod rendah formula . Power Fx

  1. Cipta sambungan kepada penyambung yang anda ingin gunakan.
  2. Tambah rujukan sambungan kepada sambungan dalam Dataverse persekitaran.
  3. Dalam editor ungkapan pemalam kod Power Fx rendah, taipkan nama rujukan sambungan (nama dalaman dengan awalan dan garis bawah, seperti new_connectorName, bukan nama paparan).
  4. Intellisense menunjukkan kepada anda tindakan yang ada. Pilih tindakan yang anda inginkan, kemudian masukkan parameter yang diperlukan.

Sebelum menggunakan penyambung dalam pemalam kod rendah, semak dokumentasi penyambung untuk memastikan anda lulus parameter input dan output dengan betul.

Maklumat lanjut: contoh

Nota

  • Tidak semua tindakan penyambung disokong pada masa ini.
  • Jangan gunakan Dataverse penyambung untuk menyambung ke Dataverse jadual daripada ungkapan pasang masuk. Sebaliknya, gunakan fungsi asli Power Fx untuk berinteraksi dengan koleksi:Penapis, Carian, Carian, Tampalan ..., Kumpul dan Set, di mana lajur dianggap sebagai pemboleh ubah global.

Menguji pasang masuk kod rendah

Uji pasang masuk segera

  1. Daripada skrin Utama, pilih pasang masuk segera daripada senarai, kemudian pilih Uji pada bar perintah. Anda juga boleh sampai ke skrin ini dari editor pemalam segera di bar arahan selepas disimpan. Pilih Ujian untuk pasang masuk kod rendah

  2. Berikan nilai untuk sebarang parameter input yang ditakrifkan dalam pasang masuk kod rendah, kemudian pilih Jalankan. Pilih Jalankan untuk menguji pasang masuk kod rendah

Perhatikan respons.

Petua

Gunakan parameter output untuk membantu mengesahkan tingkah laku dan hasil yang dijangkakan. Jika tidak, anda hanya melihat kejayaan atau kegagalan semasa ujian.

Uji pasang masuk automatik

Uji pasang masuk automatik dengan menggunakan acara data. Perhatikan jika pemalam berjaya dijalankan dengan mengesahkan perubahan jangkaan yang ditakrifkan dalam formula.

Petua

Semasa pratonton, anda boleh menggunakan peristiwa data yang berkaitan menggunakan editor jadual dalam Power Apps:

  1. Log masuk Power Apps, pergi ke Jadual dan pilih jadual Pasang Masuk .
  2. Pada bar perintah, pilih Edit.
  3. Mencipta, mengemas kini atau memadam baris terus daripada pandangan ini. Secara alternatif, buka baris dalam borang lalai dengan memilih baris, kemudian pilih Edit baris menggunakan borang pada bar perintah.

Sepadukan pemalam kod rendah

Memohon pemalam segera daripada aplikasi kanvas atau halaman tersuai

  1. Dataverse Dalam aplikasi Accelerator :
    1. Pilih pasang masuk segera dalam senarai.
    2. Pilih Salin cebisan kod pada bar perintah. Memohon contoh pemalam kod rendah
    3. Tampal dan simpan formula yang disalin ke editor teks atau notepad (di suatu tempat anda boleh merujuk kembali dengan mudah).
  2. Dalam Power Apps:
    1. Buat atau edit aplikasi kanvas (atau halaman tersuai) di Power Apps studio.
    2. Dalam navigasi kiri, di bawah tab Sumber Data, pilih + sumber data Baru dan cari opsyen Persekitaran daripada Dataverse penyambung.
    3. Masukkan komponen berikut ke dalam kanvas:
    • Tambah kawalan input yang sepadan dengan jenis data setiap parameter, seperti Input teks untuk teks atau nombor, togol untuk boolean.
    • Jika skop pasang masuk terikat pada jadual, tambahkan kotak kombo yang dikaitkan dengan jadual yang sama supaya anda boleh memilih input.
    • Tambah butang untuk memanggil pasang masuk.
  3. Tampal formula pasang masuk yang anda salin ke dalam sifat butang OnSelect .
  4. Petakan setiap parameter Value input untuk merujuk kawalan input yang sepadan:
    • Jika formula Environment.new_CalculateSum({ X: Value, Y: Value }); itu, ia boleh ditulis semula sebagai: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Jika formula terikat, gantikan Environment dengan nama paparan jadual untuk mencapai pasang masuk.
  5. Jika parameter output ditakrifkan untuk pasang masuk kod rendah:
    1. Tangkap respons dalam formula Set() atau UpdateContext() formula: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Paparkan pemboleh ubah dalam label. Secara alternatif, gunakan formula untuk Notify() memaparkan data dalam pemberitahuan.
  6. Mainkan apl dan pilih arahan pada bar arahan untuk menjalankan pemalam kod rendah.

Ketahui lebih lanjut tentang cara anda boleh memanggil Dataverse tindakan terus daripada Power Fx dalam apl kanvas.

Memohon pemalam segera daripada Power Automate aliran awan

  1. Dalam aliran awan, tambahkan tindakan baharu daripada Microsoft Dataverse penyambung.
  2. Pilih tindakan yang dipanggil Melaksanakan tindakan tidak terikat atau Melaksanakan tindakan terikat.
  3. Pilih pasang masuk anda (ia mempunyai nama unik dengan awalan).
  4. Berikan nilai untuk semua parameter input (jika ada).

Memohon pemalam segera daripada Dataverse API Web

Ikuti langkah-langkah untuk Tindakan tidak terikat atau Fungsi yang terikat pada seksyen jadual dalam Menggunakan API tersuai daripada dokumentasi API Web(bergantung pada skop pasang masuk yang sesuai).

Mendapatkan bantuan dengan anda pemalam kod rendah

Jika anda menghadapi isu membuat atau menjalankan pemalam kod rendah anda, pergi ke petua ini untuk isu biasa yang boleh berlaku: Microsoft Dataverse petua pemalam kod rendah dan isu yang diketahui

Menghubungi Bantuan + sokongan

Untuk isu dengan Dataverse pemasangan penyelesaian Pemecut atau pemalam kod rendah yang tidak diliputi dalam Microsoft Dataverse petua pemalam kod rendah dan isu yang diketahui, seperti ralat tanpa dokumen yang diterima, gunakan pengalaman sokongan Bantuan + dan sertakan maklumat berikut:

  • Masalah Type-Web Dataverse API dan SDK
  • Kit Subtipe Masalah- Pemecut untuk Dataverse

Contoh pemalam kod rendah yang boleh anda buat

Untuk beberapa contoh cara membuat pemalam kod rendah, pergi ke Contoh Dataverse pemalam kod rendah (pratonton)

Batasan

  • Objek bahasa persekitaran perlu dibaca untuk mengakses pemalam baharu di dalam apl kanvas sedia ada. Untuk sebarang pasang masuk yang dicipta selepas anda telah menambah sumber data jadual persekitaran pada apl kanvas sedia ada, anda perlu mengalih keluar dan membaca Power Fx objek bahasa persekitaran. Kemudian anda melihat senarai pemalam yang dikemas kini sebagai tindakan.

  • Intellisense memerlukan notasi eksplisit dalam pemalam automatik jika anda ingin merujuk sebarang jadual dalam formula. Gunakan sintaks nyahkekaburan berikut seperti [@Accounts], menggunakan tanda kurung persegi dan @ simbol (bukan Accounts).

  • Sokongan tersarang. Pemalam hanya boleh memanggil tindakan pihak pertama yang diterbitkan oleh Microsoft daripada Power Fx ungkapan.

  • Sesetengah Collect senario memerlukan Patch. Terdapat beberapa senario di mana Collect() tidak berfungsi. Penyelesaian adalah untuk digunakan Patch() seperti yang ditunjukkan dalam mengisi mengenai contoh lajur di bawah. Jika anda mencipta pasang masuk automatik, pasang masuk @ ke setiap jadual yang dirujuk dalam Power Fx formula.

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

  • Apabila pemalam kod rendah berinteraksi dengan penyambung dan DLP digunakan, pentadbir boleh menyekat penciptaan sambungan menggunakan DLP. Walau bagaimanapun, rujukan sambungan sedia ada dalam Dataverse persekitaran terus berfungsi. Sekiranya pentadbir perlu menyekat semua interaksi pemalam kod rendah dengan mana-mana penyambung, mereka boleh menyahdayakan tetapan Allowconnectorsonpowerfxactions organisasi. Seting ini didayakan secara lalai dan boleh dinyahdayakan dengan kaedah SDK biasa (WebAPI, SDK, PowerShell dan sebagainya). Anda boleh menyahdayakan ini menggunakan pemalam segera kod rendah seperti berikut:

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

  • Pemalam yang menggunakan penyambung hanya boleh mengeluarkan hasil daripada medan tertentu. Disebabkan ini, anda perlu memetakan nilai primitif tertentu daripada tindak balas penyambung kepada nilai output.

Pemalam kod rendah yang mempunyai had penyambung tersuai

Jika anda mempunyai plugin kod rendah dengan penyambung tersuai, penyambung tersuai mesti diimport terlebih dahulu, sebelum rujukan atau aliran sambungan.

Jika persekitaran anda tidak mengandungi penyambung tersuai dalam penyelesaian, import penyelesaian berasingan yang hanya termasuk penyambung tersuai. Lakukan import ini sebelum anda mengimport penyelesaian sebenar. Anda perlu melakukan ini terlebih dahulu kerana Azure mesti mendaftarkan penyambung tersuai sebelum komponen penyelesaian lain boleh diimport.

Jika anda mengimport penyelesaian yang mengandungi penyambung dan aliran tersuai, Azure tidak dapat mendaftarkan penyambung tersuai semasa ia mendaftarkan rujukan atau aliran sambungan anda. Ini juga digunakan pada rujukan sambungan untuk penyambung tersuai yang tidak diimport sebelum ini dalam penyelesaian berasingan. Jika Azure tidak mendaftarkan penyambung tersuai anda, import gagal atau anda tidak dapat memulakan import.

Maklumat lanjut: Cipta penyambung tersuai dalam penyelesaian: Pengehadan diketahui

Lihat juga

Pemalam Power Fx kod rendah (pratonton)

Gunakan gesaan prabina dalam Dataverse pemalam kod rendah Power Apps