Configurar el nombre para mostrar de un campo de datos visual

En este artículo se describe cómo obtener y establecer el nombre para mostrar de un campo de datos visual asignado a un rol de datos. La capacidad de cambiar los nombres para mostrar de los campos de datos visuales es útil para los objetos visuales que muestran nombres de campo de datos en informes como encabezados de columna. Por ejemplo, objetos visuales de tabla y matriz.

Obtener el nombre para mostrar

Para obtener el nombre para mostrar de un campo de datos visual, llame al método getDataFieldDisplayName del objeto visual.

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

Este método tiene las siguientes variables:

  • dataRole: el nombre del rol de datos de destino al que se asigna el campo de datos.
  • index: índice del campo de datos cuyo nombre para mostrar se lee.

Por ejemplo:

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

Para obtener información sobre el método getDataFields, vea Configurar campos de datos. Para obtener información sobre el método getCapabilities, vea Obtener las funcionalidades de un objeto visual.

Establecimiento del nombre para mostrar

Para establecer el nombre para mostrar de un campo de datos visual, llame al método setDataFieldDisplayName del objeto visual.

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

Este método tiene las siguientes variables:

  • dataRole: el nombre del rol de datos de destino al que se asigna el campo de datos.
  • index: índice del campo de datos cuyo nombre para mostrar se va a cambiar.
  • newDisplayName: el nuevo nombre para mostrar del campo de datos.

Por ejemplo:

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

Contenido relacionado

  • Last updated on