기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
내장된 대시보드 및 시각적 개체의 런타임 시 데이터 필터링
Amazon QuickSight SDK 임베딩의 필터 메서드를 사용하여 SaaS (Software as a Service) 애플리케이션 내에서 런타임에 QuickSight 필터 기능을 활용할 수 있습니다. 비즈니스 소유자는 런타임 필터를 사용하여 애플리케이션을 내장된 QuickSight 대시보드 및 시각 자료와 통합할 수 있습니다. 이를 위해서는 애플리케이션에서 사용자 지정 필터 컨트롤을 만들고 애플리케이션의 데이터를 기반으로 필터 프리셋을 적용해야 합니다. 그러면 개발자가 런타임에 최종 사용자를 위한 필터 구성을 개인화할 수 있습니다.
개발자는 QuickSight 임베딩을 SDK 사용하여 임베디드 대시보드 또는 애플리케이션의 비주얼에서 필터를 만들고, 쿼리하고, 업데이트하고, 제거할 수 있습니다. FilterGroup데이터 모델을 사용하여 애플리케이션에서 QuickSight 필터 개체를 만들고 필터 방법을 사용하여 내장된 대시보드 및 시각적 개체에 적용할 수 있습니다. QuickSight 임베딩 사용에 대한 자세한 내용은 SDK on을 참조하십시오. amazon-quicksight-embedding-sdk
사전 조건
시작하기 전에 QuickSight 임베딩 SDK 버전 2.5.0 이상을 사용하고 있는지 확인하십시오.
용어 및 개념
다음 용어는 내장된 런타임 필터링을 사용할 때 유용할 수 있습니다.
-
필터 그룹 - 개별 필터의 그룹입니다. a
FilterGroup
내에 있는 필터는 서로 OR 처리됩니다. a FilterGroup내의 필터는 동일한 시트 또는 시각 자료에 적용됩니다. -
필터 - 단일 필터. 필터는 범주, 숫자 또는 날짜/시간 필터 유형일 수 있습니다. 필터에 대한 자세한 내용은 필터를 참조하십시오.
설정
시작하기 전에 다음 자산과 정보를 준비했는지 확인하십시오.
-
범위를 지정하려는 시트의 시트 ID.
FilterGroup
이는 SDK 임베딩의getSheets
메서드를 사용하여 얻을 수 있습니다. -
필터링하려는 데이터셋의 데이터셋 및 열 식별자. 이는 작업을 통해 확인할 수 있습니다. DescribeDashboardDefinitionAPI
사용하는 열 유형에 따라 임베디드 에셋에 추가할 수 있는 필터 유형에 제한이 있을 수 있습니다. 필터 제한에 대한 자세한 내용은 필터를 참조하십시오.
-
적용 범위를 지정하려는 시각적 개체의 시각적 ID (해당하는 경우).
FilterGroup
이는 SDK 임베딩의getSheetVisuals
방법을 사용하여 얻을 수 있습니다.getSheetVisuals
메서드 외에도 추가한FilterGroup
항목의 범위를 현재 선택한 시트에만 적용할 수 있습니다.
이 기능을 사용하려면 QuickSight 임베딩을 SDK 통해 애플리케이션에 대시보드 또는 시각적 기능이 이미 내장되어 있어야 합니다. QuickSight 임베딩 SDK 사용에 대한 자세한 내용은 [Quip의 잘못된 링크] 를 참조하십시오.
SDK메서드 인터페이스
대시보드 임베딩 게터 메서드
다음 표에서는 개발자가 사용할 수 있는 다양한 대시보드 임베딩 게터 메서드에 대해 설명합니다.
메서드 | 설명 |
---|---|
|
FilterGroups 파라미터에 제공된 시트로 현재 범위가 지정된 모든 항목을 반환합니다. |
|
매개 변수에 제공된 비주얼로 범위가 지정된 모든 |
매개 변수에 제공된 시트가 내장 대시보드에서 현재 선택한 시트가 아닌 경우 위 메서드는 오류를 반환합니다.
비주얼 임베딩 게터 메서드
다음 표에서는 개발자가 사용할 수 있는 다양한 시각적 임베딩 게터 메서드에 대해 설명합니다.
메서드 | 설명 |
---|---|
|
현재 임베디드 비주얼로 범위가 지정된 모든 |
세터 메서드
다음 표에는 개발자가 대시보드 또는 시각적 임베딩에 사용할 수 있는 다양한 setter 메서드가 설명되어 있습니다.
메서드 | 설명 |
---|---|
|
제공된 내용을 임베디드 대시보드 또는 FilterGroups비주얼에 추가하고 적용합니다. 추가 성공 여부를 |
|
매개 변수에 제공된 |
|
FilterGroups 대시보드에서 제공된 항목을 제거하고 제거 시도의 성공 여부를 |
제공되는 FilterGroup
파일의 범위는 현재 선택된 포함된 시트 또는 시각적 시트에만 적용되어야 합니다.