다음을 통해 공유


영구 필터 사용

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

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

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

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

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

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

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

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

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

메모

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

영구 필터 API

영구 필터 다시 설정

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

    resetPersistentFilters(): Promise<void>

영구 필터 저장

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

    savePersistentFilters(): Promise<void>

영구 필터 적용

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

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

    arePersistentFiltersApplied(): Promise<boolean>

고려 사항 및 제한 사항

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