Membuat tindakan proses kustom

Gunakan tindakan proses kustom bila Anda ingin mengotomatisasi serangkaian perintah dalam sistem. Tindakan proses kustom menambah kosakata yang tersedia untuk pengembang agar dapat mengekspresikan proses bisnis. Tindakan proses kustom menggunakan kata kerja inti yang disediakan sistem, seperti Buat, Perbarui, Hapus, dan Tetapkan, untuk membuat kata kerja yang lebih ekspresif seperti Setujui, Eskalasikan, Rutekan, atau Jadwalkan. Jika definisi proses bisnis berubah, seseorang yang bukan pengembang dapat mengedit Tindakan proses kustom sehingga kode tidak perlu diubah.

Catatan

Jika Anda bermaksud menulis plug-in untuk menerapkan logika Anda untuk tindakan proses kustom alih-alih menggunakan desainer alur kerja, Anda harus menggunakan API kustom sebagai gantinya. Informasi selengkapnya: Membandingkan Tindakan Proses Kustom dan API kustom

Membuat tindakan proses kustom

Penting

Jika Anda membuat tindakan proses kustom untuk disertakan sebagai bagian dari solusi yang akan didistribusikan, buat tindakan dalam konteks solusi. Buka Pengaturan > Solusi, lalu temukan solusi tidak terkelola yang akan menjadi bagian dari tindakan ini. Setelah itu, dalam panel menu, pilih Baru > Proses. Hal ini memastikan bahwa awalan penyesuaian yang terkait dengan nama tindakan akan konsisten dengan komponen lain dalam solusi tersebut. Setelah tindakan dibuat, Anda tidak dapat mengubah awalan.

Seperti proses alur kerja, tindakan proses kustom memiliki properti berikut dalam kotak dialog Buat Proses:

• Nama proses

  Setelah Anda memasukkan nama untuk proses, nama unik akan dibuat untuk proses dengan menghapus spasi atau karakter khusus dari nama proses.

• Kategori

  Properti ini menetapkan bahwa ini adalah proses tindakan. Anda tidak dapat mengubahnya setelah proses disimpan.

• Tabel

  Dengan proses tindakan, Anda dapat memilih tabel untuk memberikan konteks bagi alur kerja sama seperti jenis proses lainnya, namun Anda juga memiliki pilihan untuk memilih Tidak Ada (global). Gunakan pilihan ini jika tindakan Anda tidak memerlukan konteks tabel tertentu. Anda tidak dapat mengubahnya setelah proses disimpan.

• Jenis

  Gunakan properti ini untuk memilih apakah Anda akan membuat tindakan proses kustom baru dari awal atau memulainya dari template yang ada.

Berbeda dengan proses alur kerja, Anda tidak perlu mengatur pilihan berikut:

• Mulai Saat: Tindakan dimulai saat kode memanggil pesan yang dibuat.

• Cakupan: Tindakan selalu berjalan dalam konteks menghubungi pengguna.

• Berjalan di latar belakang: Tindakan selalu memiliki alur kerja real-time.

Tindakan proses kustom ini juga memiliki sesuatu yang tidak dimiliki proses alur kerja—argumen input dan output.

Catatan

Anda dapat mengaktifkan tindakan proses kustom dari alur kerja, tanpa menulis kode. Informasi lebih lanjut: Memicu tindakan proses kustom dari alur kerja

Mengedit tindakan proses kustom

Anda harus menonaktifkan tindakan proses kustom agar dapat mengeditnya.

Anda dapat mengedit tindakan proses kustom yang dibuat sebagai bagian dari solusi tidak terkelola atau termasuk dalam solusi yang diinstal di organisasi Anda. Jika solusi tersebut adalah solusi yang terkelola, Anda mungkin tidak dapat mengeditnya. Penerbit solusi memiliki pilihan untuk mengedit properti terkelola sehingga tindakan yang diinstal dengan solusi terkelola tidak dapat diedit.

Bila tindakan disimpan, nama unik akan dihasilkan berdasarkan nama proses. Nama unik ini memiliki awalan penyesuaian yang ditambahkan dari penerbit solusi. Ini adalah nama pesan yang akan digunakan oleh pengembang dalam kode mereka.

Saat mengedit tindakan, Anda memiliki pilihan berikut:

