Tutorial ini menjelaskan kasus penggunaan tentang cara menggunakan Integrasi Aplikasi untuk mengotomatiskan alur proses bisnis pemilihan rute dan menetapkan kasus pelanggan Salesforce.
Ringkasan
Dalam tutorial ini, Anda akan membuat integrasi yang menggunakan pemicu Salesforce untuk berlangganan saluran kasus di Salesforce. Kasus baru di Salesforce memanggil integrasi, yang mengekstrak ID kasus dan jenis kasus. Bergantung pada jenis kasusnya, masalah atau insiden baru masing-masing akan dibuat di Jira Cloud atau ServiceNow.
Tujuan
Tutorial ini menunjukkan cara menyelesaikan tugas berikut dalam integrasi Anda:
- Siapkan Pemicu Salesforce untuk memanggil integrasi Anda.
- Menambahkan dan mengonfigurasi tugas Konektor untuk koneksi Salesforce, Jira Cloud, dan ServiceNow.
- Tambahkan dan konfigurasi tugas pemetaan data untuk mengekstrak dan memetakan detail kasus.
Biaya
Dalam tutorial ini, Anda menggunakan komponen Google Cloud yang dapat ditagih berikut:
Petunjuk dalam tutorial ini dirancang untuk menjaga penggunaan resource Anda tetap dalam batas paket Selalu Gratis Google Cloud.
Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, lihat Pembersihan.
Sebelum memulai
- Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Buat akun layanan:
-
Di konsol Google Cloud, buka halaman Buat akun layanan.
Buka Create service account - Pilih project Anda.
-
Di kolom Nama akun layanan, masukkan nama. Konsol Google Cloud akan mengisi kolom ID akun layanan berdasarkan nama ini.
Di kolom Deskripsi akun layanan, masukkan sebuah deskripsi. Sebagai contoh,
Service account for quickstart
. - Klik Buat dan lanjutkan.
-
Berikan peran berikut ke akun layanan: Secret Manager Viewer (
roles/secretmanager.viewer
), Secret Manager Secret Accessor (roles/secretmanager
).Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih peran.
Untuk memberikan peran tambahan, klik
Tambahkan peran lain, lalu tambahkan setiap peran tambahan. - Klik Lanjutkan.
-
Klik Selesai untuk menyelesaikan pembuatan akun layanan.
-
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Buat akun layanan:
-
Di konsol Google Cloud, buka halaman Buat akun layanan.
Buka Create service account - Pilih project Anda.
-
Di kolom Nama akun layanan, masukkan nama. Konsol Google Cloud akan mengisi kolom ID akun layanan berdasarkan nama ini.
Di kolom Deskripsi akun layanan, masukkan sebuah deskripsi. Sebagai contoh,
Service account for quickstart
. - Klik Buat dan lanjutkan.
-
Berikan peran berikut ke akun layanan: Secret Manager Viewer (
roles/secretmanager.viewer
), Secret Manager Secret Accessor (roles/secretmanager
).Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih peran.
Untuk memberikan peran tambahan, klik
Tambahkan peran lain, lalu tambahkan setiap peran tambahan. - Klik Lanjutkan.
-
Klik Selesai untuk menyelesaikan pembuatan akun layanan.
-
Menyiapkan lingkungan Anda
Memverifikasi penyiapan pengguna Salesforce
Tutorial ini mengasumsikan bahwa Anda sudah memiliki akun developer Salesforce dengan penyiapan pengguna dan kumpulan izin yang diperlukan. Pastikan akun Anda telah mengaktifkan Change Data Capture (CDC). Untuk informasi tentang cara membuat akun baru, lihat Menyiapkan pengguna integrasi.
Verifikasi akun Jira Cloud
Tutorial ini menggunakan Jira Cloud. Anda dapat menggunakan akun Jira Cloud yang ada atau membuat akun baru. Pastikan project dan board Jira Cloud Anda sudah siap. Untuk mengetahui informasi selengkapnya tentang Jira Cloud, lihat dokumentasi software Jira.
Memverifikasi instance ServiceNow
Tutorial ini menggunakan Instance Developer Pribadi (PDI) gratis ServiceNow. Anda dapat menggunakan instance ServiceNow yang ada atau membuat yang baru. Pastikan instance Anda aktif dan catat URL instance-nya. Untuk mengetahui informasi selengkapnya tentang PDI, lihat dokumentasi PDI ServiceNow.
Mengonfigurasi koneksi
Untuk tutorial ini, Anda harus mengonfigurasi koneksi berikut dalam Integrasi Integrasi:
- Koneksi Salesforce
- Mengonfigurasi koneksi Salesforce di Integration Connectors. Untuk informasi tentang cara mengonfigurasi konektor Salesforce, lihat konektor Salesforce.
- Koneksi Cloud Jira
- Konfigurasikan koneksi Cloud Jira di Integration Connectors menggunakan URL project Anda untuk menimbulkan masalah Jira di project Anda. Pastikan untuk mencatat project ID dan ID masalah. Untuk mengetahui informasi tentang cara mengonfigurasi konektor Cloud Jira, lihat konektor Jira Cloud.
- Koneksi ServiceNow
- Konfigurasikan koneksi ServiceNow di Integration Connectors menggunakan URL instance untuk membuat insiden di ServiceNow. Untuk mengetahui informasi tentang cara mengonfigurasi konektor ServiceNow, lihat konektor ServiceNow.
Buat integrasi
Untuk membuat integrasi baru, lakukan langkah-langkah berikut:
- Di konsol Google Cloud, buka halaman Application Integration.
- Di menu navigasi, klik Integrasi. Halaman Integrations List akan muncul.
- Klik
- Nama integrasi: Masukkan
salesforce-case-integration
. - Description: Masukkan
Demo integration created for tutorial
. - Region: Pilih
us-central1
dari daftar region yang didukung. - Klik Create untuk membuka editor integrasi.
Create integration, lalu berikan detail berikut di halaman Create Integration:
- Nama integrasi: Masukkan
Siapkan pemicu integrasi
Setelah berhasil membuat integrasi, Anda dapat menambahkan dan mengonfigurasi pemicu integrasi yang memanggil integrasi untuk peristiwa yang diidentifikasi.
Untuk tutorial ini, pemicu Salesforce digunakan untuk memanggil integrasi untuk setiap kasus baru yang dibuat di Salesforce. Untuk menambahkan dan mengonfigurasi pemicu Salesforce dalam integrasi salesforce-case-integration
Anda, lakukan tindakan berikut:
- Di editor integrasi, klik Pemicu untuk menampilkan daftar pemicu yang tersedia.
- Klik dan tempatkan elemen pemicu Salesforce di editor integrasi.
- Pilih elemen pemicu Salesforce di kanvas desainer untuk membuka panel konfigurasi pemicu Salesforce.
- Konfigurasikan kolom berikut di bagian Input Pemicu:
- Jenis peristiwa: Pilih Change Data Capture (CDC) dari menu drop-down.
- Konfigurasi instance Salesforce: Klik opsi + Tambahkan konfigurasi instance Salesforce baru dari menu drop-down.
Pada dialog Add Salesforce instance configuration, lakukan tindakan berikut:
- Nama koneksi instance Salesforce: Masukkan nama koneksi untuk instance Salesforce. Contoh,
test
. - Domain Salesforce: Masukkan nama domain Salesforce Anda. Anda dapat menemukan informasi ini dari halaman akun Salesforce > Lihat profil.
- Profil autentikasi: Pilih profil autentikasi. Jika Anda tidak memiliki profil autentikasi, buat profil baru. Untuk mengetahui informasinya, lihat Membuat profil autentikasi baru.
- Klik Tambahkan.
- Nama koneksi instance Salesforce: Masukkan nama koneksi untuk instance Salesforce. Contoh,
- Konfigurasi saluran Salesforce: Klik opsi + Tambahkan konfigurasi saluran Salesforce baru dari menu drop-down.
Pada dialog Add Salesforce channel, lakukan tindakan berikut:
- Salesforce object name: Masukkan
Case
. - Klik Tambahkan.
- Salesforce object name: Masukkan
- Operasi: Pilih Buat dari menu drop-down
Perubahan pada properti disimpan secara otomatis.
Memetakan payload pemicu ke konektor Salesforce
Saat integrasi dipanggil menggunakan pemicu Salesforce, Anda mengekstrak ID kasus dan memetakannya ke konektor Salesforce untuk mengambil detail tambahan kasus tersebut.
Menghubungkan ke akun Salesforce
Lakukan langkah-langkah berikut untuk menambahkan dan mengonfigurasi tugas Konektor guna mengambil detail kasus menggunakan koneksi Salesforce:
- Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
- Klik dan tempatkan elemen Connectors di editor integrasi.
- Pilih elemen tugas Connectors pada desainer untuk melihat Connectors task configuration panel.
- Klik
Fetch Salesforce Data
.
dan ganti nama label Konektor menjadi - Klik Konfigurasi konektor.
- Lakukan tindakan berikut di halaman Connectors Task Editor:
- Di bagian Select connection, pilih region
us-central1
. - Pilih koneksi Salesforce dari daftar koneksi yang tersedia.
- Klik Next.
- Di bagian Jenis, pilih Entitas.
- Di bagian Set entity/actions, pilih Kasus dari daftar entity yang tersedia, lalu pilih Get sebagai Operation.
- Klik Done untuk menyelesaikan konfigurasi koneksi dan menutup panel.
- Di bagian Select connection, pilih region
Mengekstrak dan memetakan ID kasus
Tugas Pemetaan Data digunakan untuk memetakan dan mengekstrak detail kasus antara pemicu Salesforce dan konektor Salesforce.
Untuk menambahkan dan mengonfigurasi pemetaan data dalam integrasi Anda, lakukan hal berikut:
- Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
- Klik dan tempatkan elemen Data Mapping di editor integrasi.
- Pilih elemen Data Mapping pada desainer untuk melihat panel konfigurasi tugas.
- Klik
Get Case ID
.
dan ganti nama tugas Data Mapping menjadi - Klik Open Data Mapping Editor.
Data Mapping Editor memungkinkan Anda memetakan variabel input ke variabel output yang diinginkan, menggunakan fungsi transformasi yang tersedia. Outputnya kemudian tersedia sebagai variabel untuk pemicu atau tugas integrasi lainnya. Untuk detail selengkapnya tentang pemetaan variabel, lihat Menambahkan pemetaan.
- Petakan pemicu —
SalesforceTriggerCdcRecordID
—variabel output ke konektor yang dibuat otomatis—entityId(Fetch Salesforce Data)
—variabel input.Setelah pemetaan selesai, tutup panel tersebut. Setiap perubahan akan disimpan otomatis.
- Menambahkan koneksi edge dari pemicu Salesforce ke tugas Get Case ID.
- Menambahkan koneksi edge dari tugas Dapatkan ID Kasus ke konektor Mengambil Data Salesforce.
Mengekstrak jenis kasus
Setelah mengambil semua detail kasus dari konektor Salesforce, ekstrak jenis kasus dan arahkan ke aplikasi Jira Cloud atau ServiceNow.
Untuk mengekstrak jenis kasus Salesforce, lakukan tindakan berikut:
- Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
- Klik dan tempatkan elemen Data Mapping di editor integrasi.
- Klik elemen Data Mapping pada desainer untuk melihat panel konfigurasi tugas.
- Klik
Get case type
.
dan ganti nama tugas Data Mapping menjadi - Klik Open Data Mapping Editor.
- Klik + Tambahkan variabel baru, lalu buat variabel output berikut:
Nama variabel output Jenis data sf_case_type
STRING
- Buat pemetaan berikut antara variabel payload konektor Salesforce dan variabel lokal:
Input Output connectorOutputPayload (Fetch Salesforce Data) .GET_PROPERTY("Type")
sf_case_type
Setelah pemetaan selesai, tutup panel tersebut. Setiap perubahan akan disimpan otomatis.
- Menambahkan koneksi edge dari konektor Mengambil Data Salesforce ke tugas Mendapatkan jenis kasus.
Buat masalah di Jira baru
Setelah mengekstrak jenis kasus Salesforce, dan jika jenis kasusnya adalah: Engineering
, arahkan ke Jira Cloud sebagai masalah baru.
Hubungkan ke project Jira
Lakukan langkah-langkah berikut untuk mengonfigurasi tugas Konektor yang menimbulkan masalah baru di project Jira Anda:
- Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
- Klik dan tempatkan elemen Connectors di editor integrasi.
- Klik elemen tugas Connectors pada desainer untuk melihat Connectors task configuration panel.
- Klik
Create issue in Jira
.
dan ganti nama Konektor menjadi - Klik Konfigurasi konektor.
- Lakukan tindakan berikut di halaman Connectors Task Editor:
- Di bagian Select connection, pilih region
us-central1
. - Pilih koneksi Jira Cloud Anda dari daftar koneksi yang tersedia.
- Klik Next.
- Di bagian Jenis, pilih Entitas.
- Di bagian Set entity/actions, pilih Masalah dari daftar entity yang tersedia, lalu pilih Create sebagai Operation.
- Klik Done untuk menyelesaikan konfigurasi koneksi dan menutup panel.
- Di bagian Select connection, pilih region
Detail masalah transformasi dan peta
Untuk mengubah detail kasus dan memetakannya ke masalah Jira, lakukan hal berikut:
- Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
- Klik dan tempatkan elemen Data Mapping di editor integrasi.
- Klik elemen Data Mapping pada desainer untuk melihat panel konfigurasi tugas.
- Klik
Mapping for issue creation
.
dan ganti nama tugas Data Mapping menjadi - Klik Open Data Mapping Editor.
- Klik + Tambahkan variabel baru, lalu buat variabel berikut:
Nama variabel Jenis data Nilai default jira_project-id
STRING
Ganti JIRA_PROJECT_ID dengan project ID Jira Anda.JIRA_PROJECT_ID
jira_issue_type_id
STRING
Ganti JIRA_ISSUE_TYPE_ID dengan salah satu ID jenis masalah berikut:JIRA_ISSUE_TYPE_ID
1000
- untuk Epic1001
- untuk Story1002
- untuk Tugas1003
- untuk Sub-tugas1004
- untuk Bug
- Buat pemetaan berikut:
Input Output "{ "IssueTypeId": jira_issue_type_id, "ProjectId": jira_project_id }" .TO_JSON() .SET_PROPERTY( connectorOutputPayload.Description (Fetch Salesforce Data), "Description" ) .SET_PROPERTY( connectorOutputPayload.Subject (Fetch Salesforce Data), "Summary" )
connectorInputPayload (Create issue in Jira)
Setelah pemetaan selesai, tutup panel tersebut. Setiap perubahan akan disimpan otomatis.
- Menambahkan koneksi edge dari tugas Pemetaan untuk pembuatan masalah ke konektor Create issue in Jira.
Membuat insiden ServiceNow baru
Jika kasus yang diekstrak dari Salesforce adalah jenis: Sales
, arahkan kasus tersebut ke ServiceNow sebagai insiden baru.
Hubungkan ke ServiceNow
Lakukan langkah-langkah berikut untuk mengonfigurasi tugas Connectors yang membuat insiden baru ke instance ServiceNow Anda:
- Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
- Klik dan tempatkan elemen Connectors di editor integrasi.
- Klik elemen tugas Connectors pada desainer untuk melihat Connectors task configuration panel.
- Klik
Create incident in ServiceNow
.
dan ganti nama Konektor menjadi - Klik Konfigurasi konektor.
- Lakukan tindakan berikut di halaman Connectors Task Editor:
- Di bagian Select connection, pilih region
us-central1
. - Pilih koneksi ServiceNow dari daftar koneksi yang tersedia.
- Klik Next.
- Di bagian Jenis, pilih Entitas.
- Di bagian Set entity/actions, pilih incident dari daftar entity yang tersedia, lalu pilih Create sebagai Operation.
- Klik Done untuk menyelesaikan konfigurasi koneksi dan menutup panel.
- Di bagian Select connection, pilih region
Transformasi dan petakan detail insiden
Untuk mengubah detail kasus dan memetakannya ke insiden ServiceNow, lakukan langkah berikut:
- Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
- Klik dan tempatkan elemen Data Mapping di editor integrasi.
- Klik elemen Data Mapping pada desainer untuk melihat panel konfigurasi tugas.
- Klik
Mapping for incident creation
.
dan ganti nama tugas Data Mapping menjadi - Klik Open Data Mapping Editor.
- Klik + Tambahkan variabel baru, lalu buat variabel input berikut:
- Buat pemetaan berikut:
Input Output "{}" .TO_JSON() .SET_PROPERTY( connectorOutputPayload.Description (Fetch Salesforce Data), "description" ) .SET_PROPERTY( connectorOutputPayload.Subject (Fetch Salesforce Data), "short_description" )
connectorInputPayload (Create incident in ServiceNow)
Setelah pemetaan selesai, tutup panel tersebut. Setiap perubahan akan disimpan otomatis.
- Menambahkan koneksi edge dari tugas Mapping for insiden creation ke konektor Create insiden in ServiceNow.
Tambahkan kondisi tepi
Kondisi edge memungkinkan Anda menentukan kondisi yang harus dipenuhi agar kontrol integrasi diteruskan ke tugas yang dihubungkan oleh edge. Setelah menambahkan dan mengonfigurasi tugas yang diperlukan, Anda dapat menambahkan kondisi edge untuk menentukan alur integrasi.
Kondisi edge berikut mengontrol alur integrasi berdasarkan jenis kasus Salesforce:
- Tambahkan koneksi edge dari tugas Get case type ke tugas Mapping for issue creation dengan kondisi edge berikut:
$sf_case_type$ = "Engineering"
- Tambahkan koneksi edge lain dari tugas Get case type ke tugas Mapping forIncident creation dengan kondisi edge berikut:
$sf_case_type$ = "Sales"
Contoh alur integrasi
Gambar berikut menunjukkan contoh tata letak integrasi yang dibuat menggunakan tutorial ini.
![Gambar contoh yang menunjukkan alur integrasi](https://cloud.google.com/static/application-integration/images/case-to-incident-flow.png?authuser=5&hl=id)
![Gambar contoh yang menunjukkan alur integrasi](https://cloud.google.com/static/application-integration/images/case-to-incident-flow.png?authuser=5&hl=id)
Memublikasikan dan menguji integrasi
Untuk memublikasikan integrasi, klik Publikasikan di toolbar editor integrasi.
Setelah berhasil memublikasikan integrasi, Anda dapat melihat dan memeriksa log eksekusi dari integrasi yang dipublikasikan. Untuk melihat log, klik Lihat log eksekusi untuk integrasi ini. Halaman Execution Logs akan muncul.
Kasus uji 1: Untuk memeriksa apakah masalah Jira dibuat untuk kasus pelatihan
Uji integrasi dengan login ke instance Salesforce dan membuat kasus baru. Anda harus memasukkan Engineering
di kolom Type saat membuat kasus.
Untuk memverifikasi keberhasilan integrasi Anda:
Buka akun Jira Cloud Anda.
- Periksa untuk mengonfirmasi apakah masalah baru telah dibuat dalam project Anda yang berisi deskripsi dan ringkasan kasus Salesforce.
Kasus pengujian 2: Untuk memeriksa apakah insiden ServiceNow dibuat untuk kasus penjualan
Uji integrasi dengan login ke instance Salesforce dan membuat kasus baru. Anda harus memasukkan Sales
di kolom Type saat membuat kasus.
Untuk memverifikasi keberhasilan integrasi Anda:
Buka instance ServiceNow.
- Periksa untuk mengonfirmasi apakah insiden baru telah dibuat di instance Anda yang berisi deskripsi dan ringkasan kasus Salesforce.
Pembersihan
Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, batalkan publikasi integrasi dan hapus koneksi yang dibuat di Integration Connectors.
- Untuk membatalkan publikasi integrasi ini, klik Batalkan publikasi di toolbar editor integrasi. Lihat Menghapus integrasi untuk mengetahui informasi selengkapnya.
- Untuk mengetahui informasi tentang cara menghapus koneksi, lihat Mengelola konektor.