Lihat konektor yang didukung untuk Application Integration.

Memanggil sub-integrasi menggunakan tugas For Every Loop

Panduan memulai ini menunjukkan cara membuat integrasi yang menggunakan tugas For Setiap 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 Application Integration.

    Buka Application Integration

  2. Di menu navigasi, klik Integrasi. Halaman Integrations List 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.
  6. Klik Create untuk membuka editor integrasi.

Menambahkan pemicu API dalam 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 dalam 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 (Aktifkan/nonaktifkan panel) di menu navigasi desainer untuk memunculkan panel Variabel.
  2. Klik +Create untuk membuat variabel.
  3. Di panel Create Variable, lakukan langkah berikut:

    a. Nama: Masukkan order_details.

    b. Data Type: Pilih JSON.

    c. Klik Simpulkan dari nilai default.

    d. Di Default Value, 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"
      }
    

    Pada 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 pada 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 Data Mapping di editor integrasi.
  3. Klik elemen Data Mapping di editor integrasi untuk membuka panel konfigurasi tugas.
  4. Klik Open Data Mapping Editor.
  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 UNTUK SETIAP baris dalam tanda kurung setelah elemen obj1 yang baru saja Anda tambahkan. Dalam daftar fungsi, scroll ke bawah dan pilih GET PROPERTI(String) -> JSON.
    8. Klik Variabel atau Nilai, lalu masukkan itemName di Nilai.
    9. Klik Simpan.
    10. Klik + Add a function di baris setelah GET PROPERTI dan pilih TO_STRING() -> String.
    11. Klik + Add a function di baris terakhir dan pilih TO_STRING() -> String.
  6. Konfigurasikan Output sebagai berikut:
    1. Buat variabel output baru. Di bagian Output, klik buat output 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.

    gambar konfigurasi editor pemetaan data

  8. Tutup Data Mapping Editor 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 Send Email di editor integrasi untuk membuka panel konfigurasi tugas.
  4. Tetapkan kolom Task Input berikut:

    1. Kepada Penerima: Klik Variabel, lalu pilih order_details.emailId.
    2. Subjek: Masukkan subjek email. Untuk panduan memulai ini, masukkan Order delivery notification.
    3. Body in Plain Text: 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-elemen dalam sub-integrasi

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

  1. Tambahkan tepi dari elemen pemicu API ke elemen Pemetaan Data. Arahkan kursor ke titik kontrol di elemen pemicu API, lalu klik dan tarik garis ke titik kontrol pada elemen Pemetaan Data.
  2. Demikian pula, tambahkan tepi dari elemen Data Mapping ke elemen Send 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 Integrasi untuk kembali ke halaman Integrasi.
  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 wilayah yang didukung. Pastikan Anda membuat integrasi utama di region yang sama dengan sub-integrasi.
  5. Klik Create.

Menambahkan pemicu API dalam 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 dalam integrasi utama

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

  1. Klik (Aktifkan/nonaktifkan panel) di menu navigasi desainer untuk memunculkan panel Variabel.
  2. Di panel Create Variable, lakukan langkah berikut:

    a. Nama: Masukkan order_requests.

    b. Data Type: Pilih JSON.

    c. Klik Simpulkan dari nilai default.

    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"
      }]
    

    Pada 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 Every Loop

  1. Di editor integrasi, klik Tasks.
  2. Klik dan tempatkan elemen For Every Loop di editor integrasi.
  3. Klik elemen tugas For Every Loop di editor integrasi untuk membuka panel konfigurasi tugas.
  4. Di panel konfigurasi, lakukan tindakan berikut:
    1. Daftar yang akan diiterasi: Pilih variabel input yang Anda buat, order_requests.
    2. ID pemicu API: Pilih pemicu API di sub-integrasi Anda. Untuk panduan memulai ini, pilih api_trigger/ForEachSendEmailSubIntegration_API_1.
    3. Nama integrasi: 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 API trigger ke elemen For Every Loop. Arahkan kursor ke titik kontrol di elemen Pemicu API, lalu klik dan tarik garis ke titik kontrol pada elemen Untuk Setiap 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 mengirimkan email ke alamat email yang ditentukan dalam tugas Kirim Email. Konfirmasi penerimaan email di program email Anda.