다음을 통해 공유


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

앱에 포함하는 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);

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

제한 사항

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

다음 단계