Cipta tindakan proses tersuai

Gunakan tindakan proses tersuai apabila anda mahu mengautomasikan siri perintah dalam sistem. Tindakan proses tersuai mengembangkan kosa kata yang tersedia untuk pembangun menerangkan proses perniagaan. Tindakan proses tersuai menggunakan kata kerja teras yang disediakan oleh sistem seperti Cipta, Kemas kini, Padam dan Tugaskan untuk mencipta kata kerja yang lebih ekspresif seperti Luluskan, Kemukakan, Halakan atau Jadualkan. Jika definisi proses perniagaan berubah, seseorang yang bukan pembangun boleh mengedit tindakan proses tersuai supaya kod tidak perlu ditukar.

Nota

Jika anda berhasrat untuk menulis pemalam untuk melaksanakan logik anda untuk tindakan proses tersuai dan bukannya menggunakan pereka bentuk aliran kerja, anda harus menggunakan API tersuai sebaliknya. Maklumat lanjut: Bandingkan Tindakan Proses Tersuai dan API tersuai

Cipta tindakan proses tersuai

Penting

Jika anda mencipta tindakan proses tersuai untuk dimasukkan sebagai sebahagian daripada penyelesaian yang akan diagihkan, cipta tindakan proses tersuai dalam konteks penyelesaian. Pergi ke Tetapan > Penyelesaian dan cari penyelesaian tidak terurus yang akan menjadi sebahagian daripada tindakan ini. Kemudian, dalam bar menu, pilih Baharu > Proses. Ini memastikan bahawa awalan penyesuaian yang berkaitan dengan nama tindakan akan konsisten dengan komponen lain dalam penyelesaian. Selepas anda mencipta tindakan tersebut, anda tidak boleh menukar awalan.

Seperti proses aliran kerja, tindakan proses tersuai mempunyai sifat berikut dalam kotak dialog Cipta Proses:

  • Nama proses

    Selepas anda memasukkan nama untuk proses, nama unik akan dibuat untuknya dengan mengeluarkan sebarang ruang atau aksara khas daripada nama proses.

  • Kategori

    Sifat ini menetapkan bahawa ini adalah satu proses tindakan. Anda tidak boleh mengubah ini setelah anda menyimpan proses.

  • Jadual

    Dengan proses tindakan, anda boleh memilih jadual untuk memberikan konteks untuk aliran kerja sama seperti lain-lain jenis proses, tetapi anda juga mempunyai pilihan untuk memilih Tiada (global). Gunakan pilihan ini jika tindakan anda tidak memerlukan konteks jadual tertentu. Anda tidak boleh mengubah ini setelah anda menyimpan proses.

  • Jenis

    Gunakan sifat ini untuk memilih sama ada untuk membina tindakan proses tersuai baharu daripada mula atau bermula daripada templat yang sedia ada.

Berbeza dengan proses aliran kerja, anda tidak perlu menetapkan pilihan yang berikut:

  • Mula Apabila: Tindakan bermula apabila kod panggilan mesej dijana untuknya.

  • Skop: Tindakan-tindakan sentiasa berjalan dalam konteks pengguna panggilan.

  • Berjalan pada latar belakang: Tindakan akan sentiasa aliran-kerja masa nyata.

Tindakan proses tersuai juga mempunyai sesuatu yang proses aliran kerja tidak ada—argumen input dan output.

Nota

Anda boleh mendayakan tindakan proses tersuai daripada aliran kerja tanpa menulis kod. Maklumat lanjut: Panggil tindakan proses tersuai daripada aliran kerja

Edit tindakan proses tersuai

Anda mesti menyahaktifkan tindakan proses tersuai sebelum anda boleh mengedit mereka.

Anda boleh mengedit tindakan proses tersuai yang dicipta sebagai sebahagian daripada penyelesaian tidak terurus atau dimasukkan ke dalam penyelesaian yang dipasang dalam organisasi anda. Jika penyelesaian ialah penyelesaian terurus, anda mungkin tidak dapat mengeditnya. Penerbit penyelesaian mempunyai pilihan untuk mengedit sifat diuruskan supaya tindakan yang dipasang dengan penyelesaian yang terurus tidak boleh diedit.

Bila tindakan disimpan nama unik dihasilkan berdasarkan kepada nama proses. Nama unik ini mempunyai tetapan awalan penyesuaian yang ditambah dari penerbit penyelesaian. Ini adalah nama mesej yang pereka akan gunakan dalam kod mereka.

