Lihat konektor yang didukung untuk Application Integration.

Tugas konektor

Dengan tugas Konektor, Anda dapat terhubung dengan cepat dan aman ke berbagai layanan Google Cloud dan aplikasi bisnis lainnya dari integrasi Anda menggunakan konektor siap pakai yang tersedia di Integration Connectors.

Untuk mengetahui daftar semua konektor yang didukung untuk Integrasi Aplikasi, lihat Referensi konektor.

Sebelum memulai

  • Pastikan Anda memiliki peran IAM Admin Konektor (roles/connectors.admin) yang diberikan di project Google Cloud Anda. Untuk mengetahui informasi tentang cara memberikan peran, lihat Mengelola akses.
  • Pelajari konsep umum Konektor Integrasi.
  • Untuk terhubung ke Google Cloud layanan dan aplikasi bisnis lainnya menggunakan konektor, pastikan Anda telah melampirkan akun layanan yang dikelola pengguna ke integrasi Anda. Jika integrasi Anda tidak memiliki akun layanan yang dikelola pengguna yang dikonfigurasi, maka secara default akun layanan default (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) akan digunakan untuk autentikasi.
  • Pastikan akun layanan Anda memiliki peran IAM yang diperlukan. Untuk mengetahui informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.

Menambahkan tugas Konektor

Untuk menambahkan tugas Konektor dalam integrasi Anda, lakukan hal berikut:

  1. Di konsol Google Cloud , buka halaman Application Integration.

    Buka Integrasi Aplikasi

  2. Di menu navigasi, klik Integrations.

    Halaman Integrasi akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.

  3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

    Jika Anda membuat integrasi baru:

    1. Masukkan nama dan deskripsi di panel Buat Integrasi.
    2. Pilih region untuk integrasi.
    3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasi di toolbar integrasi.
    4. Klik Buat. Integrasi yang baru dibuat akan terbuka di editor integrasi.

  4. Di menu navigasi editor integrasi, klik Tugas untuk melihat daftar tugas dan konektor yang tersedia.

    5. gambar yang menampilkan tugas konektor

  5. Jika Anda ingin mengonfigurasi koneksi baru, klik dan tempatkan elemen Konektor di editor integrasi. Kemudian, klik Konfigurasi konektor untuk mengonfigurasi koneksi.

    gambar yang menampilkan daftar tugas konektor gambar yang menampilkan daftar tugas konektor

  6. Jika Anda memiliki koneksi yang sudah ada, klik tab Konektor untuk melihat koneksi yang baru dibuat. Anda juga dapat menelusuri konektor, koneksi, atau tugas dengan memasukkan nama di kolom Penelusuran.

    gambar yang menampilkan kemampuan penelusuran untuk tugas konektor

  7. Klik dan tempatkan elemen Konektor yang dikonfigurasi di editor integrasi. Untuk mengetahui informasi tentang cara mengonfigurasi tugas konektor, lihat Mengonfigurasi tugas Konektor.

Mengonfigurasi tugas Konektor

Untuk mengonfigurasi tugas Connectors, lakukan hal berikut:

  1. Klik elemen tugas Konektor di perancang untuk melihat panel konfigurasi tugas Konektor.

    Atau, klik untuk mengganti nama tugas.

  2. Klik Configure connector.
  3. Anda dapat memilih koneksi yang ada di wilayah atau membuat koneksi baru. Untuk mengonfigurasi koneksi yang ada, selesaikan langkah-langkah berikut di halaman Editor Tugas Konektor.

    Gambar berikut menunjukkan contoh tata letak halaman Editor Tugas Konektor. gambar yang menampilkan dialog tugas Configure connector gambar yang menampilkan dialog tugas Configure connector

    1. Di bagian Pilih koneksi, pilih region koneksi.
    2. Pilih koneksi yang ada dari daftar koneksi yang tersedia di region yang dipilih.
    3. Klik Berikutnya.
    4. Dari daftar Jenis, pilih Entitas atau Tindakan.
      • Jika Anda memilih Entitas, daftar entitas yang didukung untuk koneksi akan ditampilkan di bagian Tetapkan entitas/tindakan. Pilih entitas, diikuti dengan Operasi yang ingin Anda lakukan pada entitas tersebut.
      • Jika Anda memilih Tindakan, daftar tindakan yang didukung untuk koneksi akan ditampilkan di kolom Tetapkan entitas/tindakan. Pilih tindakan untuk koneksi.
        • Entitas dan tindakan yang didukung didasarkan pada jenis konektor. Untuk mengetahui daftar semua konektor yang didukung untuk Integrasi Aplikasi, lihat Referensi konektor. Untuk melihat tindakan dan entitas yang didukung untuk konektor, lihat dokumentasi konektor tertentu.

        Jika konektor mendukung kueri SQL kustom, Anda dapat memilih opsi Jalankan kueri kustom dari daftar Tindakan. Untuk mengetahui informasi tentang cara menambahkan kueri SQL kustom untuk konektor Anda, lihat Tindakan: Jalankan kueri SQL kustom.

    5. Klik Selesai untuk menyelesaikan konfigurasi koneksi dan menutup panel.

