Lihat konektor yang didukung untuk Integration Aplikasi.

Mengambil payload API dan mengirim email

Pelajari cara membuat integrasi contoh di Application Integration. Langkah-langkah berikut menjelaskan cara mengonfigurasi pemicu, tugas, edge, variabel, dan pemetaan data yang diperlukan untuk menjalankan integrasi lengkap.

Ringkasan

Dalam panduan memulai ini, Anda akan mengambil jumlah kunjungan halaman dari API publik, mengubah data menjadi format yang dapat digunakan, dan mengirim daftar yang dihasilkan dalam email, semuanya dari dalam editor integrasi.

Jika ingin mengikuti panduan langkah demi langkah untuk tugas ini langsung di Konsol Google Cloud, klik Pandu saya:

Pandu saya

Membuat integrasi baru

Untuk membuat integrasi baru, lakukan langkah-langkah berikut:

  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 di dialog Buat Integrasi.

    Untuk panduan memulai ini, masukkan nama my-test-integration dan deskripsi Integration for quickstart.

  5. Pilih region untuk integrasi.
  6. Klik Buat untuk membuka editor integrasi.

Menambahkan dan mengonfigurasi pemicu API

Pemicu diperlukan untuk memulai urutan tugas yang membentuk integrasi. Setiap pemicu yang tersedia dapat digunakan untuk memulai integrasi. Untuk memulai cepat ini, gunakan pemicu API.

Untuk mengonfigurasi pemicu API, lakukan hal berikut:

  1. Di editor integrasi, klik Pemicu untuk menampilkan daftar pemicu yang tersedia.
  2. Klik Pemicu API di editor integrasi.
  3. Untuk mengonfigurasi pemicu, klik Pemicu API. Panel konfigurasi pemicu akan muncul.
  4. Integrasi Aplikasi akan otomatis mengisi Label dan ID Pemicu. ID Pemicu dibuat oleh mesin dan Anda tidak dapat mengedit nilainya. Namun, Anda dapat mengedit nilai properti Label.

    Perubahan pada properti akan disimpan secara otomatis.

Menambahkan dan mengonfigurasi tugas

Tugas adalah kumpulan langkah yang dapat dieksekusi yang dapat menggunakan variabel sebagai input dan menghasilkan variabel sebagai output. Seperti pemicu, tugas apa pun yang tersedia dapat digunakan dalam integrasi. Panduan memulai ini menggunakan tugas Call REST Endpoint, Data Mapping, dan Send Email. Detail konfigurasi untuk setiap tugas dijelaskan dalam langkah-langkah di bawah.

Mengonfigurasi tugas Call REST Endpoint

