O XLSForm suporta as perguntas de select_one (seleciona somente uma resposta), select_multiple (seleciona múltiplas respostas), e rank (ordena uma lista de opções). Escrever uma pergunta de múltipla escolha exige a adição de uma planilha de opções no livro de tarefas do Excel. A seguir está um exemplo de uma pergunta select_one:
Note que yes_no na planilha da pesquisa deve corresponder à yes_no na coluna de nome da lista na planilha de opções. Isto garante que o formulário exiba a lista correta de opções da resposta para uma pergunta em particular.
Por padrão, quando uma pesquisa é publicada, as opções em perguntas select_one são adicionadas à camada de feição da pesquisa como domínios de valor codificado. Você pode desabilitar a criação de domínios durante o processo de publicação. Para mais informações, consulteOpções de publicação.
Quando você modifica as opções para perguntas select_one e republica a pesquisa, o Survey123 Connect exibe um resumo das alterações e permite que você decida se essas alterações devem ser aplicadas aos domínios na camada de feição. Para mais informações, consulte Atualizar uma pesquisa.
Aviso:
A seguir estão as limitações ao usar uma lista de opções com nomes de opções duplicados:
- Nomes de opções duplicados não são suportados para perguntas select_multiple.
- Não há suporte para nomes de opções duplicados para pesquisas multilíngues.
- A função jr:choice-name() retorna o rótulo da primeira opção duplicada na lista.
- Quando aberto das pastas Caixa de Entrada, Rascunhos, Caixa de Saída, Enviado ou Visão Geral, perguntas select_one revertem para a primeira opção duplicada na lista.
Você também pode adicionar perguntas de múltipla escolha que permitem selecionar várias respostas, como as seguintes:
Por padrão, estas opções aparecem na ordem fornecida na planilha de opções. Em vez disso, você pode randomizar a ordem na qual estas opções aparecem digitando randomize=true na coluna de parâmetros.
Aviso:
Todos os valores coletados em uma pergunta select_multiple ou rank são salvos como uma lista separada por vírgula, então evite utilizar vírgulas na coluna de nome da sua lista de opções. Note também que perguntas select_multiple e rank somente enviam o nome de uma opção para o serviço da feição, ao invés do nome e rótulo enviados pelas perguntas select_one.
O valor de uma pergunta de rank permanece vazio até que a ordem de escolha seja modificada pelo usuário. Se um valor padrão tiver sido definido, a ordem padrão será aplicada, a menos que a ordem de escolha seja modificada pelo usuário.
Uma resposta individual para uma pergunta select_multiple pode ser retornada utilizando a função selected-at . O seguinte retorna o valor do nome da primeira resposta dada por uma pergunta select_multiple:
selected-at(${species}, 0)
Para enviar o rótulo para uma resposta, você pode utilizar a função jr:choice-name. Para obter o valor do rótulo para a segunda resposta dada à mesma pergunta select_multiple, utilize o seguinte:
jr:choice-name(selected-at(${species}, 1), '${species}')
Especificar outro
Para perguntas de múltipla escolha, as pesquisas podem incluir a opção de escolher outra quando a opção desejada não estiver listada. O respondente pode então ser solicitado a especificar a outra opção. Você pode fazer isso no XLSForm usando o método manual ou o método interno. O método integrado é mais rápido e fácil de configurar do que o método manual, mas tem várias limitações.
Método manual
O método manual é recomendado porque permite especificar o nome e o rótulo da outra escolha e o nome e o rótulo da pergunta de texto que coleta a outra resposta. Você pode fornecer traduções para esses nomes e rótulos. Você também pode aplicar restrições e aparências à pergunta de texto e torná-la obrigatória.
Primeiro, adicione uma outra opção à lista de opções para a pergunta na planilha de opções. Especifique um nome e um rótulo para esta opção como faria para qualquer outra opção na lista. No exemplo a seguir, a lista de opções de cores tem uma opção chamada other.
Na planilha de pesquisa, adicione uma pergunta de texto para coletar a outra resposta. Adicione uma expressão relevante para que a pergunta de texto seja relevante apenas quando a outra opção for selecionada. No exemplo a seguir, a pergunta other_color é relevante quando a resposta para a pergunta select_one é outra.
Para pesquisas multilíngues, as perguntas e opções podem ser traduzidas. No exemplo a seguir, as traduções para Francês e Grego são fornecidas na planilha de pesquisa para a pergunta select_one e a pergunta de texto.
As traduções também são fornecidas na planilha de escolhas, inclusive para a outra escolha.
Método embutido
Com este método, o Survey123 Connect cria automaticamente a outra escolha e a pergunta para recolher a outra resposta. Para usar este método, digite or_other após o nome da lista de opções na coluna tipo na planilha de pesquisa. Uma Outra opção é exibida na lista de opções para a pergunta. Quando a opção Outro é selecionada, uma pergunta Especificar outro é mostrada permitindo que os usuários forneçam suas próprias respostas. Para armazenar essa resposta, o Survey123 Connect cria um campo adicional automatically na camada de feição usando o nome da sua pergunta de múltipla escolha seguido por _other, por exemplo, favorite_toppings_other. Consulte o seguinte:
Aviso:
O rótulo para a pergunta Especificar outro não será exibido em outros idiomas além do Inglês.
Se estiver criando uma pesquisa a partir de uma camada de feição existente, o campo para a pergunta Especificar outro não será criado automaticamente e a pesquisa não será publicada. Você deve criar o campo para a pergunta Especificar outro manualmente na camada de feição, com o nome de sua pergunta de múltipla escolha seguido por _other, por exemplo, favorite_toppings_other.
Lista de opções externa
Você pode armazenar listas de opções para as perguntas select_one e select_multiple em um arquivo .csv externo. Isto é ideal para listas de opções muito grandes, pesquisas com diversas listas de opções e listas de opções gerenciadas fora do Survey123. Listas de opções externas não devem ser confundidas com seleções externas, onde as opções devem ser listadas em uma planilha adicional.
O arquivo .csv deve conter as colunas de nome e rótulo.
Anotação:
Se o seu arquivo .csv não tiver um cabeçalho de coluna ou tiver uma vírgula no final das linhas do arquivo, o arquivo não será importado para a pesquisa.
Para melhores resultados, codifique o arquivo .csv usando a codificação de caracteres UTF-8. Se você estiver usando Microsoft Excel para criar seu arquivo .csv, salve-o como CSV UTF-8.
Colunas de rótulos traduzidas podem ser incluídas no arquivo .csv, mas as opções traduzidas serão exibidas apenas no Survey123 Connect e o aplicativo de campo Survey123, não no aplicativo da web Survey123.
Para incluir uma pergunta com uma lista de escolha externa, digite o tipo de pergunta, select_one_from_file ou select_multiple_from_file, e o nome do arquivo .csv, por exemplo, select_one_from_file CoverType.csv. Os nomes dos arquivos diferenciam letras maiúsculas de minúsculas e não permitem espaços.
Há duas maneiras de incluir um arquivo .csv : armazenar o arquivo na pasta media da pesquisa ou vincular a um arquivo .csv hospedado no ArcGIS.
Dica:
Execute a ferramenta Converter listas de opções em CSV para automatizar a migração de listas de opções da planilha de opções para arquivos .csv.
Vincular um arquivo .csv
Para vincular um arquivo .csv de conteúdo do ArcGIS para uma pesquisa, faça o seguinte:
- Certifique-se que o arquivo .csv esteja hospedado no ArcGIS Online ou ArcGIS Enterprise e tenha as mesmas permissões de compartilhamento da pesquisa.
- Certifique-se que a pesquisa seja publicada no ArcGIS antes de tentar vincular o conteúdo.
- No Survey123 Connect, abra a pesquisa e clique na guia Conteúdo Vinculado. Clique no botão Vincular conteúdo, escolha CSV, procure e selecione o arquivo .csv a ser vinculado.
Para que a visualização do formulário mostre as opções do arquivo .csv vinculado, em Survey123 Connect, na guia Conteúdo Vinculado, clique no botão de download 
. Isso adiciona uma cópia do arquivo .csv na pasta de mídia da pesquisa. Os arquivos vinculados são baixados automaticamente com a pesquisa no Survey123 field app.
Se você colocar manualmente o arquivo .csv na pasta de mídia da pesquisa, e posteriormente carregar um arquivo .csv com o mesmo nome no ArcGIS e vinculá-lo à pesquisa, o arquivo .csv na pesquisa será atualizado a partir do conteúdo vinculado (se for mais recente).
Converter listas de opções em CSV
Execute a ferramenta Converter listas de opções em CSV no Survey123 Connect para migrar automaticamente listas de opções especificadas da planilha de opções para novos arquivos .csv na pasta de mídia. A ferramenta também modifica as perguntas correspondentes na planilha da pesquisa para usar os tipos de perguntas select_one_from_file e select_multiple_from_file.
Para executar a ferramenta, faça o seguinte:
- Configure um ambiente Python noSurvey123 Connect para poder executar a ferramenta. Para mais informações, consulte Configurar o Python.
- Abra o XLSForm da pesquisa. Na planilha de opções, adicione uma coluna denominada esri_tool_convert_csv. Adicione um valor sim a pelo menos uma linha para cada uma das listas de opções que você deseja converter em listas de opções externas. Salve e feche o arquivo.
- Em Survey123 Connect, abra a pesquisa, clique em Ferramentas e escolha Converter listas de opções em CSV.
Quando a conversão for concluída, um arquivo .csv será salvo na pasta de mídia para cada lista de opções migrada. O nome do arquivo corresponde ao valor do nome da lista de opções original (coluna list_name). A planilha de opções é atualizada para incluir apenas as listas restantes que não foram migradas. Ele ainda inclui cabeçalhos de coluna personalizados a partir do original. Na planilha de pesquisa, as perguntas select_one e select_multiple aplicáveis são alteradas para select_one_from_file e select_multiple_from_file para fazer referência às novas listas de opções externas. A planilha de opções original é salva em uma planilha choices_backup para que você possa verificar os resultados ou reverter. Você pode manter ou excluir a planilha da cópia de segurança.
A ferramenta não converterá listas de opções usadas em perguntas de classificação, grupos de listas de tabelas ou perguntas com aparência de pesquisa. Nenhuma das perguntas que utilizam essas listas de opções é modificada na pesquisa.
Se a ferramenta detectar perguntas não suportadas, um arquivo .xlsx será criado na pasta de depuração com os nomes da lista de opções afetadas. Você pode encontrar esse arquivo na seguinte pasta:
C:\Users\<username>\ArcGIS\My Survey Designs\<surveyName>\debug\convertchoicelists