Normalmente, existem dois componentes do ArcGIS Survey123 para instalar: Survey123 Studio ou Survey123 Connect em um computador para criar pesquisas, e Survey123 Mobile ou o aplicativo de campo Survey123 em um dispositivo para coletar dados de pesquisa.
O site da web Survey123 (o que inclui o web designer e o aplicativo da web) pode ser utilizado sem instalação; no entanto, algumas organizações podem optar por instalar o site da web Survey123 juntamente com uma implementação do ArcGIS Enterprise para dar suporte a um ambiente desconectado.
Instalar o Survey123 Studio
O Survey123 Studio está disponível a partir da Microsoft Store. Você pode instalar Survey123 Studio diretamente no seu dispositivo a partir desta loja.
Você também pode baixar o arquivo de instalação do Survey123 Studio para Windows a partir da página Downloads do Survey123 .
Para instalar o download apenas para o usuário atual, clique duas vezes no arquivo e clique em Instalar. Se uma versão anterior do Survey123 Studio já estiver instalado, você será solicitado a clicar em Atualizar. Se você precisar instalar o aplicativo para todos os usuários do computador, pode usar o comando Microsoft PowerShell Add-ProvisionedAppPackage.
Os arquivos do aplicativo estão no seguinte local no Windows: C:\Program Files\WindowsApps. Normalmente, você não navegará até esses arquivos. Se desejar desinstalar o Survey123 Studio, clique em Configurações > Aplicativos > Aplicativos instalados > ArcGIS Survey123 Studio, e escolha Desinstalar.
Os arquivos de dados da pesquisa estão localizados no seguinte caminho no Windows: C:\Users\<username>\Documents\ArcGIS\Survey-Studio.
Anotação:
O Survey123 Studio pode ser instalado lado a lado com Survey123 Connect.
Instalar o Survey123 Mobile
O aplicativo Survey123 Mobile está disponível no Google Play, App Store e Microsoft Store. Você pode instalar o Survey123 Mobile diretamente no seu dispositivo a partir destas lojas.
Você também pode baixar os arquivos de instalação do Survey123 Mobile para Windows ou Android a partir da Página de downloads do Survey123 .
No Windows, para instalar o download apenas para o usuário atual, clique duas vezes no arquivo e clique em Instalar. Se uma versão anterior do Survey123 Mobile já estiver instalado, você será solicitado a clicar em Atualizar. Se você precisar instalar o aplicativo para todos os usuários do computador, pode usar o comando PowerShell Add-ProvisionedAppPackage.
No Android, você deve primeiro executar o arquivo executável para desktop no Windows para obter o arquivo APK. O arquivo APK pode então ser copiado para um dispositivo Android para instalação, ou instalado utilizando um MDM.
Os arquivos do aplicativo estão no seguinte local no Windows: C:\Program Files\WindowsApps. Normalmente, você não navegará até esses arquivos. Se desejar desinstalar o Survey123 Mobile, clique em Configurações > Aplicativos > Aplicativos instalados > ArcGIS Survey123 Mobile, e escolha Desinstalar.
Os arquivos de dados da pesquisa estão localizados nos seguintes locais:
- Windows—C:\Users\<username>\Documents\ArcGIS\Survey123-Mobile
- Android—Android/data/com.esri.survey123.mobile/files (O dispositivo deve ser conectado a um computador desktop, e um gerenciador de arquivos do computador deve ser utilizado para localizar esses arquivos).
Anotação:
Arquivos de dados não estão acessíveis no iOS porque o aplicativo não solicita permissão para acessar arquivos locais, por questões de privacidade.
O Survey123 Mobile pode ser instalado lado a lado com o aplicativo de campo Survey123.
Instalar o Survey123 Connect
O Survey123 Connect está disponível a partir da Microsoft Store. Você pode instalar Survey123 Connect diretamente no seu dispositivo a partir desta loja.
Você também pode baixar o arquivo de instalação do Survey123 Connect para Windows a partir da página Downloads do Survey123 .
Para instalar o Survey123 Connect, clique duas vezes no arquivo de instalação e faça o seguinte:
- Clique em Avançar.
- Escolha a pasta de instalação (a padrão é preferida).
- Aceite o acordo de licença.
- Indique o nome do menu inicial.
- Clique em Instalar.
Os arquivos do aplicativo estão no seguinte local no Windows: C:\Users\<username>\Applications\ArcGIS\ArcGISSurvey123Connect.
Normalmente, você não editará estes arquivos. Se você desejar a desinstalação do Survey123 Connect, navegue até esta pasta e escolha Desinstalar ArcGISSurvey123Connect.
Os arquivos de dados da pesquisa estão localizados no seguinte caminho: C:\Users\<username>\ArcGIS\My Survey Designs.
Anotação:
Se uma versão anterior do Survey123 Connect já estiver instalada, uma mensagem aparecerá perguntando se você deseja continuar.Instalar o aplicativo de campo Survey123
O aplicativo de campo Survey123 está disponível no Google Play, App Store e Microsoft Store. Você pode instalar o Survey123 diretamente no seu dispositivo a partir destas lojas.
Você também pode baixar o arquivo de instalação do aplicativo de campo Survey123 para Windows e Android a partir da página de downloads do Survey123 e instale-o da mesma forma que Survey123 Connect.
Após a instalação ser concluída, um atalho na área de trabalho denominado Survey123 é criado. O local de instalação de todos os arquivos do aplicativo de campo Survey123 na área de trabalho é o mesmo que para Survey123 Connect.
Os arquivos de dados da pesquisa estão localizados nos seguintes locais:
- Windows—C:\Users\<username>\ArcGIS
- iOS—On My iPad/Survey123/ArcGIS ou On My iPhone/Survey123/ArcGIS
- Android—Android/data/com.esri.survey123/files/ArcGIS (O dispositivo deve ser conectado a um computador desktop, e um gerenciador de arquivos do computador deve ser utilizado para localizar esses arquivos).
Anotação:
No Windows, Se uma versão anterior do aplicativo de campo Survey123 já estiver instalada, uma mensagem aparecerá perguntando se você deseja continuar. No Android e iOS, versões anteriores do aplicativo de campo Survey123 será automaticamente substituído.Instalação e desinstalação autônoma
O Survey123 Studio e Survey123 Mobile podem ser instalados e desinstalados usando os comandos PowerShell.
O Survey123 Connect e o aplicativo de campo Survey123 podem ser instalados e desinstalados utilizando os arquivos de script fornecidos.
Survey123 Studio e Survey123 Mobile
O Survey123 Studio e Survey123 Mobile são fornecidos como arquivos MSIX para Windows, e você pode usar os comandos PowerShell abaixo para instalar e desinstalar.
Para instalar quando o nome do arquivo for o mesmo que você baixou, use Add-AppxPackage -Path "C:\Downloads\Survey123-Mobile_x64_26.1.0.100.msix".
Para desinstalar, use o seguinte:
- Survey123 Studio—Get-AppxPackage -Name "Esri.ArcGISSurvey123Studio*" | Remove-AppxPackage
- Survey123 Mobile—Get-AppxPackage -Name "Esri.ArcGISSurvey123Mobile*" | Remove-AppxPackage
O Survey123 Connect e o aplicativo de campo Survey123
Quando você instala o Survey123 Connect ou aplicativo de campo Survey123 no Windows, você também recebe arquivos de script para ajudar a realizar futuras instalações ou desinstalações autônomas.
Para se preparar para essas ações, siga os passos abaixo após instalar o aplicativo em um dispositivo, utilizando Survey123 Connect como exemplo:
- Navegue até o local onde o aplicativo foi instalado, que, por padrão, está no Windows, é C:\Users\<username>\Applications\ArcGIS\ArcGISSurvey123Connect.
- Copie os seguintes arquivos para outro local no seu dispositivo, para uma pasta de rede ou para uma unidade USB. Por exemplo, crie uma pasta chamada InstallScripts na sua área de trabalho.
- silent-install-controller.qs
- silent-uninstall-controller.qs
- silent-uninstall-install-ArcGISSurvey123Connect
- Quando chegar a hora de instalar uma nova versão do Survey123 Connect, copie o arquivo de instalação do aplicativo na pasta InstallScripts criada, e renomeie o arquivo para um nome que permanecerá constante, por exemplo Survey123ConnectInstallFile.exe.
Após esta localização ser estabelecida, os arquivos de script e .qs não serão alterados. Para executar a opção de desinstalar e instalar automaticamente, somente os arquivos da instalação precisarão alterar.
Se você tiver múltiplos aplicativos que são baseados no AppStudio em seu computador, você precisará somente de uma cópia do silent-install-controller.qs e silent-uninstall-controller.qs. Copie apenas os arquivos de script silent-uninstall-install-appName diferentes para a pasta InstallScripts que você criou, ao lado dos arquivos .qs.
Por padrão, a instalação e desinstalação autônomas serão realizadas em segundo plano, sem interface de usuário para mostrar o progresso. Para exibir uma interface de usuário para essas instalações e desinstalações autônomas, adicione o parâmetro da linha de comando showui=true ao executar os arquivos de script.
Anotação:
Se os seus scripts forem anteriores a versão do Survey123 3.10, atualize seus scripts para a versão mais recente para garantir que ocultar a interface seja o comportamento padrão.
Para desinstalar o aplicativo usando esses scripts, navegue até a pasta InstallScripts que você criou em uma janela de prompt de comando e digite o seguinte comando:
silent-uninstall-install-ArcGISSurvey123Connect.bat .
O ponto no final é importante, já que indica que nada será instalado.
Para instalar o aplicativo, navegue até a pasta InstallScripts que você criou em uma janela de prompt de comando e digite o seguinte comando:
silent-uninstall-install-ArcGISSurvey123Connect.bat Survey123ConnectInstallFile.exe
O mesmo comando desinstala todas as versões existentes do aplicativo antes de instalar a nova versão, permitindo a você atualizar o aplicativo com um comando.
Instalar o site da web Survey123
O site da web Survey123 pode ser instalado junto com uma implantação do ArcGIS Enterprise para oferecer suporte a um ambiente desconectado ou para que as organizações hospedem o site d web em sua própria infraestrutura. Os seguintes são incluídos na instalação:
- O site da web Survey123 para gerenciamento de pesquisas e visualização dos resultados das pesquisas.
- Survey123 REST API para converter configurações da pesquisa (arquivos .xlsx) para formulários de uso em aplicativos da web e campo do Survey123.
O arquivo exigido para instalar o site da web Survey123 é baixado do My Esri e pode ser instalado na mesma máquina que sua instância do Portal for ArcGIS ou em um servidor da web independente. Um administrador de sistema deve realizar o seguinte:
- Instale os arquivos baixados.
- No Windows, descompacte o arquivo baixado na máquina onde você deseja instalar o site do Survey123, execute setup.exe, e conclua as etapas de instalação do assistente.
- No Linux, extraia o conteúdo do arquivo .tar.gz na máquina onde deseja instalar o site Survey123 usando o comando gunzip [filename].tar.gz seguido de tar xf [filename].tar no Terminal. Após extraído, execute ./Setup no Terminal, e conclua as etapas de instalação do assistente.
- Execute o utilitário de pós-instalação e complete as perguntas. Esta etapa varia dependendo do método de autenticação utilizado pela sua implementação. Os detalhes completos estão descritos no artigo da Base de Conhecimento Instrução: Instalar e configurar o site ArcGIS Survey123 .
- ArcGIS Enterprise com autenticação embutida—Inicie o assistente em https://localhost:5443/share/post-install.html.
- ArcGIS Enterprise com autenticação de IWA (na mesma URL de host)—Inicie o assistente em https://webadaptorhost.domain.com:5443/share/post-install.html (onde webadaptorhost e domain são substituídos por informações sobre seu servidor).
- ArcGIS Enterprise com autenticação de IWA (na URL do host diferente)—Siga as etapas manuais de pós-instalação do artigo da Base de Conhecimento Instrução: Instalar e configurar o site ArcGIS Survey123 .
Anotação:
Se você receber um aviso de segurança em seu navegador, aceite o aviso e vá para a página da web para concluir as etapas de pós-instalação. As etapas de pós-instalação tratam do aviso.
- Clique em Enviar para completar o seguinte:
- Atualize o arquivo config.json.
- Importe seus arquivos de certificado para a pasta ~\ArcGIS\Survey123website\server\cert\.
- Anexe sua URL de host do Survey123 enterprise como um URI de redirecionamento para o survey123hub.
Para obter mais informações, consulte os seguintes artigos relacionados da Base de Dados de Conhecimento: