Freigeben über


API für benutzerdefinierte dynamische Power BI-Formate

Ab Version 4.2 der API können Entwickelnde Berichte mit Unterstützung dynamischer Zeichenfolgenformate erstellen.

Aktivieren der Unterstützung dynamischer Formate für Visuals

Damit das Visual mit dynamischen Formatzeichenfolgen funktioniert, sollten die folgenden Felder in capabilitites.json hinzugefügt werden:

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

Verwenden des dynamischen Zeichenfolgenformats

Wenn das dynamische Zeichenfolgenformat aktiviert ist, empfängt das benutzerdefinierte Visual Formatzeichenfolgen über die Optionen in update(), wie im Screenshot gezeigt.

Screenshot of update options content with dynamic format strings.

In options.dataViews[0].categorical.values[0] gibt es zwei Arrays:

  1. values: Werte aus dem Dataset
  2. objects: Objekte mit general.formatString-Eigenschaft

Jedes object entspricht einem value. Als Beispielwert weist 12519995905.9842 aus dem Screenshot das Format ¥ #,0 auf. Um dieses Format auf den Wert anzuwenden, können Sie die Formatmethode aus powerbi-visuals-utils-formattingutils verwenden.