Lihat konektor yang didukung untuk Integration Aplikasi.

Mendengarkan topik Cloud Pub/Sub dan mengirim email

Pelajari cara membuat contoh integrasi menggunakan Integrasi Aplikasi dan pemicu Cloud Pub/Sub. Langkah-langkah berikut menjelaskan cara mengonfigurasi pemicu, tugas, variabel, dan pemetaan data yang diperlukan untuk menjalankan integrasi lengkap.

Ringkasan

Dalam panduan memulai ini, Anda akan membuat integrasi dengan pemicu Cloud Pub/Sub untuk memproses topik Pub/Sub yang ada yang menerima pembacaan suhu dalam derajat Kelvin dari perangkat IOT. Kemudian, Anda dapat menggunakan tugas Pemetaan Data untuk mengubah pesan Pub/Sub ke celsius dan mengirim nilai dalam email.

Sebelum memulai

Tetapkan peran Identity and Access Management (IAM) berikut ke Agen Layanan Integrasi Aplikasi ([e-mail]) di project Google Cloud Anda:

• Editor Pub/Sub
• Application Integration Invoker

  Untuk mengetahui informasi selengkapnya tentang cara menetapkan peran IAM, lihat Peran dan izin IAM.

Lingkungan penyiapan

Membuat topik Cloud Pub/Sub baru

Panduan memulai ini mengasumsikan bahwa Anda memiliki topik Pub/Sub yang menerima pembacaan suhu dalam derajat Kelvin dari perangkat IOT. Anda tidak perlu menghubungkan topik ke perangkat. Panduan memulai ini menguji kemampuan integrasi untuk memproses topik dan melakukan tugas saat dipicu.

Untuk membuat contoh topik guna panduan memulai ini:

1. Buka halaman topik Pub/Sub di Konsol Cloud.

   Buka halaman topik Pub/Sub

2. Klik Buat topik.
3. Di kolom Topic ID, berikan nama topik yang unik. Misalnya, temperaturesensor
4. Klik Simpan.
   Catatan: Langganan tidak diperlukan agar topik ini dapat memicu integrasi.

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. Misalnya, my-test-integration.
   Catatan: Nama integrasi harus memenuhi persyaratan berikut:

   • Nama harus diawali dan diakhiri dengan huruf atau angka.
   • Nama tidak boleh berisi spasi atau lebih dari satu tanda hubung atau garis bawah secara berturut-turut.
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 Cloud Pub/Sub

Untuk menambahkan pemicu Cloud Pub/Sub ke integrasi, ikuti langkah-langkah di bawah:

1. Di editor integrasi, pilih Pemicu untuk menampilkan daftar pemicu yang tersedia.
2. Klik dan tempatkan elemen pemicu Cloud Pub/Sub ke desainer.

Mengonfigurasi pemicu Cloud Pub/Sub

Klik elemen Pemicu Cloud Pub/Sub di editor integrasi untuk melihat panel konfigurasi pemicu.

Tentukan topik yang harus diproses pemicu di kolom Pub/Sub topic dalam format berikut:

projects/PROJECT_ID/topics/TOPIC_ID

dengan:

• PROJECT_ID adalah project Google Cloud tempat topik Anda dibuat.
• TOPIC_ID adalah ID topik Cloud Pub/Sub yang Anda buat di bagian Sebelum memulai.

Misalnya, jika project Anda bernama my-project dan Anda memberi nama topik temperaturesensor, masukkan:

projects/my-project/topics/temperaturesensor.

Untuk melihat semua topik yang tersedia di project Google Cloud, lihat kolom Nama topik di Topik.

Panel konfigurasi Pemicu Cloud Pub/Sub akan otomatis mengisi kolom Output Pemicu dengan variabel untuk menyimpan pesan Pub/Sub.

Menambahkan dan mengonfigurasi tugas Pemetaan Data

Untuk mengonfigurasi tugas Pemetaan Data:

