Freigeben über

Konfigurieren des Anzeigenamens eines visuellen Datenfelds

In diesem Artikel wird beschrieben, wie Sie den Anzeigenamen eines visuellen Datenfelds abrufen und festlegen, das einer Datenrolle zugewiesen ist. Die Möglichkeit zum Ändern von Anzeigenamen visueller Datenfelder ist nützlich für visuelle Elemente, die Datenfeldnamen in Berichten als Spaltenüberschriften anzeigen. Beispiel: visuelle Tabellen- und Matrixelemente.

Abrufen des Anzeigenamens

Rufen Sie zum Abrufen des Anzeigenamens eines visuellen Datenfelds die getDataFieldDisplayName Methode des visuellen Elements auf.

getDataFieldDisplayName(dataRole: string, index: number): Promise<string>

Diese Methode hat die folgenden Variablen:

  • dataRole – Der Name der Zieldatenrolle, der das Datenfeld zugewiesen ist.
  • index – Der Index des Datenfelds, dessen Anzeigename gelesen wird.

Zum Beispiel:

let dataFieldDisplayName = visual.getDataFieldDisplayName('Category', 1);

Informationen zur getDataFields-Methode finden Sie unter Konfigurieren von Datenfeldern. Informationen zur getCapabilities-Methode finden Sie unter Abrufen der Funktionen eines visuellen.

Festlegen des Anzeigenamens

Rufen Sie zum Festlegen des Anzeigenamens eines visuellen Datenfelds die setDataFieldDisplayName Methode des visuellen Elements auf.

setDataFieldDisplayName(dataRole: string, index: number, newDisplayName: string): Promise<IError>

Diese Methode hat die folgenden Variablen:

  • dataRole – Der Name der Zieldatenrolle, der das Datenfeld zugewiesen ist.
  • index – Der Index des Datenfelds, dessen Anzeigename umbenannt werden soll.
  • newDisplayName – Der neue Anzeigename für das Datenfeld.

Zum Beispiel:

await visual.setDataFieldDisplayName('Category', 1, 'New Display Name');

Verwandte Inhalte