Lihat konektor yang didukung untuk Integration Aplikasi.

Memanggil sub-integrasi menggunakan tugas For Each Loop

Panduan memulai ini menunjukkan cara membuat integrasi yang menggunakan tugas For Each Loop untuk memanggil sub-integrasi. Sub-integrasi mengambil input dari integrasi utama dan mengirim email kepada penerima menggunakan tugas Kirim Email.

Membuat sub-integrasi

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Di menu navigasi, klik Integrations. Halaman Integrations akan muncul.
3. Klik Create integration.
4. Masukkan nama dan deskripsi untuk integrasi.

   Untuk panduan memulai ini, masukkan nama ForEachSendEmailSubIntegration dan deskripsi Quickstart sub-integration.

5. Pilih region untuk integrasi.
   Catatan: Drop-down Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan region baru untuk informasi selengkapnya.
6. Klik Buat untuk membuka editor integrasi.

Menambahkan pemicu API di sub-integrasi

Pemicu diperlukan untuk memulai urutan tugas yang membentuk integrasi. Dalam panduan memulai ini, Anda akan menggunakan pemicu API untuk memulai integrasi.

Untuk menambahkan dan mengonfigurasi pemicu API, lakukan langkah-langkah berikut:

1. Di editor integrasi, klik Pemicu untuk melihat daftar pemicu yang tersedia.
2. Klik dan tempatkan elemen pemicu API di editor integrasi.

Membuat variabel input di sub-integrasi

Sub-integrasi menggunakan variabel untuk menyimpan detail yang diterima dalam format JSON dari integrasi utama. Untuk membuat variabel input baru, lakukan langkah-langkah berikut:

1. Klik (Panel tombol) di menu navigasi desainer untuk menampilkan panel Variabel.
2. Klik +Buat untuk membuat variabel.

3. Di panel Create Variable, lakukan hal berikut:

   a. Nama: Masukkan order_details.

   b. Jenis Data: Pilih JSON.

   c. Klik Infer from the default value.

   d. Di Nilai Default, masukkan JSON berikut.

     {
       "orderId": "1",
       "customerName": "Harry Ford",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "New York",
         "country": "USA",
         "zipcode": "103487"
         },
       "items": [{
         "itemid": "111-222-333",
         "itemName": "Smartphone",
         "itemPrice": 999.0,
         "quantity": 1.0
         }, {
         "itemid": "444-555-666",
         "itemName": "Mobile Cover",
         "itemPrice": 49.0,
         "quantity": ""
         }],
       "paymentDetails": {
         "mode": "COD",
         "status": ""
         },
       "expectedDelivery": "15 March 2023"
     }
   

   Dalam contoh objek JSON ini, ganti YOUR_EMAIL_ID dengan ID email yang ingin Anda gunakan untuk menguji integrasi.

   e. Klik Gunakan sebagai input untuk integrasi.

   f. Klik Create.

Menambahkan dan mengonfigurasi tugas Pemetaan Data

Tugas Pemetaan Data memungkinkan Anda melakukan penetapan variabel dalam integrasi, mendapatkan dan menetapkan properti objek JSON, serta menerapkan fungsi transformasi bertingkat ke nilai. Variabel yang digunakan oleh tugas Pemetaan Data dapat berupa variabel integrasi atau variabel tugas.

Untuk menambahkan dan mengonfigurasi tugas Pemetaan Data, lakukan langkah-langkah berikut:

