Panggil fungsi daripada apl, aliran, kod atau fungsi lain (pratonton)

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

Anda boleh memanggil fungsi dalam Dataverse daripada aplikasi kanvas, halaman tersuai dalam aplikasi dipacu model, aliran, kod atau daripada fungsi lain.

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.

Memanggil fungsi daripada aplikasi kanvas atau halaman tersuai

  1. Daripada kawasan Fungsi dalam Power Apps (make.powerapps.com), pilih fungsi yang anda mahu gunakan daripada aplikasi kanvas atau halaman tersuai.
  2. Pilih Salin coretan kod pada bar perintah.
  3. Tampal dan simpan formula yang disalin ke editor teks, Notepad atau tempat yang boleh anda rujuk dengan mudah.
  4. Dalam Power Apps Studio:

    1. Buat atau edit aplikasi kanvas atau halaman tersuai dalam Power Apps Studio.

    2. Di panel navigasi kiri, di bawah tab Sumber Data , pilih Tambah data, cari jadual Persekitaran dari penyambung Dataverse, dan pilih ia.

      Nota

      Jika jadual Environment tidak tersedia untuk dipilih, cipta aplikasi baru dalam persekitaran yang sama untuk mencetuskan penciptaannya.

    3. Masukkan komponen berikut ke atas kanvas:

      • Tambah kawalan input yang sepadan dengan jenis data setiap parameter, seperti input nombor.
      • Tambah butang untuk memanggil fungsi.
      • Tambah kawalan output yang sepadan dengan jenis data parameter anda, seperti input nombor.
  5. Pilih butang yang anda cipta dan dalam sifat OnSelect , masukkan fungsi anda, seperti Environment.new_calculatesum.
  6. Petakan setiap parameter Value input untuk merujuk kawalan input yang sepadan:
    • Jika fungsi anda, Environment.new_CalculateSum({ X: Value, Y: Value }); ia boleh ditulis semula sebagai: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Untuk menetapkan output 'result' Fungsi anda, kemas kini formula anda kepada 'Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))'.
  7. Pilih kawalan output dan tetapkan sifat 'Nilai' dengan formula 'result.z'.

Pratonton apl anda, masukkan nilai input 1 dan 2 dan pilih butang. Hasilnya sepatutnya ditunjukkan dalam medan output.

Memanggil fungsi daripada Power Automate aliran awan

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

Memanggil fungsi daripada Dataverse API Web

Ikut langkah untuk bahagian tindakan tidak terikat dalam artikel Memanggil API tersuai daripada API Web (bergantung pada skop pemalam yang sesuai).

Panggil fungsi sedia ada dari dalam fungsi baharu

Untuk memanggil fungsi sedia ada dalam fungsi baharu, gunakan sintaks: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Memandangkan output sentiasa rekod, gunakan notasi titik untuk mengakses parameter output. Sebagai contoh, jika fungsi "ExistingFunction" mempunyai dua parameter output yang ditakrifkan sebagai out1 dan out2, anda boleh mengaksesnya dalam salah satu daripada dua cara ini:

  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out1
  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out2

Had dengan fungsi dalam Dataverse

  • Objek bahasa persekitaran perlu ditambah semula untuk mengakses fungsi baharu dalam apl kanvas sedia ada. Untuk sebarang fungsi yang dicipta selepas anda menambah sumber data jadual persekitaran pada aplikasi kanvas sedia ada, anda mesti mengalih keluar dan menambah Power Fx semula objek bahasa persekitaran. Kemudian anda melihat senarai fungsi yang dikemas kini sebagai tindakan.
  • Sokongan bersarang. Fungsi hanya boleh memanggil tindakan Microsoft 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 sini.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Nyahpepijat dan dapatkan bantuan dengan fungsi anda

Jika anda menghadapi masalah mencipta atau menjalankan fungsi anda, gunakan trace() fungsi untuk penyahpepijatan atau pergi ke Had dengan fungsi dalam Dataverse untuk isu biasa yang boleh berlaku.

Penyahpepijatan menggunakan fungsi trace()

  1. Untuk menyahpepijat menggunakan fungsi jejak, pastikan anda mendayakan pemalam dan penjejakan aktiviti aliran kerja tersuai.
  2. Pergi ke( Power Apps make.powerapps.com), pilih ikon gear Tetapan di bahagian atas sebelah kanan, dan kemudian pilih Tetapan lanjutan.
  3. Pilih Tetapan > Pengauditan > Tetapan Audit Global.
  4. Pada tab Penyesuaian , pastikan Dayakan pembalakan ke log jejak pemalam didayakan untuk Semua.

Sebaik sahaja anda mendayakan penjejakan, anda boleh mula menggunakan fungsi trace() untuk menyahpepijat Power Fx formula. Ketahui lebih lanjut tentang cara menggunakan fungsi trace() di dalam Power Fx ungkapan: Fungsi jejak - Power Platform.

Menghubungi bantuan + sokongan

Untuk isu dengan fungsi 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.

Contoh fungsi

Cipta dan gunakan fungsi dalam Microsoft Dataverse

  • Last updated on