Mengonfigurasi variabel input dan output tugas

Panel konfigurasi tugas Konektor menampilkan Input Tugas dan Output Tugas variabel yang dibuat secara otomatis berdasarkan Entitas dan Operasi atau Tindakan yang dipilih dalam dialog Konfigurasi tugas konektor. Variabel ini dapat dikonfigurasi dan dapat diakses sebagai input ke tugas saat ini atau sebagai output ke tugas berikutnya, atau sebagai kondisi dalam integrasi saat ini.

Untuk mengonfigurasi variabel Input Tugas atau Output Tugas, klik variabel yang sesuai untuk membuka panel Konfigurasi Variabel dan lakukan langkah-langkah berikut:

  1. Masukkan nilai variabel di kolom Nilai Default.
  2. (Opsional) Pilih Gunakan sebagai input untuk integrasi atau Gunakan sebagai output untuk integrasi.
  3. Klik Simpan.

Untuk mengetahui informasi selengkapnya tentang parameter input dan output tugas Konektor, lihat Operasi entitas.

Mengonfigurasi penggantian autentikasi

Untuk mengaktifkan koneksi agar menerima autentikasi backend yang berbeda secara dinamis selama runtime, pastikan di Integration Connectors, Anda telah memilih opsi Enable Authentication Override untuk koneksi Anda.

Untuk mengonfigurasi penggantian autentikasi, lakukan hal berikut:

  1. Klik elemen tugas konektor di perancang untuk melihat panel konfigurasi tugas Konektor.
  2. Luaskan bagian Input tugas. Kolom Kredensial pengguna akhir ditetapkan ke variabel dynamicAuthConfig.

    Kredensial pengguna akhir Kredensial pengguna akhir

    Kemudian, lakukan hal berikut:

    1. Klik variabel dynamicAuthConfig. Panel Edit variabel akan muncul.

      Untuk mengganti autentikasi, Anda harus memberikan nilai autentikasi saat menguji integrasi.

      Mengedit variabel euc dinamis Mengedit variabel euc dinamis

      Untuk melakukannya, ikuti langkah-langkah berikut:

      1. Dari daftar Jenis variabel, pilih Input ke Integrasi.
      2. Di JSON schema options, Anda dapat memverifikasi jenis autentikasi yang dikonfigurasi untuk koneksi. Gunakan skema ini untuk mengganti nilai autentikasi saat Anda menguji integrasi.

        Menguji integrasi untuk penggantian autentikasi Menguji integrasi untuk penggantian autentikasi

    Atau, Anda dapat meneruskan autentikasi sebagai header HTTP dengan mencentang kotak Use HTTPS Header for Auth Config di bagian Task input pada panel konfigurasi tugas Connectors.

    Uji integrasi dengan meneruskan autentikasi sebagai header HTTP Uji integrasi dengan meneruskan autentikasi sebagai header HTTP

Operasi dan tindakan entity

Anda dapat melakukan operasi CRUD (Buat, Baca, Perbarui, Hapus) pada entity konektor. Setiap operasi entitas ini memiliki serangkaian parameter input dan output yang berbeda. Tabel berikut mencantumkan parameter input dan output dari berbagai operasi entitas.

Nama operasi Parameter input Parameter output
Daftar
  • listEntitiesPageSize
  • listEntitiesPageToken
  • listEntitiesSortByColumns
  • filterClause
  • connectorOutputPayload
  • listEntitiesNextPageToken
Dapatkan entityId connectorOutputPayload
Buat connectorInputPayload connectorOutputPayload
Perbarui
  • connectorInputPayload
  • entityId
  • filterClause
 connectorOutputPayload
Hapus
  • entityId
  • filterClause
 T/A

Parameter input

Tabel berikut menjelaskan parameter input untuk berbagai operasi entitas.

Nama parameter Jenis data Deskripsi
entityId String

ID unik baris yang ingin Anda akses.

