Los datos son el núcleo de la mayoría de aplicaciones que crea con Experience Builder. Muchos widgets están basados en datos y el builder proporciona una administración de datos unificada. Los widgets que utilizan los mismos datos se pueden conectar en su aplicación. Por ejemplo, puede sincronizar selecciones de registros en varios widgets y aplicar el mismo filtro por los widgets que están conectados a los mismos datos.
Cuando agrega datos a una aplicación en Experience Builder, son una instancia específica de una conexión de fuente de datos. Estas son algunas de las ventajas:
- Las actualizaciones realizadas a la fuente de datos original se sincronizan en las aplicaciones que crea.
- Puede agregar la misma fuente de datos varias veces. Las conexiones pasan a ser datos independientes en Experience Builder. La mayor parte del procesamiento de datos no influye en otros procesamientos de datos (como el filtrado y la ordenación), con la excepción de las actualizaciones realizadas a la fuente de datos original (como la edición de entidades y la actualización de atributos).
Administrar datos
Todos los datos que agrega a la aplicación se enumeran en el panel Datos del espacio de trabajo del builder. Puede administrar los datos de la aplicación aquí y revisar la información relacionada, por ejemplo, cuántos widgets y cuáles están conectados a los datos y a qué campos, si corresponde. Utilice el cuadro Buscar para filtrar la lista y ayudarle a encontrar una fuente de datos concreta. Entre los resultados de la búsqueda están las subcapas para los mapas y escenas web que haya agregado a la aplicación.
Agregar datos a la aplicación
Al agregar datos a su aplicación, puede seleccionar mapas web, escenas web y capas que se han almacenado como elementos de contenido en ArcGIS, incluido lo siguiente.
- Capas de entidades alojadas
- Capas de escena de punto y objeto 3D que admiten consultas
- Servicios de entidades, escenas y mapas
- Conjuntos de entidades (excluidas notas de mapa y capas de ruta)
Puede examinar y buscar estas fuentes de datos en su contenido, sus grupos, su organización y contenido que se haya compartido públicamente, lo que incluye ArcGIS Living Atlas of the World. Las capas de las direcciones URL de servicio de entidades, escenas o mapas también son compatibles. Además, si agrega mapas web y escenas web a su aplicación, puede utilizar sus capas compatibles como fuente de datos para los widgets.
Nota:
- Cuando agrega un mapa web o una escena web como una fuente de datos, los widgets pueden conectarse a sus capas compatibles, como tablets, capas de imágenes de mapa, capas de teselas y capas de grupo. Los tipos de capas incompatibles no están disponibles en la configuración de widgets y no aparecen en la pestaña de detalles del panel Datos.
- Los mapas web y escenas web creados con JSAPI 3.x que no se pueden abrir en Map Viewer Classic ni Scene Viewer no se pueden utilizar como fuentes de datos. (Si agrega uno de estos elementos, no se podrá seleccionar y aparece en el panel Datos como una tarjeta de error).
Puede agregar datos a una aplicación de dos maneras:
- Antes de agregar cualquier widget, haga clic en el botón Agregar datos del panel Datos para agregar los datos que se utilizarán en la aplicación. Se enumeran todos los tipos de datos compatibles con Experience Builder en la ventana Agregar datos.
- Si no agrega los datos antes de agregar los widgets, también puede agregar los datos al configurar un widget haciendo clic en Agregar datos en la parte inferior del panel Seleccionar datos. Solo se pueden agregar los tipos de datos compatibles con el widget. Los datos que agrega al configurar un widget también aparecen en el panel Datos y se pueden seleccionar al configurar otros widgets.
Nota:
Puede elegir ocultar algunas subcapas de un servicio, una capa de grupo o un mapa web o escena web al agregar datos. También puede ocultarlas en el panel de detalles del servicio, grupo, mapa web o escena web. Las capas ocultas no estarán disponibles en la lista de datos seleccionados cuando configure widgets. Solo puede ocultar las capas que todavía no se utilicen.
Eliminar datos
Puede eliminar una fuente de datos con la opción Eliminar de las tarjetas de elementos del panel Datos. Los datos contenidos en la fuente de datos también se eliminarán. Cuando elimina los datos aquí, ya no están disponibles para la configuración del widget. Si elimina datos ya utilizados por widgets, la aplicación ya no mostrará información de dichos datos y todos los widgets conectados a esos datos se verán afectados. Puede eliminar los widgets afectados cuando elimine los datos, o puede reconfigurar los ajustes del widget conectando otros datos posteriormente.
Detalles de datos y vistas de datos
El panel Datos muestra las tarjetas de elementos con los nombres de elementos de los datos que agrega a la aplicación. Las etiquetas con iconos ayudan a diferenciar entre tipos de datos. Puede ver más datos haciendo clic en el vínculo para abrir la página del elemento de la fuente de datos original. Puede cambiar el nombre que aparece en las tarjetas de elementos a uno más relevante para su aplicación (los datos de origen se mantienen sin cambios). Cada tarjeta indica el número de widgets y capas relacionados de un mapa o escena. Al hacer clic en una tarjeta de datos se abre un panel con más detalles de los datos.
- Para mapas web, escenas web, servicios y capas de grupo, puede ver los siguientes detalles:
- Pestaña Capas: capas que contiene la fuente de datos. Las capas se dividen en dos grupos: En uso muestra las capas seleccionadas en la configuración de widgets, y Otros muestra las capas que todavía no están conectadas a un widget. Puede ocultar una capa no utilizada para que no aparezca en la lista de datos seleccionados al configurar un widget. Haga clic en la tarjeta de capa para abrir un panel de detalles.
- Pestaña Widgets: widgets que utilizan directamente el mapa, la escena, el servicio o la capa de grupo al completo. Los widgets que solo utilizan capas especificadas bajo los datos no se enumeran aquí; en su lugar, se enumeran bajo la capa correspondiente.
- Para las capas individuales (incluidas las capas sin subcapas), dispone de las siguientes opciones de configuración y detalles:
- Configuración de datos: defina filtros, campos de ordenación y limitaciones de registro para los datos. La configuración del filtro aquí afecta a todas sus vistas de datos.
- Configuración de actualización: si la actualización automática está desactivada, los datos se actualizarán solo cuando actualice la aplicación o el builder. Active la actualización automática para permitir actualizar los datos y obtener las entidades más recientes en función de un intervalo de tiempo determinado. Puede establecer un intervalo de tiempo personalizado o, si los datos proceden de un mapa web, puede optar por respetar la configuración de la capa.
- Permitir exportación: ofrece opciones para que los usuarios exporten datos en tiempo de ejecución desde widgets conectados para los que están habilitadas acciones de datos. (La exportación se limita a 5.000 registros).
Nota:
En el caso de las capas de entidades alojadas, la aplicación también verificará que el rol del usuario final y la configuración del elemento permitan la exportación de datos.
- Pestaña Vistas de datos: cree vistas de datos de capas de escena y capas de entidades admitidas agregando filtros, campos de ordenación y limitaciones de registros para controlar lo que aparece en los widgets conectados. Esta configuración solo tiene efecto dentro de la vista y no afectará a otras vistas de datos o a los datos de origen.
Nota:
Cada capa también tiene vistas integradas que puede seleccionar al configurar fuentes de datos para el widget. La vista Predeterminada contiene todas las entidades. La vista Entidades seleccionadas contiene entidades seleccionadas en tiempo de ejecución. La vista Rellenada automáticamente se utiliza para la configuración de contenido dinámico con widgets Lista.
- Ver selección vacía: active este cuadro y haga clic en su botón Configuración para configurar una vista que se muestre cuando no hay entidades seleccionadas en la vista Entidades seleccionadas. (Las entidades de esta vista configurada no se seleccionarán automáticamente).
- Pestaña Campos: los campos utilizados por los widgets.
- Pestaña Widgets: los widgets que utilizan la capa en su configuración.
Usar datos
Todos los datos que agregue a una aplicación, independientemente de cómo los agregue, están disponibles para todos los widgets compatibles en esa aplicación. El resto de widgets pueden utilizar una fuente de datos usada por un widget. La selección de registros se sincroniza en toda la aplicación. Además, filtra la vista de datos predeterminada afecta a todos los widgets que usan los datos o sus vistas. Los filtros de una vista de datos específica solo afectan a los widgets que utilizan la misma vista de datos.
Nota:
Al visualizar un mapa web o una escena web en un widget Mapa, se crea automáticamente una nueva vista de mapa web o escena web y esta vista solo se utiliza en el widget actual. Por lo tanto, el procesamiento de datos dentro del widget Mapa no afectará a los widgets que utilicen la misma fuente de datos o sus capas contenidas. No obstante, el Mapa se ve afectado por el procesamiento de datos en la vista predeterminada.
El panel de configuración de cada widget contiene un ajuste estándar para conectarse a datos. Al hacer clic en Seleccionar datos, aparece un panel que enumera los datos agregados y los datos de salida de la aplicación compatibles con los widgets (excepto los datos ocultos). Puede seleccionar datos de la lista o agregar más datos a la aplicación. Utilice el cuadro Buscar para filtrar la lista de opciones. Entre los resultados de la búsqueda están las subcapas para los mapas y escenas web que haya agregado a la aplicación. Algunos widgets admiten múltiples fuentes de datos, por lo que puede seleccionar más de un elemento de la lista. Si un widget solo se puede conectar a una fuente de datos, haga clic en la tarjeta de datos existente para abrir el panel Seleccionar datos en el que puede borrar la selección y seleccionar otro elemento.
La siguiente tabla enumera los widgets que se pueden conectar a los datos y los tipos de datos compatibles con cada uno.
| Widgets | Tipo de datos admitido* | Cantidad de datos admitidos |
|---|---|---|
Administración de versiones en rama | Servicio de entidades, servicio de mapas (deben estar registrados como versionados) | 1 o varios |
Botón** | Capa de entidades, capa de escenas | 0 o 1 |
Gráfico | Capa de entidades, capa de escenas | 1 |
Integrar** | Capa de entidades, capa de escenas | 0 o 1 |
Información de entidad | Capa de entidades, capa de escenas | 1 |
Filtro | Capa de entidades, capa de escenas | 1 para cada filtro |
Imagen** | Capa de entidades, capa de escenas | 0 o 1 |
Lista | Capa de entidades, capa de escenas | 1 |
Mapa | Mapa web, escena web | 1 o 2 |
Capas de mapa | Mapa web, escena web | 0 o 1 |
Consulta | Capa de entidades, capa de escenas | 1 para cada consulta |
Tabla | Capa de entidades | 1 para cada hoja |
Texto** | Capa de entidades, capa de escenas | 0 o más |
*Para obtener una lista específica de los tipos de elementos admitidos, consulte Agregar datos a la aplicación.
**Los widgets Imagen, Texto, Botón e Integrar son estáticos por defecto. Para visualizar información de los datos, active el ajuste Conectar a los datos y especifique los parámetros con atributos, estadísticas o expresiones. Para obtener más información, consulte Contenido dinámico.
Datos de salida
Además de los datos que agrega manualmente a la aplicación, los siguientes widgets pueden procesar los datos originales y generar un nuevo dataset de salida con los resultados mostrados.
| Widget origen | Tipo de datos de salida | Número de datos de salida |
|---|---|---|
Gráfico | Capa de entidades | 1 |
Consulta | Capa de entidades | 1 para cada consulta |
Cuando estos widgets de origen se configuran en la aplicación, sus datos de salida aparecen en el panel Seleccionar datos al configurar otros widgets. La salida se crea como una nueva fuente de datos, de modo que los filtros y las selecciones en los datos de salida no afectarán a la fuente de datos original.
Nota:
Si elimina un widget cuyos datos de salida están siendo utilizados por otro widget, recibirá un mensaje de advertencia con una lista de los widgets relacionados. Puede seleccionar los widgets relacionados para eliminarlos también, o conservarlos para reconfigurarlos con otra fuente de datos más adelante.
El esquema de los datos de salida viene definido por su widget de origen. Los datos de salida de un widget Gráfico son una estadística con atributos del campo de categoría (si se configura) y los resultados del cálculo de los campos numéricos; no contienen geometría. Los datos de salida de un widget Consulta son un subconjunto de registros que cumplen los criterios de la consulta, con los campos tal y como están configurados en su configuración de Resultados. El widget de origen genera dinámicamente los registros reales de los datos de salida en el tiempo de ejecución.
Vistas de fuentes de datos
Una vez que se seleccionan los datos en la configuración del widget, puede elegir una o varias vistas en la lista desplegable, en función de cuántas fuentes de datos admita el widget. Una fuente de datos tiene cuatro tipos de vistas:
- La Predeterminada es una vista integrada que contiene todas las entidades de los datos.
- Entidades seleccionadas es una vista integrada que contiene entidades seleccionadas por el usuario en tiempo de ejecución. El estado seleccionado de una entidad se sincroniza a través de todas las vistas. Esta vista se puede utilizar para mostrar un resultado de interacción. Por ejemplo, si está configurada para un widget Lista, la lista solo muestra los registros seleccionados y los elementos de la lista cambian dinámicamente a medida que cambia la selección. Si no hay ninguna selección, en la lista se muestra el mensaje No hay datos hasta que se seleccionen los registros. O puede crear una vista para una selección vacía en el panel Datos.
- Rellenado automáticamente es una vista integrada que está disponible en la configuración de contenido dinámico si se agrega un widget a un widget Lista y se conecta a la misma vista de datos. Esta vista solo contiene una entidad que la lista genera para cada elemento en ella.
- La Vista de datos es un subconjunto de entidades que puede crear con distintos filtros, campos de ordenación y limitaciones de registros. Puede preprocesar una fuente de datos con varias vistas de datos para controlar los datos que aparecen en un widget sin afectar a otras vistas de datos ni a los datos de origen.
Nota:
Los Datos de salida no permiten agregar vistas de datos personalizadas.
Nota:
El ajuste Tamaño de página de la pestaña Registros se utiliza para cuestiones de rendimiento y eficiencia de las consultas. No afectará al número total de entidades de resultados en los widgets que admiten la paginación. Si el tamaño de la página es menor que el resultado real, se enviarán múltiples peticiones hasta que se carguen todos los resultados.
La vista Predeterminada se selecciona de forma predeterminada. También puede editar una vista existente u optar por crear otra vista para el widget. Las vistas creadas a partir de un panel de configuración de widgets también están disponibles para seleccionarlas en otras configuraciones de widgets.
Contenido dinámico
Varios widgets tienen ajustes para los que puede utilizar o visualizar información dinámica de una fuente de datos conectada. Los ejemplos incluyen un valor de atributo de una entidad especificada, un resultado estadístico de entidades que cumplen ciertas condiciones o una expresión combinada con cadenas estáticas, valores dinámicos y cómputos.
Atributo
Obtenga el valor de atributo de una entidad en la vista de datos especificada utilizando una de las siguientes vistas:
- Las vistas que establezca en la configuración de la fuente de datos del widget.
- La vista Entidades seleccionadas de la capa de datos original. Esta vista le permite mostrar los resultados de la interacción, como la visualización de los atributos de las entidades seleccionadas.
- La vista Rellenada automáticamente si el widget está dentro de un widget Lista (como texto, imagen o botón) y tiene la misma vista de datos que la Lista. Esta vista solo contiene una entidad que representa el elemento de lista.
Si la vista que elige contiene varias entidades, se devuelve el valor de atributo de la primera entidad (según la configuración de ordenación de la vista de datos).
Estadísticas
Obtenga los resultados estadísticos del conjunto de entidades definido por la vista de datos especificada.
Los resultados podrían ser el valor máximo, mínimo, promedio o de suma de un campo numérico o el recuento de entidades del conjunto de entidades.
Expresión
El editor de expresiones le permite introducir texto (formato: "texto"), números, variables de campo (formato: {fieldname}) y funciones como AVERAGE({fieldname}), COUNT, SUM({fieldname}), MAX({fieldname}) y MIN({fieldname}). Cada parte se concatena con un signo más (+). La expresión devuelve el resultado de la concatenación de cadenas de caracteres y el cálculo de números. Por ejemplo, si introduce 1+1, devuelve 2(número), pero si introduce 1 + “1”, devuelve “11”(cadena).
A medida que escribe, se ofrecen sugerencias en las que puede hacer clic para insertarlas. También puede insertar una variable de campo o una función haciendo clic en los nombres de campo o los nombres de función enumerados bajo el cuadro de entrada.
Los datos de la pestaña Campos le permiten establecer qué vista de datos representa la variable de campo. Si se agrega una variable de campo como parte independiente en la expresión, el valor de atributo de ese campo se devuelve desde la primera entidad de la vista de datos especificada.
Si se utiliza una variable de campo numérico dentro de una función; por ejemplo, AVG({fieldname), la función devuelve el resultado estadístico de la vista de datos para ese campo.