Você pode criar links para abrir o Survey123 Mobile a partir de outro aplicativo, de um pop-up em um mapa da web ou de um hiperlink em um e-mail ou site. Use um esquema de URL personalizado para iniciar o aplicativo em um navegador da web ou use um link do aplicativo Survey123 para iniciá-lo em um aplicativo no Android ou iOS. Utilize parâmetros de URL para personalizar a forma como o Survey123 Mobile é aberto — por exemplo, para carregar uma pesquisa específica, definir coordenadas para a localização padrão do mapa e preencher respostas a perguntas com valores predeterminados ou passando atributos de dados a partir de um pop-up de mapa web.
Link de um navegador da web no Windows
Você pode criar um link para abrir o Survey123 Mobile que pode ser incorporado a outro aplicativo. O mesmo link também pode ser inserido em um navegador da web para teste.
Anotação:
Após criar o link, você pode substituir arcgis-survey123-mobile:// por https://survey123-mobile.arcgis.app como o link do Survey123 para usar no iOS ou Android.
Para criar um esquema de URL personalizado e usá-lo em um navegador da web para desktop, siga estas etapas:
- Digite arcgis-survey123-mobile:// no seu navegador.
O Survey123 Mobile abre (ou você é solicitado a abri-lo).
Anotação:
Para iniciar e baixar uma pesquisa de um portal específico, inclua o parâmetro URL do portal, por exemplo, arcgis-survey123-mobile://?portalUrl=host.domain.com/webadaptor (no qual host, domain, e webadaptor são substituídos pelas informações do seu portal).
- Adicione uma referência exclusiva a uma pesquisa e inclua-a na URL seguindo estas etapas:
- Identifique o ID do item da pesquisa que você deseja abrir.
Anotação:
Esta é a string de caracteres que oArcGIS Online utiliza para identificar exclusivamente sua pesquisa e pode ser localizada na URL do seu item de formulário no ArcGIS Online. Por exemplo, se a URL da pesquisa for https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19, o ID de item do seu formulário será 36ff9e8c13e042a58cfce4ad87f55d19.
- Inclua a pesquisa na URL adicionando ?itemID= e o ID de item do seu formulário no final da URL.
A URL deve parecer semelhante ao seguinte:arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19Se você testar a URL, ela deverá abrir o Survey123 Mobile e, imediatamente, abrir a pesquisa.
Anotação:
Se ainda não estiver no seu dispositivo, a pesquisa será baixada para ele.
- Identifique o ID do item da pesquisa que você deseja abrir.
- Inclua respostas pré-determinadas às perguntas adicionando uma referência na URL a um campo usando o nome atribuído a ele no XLSForm (não seu rótulo).
Por exemplo, para preencher o campo Surname, digite &field:surname= e o valor.
O & atua como um separador de parâmetro e field: faz referência ao nome da pergunta a ser preenchida.
A URL deve parecer semelhante ao seguinte:arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=KlauserAgora você pode usar a URL para abrir o Survey123 Mobile e a pesquisa, e preencher a pergunta indicada com a resposta que você definiu. Você pode preencher múltiplas perguntas em uma URL de pesquisa. Os nomes de campo diferenciam letra maiúscula e letra minúscula.
- Defina uma localização para uma pergunta de ponto geográfico na pesquisa adicionando coordenadas à URL da seguinte forma:
- Digite ¢er=, e digite as coordenadas.
- Digite as coordenadas de latitude e longitude em graus decimais, separadas por uma única vírgula.
- Opcionalmente, adicione altitude em metros de decimais como um terceiro valor, também separado por uma única vírgula.
A URL final deve parecer semelhante ao seguinte:
arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20Esta URL agora abrirá o Survey123 Mobile e a pesquisa escolhida, preencherá uma pergunta de texto e fornecerá um novo local padrão para a pergunta de ponto geográfico.
Os atributos de campo também podem ser passados para Survey123 Mobile a partir de um pop-up em um mapa da web do ArcGIS, permitindo a integração com outros aplicativos Esri que usam pop-ups em um mapa da web. Esse recurso pode ser usado para preencher um campo no Survey123 Mobile com o valor de um atributo da feição, em vez de um valor definido, fornecendo o nome do atributo entre chaves.
- Abra o mapa da web e selecione Pop-ups para uma das camadas, escolha Adicionar conteúdo, selecione Texto, forneça o texto a ser exibido para o link e clique no botão Link inserir o valor da URL do link.
Link de outro aplicativo no iOS ou Android
Você pode criar um link para uso em aplicativos ArcGIS para abrir o Survey123 Mobile e capturar dados em uma pesquisa. As etapas abaixo descrevem como criar um link de aplicativo Survey123 e usá-lo em um pop-up de mapa da web. Este link é inserido no pop-up de um mapa da web em sua organização ArcGIS. Você pode testar o link usando um navegador da web (usando etapas semelhantes às da seção anterior) em um dispositivo iOS ou Android.
- Abra um mapa da web que será visualizado no dispositivo e selecione Pop-up para uma das camadas.
- Escolha Adicionar conteúdo e selecione Texto.
- Digite Iniciar Survey123, Selecione este texto e clique no botão Link para inserir a URL do link, digite https://survey123-mobile.arcgis.app, clique em OK, e faça o seguinte
- Abra o mapa da web em um dispositivo móvel a partir de um navegador ou de um aplicativo ArcGIS.
- Selecione uma feição e clique no link Iniciar Survey123 no pop-up para abrir o Survey123.
- Para incluir a pesquisa na URL, adicione ?itemID= e o ID de item do seu formulário no final da URL. A URL deve parecer semelhante ao seguinte:
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19Se você testar a URL, ela deverá abrir o Survey123 Mobile e, em seguida, abrir imediatamente a pesquisa.
Anotação:
Se ainda não estiver no seu dispositivo, a pesquisa será baixada para ele.
- Inclua respostas pré-determinadas às perguntas adicionando uma referência na URL a um campo usando o nome atribuído a ele no XLSForm (não seu rótulo).
Por exemplo, para preencher o campo Surname, digite &field:surname= e o valor.
O & atua como um separador de parâmetro e field: faz referência ao nome da pergunta a ser preenchida.
A URL deve parecer semelhante ao seguinte:https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=KlauserAgora você pode usar a URL para abrir o Survey123 Mobile e a pesquisa, e preencher a pergunta apresentada com a resposta que você definiu. Você pode preencher múltiplas perguntas em uma URL de pesquisa. Os nomes de campo diferenciam letra maiúscula e letra minúscula.
- Defina uma localização para uma pergunta de ponto geográfico na pesquisa adicionando coordenadas à URL da seguinte forma:
- Digite ¢er=, e digite as coordenadas.
- Digite as coordenadas de latitude e longitude em graus decimais, separadas por uma única vírgula.
- Opcionalmente, adicione altitude em metros de decimais como um terceiro valor, também separado por uma única vírgula.
A URL final deve parecer semelhante ao seguinte:
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20Esta URL completa agora abre o Survey123 Mobile e a pesquisa selecionada, preenche uma pergunta de texto e fornece um novo local padrão para a pergunta de ponto geográfico.
Parâmetros de URL para iniciar o Survey123 Mobile
Os seguintes parâmetros podem ser usados para personalizar como o Survey123 Mobile é aberto:
| Parâmetro | Descrição | Tipo |
|---|---|---|
center | Centraliza o mapa em valores conhecidos de latitude, longitude e, opcionalmente, altitude. Exemplo: | Texto |
field:fieldname | Preenche perguntas da pesquisa com valores de campo. Exemplo: | Texto |
portalUrl | A URL para o portal onde o item de pesquisa está hospedado. Exemplo: | Texto |
itemID | O formulário a ser aberto. Exemplo: | UUID |
download | Baixa automaticamente a pesquisa quando o dispositivo estiver online. O padrão é true. Exemplo: | Booleano |
callback | A URL para retornar quando uma ação de formulário (por exemplo, enviar, mover para rascunhos, cancelar ou sair) for concluída. Exemplo: | URL |
callback:status | Exemplo: | Texto |