Agregar acciones a widgets

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 finales 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, debería definir el cambio de extensión en el widget Mapa como desencadenador y filtrar registros de la vista de datos utilizada por Lista como una acción. Como los widgets están basados en datos, la acción de filtro se aplica en los niveles de marco y de datos 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 sí mismo. 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 el cambio de extensión de un widget Mapa como desencadenador y el cambio de 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, algunas acciones agregadas a él se ejecutan como respuesta. La siguiente tabla describe los dos desencadenadores que se admiten actualmente:

DesencadenadorDescripción

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.

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 de origenCambios de extensiónCambios de selección de registrosRegistros creados

Gráfico

Sí

Información de entidad

Sí

Lista

Sí

Mapa

Sí

Sí

Consulta

Sí

Sí

Tabla

Sí

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:

ObjetivoAcción*Desencadenador: cambios de selección de registrosDesencadenador: cambios de extensiónDesencadenador: 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.

Sí

Sí

Seleccionar registros de datos**: marque los registros como seleccionados y colóquelos en la vista Entidades seleccionadas.

Sí

Widget de mapa

Desplazar panorámicamente a: mantenga la escala actual y centro en una ubicación especificada.

Sí

Sí

Sí

Acercar: acercar a una ubicación especificada.

Sí

Sí

Sí

Destacar: destaque una entidad en el mapa.

Sí

Filtrar: mantenga solo las entidades que cumplan las condiciones de visualización en el widget Mapa.

Sí

Mostrar en el mapa: muestre los registros creados en el mapa como una nueva capa.

Sí

*Para 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).

**El 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.

Acciones de datos

Puede configurar acciones de datos para que los usuarios finales 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).

Las 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 finales elijan

El dataset transmitido al destino varía en función del widget de origen. Por ejemplo, el widget Lista solo puede transmitir registros seleccionados al widget Tabla, y 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 de origenMarco: ExportarMapa: Acercar aMapa: Desplazar aMapa: Mostrar en el mapaTabla: Ver en tabla

Gráfico

Todos los registros (datos estadísticos)

N/A

N/A

N/A

Todos los registros (datos estadísticos)

Información de entidad

Selección

Selección

Selección

Selección

Selección

Lista

Todos los registros o los registros seleccionados

Selección

Selección

Selección

Selección

Consulta

Todos los registros (resultado de la consulta)

Todos los registros (resultado de la consulta)

Todos los registros (resultado de la consulta)

Todos los registros (resultado de la consulta)

Todos los registros (resultado de la consulta)

Tabla

Todos los registros o los registros seleccionados

Selección

Selección

Selección

N/A

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 final 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).

  1. En el panel Acción, en la pestaña Acción de mensaje, haga clic en Agregar un desencadenador.
  2. 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.

  3. Para agregar varias acciones al mismo desencadenador, haga clic en Agregar acción.

    Las acciones para el mismo desencadenador se producen en orden secuencial.

  4. Arrastre las acciones agrupadas bajo un desencadenador para cambiar el orden.
  5. Para modificar estos ajustes configurados más adelante, haga clic en el botón Configuración Configuración de la acción.
  6. 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.

  1. 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.
  2. 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.

  3. 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 final 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 final puede hacer clic en el botón Acciones 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 final 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 final puede hacer clic en el botón Acciones del widget Lista y seleccionar Mostrar en el mapa.
  • Muestra los registros de datos en un widget Tabla y desea que los usuarios finales 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 (hasta 5.000).