1. Di editor integrasi, klik Tasks untuk melihat daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Pemetaan Data di editor integrasi.
3. Klik elemen Pemetaan Data di editor integrasi untuk membuka panel konfigurasi tugas.
4. Klik Buka Editor Pemetaan Data.
5. Konfigurasikan Input sebagai berikut:
   1. Di bagian Input, klik Variabel atau Nilai.
   2. Di Variabel, masukkan item, lalu pilih order_details.items.
   3. Klik Simpan.
   4. Tambahkan fungsi pemetaan ke order_details.items. Klik simbol + di samping order_details.items. Dalam daftar fungsi, scroll ke bawah dan pilih FOR_EACH(Any) -> JSON.
   5. Masukkan parameter input fungsi FOR_EACH. Klik Variabel atau Nilai, lalu pilih ~obj1.
   6. Klik Simpan.
   7. Tambahkan fungsi pemetaan ke obj1. Klik + di baris FOR EACH dalam tanda kurung setelah elemen obj1 yang baru saja Anda tambahkan. Dalam daftar fungsi, scroll ke bawah dan pilih GET PROPERTY(String) -> JSON.
   8. Klik Variabel atau Nilai dan di Nilai masukkan itemName.
   9. Klik Simpan.
   10. Klik + Tambahkan fungsi di baris setelah GET PROPERTY dan pilih TO_STRING() -> String.
   11. Klik + Tambahkan fungsi di baris terakhir, lalu pilih TO_STRING() -> String.
6. Konfigurasikan Output sebagai berikut:
   1. Buat variabel output baru. Di bagian Output, klik buat yang baru.
   2. Di panel Create Variable, masukkan nama items, pertahankan nilai default untuk semua kolom lainnya, lalu klik Create.
7. Pastikan konfigurasi pemetaan data Anda mirip dengan gambar berikut.

   

8. Tutup Editor Pemetaan Data untuk kembali ke editor integrasi.

Menambahkan dan mengonfigurasi tugas Kirim Email

Untuk menambahkan dan mengonfigurasi tugas Kirim Email guna mengirim email kepada setiap penerima, lakukan langkah-langkah berikut.

1. Di editor integrasi, klik Tambahkan tugas/pemicu.
2. Buka Tasks, lalu klik dan tempatkan elemen Send Email di editor integrasi.
3. Klik elemen tugas Kirim Email di editor integrasi untuk membuka panel konfigurasi tugas.

4. Tetapkan kolom Input Tugas berikut:

   1. Kepada Penerima: Klik Variabel, lalu pilih order_details.emailId.
   2. Subjek: Masukkan subjek untuk email. Untuk panduan memulai ini, masukkan Order delivery notification.
   3. Isi dalam Teks Biasa: Masukkan teks berikut:

   Hi $order_details.customerName$! Your order with Order Id: $order_details.orderId$ with items: $items$ has been successfully placed. Expected delivery by: $order_details.expectedDelivery$.
   

Menghubungkan elemen dalam sub-integrasi

Setelah menambahkan dan mengonfigurasi tugas dan pemicu yang diperlukan di sub-integrasi, tambahkan koneksi (edge) di antara elemen. Tepi menunjukkan alur kontrol dari satu elemen ke elemen berikutnya.

1. Tambahkan tepi dari elemen Pemicu API ke elemen Pemetaan Data. Arahkan kursor ke titik kontrol pada elemen Pemicu API, lalu klik dan tarik garis ke titik kontrol pada elemen Pemetaan Data.
2. Demikian pula, tambahkan tepi dari elemen Pemetaan Data ke elemen Kirim Email.

Menguji dan memublikasikan sub-integrasi

1. Untuk menguji sub-integrasi ini, klik Test di toolbar editor integrasi, lalu klik Test integration di dialog Test Integration. Sub-integrasi berjalan dengan nilai default sebagai input dan mengirim email ke alamat email yang ditentukan dalam tugas Kirim Email. Anda akan melihat pesan berhasil saat pengujian selesai.
2. Untuk memublikasikan sub-integrasi ini, klik Publikasikan di toolbar editor integrasi.

Membuat integrasi utama

1. Di menu navigasi, klik Integrations untuk kembali ke halaman Integrations.
2. Klik Create integration.
3. Masukkan nama dan (opsional) deskripsi untuk integrasi. Untuk panduan memulai ini, masukkan nama ForEachSendEmail dan deskripsi Quickstart main integration.
4. Pilih Region untuk integrasi dari daftar region yang didukung. Pastikan Anda membuat integrasi utama di region yang sama dengan sub-integrasi.
5. Klik Create.

Menambahkan pemicu API di integrasi utama

