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 responden 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 o como un elemento de ArcGIS.

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 demás widgets (como widget Lista) se filtren y visualicen solo las entidades dentro de la extensión actual. Para ello, defina Cambios de extensión en el widget Mapa como desencadenador y establezca Filtrar registros de datos en la vista de datos utilizada por el widget 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 siete desencadenadores que se admiten actualmente:

Desencadenador	Descripción
Clic en botón	El desencadenador se ejecuta cuando se hace clic en un widget Botón o cuando se hace clic en un botón del widget Navegación por vistas.
Datos agregados	Se produce un desencadenador al agregar una fuente de datos con el widget Agregar datos.
Cambos de filtrado de datos^1	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.
Registros creados	Se produce un desencadenador cuando se cargan registros de resultados en el widget de origen.
Cambios de selección de registros	Se produce un desencadenador cuando se selecciona un registro o se borra un registro seleccionado.
Cambio de vistas	Se produce un desencadenador cuando se selecciona una vista con el widget Navegación por vistas.

¹La acción Cambios de filtrado de datos no admite campas de imágenes dinámicas.

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	Clic en botón	Datos agregados	Cambios de filtrado de datos	Cambios de extensión	Cambios de selección de registros	Registros creados	Cambio de vistas
Agregar datos
Botón
Gráfico
Información de entidad
Filtro
Lista
Mapa
Cerca de mí
Consulta
Buscar
Seleccionar
Tabla
Trazado de red de servicios
Navegación por vistas

Precaución:

La selección de un número elevado de entidades con el widget Gráfico o el widget Mapa puede sobrecargar el desencadenador Cambios de selección de registros y provocar que Experience Builder no realice la acción esperada.

Destinos

Los destinos realizan las acciones. Un destino puede ser un widget en el marco. Si utiliza el marco como el destino, la acción se realiza de forma general a través de todos los widgets y páginas pertinentes 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 responda el destino al 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.

Si desea establecer una relación de atributos entre un campo desencadenador y un campo de acción, los registros del campo desencadenador deben coincidir exactamente con los registros del campo de acción, incluidas las mayúsculas y minúsculas.

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:

Sugerencia:

Explore ejemplos de cada acción usando los vínculos de la columna Acción siguiente.

Objetivo	Acción^1	Desencadenador: clic en un botón	Desencadenador: datos agregados	Desencadenador: cambios de filtrado de datos	Desencadenador: cambios de selección de registros	Desencadenador: cambios de extensión	Desencadenador: registros creados	Desencadenador: cambio de vistas
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. Ejemplo: Posibles lugares para la construcción de viviendas en el Reino Unido
	Seleccionar registros de datos^2: marque los registros como seleccionados y colóquelos en la vista Entidades seleccionadas. Ejemplo: Estados, condados y distritos censales de EE. UU.
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. Ejemplo: pistas del Servicio de Parques Nacionales
Widget Mapa	Agregar al mapa: agregue datos al mapa o escena web como una capa. Ejemplo: Visor de datos
	Desplazar panorámicamente a^3: mantenga la escala actual y centro en una ubicación especificada. Ejemplo: Observación de aves en Boston
	Acercar a^4: acérquese a una ubicación especificada. Ejemplo: Portland 2D y 3D
	Destacar: destaque una entidad en el mapa. Ejemplo: Explorar Nueva Inglaterra
	Filtrar: mantenga solo las entidades que cumplan las condiciones de visualización en el widget Mapa. Ejemplo: Lugares de interés en Washington D. C.
	Mostrar en el mapa^5: muestre los registros creados en el mapa como una nueva capa. Ejemplo: ArcGIS Geocoding Service
Widget Cerca de mí	Establecer ubicación: defina la ubicación de búsqueda y busque entidades cercanas.
Widget Barra lateral	Abrir barra lateral: abre la barra lateral.
	Activar/Desactivar barra lateral: abra o cierre la barra lateral.
Widget Controlador de widget	Abrir widget: abre widgets del controlador.

