Puede hacer lo siguiente para crear aplicaciones dinámicas e interactivas con Experience Builder:
- Conecte widgets con datos y configúrelos con contenido dinámico.
- Configure interacciones entre un widget y el marco (fuente de datos).
- Configure interacciones entre widgets.
Puede agregar dos tipos de acciones a los widgets: acciones de mensaje y acciones de datos. Las acciones de mensaje escuchan a los desencadenadores y realizan acciones automáticamente, como filtrar una lista para mostrar solo los registros dentro de la extensión actual de un mapa. Las acciones de datos proporcionan un botón Acciones en el que los usuarios pueden hacer clic en widgets en el tiempo de ejecución y seleccionar de entre una lista de acciones a realizar, como exportar registros a un archivo.
Acciones de mensaje
Las aplicaciones de Experience Builder están basadas en datos, lo que significa que los datos visualizados con widgets pueden cambiar universalmente cuando se actualizan los datos subyacentes. Puede definir interacciones entre un widget y los datos configurando acciones de mensaje en respuesta a los desencadenadores. Por ejemplo, puede crear una interacción de forma que, siempre que el widget Mapa cambie su extensión, los otros widgets (como Lista) se filtren y muestren solo las entidades dentro de la extensión actual. Para ello, defina Cambios de extensión en el widget Mapa como desencadenador y Filtrar registros de datos de la vista de datos utilizada por la Lista como una acción. Como los widgets están basados en datos, la acción de filtro se aplica en el nivel de marco y todos los widgets que usen la misma vista de datos se sincronizan automáticamente. También puede definir interacciones entre widgets. Las acciones proporcionadas por un widget solo surten efecto dentro de ese widget. Por ejemplo, puede sincronizar la extensión de dos widgets Mapa cuando los usuarios apliquen el zoom o el desplazamiento panorámico a uno de ellos configurando Cambios de extensión de un widget Mapa como desencadenador y cambien la extensión del otro widget Mapa como acción.
Las interacciones se definen y administran en el panel Acción del widget de origen que proporciona los desencadenadores. Las configuraciones de Acción de mensaje tienen tres partes:
- Desencadenadores del widget de origen
- Destinos que responden al desencadenador (widgets y el marco de aplicaciones)
- Acciones del destino relacionadas con su uso previsto
El desencadenador del widget origen solo puede agregarse una vez, aunque puede agregar varias acciones para ese desencadenador específico desde el mismo destino u otro diferente.
Desencadenadores
Los desencadenadores son eventos generados por el widget origen. Una vez que se produce un desencadenador, todas las acciones agregadas al mismo se ejecutan como respuesta. La siguiente tabla describe los cinco desencadenadores que se admiten actualmente:
| Desencadenador | Descripción |
|---|---|
Cambios de filtrado de datos | Se produce un desencadenador cuando se aplica un filtro a la fuente de datos. |
Cambios de extensión | Se produce un desencadenador cuando la extensión del mapa cambia a través de desplazamiento panorámico, acercamiento, redimensionamiento, etc. |
Cambios de selección de registros | Se produce un desencadenador cuando se selecciona un registro o se borra un registro seleccionado. |
Registros creados | Se produce un desencadenador cuando se cargan registros de resultados en el widget de origen. |
Datos agregados | Se produce un desencadenador al agregar una fuente de datos con el widget Agregar datos. |
Para ver los desencadenadores disponibles de un widget, abra sus ajustes y haga clic en Agregar un desencadenador en la pestaña Acción. La siguiente tabla contiene los widgets origen y sus desencadenadores admitidos:
| Widget origen | Datos agregados | Cambios de filtrado de datos | Cambios de extensión | Cambios de selección de registros | Registros creados |
|---|---|---|---|---|---|
Agregar datos |
| ||||
Gráfico |
| ||||
Información de entidad |
| ||||
Filtro |
| ||||
Lista |
| ||||
Mapa |
|
| |||
Consulta |
|
| |||
Buscar |
|
|
| ||
Tabla |
|
Destinos
Los destinos realizan las acciones. Un destino puede ser un widget en el marco. Si elige el marco como el destino, la acción se realiza de forma general a través de todos los widgets y páginas relevantes de la aplicación.
Acciones
A diferencia de los desencadenadores que define el marco, los destinos (especialmente widgets) proporcionan acciones para realizar lógica de negocios específica. Puede que algunas acciones necesiten configuración adicional en función de cómo maneje el destino el mensaje procedente del desencadenador. Por ejemplo, si configura una acción de filtro para una vista de datos y el desencadenador se basa en datos diferentes, puede filtrar la vista de datos de destino estableciendo un atributo o relación espacial. También puede establecer Condiciones SQL.
Diferentes destinos proporcionan diferentes acciones que se corresponden con diferentes desencadenadores. Las acciones disponibles aparecen una vez para agregar un desencadenador y seleccionar el destino. La siguiente tabla incluye destinos y sus acciones correspondientes:
| Objetivo | Acción1 | Desencadenador: datos agregados | Desencadenador: cambios de filtrado de datos | Desencadenador: cambios de selección de registros | Desencadenador: cambios de extensión | Desencadenador: registros creados |
|---|---|---|---|---|---|---|
Marco | Filtrar registros de datos: mantenga en la vista de datos solo los registros que cumplan las condiciones para su posterior visualización o procesamiento a través de la aplicación. |
|
| |||
Seleccionar registros de datos2: marque los registros como seleccionados y colóquelos en la vista Entidades seleccionadas. |
| |||||
Widget Business Analyst | Seleccionar entidad: marque la entidad como seleccionada. |
| ||||
Widget Perfil de elevación | Seleccionar línea: marque la entidad de línea como seleccionada y genere un perfil de elevación. |
| ||||
Widget Mapa | Agregar al mapa: agregue datos al mapa o escena web como una capa. |
| ||||
Desplazar panorámicamente a3: mantenga la escala actual y centro en una ubicación especificada. |
|
|
|
|
| |
Acercar a4: acérquese a una ubicación especificada. |
|
|
|
|
|
|
Destacar: destaque una entidad en el mapa. |
| |||||
Filtrar: mantenga solo las entidades que cumplan las condiciones de visualización en el widget Mapa. |
| |||||
Mostrar en el mapa5: muestre los registros creados en el mapa como una nueva capa. |
|
1Para acciones de marco, si los datos de acción son la vista predeterminada, la acción afectará a todos los widgets que utilicen los datos y sus vistas. Si los datos de acción son una vista especificada, la acción solo afectará a los widgets que utilicen esa vista. Para las acciones de widget, la acción solo se realizará en el widget de destino. (Por ejemplo, la acción de filtro de mapa solo filtrará los registros del mapa y no afectará a todos los demás widgets que utilicen la misma capa).
2El estado seleccionado de un registro se sincroniza en toda la aplicación y los registros seleccionados se guardan en la vista Entidades seleccionadas de los datos. Los widgets pueden tener una configuración diferente para visualizar un registro seleccionado.
3Si un widget de Mapa está configurado con las acciones Acercar a y Desplazar panorámicamente a, la acción Acercar a tiene prioridad. Esto significa que si el usuario desplaza y amplía el mapa al mismo tiempo, se ignora la acción Desplazar panorámicamente a.
4Cuando agrega una acción Acercar a, puede cambiar la configuración Escala de zoom en la ventana Configuración de acción. Elija Personalizada para ajustar el nivel de zoom del mapa o Automática para utilizar la escala predeterminada del mapa. La acción Acercar a incluye el comportamiento de rotación para mapas web y escenas web y el comportamiento de inclinación para escenas web.
5Cuando agrega una acción Mostrar en el mapa, puede personalizar los símbolos de los registros creados. Elija Utilizar símbolos personalizados para personalizar el relleno, el contorno, la transparencia y más para puntos, líneas y polígonos. Elija Utilizar símbolos definidos por capas para utilizar los símbolos de las capas asociadas a la acción actual en el widget de origen.
Acciones de datos
Puede configurar acciones de datos para que los usuarios procesen datos en la aplicación en el tiempo de ejecución. Pueden hacer clic en el botón Acciones en los widgets de origen y optar por transmitir un dataset a un widget específico (como ver los resultados de la consulta en una tabla) o en el marco de la aplicación (para exportar los datos).
Estas interacciones se definen y administran en el panel Acción del widget de origen que proporciona el dataset de tiempo de ejecución. Las configuraciones de Acción de datos tienen dos partes:
- Destinos que reciben el dataset (widgets y el marco de aplicaciones)
- Acciones de datos proporcionadas por el destino, realizadas solo cuando los usuarios elijan
El dataset transmitido al destino varía en función del widget de origen. Por ejemplo, el widget Gráfico transfiere todos los datos estadísticos al widget Tabla, independientemente de si existe una selección o no. La siguiente tabla enumera los widgets de origen disponibles, los destinos y las acciones de datos admitidas (destino: acción de datos), así como el dataset que transfiere cada widget de origen para cada acción aplicable.
| Widget origen | Marco: Exportar | Marco: Definir filtro | Mapa: Desplazar a | Mapa: Mostrar en el mapa1 | Mapa: Acercar a | Mapa: Agregar al mapa | Tabla: Ver en tabla |
|---|---|---|---|---|---|---|---|
Agregar datos | Todos los registros | Todos los registros | Todos los registros | Todos los registros | Todos los registros | Todos los registros2 | |
Gráfico | Todos los registros o registros seleccionados (datos estadísticos) | Todos los registros o registros seleccionados (datos estadísticos) | |||||
Información de entidad | Todos los registros o los registros seleccionados | Registros seleccionados | Registros seleccionados | Registros seleccionados | Registros seleccionados | ||
Lista | Todos los registros o los registros seleccionados | Todos los registros o los registros seleccionados | Registros seleccionados | Todos los registros o los registros seleccionados | Todos los registros o los registros seleccionados | ||
Capas del mapa | Todos los registros | Todos los registros | |||||
Consulta | Todos los registros seleccionados o los registros seleccionados (resultado de la consulta) | Todos los registros seleccionados o los registros seleccionados (resultado de la consulta) | Todos los registros seleccionados o los registros seleccionados (resultado de la consulta) | Todos los registros seleccionados o los registros seleccionados (resultado de la consulta) | Todos los registros seleccionados o los registros seleccionados (resultado de la consulta) | ||
Tabla | Todos los registros o los registros seleccionados | Todos los registros o los registros seleccionados | Registros seleccionados | Todos los registros o los registros seleccionados |
1Cuando agrega una acción Mostrar en el mapa, puede personalizar los símbolos de los registros creados.
2Puede agregar muchos tipos de datos con el widget Agregar datos, pero solo los tipos de datos compatibles con el widget Tabla (capas de entidades y capas de escena con capas de entidades asociadas) pueden desencadenar la acción de datos Ver en tabla.
Cuando se realiza una acción de datos en un widget de destino, el widget de destino incluye un botón para borrarlo. Por ejemplo, cuando un usuario selecciona datos en un widget Lista y elige ver la selección en un widget Tabla, aparece un botón junto a la nueva hoja que le permite quitar la hoja de la tabla. Del mismo modo, cuando elige la acción de datos Mostrar en el mapa, aparece un botón en el mapa para borrarlo del mapa. (Refrescar la página borrará todos los resultados de las acciones de datos).
Configurar interacciones
Configure acciones de mensaje y acciones de datos en el panel Acción de los widgets de origen.
Configurar acciones de mensaje
Las acciones de mensaje se configuran en los ajustes de los widgets de origen (los widgets que proporcionan desencadenadores).
- En el panel Acción, en la pestaña Acción de mensaje, haga clic en Agregar un desencadenador.
- Agregue el desencadenador, seleccione el destino y agregue y seleccione las acciones.
Algunas acciones, como por ejemplo Filtrar, Destacar y Seleccionar registros de datos requieren configuración adicional. Las opciones de Configuración de acción aparecen cuando selecciona la acción. Cada desencadenador solo se puede agregar una vez.
- Para agregar varias acciones al mismo desencadenador, haga clic en Agregar acción.
Las acciones para el mismo desencadenador se producen en orden secuencial.
- Arrastre las acciones agrupadas bajo un desencadenador para cambiar el orden.
- Para modificar estos ajustes configurados más adelante, haga clic en el botón Configuración
de la acción. - Para cambiar una acción o un destino después de agregar una acción, debe eliminarla y agregar una nueva.
La eliminación de un desencadenador también elimina todas las acciones que tiene agregadas.
Configurar acciones de datos
Las acciones de datos se configuran en los ajustes de los widgets de origen, con la excepción de Exportar, que se configura para la fuente de datos en el panel Datos. Las acciones de datos están habilitadas de forma predeterminada y el botón Acciones del widget incluye automáticamente todas sus acciones de datos disponibles.
- En el panel Acción, en la pestaña Acción de datos, desactive o active las acciones de datos para especificar las opciones del menú de acciones del widget. De lo contrario, desactive Habilitar acción de datos para excluir el botón Acciones del widget.
- Para cada acción de datos activada, seleccione los widgets de destino con los que debe interactuar el widget de origen, por ejemplo, un widget Mapa.
Solo puede seleccionar widgets de destino que estén en la misma página que el widget de origen.
Nota:
Cuando agrega un widget de destino a una página, sus acciones de datos correspondientes se agregan automáticamente a los widgets de origen disponibles en la misma página.
Sugerencia:
Para obtener mejores resultados, coloque el widget de origen junto al widget de destino, porque las acciones de datos no saltan a la ubicación de destino en la aplicación.
- Para excluir la acción de datos Exportar, vaya al panel Datos y desactive Permitir exportación para la fuente de datos.
Uso de ejemplo
Agregue mensajes de acción para apoyar requisitos de diseño de la aplicación como por ejemplo los siguientes:
- Desea crear una aplicación que compare dos mapas, dos escenas o un mapa y una escena, para que las extensiones de los dos widgets Mapa siempre estén sincronizadas. Puede agregar un desencadenador Cambios de extensión a ambos widgets, seleccionar el otro widget como el destino para cada uno y seleccionar la acción Desplazar panorámicamente a o Acercar.
- Agrega un widget Lista junto a un widget Mapa y quiere que la lista solo visualice los registros dentro de la extensión actual del mapa. Puede agregar un desencadenador Cambios de extensión al widget Mapa, seleccionar la acción Filtrar registros de datos del marco, elegir los datos de acción como la vista de datos configurada en los ajustes del widget Lista y configurar la acción con una relación espacial a la extensión.
Use acciones de datos para apoyar requisitos de diseño de la aplicación como por ejemplo los siguientes:
- Puede agregar un widget Gráfico para representar un conjunto de datos numéricos o cualitativos como un gráfico y desea ofrecer al usuario una opción para ver los datos estadísticos generados por el gráfico en un widget Tabla. Cuando agrega un widget Tabla junto al widget Gráfico, la acción de datos Ver en tabla se agrega automáticamente al widget Gráfico. En el tiempo de ejecución, el usuario puede hacer clic en el botónAcciones del widget Gráfico y seleccionar Ver en tabla para mostrar los datos de estadísticas en el widget Tabla.
- Puede agregar un widget Lista para visualizar un registro de datos y un widget Mapa para mostrar un registro de datos diferente. Desea proporcionar al usuario una opción para mostrar una entidad en el mapa que se corresponda con un registro seleccionado en la lista para comparar datos diferentes en un mapa. En el tiempo de ejecución, el usuario puede hacer clic en el botónAcciones del widget Lista y seleccionar Mostrar en el mapa.
- Muestra los registros de datos en un widget Tabla y desea que los usuarios tengan la opción de exportar los datos. Con Permitir exportación habilitada para la fuente de datos, pueden hacer clic en el botón Acciones del widget Tabla y elegir exportar los registros seleccionados o todos los registros.