Usar parámetros URL

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, use el símbolo “&” para separar los parámetros. A continuación encontrará un ejemplo:

http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&webmap=9cf053ea602345ddae060010c470e615

Sugerencia:

Ahora hay una forma más sencilla de crear parámetros de dirección URL. Agregue el widget Compartir a la aplicación y haga clic en Opciones de vinculación. Vista previa del vínculo muestra los parámetros que se han seleccionado y se genera automáticamente un vínculo de acceso directo que incluye los parámetros de las direcciones URL. Tenga en cuenta que, para utilizar el parámetro find, el widget Buscar debe estar activado en la aplicación.

Nota:

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, a continuación se muestra un parámetro de dirección 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 una aplicación guardada

Para abrir una aplicación guardada que se haya creado con Web AppBuilder, utilice id= y el Id. exclusivo de la aplicación tal y como se muestra en el ejemplo siguiente:

http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d

Definir el mapa web

Para definir el mapa web, utilice webmap= y el Id. exclusivo del mapa web tal y como se muestra en el ejemplo siguiente:

http://<your portal url>/apps/webappviewer/index.html?webmap=9cf053ea602345ddae060010c470e615

Centrar el mapa

Para centrar el mapa en una ubicación particular, establezca center= utilizando coordenadas geográficas (x,y) o coordenadas proyectadas (x,y,WKID).

Precaución:

Puede utilizar la coma o el punto y coma como separadores. Utilice el punto y coma si los números usan los dos puntos como decimales

A continuación se muestra un ejemplo de coordenadas geográficas:

http://<your portal url>/apps/webappviewer/index.html?center=34,-50

A continuación se muestra un ejemplo de coordenadas proyectadas:

http://<your portal url>/apps/webappviewer/index.html?center=500000,5500000,102100

Definir el nivel de escala

Para definir el nivel de escala del mapa, utilice 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. A continuación encontrará un ejemplo:

http://<your portal url>/apps/webappviewer/index.html?center=20,45&level=4

Definir la escala

Para definir la escala del mapa, utilice 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. A continuación encontrará un ejemplo:

http://<your portal url>/apps/webappviewer/index.html?center=20,45&scale=4622324

Definir la extensión

Para definir la extensión del mapa, utilice 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. Puede utilizar la coma o el punto y coma como separadores. Use el punto y coma si los números usan los dos puntos como decimales.

A continuación se muestra un ejemplo de coordenadas geográficas:

http://<your portal url>/apps/webappviewer/index.html?extent=-117.20,34.055,-117.19,34.06

A continuación se muestra un ejemplo de coordenadas proyectadas:

http://<your portal url>/apps/webappviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

Buscar una ubicación o entidad para abrir el mapa

Para buscar una ubicación o entidad utilizada para abrir el mapa, use 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)). A continuación encontrará un ejemplo:

http://<your portal url>/apps/webappviewer/index.html?find=380 new york street, redlands, ca

Precaución:

Para utilizar este parámetro, todos los parámetros de la consulta deben estar codificados y el widget Buscar debe estar activado en la aplicación.

Agregar un punto

Para agregar un punto al mapa, utilice marker=<x>,<y>. El punto se agrega al mapa en la ubicación x,y especificada. También puede incluir las siguientes propiedades opcionales:

• <wkid>: referencia espacial de las coordenadas x,y agregadas al mapa. Si no incluye un WKID, se utilizarán las coordenadas GCS.
• <título codificado>: título del elemento emergente del punto. Si no incluye un título, la ventana emergente estará vacía.
• <dirección URL del icono codificada>: símbolo para el punto. Si no incluye un símbolo, se utilizará un símbolo de marcador azul.
• <etiqueta codificada>: etiqueta situada junto al símbolo de punto.

Debe tener en cuenta lo siguiente:

• <x>,<y> son necesarios.
• Asegúrese de codificar los parámetros de título, icono y etiqueta.
• Debe agregar las propiedades en este orden: marcador=<x>,<y>,<wkid>,<título codificado>,<dirección URL del icono codificada>,<etiqueta codificada>.
• Puede utilizar la coma o el punto y coma como separadores. Use el punto y coma si los números usan los dos puntos como decimales.
• Utilice valores vacíos. No utilice espacios. Por ejemplo, para especificar una etiqueta y ninguna de las demás propiedades opcionales, agregue 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=.

