Membaca tugas Catatan Salesforce

Pengumuman: Application Integration kini tersedia untuk project Google Cloud Anda. Anda kini dapat menggunakan Apigee Integration dan Application Integration dalam project Google Cloud yang sama. Pelajari lebih lanjut

Ada dua jenis tugas yang tersedia di Integrasi Apigee - tugas Core dan tugas Konektor. Tugas Membaca Data Salesforce adalah tugas Konektor yang memungkinkan Anda membaca data Salesforce yang ada di instance Salesforce Anda.

Sebelum memulai

Bagian ini menguraikan langkah-langkah yang diperlukan untuk menghubungkan dan mengonfigurasi instance Salesforce untuk digunakan Change Data Capture (CDC) atau Peristiwa platform untuk mengalirkan perubahan ke Integrasi Apigee Anda di pub/sub. Langkah-langkah berikut harus diselesaikan sebelum mengonfigurasi aset yang terkait dengan Salesforce tugas atau pemicu di Integrasi Apigee:

• Menyiapkan pengguna integrasi
• Mengonfigurasi kumpulan izin
• Menyiapkan token keamanan
• Membuat aplikasi yang terhubung

Catatan: Untuk menyelesaikan langkah-langkah ini, akses administrasi sistem ke instance Salesforce Anda tidak diperlukan. Jika Anda tidak memiliki akses admin, bagikan dengan Administrator Salesforce.

Tutorial ini memberikan instruksi mendalam, tetapi kami menyarankan Anda agar memiliki pemahaman tentang Opsi konfigurasi Salesforce. Salesforce memberikan detail Dokumentasi Developer untuk membantu Anda memulai.

Menyiapkan pengguna integrasi

Catatan: Jika sudah memiliki pengguna integrasi dan mengetahui sandinya, Anda dapat melanjutkan ke langkah berikutnya. Jika Anda perlu mereset sandi, lihat Langkah 6 di bawah.

Siapkan Pengguna integrasi dengan langkah-langkah berikut:

1. Login ke instance Salesforce dengan kredensial sysadmin Anda.
2. Klik ikon Roda Gigi, lalu pilih Penyiapan, seperti yang ditunjukkan pada gambar di bawah:
3. Klik Pengguna > Pengguna dari menu Administration.
4. Dari panel Users, pilih tombol New User.
5. Pada dialog Edit Pengguna, isi detail berikut:
   1. Nama Depan: Nama depan pengguna integrasi.
   2. Nama Belakang: 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 menu 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 menu dropdown.

      Sebaiknya tetapkan profil tanpa izin, untuk melindungi pengguna integrasi Anda Akses Salesforce dari penggunaan yang tidak sah.

   8. Klik Simpan.
6. Untuk memperbarui sandi pengguna integrasi baru, ikuti langkah-langkah berikut:
   1. Klik tombol Reset sandi di panel Pengguna. Email pengaturan ulang kata sandi dikirimkan ke alamat email yang terkait dengan pengguna.
      Catatan: Pastikan Anda memiliki akses ke akun email yang terkait dengan pengguna integrasi sebelum memicu untuk mengatur ulang alur {i>password<i}. Selain itu, jika Anda mengaktifkan SSO untuk pengguna ini, Anda tidak akan dapat mereset sandi. Untuk mengaktifkan opsi reset, buka Profil > Izin Sistem, lalu hapus centang opsi SSO Login Enabled.
   2. Ikuti alur reset sandi dari akun email. Catat sandi baru, karena Anda akan memerlukannya untuk langkah berikutnya.

Mengonfigurasi Kumpulan Izin

Jika Anda sudah memiliki akses ke Kumpulan Izin yang sesuai untuk pengguna integrasi, Anda dapat melewatinya dan lanjutkan ke Menyiapkan token keamanan. Jika tidak, ikuti langkah-langkah berikut untuk mengonfigurasi Kumpulan Izin bagi pengguna integrasi dan objek Salesforce.

Untuk mengonfigurasi Kumpulan Izin bagi pengguna integrasi:

1. Dari menu Setup, klik Users > Kumpulan Izin.
2. Di panel Permission Set, klik tombol New.
3. Dalam dialog Set Izin, masukkan detail berikut:
   • Label: Masukkan nama untuk Kumpulan Izin.
   • Lisensi: Pilih Salesforce dari dropdown Lisensi.
   • Klik Simpan.
4. Dari daftar opsi setelan Sistem, scroll ke bawah dan pilih Izin Sistem
5. Di halaman System Permissions, klik tombol Edit.
6. Scroll ke bawah pada daftar izin yang tersedia, lalu centang kotak API Enabled.

   Izin Api Only User juga diperlukan, tetapi tidak dapat diaktifkan hingga token keamanan yang diperlukan direset. Izin ini ditambahkan pada langkah berikutnya.