1. Di editor integrasi, klik Pemicu untuk melihat daftar tugas dan pemicu yang tersedia.
2. Klik dan tempatkan elemen pemicu API di editor integrasi.

Membuat variabel input di integrasi utama

Dalam integrasi utama, variabel input digunakan untuk menyimpan data yang diteruskan melalui For Each Loop ke sub-integrasi. Anda dapat membuat variabel ini sekarang, atau pada langkah berikutnya saat menambahkan dan mengonfigurasi tugas Loop Untuk Setiap. Untuk panduan memulai ini, buat variabel sekarang.

1. Klik (Panel tombol) di menu navigasi desainer untuk menampilkan panel Variabel.

2. Di panel Create Variable, lakukan hal berikut:

   a. Nama: Masukkan order_requests.

   b. Jenis Data: Pilih JSON.

   c. Klik Infer from the default value.

   d. Di Nilai Default, masukkan JSON berikut:

     [{
       "orderId": "1",
       "customerName": "Harry Ford",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "New York",
         "country": "USA",
         "zipcode": "103487"
       },
       "items": [{
         "itemid": "111-222-333",
         "itemName": "Smartphone",
         "itemPrice": 999.0,
         "quantity": 1.0
       }, {
         "itemid": "444-555-666",
         "itemName": "Mobile Cover",
         "itemPrice": 49.0,
         "quantity": ""
       }],
       "paymentDetails": {
         "mode": "COD",
         "status": ""
       },
      "expectedDelivery": "15 March 2023"
     }, {
       "orderId": "2",
       "customerName": "Tim Harvey",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "Los Angeles",
         "country": "USA",
         "zipcode": "210738"
       },
       "items": [{
         "itemid": "222-333-444",
         "itemName": "Laptop",
         "itemPrice": 5999.0,
         "quantity": 1.0
      }],
       "paymentDetails": {
         "mode": "Online Payment",
         "status": "Success"
       },
       "expectedDelivery": "21 Feb 2023"
     }]
   

   Dalam contoh objek JSON ini, ganti kedua kemunculan YOUR_EMAIL_ID dengan ID email yang ingin Anda gunakan untuk menguji integrasi.

   e. Klik Gunakan sebagai input untuk integrasi.

   f. Klik Create.

Menambahkan dan mengonfigurasi tugas For Each Loop

1. Di editor integrasi, klik Tugas.
2. Klik dan tempatkan elemen For Each Loop di editor integrasi.
3. Klik elemen tugas For Each Loop di editor integrasi untuk membuka panel konfigurasi tugas.
4. Di panel konfigurasi, lakukan hal berikut:
   1. Daftar untuk di-iterasi: Pilih variabel input yang Anda buat, order_requests.
   2. ID pemicu API: Pilih pemicu API di sub-integrasi Anda. Untuk memulai cepat ini, pilih api_trigger/ForEachSendEmailSubIntegration_API_1.
   3. Integration name: Pilih nama sub-integrasi yang ingin Anda panggil. Untuk panduan memulai ini, pilih ForEachSendEmailSubIntegration.
   4. Pemetaan sub-integrasi elemen iterasi: Pilih order_details.

Menghubungkan elemen dalam integrasi utama

1. Tambahkan edge dari elemen Pemicu API ke elemen For Each Loop. Arahkan kursor ke titik kontrol pada elemen Pemicu API, lalu klik dan tarik garis ke titik kontrol pada elemen For Each Loop.

Menguji dan memublikasikan integrasi utama

Tugas terakhir adalah menguji dan memublikasikan integrasi utama.

1. Klik Test di toolbar editor integrasi, lalu klik Test integration di dialog Test Integration. Anda akan melihat pesan berhasil saat pengujian selesai.

2. Untuk memublikasikan integrasi ini, klik Publikasikan di toolbar editor integrasi.

   Setelah berhasil diselesaikan, integrasi akan mengirim email ke alamat email yang ditentukan dalam tugas Kirim Email. Konfirmasi penerimaan email di program email Anda.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.