Condividi tramite


API per il formato dinamico dell'oggetto visivo personalizzato di Power BI

Dalla versione 4.2 dell'API, gli sviluppatori possono creare report con supporto per formati di stringa dinamici.

Abilitare il supporto del formato dinamico per l'oggetto visivo

Per consentire all'oggetto visivo di operare con stringhe di formato dinamico, è necessario aggiungere i campi seguenti in capabilitites.json:

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

Come usare il formato di stringa dinamica

Quando il formato di stringa dinamica è abilitato, l'oggetto visivo personalizzato riceve stringhe di formato tramite le update() opzioni, come illustrato nello screenshot.

Screenshot of update options content with dynamic format strings.

Esistono due matrici all'interno di options.dataViews[0].categorical.values[0]:

  1. values - valori del set di dati
  2. objects - oggetti con general.formatString proprietà

Ognuno object corrisponde a un oggetto value. Come valore 12519995905.9842 di esempio dello screenshot ha il formato ¥ #,0. Per applicare questo formato al valore, è possibile usare il metodo format di powerbi-visuals-utils-formattingutils.