Kongsi melalui


Gunakan pemalam kod rendah dalam Dataverse (pratonton)

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

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

Penting

  • Pemalam kod rendah segera dinyahkeutamaan dan tidak dihantar sebagai ciri. Pemalam kod rendah segera digantikan dengan fungsi. Maklumat lanjut: Fungsi dalam Microsoft Dataverse (pratonton)
  • 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, pemalam telah dicipta sebagai kelas tersuai yang disusun ke dalam perhimpunan .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 tiada keperluan untuk pendaftaran manual.

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

Faedah logik bahagian pelayan

Mentakrifkan logik perniagaan bahagian pelayan menawarkan beberapa faedah, termasuk:

  • Peningkatan keselamatan. Memandangkan logik bahagian pelayan dilaksanakan pada pelayan, ia boleh membantu menghalang akses tanpa kebenaran kepada data atau proses sensitif.
  • Prestasi yang dipertingkatkan. Dengan melaksanakan pada pelayan, logik perniagaan boleh mengurangkan jumlah data yang perlu dipindahkan antara pelanggan dan pelayan, menghasilkan masa pemprosesan yang lebih cepat.
  • Konsistensi dan kebolehpercayaan. Logik bahagian pelayan memastikan bahawa peraturan perniagaan digunakan secara konsisten merentas semua pelanggan, mengurangkan risiko ralat atau ketidakkonsistenan.
  • Penyelenggaraan dan peningkatan yang lebih mudah. Dengan memusatkan logik perniagaan pada pelayan, ia menjadi lebih mudah untuk menyelenggara dan mengemas kini, kerana perubahan boleh dibuat di satu tempat daripada perlu mengemas kini berbilang pelanggan.
  • Kebolehskalaan. Logik bahagian pelayan boleh diskalakan dengan lebih mudah daripada logik bahagian pelanggan, 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 Global dan jadual
Diautomatikkan Dataverse Acara Jadual No Table

Semua pemalam kod rendah mempunyai sifat biasa berikut:

Sifat Description
Nama paparan Nama pemalam yang boleh dibaca manusia. Tidak boleh diubah sebaik sahaja dibuat.
Nama Nama dalaman pemalam. Ia digunakan oleh platform untuk mengenal pasti komponen dalam kod dan operasi pangkalan data. Tidak boleh diubah sebaik sahaja dibuat.
Description Digunakan untuk menyediakan konteks tambahan tentang pemalam (tujuan, tingkah laku atau butiran penting lain).
Penyelesaian Digunakan untuk mengumpulkan komponen dan mengeksport ke persekitaran lain. Ketahui lebih lanjut tentang penyelesaian.
Ungkapan Ini ialah 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 apl kanvas dan telah diperluaskan untuk digunakan dalam pemalam kod rendah. Lihat fungsi yang disokong untuk maklumat lanjut.

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

Ciri-ciri unik:

Sifat Description
Scope Digunakan untuk mengaitkan pemalam kepada jadual tertentu. Ia boleh ditetapkan kepada sama ada jadual (ditunjukkan sebagai entiti) atau global, di mana skop jadual (entiti) bermakna pemalam dicetuskan dengan konteks rekod jadual tertentu dan skop global bermakna operasi tidak dikaitkan dengan jadual (ketahui lebih lanjut).
Parameter Parameter membolehkan anda menghantar 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 pemalam 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: Sepadukan pemalam kod rendah

Keizinan pemalam

Masa reka bentuk

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

Masa berjalan

Apabila pemalam dipanggil, ia mengakses data jadual yang terlibat dalam takrifan pemalam (jadual yang merupakan sebahagian daripada formula atau jika jadual dikaitkan dengan seting pemalam automatik) dalam konteks pengguna yang memanggilnya.

Sambungan

Menggunakan peranan keselamatan, akses penyambung dalam pemalam boleh dihadkan kepada set pengguna tertentu dalam organisasi anda. Tentukan peranan yang mempunyai keistimewaan mencipta, membaca, mengemas kini atau memadam.

Prasyarat untuk mencipta pemalam kod rendah

  • Pentadbir sistem atau penyesuai sistem keahlian peranan keselamatan dalam Power Platform persekitaran.
  • Akses kepada Dataverse apl pemecut.

Tip

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

Kemas kini pemecut Dataverse

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

Tip

Dayakan kemas kini aplikasi automatik 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 sebelum ini memasang penyelesaian Pemalam Kod Rendah untuk Penyambung pilihan , ia akan dipadamkan secara automatik apabila anda mengemas kini selepas 29 Jun 2023. Keupayaan akan tersedia dalam penyelesaian utama.