A continuación encontrará un ejemplo:

http://<your portal url>/apps/webappviewer/index.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7

Consultar una entidad

Para consultar una entidad y acercarla, puede 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>

Sugerencia:

Ahora hay una forma de construir parámetros de dirección URL interactivamente. Agregue el widget Compartir a la aplicación y haga clic en Opciones de vinculación. Elija la opción Consultar una entidad y aplicarle el zoom y seleccione la capa, el campo y valor de campo sobre los que desea hacer la consulta. Copie la dirección URL en Vista previa del vínculo que contiene los parámetros de dirección URL que ha especificado. Elimine el widget Compartir de la aplicación si no es necesario.

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, le recomendamos encarecidamente que utilice el Id. de la capa en la consulta. Puede recuperar el Id. de la capa del Id. del mapa web como se muestra aquí: http://<your portal url>/sharing/rest/content/items/32a83775654249dcae6b8f2eff5d4072/data/?f=pjson

Precaución:

Asegúrese de que el mapa web se comparte públicamente cuando recupere el Id. de la capa

Por ejemplo, se agrega una capa al mapa por separado en formato JSON, como se muestra a continuación. El Id. de la capa es Census_8491, el nombre de campo es POP2000 y el valor del campo es 1211537. Puede ejecutar las siguientes consultas:

id: "Census_8491",
layerType: "ArcGISFeatureLayer",
url: "http://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer/3",
visibility: true,
opacity: 1,
mode: 1,
title: "Census - states",

http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491,POP2000,1211537

http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491,POP2000=1211537

También puede consultar una cadena de caracteres o los campos ObjectID.

http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491,STATE_NAME,California

http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491,STATE_NAME='California'

http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491,OBJECTID,1

A menudo, se agrega una capa como un grupo de un servicio de mapas. Para consultar una subcapa de un grupo, use <layer id_sublayer id> como Id. de capa. Usando la siguiente capa como ejemplo, el Id. de capa es Census_3217 y el índice del Id. de la subcapa es 3. El Id. de capa de la subcapa debería ser Census_3217_3. Puede ejecutar las siguientes consultas:

id: "Census_3217", layerType: "ArcGISMapServiceLayer", url: "http://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer", visibility: true, opacity: 1,
title: "Census"

http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_3217_3,POP2000,1211537

http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_3217_3,POP2000=1211537

Cambiar la configuración regional

Para cambiar el idioma de la aplicación, utilice 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.

A continuación encontrará un ejemplo:

http://<your portal url>/apps/webappviewer/index.html?locale=fr

Autenticar el usuario

Para autenticar automáticamente un usuario en una aplicación no pública, utilice token=<token>. De esta forma, los usuarios no tendrán que introducir su nombre de usuario y contraseña. A continuación encontrará un ejemplo:

http://<your portal url>/apps/webappviewer/index.html?token=utmVcabc_LNyEQ7OuuHD73em0MErLR_cudJTeSIdMFTnL0poF3shVBeng5ieWHyZn0kAA8nhUg7jseQxz3bi5crnFMMpldDiJLrtzmO3jEM-ZNVIUEh5_qMms-YgXUwGgFbeQlM9WaI3jwraUqwah0yCceBAxEkEIAEWvlBEDfVsYs3LZydORRcs2QIcdLas

Controlar 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. No obstante, esto puede dar lugar a un comportamiento inesperado al integrar la aplicación en un sitio web, por ejemplo, cuando el elemento emergente en el sitio web tiene el estilo de diseño móvil. Para controlar el estilo del diseño, use mobileBreakPoint=<pixel number>. Por ejemplo, puede permanecer en el estilo de escritorio hasta que el tamaño de la pantalla sea inferior a 300 píxeles, como se muestra a continuación:

http://<your portal url>/apps/webappviewer/index.html?mobileBreakPoint=300