Mengotomatiskan peluang Salesforce untuk pesanan BigQuery

---

Tutorial ini menjelaskan kasus penggunaan tentang cara menggunakan Application Integration untuk mengotomatiskan alur pengelolaan pesanan antara aplikasi pengelolaan hubungan pelanggan (CRM) dan aplikasi enterprise resource planning (ERP).

Ringkasan

Perusahaan bisnis menggunakan berbagai aplikasi CRM dan ERP untuk membuat, memproses, mengelola, dan memelihara pesanan penjualan. Masing-masing aplikasi ini ditangani oleh tim atau organisasi yang berbeda, dan memastikan bahwa pesanan terus dilacak sembari memberikan pembaruan pelanggan secara tepat waktu adalah sebuah tantangan.

Dalam tutorial ini, Anda akan membuat integrasi yang menggunakan pemicu Salesforce untuk berlangganan peristiwa peluang baru di Salesforce. Saat peluang baru dibuat, integrasi akan mengambil detail peluang tambahan, seperti ID dan nama akun. Detail ini diperiksa di tabel BigQuery untuk membuat dan memperbarui peluang dengan nomor pesanan pelacakan. Selama validasi, jika informasi akun tidak ada di BigQuery, integrasi akan secara otomatis membuat entri baru di tabel BigQuery dan instance ServiceNow yang terlampir menggunakan Integration Connectors.

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, BigQuery, dan ServiceNow.
• Tambahkan dan konfigurasi tugas pemetaan data untuk mengekstrak dan memetakan detail peluang.

Biaya

Dalam tutorial ini, Anda menggunakan komponen Google Cloud yang dapat ditagih berikut:

• Integrasi Aplikasi
• Konektor Integrasi
• BigQuery
• Secret Manager

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

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

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

4. Enable the BigQuery API.

   Enable the API

5. Buat akun layanan:

   1. Di konsol Google Cloud, buka halaman Buat akun layanan.

      Buka Create service account
   2. Pilih project Anda.

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

   4. Klik Buat dan lanjutkan.

   5. Berikan peran berikut ke akun layanan: BigQuery Data Editor (roles/bigquery.dataEditor), BigQuery Read Session User (roles/bigquery.readSessionUser), 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.

      Catatan: Kolom Peran memengaruhi resource mana yang dapat diakses oleh akun layanan di project Anda. Anda dapat mencabut peran ini atau memberikan peran tambahan di lain waktu. Dalam lingkungan produksi, jangan berikan peran Owner, Editor, atau Viewer. Sebagai gantinya, berikan peran standar atau peran khusus yang memenuhi kebutuhan Anda.
   6. Klik Lanjutkan.

   7. Klik Selesai untuk menyelesaikan pembuatan akun layanan.

6. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

7. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

8. Enable the BigQuery API.

   Enable the API

9. Buat akun layanan:

   1. Di konsol Google Cloud, buka halaman Buat akun layanan.

      Buka Create service account
   2. Pilih project Anda.

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

   4. Klik Buat dan lanjutkan.

   5. Berikan peran berikut ke akun layanan: BigQuery Data Editor (roles/bigquery.dataEditor), BigQuery Read Session User (roles/bigquery.readSessionUser), 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.

      Catatan: Kolom Peran memengaruhi resource mana yang dapat diakses oleh akun layanan di project Anda. Anda dapat mencabut peran ini atau memberikan peran tambahan di lain waktu. Dalam lingkungan produksi, jangan berikan peran Owner, Editor, atau Viewer. Sebagai gantinya, berikan peran standar atau peran khusus yang memenuhi kebutuhan Anda.
   6. Klik Lanjutkan.

   7. Klik Selesai untuk menyelesaikan pembuatan akun layanan.

Catatan: Semua API Google Cloud lain yang diperlukan seperti, Application Integration API, Secret Manager API, dan Connectors API akan diaktifkan selama penyiapan Application Integration. Untuk mengetahui detail selengkapnya, lihat Menyiapkan Integrasi Aplikasi.

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.

Menyiapkan set data dan tabel BigQuery

