Halaman ini memberikan ringkasan tentang cara menggunakan Lookerbot, salah satu dari beberapa integrasi yang disediakan Looker untuk membagikan data Looker di Slack.
Lookerbot untuk Slack terintegrasi dengan Looker sehingga Anda dapat mengkueri data langsung dari Slack, sehingga Anda dapat berbagi data dengan mudah dan menjawab pertanyaan berbasis data tanpa harus bekerja di luar alur kerja organisasi yang ada.
Halaman ini membahas alur kerja Slack-Lookerbot berikut:
- Mulai menggunakan Lookerbot
- Memperluas URL konten Looker secara otomatis
- Menggunakan perintah garis miring kustom untuk menjalankan dan memposting kueri Looker
Mulai menggunakan Lookerbot
Sebelum dapat menggunakan Lookerbot di Slack, Anda harus mengonfigurasi aplikasi Lookerbot dengan mengikuti petunjuk penyiapan teknis di repositori GitHub open source Looker.
Pada Februari 2021, Slack menghentikan penggunaan beberapa endpoint API yang memengaruhi cara Lookerbot berinteraksi dengan tindakan data. Lihat info terbaru dari repo GitHub Lookerbot Looker. Filepackage.json
Anda harus menunjukkan versi Looker0.0.16
atau yang lebih baru.
Memperluas URL Looker secara otomatis
Lookerbot dapat memperluas URL secara otomatis untuk konten Looker yang Anda bagikan di Slack. Agar Lookerbot dapat otomatis memperluas URL bersama dalam saluran Slack, Anda harus menambahkan Lookerbot ke saluran Slack tersebut. (Konfigurasi bot juga harus menetapkan variabel lingkungan LOOKER_SLACKBOT_EXPAND_URLS
ke true
. Lihat petunjuk penyiapan teknis Lookerbot untuk mengetahui informasi selengkapnya tentang variabel lingkungan.)
Kemampuan untuk memperluas URL Looker tidak tersedia di pesan langsung Slack, karena adanya perbedaan yang dibuat antara saluran pribadi/publik dan pesan langsung dalam kemampuan API pengembangan lama yang digunakan di Lookerbot.
Untuk mengundang Lookerbot ke saluran publik atau pribadi di Slack:
- Klik nama channel untuk membuka setelan channel.
- Pilih tab Integrations.
- Di bagian Aplikasi, pilih nama aplikasi Lookerbot Anda.
Saat Anda menempelkan URL dari Explore atau Look di saluran Slack yang mengundang Lookerbot, Lookerbot akan otomatis memperluas URL dan kontennya. Jika konten Looker memiliki visualisasi terkait, Lookerbot akan menampilkan gambar visualisasi tersebut. Jika konten Looker adalah tabel data, Lookerbot akan menampilkan data sebagai teks.
Menggunakan perintah garis miring kustom untuk menjalankan dan memposting kueri Looker
Anda juga dapat membuat dan menggunakan perintah garis miring kustom yang, saat dijalankan, akan menjalankan kueri tersimpan atas data Anda di Looker dan memposting hasilnya di Slack. Perintah garis miring kustom dibuat selama penyiapan Lookerbot, tetapi dapat dijalankan di Slack oleh semua pengguna Slack.
Perintah garis miring tidak diperlukan untuk berinteraksi dengan Lookerbot. Untuk menggunakan semua fungsi Lookerbot, Anda juga dapat mengirim pesan ke bot secara langsung atau menyebutkannya di saluran Slack tempat Lookerbot ada: @lookerbot help
.
Jika integrasi Slack diaktifkan untuk ruang kerja Slack, Anda tidak dapat menggunakan perintah garis miring/looker
dengan Lookerbot. Sebagai ganti@looker
atau/looker
, gunakan@lookerbot
atau/lookerbot
.
Untuk melihat perintah yang telah dibuat untuk Lookerbot Anda:
- Arahkan kursor ke sebutan Lookerbot. Perintah yang tersedia tercantum di jendela pop-up.
- Pilih aplikasi Lookerbot di bagian Aplikasi pada ruang kerja Slack. Lalu pilih tab Tentang di halaman aplikasi. Perintah yang tersedia akan tercantum di bagian Commands.
Berbagai cara untuk menggunakan perintah garis miring
Ada tiga cara untuk menggunakan perintah. Misalnya, Anda atau developer di organisasi telah menyiapkan perintah untuk mengambil data dari Looker yang melacak jumlah pesanan produk tertentu yang telah dilakukan pelanggan. Developer telah menggunakan "pesanan" untuk mewakili data ini saat mengonfigurasi perintah garis miring. Untuk memanggil perintah ini, Anda dapat:
-
@sebutan Lookerbot diikuti dengan komponen teks dari perintah tersebut. Hal ini dapat dilakukan di saluran mana pun tempat Lookerbot ada. Contoh:
@lookerbot orders
-
Gunakan perintah garis miring. Anda dapat menggunakan perintah dengan mengklik perintah dari daftar perintah atau dengan mengetikkan nama perintah (diawali dengan garis miring). Anda dapat melakukannya jika perintah garis miring telah dikonfigurasi selama penyiapan.
/lookerbot orders
-
Pesan langsung Lookerbot. Jika mengirim pesan langsung ke Lookerbot, Anda tidak perlu menambahkan perintah di awal dengan
/lookerbot
. Dalam hal ini, DM hanya akan menjadiorders
.
Menggunakan perintah garis miring dengan filter
Jika Anda atau developer di organisasi Anda telah membuat perintah garis miring yang mengkueri dasbor dengan satu elemen dan filter dasbor, Anda dapat menjalankan perintah tersebut untuk mengambil konten Looker tersebut dan menambahkan nilai filter dari Slack. Filter bersifat opsional, dan kueri akan berjalan tanpa filter tersebut jika tidak ada nilai yang ditentukan.
Misalnya, Anda memiliki dasbor dengan visualisasi peta pelanggan yang memfilter kota-kota tertentu di AS dan perintah garis miring kustom telah dikonfigurasi untuk memanggil data dasbor ini. Anda dapat menjalankan perintah customer map in
yang difilter untuk New York, seperti berikut:
Format data
Perintah akan menampilkan data dengan cara yang berbeda, bergantung pada jenis visualisasi elemen Jelajahi, Tampilan, atau dasbor yang mendasarinya. Ada tiga kemungkinan format hasil:
-
Teks: Jika konten pokok adalah tabel, data akan ditampilkan sebagai teks. Misalnya, jika pengguna menjalankan perintah yang dikonfigurasi
top customer this month
, Slackbot akan menampilkan data teratas dalam format teks: -
Visualisasi Nilai Tunggal: Jika konten yang mendasarinya adalah visualisasi nilai tunggal, data akan ditampilkan sebagai nilai teks. Misalnya, jika pengguna menjalankan perintah yang dikonfigurasi
orders last week
, Slackbot akan menampilkan jumlah total untuk minggu sebelumnya: -
Visualisasi: Jika konten yang mendasarinya adalah visualisasi, data akan ditampilkan sebagai gambar visualisasi. Misalnya, jika pengguna menjalankan perintah yang dikonfigurasi
movie budgets
dengan nilaiBrad Pitt
, Slackbot akan merespons dengan link ke kueri Looker dan visualisasi diagram garis yang menggambarkan tren nilai yang meningkat dan menurun dari rata-rata anggaran film Brad Pitt dari 0 hingga 160 juta untuk tahun rilis pertama sebuah film, mulai dari tahun 1990 hingga 2015:
Referensi lain
Untuk mendapatkan informasi tentang integrasi Slack dari Looker, lihat referensi berikut:
- Mengirim data dari Looker dengan Tindakan Lampiran Slack (Token API)
- Mengirim pemberitahuan ke integrasi Lampiran Slack (Token API)
- Menjadwalkan pengiriman ke integrasi Slack
- Mengirim pemberitahuan ke integrasi Slack