Las aplicaciones creadas con Web AppBuilder se pueden modificar directamente con parámetros URL. La dirección URL siempre empieza por <your portal url>/apps/webappviewer/index.html? e incluye uno o más de los parámetros que se enumeran a continuación. Para incluir más de un parámetro, usa el símbolo “&” para separar los parámetros. Por ejemplo:
http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&webmap=9cf053ea602345ddae060010c470e615Precaución:
Actualmente, las aplicaciones 3D no admiten parámetros de dirección URL.
Codificar los parámetros de la consulta
Todos los parámetros de la consulta deben estar codificados. La codificación sustituye caracteres no válidos por %, seguido de su equivalente hexadecimal.
Por ejemplo, aquí puede verse un parámetro de URL no codificado:http://<your portal url>/apps/webappviewer/index.html?find=380 new york street, redlands, ca
He aquí el mismo parámetro codificado:http://<your portal url>/apps/webappviewer/index.html?find=380%20new%20york%20street,%20redlands,%20ca
La web tiene muchos sitios y herramientas gratuitos para generar direcciones URL codificadas. Por ejemplo, Albion Research Ltd. tiene la página URLEncode y URLDecode. Para facilitar la lectura, el resto de los ejemplos de este tema no están codificados.
Abrir aplicación guardada
Para abrir una aplicación guardada que se haya creado con Web AppBuilder, utiliza id= y el Id. exclusivo de la aplicación. Por ejemplo:
http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4dDefinir mapa web
Para definir el mapa web, utiliza webmap= y el Id. exclusivo del mapa web. Por ejemplo:
http://<your portal url>/apps/webappviewer/index.html?webmap=9cf053ea602345ddae060010c470e615Centrar el mapa
Para centrar el mapa en una ubicación particular, establece center= utilizando coordenadas geográficas (x,y) o coordenadas proyectadas (x,y,WKID).
Precaución:
Puedes usar la coma o el punto y coma como separadores. Utiliza el punto y coma si los números usan los dos puntos como decimales
Ejemplo de coordenadas geográficas:
http://<your portal url>/apps/webappviewer/index.html?center=34,-50Ejemplo de coordenadas proyectadas:
http://<your portal url>/apps/webappviewer/index.html?center=500000,5500000,102100Definir el nivel de escala
Para definir el nivel de escala del mapa, utiliza los parámetros center= y level=. El parámetro level acepta el Id. del nivel de la escala de caché que se incluye en el extremo REST del servicio de mapas. Por ejemplo:
http://<your portal url>/apps/webappviewer/index.html?center=20,45&level=4Definir escala
Para definir la escala del mapa, utiliza los parámetros center= y scale=. El parámetro scale acepta la escala de caché que se incluye en el extremo REST del servicio de mapas. Por ejemplo:
http://<your portal url>/apps/webappviewer/index.html?center=20,45&scale=4622324Definir extensión
Para definir la extensión del mapa, utiliza extent=. El parámetro extent acepta coordenadas geográficas (GCS) como MinX, MinY, MaxX, MaxY o coordenadas proyectadas (PCS) como valores MinX, MinY, MaxX, MaxY, WKID. Puedes usar la coma o el punto y coma como separadores. Usa el punto y coma si los números usan los dos puntos como decimales.
Ejemplo de coordenadas geográficas:
http://<your portal url>/apps/webappviewer/index.html?extent=-117.20,34.055,-117.19,34.06Ejemplo de coordenadas proyectadas:
http://<your portal url>/apps/webappviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113Buscar ubicación o entidad para abrir el mapa
Para buscar una ubicación o entidad utilizada para abrir el mapa, usa find=. El mapa se amplía automáticamente hasta la coincidencia más próxima y se añade un marcador de llamada al mapa. El parámetro find acepta direcciones de una sola línea, direcciones parciales (como por ejemplo solo la ciudad o el país), nombres de lugares, coordenadas de latitud-longitud y entidades en capas que permiten búsquedas (por ejemplo, 1916352001 como número de identificación de parcela (PIN)). Por ejemplo:
http://<your portal url>/apps/webappviewer/index.html?find=380 new york street, redlands, caPrecaución:
Todos los parámetros de la consulta deben estar codificados.
Añadir Punto
Para agregar un punto al mapa, utiliza marker=<x>,<y>. El punto se agrega al mapa en la ubicación x,y especificada. También puedes incluir las siguientes propiedades opcionales:
- <wkid>: referencia espacial de las coordenadas x,y agregadas al mapa. Si no incluyes un WKID, se utilizarán las coordenadas GCS.
- <título codificado>: título del elemento emergente del punto. Si no incluyes un título, la ventana emergente estará vacía.
- <dirección URL del icono codificada>: símbolo para el punto. Si no incluyes un símbolo, se utilizará un símbolo de marcador azul.
- <etiqueta codificada>: etiqueta situada junto al símbolo de punto.
Debes tener en cuenta lo siguiente:
- <x>,<y> son necesarios.
- Asegúrate de codificar los parámetros de título, icono y etiqueta.
- Debes agregar las propiedades en este orden: marcador=<x>,<y>,<wkid>,<título codificado>,<dirección URL del icono codificada>,<etiqueta codificada>.
- Puedes usar la coma o el punto y coma como separadores. Usa el punto y coma si los números usan los dos puntos como decimales.
- Utiliza valores vacíos. No utilices espacios. Por ejemplo, para especificar una etiqueta y ninguna de las demás propiedades opcionales, agrega la etiqueta como el sexto parámetro con valores vacíos para el resto (x;y;;;;etiqueta).
- Si deseas que el mapa se acerque (además de centrarse en el punto), incluye el parámetro level=.
Por ejemplo:
http://<your portal url>/apps/webappviewer/index.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7Consulta de entidad
Para consultar una entidad y acercarla, puedes utilizar una de las opciones siguientes:
- query=<layer name>,<field name>,<field value>
- query=<layer name>, <where clause>
- query=<layer id>,<field name>,<field value>
- query=<layer id>, <where clause>
Precaución:
Todos los parámetros de consulta distinguen mayúsculas de minúsculas y deben estar codificados.
Dado que el nombre de la capa se puede cambiar, te recomendamos encarecidamente que utilices el Id. de la capa en la consulta. Puedes recuperar el Id. de la capa del Id. del mapa web que se muestra abajo.http://<your portal url>/sharing/rest/content/items/32a83775654249dcae6b8f2eff5d4072/data/?f=pjson
Para una subcapa en un grupo de servicios de mapas, utiliza <layer id_sublayer id> como Id. de la capa.
Ejemplos:
http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_7501,STATE NAME,Californiahttp://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_7501,STATE NAME='California'http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_7501,POP2000,33871648http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_7501,POP2000=33871648Cambiar la configuración regional
Para cambiar el idioma de la aplicación, utiliza locale=<language code>. Se admiten los códigos de idioma siguientes: ar, cs, da, de, en, el, es, et, fi, fr, he, it, ja, ko, lt, lv, nb, nl, pl, pt-br, pt-pt, ro, ru, sv, th, tr, zh-cn, vi, zh-hk y zh-tw.
Por ejemplo:
http://<your portal url>/apps/webappviewer/index.html?locale=frAutenticar el usuario
Para autenticar automáticamente un usuario en una aplicación no pública, utiliza token=<token>. De esta forma, los usuarios no tendrán que introducir su nombre de usuario y contraseña. Por ejemplo:
http://<your portal url>/apps/webappviewer/index.html?token=utmVcabc_LNyEQ7OuuHD73em0MErLR_cudJTeSIdMFTnL0poF3shVBeng5ieWHyZn0kAA8nhUg7jseQxz3bi5crnFMMpldDiJLrtzmO3jEM-ZNVIUEh5_qMms-YgXUwGgFbeQlM9WaI3jwraUqwah0yCceBAxEkEIAEWvlBEDfVsYs3LZydORRcs2QIcdLasControlar cuándo se debe activar el diseño móvil
La aplicación admite dos estilos de diseño basados en el tamaño de la pantalla. Uno es para el escritorio y el otro para dispositivos móviles. Cuando la altura o la anchura de una pantalla es menor de 600 píxeles, el diseño móvil se aplica automáticamente. Sin embargo, esto puede provocar un comportamiento inesperado cuando la aplicación se integra en un sitio web. Por ejemplo, la ventana emergente del sitio web cambia al estilo de diseño móvil. Para controlar el estilo del diseño, usa mobileBreakPoint=<pixel number>. Por ejemplo, puedes seguir en el estilo de escritorio hasta que el tamaño de la pantalla sea inferior a 300 píxeles:
http://<your portal url>/apps/webappviewer/index.html?mobileBreakPoint=300