O Survey123 Connect irá converter seus formulários projetados utilizando a especificação de XLSForm em um XForm a ser utilizado no Survey123 e publicá-los no ArcGIS Online ou ArcGIS Enterprise. Alguns problemas podem surgir durante este processo.
Erros de conversão do formulário
Quando você cria uma nova pesquisa no Survey123 Connect, você usa a especificação XLSForm para projetar seu formulário usando uma planilha. O Survey123 Connect converte a planilha em um XForm, permitindo que você visualize sua pesquisa como ela aparecerá no Survey123.
A conversão ocorre após você fazer o seguinte:
- Salve as alterações na sua planilha.
- Clique no botão Atualizar no Survey123 Connect.
Se houver um problema com sua pesquisa, você receberá um erro do serviço de conversão do formulário. No seguinte exemplo, a mensagem de erro explica que o problema está na entrada de nome denominada sobrenome. Neste caso, a entrada tem um espaço nela. O espaço deve ser removido ou substituído por um sublinhado ou traço.
Alguns erros de formulário comuns estão listados na seguinte tabela:
| Descrição do erro | Diagnóstico |
|---|---|
Erro ao converter XLSForm | No exemplo acima, este erro destacou a pergunta denominada last name. Neste caso, o erro é o espaço na coluna name. Outro erro comum que resultará nesta mensagem é quando caracteres dferentes de ASCII são utilizados na coluna nome da planilha de survey ou choices. Os caracteres ASCII podem ser utilizados na coluna label, mas não na coluna name. |
[row : 2] Listar nome que não está na folha de opções: [JobType] | Este erro informa a você que suas perguntas select_one ou select_multiple estão referenciando uma lista que não existe na planilha choices. Neste exemplo, os colchetes devem ser removidos. |
Deve haver opções para esta pergunta. | Este erro informa a você que suas perguntas select_one ou select_multiple têm o parâmetro adicional or_other como parte do tipo que também tem um filtro de opção definido. A seleção de perguntas que incluem a opção de inserir um valor de Outro não pode ser utilizada em uma seleção de cascata. |
Erros da rede
Se você tiver problemas para acessar o serviço de conversão do formulário, você receberá um erro semelhante ao seguinte:
Alguns erros de rede comuns estão listados na seguinte tabela:
| Número do erro | Descrição do erro | Diagnóstico |
|---|---|---|
-1 | Não pode abrir C:/Users/Username/ArcGIS/My Survey Designs/Form 1/Form 1.xlsx | O Excel pode ter um bloqueio em seu arquivo. Tenha certeza que a pesquisa não esteja aberta por outro programa ou usuário. |
3 | Host survey123.arcgis.com não localizado | Você está executando uma versão antiga do Survey123 Connect. Atualize para a versão mais recente. |
6 | Falha de handshake do SSL | Há vários problemas que podem causar falhas de SSL, tais como os seguintes:
Você pode testar os certificados SSL utilizados em um servidor da web utilizando um teste online como SSL Labs. |
99 | O tempo limite da conexão expirou | Às vezes observado quando se trabalha com pesquisas muito grandes. Tente novamente. |
202 | Erro ao baixar https://survey123.esri.com/api/xls2xform - servidor respondeu: Proibido | Qualquer erro que tenha esri.com na mensagem está apontando para o servidor antigo. Atualize para a versão mais recente. |
203 | Error ao baixar https://survey123.esri.com/api/xls2xform - servidor respondeu: Não Localizado | Qualquer erro que tenha esri.com na mensagem está apontando para o servidor antigo. Atualize para a versão mais recente. |
401 | Error ao baixar https://survey123.arcgis.com/api/xls2xform - servidor respondeu: Erro Interno de Servidor | Este erro normalmente é ativado por expressões em colunas de cálculo ou relevantes. Use colchetes e inclua um símbolo $ no início da declaração. |
403 | Erro ao baixar https://survey123.esri.com/api/xls2xform - servidor respondeu: Serviço Temporariamente Indisponível | Informe isto para Esri imediatamente. |
498 | Token inválido | O token que o Survey123 Connect tentou validar no ArcGIS não foi aceito. Isto geralmente é causado por uma URL de envio tentando validar um token para uma camada de feição pública. |
499 | Erro ao transferir https://survey123.arcgis.com/api/xls2xform - servidor respondeu: Erro de Proxy | O Survey123 API não está disponível ou expirou. Tente novamente após um curto período. Se o problema persistir, consulte o grupo o Survey123 Esri Community para mais informações. |
Na caixa de diálogo de erro, você tem a oportunidade de capturar o erro para enviar à Esri. Insira qualquer informação adicional no e-mail que possa ajudar na depuração do problema.
Publicar erros
Estes erros geralmente vêm da questão de criar os itens da sua pesquisa no ArcGIS.
Alguns erros de publicação comuns são listados na seguinte tabela:
| Erro | Diagnóstico |
|---|---|
A URL de envio não é compatível (campo não encontrado) | O campo nomeado não está presente na camada de feição designado pela URL de envio, o que significa que as respostas da pesquisa são incompatíveis com a pesquisa. Cancele a atribuição da URL de envio para criar uma nova, ou certifique-se que a sua URL de envio é para camada de feição correta. Esse erro geralmente é causado pelo campo adicional que é criado ao usar a opção or_other para uma pergunta select_one ou select_multiple. Para mais informações, consulte Perguntas de múltipla escolha. |
A URL de envio não é compatível (Erro de solicitação) | Verifique se o usuário com o qual entrou no Survey123 Connect tem permissão para acessar a camada de feição. |
Nenhum campo-chave dependente no SurveyName para repeat_1 principal | Este erro ocorre se a camada de feição que você está enviando depender de chaves principais do Global ID que não estão presentes na pesquisa. Na janela Opções de Publicação, configure Utilizar chaves principais de identificação global em relacionamentos repetidos para verdadeiro. |
Falha de CRIAR TABELA, pois a coluna 'x' na tabela 'y' excede o máximo de 1024 colunas | A pesquisa que você está tentando publicar tem mais campos que o permitido por uma camada de feição em uma organização do ArcGIS (1.024). Reduza o número de campos para menos de 1.024 e publique a pesquisa novamente. Para mais informações sobre estas limitações, consulte Correção de Erros na ajuda do ArcGIS Online. |
A URL de envio do serviço da feição personalizado não é compatível com esta pesquisa (o serviço da feição não atende os requisitos para uma pesquisa com repetições - apoiaApplyEditsWithGlobalIds) | A propriedade supportsApplyEditsWithGlobalIds está definida como falso e precisa ser verdadeiro. A maneira mais fácil de fazer isto é habilitar a sincronização ao publicar sua camada de feição. |
A url de submissão do serviço de feição personalizada não é compatível com esta pesquisa (Relacionamento de destino não localizado pela tabela) | Uma repetição em sua pesquisa é associado incorretamente com uma tabela relacionada na camada de feição ou a tabela não existe. Assegure que sua repetição tenha o mesmo nome que a tabela de destino relacionada. |
Erros do portal
Pesquisas publicadas no ArcGIS Enterprise têm as limitações listadas abaixo, que diferem daquelas publicadas no ArcGIS Online.
- Você não pode publicar pesquisas no ArcGIS Enterprise que utilizam determinadas palavras-chave reservadas como nomes de campo, como end (nomes de campo contendo estas palavras-chave são aceitáveis, como endSurvey, desde que não sejam exatamente a palavra-chave). As palavras-chave reservadas são listadas na planilha Reservada dos modelos XLSForm do Survey123.
- Todos nomes de campo devem estar em letras minúsculas ao publicar no ArcGIS Enterprise.
- O número máximo de colunas que uma camada de feição publicada em um portal pode conter depende do seu geodatabase enterprise. Consulte a documentação do seu sistema de gerenciamento de banco de dados para determinar os limites de tamanho. Se o número de perguntas em sua pesquisa exceder o limite de coluna para seu banco de dados geográfico enterprise, a solução alternativa é incluir uma repetição e definir repeat_count para 1 para estender a pesquisa em várias tabelas.
- O nome de uma pergunta na planilha da pesquisa deve ter menos de 32 caracteres.
- Você não pode transferir o conteúdo do Survey123 para ArcGIS Enterprise ou Portal for ArcGIS se você não estiver utilizando o ArcGIS Data Store.
- Quando o ArcGIS Enterprise é desenvolvido em um ambiente desconectado, modelos de levantamento, amostras e URLs de envio para camadas de feição do ArcGIS Online não funcionam.
- As URLs de envio não podem ser utilizadas diretamente com uma camada de feição não federada do ArcGIS Server. Uma solução alternativa é fornecida pelo registrando o serviço com ArcGIS Online ou ArcGIS Enterprise.
- Se estiver usando um geodatabase multiusuário, as camadas podem usar versionamento de ramificação, mas não versionamento tradicional. O Survey123 terá como destino a versão padrão ao usar um geodatabase versionado da ramificação. Para mais informações, consulte Tipos de versionamento.
Habilitar registro de diagnóstico
Se você observar mensagens de erro que não estejam listadas neste tópico ou outro comportamento inesperado, poderá ser útil registrar um log de informações do Survey123 Connect para compartilhar com outra pessoa (como Suporte da Esri) para solucionar problemas.
Para habilitar o registro, abra o menu na página inicial do aplicativo, clique em Configurações e clique na guia Diagnóstico.
Para capturar mensagens em um arquivo, clique no botão Entrar para habilitar o registro. A caixa de texto Local de Saída de Log será automaticamente preenchida com o local do arquivo de log padrão. Você pode editar este caminho do arquivo. Para capturar mensagens para um console compatível com syslog online, insira sua URL na caixa de texto Registrar Local de Saída ao invés do local do arquivo de log.
Os arquivos de log podem ser compartilhados ou enviados por e-mail. Quando você optar por enviar o log por e-mail do aplicativo, o número da versão do aplicativo, o nome do sistema operacional e a localidade do sistema serão incluídos no corpo do e-mail e o log será incluído como um anexo.
Anotação:
Para registro em tempo real, a guia Diagnóstico exibe todas as instâncias de um console doAppStudio atualmente aberto em sua rede. Um símbolo de círculo da pesquisa aparece na guia Diagnósticos até que ele seja localizado e executado no console do AppStudio. Se você primeiro selecionar um console do AppStudio e clicar no botão Entrar, as informações de registro começarão a aparecer neste console. Para mais informações, consulte Capturar saída do console na ajuda do ArcGIS AppStudio.