Salesforce

catatan

Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat Mengelola akses ke plugin Enterprise.

Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat Grafana plugin.

Sumber data Salesforce memungkinkan Anda memvisualisasikan data dari Salesforce dalam Grafana Terkelola Amazon.

Untuk menggunakan sumber data ini, Anda harus memiliki akun Salesforce dan Aplikasi Terhubung Salesforce.

Keterbatasan yang Sudah Diketahui

• Filter ad-hoc belum didukung.

• Hanya kueri SOQL, dan data yang dapat diakses melalui SOQL yang saat ini didukung. Format kueri SOSL dan SAQL belum didukung.

Pengaturan yang diperlukan

Pengaturan berikut diperlukan.

catatan

Plugin saat ini menggunakan OAuth 2.0 Username-Password Flow. URL panggilan balik yang diperlukan di Aplikasi Terhubung tidak digunakan. Dengan demikian, Anda dapat mengaturnya ke URL yang valid.

Nama	Penjelasan
Enable OAuth settings	Anda harus memeriksa ini untuk mengaktifkan OAuth.
Callback URL	Tidak digunakan dalam plugin ini, sehingga Anda dapat menentukan URL yang valid.
Selected OAuth Scopes (minimum requirements)	Akses dan Kelola data Anda (api).
Require Secret for Refresh Token Flow	Anda dapat mengaktifkan atau menonaktifkan ini.

Menambahkan sumber data

1. Buka konsol Grafana di ruang kerja Grafana yang Dikelola Amazon dan pastikan Anda masuk.

2. Di menu samping di bawah Konfigurasi (ikon roda gigi), pilih Sumber Data.

3. Pilih Tambahkan sumber data.

   catatan

   Jika Anda tidak melihat link Sumber Data di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki Admin peran.

4. Pilih Salesforce dari daftar sumber data.

5. Masukkan informasi berikut:

   • Untuk Nama Pengguna, masukkan nama pengguna untuk akun Salesforce yang ingin Anda gunakan untuk menghubungkan dan menanyakan Salesforce.

   • Untuk Kata Sandi, masukkan kata sandi untuk pengguna tersebut.

   • Untuk Token Keamanan, masukkan token keamanan untuk pengguna tersebut.

   • Untuk Kunci Konsumen, masukkan kunci Konsumen untuk terhubung ke Salesforce. Anda dapat memperoleh ini dari Aplikasi Salesforce Connected Anda.

   • Untuk Rahasia Konsumen, masukkan rahasia Konsumen untuk terhubung ke Salesforce. Anda dapat memperoleh ini dari Aplikasi Salesforce Connected Anda.

   • Untuk Gunakan Sandbox, pilih ini jika Anda ingin menggunakan kotak pasir Salesforce.

Kueri sumber data Salesforce

Editor kueri mendukung mode Query Builder dan SOQL Editor. SOQL adalah singkatan dari Salesforce Object Query Language.

Pembuat Kueri (Pembuat SOQL)

Query Builder adalah antarmuka yang ramah pengguna untuk membangun kueri SOQL. Jika Anda tidak terbiasa menulis kueri SOQL, Anda dapat menggunakan mode ini untuk membangun SOQL untuk menanyakan objek Salesforce. Bidang FROM di pembuat kueri mengacu pada entitas atau entitas di Salesforce. Anda harus memilih bidang FROM sebelum operasi lain di pembuat kueri. Setelah Anda memilih bidang FROM, Anda harus memilih mode pembangun. SOQL Builder saat ini mendukung mode berikut.

• List— Daftar item dengan bidangnya dari tabel/salesforce yang dipilih. Gunakan mode ini untuk mendapatkan hasil seperti, “Tunjukkan daftar peluang yang dibuat pada kuartal fiskal ini bersama dengan nama, nilai, dan tahapannya.”

• Aggregate— Agregat item dalam suatu entitas. Gunakan mode ini untuk mendapatkan hasil seperti, “Hitung peluang yang dibuat pada bulan lalu.” atau “Berapa nilai total peluang yang dikelompokkan berdasarkan nama panggung mereka?”

