Com o web designer do ArcGIS Survey123, você pode criar pesquisas para o aplicativo da web e o aplicativo de campo usando uma interface de arrastar e soltar. O web designer do Survey123 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 como um hiperlink. Forneça o texto e uma URL para o hiperlink.
- 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 que são 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 do 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 apenas 31 caracteres. Os caracteres adicionais serão truncados.
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. |
Limite para o seguinte intervalo | Perguntas de entrada de data e hora | As respostas são limitadas ao intervalo específico definido para a pergunta. | Use expressões na coluna de restrição. |
Definir a contagem mínima e máxima de caracteres | Perguntas de inserção de texto | O usuário deve fornecer uma resposta com pelo menos a contagem mínima de caracteres e não mais do que a contagem máxima de caracteres. | Use expressões na coluna de restrição. |
Especificar contagem de arquivos | Imagem e Transferência de imagem | O usuário deve carregar a quantidade exata de imagens ou arquivos conforme o número fornecido. | Defina a coluna aparência desta pergunta para multiline e utilize uma expressão count-selected na coluna restrição. |
Definir a contagem mínima e máxima de arquivo | Imagem e Transferência de imagem | O usuário deve fornecer pelo menos imagens ou arquivos com a contagem mínima de arquivos e não mais do que a contagem máxima de arquivos. | Defina a coluna aparência desta pergunta para multiline e utilize uma expressão count-selected na coluna 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. |
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 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. Se você desejar exibir os resultados de um cálculo, certifique-se que o cálculo está 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, você pode 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 ou não. 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.
O botão Copiar regra de visibilidade permite que o autor aplique a mesma regra de visibilidade a várias perguntas. Quando a visibilidade da pergunta é controlada por uma regra de visibilidade, a opção Visível aparece como estado indeterminado (parcialmente marcada).
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.