Exportación de datos

Con Exportación de datos, puede exportar datos de una tabla, un diseño repetitivo, o una lista de objetos complejos que contienen propiedades de tipos simples a un archivo de hoja de cálculo. Se admiten las siguientes extensiones de archivo: .xlsx y .csv.

Restricciones

No se puede utilizar este control para exportar datos del control Tabla de datos de servicio.

Propiedades de configuración

Puede definir o modificar las propiedades de configuración del control, como por ejemplo las propiedades de aspecto y comportamiento, en la pestaña de propiedades de Configuración.

Tamaño de pantalla: Una propiedad de configuración que tenga el icono Tamaños de pantalla además del nombre de propiedad, puede tener distintos valores para cada tamaño de pantalla. Si no define un valor, el tamaño de la pantalla hereda el valor del siguiente tamaño de pantalla más grande como su valor predeterminado. Si está utilizando el editor de escritorio de Process Designer (en desuso), está estableciendo el valor para el tamaño de pantalla grande. Los otros tamaños de pantalla heredan este valor.

Definiciones de temas: Las definiciones de temas especifican los colores y estilos de un control y determinan el aspecto del control. Puede obtener una vista previa del aspecto de los controles en el editor de temas. Consulte Temas.

Las propiedades de configuración de aspecto para Exportación de datos se muestran en la tabla siguiente:

Tabla 1. Propiedades de configuración de aspecto para Exportación de datos
Propiedad de configuración del aspecto	Descripción	Tipo de datos
Estilo de color	Especifica el estilo de color para el control.	`String`
Estilo de forma	Especifica el estilo de forma del control. El valor predeterminado es cuadrado.	`String`
Estilo de tamaño	Especifica el tamaño del control.	`String`
Sólo esquema	Especifica si el control muestra su estilo de color solo al pasar un cursor por encima del mismo. De forma predeterminada, esta propiedad no está seleccionada.	`Boolean`
Icono	Especifica el nombre del icono que precede al texto del botón. Por ejemplo: `calendar`, `clock-o`, `camera`, `cloud-upload`, `bell`, `info`, `file-text`. Consulte Font Awesome para obtener una lista completa de iconos. De forma predeterminada, no hay ningún icono especificado.	`String`
Anchura	Especifica el ancho del control en `px` (píxeles), `%` (porcentaje) o unidades `em`. Por ejemplo, `50px`, `20%` o `0.4em`. Si no se especifica ningún tipo de unidad, se presupone que es `px`	`String`

Las propiedades de configuración del comportamiento para Exportación de datos se muestran en la tabla siguiente:

Tabla 2. Propiedades de configuración de comportamiento para Exportación de datos
Propiedad de configuración del comportamiento	Descripción	Tipo de datos
Control de destino	Especifica la vía de acceso relativa a la tabla o diseño repetitivo utilizado para llenar el archivo de salida. Si este control está enlazado a datos, el valor se sobrescribe. Consejo: Si experimenta problemas con la exportación parcial de datos, por ejemplo, con tablas con páginas, enlace el control Exportación de datos a la misma variable de lista que la tabla en lugar de utilizar la propiedad control Destino.	`String`
Tipo de archivo de exportación	Especifica el tipo de archivo del archivo de salida: `{Microsoft Excel 2007+ file type xlsx \| Comma Separated Values file type csv}`	`String`
Nombre de archivo predeterminado	Especifica el nombre predeterminado del archivo de salida. Los usuarios pueden cambiar el nombre al guardar sus archivos.	`String`
Incluir cabeceras de columna	Incluye las cabeceras de columna en la parte superior del archivo de salida. Si el control está enlazado a una tabla, y la propiedad Cabeceras de columna no tiene ningún lector definido, se incluyen las cabeceras de columna de la tabla de enlace. Si el control está enlazado a datos, los valores de la propiedad Cabeceras de columna se utilizan como las cabeceras de columna.	`Boolean`
Índice de pestañas	Especifica el índice de secuencia de pestañas. Los índices de pestañas empiezan en 1 y se pueden establecer de forma dispersa. Por ejemplo, puede utilizar 1, 5, 10. Esta propiedad controla la secuencia de las pestañas al desplazarse entre las distintas áreas de un coach pulsando la tecla Tabulador.	`Integer`
Incluir columnas ocultas	Incluye todas las columnas, independientemente de su estado de visibilidad. De forma predeterminada, las columnas que no son visibles no se incluyen en el archivo de salida. Si este control está enlazado a datos, se incluyen todas las columnas.	`Boolean`
Formato de columnas	Especifica opciones de configuración para las columnas exportadas. Serie de formato de columna. El formato de datos para utilizar para cada columna en el archivo de salida, según los estándares de formato de Microsoft. Cuando se exportan datos a un archivo .csv, no se mantiene el estilo de color del control de destino en el archivo de salida. Para obtener más información sobre los estándares de formato de Microsoft formatting, consulte Crear o suprimir un formato de número personalizado.	`ColumnSpec[]`
Cabeceras de columna	Las cabeceras de las columnas exportadas. Requiere que la propiedad Incluir columnas ocultas esté seleccionada. Si el control está enlazado a una tabla, se utilizan estas cabeceras en lugar de las cabeceras de columna de tabla.

Sucesos

La Exportación de datos de Establezca o modifique los manejadores de sucesos para el control en la pestaña Sucesos. Puede definir que los sucesos se desencadenen mediante programación o cuando el usuario interactúa con el control. Para obtener información sobre cómo definir y codificar sucesos, consulte Sucesos definidos por el usuario. tiene los tipos siguientes de manejadores de sucesos:

Al cargar: Se activa cuando se carga la vista. Por ejemplo,
```
console.log("DataExport loaded")
```
Al pulsar: Se activa cuando un usuario pulsa en el coach y antes de generar el archivo de salida. Por ejemplo,
```
return ${Text1}.isValid();
```
Si la expresión evaluada devuelve false, no se genera el archivo de salida.
Al exportar celda: Se activa cuando se exporta una celda. La expresión puede devolver un valor de serie, número o booleano para sustituir el valor de celda, un nulo para provocar que la celda exportada esté en blanco o un objeto que contenga una propiedad de formato para sobrescribir el formato de la celda. Si se devuelve un objeto, también puede contener una propiedad de valor para sobrescribir el valor exportado de la celda. Por ejemplo,
```
me.setVisible("READONLY")
```

Métodos

Si desea más información sobre los métodos para Exportación de datos, consulte la API JavaScript Exportación de datos.

Recursos adicionales

Para obtener información sobre cómo crear un coach, consulte Creación de coaches.
Para obtener información sobre las propiedades estándar (General, Configuración, Posicionamiento, Visibilidad y Atributos HTML), consulte Propiedades de vista de coach.