Power BI 自訂視覺效果動態格式 API

自 API 4.2 版起，開發人員可以使用動態字串格式支援來建立報表。

啟用視覺效果的動態格式支援

若要允許視覺效果使用動態格式字串運作，則應該在 capabilitites.json中新增下列欄位：

"objects": {
    "general": {
        "properties": {
            "formatString": {
                "type": {
                    "formatting": {
                        "formatString": true
                    }
                }
            }
        }
    },
}

如何使用動態字串格式

啟用動態字串格式時，自訂視覺效果會透過 update() 選項接收格式字串，如螢幕擷取畫面所示。

options.dataViews[0].categorical.values[0] 內有兩個陣列：

1. values - 來自資料集的值
2. objects - 具有 general.formatString 屬性的物件

每個 object 都會對應至 value。 作為螢幕擷取畫面的範例值 12519995905.9842，格式為 ¥ #,0。 若要將此格式套用至值，您可以使用 powerbi-visuals-utils-formattingutils 格式方法。