• Nama proses

  Setelah proses dibuat dan nama unik yang dihasilkan dari nama proses tersebut, Anda dapat mengedit nama proses. Anda mungkin ingin menerapkan konvensi penamaan untuk mempermudah pencarian proses tertentu.

• Nama unik

  Bila tindakan disimpan, nama unik akan dihasilkan berdasarkan nama proses. Nama unik ini memiliki tambahan awalan penyesuaian dari penerbit solusi. Ini adalah nama pesan yang akan digunakan oleh pengembang dalam kode mereka. Jangan ubah nama unik ini jika proses telah diaktifkan dan kode telah dimasukkan yang akan digunakan untuk menjalankan tindakan menggunakan nama ini.

  Penting

  Setelah tindakan diaktifkan dan kode yang tertulis menggunakan nama unik, maka nama unik tersebut tidak boleh diubah juga tanpa mengubah kode referensinya.

• Aktifkan pemutaran kembali

  Secara umum, proses yang mendukung transaksi akan "membatalkan" (atau diputar kembali) seluruh operasi jika setiap bagian gagal. Ada beberapa pengecualian untuk proses ini. Tindakan tertentu yang mungkin dilakukan pengembang dalam kode yang dimulai oleh tindakan proses kustom mungkin tidak mendukung transaksi. Misalnya, jika kode melakukan tindakan di sistem lainnya yang berada di luar cakupan transaksi. Proses ini tidak dapat diputar kembali saat tindakan berjalan di aplikasi. Beberapa pesan di platform tidak mendukung transaksi. Tetapi segala hal yang dapat Anda lakukan hanya dengan antarmuka pengguna tindakan akan mendukung transaksi. Semua tindakan yang merupakan bagian dari alur kerja real-time dipertimbangkan dalam transaksi, namun dengan tindakan Anda memiliki pilihan untuk memilih keluar dari proses ini.

  Hubungi pengembang yang akan menggunakan pesan ini untuk menentukan apakah pesan harus berada dalam transaksi atau tidak. Umumnya, tindakan harus berada dalam transaksi jika tindakan yang dilakukan oleh proses bisnis tidak masuk akal, kecuali jika semuanya berhasil diselesaikan. Contoh umumnya adalah mentransfer dana antara dua rekening bank. Jika Anda menarik dana dari satu akun, Anda harus memasukkannya ke rekening lain. Jika salah satu gagal, keduanya pasti gagal.

  Catatan

  Anda tidak dapat mengaktifkan rollback jika tindakan proses kustom dipanggil langsung dari dalam alur kerja. Anda dapat mengaktifkan rollback jika tindakan dipicu oleh pesan layanan web Power Apps.

• Aktifkan sebagai

  Seperti semua proses, Anda dapat mengaktifkan proses sebagai template dan menggunakannya sebagai titik awal lanjutan untuk proses yang mengikuti pola yang sama.

• Menentukan argumen proses

  Di area ini, Anda akan menentukan data apa pun yang akan dimulai oleh tindakan dan data yang akan dilewati tindakan. Informasi selengkapnya: menentukan argumen proses

• Menambahkan tahap dan langkah

  Sama seperti proses lainnya, Anda menentukan tindakan apa yang akan dilakukan serta waktunya. Informasi lebih lanjut: Tambahkan Tahap dan langkah

Menentukan argumen proses

Bila pengembang menggunakan pesan, mereka mungkin mulai dengan beberapa data yang dapat dimasukkan ke pesan. Misalnya, untuk membuat baris kasus baru, mungkin ada nilai judul kasus yang lolos sebagai argumen input.

Bila pesan selesai, pengembang mungkin harus memberikan beberapa data yang berubah atau dihasilkan oleh pesan operasi lain dalam kode mereka. Data ini adalah argumen output.

Argumen input dan output harus memiliki nama, jenis, dan beberapa informasi tentang apakah argumen selalu diperlukan. Anda juga dapat memberikan deskripsi.

Nama pesan dan informasi tentang semua argumen proses mewakili tanda tangan untuk pesan. Setelah tindakan proses kustom diaktifkan dan digunakan dalam kode, tanda tangan tidak boleh berubah. Ji tanda tangan ini berubah, semua kode yang menggunakan pesan tersebut akan gagal. Satu-satunya pengecualian untuk hal ini adalah mengubah salah satu parameter sehingga hal ini tidak selalu diperlukan.