Untuk tutorial ini, Anda harus menyiapkan set data BigQuery dan membuat dua tabel untuk menyimpan detail peluang Salesforce dan informasi akun ServiceNow.

Menyiapkan set data BigQuery

Untuk menyiapkan set data BigQuery, lakukan hal berikut:

1. Buka halaman BigQuery di Konsol Google Cloud.

   Buka BigQuery

2. Klik panel Penjelajah lalu pilih project yang Anda gunakan untuk tutorial ini.
3. Luaskan (Actions), lalu pilih Create set data.
4. Konfigurasikan detail berikut di halaman Buat set data:
   1. ID Set Data: Masukkan Demo_order_dataset.
   2. Jenis lokasi > Wilayah: Pilih region us-central1 (lowa).
5. Klik Create dataset.

Set data Demo_order_dataset baru kini akan muncul di project Anda di panel Explorer.

Menyiapkan tabel BigQuery

Untuk membuat tabel BigQuery, lakukan langkah berikut:

1. Di panel Explorer, klik dan buka set data Demo_order_dataset yang dibuat.
2. Lakukan langkah-langkah berikut untuk membuat tabel Pesanan kosong guna menyimpan detail peluang Salesforce:
   1. Klik Buat tabel.
   2. Di bagian Destination, masukkan Orders sebagai nama tabel.
   3. Di bagian Schema, klik Edit as text, lalu tempel definisi skema JSON berikut:

      [
        {
          "name": "order_number",
          "type": "STRING",
          "mode": "NULLABLE",
          "description": "Salesforce order number"
        },
        {
          "name": "order_status",
          "type": "STRING",
          "mode": "NULLABLE",
          "description": "Sale order status"
        },
        {
          "name": "tracking_number",
          "type": "INTEGER",
          "mode": "NULLABLE",
          "description": "Salesforce tracking number"
        }
      ]
      

   4. Klik Create table.
3. Lakukan langkah-langkah berikut untuk membuat tabel Akun kosong guna menyimpan detail akun Salesforce:
   1. Klik Buat tabel.
   2. Di bagian Destination, masukkan Accounts sebagai nama tabel.
   3. Di bagian Schema, klik Edit as text, lalu tempel definisi skema JSON berikut:

      [
        {
          "name": "account_id",
          "type": "STRING",
          "mode": "NULLABLE",
          "description": "Account ID for the opportunity"
        },
        {
          "name": "name",
          "type": "STRING",
          "mode": "NULLABLE",
          "description": "Account name for the opportunity"
        }
      ]
      

   4. Klik Create table.

   Tabel Orders dan Accounts yang baru kini akan muncul di set data Demo_order_dataset di panel Explorer.

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:

Tips: Sebaiknya Anda membuat koneksi berikut di region us-central1(lowa).

Koneksi Salesforce

Mengonfigurasi koneksi Salesforce di Integration Connectors. Untuk informasi tentang cara mengonfigurasi konektor Salesforce, lihat konektor Salesforce.

Koneksi BigQuery

Konfigurasikan koneksi BigQuery di Konektor Integrasi untuk mendapatkan, memperbarui, dan memvalidasi detail pesanan dan akun dalam set data Demo_order_dataset. Untuk mengetahui informasi tentang cara mengonfigurasi konektor BigQuery, lihat konektor BigQuery.

Koneksi ServiceNow

Konfigurasikan koneksi ServiceNow di Integration Connectors menggunakan URL instance untuk membuat dan mengambil detail akun di ServiceNow. Untuk mengetahui informasi tentang cara mengonfigurasi konektor ServiceNow, lihat konektor ServiceNow.

Buat integrasi

Untuk membuat integrasi baru, lakukan langkah-langkah berikut:

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

   Buka Application Integration

2. Di menu navigasi, klik Integrasi. Halaman Integrations List akan muncul.
3. Klik Create integration, lalu berikan detail berikut di halaman Create Integration:
   1. Nama integrasi: Masukkan opportunity-to-order-integration.
   2. Description: Masukkan Demo integration created for tutorial.
   3. Region: Pilih us-central1 dari daftar region yang didukung.
   4. Klik Create untuk membuka editor integrasi.

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 peluang baru yang dibuat dalam instance Salesforce. Untuk menambahkan dan mengonfigurasi pemicu Salesforce dalam integrasi opportunity-to-order-integration Anda, lakukan tindakan berikut:

