Seleccionar datos

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 consumen los mismos datos se pueden conectar en una 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 una 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 una aplicación

Al agregar datos a una aplicación, puede seleccionar mapas web, escenas web y capas que se han almacenado como elementos de contenido en ArcGIS, incluido lo siguiente:

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 una 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 las siguientes 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, 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 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 por uno más pertinente para la 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: se enumeran 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: se enumeran los 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 subcapa), 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 opción Actualizar automáticamente está desactivada, los datos se actualizan solo cuando actualice la aplicación o el builder. Active Actualizar automáticamente para actualizar los datos y obtener las entidades más recientes en función de un intervalo de tiempo especificado. Puede establecer un intervalo de tiempo personalizado o, si los datos proceden de un mapa web, puede utilizar la configuración de la capa.
    • Permitir exportación: ofrezca opciones para que los usuarios exporten datos en tiempo de ejecución desde widgets conectados para los que están habilitadas acciones de datos.
      Nota:

      En el caso de las capas de entidades alojadas, la aplicación verifica que el rol del usuario y la configuración del elemento permiten la exportación de los 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 de 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 seleccionan automáticamente).
    • Pestaña Campos: se enumeran los campos utilizados por los widgets.
    • Pestaña Widgets: se enumeran los widgets que utilizan la capa en su configuración.

Usar datos

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. El procesamiento de datos en el widget Mapa no afecta a los widgets que utilicen la misma fuente de datos o sus capas contenidas; no obstante, el widget 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.

WidgetsTipo 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

Editar

Capa de entidades, capa de escena (las capas deben ser editables)

1 o varios

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 del mapa

Mapa web, escena web

0 o 1

Consulta

Capa de entidades, capa de escenas

1 para cada consulta

Buscar

Capa de entidades, capa de escenas

1 para cada origen de capa

Tabla

Capa de entidades, capa de escenas

1 para cada hoja

Texto**

Capa de entidades, capa de escenas

0 o más

Línea temporal***

Mapa web, capa de entidades, capa de servicio de mapas

1 o varios

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

***El widget Línea temporal admite varias capas de entidades o capas de servicios de mapas, aunque solo un mapa web a la vez.

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 origenTipo de datos de salidaDatasets de salida

Gráfico

Capa de entidades

Estadística de gráfico

Indicaciones

Capa de entidades

1 para cada parada, punto de dirección, línea de dirección y ruta

Perfil de elevación

Capa de entidades

1 por cada perfil

Consulta

Capa de entidades

1 para cada consulta

Buscar

Capa de entidades

1 para cada origen del localizador

Trazado de red de servicios

Capa de entidades

1 capa que contiene polígonos de área de resultados

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 afectan a la fuente de datos original.

Nota:

Si elimina un widget con datos de salida que están siendo utilizados por otro widget, aparece un mensaje de advertencia con una lista de los widgets relacionados. Puede eliminar los widgets relacionados o mantenerlos para volver a configurarlos 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.
  • Buscar: la dirección para el resultado de búsqueda del origen del localizador correspondiente

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 del número de fuentes de datos que admite el widget. Una fuente de datos tiene las siguientes opciones de vista:

  • Predeterminada: una vista integrada que contiene todas las entidades de los datos.
  • Entidades seleccionadas: 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. También puede crear una vista para una selección vacía en el panel Datos.
  • Rellenado automáticamente: 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.
  • Vista de datos: 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 afecta 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, se envían 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 o 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 que puede utilizar para 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 el widget Lista. Esta vista solo contiene una entidad que representa el elemento de lista.

Si la vista 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 pueden ser el valor máximo, mínimo, medio o de suma de un campo numérico, el valor máximo o mínimo de un campo de fecha, el recuento de entidades del conjunto de entidades (utilizando el campo de Id. único) o, si el servicio admite un recuento distinto, el número de valores únicos de un campo.

Utilice el editor de estadísticas para proporcionar etiquetas personalizadas de estadísticas. Para definir una etiqueta, sustituya el texto del marcador de posición, que actúa como la etiqueta predeterminada, y cámbielo en función del operador y campo que especifique.

Expresión

Utilice el editor de expresiones para introducir texto (formato: “text”), números, variables de campo (formato: {fieldname}) y funciones que incluyen AVERAGE({fieldname}), COUNT({fieldname}), 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, aparecen 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 permiten definir 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 o una variable de campo de fecha dentro de una función —por ejemplo, AVERAGE({fieldname})—, la función devuelve el resultado estadístico de la vista de datos para ese campo. En el caso de los campos de fecha, el constructor de expresiones solo admite las funciones COUNT, MAX y MIN.

Puede dar formato a los números de la expresión haciendo clic en el botón Formato de números Formato de números y activando Formato de números. Puede elegir el número de posiciones decimales que se van a mostrar, incluir un separador de miles y agregar una unidad de los datos.