• Trend— Menampilkan hasil agregat dari waktu ke waktu. Gunakan mode ini untuk mendapatkan hasil seperti, “Hitung jumlah peluang dengan CreatedDate.” atau “Berapa jumlah total nilai yang dikelompokkan berdasarkan tanggal penutupan peluang.”

Setelah Anda memilih Entity/FROM dan mode di editor kueri, buat kueri Anda menggunakan opsi berikut.

Bidang	Dapat diterapkan ke	Deskripsi
SELECT	SEMUA	Pilih daftar bidang yang ingin Anda lihat. Untuk tampilan agregat atau tren, pilih juga bagaimana Anda ingin menggabungkan nilai.
WHERE	SEMUA	(Opsional) Tentukan kondisi filter. Hasilnya disaring berdasarkan kondisi yang Anda pilih.
ORDER BY	DAFTAR, AGREGAT	(Opsional) Pilih nama bidang dan urutan pengurutan yang Anda inginkan untuk hasilnya.
LIMIT	DAFTAR, AGREGAT	(Opsional) Batasi jumlah hasil yang dikembalikan. Secara default, nilainya adalah 100.
GROUP BY	AGREGAT	(Opsional) Pilih bidang jika Anda ingin membagi nilai agregat dengan bidang tertentu.
BIDANG WAKTU	KECENDERUNGAN	Tentukan bidang tanggal yang ingin Anda kelompokkan hasil Anda. Hasil disaring berdasarkan rentang pemilih waktu Grafana.

Jika Anda mengonfigurasi bidang sebelumnya di editor kueri, Anda juga akan melihat pratinjau SOQL yang dihasilkan di bawah editor kueri. Jika Anda diblokir dengan batasan apa pun di pembuat kueri, Anda dapat dengan aman beralih ke Editor SOQL, di mana Anda dapat menyesuaikan kueri SOQL yang dihasilkan.

Editor SOQL

Editor SOQL mentah menyediakan opsi untuk menanyakan objek Salesforce melalui kueri SOQL mentah. Editor SOQL memberikan saran pelengkapan otomatis, seperti entitas yang tersedia per tabel dan bidang yang sesuai. Gunakan Ctrl+Spasi setelah SELECT atau WHERE untuk melihat entitas yang tersedia per tabel. Anda dapat melihat bidang yang tersedia, jika Anda memasukkan titik setelah nama entitas.

Pintasan

Gunakan CTRL+SPACE untuk menunjukkan penyelesaian kode, yang menunjukkan opsi kontekstual yang tersedia.

CMD +S menjalankan kueri.

Kueri sebagai deret waktu

Buat kueri deret waktu dengan mengalihkan bidang tanggal ke waktu, dan bidang metrik ke metrik, lalu kelompokkan berdasarkan metrik dan tanggal. Berikut ini adalah contohnya:

SELECT sum(Amount) amount, CloseDate time, Type metric from Opportunity
group by Type, CloseDate

Makro

Untuk memfilter berdasarkan rentang waktu dasbor, Anda dapat menggunakan Makro dalam kueri SOQL Anda:

• $__timeFrom— Akan diganti dengan dimulainya pemilihan waktu aktif yang saat ini dikonversi ke tipe time data.

• $__timeTo— Akan diganti pada akhir pemilihan waktu aktif yang saat ini dikonversi ke tipe time data.

• $__quarterStart— Awal kuartal fiskal (berasal dari Pengaturan Tahun SalesForce Fiskal).

• $__quarterEnd— Akhir kuartal fiskal (berasal dari Pengaturan Tahun SalesForce Fiskal).

SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom

Template dan variabel

Untuk menambahkan variabel kueri Salesforce baru, lihat. Menambahkan variabel kueri Gunakan sumber data Salesforce Anda sebagai sumber data Anda. Anda dapat menggunakan kueri SOQL apa pun di sini.

Jika Anda ingin menggunakan pasangan nama/nilai, misalnya id pengguna dan nama pengguna, kembalikan dua bidang dari kueri SOQL Anda. Bidang pertama akan digunakan sebagai ID. Lakukan ini ketika Anda ingin memfilter berdasarkan kunci (ID, dll) di editor kueri SOQL Anda.

Gunakan variabel dalam kueri SOQL Anda dengan menggunakan sintaks Variabel. Lihat informasi yang lebih lengkap di Sintaks variabel.