Share via


영구 필터 사용

조직에 대해 포함하는 보고서에서 영구 필터 기능을 사용하도록 설정하면 보고서는 필터, 슬라이서 및 기타 데이터 뷰 변경 내용을 포함하여 해당 상태를 유지합니다. 사용자가 보고서를 열면 저장된 사용자 상태가 보고서에 로드됩니다. 또한 영구 필터를 사용하는 경우 사용자는 다른 시나리오에서 동일한 사용자 상태를 가져옵니다.

포함 시나리오에서 영구 필터를 다시 설정하려면 단추를 구현하고 API를 사용 resetPersistentFilters 하거나 작업 표시줄을 표시하여 작업 표시줄에서 Power BI 재설정을 기본 단추로 설정 해야 합니다.

영구 필터를 사용하도록 설정하는 방법

영구 필터는 기본적으로 사용하지 않도록 설정됩니다. 영구 필터를 사용하도록 설정하려면 이 섹션의 단계를 수행합니다.

  1. Power BI 서비스 또는 데스크톱의 보고서 설정에서 영구 필터가 사용하도록 설정되어 있는지 확인합니다.

  2. Azure Active Directory(Azure AD) 앱에 UserState.ReadWrite.All 권한이 있는지 확인합니다.

  3. persistentFiltersEnabled 속성을 true로 설정합니다.

    let config = {
        type: 'report',
        ...
        settings: {
            persistentFiltersEnabled: true
        }
    };

상태가 있는 경우 보고서가 최신 사용자의 보고서 상태로 로드됩니다. 사용자의 보고서 상태는 변경되지 않고 60초 후에 자동으로 저장됩니다.

참고

기존 필터에 대한 업데이트만 저장됩니다. API에 의해 추가된 새 필터는 setFilters 저장되지 않습니다.

영구 필터 API

영구 필터 다시 설정

사용자의 필터, 슬라이서 및 기타 데이터 뷰 변경 내용을 보고서의 기본 상태로 다시 설정합니다.

    resetPersistentFilters(): Promise<void>

영구 필터 저장

사용자의 보고서 필터, 슬라이서 및 기타 데이터 뷰 변경 내용을 저장합니다.

    savePersistentFilters(): Promise<void>

영구 필터 적용

보고서에 적용된 사용자의 필터, 슬라이서 또는 기타 데이터 뷰 변경 내용(있는 경우)을 반환합니다. 영구 필터를 사용하지 않도록 설정하면 false가 반환됩니다.

이 API를 사용하여 다시 설정 단추 상태를 확인할 수 있습니다.

    arePersistentFiltersApplied(): Promise<boolean>

제한 사항

영구 필터는 조직(사용자 소유 데이터) 솔루션 에 대한 포함 에 대해서만 지원됩니다.

다음 단계