Lihat konektor yang didukung untuk Integration Aplikasi.
Pemicu Salesforce
Pemicu Salesforce memungkinkan Anda memproses peristiwa Change Data Capture (CDC) atau Enterprise Messaging Platform. Dengan pemicu ini, Anda dapat memulai integrasi berdasarkan peristiwa CDC (Create, Update, Delete, atau Undelete) atau peristiwa platform di instance Salesforce Anda.
Untuk informasi selengkapnya, lihat tutorial berikut:
- Untuk menggunakan Integrasi Aplikasi guna mengotomatiskan alur proses bisnis pemilihan rute dan penetapan kasus pelanggan Salesforce, lihat tutorial Mengotomatiskan penetapan pemilihan rute kasus Salesforce.
- Untuk menggunakan Integrasi Aplikasi guna mengotomatiskan alur pengelolaan pesanan antara aplikasi pengelolaan hubungan pelanggan (CRM) dan aplikasi perencanaan sumber daya perusahaan (ERP), lihat tutorial Mengotomatiskan peluang Salesforce untuk pesanan BigQuery.
- Untuk menggunakan pemicu Salesforce guna memanggil integrasi di Integrasi Aplikasi untuk peristiwa Salesforce Change Data Capture (CDC), lihat tutorial Memanggil integrasi untuk peristiwa Salesforce Change Data Capture (CDC).
Sebelum memulai
Bagian ini menguraikan langkah-langkah yang diperlukan untuk menghubungkan dan mengonfigurasi instance Salesforce agar dapat menggunakan peristiwa Change Data Capture (CDC) atau Platform untuk melakukan streaming perubahan ke Integrasi Aplikasi Anda dengan cara pub/sub. Langkah-langkah berikut harus diselesaikan sebelum mengonfigurasi tugas atau pemicu terkait Salesforce di Integrasi Aplikasi:
- Menyiapkan pengguna integrasi
- Mengonfigurasi kumpulan izin
- Menyiapkan token keamanan
- Membuat aplikasi terhubung
Menyiapkan pengguna integrasi
Siapkan pengguna integrasi dengan langkah-langkah berikut:
- Login ke instance Salesforce dengan kredensial
sysadmin
Anda. - Klik ikon Roda Gigi, lalu pilih Siapkan, seperti yang ditunjukkan pada gambar di bawah:
- Klik Pengguna > Pengguna dari menu Administrasi.
- Dari panel Users, pilih tombol New User.
- Pada dialog User Edit, isi detail berikut:
- Nama Depan: Nama depan pengguna integrasi.
- Last Name: Nama belakang pengguna integrasi.
- Alamat Email: Email untuk pengguna integrasi. Idealnya, ini harus berupa email grup.
- Nama pengguna: Nama pengguna yang mematuhi konvensi penamaan tingkat organisasi.
Jika Anda membuat pengguna integrasi baru, gunakan format berikut:
EMAIL.SALESFORCE_ORG_NAME.SANDBOX_NAME
Jika Anda sudah memiliki pengguna integrasi, pastikan nama pengguna dimasukkan di sini.
- Peran: Pilih dari dropdown opsi.
- Lisensi Pengguna: Masukkan
Salesforce
atau, jika menggunakan organisasi uji coba, masukkanSalesforce Platform
. - Profil: Pilih profil izin untuk pengguna integrasi dari dropdown.
Sebaiknya tetapkan profil dengan tanpa izin, untuk melindungi akses Salesforce pengguna integrasi Anda dari penggunaan yang tidak sah.
- Klik Simpan.
- Untuk memperbarui sandi bagi pengguna integrasi baru, ikuti langkah-langkah berikut:
- Klik tombol Reset sandi di panel Pengguna. Email reset sandi dikirim ke alamat email yang terkait dengan pengguna.
- Ikuti alur reset sandi dari akun email. Catat sandi baru, karena Anda akan memerlukannya untuk langkah berikutnya.
Mengonfigurasi Set Izin
Jika sudah memiliki akses ke Set Izin yang sesuai untuk pengguna integrasi, Anda dapat melewati langkah ini dan melanjutkan ke Menyiapkan token keamanan. Jika tidak, ikuti langkah-langkah berikut untuk mengonfigurasi Set Izin bagi pengguna integrasi dan objek Salesforce.
Untuk mengonfigurasi Kumpulan Izin bagi pengguna integrasi:
- Dari menu Penyiapan, klik Pengguna > Kumpulan Izin.
- Di panel Set Izin, klik tombol Baru.
- Pada dialog Permission Sets, masukkan detail berikut:
- Label: Masukkan nama untuk Kumpulan Izin.
- License: Pilih Salesforce dari dropdown License.
- Klik Simpan.
- Dari daftar opsi setelan System, scroll ke bawah dan pilih System Permissions
- Di halaman System Permissions, klik tombol Edit.
- Scroll ke bawah daftar izin yang tersedia, lalu centang kotak API Enabled.
Izin Pengguna Khusus API juga diperlukan, tetapi tidak dapat diaktifkan hingga token keamanan yang diperlukan direset. Izin ini ditambahkan di langkah berikutnya.
- (Opsional) Scroll dan pilih Ubah Semua Data dan Lihat Semua Data, jika berlaku. Izin ini tidak diperlukan, tetapi dapat berguna jika Anda ingin otomatis memberi pengguna integrasi akses ke objek baru. Sebaiknya hanya aktifkan izin ini untuk pengujian di sandbox.
- Scroll ke bagian atas daftar izin, lalu klik Simpan.
- Konfirmasi setelan Anda, lalu klik Simpan.
Untuk mengonfigurasi Kumpulan Izin untuk objek Salesforce:
- Klik Ringkasan Setelan Izin untuk kembali ke halaman konfigurasi Setelan Izin utama.
- Pilih Setelan Objek dari bagian Aplikasi di panel Set Izin.
- Scroll ke bawah, lalu pilih objek Salesforce yang memerlukan Set Izin. Contoh ini menggunakan objek Peluang.
- Klik tombol Edit di halaman detail objek.
- Centang kotak untuk jenis data. Jika Anda mengetahui jenis data yang diperlukan, pilih jenis data tersebut. Jika Anda tidak tahu jenis data yang diperlukan, pilih semuanya.
- Centang kotak untuk Object Permissions yang akan diaktifkan. Baca dan Lihat Semua direkomendasikan.
- Berikan Akses Baca atau Akses Edit untuk setiap kolom objek dengan memilih kotak centang yang sesuai.
- Scroll ke bagian atas halaman, lalu klik Simpan.
Menyiapkan Token Keamanan
Jika Anda telah membuat token keamanan untuk pengguna integrasi sebelumnya, dan mereset sandi, email dengan token keamanan baru akan dikirim secara otomatis. Anda dapat menggunakan token baru dan melanjutkan ke Membuat aplikasi terhubung.
Jika tidak, gunakan langkah-langkah berikut untuk mereset token keamanan bagi pengguna integrasi:
- Login ke Salesforce sebagai pengguna integrasi, menggunakan nama pengguna dan sandi yang ditetapkan di langkah sebelumnya.
- Dari menu utama, klik foto profil, lalu klik Setelan.
- Dari menu Setelan, pilih Reset Token Keamanan Saya untuk membuka panel Reset Token Keamanan.
- Klik tombol Reset Security Token.
- Periksa akun email yang terkait dengan pengguna integrasi untuk menemukan email yang berisi token keamanan baru. Catat token keamanan baru, karena Anda akan memerlukannya untuk langkah berikutnya.
- (Opsional) Aktifkan izin Khusus Pengguna API di Izin Sistem untuk kumpulan izin Anda, seperti yang dijelaskan di Mengonfigurasi kumpulan izin di atas.
Membuat Aplikasi yang Terhubung
Izin administrasi sistem diperlukan untuk menyiapkan Aplikasi Terhubung. Jika saat ini Anda login
sebagai pengguna integrasi, pastikan untuk logout, lalu login lagi sebagai sysadmin
.
Ikuti langkah-langkah berikut untuk menyiapkan Aplikasi Terhubung:
- Klik ikon Roda Gigi, lalu pilih Penyiapan.
- Dari menu Setup, telusuri dan pilih App Manager, seperti yang ditunjukkan pada gambar di bawah:
- Klik Aplikasi Terhubung Baru.
- Di panel konfigurasi, berikan detail berikut:
- Connected App Name: Masukkan nama untuk aplikasi yang terhubung.
- API Name: Masukkan nama API.
- Email kontak: Masukkan email untuk aplikasi yang terhubung, idealnya alias email grup.
- API (Aktifkan Setelan OAuth): Pilih Aktifkan Setelan OAuth. Kemudian, tetapkan hal berikut:
- (Opsional) URL Panggilan Balik: Ini hanya diperlukan jika Anda ingin layanan eksternal melakukan validasi.
Jika Anda memilih untuk memberikan callback, pastikan untuk menyertakan awalan
http(s)://
. - Cakupan OAuth yang Dipilih: Pilih:
- Mengakses dan mengelola data (api) Anda
- Menjalankan permintaan atas nama Anda kapan saja (refresh_token, offline_access)
- (Opsional) URL Panggilan Balik: Ini hanya diperlukan jika Anda ingin layanan eksternal melakukan validasi.
Jika Anda memilih untuk memberikan callback, pastikan untuk menyertakan awalan
- Klik Simpan.
- Klik Lanjutkan. Anda harus memberikan otorisasi ulang dengan kode verifikasi yang dikirim ke alamat email Anda.
- Setelah berhasil memverifikasi kode, secret konsumen dan kunci konsumen akan ditampilkan di halaman berikutnya. Catat nilai ini, karena akan digunakan saat menyiapkan Modul Autentikasi untuk Integrasi Aplikasi.
- Klik tombol Kelola.
- Setelah berada di halaman Connected App Detail, klik tombol Edit Policies.
- Di bagian Kebijakan OAuth, ubah nilai di dropdown Pengguna yang Diizinkan menjadi Pengguna yang disetujui admin telah diotorisasi.
- Klik Simpan.
- Scroll ke bagian Profil dan Kumpulan Izin di halaman untuk memilih profil atau Kumpulan Izin yang ingin Anda terapkan ke aplikasi terhubung.
- Pilih profil atau Kumpulan Izin yang diinginkan.
- Klik Simpan.
Langkah-langkah prasyarat untuk menggunakan peristiwa CDC
Sebelum mengonfigurasi pemicu Integrasi Aplikasi untuk menggunakan peristiwa CDC, pastikan untuk menambahkan objek yang dikonfigurasi ke CDC di Salesforce:
- Login ke Salesforce sebagai
sysadmin
. - Klik ikon Roda Gigi, lalu klik Penyiapan.
- Menggunakan navigasi sebelah kiri, telusuri dan pilih Change Data Capture.
- Di halaman penyiapan Change Data Capture, temukan objek Salesforce yang ingin Anda gunakan di kolom Available Entities, lalu tarik ke kolom Selected Entities.
- Klik Simpan.
Langkah-langkah prasyarat untuk menggunakan peristiwa Platform
Sebelum mengonfigurasi pemicu Integrasi Aplikasi untuk menggunakan peristiwa Platform, selesaikan langkah-langkah berikut di Salesforce:
- Membuat Peristiwa Platform
- Memperbarui izin untuk Peristiwa Platform
Membuat peristiwa Platform
Untuk membuat peristiwa Platform, lakukan langkah-langkah berikut:
- Login ke instance Salesforce dengan kredensial
sysadmin
Anda. - Klik ikon Roda Gigi, lalu pilih Siapkan.
- Di panel navigasi, telusuri Platform, lalu klik Peristiwa platform.
- Di halaman Peristiwa platform, klik Peristiwa Platform Baru dan tetapkan properti berikut:
- Label
- Label Jamak
- Nama Objek(Kolom ini diisi secara otomatis)
- Perilaku Publikasi
Pilih salah satu nilai berikut:
- Publish After Commit: Mengembalikan streaming peristiwa jika kondisi tidak terpenuhi.
- Segera Publikasikan: Segera memicu peristiwa, tanpa menunggu validasi apa pun.
- Status Deployment (Opsional): Pilih Di-deploy jika peristiwa siap di-deploy.
Setelah membuat kolom kustom, di halaman Peristiwa platform, perhatikan nilai kolom Nama API. Nama objek diakhiri dengan _e, yang berarti objek tersebut adalah objek Peristiwa Platform. Untuk objek CDC, nama objek diakhiri dengan _c.
Memperbarui izin untuk Peristiwa Platform
Izin yang ditetapkan harus diperbarui agar pengguna integrasi dapat mengakses Peristiwa Platform yang baru dibuat.
Untuk memperbarui izin, lakukan langkah-langkah berikut:
- Dari menu Penyiapan, klik Pengguna > Kumpulan Izin.
- Di halaman Permission Sets, klik izin yang dibuat sebelumnya.
- Klik Setelan Objek > Plural Label of the Platform Event.
- Di bagian Object Permissions, aktifkan izin Read dan Create.
- Klik Simpan.
Menambahkan pemicu Salesforce
Untuk menambahkan pemicu Salesforce ke integrasi baru atau yang sudah ada, ikuti langkah-langkah di bawah:- Di konsol Google Cloud, buka halaman Integrasi Aplikasi.
- Di menu navigasi, klik Integrations.
Halaman Integrasi akan muncul yang mencantumkan semua integrasi yang tersedia di project Google Cloud.
- Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.
Jika Anda membuat integrasi baru:
- Masukkan nama dan deskripsi di panel Buat Integrasi.
- Pilih region untuk integrasi.
- Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasi di toolbar integrasi.
- Klik Create.
Tindakan ini akan membuka integrasi di editor integrasi.
- Di menu navigasi editor integrasi, klik Tugas untuk melihat daftar tugas dan konektor yang tersedia.
- Pilih integrasi yang ada atau klik Buat integrasi.
- Di editor integrasi, klik + Tambahkan tugas/pemicu > Pemicu untuk melihat pemicu yang tersedia
- Klik dan tempatkan elemen pemicu Salesforce ke desainer.
Mengonfigurasi pemicu Salesforce
Untuk mengonfigurasi pemicu Salesforce, lakukan langkah-langkah berikut:
- Klik Pemicu Salesforce di editor integrasi untuk melihat panel konfigurasi pemicu.
- Pilih instance Salesforce dari dropdown Konfigurasi instance Salesforce.
Jika Anda tidak memiliki instance Salesforce, buat instance baru. Untuk mengetahui informasi selengkapnya, lihat Membuat instance Salesforce baru.
- Pilih saluran Salesforce dari drop-down Konfigurasi saluran Salesforce.
Jika Anda tidak memiliki channel Salesforce, buat channel baru. Untuk informasi selengkapnya, lihat Membuat saluran Salesforce baru.
- Jika Anda telah memilih jenis peristiwa sebagai CDC, pilih salah satu operasi berikut:
Create
Update
Delete
Undelete
Pemicu hanya berjalan jika operasi tertentu atau operasi kesenjangan terjadi.
Pemicu Salesforce hanya dapat dikonfigurasi untuk satu operasi. Jika Anda ingin menjalankan pemicu untuk beberapa operasi, buat pemicu Salesforce untuk setiap operasi.
Membuat instance Salesforce baru
Untuk mengonfigurasi instance Salesforce baru, lakukan langkah-langkah berikut:
- Di properti pemicu yang dapat diedit, klik Pilih konfigurasi instance Salesforce > + Tambahkan konfigurasi instance Salesforce baru.
- Di dialog Tambahkan konfigurasi instance Salesforce, tetapkan properti berikut:
- Nama koneksi instance Salesforce: Masukkan nama untuk instance.
Setelah konfigurasi, Anda akan menggunakan nama ini untuk merujuk ke instance Salesforce.
- Domain Salesforce: Masukkan otoritas layanan untuk instance. Anda dapat menemukan domain di akun Salesforce. Misalnya,
instance.my.salesforce.com
. Gambar berikut menampilkan domain Salesforce: - Profil autentikasi: Pilih profil autentikasi.
Jika Anda tidak memiliki profil autentikasi, buat profil baru dari jenis autentikasi kredensial sandi pemilik resource OAuth 2.0. Untuk informasi tentang kolom, lihat Kredensial sandi pemilik resource OAuth 2.0. Untuk instance Salesforce, masukkan nilai berikut:
- Client ID: masukkan kunci konsumen yang Anda catat saat menyiapkan aplikasi terhubung.
- Rahasia: masukkan rahasia konsumen yang Anda catat saat menyiapkan aplikasi terhubung.
- Sandi: Masukkan sandi pengguna dengan format
USER_PASSWORDSECURITY_TOKEN
. Ganti kode berikut:USER_PASSWORD
: sandi pengguna Salesforce.SECURITY_TOKEN
: token keamanan yang Anda tetapkan untuk integrasi.
USER_PASSWORD
Anda adalahtest-password
danSECURITY_TOKEN
adalah737K27NCa3O6
, sandi Anda akan menjaditest-password737K27NCa3O6
.
- Salesforce Organization ID: Masukkan ID organisasi instance Salesforce. Anda bisa mendapatkan ID dari administrator Salesforce.
- Klik Tambahkan.
Gambar berikut menunjukkan kolom yang diperlukan untuk membuat profil autentikasi:
Membuat saluran Salesforce baru
Untuk mengonfigurasi saluran Salesforce baru, lakukan langkah-langkah berikut:
- Di properti pemicu yang dapat diedit, klik Select a Salesforce channel configuration > + Add new Salesforce channel configuration.
- Di dialog Tambahkan konfigurasi saluran Salesforce, masukkan nama objek untuk properti Nama objek Salesforce.
Untuk daftar objek Salesforce, lihat Objek standar di Salesforce. Jika tidak yakin dengan nama objek, hubungi administrator Salesforce Anda.
- Klik Tambahkan.
Variabel output
Respons dari pemicu Salesforce tersedia untuk Anda di variabel output.
Variabel output untuk peristiwa CDC dijelaskan dalam tabel berikut:
Variabel | Data type | Deskripsi |
SalesforceTriggerCdcPayload | JSON | Detail peristiwa perubahan. |
SalesforceTriggerEvent | JSON | Berisi replayId peristiwa. |
SalesforceTriggerSchema | String | Skema pemicu. |
SalesforceTriggerCdcSnapshot | JSON | Ringkasan objek setelah peristiwa perubahan. Kolom ini hanya tersedia untuk
operasi Update dan Create . |
SalesforceTriggerCdcRecordId | String | Berisi recordId data yang diperbarui atau ditambahkan. recordId adalah
ID objek Salesforce yang diubah. |
Variabel output untuk peristiwa Platform dijelaskan dalam tabel berikut:
Variabel | Data type | Deskripsi |
SalesforceTriggerPEPayload | JSON | Detail peristiwa perubahan. |
SalesforceTriggerEvent | JSON | Berisi replayId peristiwa. |
SalesforceTriggerSchema | String | Skema pemicu. |
CdcTriggerPayload
. Variabel JSON berisi objek data yang diperbarui.
Praktik terbaik
Penggunaan pemicu Salesforce direkomendasikan jika Anda ingin menggunakan notifikasi Salesforce untuk memicu integrasi tanpa menulis kode kustom untuk memublikasikan peristiwa Salesforce. Setiap perubahan kecil pada kolom di kasus Salesforce Anda akan memicu peristiwa CDC Salesforce, sehingga memicu integrasi, yang dapat menyebabkan derau integrasi yang signifikan. Sebaiknya gunakan Filter peristiwa perubahan untuk memfilter hanya peristiwa CDC yang diperlukan yang memicu integrasi. Menggunakan Ubah filter peristiwa dapat membantu mengurangi derau integrasi dan memastikan kepatuhan terhadap batasan lisensi Anda.
Demikian pula, sebaiknya batalkan publikasi integrasi apa pun yang menggunakan pemicu ini jika integrasi tidak lagi diperlukan. Hingga dihapus atau tidak dipublikasikan, integrasi akan terus memproses peristiwa CDC dan Platform Salesforce.
Pertimbangan
Sebelum menggunakan pemicu Salesforce untuk menjalankan integrasi, pertimbangkan hal berikut:
- Salesforce mengirim maksimum 100 ribu peristiwa CDC dan Platform per hari. Jika membeli lebih banyak kapasitas peristiwa platform dari Salesforce, Anda dapat memublikasikan lebih dari 10 juta peristiwa per hari. Untuk informasi selengkapnya, lihat Alokasi Peristiwa Platform. Hubungi administrator Salesforce Anda untuk memahami batasan lisensi sebelum memilih peristiwa CDC untuk pemicu integrasi Anda.
- Jika Anda berencana melakukan upload massal ke Salesforce, pertimbangkan untuk menjeda CDC guna mengurangi derau integrasi dan memastikan kepatuhan terhadap batasan lisensi Anda.
- Ukuran pesan peristiwa maksimum yang dapat dipublikasikan Salesforce adalah 1 MB. Untuk mengetahui informasi selengkapnya, lihat Mengubah Alokasi Pengambilan Data.
- Integrasi Aplikasi tidak mendukung peristiwa CDC Salesforce untuk wilayah berikut:
asia-northeast1
asia-south1
australia-southeast1
europe-west2
europe-west3
europe-west6
northamerica-northeast1
southamerica-east1
us-east4
us-west2
Pengecualian SLA
Pemicu Salesforce bergantung pada produk Salesforce. Karena dependensi ini bersifat eksternal terhadap Integrasi Aplikasi, persyaratan dan ketentuan Perjanjian Tingkat Layanan (SLA) Integration Aplikasi hanya berlaku jika pemicu Salesforce berhasil memulai eksekusi integrasi active
.
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 Integrasi Aplikasi.
Kuota dan batas
Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.
Langkah selanjutnya
- Pelajari semua tugas dan pemicu.
- Pelajari cara menguji dan memublikasikan integrasi.
- Pelajari penanganan error.
- Pelajari log eksekusi integrasi.