시각적 머리글 숨기기 또는 표시

아티클
09/17/2023

앱에 포함하는 Power BI 보고서에는 차트, 열 지도 및 계기와 같은 시각적 개체가 포함되어 있습니다. 이러한 시각적 개체에는 사용자가 작업을 사용할 수 있도록 하는 헤더가 있습니다. Power BI를 사용하는 경우 보고서에서 각 시각적 개체의 헤더를 숨기거나 표시할 수 있습니다. 각 시각적 개체에는 시각적 개체 헤더라는 시각화 창의 서식 섹션에 카드가 있습니다. 이 카드를 사용하여 시각적 개체의 헤더를 켜고 끌 수 있습니다. 시각적 개체 헤더의 시각적 개체 헤더에 대해 자세히 알아봅니 다.

시각적 개체 헤더의 작업 예는 다음과 같습니다.

포커스 모드에서 시각적 개체를 엽니다.
드릴다운 또는 위로 드릴다운합니다.
현재 시각적 개체에 적용된 필터 및 슬라이서 보기
시각적 개체의 옵션 메뉴를 엽니다.

경우에 따라 이러한 작업을 숨기는 것이 유용합니다. 예를 들어 두 시각적 개체가 겹치는 경우 두 시각적 개체의 헤더를 모두 표시하지 않을 수 있습니다.

이 API는 보고서의 모든 시각적 개체 또는 특정 시각적 개체의 헤더를 숨기거나 표시하는 방법을 제공합니다. 보고서 로드에 대한 가시성을 구성하거나 보고서 메서드를 호출하여 보고서가 updateSettings 로드된 후 표시 유형을 변경할 수 있습니다. 런타임 시 보고서 설정 업데이트를 참조하세요.

다음 사용 사례를 포함하여 많은 시나리오에서 API를 사용할 수 있습니다.

보고서의 일부 시각적 개체 헤더만 숨깁니다.
앱에서 단추 클릭과 같은 비즈니스 논리를 사용하여 보고서를 로드한 후 헤더를 숨기거나 표시합니다.

시각적 개체 헤더를 숨기거나 표시하는 방법

API에서 시각적 헤더를 숨기거나 표시하려면 보고서 설정에서 특정 매개 변수를 구성합니다. 포함된 보고서의 옵션 구성에 대한 일반적인 정보는 보고서 설정 구성 을 참조하세요.

시각적 헤더 설정

시각적 개체 헤더를 사용하면 현재 구성할 수 있는 유일한 설정이 표시 유형입니다. 머리글을 숨기거나 표시하려면 시각적 헤더 구성 개체 목록을 제공합니다. 각 개체는 설정 개체를 포함하며 선택기를 포함할 수도 있습니다. 선택기는 설정을 적용하는 시각적 개체를 식별합니다. 선택기의 선택기에 대해 자세히 알아봅니다.

API에 제공하는 구성 개체의 형식은 IVisualSettings입니다. 이 문서의 뒷부분에서는 코드에서 이 인터페이스를 사용하는 방법을 보여 주는 예제 를 찾을 수 있습니다. Power BI 모델에 는 예제에서 사용하는 모든 인터페이스 정의가 나열됩니다.

다음 사항에 유의하세요.

선택기는 이러한 설정에서 선택 사항입니다. 선택기를 나열하지 않으면 API는 보고서의 모든 시각적 개체에 설정을 적용합니다.
선택기를 사용하는 경우 이름 또는 형식별로 시각적 개체를 지정할 수 있습니다. 지정된 페이지에서 시각적 개체의 이름과 형식을 얻으려면 Page getVisuals 메서드를 사용합니다.

우선 순위 규칙

API는 다음 순서로 구성 설정을 적용합니다.

보고서에 저장된 설정입니다.
로드할 때 API가 적용되는 포함 구성 개체에서 정의하는 설정입니다.
API에 updateSettings 제공하는 설정입니다.

둘 이상의 설정을 시각적 개체에 적용할 수 있는 경우 API는 적용되는 마지막 설정을 사용합니다. 다음 섹션의 시각적 머리글 예제를 제외한 모두 숨기기 에서 이 점을 보여 줍니다.

예

이러한 예제에서는 API를 사용하여 시각적 헤더를 숨기거나 표시하는 다양한 방법을 보여 줍니다.

모든 시각적 개체 헤더 숨기기

이 간단한 시나리오는 보고서의 모든 시각적 헤더를 숨김으로써 고객에게 깨끗한 보고서 보기를 제공합니다.

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    }
                    /* No selector is listed. The API hides the headers of all the visuals in the report. */
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

특정 시각적 개체의 헤더 숨기기

다음은 선택기를 사용하여 단일 시각적 개체에 표시 유형 설정을 적용하는 예제입니다. 이 시나리오는 시각적 개체에 적합하지 않은 기능을 숨기려는 경우에 발생합니다. 이 경우 다음 코드를 사용합니다.

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    },
                    selector: {
                        $schema: "http://powerbi.com/product/schema#visualSelector",
                        visualName: <The name of the visual>  // You can retrieve the name by using getVisuals.
                    }
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

하나의 시각적 개체 헤더를 제외한 모든 항목 숨기기

이 코드를 사용하여 특정 시각적 개체의 헤더를 제외한 보고서의 모든 시각적 개체 헤더를 숨깁니다.

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    }
                    /* No selector is listed. The API hides the headers of all the visuals in the report. */
                },
                {
                    settings: {
                        visible: true
                    },
                    selector: {
                        $schema: "http://powerbi.com/product/schema#visualSelector",
                        visualName: <The name of the visual> // You can retrieve the name by using getVisuals.
                    }
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

둘 이상의 헤더를 표시하려면 이 코드를 확장할 수 있습니다. 로 설정된 매개 변수 settings 를 visible 사용하여 IVisualHeader 추가 인스턴스를 true설정합니다. 표시되는 헤더가 있어야 하는 각 시각적 개체에 대해 하나의 IVisualHeader 인스턴스를 목록에 추가합니다.

제한 사항

포함하는 보고서가 보기 모드인 경우에만 시각적 머리글의 표시 유형을 제어할 수 있습니다.
시각적 개체의 전체 헤더만 숨기거나 표시할 수 있습니다. 헤더 메뉴에서 특정 항목의 표시 유형을 구성할 수 없습니다.
선택기를 사용하여 시각적 개체의 이름 또는 형식을 지정하는 경우 Page getVisuals 메서드를 사용하여 고유한 식별자인 시각적 개체의 이름을 가져옵니다. 시각적 개체의 제목으로 선택기를 구성하지 마세요.
사용자가 API에 포함하는 보고서를 저장하면 정의한 시각적 설정이 보고서에 저장됩니다. 대신 사용 권한 수준으로 ViewEdit 보고서를 구성하여 이 상황을 방지할 Save수 있습니다.

다음 단계

보고서 설정 구성

선택기를 사용하여 영향을 받는 시각적 개체 제어

get-visuals.md

다음을 통해 공유