1. Di editor integrasi, klik Pemicu untuk menampilkan daftar pemicu yang tersedia.
2. Klik dan tempatkan elemen pemicu Salesforce di editor integrasi.
3. Pilih elemen pemicu Salesforce di kanvas desainer untuk membuka panel konfigurasi pemicu Salesforce.
4. Konfigurasikan kolom berikut di bagian Input Pemicu:
   1. Jenis peristiwa: Pilih Change Data Capture (CDC) dari menu drop-down.
   2. 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.
   3. 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 Opportunity.
      • Klik Tambahkan.
   4. 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 peluang dan memetakannya ke konektor Salesforce untuk mengambil detail tambahan peluang.

Menghubungkan ke akun Salesforce

Lakukan langkah-langkah berikut untuk menambahkan dan mengonfigurasi tugas Konektor guna mengambil detail peluang menggunakan koneksi Salesforce:

1. Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Connectors di editor integrasi.
3. Pilih elemen tugas Connectors pada desainer untuk melihat Connectors task configuration panel.
4. Klik dan ganti nama label Konektor menjadi Fetch Salesforce Data.
5. Klik Konfigurasi konektor.
6. Lakukan tindakan berikut di halaman Connectors Task Editor:
   1. Di bagian Select connection, pilih region us-central1.
   2. Pilih koneksi Salesforce dari daftar koneksi yang tersedia.
   3. Klik Next.
   4. Di bagian Jenis, pilih Entitas.
   5. Di bagian Set entity/actions, pilih Opportunity dari daftar entity yang tersedia, lalu pilih Get sebagai Operation.
   6. Klik Done untuk menyelesaikan konfigurasi koneksi dan menutup panel.

Mengekstrak dan memetakan ID peluang

Tugas Pemetaan Data digunakan untuk memetakan dan mengekstrak detail peluang antara pemicu Salesforce dan konektor Salesforce.

Untuk menambahkan dan mengonfigurasi pemetaan data dalam integrasi Anda, lakukan hal berikut:

1. Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Data Mapping di editor integrasi.
3. Pilih elemen Data Mapping pada desainer untuk melihat panel konfigurasi tugas.
4. Klik dan ganti nama tugas Data Mapping menjadi Map to opportunity ID.
5. 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.

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

7. Tambahkan koneksi edge dari pemicu Salesforce ke tugas Petakan ke ID peluang.
8. Tambahkan koneksi edge dari tugas Petakan ke ID peluang ke konektor Ambil Data Salesforce.

Validasi akun Salesforce di tabel BigQuery

Setelah mengambil semua detail peluang dari konektor Salesforce, Anda mengekstrak dan memetakan ID akun yang terkait dengan peluang, serta memvalidasi keberadaannya di tabel BigQuery.

Terhubung ke tabel BigQuery

Lakukan langkah-langkah berikut untuk mengonfigurasi tugas Connectors yang membaca tabel Accounts BigQuery menggunakan koneksi BigQuery:

1. Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Connectors di editor integrasi.
3. Klik elemen tugas Connectors pada desainer untuk melihat Connectors task configuration panel.
4. Klik dan ganti nama Konektor menjadi Check account in BigQuery.
5. Klik Konfigurasi konektor.
6. Lakukan tindakan berikut di halaman Connectors Task Editor:
   1. Di bagian Select connection, pilih region us-central1.
   2. Pilih koneksi BigQuery Anda dari daftar koneksi yang tersedia.
   3. Klik Next.
   4. Di bagian Jenis, pilih Entitas.
   5. Di bagian Set entity/actions, pilih akun dari daftar entity yang tersedia, lalu pilih List sebagai Operation.
   6. Klik Done untuk menyelesaikan konfigurasi koneksi dan menutup panel.