Apabila mengedit tindakan, anda mempunyai pilihan berikut:

  • Nama proses

    Setelah proses dicipta dan nama unik dihasilkan daripada nama proses, anda boleh mengedit nama proses tersebut. Anda mungkin perlu menggunakan konvensyen penamaan untuk memudahkan anda mengesan proses tertentu.

  • Nama unik

    Bila tindakan disimpan nama unik dihasilkan berdasarkan kepada nama proses. Nama unik ini mempunyai tetapan awalan penyesuaian dari penerbit penyelesaian yang ditambah. Ini adalah nama mesej yang pereka akan gunakan dalam kod mereka. Jangan tukar nama unik ini jika proses telah diaktifkan dan kod ditempatkan, dengan harapan untuk memanggil tindakan menggunakan nama ini.

    Penting

    Selepas tindakan diaktifkan dan kod ditulis untuk menggunakan nama yang unik, nama unik tersebut tidak harus diubah tanpa menukar kod yang merujuknya juga.

  • Bolehkan undur

    Secara umum, proses yang menyokong urus niaga akan "buat asal" itu (atau gulung balik) keseluruhan operasi jika mana-mana bahagiannya gagal. Terdapat beberapa pengecualian kepada ini. Sesetengah tindakan pembangun yang mungkin dilakukan dalam kod dimulakan oleh tindakan proses tersuai mungkin tidak menyokong urus niaga. Contohnya, jika kod menjalankan tindakan dalam sistem-sistem lain yang di luar skop transaksi. Ia tidak dapat diundurkan oleh tindakan yang sedang berjalan dalam aplikasi . Sesetengah mesej dalam platform tidak menyokong urus niaga. Tetapi segala-galanya anda boleh lakukan hanya dengan antara muka pengguna tindakan akan menyokong urus niaga. Semua tindakan yang merupakan sebahagian daripada aliran masa nyata dipertimbangkan dalam urus niaga, tetapi dengan tindakan anda mempunyai pilihan untuk memilih keluar daripadanya.

    Anda harus berunding dengan pemaju yang akan menggunakan mesej ini untuk menentukan sama ada ia mestilah dalam transaksi atau tidak. Secara umum, tindakan harus dalam urus niaga jika tindakan-tindakan dilakukan oleh proses perniagaan tidak masuk akal melainkan mereka semua berjaya dilengkapkan. Contoh klasik ialah memindahkan dana antara dua akaun bank. Jika anda mengeluarkan wang dari satu akaun anda mesti mendepositkan dalam yang lain. Jika salah satu gagal, kedua-duanya mesti gagal.

    Nota

    Anda tidak boleh mendayakan gulung balik jika tindakan proses tersuai dipanggil secara langsung dari dalam aliran kerja. Anda boleh mengaktifkan undur jika tindakan dicetuskan oleh mesej perkhidmatan web Power Apps.

  • Aktifkan sebagai

    Seperti semua proses, anda boleh mengaktifkan proses sebagai templat dan menggunakannya sebagai titik permulaan lanjutan untuk proses-proses yang mengikuti pola yang sama.

  • Tentukan argumen proses

    Dalam ruang ini, anda akan menentukan mana-mana data yang tindakannya dijangka akan mula dan data yang akan dihantar keluar daripada tindakan itu. Maklumat lanjut: Takrifkan argumen proses

  • Tambah peringkat dan langkah

    Seperti proses-proses lain, anda menentukan tindakan apa untuk dilaksanakan dan bila untuk melaksanakannya. Maklumat lanjut: Tambah peringkat dan langkah

Tentukan argumen proses

Apabila pembangun menggunakan mesej, mereka mungkin bermula dengan beberapa data yang mereka boleh hantar ke dalam mesej. Contohnya, untuk mencipta baris kes baharu, mungkin terdapat nilai tajuk kes yang akan dihantar masuk sebagai argumen input.

Apabila mesej telah selesai, pembangun mungkin perlu menghantari beberapa data yang ditukar atau dijana oleh mesej ke operasi lain dalam kodnya. Data ini ialah argumen output.

Kedua-dua hujah input dan output mesti mempunyai nama, jenis, dan sedikit maklumat mengenai sama ada hujah sentiasa diperlukan. Anda juga boleh memberikan penerangan.

Nama mesej dan maklumat tentang semua hujah proses mewakili tandatangan untuk mesej. Selepas tindakan proses tersuai diaktifkan dan digunakan dalam kod, tandatangan tidak boleh berubah. Jika tandatangan ini berubah, sebarang kod yang menggunakan mesej akan gagal. Satu-satunya pengecualian baginya mungkin adalah menukar salah satu parameter supaya ia tidak sentiasa diperlukan.

