O aplicativo da web Survey123 pode aceitar parâmetros no mesmo formato do aplicativo de campo. Uma distinção a ser observada é que o ID do item da pesquisa faz parte do caminho da URL, e não de umParâmetro de URL como os outros links usados para abrir pesquisas. Ao adicionar parâmetros a essa URL, você deve usar um ponto de interrogação para separar o ID do item de pesquisa no caminho do primeiro parâmetro e, em seguida, usar o "e" comercial para separar os parâmetros subsequentes. O seguinte exemplo de URL passa os parâmetros da coordenada e sobrenome para uma pesquisa no aplicativo da web Survey123 :
https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19?field:surname=Klauser¢er=37.8199,-122.4783O aplicativo da web Survey123 também suporta uma variedade de parâmetros que o aplicativo de campo Survey123 não. Estes parâmetros estão relacionados à apresentação da pesquisa em um navegador. Consulte a tabela a seguir para parâmetros da URL e exemplos que personalizam como o aplicativo da web é aberto.
Anotação:
Se um valor de parâmetro incluir espaços, sinais de adição (+), ou outros caracteres especiais, esses caracteres devem ser codificados por porcentagem. Para mais informações, consulte Codificação de URL.
Parâmetros de URL para iniciar o aplicativo da web
| Parâmetro | Descrição | Tipo |
|---|---|---|
isOrgSignIn | Usa a página de login específica da organização. Por padrão, o Survey123 usa a página de login específica da organização, mas ao compartilhar pesquisas com mais de uma organização, usando a página de login do ArcGIS Online pode ser preferido. Defina este parâmetro como false para usar a página de login do ArcGIS Online. Exemplo: | Booleano |
center | Centraliza o mapa na latitude, longitude e altitude opcional conhecidas. Exemplo: | Texto |
field:fieldname | Preenche perguntas da pesquisa com valores de campo. Exemplo: | Texto |
portalUrl | Especifica a URL para o portal onde o item de pesquisa está hospedado. Exemplo: | Texto |
| open | Especifica o aplicativo usado para abrir a pesquisa. Os valores válidos são web, que abre a pesquisa no aplicativo da web (o padrão; native que abre a pesquisa no aplicativo de campo se o aplicativo de campo estiver instalado e menu, que abre uma página da web para determinar o aplicativo que abrirá a pesquisa. Exemplo: | Texto |
| hide |
Oculta elementos da pesquisa no aplicativo da web. O parâmetro pode aceitar múltiplos valores separados por uma vírgula. Os valores válidos são navbar (a barra na parte superior da pesquisa, incluindo opções para entrar, sair e alterar o idioma), header, description, footer, submit, theme e leaveDialog (a mensagem de aviso que aparece ao sair ou fechar a página). Você também pode usar o parâmetro field:fieldName para ocultar uma pergunta, grupo, página ou repetição específica, fornecendo o nome no lugar de fieldName. As perguntas nas repetições não podem ser ocultadas individualmente. Exemplo: | Texto |
| locale | Muda o idioma da pesquisa. Só funciona se a pesquisa incluir vários idiomas. Exemplo: | Texto |
| mode | Define o modo do aplicativo da web. Os valores válidos são edit, que define a pesquisa para editar uma entrada existente em vez de criar uma; view, que abre uma entrada existente no modo de somente leitura; e copy, que cria uma pesquisa que é preenchida com o conteúdo da entrada especificada. Ao utilizar este parâmetro, o parâmetro globalId também deve ser fornecido. Exemplo: | Texto |
| globalId | Especifica o registro da pesquisa que é carregado no formulário. Os valores válidos são os IDs globais para registros de pesquisa existentes. O nome deste parâmetro faz distinção entre letra maiúsculas e minúsculas. Exemplo: | Texto |
recalculate | Pode ser usado somente com mode=edit. Este procedimento força as perguntas especificadas a serem recalculadas à medida que a pesquisa é carregada, sem o uso do botão Recalcular. Exemplo: | Texto |
| version | Define a versão do aplicativo da web que será utilizada. O único valor válido é latest, que usa a versão mais recente do aplicativo da web, mesmo se a versão da pesquisa estiver bloqueada. Exemplo: | Texto |
| token | Passa um token válido de uma pesquisa. Ele pode ser usado para permitir que os entrevistados respondam a uma pesquisa que exige uma conta do ArcGIS para acessar sem registrar. Exemplo: | Texto |
autoReload | Recarrega a pesquisa após o envio. Especifique o atraso (em segundos) antes que a pesquisa seja recarregada. Anteriormente era chamado de autoRefresh. O parâmetro autoRefresh tem suporte para compatibilidade com versões anteriores. Exemplo: | Inteiro |
| encodeUrlParams | Obscurece os parâmetros de URL. Em vez disso, a URL resultante incluirá um parâmetro code que representa todos os parâmetros codificados; os parâmetros incluídos fora deste parâmetro code serão ignorados. Exemplo: | Booleano |
width | Define a largura da pesquisa, em pixels. Isso também afeta outros controles na pesquisa, como caixas de texto. Exemplo: | Inteiro |
Anotação:
O parâmetro field:fieldname oferece suporte a perguntas de ponto geográfico, traçado geográfico e formato geográfico no aplicativo da web. Para perguntas de ponto geográfico, especifique latitude, longitude e altitude (opcional) separados por espaços. Para traçado geográfico e formato geográfico, para cada vértice especifique a latitude e longitude separadas por um espaço, com cada par de coordenadas separado por um ponto e vírgula. Este exemplo funcionaria para uma pergunta de formato geográfico:
field:geoshape=-37.842156723211474 144.95942945338243;-37.83554486071995 144.9726235713864;-37.85681405373047 144.98240735651922;-37.85954045531896 144.97715349053766