Fundamentos do web designer

Com o ArcGIS Survey123 web designer você pode criar pesquisas para Survey123 Mobile, o aplicativo da web Survey123 e o aplicativo de campo Survey123 usando uma interface de arrastar e soltar.

Anotação:

Os botões de desfazer e refazer afetam a maioria das ações no web designer. As exceções incluem clicar no botão Visualizar nos painéis Idiomas e Opções, e o momento no qual o mapa é carregado após a adição de uma pergunta de mapa.

O Survey123 web designer fornece uma 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.

O assistente Survey123 também pode ser usado para criar uma pesquisa usando uma conversa.

Elementos da pesquisa

As opções no painel Adicionar no Survey123 web designer permitem controlar 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.

Clique em um elemento na visualização do formulário para personalizá-lo no painel de configurações.

CAPTCHA

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 aplicativo da web Survey123. CAPTCHAs não podem ser configurados quando o site Survey123 está instalado na sua infraestrutura. Eles não são suportados no aplicativo de campo Survey123.

Por questões de usabilidade e acessibilidade, um CAPTCHA não diferencia letras maiúsculas de minúsculas.

Tipos de perguntas

A tabela abaixo lista os tipos de pergunta que você pode adicionar à sua pesquisa por meio do Survey123 web designer e como eles são implementados na especificação do XLSForm.

Aviso:

Após uma pesquisa criada com o Survey123 web designer ser publicada a partir 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, número, data e hora
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 que pode ser um número inteiro ou decimal.	Pergunta inteira ou decimal
Controle deslizante	Entrada inteira ou decimal em um intervalo especificado.	Questão de intervalo
Data	Entrada de data.	Pergunta de data
Tempo	Entrada de hora.	Pergunta de tempo
Data e Hora	Entrada de data e hora.	Pergunta DateTime
E-mail	Uma caixa de texto limitada que 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 que 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
Código de barras	Escaneia um código de barras com a câmera do dispositivo.	Pergunta de código de barras
Escolher
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; uma ou várias opções podem ser selecionadas, dependendo de como a lista de opções estiver configurada.	Pergunta select_one ou select_multiple, aparência minimal ou autocomplete
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
Avaliaçã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
Local
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: Os endereços de geocodificação usando ArcGIS World Geocoding Service consomem créditos. Para mais informações, consulte Entender os créditos.	Pergunta de texto, aparência do geocódigo
Lista de locais	Permite ao usuário escolher uma localização em uma lista suspensa, com a opção enviada como texto e sua geometria correspondente enviada como a localização para a resposta da pesquisa.	A pergunta select_one com aparência de preenchimento automático e pesquisa, combinada com uma pergunta oculta de ponto geográfico, traçado geográfico ou forma geográfica com um cálculo.
Mídia e arquivos
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	Carrega um arquivo no dispositivo.	Pergunta de arquivo
Áudio	Grave ou carregue um arquivo de áudio.	Pergunta de áudio
Assinatura	Usa uma entrada de desenho para uma assinatura.	Pergunta de imagem, aparência de assinatura
Exibição e estrutura
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 uma grade.	Comece o grupo e termine as perguntas do grupo
Repetir	Captura de um conjunto de perguntas várias vezes dentro de uma única resposta da pesquisa.	Perguntas de repetição inicial e repetição final

¹ 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 o painel de configurações, clique no botão Alterar tipo de pergunta na parte superior 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.

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 Multiple select não contenham espaços ou vírgulas.

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 seguintes seções contêm 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 informações sobre opções, consulte Tipos de consulta.

Opções gerais e de aparência

A tabela a seguir descreve as opções gerais e de aparência:

Opção	Perguntas aplicáveis	Descrição	XLSForm equivalente
Valor padrão	Todas as opções, exceto Código de barras, Imagem, Transferência de arquivo, Áudio, Assinatura, Nota, Página, Grupo e Repetição.	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	Todas as opções, exceto Hora, Código de barras, Grade de seleção única, Lista de locais, Imagem, Transferência de arquivo, Áudio, Assinatura, Página, Grupo e Repetição	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, o padrão da organização será utilizado.	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	Especifica se as opções da pergunta serão apresentadas verticalmente, horizontalmente ou horizontalmente com cada opção 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

A tabela a seguir descreve as opções de validação:

Opção	Perguntas aplicáveis	Descrição	XLSForm equivalente
Esta é uma pergunta exigida	Todas, exceto Nota, Página, Grupo e Repetição	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

A seguir, estão as opções na seção Outros:

• 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 fornecer uma responder a esta pergunta. A pergunta pode conter somente valores padrão 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 visualizar esta pergunta, mas a pergunta ainda pode armazenar respostas preenchidas por valores padrão ou cálculos. Esta opção está disponível apenas para perguntas que suportam valores padrão 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 não suportam cálculos:

• Tempo
• Código de barras
• Grade de seleção única
• Lista de locais
• Imagem
• Transferência de arquivo
• Áudio
• Assinatura
• Página
• Grupo
• Repetir

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 pelo valor 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 abaixo, a pergunta de texto denominada País é preenchida com o valor 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, conforme mostrado no exemplo abaixo. 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.

