Partilhar via

API de formato dinâmico visual personalizado do Power BI

  • Artigo

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

Habilite o suporte ao formato dinâmico para visual

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

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

Como usar o formato de cadeia de caracteres dinâmica

Quando o formato de cadeia de caracteres dinâmico está habilitado, o visual personalizado recebe cadeias de caracteres de formato através das update() opções, conforme mostrado na captura de tela.

Screenshot of update options content with dynamic format strings.

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

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

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