Biasanya, entityId adalah nilai kunci utama tabel atau set data. Jika Anda menentukan nilai untuk entityId dan tabel atau set data tidak memiliki kolom kunci utama, integrasi akan melaporkan error runtime dan tugas Konektor akan gagal.

Misalnya, untuk mendapatkan baris tertentu dari tabel MySQL, entityId adalah nilai kunci utama dalam tabel.
connectorInputPayload JSON Data sebenarnya yang akan ditambahkan atau diperbarui dalam entitas. Contoh berikut menunjukkan cuplikan JSON data baris yang akan ditambahkan dalam tabel: 
{
"employee_first_name": "John",
"employee_emailID": "test-05@test.com"
}

Dalam contoh ini, employee_first_name dan employee_emailID adalah nama kolom dengan nilai yang sesuai John dan test-05@test.com.
filterClause String Membatasi hasil operasi berdasarkan kondisi. Untuk mengetahui informasi selengkapnya tentang cara menambahkan klausa filter, lihat Menambahkan filter untuk operasi.
listEntitiesPageSize Bilangan bulat

Menentukan jumlah hasil yang harus ditampilkan dalam satu halaman.

Halaman adalah pengelompokan logis dari data dalam kumpulan hasil. Konsep halaman berguna saat Anda mengharapkan sejumlah besar catatan dalam kumpulan hasil. Jika set hasil berukuran besar, tugas Konektor mungkin gagal, karena ada batas ukuran data yang dapat diproses oleh tugas Konektor. Dengan menguraikan set hasil menjadi bagian-bagian yang lebih kecil, Anda dapat menghindari masalah ini.

Misalnya, jika Anda mengharapkan 1.000 data dalam set hasil, Anda dapat menetapkan listEntitiesPageSize ke 100. Jadi, saat tugas Connectors berjalan untuk pertama kalinya, tugas ini akan menampilkan 100 record pertama, 100 record berikutnya pada run kedua, dan seterusnya.

listEntitiesPageToken String

ID halaman (token) yang memungkinkan Anda mengakses halaman tertentu.

Anda bisa mendapatkan nilai token halaman dari parameter output listEntitiesNextPageToken. Karena setiap halaman memiliki token unik, Anda dapat mengakses halaman mana pun yang diinginkan dalam kumpulan hasil. Untuk memahami penggunaan parameter ini, baca juga deskripsi parameter output listEntitiesNextPageToken.
listEntitiesSortByColumns Array string Nama kolom yang ingin Anda gunakan untuk mengurutkan set hasil.

Parameter output

Tabel berikut menjelaskan parameter output untuk berbagai operasi entitas.

Nama parameter Jenis data Deskripsi
connectorOutputPayload JSON Output operasi dalam format JSON.
listEntitiesNextPageToken String

ID yang dibuat sistem untuk halaman. Anda dapat menganggap token sebagai pointer yang dapat digunakan untuk mengakses halaman tertentu dari set hasil.

Jika Anda telah membagi kumpulan hasil menjadi beberapa halaman dengan menetapkan parameter listEntitiesPageSize, Anda memerlukan mekanisme untuk menavigasi halaman. Parameter output listEntitiesNextPageToken memungkinkan Anda melakukan hal tersebut. Setiap kali tugas Konektor berjalan, sistem membuat token untuk halaman berikutnya dan menetapkan nilai listEntitiesNextPageToken ke token yang baru dibuat. Kemudian, Anda dapat menggunakan token ini untuk mengakses halaman berikutnya dalam kumpulan hasil. Untuk mengakses halaman berikutnya, Anda harus menyetel parameter input listEntitiesPageToken ke nilai token halaman berikutnya.

Misalnya, Anda telah menetapkan parameter listEntitiesPageSize ke 2 dan saat tugas Connectors berjalan untuk pertama kalinya, listEntitiesNextPageToken ditetapkan ke nilai token ChoKC2VtcGxveWVlX2lkEgkRAAAAAAAA8D8YDw==. Kemudian, Anda dapat menetapkan parameter input listEntitiesPageToken ke nilai token ini untuk mengambil halaman berikutnya dalam tugas Konektor yang dijalankan berikutnya.

Jika set hasil Anda memiliki banyak halaman, Anda dapat mempertimbangkan untuk menggunakan tugas While Loop untuk mendapatkan halaman berikutnya dan menggunakan tugas Pemetaan Data untuk menetapkan nilai token halaman secara otomatis ke parameter input listEntitiesPageToken setelah setiap proses. Petakan listEntitiesNextPageToken dari iterasi loop terakhir ke listEntitiesPageToken di LIST Operation tugas Konektor iterasi loop saat ini. Tugas While Loop berakhir saat listEntitiesNextPageToken adalah NULL, yang berarti tidak ada lagi halaman.

