Tugas Persetujuan memungkinkan Anda mengonfigurasi integrasi berbasis persetujuan. Hal ini juga memungkinkan Anda mengontrol alur integrasi.
Anda dapat menggunakan tugas Approval untuk mengirim email permintaan persetujuan kepada satu atau beberapa pengguna integrasi. Email tersebut menyertakan link ke integrasi yang memungkinkan pengguna menyetujui atau menolak permintaan secara manual.
Selama eksekusi integrasi, saat kontrol mencapai tugas Approval, eksekusi akan dihentikan, dan semua tugas setelah tugas Approval ditangguhkan. Integrasi akan melanjutkan eksekusi hanya jika pengguna menyetujui atau menolak permintaan persetujuan secara manual.
Tugas Approval dapat digunakan untuk tujuan berikut:
- Untuk menangguhkan dan mencabangkan integrasi berdasarkan persetujuan atau penolakan pengguna.
- Untuk menangguhkan integrasi hingga durasi yang ditentukan.
- Untuk digunakan sebagai titik henti sementara guna men-debug integrasi.
Membandingkan tugas Persetujuan, tugas Suspend, dan tugas Timer
Ketiganya (Persetujuan, Tangguhkan, dan Timer) menjalankan tugas menjeda dan melanjutkan integrasi. Namun, ada perbedaan kecil di antara mereka. Tabel berikut menjelaskan perbedaan antara ketiga tugas tersebut.
Tugas persetujuan | Tugas penangguhan | Tugas timer |
---|---|---|
Tidak mendukung melanjutkan otomatis integrasi dan memerlukan secara manual untuk melanjutkan integrasi. | Mendukung melanjutkan integrasi secara manual dan otomatis. Jika tidak ada secara manual untuk mencabut penangguhan, integrasi akan melanjutkan eksekusi setelah batas waktu penangguhan berakhir. | Hanya mendukung melanjutkan integrasi secara otomatis. Eksekusi integrasi otomatis dilanjutkan setelah batas waktu penangguhan berakhir. |
Tidak dapat melanjutkan integrasi melalui panggilan API. Anda harus me-resolve secara manual penangguhan pembayaran menggunakan UI Integrasi. | Dapat melanjutkan integrasi menggunakan Suspensions API untuk integrasi. |
Hanya mendukung melanjutkan integrasi secara otomatis. |
Pengguna menerima notifikasi saat integrasi dijeda (ditangguhkan). | Pengguna tidak menerima notifikasi apa pun saat integrasi dijeda (ditangguhkan). | Pengguna tidak menerima notifikasi apa pun saat integrasi dijeda (ditangguhkan). |
Mendukung variabel output (boolean), yang memungkinkan Anda melakukan pemeriksaan bersyarat
sebelum melanjutkan integrasi. Namun, variabel {i>output<i} hanya dapat memiliki
nilainya sebagai true atau false . |
Mendukung variabel output (string), yang memungkinkan Anda melakukan pemeriksaan kondisional sebelum melanjutkan integrasi. Anda dapat menetapkan nilai apa pun ke variabel output. | Tidak mendukung variabel output apa pun. |
Mengonfigurasi tugas Persetujuan
Untuk mengonfigurasi tugas Approval:
- Di UI Apigee, pilih Organisasi Apigee Anda.
- Klik Develop > Integrasi.
- Pilih integrasi yang ada atau buat integrasi baru dengan mengklik Buat Integrasi.
Jika Anda membuat integrasi baru:
- Masukkan nama dan deskripsi dalam dialog Create Integration.
- Pilih Region untuk integrasi dari daftar wilayah yang didukung.
- Klik Create.
Tindakan ini akan membuka integrasi di desainer integrasi.
- Di menu navigasi desainer integrasi, klik +Tambahkan tugas/pemicu > Tasks untuk melihat daftar tugas yang tersedia.
- Klik dan tempatkan elemen tugas Approval di editor integrasi.
- Klik elemen tugas Approval pada desainer untuk melihat tugas Persetujuan panel konfigurasi.
- Konfigurasikan kolom yang ditampilkan menggunakan Properti konfigurasi untuk tugas
seperti dijelaskan dalam tabel di bawah ini.
Semua perubahan pada properti disimpan secara otomatis.
Properti konfigurasi
Tabel berikut menjelaskan properti konfigurasi dari tugas Approval.
Properti | Data type | Deskripsi |
Recipients
|
Array String | Alamat email yang akan dikirimi notifikasi saat tugas ditangguhkan. Masukkan beberapa alamat email yang dipisahkan oleh koma. |
Custom notification message
|
String | Pesan khusus yang akan disertakan dalam notifikasi email saat tugas ditangguhkan. Nilainya
dapat berupa literal atau variabel. Jika pesan khusus tersedia dalam variabel,
klik VAR , lalu pilih variabel.
|
Reminder frequency (in hours)
|
Bilangan bulat | Frekuensi notifikasi pengingat.
Jika penangguhan masih dalam status belum terselesaikan, Anda dapat mengirim notifikasi email pengingat yang meminta pengguna yang diberi otorisasi untuk menyelesaikan penangguhan. |
Time until expiration (in hours)
|
Bilangan bulat | Jangka waktu penangguhan.
Jika penangguhan tidak diselesaikan dalam waktu tersebut, penangguhan akan ditolak secara default. |
On expiration
|
Boolean | Tindakan yang akan diambil setelah penangguhan berakhir.
Anda dapat memilih untuk menolak penangguhan atau mencabut penangguhan. Secara default, penangguhan ditolak. |
isApproved (Approval)
|
Boolean | Variabel output yang memiliki status penangguhan setelah resolusi.
Variabel |
Strategi penanganan error
Strategi penanganan error untuk tugas menentukan tindakan yang akan diambil jika tugas gagal karena error sementara. Untuk informasi tentang cara menggunakan strategi penanganan error, dan mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.