Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Connect ke sumber data Salesforce
catatan
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat Kelola 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 Perluas ruang kerja Anda dengan plugin.
Sumber data Salesforce memungkinkan Anda memvisualisasikan data dari Salesforce dalam Grafana Terkelola Amazon.
Untuk menggunakan sumber data ini, Anda harus memiliki akun 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
-
Buka konsol Grafana di ruang kerja Grafana yang Dikelola Amazon dan pastikan Anda masuk.
-
Di menu samping di bawah Konfigurasi (ikon roda gigi), pilih Sumber Data.
-
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
Adminperan. -
Pilih Salesforce dari daftar sumber data.
-
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
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 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 tipetimedata. -
$__timeTo— Akan diganti pada akhir pemilihan waktu aktif yang saat ini dikonversi ke tipetimedata. -
$__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. Untuk informasi selengkapnya, lihat Sintaks variabel.