Klausa filter untuk operasi entitas

Anda dapat membatasi data yang diproses oleh tugas Konektor menggunakan variabel Klausul filter yang tersedia sebagai Input Tugas. Misalnya, dalam kasus operasi delete, Anda dapat menambahkan klausa filter untuk menghapus data dengan orderId tertentu.

Klausul filter hanya dapat diterapkan untuk operasi entity berikut:

  • Daftar
  • Hapus
  • Perbarui

Saat Anda memilih salah satu operasi ini, bagian Input Tugas dari tugas Konektor akan menampilkan kolom Klausul filter secara otomatis.

Menambahkan klausa filter

Untuk menambahkan klausa filter, lakukan langkah-langkah berikut:

  1. Klik elemen tugas Konektor di perancang untuk melihat panel konfigurasi tugas Konektor.
  2. Luaskan bagian Task Input dan klik variabel string filterClause(Connectors).

    Dialog Configure Variable akan muncul.

  3. Masukkan klausa filter (mengikuti sintaksis klausa) di kolom Nilai Default.
  4. Klik Simpan.

Sintaksis dan contoh klausa filter

Klausa filter memiliki format berikut:

FIELD_NAME CONDITION FILTER_VALUE

Contoh

  • OwnerId = '0053t000007941XAAQ'
     
  • PoNumber < 2345
     
  • OrderNumber = 00110 AND StatusCode = 'Draft'
     
  • TotalAmount > 2500
     
  • ShippingPostalCode = 94043 OR ShippingPostalCode = 77002

Penggunaan variabel dalam klausa filter

Anda tidak dapat langsung menggunakan variabel integrasi dalam klausa filter. Jika ingin menggunakan variabel integrasi, Anda harus mengonfigurasi tugas Pemetaan Data terlebih dahulu untuk membuat pemetaan antara variabel integrasi dan klausa filter.

Tabel berikut menunjukkan contoh pemetaan antara variabel integrasi dan variabel filterClause(Connectors):

Input Output
PRIMARY_KEY_ID = ' .CONCAT(INTEGRATION_VARIABLE) .CONCAT(') filterClause(Connectors)
Dengan PRIMARY_KEY_ID = ' dimasukkan sebagai Nilai di baris input.

Tindakan: Menjalankan kueri SQL kustom

Untuk membuat kueri kustom, ikuti langkah-langkah berikut:

  1. Ikuti petunjuk mendetail untuk menambahkan tugas konektor.
  2. Saat Anda mengonfigurasi tugas konektor, di jenis tindakan yang ingin Anda lakukan, pilih Tindakan.
  3. Dalam daftar Tindakan, pilih Jalankan kueri kustom, lalu klik Selesai.

    Gambar yang menampilkan tindakan execute-custom-query Gambar yang menampilkan tindakan execute-custom-query

  4. Luaskan bagian Input tugas, lalu lakukan hal berikut:
    1. Di kolom Waktu tunggu setelah, masukkan jumlah detik untuk menunggu hingga kueri dieksekusi.

      Nilai default: 180 detik.

    2. Di kolom Jumlah baris maksimum, masukkan jumlah baris maksimum yang akan ditampilkan dari database.

      Nilai default: 25.

    3. Untuk memperbarui kueri kustom, klik Edit Skrip Kustom. Dialog Script editor akan terbuka.

      Gambar yang menampilkan custom-sql-query Gambar yang menampilkan custom-sql-query

    4. Dalam dialog Editor skrip, masukkan kueri SQL, lalu klik Simpan.

      Anda dapat menggunakan tanda tanya (?) dalam pernyataan SQL untuk merepresentasikan satu parameter yang harus ditentukan dalam daftar parameter kueri. Misalnya, kueri SQL berikut memilih semua baris dari tabel Employees yang cocok dengan nilai yang ditentukan untuk kolom LastName: 

      SELECT * FROM Employees where LastName=?

    5. Jika Anda telah menggunakan tanda tanya dalam kueri SQL, Anda harus menambahkan parameter dengan mengklik + Tambahkan Nama Parameter untuk setiap tanda tanya. Saat menjalankan integrasi, parameter ini menggantikan tanda tanya (?) dalam kueri SQL secara berurutan. Misalnya, jika Anda telah menambahkan tiga tanda tanya (?), maka Anda harus menambahkan tiga parameter sesuai urutan.

      gambar yang menampilkan add-query-param gambar yang menampilkan add-query-param

      Untuk menambahkan parameter kueri, lakukan hal berikut:

      1. Dari daftar Jenis, pilih jenis data parameter.
      2. Di kolom Nilai, masukkan nilai parameter.
      3. Untuk menambahkan beberapa parameter, klik + Tambahkan Parameter Kueri.

      6. Tindakan Execute custom query tidak mendukung variabel array.

