Tugas persetujuan

Tugas Persetujuan memungkinkan Anda mengonfigurasi integrasi berbasis persetujuan. Hal ini juga memungkinkan Anda mengontrol alur integrasi.

Anda dapat menggunakan tugas Persetujuan untuk mengirim email permintaan persetujuan kepada satu atau beberapa pengguna integrasi. Email tersebut menyertakan link ke integrasi tempat pengguna dapat 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 Persetujuan 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, Menangguhkan tugas, dan tugas Timer

Ketiga tugas (Persetujuan, Penangguhan, dan Timer) tersebut memiliki fungsi yang serupa untuk menjeda dan melanjutkan integrasi. Namun, ada perbedaan kecil di antara keduanya. Tabel berikut menjelaskan perbedaan di antara ketiga tugas tersebut.

Tugas persetujuan Tugas penangguhan Tugas timer
Tidak mendukung dimulainya kembali integrasi secara otomatis dan memerlukan intervensi manual untuk melanjutkan integrasi. Mendukung kelanjutan integrasi secara manual dan otomatis. Jika tidak ada intervensi manual untuk mencabut penangguhan, integrasi akan otomatis melanjutkan eksekusi setelah batas waktu penangguhan berakhir. Hanya mendukung kelanjutan integrasi secara otomatis. Eksekusi integrasi akan otomatis dilanjutkan setelah batas waktu penangguhan berakhir.
Tidak dapat melanjutkan integrasi melalui panggilan API. Anda harus menyelesaikan penangguhan secara manual menggunakan UI Integrasi. Dapat melanjutkan integrasi dengan menggunakan Suspensions API untuk integrasi. Hanya mendukung kelanjutan 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 kondisional sebelum melanjutkan integrasi. Namun, variabel output hanya dapat memiliki nilai 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 Persetujuan:

  1. Di UI Apigee, pilih Organisasi Apigee.
  2. Klik Develop > Integrations.
  3. Pilih integrasi yang ada atau buat integrasi baru dengan mengklik Buat Integrasi.

    Jika Anda membuat integrasi baru:

    1. Masukkan nama dan deskripsi dalam dialog Create Integration.
    2. Pilih Region untuk integrasi dari daftar wilayah yang didukung.
    3. Klik Create.

    Tindakan ini akan membuka integrasi di desainer integrasi.

  4. Di menu navigasi desainer integrasi, klik +Tambahkan tugas/pemicu > Tasks untuk melihat daftar tugas yang tersedia.
  5. Klik dan tempatkan elemen tugas Approval di editor integrasi.
  6. Klik elemen tugas Approval pada desainer untuk melihat panel konfigurasi tugas Persetujuan.
  7. Konfigurasikan kolom yang ditampilkan menggunakan Properti konfigurasi untuk tugas seperti yang dijelaskan pada tabel di bawah.

    Semua perubahan pada properti disimpan secara otomatis.

Properti konfigurasi

Tabel berikut menjelaskan properti konfigurasi tugas Persetujuan.

Properti Data type Deskripsi
Recipients Array String Alamat email yang akan dikirimi notifikasi saat tugas ditangguhkan. Masukkan beberapa alamat email dengan dipisahkan koma.
Custom notification message String Pesan kustom yang akan disertakan dalam notifikasi email saat tugas ditangguhkan. Nilainya dapat berupa literal atau variabel. Jika pesan kustom tersedia dalam variabel, klik VAR, lalu pilih variabel.
Reminder frequency (in hours) Bilangan bulat Frekuensi notifikasi pengingat.

Jika penangguhan berada dalam status belum terselesaikan, Anda dapat mengirimkan 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 yang ditentukan, penangguhan akan ditolak secara default.

On expiration Boolean Tindakan yang harus 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 isApproved disetel ke True jika penangguhan disetujui, dan disetel ke False jika penangguhan ditolak.

Strategi penanganan error

Strategi penanganan error untuk tugas menentukan tindakan yang akan diambil jika tugas gagal karena error sementara. Untuk mendapatkan informasi tentang cara menggunakan strategi penanganan error, dan mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.