Compartilhar via

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

  • Artigo

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.

Screenshot of update options content with dynamic format strings.

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.