Tugas persetujuan

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:

  1. Di UI Apigee, pilih Organisasi Apigee Anda.
  2. Klik Develop > Integrasi.
  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 tugas Persetujuan panel konfigurasi.
  7. 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 isApproved ditetapkan ke True jika penangguhan disetujui dan ditetapkan ke False jika penangguhan akan ditolak.

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.