Lihat konektor yang didukung untuk Application Integration.
Menangguhkan tugas
Dengan tugas Suspend, Anda dapat menjeda sementara waktu lalu melanjutkan eksekusi integrasi.
Selama eksekusi integrasi, saat kontrol mencapai tugas Suspend, eksekusi akan dihentikan, dan semua tugas setelah tugas Suspend ditangguhkan. Integrasi akan melanjutkan eksekusi jika salah satu peristiwa berikut terjadi:
- Berakhirnya waktu penangguhan yang ditentukan.
- Setelah menerima permintaan eksekusi lanjutkan dari
Suspensions
API.
Anda juga dapat mengonfigurasi variabel output (Hasil penangguhan) untuk tugas Suspend dan menetapkannya ke nilai apa pun serta menggunakan nilai tersebut untuk membuat kondisi percabangan guna menjalankan tugas downstream.
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 | Menangguhkan tugas | 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 Suspend
Untuk mengonfigurasi tugas Suspend, lakukan langkah-langkah berikut:
- Di konsol Google Cloud, buka halaman Application Integration.
- Di menu navigasi, klik Integrasi.
Halaman Integrations akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.
- Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.
Jika Anda membuat integrasi baru:
- Masukkan nama dan deskripsi di panel Create Integration.
- Pilih region untuk integrasi.
- Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration summary di toolbar integrasi.
- Klik Create.
Tindakan ini akan membuka integrasi di editor integrasi.
- Di menu navigasi editor integrasi, klik Tasks untuk melihat daftar tugas yang tersedia.
- Klik dan tempatkan elemen tugas Suspend di editor integrasi.
- Klik elemen tugas Suspend pada desainer untuk melihat panel konfigurasi tugas Suspend.
- Konfigurasikan kolom yang tersisa menggunakan Properti konfigurasi untuk tugas
seperti yang dijelaskan dalam tabel di bawah.
Semua perubahan pada properti disimpan secara otomatis.
Properti konfigurasi
Tabel berikut menjelaskan properti konfigurasi tugas Suspend.
Properti | Data type | Deskripsi |
Suspension Time
|
Bilangan bulat | Waktu (dalam menit) hingga eksekusi integrasi harus ditangguhkan. Batas waktu
maksimum adalah 44640 menit (31 hari) yang juga merupakan nilai default.
Jika eksekusi integrasi tidak dilanjutkan dalam batas waktu yang ditentukan,
integrasi akan otomatis melanjutkan eksekusi setelah batas waktu habis dan
menetapkan nilai variabel |
Suspension result
|
String | Variabel untuk menyimpan hasil tugas Suspend. Menetapkan nilai ke variabel ini bersifat opsional. Anda dapat menetapkan variabel ini ke nilai apa pun berdasarkan persyaratan Anda. Variabel ini berguna jika Anda ingin memiliki kontrol lebih besar atas alur eksekusi integrasi. Misalnya, Anda dapat membaca hasil penangguhan dan mengonfigurasi keputusan kondisional berdasarkan nilai dalam tugas downstream mana pun. |
Suspension Id
|
String | ID unik untuk tugas Suspend. Nilai variabel ini ditetapkan segera setelah integrasi ditangguhkan. Anda bisa mendapatkan nilai ID dari halaman eksekusi log di UI integrasi. Anda juga bisa mendapatkan nilai ID dari objek respons API jika menggunakan API untuk memicu integrasi.
Anda dapat melanjutkan eksekusi integrasi menggunakan ID penangguhan atau dengan ID eksekusi integrasi. |
Mencabut penangguhan dengan Penangguhan API
Penangguhan API memungkinkan Anda mencabut penangguhan melalui panggilan API. Untuk mencabut penangguhan dengan
Penangguhans API, Anda harus memiliki ID eksekusi integrasi atau
ID penangguhan tugas Suspend. Untuk mencabut penangguhan, Anda
harus mengeluarkan permintaan POST
ke API berikut:
https://REGION-integrations.googleapis.com/v1/{name=projects/PROJECT/locations/LOCATION/integrations/INTEGRATION_ID/executions/EXECUTION_ID/suspensions/SUSPENSION_ID}:lift
Dalam API ini, INTEGRATION_ID
bersifat opsional. Namun, Anda harus menyediakan
EXECUTION_ID
atau SUSPENSION_ID
. Jika Anda tidak memiliki nilai ID, Anda dapat mengganti nilai ini dengan -
. Dalam API ini, REGION
, PROJECT
, dan LOCATION
adalah kolom yang wajib diisi.
Setelah Anda mencabut penangguhan, eksekusi integrasi akan dilanjutkan dan menjalankan tugas downstream setelah tugas Suspend.
Contoh berikut menunjukkan cara mencabut penangguhan dengan menggunakan penangguhans API.
Contoh 1: Mencabut penangguhan hanya dengan ID penangguhan
Perintah curl
berikut menunjukkan cara mencabut penangguhan saat Anda hanya memiliki ID penangguhan:
curl -H "Authorization: Bearer $TOKEN" \ -H "Content-type: application/json" \ -H X-GFE-SSL: yes \ -X POST \ -d '{"suspension_result":"Approved"}' \ https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/-/suspensions/c6a13a79-a918-41e2-82b9-32b5a010755a:lift
Dalam contoh ini, variabel Suspension result
disetel ke Approved
untuk ID tambahan c6a13a79-a918-41e2-82b9-32b5a010755a
.
Contoh 2: Mencabut penangguhan hanya dengan ID eksekusi
Perintah curl
berikut menunjukkan cara mencabut penangguhan saat Anda hanya memiliki ID eksekusi:
curl -H "Authorization: Bearer $TOKEN" \ -H "Content-type: application/json" \ -H X-GFE-SSL: yes \ -X POST \ -d '{"suspension_result":"true"}' \ https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/76a391e7-c801-45d7-8046-eab20d167ec5/suspensions/-:lift
Dalam contoh ini, variabel Suspension result
disetel ke true
untuk ID eksekusi 76a391e7-c801-45d7-8046-eab20d167ec5
.
Contoh 3: Mencabut penangguhan dengan ID eksekusi dan ID penangguhan
Perintah curl
berikut menunjukkan cara mencabut penangguhan saat Anda memiliki ID eksekusi dan ID penangguhan:
curl -H "Authorization: Bearer $TOKEN" \ -H "Content-type: application/json" \ -H X-GFE-SSL: yes \ -X POST \ -d '{"suspension_result":"{processname: "Release", owner: "John", status: "approved"};"}' \ https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/-/executions/9b721baa-0a23-4576-b2b6-d251d163ea6f/suspensions/f01815bf-ed18-4e01-9d41-cc2ce7861e95:lift
Dalam contoh ini, variabel Suspension result
ditetapkan ke {processname: "Release", owner: "John", status: "approved"};
untuk ID penangguhan f01815bf-ed18-4e01-9d41-cc2ce7861e95
.
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.