O ArcGIS Survey123 suporta uma grande quantidade de especificações do XLSForm. Este guia de referência fornece um resumo de recursos do XLSForm que você pode utilizar no Survey123. As pesquisas podem ser criadas no Survey123 Connect ou site da web Survey123 ; alguns recursos estão disponíveis somente em um ou outro, e alguns estão disponíveis em ambos.
Tipos de perguntas
A tabela a seguir descreve os tipos de perguntas disponíveis noSurvey123 Connect, o Survey123 field app, o Survey123 web designer e Survey123 web app. Em algumas perguntas, há diferenças de comportamento e implementação entre plataformas; para as diferenças, consulte as notas após a tabela.
| Tipo de perguntas do Survey123 Connect | Tipo de pergunta do designer da web do Survey123 | Descrição | Suportado no Survey123 field app | Suportado no Survey123 web app |
|---|---|---|---|---|
| áudio⁴ | Áudio⁴ ⁶ | Grava um clipe de áudio no aplicativo de campo. Grava um clipe de áudio ou aceita um arquivo de áudio carregado no aplicativo da web. | Sim | Sim |
| código de barras | Escaneia um código de barras ou código QR. | Sim | Sim | |
| começar grupo | Inicia um grupo de perguntas. | Sim | Sim | |
| begin repeat | Não Aplicável | Inicia um conjunto de repetições de perguntas. | Sim | Sim |
| calcular | Não Aplicável | Executa um cálculo em valores no formulário. O campo de cálculo contém o resultado do cálculo. | Sim | Sim |
| decimal¹ | Entrada de decimal. | Sim | Sim | |
| data | Entrada de data. | Sim | Sim | |
| dateTime | Entrada de data e hora. | Sim | Sim | |
| ID de dispositivo | Não Aplicável | O UUID representando o dispositivo específico no qual a pesquisa foi realizada. | Sim | Não |
| e-mail² | Não Aplicável | Quando registrado com uma conta organizacional, esta pergunta é automaticamente preenchida com o endereço de e-mail da conta. | Sim | Sim |
| finalizar | Não Aplicável | Finaliza a data e hora da pesquisa. | Sim | Sim |
| finalizar grupo | Finaliza um grupo de perguntas. | Sim | Sim | |
| finalizar repetição | Não Aplicável | Finaliza um conjunto de repetições de perguntas. | Sim | Sim |
| arquivo | Aceita um arquivo no dispositivo. | Sim | Sim | |
| ponto geográfico³ | Coleta uma coordenada de GPS fornecida. Este padrão é a localização atual. | Sim | Sim | |
| forma geográfica³ | Coleta um polígono no mapa. | Sim | Sim | |
| traçado geográfico³ | Coleta uma linha no mapa. | Sim | Sim | |
| oculto | Não Aplicável | Cria um campo em sua camada de feição que não é exibida no formulário. Utilize as colunas bind::esri:fieldType e bind::esri:fieldLength para especificar o esquema de dados para este campo. | Sim | Sim |
| inteiro¹ | Entrada de número inteiro. | Sim | Sim | |
| imagem | Aceita uma imagem dos arquivos do dispositivo ou uma foto tirada diretamente. | Sim | Sim | |
| anotação | Exibe o texto na tela. Nota também pode lidar com cálculos ocultos. | Sim | Sim | |
| intervalo | Controle Deslizante⁶ | Entrada para um intervalo de números fornecidos. | Sim | Sim |
| rank list_name | Pergunta de classificação; solicita uma lista de opções. Substitua list_name pelo nome da sua lista de opções. | Sim | Sim | |
| select_one list_name | Lista Suspensa⁵ ⁶, Escala de Likert⁵ ⁶, Classificação⁶, Única seleção⁶,Grade de única seleção⁶ | Pergunta de múltipla escolha; somente uma resposta pode ser selecionada. Substitua list_name pelo nome da sua lista de opções. | Sim | Sim |
| select_one_from_file file_name.csv | Não Aplicável | Pergunta de múltipla escolha; somente uma resposta pode ser selecionada. Substitua file_name.csv pelo nome do arquivo localizado na pasta de mídia da pesquisa que contém a lista de opções. | Sim | Sim |
| select_multiple list_name | Pergunta de múltipla escolha; múltiplas respostas podem ser selecionadas. Substitua list_name pelo nome da sua lista de opções. | Sim | Sim | |
| select_multiple_from_file file_name.csv | Não Aplicável | Pergunta de múltipla escolha; múltiplas respostas podem ser selecionadas. Substitua file_name.csv pelo nome do arquivo localizado na pasta de mídia da pesquisa que contém a lista de opções. | Sim | Sim |
| iniciar | Não Aplicável | Inicia a data e hora da pesquisa. | Sim | Sim |
| texto | Endereço⁶, E-mail⁶, Texto de múltiplas linhas⁵ ⁶, Texto de única linha⁶, Site da web⁶ | Resposta de texto livre. Uma expressão regular é aplicada no E-mail e Site da Web. A aparência do geocódigo é aplicada ao Endereço. | Sim | Sim |
| hora | Entrada de hora. | Sim | Sim | |
| username | Não Aplicável | Quando registrado com uma conta organizacional, esta pergunta é automaticamente preenchida com o nome do usuário da conta. | Sim | Sim |
¹O designer da web combina perguntas inteiro e decimal em um tipo de pergunta única denominado Número. Uma caixa de seleção nas propriedades da pergunta permita ao designer da pesquisa para definir qual entrada é exigida.
²Os tipos de perguntas de e-mail fornecidos no Survey123 Connect e Survey123 designer da web são implementados diferentemente. A implementação no Survey123 Connect preenche automaticamente com o endereço de e-mail da conta organizacional que o usuário é registrado. A implementação no Survey123 web designer é , ao contrário, um campo de texto que somente aceita formatação que corresponda a um endereço de e-mail.
³As perguntas de ponto geográfico, traço geográfico e forma geográfica foram combinadas em um único tipo de pergunta denominada Mapa. Uma caixa de seleção nas propriedades da pergunta permita ao designer da pesquisa para definir qual entrada é exigida. Perguntas de ponto geográfico, geográfico e forma geográfica foram combinadas em um único tipo de pergunta denominada Mapa.
⁴As perguntas de áudio não permitem transferir no Survey123 field app como no aplicativo da web. Para permitir a transferência de áudio no aplicativo de campo, use uma pergunta File.
⁵Diversas aparências disponíveis no Survey123 Connect estão ao contrário, disponíveis como tipos de perguntas separadas no Survey123 web designer. Estas incluem texto de Múltiplas Linhas, Lista Suspensa e Escala de Likert.
⁶Para cada pergunta, o web designer oferece uma opção de armazenar a resposta em cache. No aplicativo da web, após o envio de um registro de pesquisa, a resposta à pergunta será armazenada em cache no navegador e pré-carregada no próximo envio feito para esta pesquisa no dispositivo. O armazenamento em cache de uma resposta pode ser definido para todos os tipos de pergunta, exceto Áudio, Imagem, Transferência de arquivo e Assinatura.
Valores padrão
A maioria dos tipos de pergunta permitem que você defina uma resposta padrão que será automaticamente utilizada quando a pesquisa for carregada. Isto tem o mesmo propósito que a coluna padrão no XLSForm.
Validação dos dados
Marcar a opção Esta é uma pergunta exigida na guia Editar faz com que a pergunta da pesquisa exija que a pergunta contenha um valor antes que o formulário possa ser finalizado.
A maioria das perguntas também têm funcionalidade para configurar um comprimento mínimo e máximo. Isto evita que a pesquisa seja enviada a menos que a resposta para a pergunta esteja dentro dos limites definidos. Esta função tem o mesmo papel que qualquer coluna restrição ou bind::esri:fieldLength na especificação de XLSForm do Survey123 .
Caracteres especiais
Nomes de perguntas e nomes de opções não devem conter caracteres especiais, como espaços, vírgulas, hífens, parênteses, colchetes ou caracteres como $, % e #. É importante que os nomes das opções para perguntas de Seleção múltipla não contenham espaços ou vírgulas.