Configurare il nome visualizzato di un campo dati visivo

Questo articolo descrive come ottenere e impostare il nome visualizzato di un campo dati visivo assegnato a un ruolo dati. La possibilità di modificare i nomi visualizzati dei campi dati visivi è utile per gli oggetti visivi che visualizzano i nomi dei campi dati nei report come intestazioni di colonna. Ad esempio, oggetti visivi tabella e matrice.

Ottenere il nome visualizzato

Per ottenere il nome visualizzato di un campo dati visivo, chiamare il metodo getDataFieldDisplayName dell'oggetto visivo.

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

Questo metodo ha le variabili seguenti:

  • dataRole: nome del ruolo dati di destinazione a cui è assegnato il campo dati.
  • index: indice del campo dati il cui nome visualizzato è letto.

Per esempio:

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

Per informazioni sul metodo getDataFields, vedere Configurare i campi dati. Per informazioni sul metodo getCapabilities, vedere Ottenere le funzionalità di un oggetto visivo.

Impostare il nome visualizzato

Per impostare il nome visualizzato di un campo dati visivo, chiamare il metodo setDataFieldDisplayName dell'oggetto visivo.

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

Questo metodo ha le variabili seguenti:

  • dataRole: nome del ruolo dati di destinazione a cui è assegnato il campo dati.
  • index: indice del campo dati il cui nome visualizzato deve essere rinominato.
  • newDisplayName: nuovo nome visualizzato per il campo dati.

Per esempio:

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