7. Tambahkan koneksi edge dari konektor Ambil Data Salesforce ke konektor Periksa akun di BigQuery.

Mengekstrak dan memvalidasi ID akun Salesforce

Untuk mengekstrak, memetakan, dan memvalidasi ID akun peluang, lakukan tindakan berikut:

1. Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Data Mapping di editor integrasi.
3. Klik elemen Data Mapping pada desainer untuk melihat panel konfigurasi tugas.
4. Klik dan ganti nama tugas Data Mapping menjadi Check account.
5. Klik Open Data Mapping Editor.
6. Klik + Tambahkan variabel baru, lalu buat variabel output berikut:

   Nama variabel output	Jenis data
   sf_account_id	STRING
   sf_account_name	STRING
   account_exists	BOOLEAN

7. Buat pemetaan berikut antara variabel payload konektor Salesforce dan variabel lokal:

   Input	Output
   connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("AccountId")	sf_account_id
   connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("Name")	sf_account_name
   connectorOutputPayload (Check account in BigQuery) .FILTER(~obj1 -> ~obj1 .GET_PROPERTY("account_id") .TO_STRING() .EQUALS(sf_account_id) ) .SIZE() .EQUALS("1")	account_exists

   Setelah pemetaan selesai, tutup panel tersebut. Setiap perubahan akan disimpan otomatis.

8. Tambahkan koneksi edge dari konektor Check account in BigQuery ke tugas Check account.

Buat akun BigQuery baru

Setelah memvalidasi akun Salesforce di BigQuery, dan jika akun tidak ada, lakukan hal berikut untuk membuat akun baru di BigQuery. Anda juga menggunakan informasi yang sama untuk membuat akun di ServiceNow.

Tambahkan akun ke BigQuery

Lakukan langkah-langkah berikut untuk mengonfigurasi tugas Connectors yang membuat entity baru di tabel Accounts BigQuery:

1. Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Connectors di editor integrasi.
3. Klik elemen tugas Connectors pada desainer untuk melihat Connectors task configuration panel.
4. Klik dan ganti nama Konektor menjadi Create account in BigQuery.
5. Klik Konfigurasi konektor.
6. Lakukan tindakan berikut di halaman Connectors Task Editor:
   1. Di bagian Select connection, pilih region us-central1.
   2. Pilih koneksi BigQuery Anda dari daftar koneksi yang tersedia.
   3. Klik Next.
   4. Di bagian Jenis, pilih Entitas.
   5. Di bagian Set entity/actions, pilih akun dari daftar entity yang tersedia, lalu pilih Create sebagai Operation.
   6. Klik Done untuk menyelesaikan konfigurasi koneksi dan menutup panel.

Membuat akun ServiceNow baru

Lakukan langkah-langkah berikut untuk mengonfigurasi tugas Connectors yang menambahkan akun baru ke instance ServiceNow Anda:

1. Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Connectors di editor integrasi.
3. Klik elemen tugas Connectors pada desainer untuk melihat Connectors task configuration panel.
4. Klik dan ganti nama Konektor menjadi Create account in ServiceNow.
5. Klik Konfigurasi konektor.
6. Lakukan tindakan berikut di halaman Connectors Task Editor:
   1. Di bagian Select connection, pilih region us-central1.
   2. Pilih koneksi BigQuery Anda dari daftar koneksi yang tersedia.
   3. Klik Next.
   4. Di bagian Jenis, pilih Entitas.
   5. Di bagian Set entity/actions, pilih system_user dari daftar entity yang tersedia, lalu pilih Create sebagai Operation.
   6. Klik Done untuk menyelesaikan konfigurasi koneksi dan menutup panel.

Transformasi dan petakan detail akun

Untuk mengubah detail akun dan memetakannya ke konektor BigQuery dan ServiceNow, lakukan tindakan berikut:

1. Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Data Mapping di editor integrasi.
3. Klik elemen Data Mapping pada desainer untuk melihat panel konfigurasi tugas.
4. Klik dan ganti nama tugas Data Mapping menjadi Mapping for Account Creation.
5. Klik Open Data Mapping Editor.
6. Klik + Tambahkan variabel baru, lalu buat variabel input berikut:

   Nama variabel input	Jenis data
   new_BQaccount	JSON
   new_SNaccount	JSON