Refresh skema

Semua entitas dan tindakan akan memiliki skema yang terkait dengannya. Misalnya, skema tindakan akan memiliki detail parameter seperti; nama parameter, dan jenis data yang sesuai. Skema (metadata) untuk entity dan tindakan diambil oleh koneksi saat runtime dari backend Anda. Jika ada update pada skema, update tersebut tidak akan otomatis ditampilkan di koneksi yang ada; Anda harus me-refresh skema secara manual. Untuk melihat skema yang diperbarui di tugas konektor yang ada, ikuti langkah-langkah berikut:
  1. Di Integration Connectors, buka halaman Connection details koneksi, lalu klik Refresh connection schema.
  2. Di Integrasi Aplikasi, Anda harus mengonfigurasi ulang tugas konektor yang ada untuk koneksi yang sama.

Pembuatan koneksi inline

Anda dapat menggunakan tugas Connectors untuk membuat koneksi baru secara langsung di Integration Connectors.

Sebelum memulai

Buat koneksi baru

Untuk membuat koneksi baru dari Integrasi Aplikasi, lakukan langkah-langkah berikut:

  1. Klik elemen tugas Konektor di perancang untuk melihat panel konfigurasi tugas Konektor.
  2. Klik Configure connector.

    Halaman Connectors Task Editor akan muncul.

  3. Lewati kolom Region.
  4. Klik Connection dan pilih opsi Create Connection dari menu drop-down.
  5. Selesaikan langkah-langkah berikut di panel Buat Koneksi:
    1. Pada langkah Location, pilih lokasi untuk koneksi.
      1. Klik Region, lalu pilih lokasi dari menu drop-down.
      2. Klik Berikutnya.
    2. Pada langkah Detail Koneksi, berikan detail tentang koneksi:
      1. Konektor: Pilih jenis konektor yang ingin Anda buat dari daftar drop-down. Untuk mengetahui informasi tentang daftar konektor yang didukung, lihat Semua Konektor Integrasi.
      2. Versi konektor: Pilih versi yang tersedia dari jenis Konektor yang dipilih dari daftar drop-down.
      3. Nama Koneksi: Masukkan nama untuk instance Koneksi.
      4. (Opsional) Masukkan Deskripsi untuk instance koneksi.
      5. (Opsional) Centang Aktifkan Cloud Logging untuk menyimpan data log instance koneksi.
      6. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
      7. (Opsional) Klik Setelan lanjutan untuk mengonfigurasi setelan node koneksi.

        Untuk mengetahui informasi selengkapnya, lihat dokumentasi koneksi masing-masing di Integration Connectors.

      8. (Opsional) Klik + TAMBAHKAN LABEL untuk menambahkan label ke koneksi dalam bentuk pasangan nilai kunci.
      9. Klik Berikutnya.
    3. Pada langkah Autentikasi, berikan detail autentikasi untuk koneksi.
      1. Metode Autentikasi yang diisi selama langkah ini didasarkan pada jenis koneksi yang dibuat.

        Jenis koneksi yang berbeda menggunakan metode autentikasi yang berbeda. Untuk mengetahui informasi selengkapnya, lihat bagian Mengonfigurasi autentikasi pada dokumentasi koneksi masing-masing di Integration Connectors.

      2. Klik Berikutnya.
    4. Tinjau: Tinjau detail koneksi dan autentikasi Anda.
    5. Klik Buat.

Praktik terbaik

Strategi penanganan error

Strategi penanganan error untuk tugas menentukan tindakan yang harus dilakukan jika tugas gagal karena error sementara. Untuk mengetahui informasi tentang cara menggunakan strategi penanganan error, dan untuk mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.

Harga

Pemicu Cloud Pub/Sub dan pemicu Salesforce tidak mengharuskan Anda membuat konektor. Namun, jika Anda menggunakan tugas Konektor untuk terhubung ke Pub/Sub atau Salesforce, Anda akan ditagih untuk penggunaan konektor. Untuk mengetahui informasi tentang harga, lihat Harga Application Integration.

Kuota dan batas

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

Langkah berikutnya