Cipta pemalam kod rendah segera

  1. Mainkan Dataverse apl pemecut.
  2. Pilih kad Buat pemalam segera. Cipta kad pemalam segera
  3. Berikan nama paparan .
  4. Secara pilihan, tentukan parameter:
    • Pilih Parameter input baharu atau Parameter output baharu, kemudian masukkan label dan jenis data.
    • Tambah lebih banyak parameter input dan output mengikut keperluan.
  5. Masukkan Power Fx ungkapan dalam editor Ungkapan .
    • Rujukan parameter input 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 Filter() dan LookUp().
    • Jika skop ditetapkan kepada entiti, gunakan ThisRecord untuk mengakses nilai lajur dalam baris jadual yang dikaitkan dengan larian pemalam, seperti ThisRecord.'Account Name'.

    Tip

    Perhatikan intellisense dalam kotak Ungkapan . Merah yang digariskan tidak sah. Kuning berlekuk-lekuk bermakna logik anda mungkin terjejas oleh had perwakilan. Elakkan isu delegasi dengan menggunakan fungsi yang boleh diwakilkan.

  6. Secara pilihan kembangkan Pilihan lanjutan untuk mengubah suai penyelesaian, skop atau perihalan.
  7. Pilih Simpan.
  8. Uji pemalam kod rendah segera anda.

Contoh: Kira jumlah dua integer.

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

Contoh pemalam segera dalam apl Dataverse Accelerator

Cipta pemalam kod rendah automatik

  1. Mainkan Dataverse apl pemecut.
  2. Pilih kad Cipta pemalam automatik. Buat kad pemalam automatik
  3. Sediakan nilai berikut:
    • Nama: Masukkan nama untuk pemalam, seperti Pengesahan input.
    • Jadual: Pilih jadual untuk mengaitkan pemalam kepada, seperti Akaun.
    • Jalankan peraturan pemalam ini apabila baris adalah. Tentukan peristiwa data yang menggunakan pemalam.
  4. Masukkan Power Fx ungkapan dalam editor Ungkapan .
    • Jadual rujukan Dataverse menggunakan fungsi pengumpulan data, seperti Filter() dan LookUp().
    • Gunakan ThisRecord untuk mengakses nilai lajur dalam baris jadual yang dikaitkan dengan larian pemalam, seperti ThisRecord.'Account Name'.
  5. Secara pilihan, kembangkan Pilihan lanjutan untuk mengubah suai peringkat (apabila ini harus dijalankan) dan penyelesaian di mana pemalam disimpan.
  6. Pilih Simpan.
  7. Uji pemalam kod rendah automatik anda.

Gunakan Power Platform penyambung dalam pemalam kod rendah

Power Platform penyambung boleh digunakan dalam pemalam kod rendah untuk menyepadukan data dan kefungsian dengan mudah daripada sistem di luar Dataverse, seperti SQL Server, Salesforce, dan SharePoint, tanpa memerlukan pengekodan yang 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 formula pemalam Power Fx kod rendah.

  1. Cipta sambungan kepada penyambung yang anda mahu gunakan.
  2. Tambah rujukan sambungan kepada sambungan dalam Dataverse persekitaran.
  3. Dalam editor ungkapan pemalam Power Fx kod 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 tersedia. Pilih tindakan yang anda mahu, dan kemudian masukkan parameter yang diperlukan.

Sebelum menggunakan penyambung dalam pemalam kod rendah, semak dokumentasi penyambung untuk memastikan anda menghantar 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 pemalam. Sebaliknya, gunakan fungsi asli Power Fx untuk berinteraksi dengan koleksi: Penapis, Carian, Carian, Tampalan..., Kumpulkan dan Tetapkan, di mana lajur dianggap sebagai pembolehubah global.

Uji pemalam kod rendah

Uji pemalam segera

  1. Daripada skrin Utama, pilih pemalam segera daripada senarai, kemudian pilih Uji pada bar perintah. Anda juga boleh pergi ke skrin ini daripada editor pemalam segera dalam bar arahan selepas ia disimpan. Pilih Uji untuk pemalam kod rendah

  2. Sediakan nilai untuk sebarang parameter input yang ditakrifkan dalam pemalam kod rendah dan kemudian pilih Jalankan. Pilih Jalankan untuk menguji pemalam kod rendah

Perhatikan respons.

Tip

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

Uji pemalam automatik

Uji pemalam automatik dengan memanggil peristiwa data. Perhatikan sama ada pemalam berjaya dijalankan dengan mengesahkan perubahan yang dijangkakan yang ditakrifkan dalam formula.

