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 |
|---|---|---|
signIn | Para pesquisas públicas, mostra o botão de login ou exige que os usuários efetuem login. Por padrão, o aplicativo da web não fornece um método para os usuários efetuarem login em pesquisas públicas, mas as pesquisas públicas podem incluir recursos que só somente funcionam quando os usuários estão conectados. Um exemplo é usar um cálculo para extrair o endereço de e-mail de um usuário conectado. Os valores válidos são show, que exibe o botão de login na barra de navegação na parte superior do aplicativo da web; e require, que exige que os usuários efetuem login redirecionando-os para a página de login. Exemplo: | Texto |
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 ou como uma fração da largura da tela. Um valor maior que 1 define a largura em pixels. Se o valor do pixel for menor que a largura da tela, a largura da tela será usada. Um valor entre 0 e 1 definirá a largura do formulário como uma fração da largura da tela. Isso também afeta outros controles na pesquisa, como caixas de texto, e pode ajudar a melhorar a forma como o aplicativo da web exibe uma grade fixa ou dinâmica. Exemplos: | Texto |
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