Experience Builder le permite agregar parámetros de URL a sus aplicaciones. Puede utilizar parámetros de URL para mejorar una experiencia haciendo que la URL establezca una configuración regional, dirija a una página específica, active la vista previa de impresión, etc.
Los parámetros se agregan al final de la URL y se formatean como par de clave-valor conectado con un signo igual. Las aplicaciones de Experience Builder admiten parámetros que sean cadenas de caracteres de consulta, es decir, que comiencen con un signo de interrogación. Para incluir varios parámetros, debe separarlos con símbolos et (&). Las URL de experiencias con parámetros utilizan la siguiente estructura: https://<domain>/experience/<AppID>/[?<param1=value>&<param2=value>&...]
A continuación, encontrará un ejemplo:https://experience.arcgis.com/experience/<AppId>/
La URL de una experiencia puede incluir uno o varios de los parámetros que se enumeran a continuación.
Parámetros generales
A continuación, se muestra una lista de parámetros de URL generales.
Cambiar la configuración regional
Para cambiar el idioma de la aplicación, utilice el parámetro locale y un código de idioma de ISO 639-1 de dos letras. Experience Builder admite los mismos idiomas que admite ArcGIS Enterprise, lo cual incluye los siguientes códigos de idioma: ar, bg, bs, ca, cs, da, de-at, de-de, de-ch, el, en-au, en-ca, en-gb, en-us, es-es, es-mx, et, fi, fr-fr, fr-ch, he, hr, hu, id, it-it, it-ch, ja, ko, lt, lv, nb, nl, pl, pt-br, pt-pt, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-cn, zh-hk, and zh-tw.
Para utilizar una aplicación de Experience Builder en francés y francés de Suiza, puede incorporar locale=fr a la URL, como en los siguientes ejemplos:https://experience.arcgis.com/experience/<AppId>/?locale=frhttps://experience.arcgis.com/experience/<AppId>/?locale=fr-ch
Nota:
Si solo asigna un idioma sin una configuración regional detallada, como fr en lugar de fr-ch o fr-fr, no se garantiza que obtenga un formato de número o fecha esperado. Esto se debe a que diferentes configuraciones regionales que hablan el mismo idioma a veces tienen diferentes notaciones para fechas y números, como Estados Unidos (en-us) frente al Reino Unido (en-gb).
Ir a una página
Para dirigir a una página específica, utilice page seguido del nombre de la página. En aplicaciones de ArcGIS Online Experience Builder, el parámetro de página no forma parte de una cadena de caracteres de consulta y no va después de un signo de interrogación. Se agrega a la ruta de la URL, como en los siguientes ejemplos:https://experience.arcgis.com/experience/<AppId>/page/Page-4https://experience.arcgis.com/experience/<AppId>/page/{xxxHome}/
Ir a una vista
Para dirigir a una vista de sección activa específica, utilice views seguido de una etiqueta de vista, como v1 o View 1.
https://experience.arcgis.com/experience/<AppId>/?views=View-2https://experience.arcgis.com/experience/<AppId>/?views=v1Abrir una ventana
Para dirigir a una ventana activa específica, utilice dlg seguido de un Id. o etiqueta de ventana.https://experience.arcgis.com/experience/<AppId>/?dlg=Window-1
Controlar el enfoque en ventana
Si desea incrustar una aplicación de Experience Builder con ventanas de presentación, ventanas de página o ventanas fijas y no desea que la aplicación salte o se desplace automáticamente a esas ventanas, puede usar el parámetro disable_window_focus para controlar ese comportamiento. Agregue la siguiente URL a la página web del host para deshabilitar el comportamiento de salto. De forma predeterminada, el valor de disable_window_focus es false.https://experience.arcgis.com/experience/<AppId>/?disable_window_focus=true
Ver el modo borrador
Siempre que previsualice una aplicación, el parámetro draft se agrega automáticamente. Este le permite obtener recursos de elementos para aplicaciones no publicadas.https://experience.arcgis.com/experience/<AppId>/?draft=truehttps://experience.arcgis.com/experience/<AppId>/?draft=1
Abrir la vista previa de impresión
Para activar el modo de vista previa de impresión, utilice print_preview.https://experience.arcgis.com/experience/<AppId>/?print_preview=truehttps://experience.arcgis.com/experience/<AppId>/?print_preview=1
Parámetros relacionados con datos
A continuación, se muestra una lista de parámetros de URL relacionados con datos.
Proporcionar un Id. de fuente de datos
Cada fuente de datos de una aplicación tiene su propio Id. de fuente de datos. Cuando selecciona un registro de datos, el Id. de la fuente de datos se agrega a la URL de la aplicación, como en los siguientes ejemplos:https://experience.arcgis.com/experience/<AppId>/?data_id=<dsID>:<selectedrecordID>https://experience.arcgis.com/experience/<AppId>/?data_id=dataSource_1-csv_966%3A0
Puede usar este método para buscar el Id. de fuente de datos específico de una capa. Por ejemplo, puede agregar un widget Lista y conectarlo a una capa, obtener una vista previa de la aplicación y seleccionar cualquier registro de la lista. La URL se rellena de forma similar al siguiente ejemplo:https://experience.arcgis.com/experience/<AppId>/?data_id=dataSource_2-Shelters_966%3Axxxxxx
El valor posterior a ?data_id= y anterior a :<selectedrecordID> (o %3A<selectedrecordID>) es el Id. de la fuente de datos de la capa. Conociendo el Id., puede usarlo con otros parámetros para filtrar la fuente de datos o cambiar las versiones.
Filtrar fuentes de datos
Para filtrar directamente una fuente de datos, utilice data_filter. El formato de filtro es una sintaxis estándar de cláusula WHERE que no puede contener "," ni ":". Para filtrar varias fuentes de datos, utilice el formato [<dsId:filter>,<dsId:filter>].https://experience.arcgis.com/experience/<AppId>/?data_filter=dataSource_1:st=’HI’
La URL anterior es igual a la siguiente URL codificada:https://experience.arcgis.com/experience/<AppId>/?data_filter=dataSource_1:st=%27HI%27
A continuación, se muestra otra URL de ejemplo con este parámetro:https://experience.arcgis.com/experience/<AppId>/?data_filter=ds1:objectid=1,ds2:fielda>2
Cambiar la versión de GDB de una fuente de datos
Para cambiar la versión de GDB de una fuente de datos, utilice data_version.https://experience.arcgis.com/experience/<AppId>/?data_version=<dsId:version>,<dsId:version>https://experience.arcgis.com/experience/<AppId>/?data_version=dsId1:v1, dsID2:v1
Parámetros relacionados con el inicio de sesión
A continuación, se muestra una lista de parámetros de URL relacionados con el inicio de sesión.
Compartir la autenticación mediante un widget Integrar
Algunas aplicaciones web solicitan a los usuarios que inicien sesión con una cuenta de ArcGIS. Una aplicación puede requerir a los usuarios que inicien sesión debido a su configuración de uso compartido, porque la aplicación incluye widgets que utilizan contenido Premium o por otros motivos.
Si desea integrar una aplicación web de ArcGIS en su aplicación de Experience Builder y ambas requieren que los usuarios inicien sesión, puede agregar los parámetros de URL arcgis-auth-origin y arcgis-auth-portal para compartir la autenticación entre las dos aplicaciones de modo que los usuarios solo tengan que iniciar sesión una vez.
Para integrar una aplicación privada Experience Builder en otra aplicación Experience Builder, utilice ?arcgis-auth-origin= para definir la URL del dominio de la aplicación host para la autenticación. A continuación, encontrará un ejemplo:https://<orgdomain>/experience/<AppID>/?arcgis-auth-origin=<your host app domain, such as https://localhost:3001>
Para integrar una aplicación basada en API JavaScript como, por ejemplo, una aplicación Web AppBuilder, utilice ?arcgis-auth-origin= para la autenticación del dominio de la aplicación host y ?arcgis-auth-portal= para la autenticación de dominio de la aplicación basada en la API JavaScript. A continuación, se muestran algunos ejemplos:https://<orgdomain>/apps/webappviewer/index.html?id=<appID>&arcgis-auth-origin=<your host app domain, such as https://localhost:3001>&arcgis-auth-portal=<orgA URL>https://www.arcgis.com/apps/opsdashboard/index.html#/<appID>?arcgis-auth-origin=https://experience.arcgis.com&arcgis-auth-portal=https://<myorg>.maps.arcgis.com