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:

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

Siapkan pengguna integrasi dengan langkah-langkah berikut:

  1. Login ke instance Salesforce dengan kredensial sysadmin Anda.
  2. Klik ikon Roda Gigi, lalu pilih Siapkan, seperti yang ditunjukkan pada gambar di bawah: gambar yang menampilkan halaman Penyiapangambar yang menampilkan halaman Penyiapan
  3. Klik Pengguna > Pengguna dari menu Administrasi.
  4. Dari panel Users, pilih tombol New User.
  5. Pada dialog User Edit, isi detail berikut:
    1. Nama Depan: Nama depan pengguna integrasi.
    2. Last Name: Nama belakang pengguna integrasi.
    3. Alamat Email: Email untuk pengguna integrasi. Idealnya, ini harus berupa email grup.
    4. 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.

    5. Peran: Pilih dari dropdown opsi.
    6. Lisensi Pengguna: Masukkan Salesforce atau, jika menggunakan organisasi uji coba, masukkan Salesforce Platform.
    7. 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.

    8. Klik Simpan.
  6. Untuk memperbarui sandi bagi pengguna integrasi baru, ikuti langkah-langkah berikut:
    1. Klik tombol Reset sandi di panel Pengguna. Email reset sandi dikirim ke alamat email yang terkait dengan pengguna.
    2. 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:

  1. Dari menu Penyiapan, klik Pengguna > Kumpulan Izin.
  2. Di panel Set Izin, klik tombol Baru.
  3. Pada dialog Permission Sets, masukkan detail berikut:
    • Label: Masukkan nama untuk Kumpulan Izin.
    • License: Pilih Salesforce dari dropdown License.
    • Klik Simpan.
  4. Dari daftar opsi setelan System, scroll ke bawah dan pilih System Permissions
  5. Di halaman System Permissions, klik tombol Edit.
  6. 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.

  7. (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.
  8. Scroll ke bagian atas daftar izin, lalu klik Simpan.
  9. Konfirmasi setelan Anda, lalu klik Simpan.

Untuk mengonfigurasi Kumpulan Izin untuk objek Salesforce:

  1. Klik Ringkasan Setelan Izin untuk kembali ke halaman konfigurasi Setelan Izin utama.
  2. Pilih Setelan Objek dari bagian Aplikasi di panel Set Izin.
  3. Scroll ke bawah, lalu pilih objek Salesforce yang memerlukan Set Izin. Contoh ini menggunakan objek Peluang.
  4. Klik tombol Edit di halaman detail objek.
  5. 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.
  6. Centang kotak untuk Object Permissions yang akan diaktifkan. Baca dan Lihat Semua direkomendasikan.
  7. Berikan Akses Baca atau Akses Edit untuk setiap kolom objek dengan memilih kotak centang yang sesuai.
  8. 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:

  1. Login ke Salesforce sebagai pengguna integrasi, menggunakan nama pengguna dan sandi yang ditetapkan di langkah sebelumnya.
  2. Dari menu utama, klik foto profil, lalu klik Setelan.
  3. Dari menu Setelan, pilih Reset Token Keamanan Saya untuk membuka panel Reset Token Keamanan.
  4. Klik tombol Reset Security Token.
  5. 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.
  6. (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:

  1. Klik ikon Roda Gigi, lalu pilih Penyiapan.
  2. Dari menu Setup, telusuri dan pilih App Manager, seperti yang ditunjukkan pada gambar di bawah: gambar yang menampilkan halaman Penyiapangambar yang menampilkan halaman Penyiapan
  3. Klik Aplikasi Terhubung Baru.
  4. 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:
      1. (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)://.
      2. Cakupan OAuth yang Dipilih: Pilih:
        • Mengakses dan mengelola data (api) Anda
        • Menjalankan permintaan atas nama Anda kapan saja (refresh_token, offline_access)
  5. Klik Simpan.
  6. Klik Lanjutkan. Anda harus memberikan otorisasi ulang dengan kode verifikasi yang dikirim ke alamat email Anda.
  7. 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.
  8. Klik tombol Kelola.
  9. Setelah berada di halaman Connected App Detail, klik tombol Edit Policies.
  10. Di bagian Kebijakan OAuth, ubah nilai di dropdown Pengguna yang Diizinkan menjadi Pengguna yang disetujui admin telah diotorisasi.
  11. Klik Simpan.
  12. Scroll ke bagian Profil dan Kumpulan Izin di halaman untuk memilih profil atau Kumpulan Izin yang ingin Anda terapkan ke aplikasi terhubung.
  13. Pilih profil atau Kumpulan Izin yang diinginkan.
  14. 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:

  1. Login ke Salesforce sebagai sysadmin.
  2. Klik ikon Roda Gigi, lalu klik Penyiapan.
  3. Menggunakan navigasi sebelah kiri, telusuri dan pilih Change Data Capture.
  4. Di halaman penyiapan Change Data Capture, temukan objek Salesforce yang ingin Anda gunakan di kolom Available Entities, lalu tarik ke kolom Selected Entities.
  5. 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:

  1. Login ke instance Salesforce dengan kredensial sysadmin Anda.
  2. Klik ikon Roda Gigi, lalu pilih Siapkan.
  3. Di panel navigasi, telusuri Platform, lalu klik Peristiwa platform.
  4. gambar yang menampilkan peristiwa platform barugambar yang menampilkan peristiwa platform baru
  5. 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.
    Untuk informasi selengkapnya tentang perilaku publikasi, lihat Peristiwa platform dan Transaksi.
  • Status Deployment (Opsional): Pilih Di-deploy jika peristiwa siap di-deploy.
  • Klik Simpan.
  • gambar yang menampilkan setelan label dan perilaku publikasi untuk peristiwa platformgambar yang menampilkan setelan label dan perilaku publikasi untuk peristiwa platform
  • Membuat kolom kustom. Untuk membuat kolom kustom, klik Baru di bagian Kolom dan Hubungan Kustom, lalu pilih jenis kolom kustom. Anda dapat membuat kolom kustom sebanyak yang diperlukan.
  • 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.

    gambar yang menampilkan detail peristiwa platform tersimpangambar yang menampilkan detail peristiwa platform tersimpan

    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:

    1. Dari menu Penyiapan, klik Pengguna > Kumpulan Izin.
    2. Di halaman Permission Sets, klik izin yang dibuat sebelumnya.
    3. Klik Setelan Objek > Plural Label of the Platform Event.
    4. Di bagian Object Permissions, aktifkan izin Read dan Create.
    5. Klik Simpan.
    6. gambar yang menampilkan izin peristiwa platformgambar yang menampilkan izin peristiwa platform

    Menambahkan pemicu Salesforce

    Untuk menambahkan pemicu Salesforce ke integrasi baru atau yang sudah ada, ikuti langkah-langkah di bawah:
    1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

      Buka Application Integration

    2. Di menu navigasi, klik Integrations.

      Halaman Integrasi akan muncul yang 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 Create.

      Tindakan ini akan membuka integrasi di editor integrasi.

    4. Di menu navigasi editor integrasi, klik Tugas untuk melihat daftar tugas dan konektor yang tersedia.
    5. Pilih integrasi yang ada atau klik Buat integrasi.
    6. Di editor integrasi, klik + Tambahkan tugas/pemicu > Pemicu untuk melihat pemicu yang tersedia
    7. Klik dan tempatkan elemen pemicu Salesforce ke desainer.

    Mengonfigurasi pemicu Salesforce

    Untuk mengonfigurasi pemicu Salesforce, lakukan langkah-langkah berikut:

    1. Klik Pemicu Salesforce di editor integrasi untuk melihat panel konfigurasi pemicu.
    2. 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.

    3. 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.

    4. 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:

    1. Di properti pemicu yang dapat diedit, klik Pilih konfigurasi instance Salesforce > + Tambahkan konfigurasi instance Salesforce baru.
    2. 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:

        Mendapatkan domain Salesforce di instance Salesforce Mendapatkan domain Salesforce di instance 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: Misalnya, jika USER_PASSWORD Anda adalah test-password dan SECURITY_TOKEN adalah 737K27NCa3O6, sandi Anda akan menjadi test-password737K27NCa3O6.
      • Gambar berikut menunjukkan kolom yang diperlukan untuk membuat profil autentikasi:

        Kredensial sandi pemilik resource OAuth 2.0 Kredensial sandi pemilik resource OAuth 2.0

      • Salesforce Organization ID: Masukkan ID organisasi instance Salesforce. Anda bisa mendapatkan ID dari administrator Salesforce.
    3. Klik Tambahkan.

    Membuat saluran Salesforce baru

    Untuk mengonfigurasi saluran Salesforce baru, lakukan langkah-langkah berikut:

    1. Di properti pemicu yang dapat diedit, klik Select a Salesforce channel configuration > + Add new Salesforce channel configuration.
    2. 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.

    3. 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.
    Parameter output untuk pemicu ini adalah variabel JSON 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