在執行階段篩選 QuickSight 內嵌儀表板和視覺效果的資料 - Amazon QuickSight
術語與概念設定SDK 方法界面

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在執行階段篩選 QuickSight 內嵌儀表板和視覺效果的資料

您可以在 Amazon QuickSight 內嵌中使用篩選方法SDK，以在執行時間利用軟體即服務 (SaaS) 應用程式內的 QuickSight 篩選條件功能。執行期篩選條件可讓企業擁有者將其應用程式與內嵌 QuickSight 儀表板和視覺效果整合。若要達成此目的，請在您的應用程式中建立自訂篩選控制項，並根據您應用程式的資料套用篩選預設集。然後，開發人員可以在執行時間為最終使用者個人化篩選條件組態。

開發人員可以使用內嵌 ，在內嵌儀表板或視覺效果上建立、查詢、更新和移除篩選條件 QuickSight SDK。使用FilterGroup資料模型在應用程式中建立 QuickSight 篩選條件物件，並使用篩選條件方法將其套用至內嵌儀表板和視覺效果。如需使用 QuickSight 內嵌 的詳細資訊SDK，請參閱 amazon-quicksight-embedding-sdk上的 GitHub。

先決條件

開始之前，請確定您使用的是 QuickSight 內嵌 2.5.0 SDK版或更新版本。

術語與概念

下列術語在處理內嵌執行期篩選時非常有用。

  • 篩選條件群組 – 個別篩選條件的群組。位於 內的篩選條件FilterGroup彼此 OR-ed。內的篩選條件FilterGroup會套用至相同的工作表或視覺效果。

  • 篩選條件 – 單一篩選條件。篩選條件可以是類別、數值或日期時間篩選條件類型。如需篩選條件的詳細資訊，請參閱篩選條件。

設定

開始之前，請確定您已備妥下列資產和資訊。

  • 您要將 範圍FilterGroup設為範圍之工作表的工作表 ID。這可透過內嵌 中的 getSheets方法取得SDK。

  • 您要篩選之資料集的資料集和資料欄識別符。這可以透過 DescribeDashboardDefinitionAPI操作取得。

    根據您所使用的資料欄類型，可以新增至內嵌資產的篩選條件類型可能會有限制。如需篩選條件限制的詳細資訊，請參閱篩選條件。

  • 您想要將 範圍FilterGroup範圍設為 的視覺效果 ID，如適用。這可以透過使用內嵌 中的 getSheetVisuals方法來取得SDK。

    除了 getSheetVisuals方法之外，您新增FilterGroup的 只能範圍為目前選取的工作表。

若要使用此功能，您必須已透過內嵌 將儀表板或視覺效果 QuickSight 內嵌至您的應用程式SDK。如需使用 QuickSight 內嵌 的詳細資訊SDK，請參閱 amazon-quicksight-embedding-sdk上的 GitHub。

SDK 方法界面

儀表板內嵌 getter 方法

下表說明開發人員可以使用的不同儀表板內嵌 getter 方法。

方法 描述

getFilterGroupsForSheet(sheetId: string)

傳回 FilterGroups 目前範圍為 參數中提供的工作表的所有 。

getFilterGroupsForVisual(sheetId: string, visualId: string)

傳回 FilterGroups 參數中提供的視覺效果範圍的所有 。

如果 參數中提供的工作表不是內嵌儀表板目前選取的工作表，上述方法會傳回錯誤。

視覺化內嵌 getter 方法

下表說明開發人員可以使用的不同視覺化內嵌 getter 方法。

方法 描述

getFilterGroups()

傳回FilterGroups目前範圍為內嵌視覺效果的所有 。

設定程式方法

下表說明開發人員可用於儀表板或視覺化內嵌的不同設定程式方法。

方法 描述

addFilterGroups(filterGroups: FilterGroup[])

新增 ，並將提供的 套用至FilterGroups內嵌儀表板或視覺效果。會傳回ResponseMessage指出是否成功新增的 。

updateFilterGroups(filterGroups: FilterGroup[])

更新內嵌體驗FilterGroups上的 ，其中包含FilterGroupId與 參數中FilterGroup提供的 相同的 。會傳回ResponseMessage指出更新是否成功的 。

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

FilterGroups 從儀表板移除提供的 ，並傳回ResponseMessage指示移除嘗試是否成功的 。

FilterGroup 提供的 範圍必須是目前選取的內嵌工作表或視覺效果。