Konfigurace zobrazovaného názvu datového pole vizuálu

Tento článek popisuje, jak získat a nastavit zobrazovaný název datového pole vizuálu, které je přiřazeno k roli dat. Možnost změnit zobrazované názvy datových polí vizuálů je užitečná pro vizuály, které zobrazují názvy datových polí v sestavách jako záhlaví sloupců. Například tabulkové a maticové vizuály.

Získání zobrazovaného názvu

Pokud chcete získat zobrazovaný název datového pole vizuálu, zavolejte metodu getDataFieldDisplayName vizuálu.

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

Tato metoda má následující proměnné:

  • dataRole – název cílové role dat, ke které je datové pole přiřazeno.
  • index – index datového pole, jehož zobrazovaný název je přečtený.

Například:

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

Informace o metodě getDataFields naleznete v tématu Konfigurace datových polí. Informace o metodě getCapabilities naleznete v tématu Získání schopností vizuálu.

Nastavení zobrazovaného názvu

Pokud chcete nastavit zobrazovaný název datového pole vizuálu, zavolejte metodu setDataFieldDisplayName vizuálu.

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

Tato metoda má následující proměnné:

  • dataRole – název cílové role dat, ke které je datové pole přiřazeno.
  • index – index datového pole, jehož zobrazovaný název se má přejmenovat.
  • newDisplayName – nový zobrazovaný název datového pole.

Například:

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