Untuk mengonfigurasi tugas Call REST Endpoint, lakukan hal berikut:

  1. Pilih Tugas untuk menampilkan daftar tugas yang tersedia.
  2. Klik dan tempatkan Call REST Endpoint di editor integrasi.
  3. Tambahkan koneksi edge dari API trigger ke Call REST Endpoint dengan mengarahkan kursor ke titik kontrol di API trigger, lalu mengklik dan menarik garis ke titik kontrol pada tugas Call REST Endpoint. Edge menunjukkan alur kontrol dari pemicu API ke tugas Call REST Endpoint.

    Edge adalah koneksi antara dua elemen dalam integrasi. Koneksi menunjukkan arah alur kontrol dari satu elemen (tugas atau pemicu) ke elemen lainnya. Untuk mengetahui informasi selengkapnya tentang tepi, lihat Tepi.

  4. Untuk mengonfigurasi tugas, klik Call REST Endpoint. Panel konfigurasi tugas akan muncul. Tetapkan properti berikut:
    • Label: Masukkan nama kustom untuk tugas ini. Misalnya, masukkan Call REST Endpoint Task.
    • Autentikasi: Untuk memulai quickstart ini, profil autentikasi tidak diperlukan. Untuk informasi selengkapnya tentang penggunaan profil autentikasi untuk kasus penggunaan lainnya, lihat Membuat profil autentikasi di Integrasi Aplikasi.
    • Input Tugas: Masukkan detail untuk memanggil endpoint REST. Informasi yang dimasukkan di sini digunakan sebagai input untuk tugas Call REST Endpoint. Diagram berikut menunjukkan bagian Input Tugas dan Setelan HTTP untuk tugas Call REST Endpoint:

      Input tugas Call REST Endpoint Input tugas Call REST Endpoint

      Masukkan informasi berikut:

      • URL dasar endpoint: Masukkan https://wikimedia.org/api/rest_v1/metrics/pageviews/per-article/en.wikipedia/desktop/user/Tree/monthly/20201001/20201031. API publik dari wikimedia.org ini menampilkan jumlah kunjungan halaman untuk artikel bernama Tree selama bulan tertentu.
      • Metode HTTP: Pilih GET menggunakan menu drop-down.
    • Setelan HTTP: Integrasi Aplikasi mengisi nilai berikut:
      1. Ikuti pengalihan: True
      2. Tugas akan gagal saat terjadi Error HTTP: True
    • Output Tugas: Integrasi Aplikasi mengisi tiga variabel untuk menyimpan output data respons dari pemanggilan endpoint REST. Diagram berikut menunjukkan Output Tugas dan bagian lainnya untuk tugas Call REST Endpoint:

      Output tugas endpoint rest call Output tugas endpoint rest call

      Tinjau informasi berikut:

      • responseHeader(Call REST Endpoint): Variabel ini menyimpan data header respons yang terkait dengan tugas Call REST Endpoint. Data variabel berjenis String (STR).
      • responseBody(Call REST Endpoint): Variabel ini menyimpan data isi respons yang terkait dengan tugas Call REST Endpoint. Data variabel berjenis String (STR).
      • responseStatus(Call REST Endpoint): Variabel ini menyimpan data status respons yang terkait dengan tugas Call REST Endpoint. Data variabel berjenis String (STR).
    • Kolom lainnya harus berisi nilai default berikut:
      • Strategi eksekusi untuk tugas ini: When all tasks succeed
      • Kebijakan eksekusi untuk tugas berikutnya: Run all match

    Perubahan pada properti akan disimpan secara otomatis.

Menambahkan dan mengonfigurasi tugas Pemetaan Data

Untuk mengonfigurasi tugas Pemetaan Data:

  1. Pilih Tugas untuk menampilkan daftar tugas yang tersedia.
  2. Klik dan tempatkan Pemetaan Data di editor integrasi.
  3. Tambahkan koneksi tepi dari Call REST Endpoint ke Data Mapping dengan mengarahkan kursor ke titik kontrol di Call REST Endpoint, lalu mengklik dan menarik garis ke titik kontrol pada tugas Data Mapping. Tepi menunjukkan aliran kontrol dari tugas Call REST Endpoint ke tugas Data Mapping.
  4. Untuk mengonfigurasi tugas, klik tugas Pemetaan Data. Panel konfigurasi tugas akan muncul.
  5. Klik Buka Editor Pemetaan Data.

    Editor Pemetaan Data memungkinkan Anda memetakan variabel input ke variabel output yang diinginkan, menggunakan fungsi transformasi yang tersedia. Output kemudian tersedia sebagai variabel untuk tugas atau pemicu integrasi lainnya. Untuk mengetahui detail selengkapnya tentang cara meneruskan data sebagai variabel, lihat Variabel.

    Untuk panduan memulai ini, buat pemetaan menggunakan responseBody(Call REST Endpoint) sebagai input:

    1. Tarik variabel responseBody dari panel Variables ke baris Input pertama.
    2. Klik + (Tambahkan fungsi) di chip variabel responseBody untuk melihat daftar fungsi yang tersedia. Anda dapat menerapkan sejumlah fungsi untuk mengubah data dalam variabel input.

      Dalam hal ini, Anda dapat mengonversi payload ke JSON, lalu melakukan iterasi pada array respons untuk mendapatkan daftar nama produk yang diperlukan untuk notifikasi email Anda. Untuk melakukannya, ikuti langkah-langkah berikut:

      • Pilih TO_JSON() untuk mengonversi string responseBody menjadi JSON.
      • Klik + (Tambahkan fungsi) di chip variabel responseBody untuk memilih dan membuat rantai fungsi GET_PROPERTY().
      • Untuk menambahkan parameter input untuk GET_PROPERTY(), klik Variabel atau Nilai dan di Nilai, masukkan items.

        Fungsi ini akan mengekstrak properti dari payload JSON. Teruskan properti items sebagai parameter untuk fungsi ini. Tindakan ini akan menampilkan daftar HANYA nama produk, tanpa informasi produk lainnya. Fungsi Anda akan terlihat seperti berikut: 

        responseBody(Call REST Endpoint).TO_JSON().GET_PROPERTY(items)
      • Jika Anda perlu menghapus atau menghapus fungsi, klik simbol -.
    3. Klik kolom pertama di kolom Output untuk membuat variabel output baru guna menyimpan nilai data yang ditransformasikan. Lengkapi kolom berikut:
      • Di kolom Name, masukkan JSONList.
      • Dari daftar Variable Type, pilih Output from integration.
      • Dari daftar Jenis Data, pilih JSON
      • Untuk membuat variabel dan menutup panel, klik Buat. Variabel JSONList baru akan muncul dalam daftar Variables di sisi kiri editor Pemetaan Data.
    4. Tutup Editor Pemetaan Data setelah pemetaan selesai. Setiap perubahan akan otomatis disimpan. Gambar berikut menunjukkan Editor Pemetaan Data dengan pemetaan yang dibuat dalam panduan memulai ini:

      Editor pemetaan data Editor pemetaan data