¹Para acciones de marco, si los datos de acción son la vista predeterminada, la acción afecta 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 afecta a los widgets que utilicen esa vista. Para las acciones de widget, la acción solo se realiza en el widget de destino. (Por ejemplo, la acción de filtro de mapa solo filtra los registros del mapa y no afecta 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.

³Si 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.

⁴Cuando 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.

⁵Cuando 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.

Datos relacionados

Si una fuente de datos tiene datos relacionados, puede utilizar la relación de la capa para configurar una acción de mensaje. Los siguientes desencadenadores, objetivos y acciones admiten datos relacionados:

Desencadenador	Objetivo	Acciones
Cambios de selección de registros	Marco	Seleccionar registros de datos, Filtrar registros de datos
	Mapa	Filtrar, Destacar

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 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 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 especifiquen una acción

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.

En las dos tablas siguientes se enumeran los widgets de origen disponibles, los destinos y las acciones de datos admitidas (destino: acción de datos):

Widget origen	Marco: Exportar	Marco: Datos relacionados^1	Marco: Definir filtro	Marco: Estadísticas	Análisis: Configurar como entrada de análisis	Indicaciones: Indicaciones desde	Indicaciones: Indicaciones hasta
Análisis
Agregar datos
Gráfico
Información de entidad
Lista
Mapa
Capas del mapa
Cerca de mí
Consulta
Seleccionar
Tabla

Widget origen	Indicaciones: Planificar ruta	Perfil de elevación: Ver perfil de elevación	Mapa: Desplazar a	Mapa: Mostrar en mapa^2	Mapa: Acercar a	Mapa: Agregar a mapa^3	Cerca de mí: establecer ubicación	Tabla: Agregar a tabla	Tabla: Ver en tabla^4
Análisis
Agregar datos
Gráfico
Información de entidad
Lista
Mapa
Capas del mapa
Cerca de mí
Consulta
Seleccionar
Tabla

¹Los campos de Arcade no se muestran de la forma esperada con la acción Datos relacionados. Por el momento, Experience Builder no admite Arcade.

²Al agregar una acción Mostrar en mapa, puede personalizar los símbolos para los registros creados.

³No puede agregar la misma capa del widget Agregar datos a un mapa varias veces. Una vez que utilice la acción de datos Agregar a mapa con el widget Tabla o Agregar datos, desaparece como una opción para esa capa en ambos widgets. Si configura el widget Análisis para agregar capas de resultados al mapa automáticamente, Agregar a mapa no está disponible como una acción de datos para dichos resultados.

⁴Puede agregar muchos tipos de datos con el widget Agregar datos, aunque solo los tipos de datos compatibles con el widget Tabla (capas de entidades y capas de escenas con capas de entidades asociadas) pueden desencadenar la acción de datos Agregar a 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 borra todos los resultados de las acciones de datos).

Nota:

A partir de la versión de febrero de 2024, Experience Builder solo carga los campos necesarios para mejorar el rendimiento. Por ejemplo, si un widget está configurado para utilizar determinados campos de una fuente de datos, Experience Builder solo cargará esos campos. Por ello, es posible que los campos descargados no aparezcan cuando ejecute la acción de datos Estadística. Si desea ver las estadísticas de más campos, puede utilizar las acciones de datos Ver en tabla o Agregar a tabla para ver los datos en un widget Tabla en tiempo de ejecución, y utilizar la acción de datos Estadísticas del widget Tabla.

Niveles de acción de datos

Las acciones de datos pueden afectar a algunos o a todos los datos de un widget origen. Las acciones de datos que afectan a todos los registros de una fuente de datos completa se denominan acciones de nivel de fuente de datos. Las acciones de datos que solo afectan a registros seleccionados, registros cargados o al registro actual se denominan acciones de nivel de registro.

La tabla siguiente enumera los widgets de origen y los niveles de acciones de datos que admiten:

Widget origen	Nivel de fuente de datos	Nivel de registro
	Todos los registros	Registros seleccionados	Registros cargados	Registro actual
Agregar datos
Gráfico
Información de entidad
Lista
Mapa
Capas del mapa
Cerca de mí
Consulta
Seleccionar
Tabla

La siguiente tabla enumera todos los posibles destinos y sus niveles admitidos de acciones de datos:

Objetivo	Acción	Nivel de fuente de datos	Nivel de registro
Análisis	Configurar como entrada de análisis
Perfil de elevación	Ver perfil de elevación
Indicaciones	Indicaciones desde
	Indicaciones hasta
	Planificar ruta
Marco	Exportar
	Datos relacionados
	Definir filtro
	Estadísticas
Mapa	Zoom a
	Desplazar panorámicamente a
	Mostrar en el mapa
	Agregar al mapa
Cerca de mí	Definir ubicación
Tabla	Agregar a tabla
	Ver en tabla

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

Para configurar acciones de mensajes, siga estos pasos:

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

Para configurar acciones de datos, siga estos pasos:

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 acciones de mensajes para apoyar requisitos de diseño de la aplicación como por ejemplo en los siguientes escenarios:

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

Utilice acciones de datos para apoyar requisitos de diseño de la aplicación como por ejemplo en los siguientes escenarios:

• Desea agregar un widget Gráfico para representar un conjunto de datos numéricos o cualitativos como un gráfico y desea proporcionar 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.

  Sugerencia:

  Si el widget de destino, que en este ejemplo es el widget Tabla, se encuentra en un widget Controlador de widget, el widget objetivo se abre automáticamente en el Controlador de widget cuando el usuario activa la acción de datos.

• 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 exportar los registros seleccionados o todos los registros.