API de formato dinâmico de visual personalizado do Power BI

A partir da API versão 4.2, os desenvolvedores podem criar relatórios com suporte formatos de cadeia de caracteres dinâmicos.

Habilitar o suporte de formato dinâmico para o visual

Para permitir que o visual opere com cadeias de caracteres de formato dinâmico, os seguintes campos devem ser adicionados ao capabilitites.json:

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

Como usar o formato dinâmico de cadeia de caracteres

Quando o formato dinâmico de cadeia de caracteres estiver habilitado, o visual personalizado receberá cadeias de caracteres de formato por meio das opções update(), conforme mostrado na captura de tela.

Há duas matrizes dentro de options.dataViews[0].categorical.values[0]:

1. values: valores do conjunto de dados
2. objects: objetos com a propriedade general.formatString

Cada object corresponde a um value. Como exemplo, um valor 12519995905.9842 da captura de tela tem o formato ¥ #,0. Para aplicar esse formato ao valor, você pode usar o método de formato de powerbi-visuals-utils-formattingutils.