Aplicativos criados com Web AppBuilder podem ser diretamente modificados com parâmetros da URL. A URL sempre começa com <your portal url>/apps/webappviewer/index.html? e inclui um ou mais dos parâmetros listados abaixo. Para incluir mais de um parâmetro, utilize o sinal gráfico (&) para separar os parâmetros. Abaixo está um exemplo:
http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&webmap=9cf053ea602345ddae060010c470e615Dica:
Agora há uma maneira mais fácil para construir parâmetros da URL. Adicione o widget Compartilhar no aplicativo e clique em Opções de Link. Visualizar Link exibe os parâmetros que você selecionou e um link de atalho incluindo os parâmetros da URL é automaticamente gerado para você. Esteja ciente que o widget Pesquisar deve ser habilitado no aplicativo para utilizar o parâmetro find.
Anotação:
Atualmente os aplicativos 3D não suportam parâmetros do URL.
Codificar os parâmetros da consulta
Todos os parâmetros da consulta devem ser codificados. A codificação substitui caracteres inválidos com a % seguida por seu hex equivalente.
Por exemplo, o seguinte é um parâmetro da URL não codificado:http://<your portal url>/apps/webappviewer/index.html?find=380 new york street, redlands, ca
Aqui está o mesmo parâmetro codificado:http://<your portal url>/apps/webappviewer/index.html?find=380%20new%20york%20street,%20redlands,%20ca
A web tem muitos sites e ferramentas gratuitas para gerar URLs codificadas. Por exemplo, Albion Research Ltd. tem a página URLEncode e URLDecode. Para efeitos de leitura, os outros exemplos neste tópico não estão codificados.
Abrir um aplicativo salvo
Para abrir um aplicativo salvo criado com o Web AppBuilder, utilize id= e o ID único do aplicativo como mostrado no exemplo seguinte:
http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4dDefinir o mapa da web
Para definir o mapa da web, utilize webmap= e o ID único do mapa da web como mostrado no exemplo seguinte:
http://<your portal url>/apps/webappviewer/index.html?webmap=9cf053ea602345ddae060010c470e615Centralizar o mapa
Para centralizar o mapa em uma posição em particular, configure center= utilizando coordenadas geográficas (x,y) ou coordenadas planas (x,y,WKID).
Aviso:
Você pode utilizar vírgulas ou pontos-e-vírgulas como separadores. Utilize pontos e vírgulas se os seus números utilizarem vírgulas como seus decimais
O seguinte é um exemplo de coordenadas geográficas:
http://<your portal url>/apps/webappviewer/index.html?center=34,-50O seguinte é um exemplo de coordenadas planas:
http://<your portal url>/apps/webappviewer/index.html?center=500000,5500000,102100Definir o nível de escala
Para definir o nível de escala do mapa, utilize os parâmetros center= e level=. O parâmetro level aceita o ID de nível da escala de cache como listado no ponto final REST do serviço de mapa. Abaixo está um exemplo:
http://<your portal url>/apps/webappviewer/index.html?center=20,45&level=4Definir a escala
Para definir o nível da escala de mapa, utilize os parâmetros center= e scale=. O parâmetro scale aceita a escala de cache como listado no ponto final REST do serviço de mapa. Abaixo está um exemplo:
http://<your portal url>/apps/webappviewer/index.html?center=20,45&scale=4622324Definir a extensão
Para definir a extensão de mapa, utilize extent=. O parâmetro extent aceita coordenadas geográficas (GCS) como MinX,MinY,MaxX,MaxY, coordenadas planas (PCS) como MinX,MinY,MaxX,MaxY,WKID ou Well-Known Text String (WKT) como MinX,MinY,MaxX,MaxY,WKT. Você pode utilizar vírgulas ou pontos-e-vírgulas como separadores. Utilize pontos-e-vírgulas se os seus números utilizarem vírgulas como seus decimais.
O seguinte é um exemplo de coordenadas geográficas:
http://<your portal url>/apps/webappviewer/index.html?extent=-117.20,34.055,-117.19,34.06O seguinte é um exemplo de coordenadas planas:
http://<your portal url>/apps/webappviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113O seguinte é um exemplo de Well-Known Text String:
http://<your portal url>/apps/webappviewer/index.html?extent=1008562.1255,1847133.031,1060087.7901,1877230.7859,wkt=PROJCS["NAD_1983_HARN_StatePlane_Illinois_East_FIPS_1201",GEOGCS["GCS_North_American_1983_HARN",DATUM["D_North_American_1983_HARN",SPHEROID["GRS_1980",6378137.0,298.257222101]]Encontre uma localização ou feição para abrir o mapa
Para encontrar um local ou feição que é utilizado para abrir o mapa, utilize find=. O mapa é automaticamente ampliado até o correspondente mais próximo e um marcador de texto é adicionado ao mapa. O parâmetro find aceita endereços de linha única, endereços parciais (como somente cidade ou somente país), nomes de lugares, coordenadas de latitude de longitude e feições em camadas pesquisáveis (como 1916352001 para um Número de Identificação do Lote (PIN)). Abaixo está um exemplo:
http://<your portal url>/apps/webappviewer/index.html?find=380 new york street, redlands, caAviso:
Todos os parâmetros de consulta devem ser codificados e widget Pesquisa deve estar habilitado no aplicativo para utilizar este parâmetro.
Adicionar um ponto
Para adicionar um ponto no mapa, utilize marker=<x>,<y>. O ponto é adicionado no mapa nas posições x e y especificadas. Você também pode incluir as seguintes propriedades opcionais:
- <wkid>—A referência espacial das coordenadas x,y adicionadas no mapa. Se você não incluir um WKID, coordenadas GCS serão utilizadas.
- <título codificado>—Título do pop-up de ponto. Se você não incluir um título, o pop-up estará vazio.
- <URL de ícone codificada>—Símbolo do ponto. Se você não incluir um símbolo, um símbolo de marcador azul será utilizado.
- <rótulo codificado>—Rótulo próximo ao símbolo do ponto.
O seguinte deve ser considerado:
- <x>,<y> são exigidos.
- Certifique-se de codificar o título, ícone e parâmetros do rótulo.
- Você deve adicionar as propriedades nesta ordem: marker=<x>,<y>,<wkid>,<título codificado>,<URL de ícone codificada>,<rótulo codificado>.
- Você pode utilizar vírgulas ou pontos-e-vírgulas como separadores. Utilize pontos-e-vírgulas se os seus números utilizarem vírgulas como seus decimais.
- Utilize valores vazios. Não utilize espaços. Por exemplo, se você desejar especificar um rótulo e nenhuma das outras propriedades opcionais, adicione o rótulo como o sexto parâmetro com valores vazios para os outros (x;y;;;;label).
- Se você desejar o mapa ampliado (além de centralizar no ponto), inclua o parâmetro level=.
Abaixo está um exemplo:
http://<your portal url>/apps/webappviewer/index.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7Consultar uma feição
Para consultar uma feição e ampliá-la, você pode utilizar uma das seguintes opções:
- query=<layer name>,<field name>,<field value>
- query=<layer name>, <where clause>
- query=<layer id>,<field name>,<field value>
- query=<layer id>, <where clause>
Dica:
Agora há uma maneira para construir parâmetros da URL interativamente. Adicione o widget Compartilhar no aplicativo e clique em Opções de Link. Escolha a opção Consultar uma feição e ampliá-la e selecione a camada, campo, e valor de campo que você deseja consultar. Copie a URL na Visualização de Link que contém os parâmetros da URL que você especificou. Remover o widget Compartilhar a partir do aplicativo se não for necessário.
Aviso:
Todos os parâmetros de consulta diferenciam letra maiúscula e minúscula e devem ser codificados.
A cláusula where segue o padrão de SQL. Quando a cláusula where tiver, por exemplo, a operação IN, utilize o ponto-e-vírgula, ao invés de separar o nome da camada ou o id da cláusula where com vírgulas, como mostrado abaixo. O motivo é devido a uma vírgula ser utilizada na cláusula where especificamente para construir a lista de valores como ('A11', 'A12', 'A13) ou ('Charlotte', 'Chicago'). Isto permite que o parâmetro de consulta seja analisado corretamente para distinguir o que é a camada e a cláusula where.
- query=<layer name>; <where clause>
- query=<layer id>; <where clause>
Já que o nome da camada pode ser alterado, é fortemente recomendado que você utilize o ID da camada na consulta. Você pode recuperar o ID da camada a partir do ID de mapa da web como mostrado abaixo: http://<your portal url>/sharing/rest/content/items/32a83775654249dcae6b8f2eff5d4072/data/?f=pjson
Aviso:
Certifique-se que o mapa da web esteja publicamente compartilhado quando você recuperar o ID da camada
Por exemplo, uma camada é adicionada no mapa individualmente como mostrado abaixo no formato JSON. O ID da camada é Census_8491, o nome do arquivo é POP2000 e valor do campo é 1211537. Você pode executar as seguintes 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,1211537http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491,POP2000=1211537Você também pode consultar uma string ou campos de ObjectID.
http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491,STATE_NAME,Californiahttp://<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,1Normalmente uma camada é adicionada como um grupo do serviço de mapa. Para consultar uma subcamada em um grupo, utilize <layer id_sublayer id> como o ID da camada. Utilize a seguinte camada como um exemplo, o ID da camada é Census_3217 e o índice de ID da subcamada é 3. O ID da camada para subcamada deve ser Census_3217_3. Você pode executar as seguintes 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,1211537http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_3217_3,POP2000=1211537http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_8491;STATE_NAME in ('California', '')
Trocar localização
Para trocar o idioma do aplicativo, utilize locale=<language code>. Estes códigos de idioma são suportados: 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, and zh-tw.
Abaixo está um exemplo:
http://<your portal url>/apps/webappviewer/index.html?locale=frControle ao ativar o layout móvel
O aplicativo suporta dois estilos de layout baseado no tamanho da tela. Um é para desktop e um para os dispositivos móveis. Quando a altura ou largura de uma imagem da tela for menor que 600 pixels, o layout móvel se aplica automaticamente. Entretanto, isto pode resultar em comportamento inesperado quando o aplicativo é embutido em um site da web, por exemplo, quando o pop-up no site da web está no estilo de layout móvel. Para controlar o estilo de layout, utilize mobileBreakPoint=<pixel number>. Por exemplo, você pode permanecer no estilo de desktop até que o tamanho da tela seja menor que 300 pixels:
http://<your portal url>/apps/webappviewer/index.html?mobileBreakPoint=300