Condividi tramite

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

  • Articolo

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

Abilitare il supporto del formato dinamico per l'oggetto visivo

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

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

Come usare il formato di stringa dinamico

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

Screenshot del contenuto delle opzioni di aggiornamento con stringhe di formato dinamico.

All'interno di options.dataViews[0].categorical.values[0] esistono due matrici:

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

Ogni object corrisponde a un value. A titolo di valore di esempio, 12519995905.9842 nello screenshot ha il formato ¥ #,0. Per applicare questo formato al valore, è possibile usare il metodo formato di powerbi-visuals-utils-formattingutils.