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 中的 format 方法。