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 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 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 cinco desencadenadores que se admiten actualmente:

DesencadenadorDescripció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 origenDatos agregadosCambios de filtrado de datosCambios de extensiónCambios de selección de registrosRegistros creados

Agregar datos

Sí

Gráfico

Sí

Información de entidad

Sí

Filtro

Sí

Lista

Sí

Mapa

Sí

Sí

Consulta

Sí

Sí

Buscar

Sí

Sí

Sí

Tabla

Sí

Trazado de red de servicios

Sí

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.

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.

ObjetivoAcción1Desencadenador: datos agregadosDesencadenador: cambios de filtrado de datosDesencadenador: 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.

Ejemplo: Posibles lugares para la construcción de viviendas en el Reino Unido

Sí

Sí

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

Ejemplo: Estados, condados y distritos censales de EE. UU.

Sí

Widget Business Analyst

Seleccionar entidad: marque la entidad como seleccionada.

Sí

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

Sí

Widget Mapa

Agregar al mapa: agregue datos al mapa o escena web como una capa.

Ejemplo: Visor de datos

Sí

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

Ejemplo: Observación de aves en Boston

Sí

Sí

Sí

Sí

Sí

Acercar a4: acérquese a una ubicación especificada.

Ejemplo: Portland 2D y 3D

Sí

Sí

Sí

Sí

Sí

Destacar: destaque una entidad en el mapa.

Ejemplo: Explorar Nueva Inglaterra

Sí

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.

Sí

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

Ejemplo: ArcGIS World Geocoding Service

Sí

Widget Cerca de mí

Establecer ubicación: defina la ubicación de búsqueda y busque entidades cercanas.

Sí

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

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

La siguiente tabla enumera los widgets de origen disponibles, los destinos y las acciones de datos admitidas (destino: acción de datos):

Widget origenMarco: ExportarMarco: Definir filtroIndicaciones: Indicaciones desdeIndicaciones: Indicaciones hastaPerfil de elevación: Ver perfil de elevaciónMapa: Desplazar aMapa: Mostrar en el mapa1Mapa: Acercar aMapa: Agregar a mapa2Cerca de mí: establecer ubicaciónTabla: Ver en tabla3

Análisis

Sí

Sí

Sí

Sí

Agregar datos

Sí

Sí

Sí

Sí

Sí

Sí

Gráfico

Sí

Sí

Información de entidad

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Lista

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Mapa

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Capas del mapa

Sí

Sí

Cerca de mí

Sí

Consulta

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Tabla

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

Sí

1Cuando agrega una acción Mostrar en el mapa, puede personalizar los símbolos de los registros creados.

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

3Puede 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 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 borra todos los resultados de las acciones de datos).

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 siguiente tabla enumera widgets y sus niveles admitidos de acciones de datos:

Widget origenNivel de fuente de datosNivel de registro

Todos los registros

Registros seleccionados

Registros cargados

Registro actual

Agregar datos

Sí

Gráfico

Sí

Sí

Información de entidad

Sí

Sí

Lista

Sí

Sí

Mapa

Sí

Capas del mapa

Sí

Cerca de mí

Sí

Consulta

Sí

Sí

Sí

Tabla

Sí

Sí

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

ObjetivoAcciónNivel de fuente de datosNivel de registro

Perfil de elevación

Ver perfil de elevación

Sí

Indicaciones

Indicaciones desde

Sí

Indicaciones hasta

Sí

Marco

Exportar

Sí

Sí

Definir filtro

Sí

Mapa

Zoom a

Sí

Sí

Desplazar panorámicamente a

Sí

Sí

Mostrar en el mapa

Sí

Agregar al mapa

Sí

Cerca de mí

Definir ubicación

Sí

Tabla

Ver en tabla

Sí

Sí

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