Memfilter data saat runtime untuk dasbor dan visual tertanam Amazon Quick Sight - Amazon Quick Suite
Terminologi dan konsepMenyiapkanAntarmuka metode SDK

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memfilter data saat runtime untuk dasbor dan visual tertanam Amazon Quick Sight

Anda dapat menggunakan metode filter di Amazon Quick Sight embedding SDK untuk memanfaatkan kekuatan filter Amazon Quick Sight dalam aplikasi perangkat lunak Anda sebagai layanan (SaaS) saat runtime. Filter runtime memungkinkan pemilik bisnis untuk mengintegrasikan aplikasi mereka dengan dasbor dan visual Amazon Quick Sight yang disematkan. Untuk mencapai hal ini, buat kontrol filter khusus dalam aplikasi Anda dan terapkan preset filter berdasarkan data dari aplikasi Anda. Kemudian, pengembang dapat mempersonalisasi konfigurasi filter untuk pengguna akhir saat runtime.

Pengembang dapat membuat, menanyakan, memperbarui, dan menghapus filter Amazon Quick Sight pada dasbor atau visual yang disematkan dari aplikasi mereka dengan Amazon Quick Sight Embedding SDK. Buat objek filter Amazon Quick Sight di aplikasi Anda dengan model FilterGroupdata dan terapkan ke dasbor dan visual yang disematkan menggunakan metode filter. Untuk informasi selengkapnya tentang menggunakan Amazon Quick Sight Embedding SDK, lihat di. amazon-quicksight-embedding-sdk GitHub

Prasyarat

Sebelum Anda dapat memulai, pastikan bahwa Anda menggunakan Amazon Quick Sight Embedding SDK versi 2.5.0 atau lebih tinggi.

Terminologi dan konsep

Terminologi berikut dapat berguna saat bekerja dengan penyaringan runtime tertanam.

  • Grup filter — Sekelompok filter individual. Filter yang terletak di dalam a FilterGroup adalah OR-ed satu sama lain. Filter dalam a FilterGroupditerapkan pada lembar atau visual yang sama.

  • Filter — Filter tunggal. Filter dapat berupa jenis filter kategori, numerik, atau datetime. Untuk informasi selengkapnya tentang filter, lihat Menyaring.

Menyiapkan

Sebelum Anda mulai, pastikan Anda memiliki aset dan informasi berikut yang disiapkan.

  • ID lembar lembar yang ingin Anda cakup FilterGroup ke. Ini dapat diperoleh dengan getSheets metode di Embedding SDK.

  • Dataset dan pengidentifikasi kolom dari kumpulan data yang ingin Anda filter. Ini dapat diperoleh melalui operasi DescribeDashboardDefinitionAPI.

    Bergantung pada jenis kolom yang Anda gunakan, mungkin ada batasan pada jenis filter yang dapat ditambahkan ke aset yang disematkan. Untuk informasi selengkapnya tentang pembatasan filter, lihat Memfilter.

  • ID visual visual yang ingin Anda lingkup FilterGroup ke, jika berlaku. Ini dapat diperoleh dengan menggunakan getSheetVisuals metode di Embedding SDK.

    Selain getSheetVisuals metode, FilterGroup yang Anda tambahkan hanya dapat dicakup ke lembar yang saat ini dipilih.

Untuk menggunakan fitur ini, Anda harus sudah memiliki dasbor atau visual yang disematkan ke dalam aplikasi Anda melalui Amazon Quick Sight Embedding SDK. Untuk informasi selengkapnya tentang menggunakan Amazon Quick Sight Embedding SDK, lihat di. amazon-quicksight-embedding-sdk GitHub

Antarmuka metode SDK

Metode pengambil penyematan dasbor

Tabel berikut menjelaskan metode pengambil penyematan dasbor yang berbeda yang dapat digunakan pengembang.

Metode Deskripsi

getFilterGroupsForSheet(sheetId: string)

Mengembalikan semua FilterGroups yang saat ini dicakup ke lembar yang disediakan dalam parameter.

getFilterGroupsForVisual(sheetId: string, visualId: string)

Mengembalikan semua FilterGroups yang dicakup ke visual yang disediakan dalam parameter.

Jika lembar yang disediakan dalam parameter bukan lembar yang saat ini dipilih dari dasbor tertanam, metode di atas mengembalikan kesalahan.

Metode pengambil penyematan visual

Tabel berikut menjelaskan berbagai metode pengambil penyematan visual yang dapat digunakan pengembang.

Metode Deskripsi

getFilterGroups()

Mengembalikan semua FilterGroups yang saat ini dicakup ke visual tertanam.

Metode setter

Tabel berikut menjelaskan metode setter berbeda yang dapat digunakan pengembang untuk dashboard atau penyematan visual.

Metode Deskripsi

addFilterGroups(filterGroups: FilterGroup[])

Menambahkan dan menerapkan yang disediakan FilterGroupske dasbor atau visual yang disematkan. A ResponseMessage yang menunjukkan apakah penambahan berhasil dikembalikan.

updateFilterGroups(filterGroups: FilterGroup[])

Memperbarui pengalaman tertanam yang berisi FilterGroupId sama dengan FilterGroup yang disediakan dalam parameter. FilterGroups A ResponseMessage yang menunjukkan apakah pembaruan berhasil dikembalikan.

removeFilterGroups(filterGroupsOrIds: FilterGroup[] | string[])

Menghapus yang disediakan FilterGroups dari dasbor dan mengembalikan a ResponseMessage yang menunjukkan apakah upaya penghapusan berhasil.

FilterGroupYang disediakan harus dicakup ke lembar tertanam atau visual yang saat ini dipilih.