Agregar desencadenadores de acción 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.

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 las acciones en respuesta a los desencadenadores. Por ejemplo, puede crear una interacción que siempre que el widget Mapa cambie su extensión, los otros widgets como Lista se filtrarán y mostrarán solo las entidades dentro de la extensión actual, configurando el cambio de extensión en el widget Mapa como desencadenador y el registro de filtro en la vista de datos que Lista utiliza como acción. Como los widgets se basan en datos, la acción de filtro se aplica en el nivel de marco y datos para que todos los widgets que utilicen la misma vista de datos se sincronicen automáticamente. También puede definir interacciones entre widgets. Las acciones proporcionadas por un widget solo tendrán efecto dentro de sí mismas. Por ejemplo, puede sincronizar la extensión de dos widgets Mapa cuando los usuarios aplican 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.

Estructura de interacción

Las interacciones se definen y administran en el panel Acción del widget origen que proporciona los desencadenadores. Las interacciones tienen tres partes:

  • Desencadenadores del widget origen
  • Destinos que responden al desencadenador, incluyendo 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:

DesencadenadorDescription

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.

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

Mapa

Sí

Sí

Información de entidad

Sí

Lista

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ón

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í

Acercar: acercar a una ubicación especificada.

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í

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

Configurar y administrar interacciones

Configure interacciones en la pestaña Acción de los widgets origen (widgets que proporcionan desencadenadores). Agregue y seleccione el desencadenador, seleccione el destino y agregue y seleccione las acciones. Cada desencadenador solo puede agregarse una vez, aunque puede agregar varias acciones para el mismo desencadenador haciendo 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.

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. Una vez configurada, puede modificar los ajustes posteriormente haciendo clic en el botón Ajuste Configuración de la acción. Para cambiar una acción o 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.

Uso de ejemplo

Agregue desencadenadores 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 vista de datos configurada en Configuración de lista y configurar la acción con una relación espacial a la extensión.