Anda boleh mengubah urutan argumen dengan mengisihnya atau mengalihkannya ke atas atau ke bawah kerana argumen dikenal pasti melalui nama, bukan mengikut urutan. Mengubah perihalan juga tidak akan melanggar kod yang menggunakan mesej.

Jenis-jenis hujah proses tindakan

Jadual berikut menerangkan jenis-jenis hujah proses tindakan.

Jenis Perihalan
Boolean Nilai true atau false .
DateTime Nilai yang menyimpan maklumat tarikh dan masa.
Perpuluhan Nilai nombor dengan kejituan perpuluhan Digunakan apabila ketepatan adalah amat penting.
Jadual Baris untuk jadual yang ditentukan. Apabila anda memilih jadual, senarai juntai bawah didayakan dan membolehkan anda untuk memilih jenis jadual.
entityCollection Koleksi baris jadual.
entityReference Objek yang mengandungi nama, ID dan jenis baris jadual yang mengenal pasti secara unik. Apabila anda memilih entityReference, senarai juntai bawah didayakan dan membolehkan anda untuk memilih jenis jadual.
Float Nilai nombor dengan kejituan perpuluhan Digunakan apabila data datang dari pengukuran yang tidak benar-benar tepat.
Integer Nombor bulat.
Wang Nilai yang menyimpan data tentang jumlah wang.
Senarai Pilihan Nilai yang mewakili pilihan untuk atribut OptionSet.
Jalur Nilai teks.

Nota

entityCollection nilai argumen tidak dapat ditetapkan dalam antara muka pengguna untuk syarat atau tindakan. Ini disediakan untuk kegunaan pereka dalam kod khusus. Maklumat lanjut: Cipta mesej anda sendiri

Tambah peringkat dan langkah

Tindakan proses tersuai adalah jenis proses yang serupa dengan aliran kerja masa nyata. Semua langkah yang boleh digunakan dalam aliran kerja masa nyata boleh digunakan dalam tindakan. Untuk mendapatkan maklumat tentang langkah yang boleh digunakan untuk kedua-dua aliran kerja dan tindakan masa sebenar, lihat Peringkat dan langkah aliran kerja.

Selain daripada langkah yang boleh digunakan untuk aliran kerja masa sebenar, tindakan juga mempunyai langkah Peruntukkan Nilai. Dalam tindakan, ini boleh digunakan hanya untuk menetapkan argumen output. Anda boleh menggunakan pembantu borang untuk menetapkan argumen output kepada nilai tertentu atau, lebih berkemungkinan, kepada nilai daripada baris yang tindakan sedang berjalan, baris yang berkaitan dengan baris tersebut dengan perhubungan banyak ke satu, baris dicipta dalam langkah awal atau nilai yang merupakan sebahagian daripada proses itu sendiri.

Sifat terurus

Tindakan proses tersuai mempunyai dua sifat terurus yang berkaitan

Boleh Disesuaikan

Sifat terurus Boleh Disesuaikan mengawal sama ada seseorang yang memasang penyelesaian terurus mengandungi tindakan proses tersuai tidak boleh mengedit atau menghapuskannya. Jika mahu untuk tindakan proses tersuai diedit atau dipadam apabila disertakan dalam penyelesaian terurus, anda hendaklah menetapkan sifat ini ke benar.

Adakah Langkah Pemprosesan Tersuai Dibenarkan untuk Penerbit Lain

Sifat terurus Adakah Langkah Pemprosesan Tersuai Dibenarkan untuk Penerbit Lain mengawal sama ada pihak ketiga pembangun pasang masuk boleh mendaftarkan langkah pasang masuk pada mesej yang dicipta oleh tindakan proses tersuai. Apabila ini benar, pasang masuk yang didaftarkan oleh sesiapa pada mesej ini akan berjalan dan boleh mengubah suai tingkah laku tindakan proses tersuai. Apabila palsu, hanya langkah pasang masuk yang berdaftar dalam penyelesaian daripada penerbit penyelesaian yang sama akan berjalan.

Langkah seterusnya

Panggil tindakan proses tersuai daripada aliran kerja

Nota

Adakah anda boleh memberitahu kami tentang keutamaan bahasa dokumentasi anda? Jawab tinjauan pendek. (harap maklum bahawa tinjauan ini dalam bahasa Inggeris)

Tinjauan akan mengambil masa lebih kurang tujuh minit. Tiada data peribadi akan dikumpulkan (pernyataan privasi).