1. Pilih Tugas untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Pemetaan Data di editor integrasi.
3. Klik tugas Pemetaan Data di desainer untuk membuka panel konfigurasi untuk tugas tersebut.
4. 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 meneruskan data sebagai variabel, lihat Menggunakan variabel dalam Integrasi Aplikasi.

   Untuk panduan memulai ini, ikuti langkah-langkah berikut untuk membuat pemetaan menggunakan CloudPubSubMessage sebagai input:

   1. Luaskan variabel JSON CloudPubSubMessage dalam daftar Variabel dan tarik variabel CloudPubSubMessage.data ke baris Input pertama.
   2. Klik + (Tambahkan fungsi) di samping variabel CloudPubSubMessage.data untuk melihat daftar drop-down fungsi yang tersedia.
   3. Pilih TO_DOUBLE() untuk mengonversi nilai CloudPubSubMessage.data menjadi jenis data double.
   4. Klik + (Tambahkan fungsi) lagi untuk memilih dan merantai fungsi SUBTRACT.
   5. Masukkan 273.15 sebagai nilai fungsi SUBTRACT. Ini untuk mengonversi suhu Kelvin ke derajat Celsius.
   6. Klik baris pertama di kolom Output untuk membuat variabel output baru guna menyimpan nilai data yang ditransformasikan. Lengkapi kolom berikut:
      • Nama: Masukkan TempInCelsius.
      • Centang Gunakan sebagai output integrasi.
      • Klik Create untuk membuat variabel dan menutup panel. Variabel TempInCelsius baru akan muncul dalam daftar Variabel.
   7. Tarik variabel TempInCelsius dari daftar Variabel ke baris kedua di kolom Input.
   8. Klik + (Tambahkan fungsi) di variabel TempInCelsius untuk melihat daftar drop-down fungsi yang tersedia.
   9. Klik TO_STRING() untuk mengubah jenis data variabel dari double menjadi string.
   10. Klik baris kedua di kolom Output untuk membuat variabel baru guna menyimpan nilai data yang ditransformasi. Lengkapi kolom berikut:
       • Nama: Masukkan TempInCelsiusString.
       • Nilai default kosong berarti: Pilih String Kosong.
       • Centang kotak Gunakan sebagai output integrasi.
       • Klik Create untuk membuat variabel dan menutup panel. Variabel baru akan muncul dalam daftar Variables di sisi kiri editor pemetaan data.
   11. Tutup Editor Pemetaan Data setelah pemetaan selesai. Setiap perubahan akan otomatis disimpan.

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 elemen Kirim Email di editor integrasi.
3. Klik elemen Kirim Email di desainer untuk membuka panel konfigurasi tugas. Tetapkan properti berikut:
   • Kepada Penerima: Masukkan alamat email Anda. Anda akan menggunakan email ini untuk mengonfirmasi keberhasilan penyelesaian integrasi.
   • Subjek: Masukkan Temperature in Celsius.
   • Isi dalam Teks Biasa: Pilih variabel TempInCelsiusString yang dibuat sebelumnya dalam tugas Pemetaan Data.
   • Opsi lainnya dapat dibiarkan dalam konfigurasi default.
   Perubahan Anda pada properti akan disimpan secara otomatis.

Menambahkan koneksi tepi yang diperlukan

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

1. Tambahkan koneksi edge dari elemen Cloud Pub/Sub trigger ke elemen Data Mapping dengan mengarahkan kursor ke titik kontrol pada elemen Cloud Pub/Sub trigger, lalu klik dan tarik garis ke titik kontrol pada elemen tugas Data Mapping. Edge ini menunjukkan alur kontrol dari tugas Pemicu Cloud Pub/Sub ke tugas Pemetaan Data.
2. Tambahkan koneksi tepi dari elemen Pemetaan Data ke elemen Kirim Email dengan mengarahkan kursor ke titik kontrol pada elemen Pemetaan Data, lalu mengklik dan menarik garis ke titik kontrol pada elemen tugas Kirim Email. Edge ini menunjukkan alur kontrol dari tugas Pemetaan Data ke tugas Kirim Email.

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

Menguji integrasi

Untuk menguji integrasi baru dari halaman topik Pub/Sub, lakukan langkah-langkah berikut:

1. Buka halaman topik Pub/Sub di Konsol Cloud.

   Buka halaman topik Pub/Sub

2. Telusuri, lalu pilih topik temperaturesensor yang Anda buat.
3. Dari halaman detail topik, klik + Publish Message untuk membuka panel konfigurasi Publish Message.
4. Di kolom Isi pesan, masukkan 307.15.

   Membuat pesan ini menyimulasikan publikasi pembacaan suhu dalam Kelvin yang diterima oleh Pub/Sub dari perangkat IOT.

5. Klik Publikasikan untuk memublikasikan pesan ke topik dan memicu integrasi Anda.

Setelah berhasil diselesaikan, integrasi akan mengirimkan email dengan suhu Kelvin yang dikonversi ke derajat Celsius ke alamat email yang ditentukan dalam tugas Kirim Email. Konfirmasi penerimaan email di program email Anda.

Email yang dikirim oleh integrasi harus memiliki isi pesan yang berisi nilai 34.

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

1. Di editor integrasi, klik Lihat log eksekusi untuk integrasi ini. Halaman Execution Logs akan muncul. Untuk mengetahui informasi selengkapnya tentang log eksekusi, lihat Melihat log eksekusi 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
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.