Tip

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

  1. Log masuk Power Apps, pergi ke Jadual dan pilih jadual Pemalam .
  2. Pada bar perintah, pilih Edit.
  3. Cipta, kemas kini atau padamkan baris terus daripada paparan ini. Sebagai alternatif, buka baris dalam borang lalai dengan memilih baris, kemudian pilih Edit baris menggunakan borang pada bar perintah.

Sepadukan pemalam kod rendah

Memanggil pemalam segera daripada app kanvas atau halaman tersuai

  1. Dalam Dataverse apl Accelerator :
    1. Pilih pemalam segera dalam senarai.
    2. Pilih Salin coretan kod pada bar perintah. Panggil pemalam kod rendah contoh
    3. Tampal dan simpan formula yang disalin ke editor teks atau pad nota (di suatu tempat yang boleh anda rujuk semula dengan mudah).
  2. Dalam Power Apps:
    1. Cipta atau edit aplikasi kanvas (atau halaman tersuai) dalam Power Apps studio.
    2. Dalam navigasi kiri, di bawah tab Sumber Data, pilih + Sumber data baharu dan cari pilihan Persekitaran daripada penyambung Dataverse .
    3. Masukkan komponen berikut ke dalam kanvas:
    • Tambah kawalan input yang sepadan dengan setiap jenis data parameter, seperti Input teks untuk teks atau nombor, togol untuk boolean.
    • Jika skop pemalam terikat pada jadual, tambah kotak kombo yang dikaitkan dengan jadual yang sama supaya anda boleh memilih input.
    • Tambah butang untuk memanggil pemalam.
  3. Tampal formula pemalam yang anda salin ke dalam sifat butang OnSelect .
  4. Petakan setiap parameter Value input untuk merujuk kawalan input yang sepadan:
    • Jika formula itu Environment.new_CalculateSum({ X: Value, Y: Value });, ia boleh ditulis semula sebagai: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Jika formula telah diikat, gantikan Environment dengan nama paparan jadual untuk mengakses pemalam.
  5. Jika parameter output ditakrifkan untuk pemalam kod rendah:
    1. Tangkap respons dalam formula Set()UpdateContext() atau : Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Paparkan pemboleh ubah dalam label. Sebagai alternatif, gunakan Notify() formula untuk 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 apl kanvas.

Panggil pemalam segera daripada Power Automate aliran awan

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

Panggil pemalam segera daripada Dataverse API Web

Ikut langkah untuk tindakan Tidak Terikat atau Fungsi terikat pada bahagian jadual dalam Memanggil API tersuai daripada dokumentasi API Web (bergantung pada skop pemalam yang sesuai).

Mendapatkan bantuan dengan pemalam kod rendah anda

Jika anda menghadapi masalah mencipta 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 Accelerator atau pemalam kod rendah yang tidak diliputi dalam Microsoft Dataverse petua pemalam kod rendah dan isu yang diketahui, seperti ralat tidak berdokumen yang diterima, gunakan pengalaman sokongan Bantuan + dan sertakan maklumat berikut:

  • Jenis Masalah-Web Dataverse API dan SDK
  • Subjenis Masalah- Kit pemecut untuk Dataverse

Contoh pemalam kod rendah yang boleh anda cipta

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

Batasan

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

  • Intellisense memerlukan notasi eksplisit dalam pemalam automatik jika anda ingin merujuk mana-mana jadual dalam formula. Gunakan sintaks nyahkekaburan berikut seperti [@Accounts], menggunakan kurungan persegi dan @ simbol (tidak Accounts).

  • Sokongan bersarang. 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. Penyelesaiannya ialah menggunakan Patch() seperti yang ditunjukkan dalam mengisi mengenai contoh lajur di bawah. Jika anda mencipta pemalam automatik, tambahkan @ pada 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 melumpuhkan tetapan Allowconnectorsonpowerfxactions organisasi. Tetapan ini didayakan secara lalai dan boleh dilumpuhkan oleh kaedah SDK biasa (WebAPI, SDK, PowerShell dan sebagainya). Anda boleh melumpuhkan 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 pemalam kod rendah dengan penyambung tersuai, penyambung tersuai mesti diimport terlebih dahulu, sebelum rujukan sambungan atau aliran.

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 terpakai 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: Had yang diketahui

Lihat juga

Pemalam Power Fx kod rendah(pratonton)

Gunakan gesaan prabina dalam Dataverse pemalam kod rendah dalam Power Apps

Buat pemalam kod rendah automatik dengan Power Apps (video)

Buat pemalam kod rendah segera dengan Power Apps (video)