7. (Opsional) Scroll dan pilih Ubah Semua Data dan Lihat Semua Data, jika ada. Izin ini tidak diperlukan, tetapi dapat berguna jika Anda ingin secara otomatis memberikan akses pengguna integrasi ke objek baru. Saran dari kami hanya mengaktifkan izin ini untuk pengujian di sebuah {i>sandbox<i}.
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 Kumpulan Izin untuk kembali ke halaman konfigurasi Kumpulan Izin utama.
2. Pilih Object Settings dari bagian Apps pada panel Permissions Set.
3. Scroll ke bawah dan pilih objek Salesforce yang memerlukan Kumpulan Izin. Contoh ini menggunakan objek Opportunity.
   CATATAN: CDC hanya mendukung subset objek Salesforce standar. Untuk mempelajari lebih lanjut, lihat: Mengubah Dukungan Objek Peristiwa.
4. Klik tombol Edit di halaman detail objek.
5. Pilih kotak centang untuk jenis {i>record<i} jika Anda tahu {i>record<i} mana jenis wajib diisi, pilih jenis tersebut. Jika Anda tidak mengetahui jenis data yang diperlukan, pilih semuanya.
6. Pilih kotak centang Object Permissions yang akan diaktifkan. Baca dan Lihat Semua direkomendasikan.
7. Berikan Akses Baca atau Akses Edit untuk setiap kolom objek dengan memilih objek yang sesuai .
   Catatan: Akses tulis tidak diperlukan untuk digunakan dengan CDC.
8. Scroll ke bagian atas halaman, lalu klik Simpan.

Siapkan Token Keamanan

Jika Anda telah membuat token keamanan untuk pengguna integrasi sebelumnya, dan mengatur ulang kata sandi, email berisi token keamanan baru dikirim secara otomatis. Anda dapat menggunakan token baru dan langsung membuka bagian Membuat aplikasi yang 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 Settings, pilih Reset My Security Token untuk membuka panel Reset Security Token.
4. Klik tombol Reset Security Token.
5. Periksa akun email yang terkait dengan pengguna integrasi untuk mengetahui 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 yang Terhubung. Jika saat ini Anda mencatat sebagai pengguna integrasi, pastikan Anda logout, lalu login lagi sebagai sysadmin.

Ikuti langkah-langkah berikut untuk menyiapkan Aplikasi yang Terhubung:

1. Klik ikon Roda Gigi, lalu pilih Penyiapan.
2. Dari menu Penyiapan, telusuri dan pilih App Manager, seperti yang ditunjukkan pada gambar di bawah:
3. Klik Aplikasi Terhubung Baru.
4. Di panel konfigurasi, berikan detail berikut:
   • Nama Aplikasi yang Terhubung: Masukkan nama untuk aplikasi yang terhubung.
   • Nama API: Masukkan nama API.
   • Email kontak: Masukkan email untuk aplikasi Anda yang terhubung, idealnya alias email grup.
   • API (Aktifkan Setelan OAuth): Pilih Aktifkan Setelan OAuth. Lalu, tetapkan nilai berikut:
     1. (Opsional) URL Callback: 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 Anda (api)
        • Melakukan permintaan atas nama Anda kapan saja (refresh_token, offline_access)
5. Klik Simpan.
   Catatan: Aplikasi terhubung yang baru dibuat tidak akan berfungsi selama 2-10 menit awal setelah pembuatan.
6. Klik Lanjutkan.
7. Rahasia konsumen dan kunci konsumen akan ditampilkan di halaman berikutnya. Perhatikan nilai-nilai ini, karena akan digunakan saat menyiapkan Modul Auth untuk Apigee.
8. Klik tombol Manage.
9. Setelah berada di halaman Detail Aplikasi yang Terhubung, klik tombol Edit Kebijakan.
10. Di bagian OAuth Policy, ubah nilainya pada dropdown Izin Pengguna ke pengguna yang disetujui Admin telah diberi otorisasi sebelumnya.
11. Klik Simpan.
12. Scroll ke bagian Profil dan Kumpulan Izin halaman untuk memilih profil atau Kumpulan Izin yang ingin Anda terapkan ke aplikasi yang terhubung.
    Anda dapat memilih profil atau Kumpulan Izin, atau campuran keduanya, yang akan memungkinkan pengguna dengan profil yang benar atau Permission Set untuk mengakses aplikasi yang terhubung.
13. Pilih profil atau Set Izin yang diinginkan.
14. Klik Simpan.

Autentikasi

Untuk menggunakan tugas ini, Anda harus menyiapkan profil autentikasi dengan Kredensial klien OAuth 2.0. Integrasi Apigee menggunakan autentikasi untuk terhubung ke instance Salesforce. Untuk membuat profil otentikasi, lakukan langkah-langkah berikut:

1. Di properti tugas yang dapat diedit, klik +New authentication profile untuk membuka dialog Authentication profile.
2. Tetapkan properti berikut:
   • Di bagian Authentication type, pilih OAuth 2.0 resource owner password credentials.
   • Endpoint token:
     • Untuk sandbox, masukkan https://test.salesforce.com/services/oauth2/token
     • Untuk produksi, masukkan https://login.salesforce.com/services/oauth2/token
   • Client-ID: Masukkan ID unik klien.

     Client ID adalah kunci konsumen aplikasi yang terhubung. Anda dapat menemukan kunci konsumen di halaman Manage Connected Apps aplikasi yang terhubung atau dari definisi aplikasi yang terhubung.

   • Secret: Masukkan rahasia klien.

     Rahasia klien adalah rahasia konsumen aplikasi yang terhubung. Anda dapat menemukan rahasia konsumen di laman Kelola Aplikasi yang Terhubung aplikasi yang tersambung atau dari definisi aplikasi yang terhubung.

   • Cakupan: Cakupan token akses.

     Cakupan memungkinkan Anda menentukan izin akses untuk pengguna. Anda dapat menentukan beberapa {i>scope<i} yang dipisahkan oleh spasi.

   • Nama pengguna: Nama pengguna untuk autentikasi.
   • Sandi: Sandi pengguna.
   • Jenis permintaan: Pilih salah satu nilai berikut:
     • Parameter kueri
     • Isi permintaan

     Jenis permintaan yang Anda pilih harus didukung oleh instance Salesforce.

   • Parameter token: Parameter permintaan yang diperlukan untuk mendapatkan token.
   • Nama profil autentikasi: Nama profil autentikasi.
   • Deskripsi profil autentikasi: Deskripsi profil autentikasi.
   • Sertifikat SSL: Upload sertifikat SSL/TLS dan kunci Pribadi yang sesuai.

     Jika kunci pribadi memiliki frasa sandi, masukkan frasa sandi.

3. Klik Simpan.

Mengonfigurasi tugas Baca Data Salesforce

Untuk mengonfigurasi tugas Baca Data Salesforce:

1. Buka UI Apigee dan login.
2. Pilih organisasi Anda menggunakan menu drop-down di sudut kiri atas UI.
3. Klik Develop > Integrasi.
4. Telusuri atau pilih integrasi yang ingin diedit dari daftar Integrations dan klik untuk membuka desainer integrasi.
5. Klik +Tambahkan tugas/pemicu > Tasks untuk melihat daftar tugas yang tersedia.
6. Tarik elemen Baca Data Salesforce ke desainer integrasi.
7. Klik elemen Baca Data Salesforce pada desainer untuk melihat tugas Membaca Data Salesforce panel konfigurasi.
8. Pilih Authentication profile yang Anda buat sebelumnya dari dropdown Authentication.
9. Konfigurasikan kolom yang tersisa menggunakan properti konfigurasi tugas.
10. Perubahan pada properti disimpan secara otomatis.

Properti konfigurasi

Tabel berikut menjelaskan properti konfigurasi tugas Baca Data Salesforce.

Properti	Data type	Deskripsi
Domain Salesforce	String	Nama instance Salesforce yang ingin Anda hubungkan. Domain Salesforce tersedia di URL instance Salesforce. Contoh, INSTANCE_NAME.my.salesforce.com
Versi Salesforce API	String	Versi API saat ini di instance Salesforce Anda. Versi API saat ini tersedia di instance Salesforce Anda di bagian Penyiapan > API > Buat WSDL Partner.
Nama Objek	String	Nama objek Salesforce yang ingin Anda baca.
ID Kumpulan Data	String	ID data yang akan diperbarui. Nilai ID dibuat secara otomatis saat Anda menyisipkan data. Nilai ID secara unik mengidentifikasi rekaman dan tidak berubah selama masa pakai rekaman.
Record	String	Nilai tugas yang ditampilkan. Jika operasi baca berhasil, variabel ini berisi detail objek Salesforce yang dibaca.

Coba lagi jika gagal

Anda dapat mengonfigurasi berbagai strategi percobaan ulang untuk menangani error dalam tugas. Strategi percobaan ulang memungkinkan Anda untuk menentukan cara menjalankan ulang tugas jika terjadi {i>error<i}. Untuk informasi selengkapnya, lihat Strategi penanganan error.

Pertimbangan

Batasan kuota di instance Salesforce Anda mungkin memengaruhi penggunaan tugas ini. Hubungi Admin Salesforce untuk memastikan desain integrasi Anda kompatibel dengan kuota Salesforce.