Mashup Builder > Widgets > Widgets estándar > Widget de recopilación (con temas)
Widget de recopilación (con temas)
El widget de recopilación es un widget dinámico que permite mostrar una serie de mashups repetidos como celdas dentro de una recopilación. Es posible configurar esquemas avanzados y agrupar celdas para facilitar a los usuarios la visualización de la recopilación en distintos tamaños de pantalla. Para mostrar datos dentro de las celdas de recopilación, se debe definir una infotable con datos para las celdas del mashup. También se puede configurar el comportamiento de la carga de datos para optimizar el rendimiento al cargar conjuntos de datos de gran tamaño.
* 
Este widget también está disponible como componente Web en Web Component SDK.
Prácticas recomendadas
Evite ejecutar servicios en cada celda de mashup de recopilación. La ejecución de varios servicios repetidamente para cada celda de una recopilación requiere un número significativo de solicitudes de red. Todos los servicios del mashup de recopilación se ejecutan repetidamente cuando se inicializa el mashup padre, lo que puede provocar problemas significativos de rendimiento a medida que se carga cada celda. Para evitar problemas de rendimiento, ejecute los servicios de datos en el mashup padre y, a continuación, pase los datos a los mashups contenidos mediante los parámetros de mashup y la propiedad MashupPropertyBinding. Para obtener más información sobre el trabajo con parámetros, consulte el tema Configuración de los parámetros de mashup.
Pulsación en Comportamiento de eventos dentro de las celdas
Las celdas de recopilación pueden mostrar múltiples widgets interactivos y no interactivos. Cuando en una celda se incluye un widget interactivo en el que se pulsa, un controlador de eventos comprueba si el widget tiene un evento Clicked enlazado. Cuando el evento está enlazado, se activa el evento de pulsación del widget. Cuando el evento no está enlazado, el widget se considera no interactivo y se selecciona la celda en su lugar. Por ejemplo, en la recopilación se puede mostrar un widget de dial de KPI que tiene un evento Clicked opcional. Cuando el evento está enlazado, el controlador de eventos registra el evento y se ejecuta el servicio o la función enlazados. Cuando el evento no está enlazado, se selecciona la celda de recopilación.
Propiedades
Nombre de la propiedad
Descripción
Tipo base
Valor por defecto
Enlazable
Localizable (Sí/No)
Data
El origen de datos infotable para el widget de recopilación.
INFOTABLE
No
DragActionsData
Una propiedad JSON que almacena los cambios realizados en las celdas de colecciones al utilizar acciones de arrastrar y soltar. Se almacenan los números de índice de las celdas añadidas, quitadas y reordenadas.
JSON
N/D
No
DragCells
Permite al usuario arrastrar y soltar celdas en la recopilación en tiempo de ejecución. Cuando esta opción está activada, no se soportan la clasificación ni las secciones.
BOOLEAN
Falso
No
DragCellsBetweenWidgets
Permite a los usuarios arrastrar y soltar celdas entre dos widgets de recopilación diferentes en tiempo de ejecución. Para soportar esto, ambos widgets deben tener esta propiedad activada y compartir la misma definición de datos.
BOOLEAN
Falso
No
ItemLoadBehavior
Permite controlar el comportamiento de carga de los datos de recopilación. Es posible cargar y descargar datos mientras los usuarios se desplazan, cargar datos progresivamente a petición o bien cargar el conjunto de datos completo inicialmente.
STRING
Cargar/Descargar
No
No
Layout
Permite especificar el diseño que se va a utilizar para las celdas de la recopilación. Opciones: flex, rejilla, tabla.
STRING
Flex
No
Mashup
El mashup que se utilizará para mostrar los datos de recopilación.
MASHUPNAME
No
Width
Permite definir el ancho del widget.
NUMBER
400
No
No
Height
Permite definir la altura del widget.
NUMBER
300
No
No
MashupHeight
Permite definir la altura del mashup de recopilación.
NUMBER
No
MashupWidth
Permite definir el ancho del mashup de recopilación.
NUMBER
No
MashupWidthField
Permite especificar el campo de infotable para definir el ancho de celda mediante un servicio. Los valores sustituyen MashupHeight.
Columna de infotable
No
No
MashupHeightField
Permite especificar el campo de infotable para definir la altura de celda mediante un servicio. Los valores sustituyen MashupHeight.
Columna de infotable
No
No
UIDField
Obligatorio. Permite especificar el campo de infotable con el identificador único de cada celda.
Columna de infotable
No
No
LastRowAlignment
Permite controlar la alineación de las celdas dentro de la última fila de la recopilación. Opciones: Por defecto, Espacio uniforme, Espacio intermedio, Izquierda, Centro, Derecha, Estirar
STRING
Por defecto
No
No
ContentAlignment
Permite controlar la alineación vertical del contenido de la recopilación cuando el número de celdas es demasiado pequeño para rellenar el espacio disponible en el esquema.
Opciones: Arriba, Centro, Abajo
STRING
Centro
No
No
RowHorizontalAlignment
Permite controlar la alineación horizontal de las celdas dentro de las filas de la recopilación. Opciones: Espacio uniforme, Espacio intermedio, Izquierda, Centro, Derecha, Estirar
STRING
Espacio uniforme
No
No
RowVerticalAlignment
Permite controlar la alineación vertical de las celdas dentro de las filas de la recopilación. Opciones: Arriba, Centro, Estirar, Abajo
STRING
Centro
No
No
UniformRowHeight
Permite mostrar filas con la misma altura.
BOOLEAN
Falso
No
No
RowGap
Permite definir el espaciado entre las filas de la recopilación.
NUMBER
40
No
No
ColumnGap
Permite definir el espaciado entre las columnas de la recopilación.
NUMBER
40
No
No
SectionGap
Permite definir el espaciado entre las secciones de la recopilación.
NUMBER
48
No
No
TopPadding
Permite definir el relleno entre el margen superior de la recopilación y la primera celda.
NUMBER
24
No
No
BottomPadding
Permite definir el relleno entre el margen inferior de la recopilación y la última celda.
NUMBER
24
No
No
RightPadding
Permite definir el relleno entre el borde derecho del widget y la recopilación de celdas.
NUMBER
24
No
No
LeftPadding
Permite definir el relleno entre el borde izquierdo del widget y la recopilación de celdas.
NUMBER
0
No
No
MashupBackground
Permite controlar el fondo del mashup de recopilación y todos sus contenedores. Cuando el fondo del mashup es transparente, los estilos que se aplican al fondo de celda son visibles. Opciones: transparente, Visible
STRING
Visible
No
No
MashupNameField
Permite especificar un campo de infotable para proporcionar el nombre del mashup mediante un servicio de datos. Esta propiedad sustituye a la propiedad Mashup.
Columna de infotable
No
No
MashupPropertyBinding
Un objeto JSON serializado que tiene campos de infotable como claves y parámetros de mashup como valores. Por ejemplo:
{
"min_temp": "minTemp"
}
JSON
No
No
MashupGlobalPropertyBinding
Un objeto JSON serializado que tiene nombres de parámetros globales como claves y tipos de datos como valores. Estas propiedades se pueden enlazar al widget de recopilación y los valores se pueden enviar a cada mashup de celda.
{
"minTemp": "STRING"
}
JSON
No
No
SelectedCellMashupField
Permite especificar un campo de infotable para definir el estado seleccionado de cada celda de la recopilación.
Columna de infotable
No
No
UseMashupDimensions
Permite hacer coincidir el tamaño de la celda con las cotas del mashup.
BOOLEAN
Falso
No
No
SelectionMode
Permite controlar el número de celdas que los usuarios pueden seleccionar en tiempo de ejecución. Opciones: Ninguno, Único, Varios
STRING
Ninguno
No
No
HasSelectedCells
Se devuelve Verdadero cuando el widget tiene celdas seleccionadas.
BOOLEAN
Falso
No
SelectedCellsCount
Se devuelve el número de celdas seleccionadas en la recopilación.
NUMBER
0
No
No
ScrollToSelectedCell
Se desplaza automáticamente a las celdas cuando se seleccionan.
BOOLEAN
Falso
No
No
AutoSelectFirstRow
Permite seleccionar automáticamente la primera fila cuando se cargan datos en la recopilación.
BOOLEAN
Falso
No
No
SelectedCells
Permite especificar las celdas de la recopilación que se seleccionarán mediante una infotable.
INFOTABLE
No
SelectedCellMashup
Permite especificar un mashup alternativo para mostrar en las celdas seleccionadas de la recopilación. En este mashup se deben incluir las mismas propiedades que el mashup por defecto.
Selector de mashup
No
HandleSelectionUpdates
Cuando se activa, el widget envía y recibe actualizaciones de selección hacia y desde su servicio de datos.
BOOLEAN
True
No
No
CellMenu
Permite especificar la definición de estado que se utiliza para definir el menú de celdas que aparece al deslizarse sobre las celdas de los dispositivos táctiles. En los dispositivos que no disponen de interfaz táctil, este menú se muestra al pulsar con el botón derecho del ratón en las celdas.
STATEDEFINITION
No
No
CellMenuIconSize
Permite especificar el tamaño de los iconos del menú de celdas.
NUMBER
20
No
No
CellActionsPosition
Permite controlar la posición del botón de menú de celdas. Opciones: Arriba, Abajo, Derecha, Izquierda
STRING
Abajo
No
No
CellTabKeyScope
Permite controlar el ámbito de la navegación cuando se interactúa con el contenido de una celda mediante el teclado. Opciones: Celda, Recopilación, Solo elementos. Cuando el ámbito se define en celda, al pulsar el tabulador se pasa por encima de los elementos de la celda. Cuando el ámbito se define en recopilación, al pulsar la tecla del tabulador, el foco vuelve a la celda después de seleccionar el último elemento. Seleccione Solo elementos para centrarse únicamente en el contenido de la celda y omitir la celda en sí al navegar entre celdas.
* 
Al migrar desde un widget de recopilación heredado, esta propiedad se establece por defecto en Solo elementos.
STRING
Celda
No
No
CellUnloadDelay
Se especifica el tiempo de demora, expresado en segundos, antes de descargar las celdas de recopilación del DOM cuando están fuera de la vista. Esta propiedad solo se aplica cuando ItemLoadBehavior se define en Cargar a petición.
NUMBER
N/D
N
No
CellPointer
Permite controlar el estilo del puntero del ratón al pasar el ratón sobre una celda de la recopilación. Opciones: automático, pointer, por defecto
STRING
Automático
No
No
SectionField
Permite especificar el campo de infotable con valores de identificador que se pueden utilizar para agrupar celdas dentro de secciones.
INFOTABLE
No
No
SectionInsetLeft
Permite definir el valor del recuadro izquierdo de secciones al agrupar celdas.
NUMBER
0
No
No
SectionInsetTop
Permite definir el valor del recuadro superior de secciones al agrupar celdas.
NUMBER
0
No
No
SectionInsetRight
Permite definir el valor del recuadro derecho de las secciones al agrupar celdas.
NUMBER
0
No
No
SectionInsetBottom
Permite definir el valor del recuadro inferior de secciones al agrupar celdas.
NUMBER
0
No
No
SortField
Permite especificar el campo de infotable por el que se clasifica el contenido de la sección. La clasificación se realiza en el cliente y no afecta a la infotable de origen ni a otros widgets enlazados al conjunto de datos.
INFOTABLE
No
SortAscending
Permite clasificar el contenido de la sección en orden ascendente cuando la propiedad SortField está activada. Por defecto, las secciones se clasifican en orden descendente.
BOOLEAN
Falso
No
SectionHeaders
Permite controlar la visibilidad de las cabeceras de sección al agrupar celdas en la recopilación. Opciones: Ninguno, Visible, Anclado
STRING
Ninguno
No
No
HeaderMashup
Permite especificar el mashup que se utilizará para las cabeceras de sección al agrupar celdas en la recopilación.
MASHUPNAME
Ninguno
No
No
HeaderSectionParam
El nombre del parámetro de mashup de cabecera que recibirá el identificador de sección.
STRING
No
No
HeaderHeight
Permite definir la altura de las cabeceras de sección de la recopilación.
NUMBER
40
No
No
SectionFooters
Permite controlar la visibilidad de los pies de sección al agrupar celdas en la recopilación. Opciones: Ninguno, Visible, Anclado
STRING
Ninguno
No
No
FooterMashup
Permite especificar el mashup que se utilizará para el pie de sección al agrupar celdas en la recopilación.
MASHUPNAME
No
No
FooterSectionParam
El nombre del parámetro de mashup de pie de página que recibirá el identificador de sección.
STRING
No
No
FooterHeight
Permite definir la altura de los pies de sección al agrupar celdas en la recopilación.
NUMBER
40
No
No
EmptyMashup
Permite especificar el mashup que se debe mostrar cuando una celda de la recopilación no contenga datos.
MASHUPNAME
Ninguno
No
No
Deselect
Un servicio enlazable que borra de la memoria cualquier selección de la recopilación.
Servicio
No
SelectAll
Un servicio enlazable que selecciona todas las celdas de la recopilación.
Servicio
No
DisableWrapping
Cuando se activa, las celdas se muestran en una fila con una barra de desplazamiento horizontal. Cuando se desactiva, las celdas se ajustan en una nueva fila cuando el espacio horizontal disponible no es suficiente para mostrar la colección completa. Esta propiedad solo se soporta cuando la recopilación se configura mediante el modo de esquema Flex.
BOOLEAN
Falso
No
No
Eventos
Nombre de la propiedad
Descripción
Tipo base
Enlazable
Localizable (Sí/No)
CellClicked
Un evento que se activa cuando un usuario pulsa o toca en una celda en la colección.
Evento
No
CellDoubleClicked
Un evento que se activa cuando un usuario pulsa o toca dos veces en una celda en la colección.
Evento
No
CellLongClicked
Un evento que se activa cuando un usuario pulsa o mantiene tocada una celda en la colección durante más de 400 milisegundos.
Evento
No
CellRightClicked
Un evento que se activa cuando un usuario pulsa con el botón derecho del ratón en una celda en la colección.
Evento
No
CellAdded
Evento que se activa cuando se añade una celda a la recopilación mediante arrastrar y soltar.
Evento
No
CellRemoved
Un evento que se activa cuando se quita una celda de la recopilación.
Evento
No
CellMoved
Un evento que se activa cuando se mueve una celda dentro de la recopilación. Este evento también se activa cuando una celda se mueve a otra sección dentro de la recopilación.
Evento
No
¿Fue esto útil?