Sdílet prostřednictvím


Rozhraní API pro dynamický formát vlastního vizuálu Power BI

Od rozhraní API verze 4.2 můžou vývojáři vytvářet sestavy s podporou dynamických formátů řetězců.

Povolení podpory dynamického formátu pro vizuál

Aby vizuál mohl pracovat s řetězci dynamického formátu, měly by být do capabilitites.jsonpole přidána následující pole:

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

Jak používat formát dynamického řetězce

Pokud je povolený dynamický formát řetězce, vlastní vizuál přijímá formátovací řetězce prostřednictvím update() možností, jak je znázorněno na snímku obrazovky.

Screenshot of update options content with dynamic format strings.

Uvnitř jsou dvě pole options.dataViews[0].categorical.values[0]:

  1. values - hodnoty z datové sady
  2. objects - objekty s general.formatString vlastností

Každý object odpovídá hodnotě value. Jako příklad hodnoty 12519995905.9842 ze snímku obrazovky má formát ¥ #,0. Chcete-li použít tento formát na hodnotu, můžete použít metodu formátování z powerbi-visuals-utils-formattingutils.