Power BI ビジュアルの分析ウィンドウ

[分析] ウィンドウを使用すると、最小、最大、平均などの動的な参照線を視覚エフェクトに追加することができます。 これらの行は、重要な傾向や分析情報をズームする際に役立ちます。 この記事では、 [分析] ウィンドウで動的な参照行を表示および管理できる Power BI ビジュアルを作成する方法について説明します。

Note

[分析] ウィンドウは、API バージョン 2.5.0 で使用できます。 使用しているバージョンを確認するには、pbiviz.json ファイルの apiVersion を確認してください。

分析ウィンドウを管理する

[分析] ウィンドウでのプロパティの管理方法は、[書式] ウィンドウでのプロパティの管理方法と似ています。 オブジェクトの定義付けは、ビジュアルの capabilities.json ファイル内で行います。

[分析] ウィンドウでは、オブジェクトは次のように定義されます。

API 5.1 以降

オブジェクトの定義の下に、ここで説明されているように、オブジェクト名、プロパティ名、種類だけを追加します。 例:

{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

古い API (5.1 より前)

1. オブジェクトの定義で、displayName と objectCategory フィールドを 2 の値で追加します。

   注意

   オブジェクトによって制御されるビジュアルの側面が、objectCategory によって定義されます (1 = 書式設定、2 = 分析)。 外観、色、軸、ラベルなどの要素には Formatting を使用します。 Analytics は、予測、参照線、図形などの要素に使用します。

   objectCategory 値が指定されていない場合、既定値は Formatting になります。

2. 次の 2 つのプロパティをオブジェクトに追加します。

   • bool 型の show (既定値は true)
   • text 型の displayName (既定値は true)

{
  "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
      }
    }
  ...
  }
}

書式設定カードで、set card analyticsPane パラメーターを true に設定し、このカードが分析ウィンドウに属することを指定します。 既定では、analyticsPane パラメーターは false であり、カードは書式設定ウィンドウに追加されます。 次の実装を参照してください。

FormattingModel ユーティリティの使用

class YourAnalyticsCardSettings extends FormattingSettingsCard {
    show = new formattingSettings.ToggleSwitch({
        name: "show",
        displayName: undefined,
        value: false,
        topLevelToggle: true
    });

    displayNameProperty = new formattingSettings.TextInput({
        displayName: "displayName",
        name: "displayName",
        placeholder: "",
        value: "Analytics Instance",
    });

    name: string = "YourAnalyticsPropertiesCard";
    displayName: string = "Your analytics properties card's name";
    analyticsPane: boolean = true; // <===  Add and set analyticsPane variable to true 
    slices = [this.show, this.displayNameProperty];
}

FormattingModel ユーティリティを使用しない

      const show: powerbi.visuals.EnabledSlice = {
          uid: "enableAxisCard_topLevelToggle_show_uid",
          suppressDisplayName: true,
          control: {
              type: powerbi.visuals.FormattingComponent.ToggleSwitch,
              properties: {
                  descriptor: {
                      objectName: "YourAnalyticsPropertiesCard",
                      propertyName: "show"
                  },
                  value: false
              }
          }
      }
        
      const displayNameProperty: powerbi.visuals.FormattingSlice = {
          uid: "enableAxisCard_displayName_uid",
          suppressDisplayName: true,
          control: {
              type: powerbi.visuals.FormattingComponent.TextInput,
              properties: {
                  descriptor: {
                      objectName: "YourAnalyticsPropertiesCard",
                      propertyName: "displayName"
                  },
                  value: "Analytics Instance",
                  placeholder: ""
              }
          }
      }

      const averageLineCard: powerbi.visuals.FormattingCard = {
          displayName: "Your analytics properties card's name",
          uid: "yourAnalyticsCard_uid",
          analyticsPane: true, // <===  Add and set analyticsPane variable to true 
          topLevelToggle: show,
          groups: [{
              displayName: undefined,
              uid: "yourAnalyticsCard_group_uid",
              slices: [displayNameProperty],
          }]
      };

その他のプロパティは Format オブジェクトと同じように定義し、[書式] ペインと同じようにオブジェクトを列挙します。

注意

• 分析ウィンドウは、新しい情報を追加するか、表示された情報に新たな光を当てるオブジェクトに対してのみ使用します (たとえば、重要な傾向を示す動的な参照行)。
• ビジュアルの外観 (つまり、書式設定) を制御するオプションはすべて、書式設定ウィンドウに限定する必要があります。

考慮事項と制限事項

• 分析ウィンドウでは、まだマルチインスタンスはサポートされていません。 オブジェクトには、静的なセレクター (つまり selector: null) のみを含めることができます。また、Power BI 視覚エフェクトには、ユーザー定義カードの複数のインスタンスを含めることはできません。
• integer 型のプロパティが正しく表示されません。 回避策として、代わりに numeric 型を使用します。

次の手順

条件付き書式を追加する