Menambahkan dan mengonfigurasi tugas Kirim Email

Untuk mengonfigurasi tugas Kirim Email:

  1. Pilih Tugas di editor integrasi untuk menampilkan daftar tugas yang tersedia.
  2. Klik dan tempatkan Kirim Email di editor integrasi.
  3. Tambahkan koneksi tepi dari Pemetaan Data ke Kirim Email dengan mengarahkan kursor ke titik kontrol di Pemetaan Data, lalu mengklik dan menarik garis ke titik kontrol pada tugas Kirim Email. Tepi menunjukkan alur kontrol dari tugas Pemetaan Data ke tugas Kirim Email.
  4. Untuk mengonfigurasi tugas, klik Kirim Email. Panel konfigurasi tugas akan muncul. Di bagian Task Input, tetapkan properti berikut:
    • Kepada Penerima: Masukkan alamat email Anda. Anda akan menggunakan email ini untuk mengonfirmasi keberhasilan penyelesaian integrasi.
    • Subjek: Masukkan Email from Application Integration.
    • Isi dalam Teks Biasa: Pilih variabel JSONList yang dibuat sebelumnya dalam tugas Pemetaan Data.
    • Opsi lainnya dapat dibiarkan dalam konfigurasi default.

    Perubahan pada properti akan disimpan secara otomatis.

Memverifikasi koneksi tepi yang diperlukan

Pastikan Anda telah menambahkan koneksi edge antara tugas dan pemicu dalam integrasi. Koneksi menunjukkan arah alur kontrol dari satu elemen (tugas atau pemicu) ke elemen lainnya. Untuk mengetahui informasi selengkapnya tentang tepi, lihat Tepi.

Koneksi yang telah selesai akan muncul seperti yang ditunjukkan pada gambar di bawah:

gambar yang menampilkan alur memulai cepat gambar yang menampilkan alur memulai cepat

Menguji integrasi

Untuk menguji integrasi baru:

  1. Klik Uji di toolbar editor integrasi.

    Panel Uji Integrasi akan muncul.

  2. Klik Uji integrasi.

Untuk informasi selengkapnya tentang pengujian, lihat Menguji dan memublikasikan integrasi.

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

Email yang dikirim oleh integrasi harus berisi isi yang mirip dengan berikut ini: 

[{
   "project": "en.wikipedia",
   "article": "Tree",
   "granularity": "monthly",
   "timestamp": "2020100100",
   "access": "desktop",
   "agent": "user",
   "views": 33828.0
}]

Selain memverifikasi konten email, Anda dapat memeriksa log untuk melihat status dan payload integrasi tertentu. Untuk melihat log:

  1. Klik Log di toolbar editor integrasi.
  2. Di halaman Log Eksekusi, Anda dapat melihat detail tentang setiap upaya untuk menjalankan integrasi. Setiap entri menyertakan detail untuk upaya eksekusi, termasuk:
    • Nama integrasi
    • ID Eksekusi
    • Status
    • Waktu mulai
    • Durasi
    • Versi Integrasi
    • ID Pemicu
    • Cloud Logging
  3. Klik panah peluas (>) di samping integrasi yang dieksekusi untuk melihat daftar tugas dan variabel yang diperluas dalam integrasi, beserta status tugas dan payload variabel.

Kuota dan batas

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