Modo de cálculo

O modo de cálculo determina quando o cálculo será ativado, conforme segue:

• Automático—calcule quando a pergunta está vazia ou não foi modificada anteriormente pelo usuário. Este é o comportamento de cálculo padrão.
• Manual—a pergunta calculará somente quando o botão Calcular ao lado da pergunta for pressionado.
• Sempre—calcule quando qualquer valor referenciado na expressão de cálculo for alterado. Isso inclui funções dinâmicas, como now().
• Quando vazio—calcule até que um valor não vazio seja retornado. Assim que um valor não vazio for retornado, a pergunta se comportará da mesma forma que no modo manual. Os cálculos que contêm funções dinâmicas, como now(), não serão recalculados a menos que o botão Calcular seja pressionado. O modo Quando vazio é útil quando você não deseja que uma pergunta que já foi calculada com um valor não vazio seja atualizada quando o formulário for recarregado, por exemplo, ao abrir o formulário a partir da Caixa de entrada no aplicativo de campo Survey123 ou ao usar o modo de edição no aplicativo da web Survey123.

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.
URL de Envio	A URL da camada de serviço da feição (ou camada pricipal do formulário quando há repetições) para a qual a pesquisa é enviada.

Cálculos de análise (beta)

Anotação:

Os cálculos de análise são suportados apenas no aplicativo da web. Para utilizar os cálculos de análise, o entrevistado deve estar conectado à mesma organização do ArcGIS a partir da qual a pesquisa foi publicada.

A análise de imagens, a análise de texto e a transcrição de áudio baseadas em IA são configuradas no web designer utilizando cálculos.

Para qualquer pergunta de destino, você pode inserir um prompt personalizado para extrair automaticamente informações específicas de uma pergunta de imagem, texto ou áudio de origem.

Exemplos de cenários de análise de imagem incluem o seguinte:

• Um entrevistado da pesquisa anexa uma foto de um documento de identidade à pesquisa, e o formulário preenche automaticamente o nome, a data ou o endereço de e-mail nos campos correspondentes.
• Um inspetor de trânsito tira uma foto de uma placa de rua e a pesquisa insere automaticamente o tipo e a condição da placa nas perguntas corretas.

Exemplos de cenários de análise de texto incluem o seguinte:

• Um técnico insere informações de forma livre descrevendo o trabalho realizado, e o formulário extrai detalhes importantes para perguntas específicas.
• Um entrevistado da pesquisa fornece um comentário em um idioma diferente do inglês, e uma tradução da resposta é salva em outra pergunta da pesquisa, em inglês.

A transcrição de áudio é normalmente utilizada em conjunto com a análise de texto. Exemplos de cenários incluem o seguinte:

• Um agente de saúde ambiental registra comentários em áudio durante a inspeção de um restaurante; o formulário transcreve o áudio para uma pergunta de texto e utiliza análise de texto para extrair o sentimento da inspeção para outra pergunta.
• Um entrevistador registra uma resposta em um idioma diferente do inglês. O formulário transcreve o áudio no idioma original e utiliza análise de texto para traduzi-lo para o inglês em outra pergunta.

Para obter mais informações sobre esse recurso beta, consulte o blog da comunidade Torne seus formulários do Survey123 mais inteligentes com análise de imagem, texto e áudio com IA.

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 com 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.

Criar uma pesquisa usando uma conversa

O assistente Survey123 usa IA generativa para ajudá-lo a criar um design de pesquisa que você poderá refinar de forma manual posteriormente. O assistente a fazer o seguinte:

• Converter uma ideia em uma lista de perguntas.
• Adicionar, modificar e remover perguntas ou opções de escolha.
• Gerar uma pesquisa a partir de uma lista de perguntas.

Atualmente, o assistente não pode gerar pesquisas multilíngues ou pesquisas que usem um tipo de pergunta de lista de localização, repetições, cálculos, regras de visibilidade ou restrições. Você pode adicioná-los à sua pesquisa após ela ser gerada.

Ao iniciar, selecione o assistente do Survey123 para criar um rascunho de pesquisa.

Alternativamente, ao iniciar uma pesquisa em branco, clique no assistente do Survey123 para criar um rascunho de pesquisa.

Aviso:

Se você já tiver um design de pesquisa em vigor, usar o assistente substituirá o design existente.

Prompts

Selecione um prompt de exemplo ou insira seu próprio prompt para gerar sugestões. Use os exemplos fornecidos como um recurso para criar seus próprios prompts. Um prompt bem formado é claro e específico, os seguintes são exemplos:

• Criar um formulário de inspeção de hidrante.
• Criar uma pesquisa para relatar árvores perigosas na cidade.
• Criar uma pesquisa para coletar comentários dos cidadãos sobre um grande evento em sua área.

Após o modelo da pesquisa de amostra ser exibido, você poderá continuar a refiná-lo com prompts adicionais ou editando seu prompt. Quando estiver satisfeito com o design da pesquisa, clique no botão Gerar.

Após a pesquisa aparecer no web designer, você poderá continuar adicionando perguntas ou modificando perguntas existentes usando a interface de arrastar e soltar.