Control Tabla de datos de servicio

Utilizando el control Tabla de datos de servicio, similar al control Tabla, puede crear una tabla que se repite. El control Tabla de datos de servicio debe especificar un servicio AJAX que devuelve los datos que se mostrarán en la tabla. Por esta razón, no vincule la tabla de datos a una variable.

Propiedades de configuración

Puede definir o modificar las propiedades de configuración del control, como por ejemplo propiedades de aspecto, de comportamiento, de columnas y de rendimiento en la pestaña de propiedades 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 del escritorio de Process Designer, 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.

En la tabla siguiente se muestran las propiedades de configuración del aspecto para el control Tabla de datos de servicio:

Tabla 1. Propiedades de configuración del aspecto para el control Tabla de datos de servicio
Propiedad de configuración del aspecto	Descripción	Tipo de datos
Estilo de tabla	Establezca el estilo de tabla a utilizar.	`String`
Estilo de color	Establezca el estilo de color de la tabla.	`String`
Resaltar selección	Sombrea las filas que tienen estado seleccionado. Esta opción requiere que se especifique un estilo de color distinto de `Ninguno`.	`Boolean`
Anchura	La anchura en px, % o em, por ejemplo 50px, 20%, o 0,4 em. Si no se especifica ninguna unidad, se presupone que es px.	`String`
Altura	La altura de la tabla en px o en em (sin incluir la cabecera ni el pie, si se muestran), por ejemplo 50px o 0.4 em. Si no se especifica ninguna unidad, se presupone que es px.	`String`

En la tabla siguiente se muestran las propiedades de configuración del comportamiento para el control Tabla de datos de servicio:

Tabla 2. Propiedades de configuración del comportamiento del control Tabla de datos de servicio
Propiedad de configuración del comportamiento	Descripción	Tipo de datos
Servicio de datos	El servicio Ajax a utilizar con este control. El servicio proporciona datos a la tabla.	`AJAX Service`
Datos de servicio	Datos de entrada para el servicio de datos. El tipo debe coincidir con el tipo de entrada para el servicio.	`ANY`
Iniciar vacía	La tabla está vacía inicialmente. La tabla se llena al ejecutar el servicio utilizando el método Renovar.	`Boolean`
Modalidad de selección	La modalidad de selección de elementos de la tabla.	`String`
Mostrar pie	Muestra el pie de la tabla.	`Boolean`
Mostrar estadísticas de tabla	Muestra las estadísticas de la tabla (por ejemplo "Mostrando 1 a 5 de 59 entradas").	`Boolean`
Mostrar paginador	Habilita la paginación.	`Boolean`
Mostrar medidor de página	Habilita la opción de elegir el número de filas a visualizar por página.	`Boolean`
Tamaño de página inicial	El número máximo inicial de entradas que se muestran por página.	`Integer`

En la tabla siguiente se muestran las propiedades de configuración de columnas para el control Tabla de datos de servicio:

Tabla 3. Propiedades de configuración de columna del control Tabla de datos de servicio
Propiedad de configuración de columnas	Descripción	Tipo de datos
dataElementName	Nombre del elemento de datos a mostrar para la columna.	`String`
renderAs	Seleccione cómo se debe representar la celda.	`String`
visibilidad	La visibilidad de la columna.	`String`
ordenable	Si esta opción está habilitada, los usuarios pueden ordenar la tabla utilizando esta columna.	`Boolean`
opciones	Datos opcionales a pasar a la celda, según el tipo de datos de la columna: `Decimal: thousandsSeparator`, `decimalPlaces`, `decimalSeparator`, `postfix`, `prefix - DatePicker: datePattern - Link: href - Integer: thousandSeparator`.	`String`
css	Opciones CSS a añadir a la columna, por ejemplo color:#00ff00.	`String`
anchura	El ancho de la columna.	`String`
etiqueta	Defina la etiqueta de columna.	`String`

En la tabla siguiente se muestran las propiedades de configuración del rendimiento para el control Tabla de datos de servicio:

Tabla 4. Propiedades de configuración del rendimiento del control Tabla de datos de servicio
Propiedad de configuración del rendimiento	Descripción	Tipo de datos
Carga asíncrona	Proporciona una mejor experiencia de interfaz de usuario para conjuntos de datos grandes (en detrimento de un tiempo de carga de filas general más lento una vez que la sección empieza a cargarse).	`Boolean`
Tamaño de lote asíncrono	Define cuántas filas se cargan de forma síncrona en un lote asíncrono. Esta opción puede ayudarle a optimizar el rendimiento de carga síncrono con el asíncrono.	`ANY`

Sucesos

Establezca o modifique los manejadores de sucesos para el control en la pestañaSucesos. 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.

El usuario no interacciona con el control Tabla de datos de servicio, sino que los sucesos se activan cuando el usuario obtiene un resultado o un error de la llamada al flujo de servicios.

El control Tabla de datos de servicio tiene los siguientes tipos de manejadores de sucesos.

Al cargar: Se activa cuando se carga la tabla, por ejemplo:
```
me.setPageIndex(0);
```
Al cargar los datos de servicio: Se activa cuando se completa satisfactoriamente un servicio Ajax que suministra datos a la tabla, por ejemplo
```
alert("AJAX service has returned with data");
```
En error de datos de servicio: Se activa cuando un servicio Ajax que suministra datos a la tabla da error, por ejemplo
```
alert("AJAX service has returned with an error");
```
En celda personalizada: Se activa cuando se carga una celda con opciones de representación personalizadas si el valor de configuración Representar está establecido en Personalizado en la sección Columnas, por ejemplo
```
var div = document.createElement("div"); div.innerHTML =cell.row.data[cell.varName]; return div;
```
En filas cargadas: sólo es aplicable para las tablas con páginas, este suceso se activa sólo cuando se muestran las filas, por ejemplo
```
alert("All rows have " + (all ? "" : "NOT") + " been loaded");
```
En filas seleccionadas por usuario: Se activa cuando una fila ha sido seleccionada por un usuario, por ejemplo
```
alert("Selected row has index " + row.index);
```

Métodos

Para obtener información detallada sobre los métodos disponibles para el control Tabla de datos de servicio, consulte la documentación de JavaScript.

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.