Power BI 시각적 개체의 분석 창The Analytics pane in Power BI visuals

분석 창은 2018년 11월에 네이티브 시각적 개체에 대해 도입되었습니다.The Analytics pane was introduced for native visuals in November 2018. 이 문서에서는 API v2.5.0을 사용하는 Power BI 시각적 개체가 분석 창에 해당 속성을 제공하고 관리할 수 있는 방법을 설명합니다.This article discusses how Power BI visuals with API v2.5.0 can present and manage their properties in the Analytics pane.

분석 창

분석 창 관리Manage the Analytics pane

서식에서 속성을 관리하는 것과 동일한 방법으로, 시각적 개체의 capabilities.json 파일에서 개체를 정의하여 분석 창을 관리합니다.Just as you'd manage properties in the Format pane, you manage the Analytics pane by defining an object in the visual's capabilities.json file.

분석 창의 차이점은 다음과 같습니다.For the Analytics pane, the differences are as follows:

  • 개체 정의 아래에 값이 2인 objectCategory 필드를 추가합니다.Under the object's definition, you add an objectCategory field with a value of 2.

    참고

    선택적 objectCategory 필드는 API 2.5.0에서 도입되었습니다.The optional objectCategory field was introduced in API 2.5.0. 개체가 제어하는 시각적 개체의 측면을 정의합니다(1 = 서식, 2 = 분석).It defines the aspect of the visual that the object controls (1 = Formatting, 2 = Analytics). Formatting은 모양과 느낌, 색, 축, 레이블 등의 요소에 사용됩니다.Formatting is used for such elements as look and feel, colors, axes, and labels. Analytics는 예측, 추세선, 참조선, 도형 등의 요소에 사용됩니다.Analytics is used for such elements as forecasts, trendlines, reference lines, and shapes.

    값을 지정하지 않으면, objectCategory는 기본적으로 “서식”으로 설정됩니다.If the value isn't specified, objectCategory defaults to "Formatting."

  • 개체에는 다음 두 가지 속성이 있어야 합니다.The object must have the following two properties:

    • bool 형식의 show(기본값은 false임)show of type bool, with a default value of false.
    • text 형식의 displayName.displayName of type text. 선택한 기본값이 인스턴스의 초기 표시 이름이 됩니다.The default value that you choose becomes the instance's initial display name.
{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "displayName": "Your analytics properties card's name",
      "objectCategory": 2,
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

서식 개체와 동일한 방식으로 다른 속성을 정의할 수 있습니다.You can define other properties in the same way that you do for Format objects. 서식 창과 동일한 방식으로 개체를 열거할 수도 있습니다.And you can enumerate objects just as you do in the Format pane.

분석 창의 알려진 제한 사항 및 문제Known limitations and issues of the Analytics pane

  • 분석 창에서는 다중 인스턴스가 아직 지원되지 않습니다.The Analytics pane has no multi-instance support yet. 개체에 static 이외의 selector(즉, “selector”: null)를 사용할 수 없으며, Power BI 시각적 개체에 사용자 정의된 카드 인스턴스를 여러 개 사용할 수 없습니다.Objects can't have a selector other than static (that is, "selector": null), and Power BI visuals can't have user-defined multiple instances of a card.
  • integer 형식의 속성이 올바르게 표시되지 않습니다.Properties of type integer aren't displayed correctly. 해결 방법으로, numeric 형식을 대신 사용합니다.As a workaround, use type numeric instead.

참고

  • 새 정보를 추가하거나 제공된 정보를 새롭게 조명하는 개체(예: 중요한 추세를 보여 주는 동적 참조선)에 대해서만 분석 창을 사용합니다.Use the Analytics pane only for objects that add new information or shed new light on the presented information (for example, dynamic reference lines that illustrate important trends).
  • 시각적 개체의 모양과 느낌(즉, 서식)을 제어하는 모든 옵션은 서식 창으로 제한되어야 합니다.Any options that control the look and feel of the visual (that is, formatting) should be limited to the Formatting pane.