Com o ArcGIS Survey123 web designer você pode criar pesquisas para o aplicativo da web e o aplicativo de campo usando uma interface de arrastar e soltar. O Survey123 web designer fornece uma ampla variedade de tipos de perguntas que você pode configurar de várias maneiras. Nos bastidores, o web designer usa a especificação XLSForm. Para recursos XLSForm mais avançados, você pode continuar seu projeto no Survey123 Connect. Para mais informações, consulte Fundamentos do XLSForm.
Elementos da pesquisa
As opções na guia Adicionar no web designer Survey123 permitem que você controle a visibilidade dos seguintes elementos:
- Cabeçalho da pesquisa—O cabeçalho aparece na parte superior do formulário e pode ser um texto ou uma imagem. Para um cabeçalho de imagem, forneça a URL de uma imagem hospedada online ou carregue um arquivo de imagem.
- Descrição da pesquisa—A descrição aparece abaixo do cabeçalho e pode conter texto formatado, links e imagens.
- Rodapé da pesquisa—O rodapé aparece abaixo do botão Enviar e pode conter texto formatado, links e imagens.
- CAPTCHA—Um CAPTCHA é um teste exibido no final do formulário que os usuários devem resolver antes de enviar uma resposta. O usuário resolve o CAPTCHA digitando os caracteres mostrados na imagem. Você pode modificar o texto que aparece acima do CAPTCHA clicando-o na visualização do formulário. CAPTCHAs podem ser habilitados ao usar https://survey123.arcgis.com/ e são suportados no Survey123 web app. CAPTCHAs não podem ser configurados quando o site da web Survey123 está instalado na sua infraestrutura, e não são suportados no Survey123 field app.
Clique em um elemento na visualização do formulário para personalizá-lo na guia Editar.
Tipos de perguntas
A tabela a seguir lista os tipos de pergunta que você pode adicionar à sua pesquisa por meio do web designer do Survey123 e como eles são implementados na especificação XLSForm.
Aviso:
Após uma pesquisa que foi criada com o Survey123 web designer ser publicada do Survey123 Connect, você não poderá mais editar as partes da pesquisa gerenciadas pelo XLSForm no web designer. Por exemplo, o título da pesquisa e as perguntas da pesquisa não podem ser editados. Temas, webhooks e opções de compartilhamento ainda podem ser editados no web designer.
| Pergunta do web designer Survey123 | Descrição | Implementação XLSForm |
|---|---|---|
Texto de única linha | Uma caixa de texto com entrada de uma única linha. | Pergunta de texto |
Texto de múltiplas linhas | Uma caixa de texto com várias linhas de entrada. | Pergunta de texto, aparência de várias linhas |
Número | A entrada numérica pode ser um número inteiro ou decimal. | Pergunta inteira ou decimal |
Data | Entrada de data. | Pergunta de data |
Tempo | Entrada de hora. | Pergunta de tempo |
Data e Hora | Entrada de data e hora. | Pergunta DateTime |
Uma caixa de texto limitada rejeita todas as entradas que não sejam na forma de um endereço de e-mail. | Pergunta de texto com restrição de expressão regular | |
Site da Web | Uma caixa de texto limitada rejeita todas as entradas que não estejam na forma de uma URL de site. | Pergunta de texto com restrição de expressão regular |
Seleção única | Pergunta de múltipla escolha; apenas uma opção pode ser selecionada. | Pergunta Select_one |
Múltipla seleção | Pergunta de múltipla escolha; múltiplas escolhas podem ser selecionadas. | Pergunta Select_multiple |
Grade de seleção única | Série de perguntas de múltipla escolha com escolhas idênticas; apenas uma opção pode ser selecionada para cada um. | Múltiplas perguntas select_one usando a mesma lista de escolha, em um grupo usando aparência de lista de tabela |
Suspensa | Pergunta de múltipla escolha com opções exibidas em uma lista suspensa; apenas uma opção pode ser selecionada. | Pergunta Select_one, aparência mínima ou opção de auto completar |
Escala Likert | Pergunta de múltipla escolha; selecione uma de uma série de opções usando uma escala simétrica concordo-discordo. | Pergunta select_one, aparência Likert |
Classificação | Pergunta de múltipla escolha; selecione um de uma série de números. | Pergunta Select_one |
Classificação | Uma lista de opções que podem ser solicitadas. | Pergunta de classificação |
Mapa | Coleta um ponto, linha ou polígono no mapa. | Pergunta de ponto geográfico, traço geográfico, forma geográfica |
Endereço | Uma caixa de texto usada para localizar um endereço. Anotação:A geocodificação de endereços usando ArcGIS World Geocoding Service consumirá créditos. Para mais informações, consulte Entender os créditos. | Pergunta de texto, aparência do geocódigo |
Imagem | Tire uma ou mais fotos com a câmera ou carregue arquivos de imagem do dispositivo. | Pergunta de imagem, potencialmente com aparência de várias linhas |
Transferência de arquivo | Aceita um arquivo no dispositivo. | Pergunta de arquivo |
Áudio | Grave ou carregue um arquivo de áudio. | Pergunta de áudio |
Assinatura | Aceita uma entrada de desenho destinada a uma assinatura. | Pergunta de imagem, aparência de assinatura |
Nota | Exibe o texto na tela. | Pergunta de anotação |
Página | Apresenta as perguntas em uma página separada. | Comece o grupo e termine as perguntas do grupo, estilo das páginas |
Grupo | Organiza as perguntas em grupo. | Comece o grupo e termine as perguntas do grupo |
¹ Os nomes de opção são limitados a 31 caracteres. Os caracteres adicionais serão truncados.
Após configurar uma pergunta, alguns tipos de perguntas suportam a mudança para outro tipo que tenha o mesmo tipo de campo subjacente. Por exemplo, talvez queira alterar uma pergunta de seleção única para uma pergunta Suspensa após já ter configurado todas as opções. Para alterar o tipo de pergunta de uma pergunta existente, clique-a na visualização do formulário para abrir a guia Editar, clique no botão Alterar tipo de pergunta 
na parte superior do painel e escolha na lista de tipos de pergunta suportados. Após a publicação, alguns tipos de perguntas não poderão ser selecionados na lista. Para mais informações, consulte Atualizar uma pesquisa. Ao alterar o tipo de pergunta, as configurações comuns são preservadas, como validação e comportamento, para que você não precise reconfigurar a pergunta.
Opções de pergunta
Ao adicionar uma pergunta à sua pesquisa, há várias opções adicionais disponíveis para alterar como a pergunta aparecerá ou se comportará quando a pesquisa for preenchida e enviada por um usuário. Essas opções são refletidas na especificação XLSForm.
A seguir estão as descrições das opções disponíveis para vários tipos de perguntas; no entanto, nem todas essas opções estão disponíveis para todos os tipos de pergunta. Para obter informações sobre as opções disponíveis apenas para tipos de perguntas específicos, consulte a referência rápida.
Opções gerais e de aparência
| Opção | Perguntas aplicáveis | Descrição | XLSForm equivalente |
|---|---|---|---|
Valor padrão | Todos, exceto para Imagem, Transferência de arquivo, Áudio, Nota, Página e Grupo | O valor padrão estará presente na abertura da pesquisa, embora o valor possa ser editado. | Forneça um valor na coluna padrão. |
Cálculo | Texto de única linha, Texto de múltiplas linhas, Número, Mapa, Data e, Data e Hora | O campo será pré-preenchido com o resultado de uma expressão, potencialmente incluindo respostas a outras perguntas. O botão Editar permite que você construa cálculos numéricos, incluindo campos de data e hora, concatenações de strings e extração de dados de outras partes da pesquisa. Para mais informações, consulte Cálculos. | Forneça uma expressão na coluna de cálculo. |
Mostrar opções em ordem aleatória | Única seleção, múltipla seleção, Lista Suspensa e Classificação | As opções para esta pergunta serão exibidas em uma ordem aleatória. | Defina a coluna parâmetros para randomize. |
Permitir "Outro" | Única seleção, Múltipla seleção e Lista Suspensa | Uma outra opção adicional estará disponível, o que revelará uma caixa de texto adicional quando selecionada. | Adicione or_other ao tipo de pergunta. |
Valor Máximo | Classificação e Escala de Likert | Define a quantidade máxima de respostas possíveis para a pergunta. | O número de opções na lista de opções de uma pergunta select_one. |
Localizador | Endereço e Mapa | Define o serviço localizador a ser usado para a pergunta. Se não estiver definido, usa o padrão da organização. | Defina a coluna de aparência de uma pergunta de texto para geocode, e defina o parâmetro geocode para o ID do item do serviço localizador na coluna bind::esri:parameters. |
Vertical, Horizontal e Horizontal (compacto) | Única seleção e Múltipla seleção | Determina se as opções da pergunta serão apresentadas verticalmente, horizontalmente ou horizontalmente, com cada escolha recebendo apenas o espaço necessário para seu rótulo. | Defina a coluna aparência para a pergunta permanecer em branco, horizontal, ou horizontal-compact. |
Opções de validação
| Opção | Perguntas aplicáveis | Descrição | XLSForm equivalente |
|---|---|---|---|
Esta é uma pergunta exigida | Todos exceto Nota, Página e Grupo | Uma resposta deve ser fornecida a esta pergunta para enviar a pesquisa. | Defina a coluna exigido desta pergunta para true. |
Restrição | Texto de única linha, Texto de múltiplas linhas, Número, Data, Data e Hora, E-mail, Site, Código de barras, Seleção múltipla, Mapa, Endereço, Imagem, Carregar arquivo | O usuário é obrigado a fornecer uma resposta com base nas restrições especificadas por uma expressão ou combinação de expressões. Quando a condição especificada não for atendida, o formulário exibirá uma mensagem informativa, que você pode personalizar. | Use expressões na coluna de restrição. |
Limite de tamanho de único arquivo | Imagem e Transferência de imagem | Define um tamanho máximo de arquivo, em megabytes, para um único arquivo enviado à pergunta. Isso não é suportado no Survey123 field app. | Forneça um valor para max-size na coluna bind::esri:parameters. |
A seguir estão exemplos de especificação de restrições com regras para restringir respostas:
- Para perguntas de entrada de Data e Hora, limite as respostas a um intervalo específico definido para a pergunta.
- Para perguntas de entrada de Texto, defina uma contagem mínima e máxima de caracteres para que o usuário seja obrigado a fornecer uma resposta pelo menos tão longa quanto a contagem mínima de caracteres e não mais que a contagem máxima de caracteres.
- Para perguntas sobre Carregar imagens e arquivos, especifique uma contagem de arquivos para que o usuário seja obrigado a carregar uma quantidade mínima, máxima ou exata de imagens ou arquivos conforme o número fornecido. No XLSForm, isso é feito definindo a coluna de aparência da pergunta para multiline e usando uma expressão count-selected na coluna de restrição.
Outras opções
- Resposta de cache—Após a pesquisa ser enviada, essa resposta será preenchida automaticamente na próxima vez que o usuário abrir a pesquisa. Não tem equivalente em XLSForm, mas oSurvey123 field app oferece a opção de definir e aplicar respostas favoritas que funcionam de forma semelhante.
- Somente leitura—O usuário não consegue responder a esta pergunta. A pergunta só pode conter padrões ou resultados de cálculos. No XLSForm, isso é feito definindo a coluna de somente leitura desta pergunta para yes.
- Ocultar da pesquisa—O usuário não consegue ver esta pergunta, mas a pergunta ainda pode armazenar respostas preenchidas por padrões ou cálculos. Esta opção está disponível apenas para perguntas que suportam padrões ou cálculos. No XLSForm, isso é feito definindo a coluna aparência desta pergunta para hidden.
- Não enviar a resposta—Esta pergunta não terá um campo na camada de feição e a resposta à pergunta não será enviada. No XLSForm, isso é feito definindo a coluna bind::esri:fieldType desta pergunta para null.
Rótulos dinâmicos
Notas, rótulos, dicas e tela de agradecimento em sua pesquisa podem exibir o conteúdo de outra pergunta referindo ao nome da pergunta no texto utilizando o formato ${field_name}. Isto pode ser útil para exibir o conteúdo de campos que não precisam ser expostos caso contrário, tal como, cálculos baseados em respostas anteriores ou o nome de uma pessoa sendo pesquisada a partir de uma pergunta anterior no rótulo da próxima pergunta.
Ao editar um rótulo, clique no botão inserir valor da pergunta 
para exibir uma lista de perguntas que podem ser referenciadas.
Os cálculos não podem ser apresentados em um rótulo ou sugestão. Para exibir os resultados de um cálculo, certifique-se que o cálculo esteja em uma pergunta.
Aviso:
Rótulos dinâmicos não são suportados em listas de opções.
Cálculos
Você pode calcular a resposta a uma pergunta usando outras perguntas em sua pesquisa ou propriedades da pesquisa. Para criar ou editar um cálculo para uma pergunta, clique em Editar ao lado da opção Cálculo.
Os seguintes tipos de pergunta suportam cálculos:
- Texto de única linha
- Texto de múltiplas linhas
- Número
- Data
- Data e Hora
- Mapa
Por exemplo, a localização de uma pergunta de mapa pode ser usada para preencher uma pergunta de texto de única linha. Da mesma forma, a localização de uma pergunta de mapa pode ser derivada dos metadados EXIF de uma foto enviada a uma pergunta de imagem. No exemplo a seguir, a pergunta de mapa denominada Localização é preenchida pela Localização a partir do EXIF da pergunta Foto:
Ao configurar a Origem para Camada, é possível consultar uma camada de feição ou tabela do ArcGIS e usar o resultado da consulta como a resposta da pergunta. Você pode realizar uma consulta de atributo ou uma consulta espacial. No exemplo a seguir, a pergunta de texto denominada País é preenchida com o Nome do País da camada de feição Países do Mundo. Na pesquisa, os usuários especificam uma localização em uma pergunta de mapa denominada Localização, e o país onde a localização se encontra é retornado da camada de feição.
Ao usar cálculos para criar uma string, as perguntas que estão sendo referenciadas devem ter o operador joins colocado antes e depois delas, a menos que no início ou no final do cálculo. O texto pode ser inserido livremente fora dessas perguntas.
Aviso:
Expressões matemáticas com valores vazios não serão avaliadas e a pergunta que contém a expressão permanecerá vazia. Considere atribuir um valor padrão de 0 às perguntas de número que contêm uma expressão.
Propriedades do dispositivo e usuário
A tabela a seguir lista as propriedades do dispositivo e do usuário que podem ser referenciadas por cálculos:
| Propriedade | Descrição |
|---|---|
Nome de Usuário | Nome de usuário da conta organizacional do ArcGIS do usuário conectado no momento. |
Nome completo do usuário | Nome e sobrenome do usuário conectado no momento. |
Nome do usuário | Nome do usuário conectado no momento. |
Sobrenome do usuário | Sobrenome do usuário conectado no momento. |
E-mail do usuário | Endereço de e-mail da conta organizacional do ArcGIS do usuário atualmente conectado. |
| Idioma | Idioma usado na pesquisa atual. |
| Deslocamento UTC | Deslocamento em horas a partir do UTC para o fuso horário local. |
Agente de usuário | String de agente do usuário para o dispositivo do usuário. |
Regras de visibilidade
A visibilidade de uma pergunta pode ser definida para estar sempre visível (marcada), sempre não visível (desmarcada) ou definida por uma regra.
Clique em Definir regra para criar uma regra de visibilidade e escolher outra pergunta na pesquisa cuja resposta controlará a visibilidade da pergunta selecionada. Quando a regra de visibilidade não for atendida, o autor poderá escolher se as respostas serão enviadas. Optar por não enviar a resposta é o mesmo que usar a coluna relevante no XLSForm. Optar por enviar a resposta é o mesmo que usar a coluna bind::esri:visible no XLSForm.
Quando a visibilidade da pergunta é controlada por uma regra de visibilidade, a opção Visível aparece como estado indeterminado (parcialmente marcada).
Você pode copiar uma regra de visibilidade para uma ou mais perguntas em uma pesquisa. Para copiar uma regra de visibilidade, selecione a pergunta que tem a regra aplicada e clique em Definir regra. No painel Regra de visibilidade, clique no botão Copiar regra de visibilidade 
. Selecione as perguntas de destino para as quais você deseja copiar a regra. As regras de visibilidade existentes serão substituídas.
Anotação:
Para perguntas do tipo Imagem, Carregar arquivo, Áudio e Assinatura, as respostas não podem ser enviadas quando a pergunta não estiver visível.