7. Buat pemetaan berikut untuk memetakan ID dan nama akun Salesforce ke tabel BigQuery:

   Input	Output
   new_BQaccount .SET_PROPERTY( sf_account_id, "account_id" ) .SET_PROPERTY( sf_account_name, "name" )	connectorInputPayload (Create account in BigQuery)
   new_SNaccount .SET_PROPERTY( sf_account_id, "sys_id" ) .SET_PROPERTY( sf_account_name, "first_name" )	connectorInputPayload (Create account in ServiceNow)

   Setelah pemetaan selesai, tutup panel tersebut. Setiap perubahan akan disimpan otomatis.

8. Menambahkan koneksi edge dari tugas Mapping for Account Creation ke konektor Create account in BigQuery.
9. Menambahkan koneksi edge dari tugas Mapping for Account Creation ke konektor Create account in ServiceNow.

Membuat pesanan baru di BigQuery

Lakukan hal berikut untuk membuat nomor pesanan dan menambahkannya di BigQuery.

Menambahkan pesanan ke BigQuery

Lakukan langkah-langkah berikut untuk mengonfigurasi tugas Connectors yang membuat entity baru di tabel Orders BigQuery:

1. Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Connectors di editor integrasi.
3. Klik elemen tugas Connectors pada desainer untuk melihat Connectors task configuration panel.
4. Klik dan ganti nama Konektor menjadi Create order in BigQuery.
5. Klik Konfigurasi konektor.
6. Lakukan tindakan berikut di halaman Connectors Task Editor:
   1. Di bagian Select connection, pilih region us-central1.
   2. Pilih koneksi BigQuery Anda dari daftar koneksi yang tersedia.
   3. Klik Next.
   4. Di bagian Jenis, pilih Entitas.
   5. Di bagian Set entity/actions, pilih Orders dari daftar entity yang tersedia, lalu pilih Create sebagai Operation.
   6. Klik Done untuk menyelesaikan konfigurasi koneksi dan menutup panel.

Membuat urutan dan memetakan ke BigQuery

1. Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Data Mapping di editor integrasi.
3. Klik elemen Data Mapping pada desainer untuk melihat panel konfigurasi tugas.
4. Klik dan ganti nama tugas Data Mapping menjadi Mapping for Order Creation.
5. Klik Open Data Mapping Editor.
6. Klik + Tambahkan variabel baru dan buat variabel berikut:

   Nama variabel	Jenis data
   order_number	STRING

7. Buat pemetaan berikut untuk membuat nomor pesanan baru dan memetakan detail pesanan ke konektor BigQuery:

   Input	Output
   GENERATE_UUID() .SPLIT("-") .GET("0")	new_order_number
   "{}" .TO_JSON() .SET_PROPERTY( connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("DeliveryInstallationStatus__c") , "order_status" ) .SET_PROPERTY( connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("TrackingNumber__c") , "tracking_number" ) .SET_PROPERTY( new_order_number , "order_number" )	connectorInputPayload (Create Order in BigQuery)

   Setelah pemetaan selesai, tutup panel tersebut. Setiap perubahan akan disimpan otomatis.

8. Menambahkan koneksi edge dari konektor Create account in BigQuery ke tugas Mapping for Order Creation.
9. Menambahkan koneksi edge dari konektor Create account in ServiceNow ke tugas Mapping for Order Creation.
10. Menambahkan koneksi edge dari tugas Mapping for Order Creation ke konektor Create Order in BigQuery.

Memperbarui peluang Salesforce

Setelah membuat nomor pesanan baru, Anda memperbarui peluang Salesforce sumber

Mengonfigurasi konektor Salesforce

Lakukan langkah-langkah berikut untuk mengonfigurasi tugas Konektor yang memperbarui peluang Salesforce yang ada:

1. Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Connectors di editor integrasi.
3. Klik elemen tugas Connectors pada desainer untuk melihat Connectors task configuration panel.
4. Klik dan ganti nama Konektor menjadi Update Salesforce.
5. Klik Konfigurasi konektor.
6. Lakukan tindakan berikut di halaman Connectors Task Editor:
   1. Di bagian Select connection, pilih region us-central1.
   2. Pilih koneksi Salesforce dari daftar koneksi yang tersedia.
   3. Klik Next.
   4. Di bagian Jenis, pilih Entitas.
   5. Di bagian Set entity/actions, pilih Opportunity dari daftar entity yang tersedia, lalu pilih Update sebagai Operation.
   6. Klik Done untuk menyelesaikan konfigurasi koneksi dan menutup panel.

Memetakan nomor pesanan ke Salesforce

1. Di editor integrasi, klik Tasks untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Data Mapping di editor integrasi.
3. Klik elemen Data Mapping pada desainer untuk melihat panel konfigurasi tugas.
4. Klik dan ganti nama tugas Data Mapping menjadi Mapping to update opportunity.
5. Klik Open Data Mapping Editor.
6. Buat pemetaan berikut untuk memperbarui peluang Salesforce:

   Input	Output
   "{}" .TO_JSON() .SET_PROPERTY( new_order_number , "OrderNumber__c" )	connectorInputPayload (Update Salesforce)
   entityId ( Fetch Salesforce Data)	entityId (Update Salesforce )
   "'" .CONCAT(entityId ( Fetch Salesforce Data)) .CONCAT("'")	filterClause (Update Salesforce )

   Setelah pemetaan selesai, tutup panel tersebut. Setiap perubahan akan disimpan otomatis.

7. Menambahkan koneksi edge dari konektor Buat Pesanan di BigQuery ke tugas Mapping to update opportunity.
8. Tambahkan koneksi edge dari tugas Mapping to update Opportunity ke konektor Update Salesforce.

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 validasi informasi akun:

1. Tambahkan koneksi edge dari tugas Check account ke tugas Mapping for Account Creation dengan kondisi edge berikut:

     $account_exists$ = False

2. Tambahkan koneksi edge lain dari tugas Check account ke tugas Mapping for Order Creation dengan kondisi edge berikut:

     $account_exists$ = True

Contoh alur integrasi

Gambar berikut menunjukkan contoh tata letak integrasi yang dibuat menggunakan tutorial ini.

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 pengujian 1: Untuk memeriksa apakah nomor pesanan telah dibuat untuk ID akun baru

Uji integrasi dengan login ke instance Salesforce dan membuat peluang baru. Anda harus membuat peluang di akun baru atau akun yang tidak ada di tabel BigQuery.

Untuk memverifikasi keberhasilan integrasi Anda:

1. Buka halaman BigQuery.

   Buka BigQuery

   • Buka tabel Akun dan periksa untuk mengonfirmasi penyisipan ID akun peluang baru.
   • Buka tabel Pesanan dan centang untuk mengonfirmasi penyisipan detail pesanan baru.
2. Buka instance ServiceNow.
   • Periksa untuk mengonfirmasi apakah akun baru telah ditambahkan ke instance Anda yang berisi ID akun peluang Salesforce yang sama.
3. Buka Salesforce.
   • Periksa untuk mengonfirmasi apakah peluang diperbarui dengan nomor pesanan baru.

Kasus pengujian 2: Untuk memeriksa apakah nomor pesanan dibuat untuk ID akun yang ada di BigQuery

Uji integrasi dengan login ke instance Salesforce dan membuat peluang baru. Anda harus membuat peluang di akun yang sudah ada yang juga ada di tabel BigQuery.

Untuk memverifikasi keberhasilan integrasi Anda:

1. Buka halaman BigQuery.

   Buka BigQuery

   • Buka tabel Akun dan periksa untuk memastikan TIDAK ADA ID akun baru yang dimasukkan.
   • Buka tabel Pesanan dan centang untuk mengonfirmasi penyisipan detail pesanan baru.
2. Buka Salesforce.
   • Periksa untuk mengonfirmasi apakah peluang diperbarui dengan nomor pesanan baru.

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.