Anda dapat mengubah urutan argumen dengan mengurutkan atau memindahkannya ke atas atau bawah karena argumen diidentifikasikan menurut nama, bukan urutan. Mengubah deskripsi juga tidak akan membuka kode menggunakan pesan.

Jenis argumen proses tindakan

Tabel berikut menjelaskan jenis argumen proses tindakan.

Jenis	KETERANGAN
Boolean	Nilai true atau false.
Datetime	Nilai yang menyimpan informasi tanggal dan waktu.
Desimal	Nilai angka dengan presisi desimal. Digunakan bila presisi sangat penting.
Tabel	Baris untuk tabel yang ditentukan. Bila Anda memilih tabel, daftar drop-down akan diaktifkan dan Anda dapat memilih jenis tabel.
entityCollection	Berisi kumpulan baris tabel.
entityReference	Objek yang berisi nama, ID, dan jenis baris tabel unik yang mengidentifikasinya. Bila Anda memilih entityReference, daftar drop-down akan diaktifkan dan Anda dapat memilih jenis tabel.
Float	Nilai angka dengan presisi desimal. Digunakan bila data berasal dari pengukuran yang tidak tepat.
Integer	Bilangan bulat.
Uang	Nilai yang menyimpan data tentang jumlah uang.
Daftar pilihan	Nilai yang mewakili pilihan untuk atribut OptionSet.
String	Nilai teks.

Catatan

Nilai argumen entityCollection tidak dapat ditetapkan dalam antarmuka pengguna untuk kondisi atau tindakan. Nilai argumen tersebut disediakan untuk digunakan oleh pengembang dalam kode kustom. Informasi selengkapnya: Membuat pesan Anda sendiri

Menambahkan tahap dan langkah

Tindakan proses kustom adalah jenis proses yang sangat mirip dengan alur kerja real-time. Semua langkah yang dapat digunakan dalam alur kerja real-time dapat digunakan dalam tindakan. Untuk informasi tentang langkah-langkah yang dapat digunakan untuk alur kerja dan tindakan real-time, lihat Tahapan dan langkah alur kerja.

Selain langkah-langkah yang dapat digunakan untuk alur kerja real-time, tindakan juga memiliki langkah menetapkan nilai. Dalam tindakan, langkah dapat digunakan hanya untuk mengatur argumen output. Anda dapat menggunakan asisten formulir untuk mengatur argumen output ke nilai tertentu atau, kemungkinan besar, ke nilai dari baris tempat tindakan dijalankan, baris yang terkait dengan baris itu dengan relasi banyak-ke-satu, baris yang dibuat di langkah sebelumnya , atau nilai yang merupakan bagian dari proses itu sendiri.

Properti terkelola

Tindakan proses kustom memiliki dua properti terkelola yang relevan

Dapat Disesuaikan

Kontrol properti terkelola Is Customizable mengontrol apakah seseorang yang menginstal solusi terkelola berisi tindakan proses kustom dapat mengedit atau menghapusnya. Jika ingin tindakan proses kustom diedit atau dihapus bila tercakup dalam solusi terkelola, Anda harus menetapkan properti ini ke benar.

Adalah Langkah Pemrosesan Kustom yang Diizinkan Untuk Penerbit Lain

Properti terkelola Adalah Langkah Pemrosesan Kustom yang Diizinkan untuk Penerbit Lain mengontrol apakah pengembang plug-in pihak ketiga dapat mendaftarkan langkah plug-in pada pesan yang dibuat oleh tindakan proses kustom. Bila ini benar, plug-in yang didaftarkan oleh siapa pun pada pesan ini akan berjalan dan dapat memodifikasi perilaku tindakan proses kustom. Bila salah, hanya langkah plug-in yang terdaftar dalam solusi dari penerbit solusi yang sama yang akan dijalankan.

Langkah berikutnya

Picu tindakan proses kustom dari alur kerja

Catatan

Apa bahasa dokumentasi yang Anda inginkan? Lakukan survei singkat. (perlu diketahui bahwa survei ini dalam bahasa Inggris)

Survei akan berlangsung kurang lebih selama tujuh menit. Tidak ada data pribadi yang dikumpulkan (pernyataan privasi).