Memanggil fungsi dari aplikasi, alur, kode, atau fungsi lain (pratinjau)

[Topik ini adalah dokumentasi prarilis dan dapat berubah.]

Anda dapat memanggil fungsi dalam Dataverse dari aplikasi kanvas, halaman kustom dalam aplikasi berbasis model, alur, kode, atau dari fungsi lainnya.

Penting

  • Ini adalah fitur pratinjau.
  • Fitur pratinjau tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas yang dibatasi. Fitur ini tersedia sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan.

Memanggil fungsi dari aplikasi kanvas atau halaman khusus

  1. Dari area Fungsi di Power Apps (make.powerapps.com), pilih fungsi yang ingin Anda panggil dari aplikasi kanvas atau halaman khusus.
  2. Pilih Salin cuplikan kode pada bilah perintah.
  3. Tempel dan simpan rumus yang disalin ke editor teks, Notepad, atau tempat lain yang mudah Anda rujuk.
  4. Dalam Power Apps Studio:

    1. Buat atau edit aplikasi kanvas atau halaman khusus di Power Apps Studio.

    2. Di panel navigasi kiri, di bawah tab Sumber Data , pilih Tambahkan data, cari tabel Lingkungan dari konektor Dataverse, dan pilih.

      Note

      Jika tabel Lingkungan tidak tersedia untuk pilihan, buat aplikasi baru di lingkungan yang sama untuk memicu pembuatannya.

    3. Sisipkan komponen berikut ke kanvas:

      • Tambahkan kontrol input yang sesuai dengan setiap tipe data parameter, seperti input angka.
      • Tambahkan tombol untuk memanggil fungsi.
      • Tambahkan kontrol keluaran yang sesuai dengan tipe data parameter Anda, seperti input angka.
  5. Pilih tombol yang Anda buat, dan di properti OnSelect , masukkan fungsi Anda, seperti Environment.new_calculatesum.
  6. Petakan setiap parameter input Value untuk merujuk ke kontrol input yang sesuai:
    • Jika fungsi Anda adalah Environment.new_CalculateSum({ X: Value, Y: Value });, dapat ditulis ulang sebagai: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Untuk mengatur keluaran Fungsi 'hasil' Anda, perbarui rumus Anda menjadi 'Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))'.
  7. Pilih kontrol keluaran dan atur properti 'Nilai' dengan rumus 'result.z'.

Pratinjau aplikasi Anda, masukkan nilai input 1 dan 2, lalu pilih tombol. Hasilnya akan ditampilkan di kolom keluaran.

Memanggil fungsi dari aliran cloud Power Automate

  1. Dalam aliran awan, tambahkan tindakan baru dari Microsoft Dataverse konektor.
  2. Pilih tindakan yang disebut Lakukan tindakan yang tidak terikat
  3. Pilih fungsi Anda. Fungsi tersebut memiliki nama unik dengan awalan.
  4. Berikan nilai untuk semua parameter input (jika ada).

Memanggil fungsi dari Dataverse Web API

Ikuti langkah-langkah untuk bagian tindakan tidak terikat dalam artikel Memanggil API khusus dari Web API (tergantung pada cakupan plug-in yang sesuai).

Memanggil fungsi yang ada dari dalam fungsi baru

Untuk memanggil fungsi yang sudah ada di dalam fungsi baru, gunakan sintaks berikut: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Karena keluaran selalu berupa rekaman, gunakan notasi titik untuk mengakses parameter keluaran. Misalnya, jika fungsi "ExistingFunction" memiliki dua parameter output yang ditetapkan sebagai out1 dan out2, Anda dapat mengaksesnya dengan salah satu dari dua cara berikut:

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

Keterbatasan dengan fungsi di Dataverse

  • Objek bahasa lingkungan perlu ditambahkan kembali untuk mengakses fungsi baru di dalam aplikasi kanvas yang ada. Untuk fungsi apa pun yang dibuat setelah Anda menambahkan sumber data tabel lingkungan ke aplikasi kanvas yang ada, Anda harus menghapus dan menambahkan kembali Power Fx objek bahasa lingkungan. Kemudian Anda melihat daftar fungsi yang diperbarui sebagai tindakan.
  • Dukungan bertingkat. Fungsi hanya dapat memanggil tindakan Microsoft yang diterbitkan oleh Microsoft dari Power Fx ekspresi.
  • Beberapa Collect skenario memerlukan Patch. Ada beberapa skenario di mana Collect() tidak berfungsi. Solusinya adalah dengan menggunakan Patch() seperti yang ditunjukkan pada contoh pengisian kolom terkait di sini.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Debug dan dapatkan bantuan dengan fungsi Anda

Jika Anda mengalami masalah saat membuat atau menjalankan fungsi, gunakan trace() fungsi untuk debugging atau buka Keterbatasan pada fungsi di Dataverse untuk mengetahui masalah umum yang dapat terjadi.

Debugging menggunakan fungsi trace()

  1. Untuk men-debug menggunakan fungsi pelacakan, pastikan Anda mengaktifkan plug-in dan pelacakan aktivitas alur kerja kustom.
  2. Buka Power Apps (make.powerapps.com), pilih Pengaturan ikon roda gigi di kanan atas, lalu pilih Pengaturan lanjutan.
  3. Pilih Pengaturan > Audit > Pengaturan Audit Global.
  4. Pada tab Penyesuaian , pastikan bahwa Aktifkan pencatatan ke log jejak plug-in diaktifkan untuk Semua.

Setelah Anda mengaktifkan pelacakan, Anda dapat mulai menggunakan fungsi trace() untuk men-debug Power Fx rumus. Pelajari selengkapnya tentang cara menggunakan fungsi trace() di dalam Power Fx ekspresi: Fungsi trace - Power Platform.

Menghubungi bantuan + dukungan

Untuk masalah dengan fungsi yang tidak tercakup dalam Microsoft Dataverse tips plug-in kode rendah dan masalah yang diketahui, seperti kesalahan tidak terdokumentasi yang diterima, gunakan pengalaman Bantuan + dukungan dan sertakan informasi berikut:

  • Jenis Masalah- Dataverse Web API dan SDK.
  • Subtipe Masalah.

Fungsi contoh

Membuat dan menggunakan fungsi di Microsoft Dataverse

  • Last updated on