O Survey123 suporta as perguntas de select_one (seleciona somente uma resposta), select_multiple (seleciona múltiplas respostas), e rank (ordena uma lista de opções).
Anotação:
Perguntas de classificação são atualmente suportadas apenas no aplicativo de campo e no aplicativo da web.
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:
O nome da lista na planilha de pesquisa yes_no, deve corresponder ao 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.
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.
Para considerações adicionais ao modificar listas de opções em pesquisas existentes, consulte Atualizar uma pesquisa.
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}')
Aparência
Ao definir a coluna aparência como mínima, uma pergunta de seleção é apresentada em um menu suspenso.
Definindo a aparência para horizontal, as opções para uma pergunta de seleção são apresentadas em uma coluna horizontal de largura idêntica.
A aparência compact é semelhante à aparência horizontal mas usa um método diferente para determinar larguras de coluna que podem resultar em escolhas ocupando menos espaço.
Anotação:
No Survey123 Connect, você pode especificar um número máximo de colunas para a aparência compacta fornecendo um número separado por um hífen. Por exemplo, compact-3 limita a pergunta a um máximo de três colunas para perguntas de múltipla escolha em pesquisas utilizadas com o aplicativo de campo ou o aplicativo da web.
As aparências compact e horizontal-compact são idênticas. No aplicativo web Survey123, em vez de usar colunas, essas apresentações dispõem os rótulos de opção de uma pergunta de seleção lado a lado, em linhas, sem espaçamento adicional.
Para uma pergunta de seleção única, definir a coluna de aparência para likert apresenta as opções como uma escala Likert. Uma escala de Likert é uma escala de classificação que permite aos entrevistados especificarem seu nível de concordância em uma escala simétrica de concordância e discordância de uma declaração.
Ao definir a aparência como auto completar, uma pergunta de seleção é apresentada com um campo de texto e um menu suspenso. A inserção de texto no campo limita o menu suspenso a somente respostas que contenham este texto. Isso é útil para listas de opções muito longas.
Anotação:
A aparência auto completar para selecionar várias perguntas somente é suportada com Survey123 Mobile. Não é suportado no aplicativo de campo ou no aplicativo da web.
Ao definir a aparência para pesquisa, Você pode preencher a lista de opções de uma pergunta de seleção com valores de uma tabela CSV localizada na pasta media da pesquisa, ou uma camada de feição ou tabela existente. Para mais informações, consulte Crie uma lista de opções dinâmica usando a aparência de pesquisa.
Ao definir a aparência para image-map, uma pergunta de seleção pode ser apresentada no aplicativo de campo como uma imagem com regiões selecionáveis servindo como opções, utilizando um arquivo SVG. Para mais informações, consulte Trabalhar com arquivos SVG.
Crie uma lista de opções dinâmica usando a aparência de pesquisa.
Anotação:
Esta seção descreve a funcionalidade que está disponível apenas no Survey123 Connect e aplicativo de campo Survey123. Esta funcionalidade não está disponível no Survey123 Studio ou Survey123 Mobile.
Selecione uma e selecione várias perguntas suportam a aparência da pesquisa, que pode ser usada para preencher a lista de opções com valores de uma tabela CSV na pasta media da pesquisa, ou uma camada ou tabela de feição existente. Ao usar a aparência da pesquisa, você ainda deve incluir uma entrada na planilha de opções, mas em vez de listar cada uma das opções, você fará referência ao nome do campo da camada de feição ou tabela existente.
No exemplo a seguir, uma lista de opções chamada us_states é definida na planilha de opções e usará o campo STATE_NAME para o nome da escolha e o rótulo.
No exemplo a seguir, essa lista de opções é então referenciada na planilha de pesquisa da mesma forma que outras listas de opções, mas inclui a expressão de aparência de pesquisa que faz referência à camada de feição existente da qual recuperar as escolhas.
A expressão de aparência da pesquisa deve ser estruturada da seguinte forma, com variáveis separadas por vírgulas:
search(tableName, searchType, searchColumn, searchText, filterColumn, filterText)O parâmetro tableName aceita o nome do arquivo .csv na pasta media da pesquisa, por exemplo, airports ou a URL de uma camada de feição ou camada do serviço de mapa, precedida por um nome do Survey123 para consultar a tabela internamente. Este nome de tabela não precisa corresponder ao nome da camada hospedada, mas porque é assim que se refere Survey123 internamente à sua pesquisa, ele deve ser diferente de todos os outros nomes de tabela e arquivos .csv usados na pesquisa. Opcionalmente, você pode anexar parâmetros de solicitação de consulta ao parâmetro REST de sua camada de feição ou camadas de serviço do mapa para configurar o comportamento da pesquisa. No exemplo a seguir, uma URL da camada de feição é anexada ao parâmetro resultRecordCount para preencher a lista de opções com os primeiros 10 resultados da consulta, com a pesquisa sendo armazenada internamente sob o nome airports:
"airports?url=https://services1.arcgis.com/e7dVfn25KpfE6dDd/arcgis/rest/services/Airports2/FeatureServer/0&resultRecordCount=10"A lista de opções também pode ser filtrada usando uma expressão WHERE. Ao usar o exemplo a seguir como tableName, a lista de opções será filtrada para mostrar apenas estados cujo nome não seja Alabama ou Alasca:"state?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized_Boundaries/FeatureServer/0&where=STATE_NAME
NOT IN('Alabama', 'Alaska')"
Anotação:
Parâmetros de pesquisa que incluam caracteres especiais devem ser codificados se a pesquisa for utilizada no aplicativo da web Survey123. A codificação substitui caracteres especiais (como um caractere curinga na expressão) pelo sinal de porcentagem (%) seguido de seu equivalente hexadecimal.
Os seguintes parâmetros adicionais são opcionais, mas podem ser usados para restringir os resultados fornecidos pela pesquisa:
| Parâmetro | Descrição |
|---|---|
searchType | Controla que tipo de pesquisa é realizada e aceita valores diferentes, dependendo se a tabela que está sendo pesquisada é uma tabela espacial dentro de uma camada de feição ou uma tabela não espacial em um CSV ou tabela de feição. Para tabelas espaciais, os tipos de pesquisa aceitos são intersects, contains, crosses, envelope_intersects, index_intercepts, overlaps, touches ewithin. Para saber mais, consulte Relacionamentos espaciais. Para uma tabela não espacial, os tipos de pesquisa suportados são contains, startswith, endswith e matches. |
searchColumn | Determina a coluna que será pesquisada para o texto no parâmetro searchText. Essas colunas são retiradas da própria tabela. Além disso, uma tabela espacial em uma camada de feição pode pesquisar as colunas @geopoint, @geotrace e @geoshape. |
searchText | Contém o texto que será procurado e retornado no parâmetro searchColumn. |
Além disso, os seguintes parâmetros de filtro podem ser adicionados à expressão de pesquisa para refinar ainda mais os valores da lista de opções:
| Parâmetro | Descrição |
|---|---|
filterColumn | Define uma coluna para procurar correspondências com o texto fornecido no parâmetro filterText. A consulta de pesquisa retornará apenas resultados que contenham esse texto. Os parâmetros filterColumn e filterText devem ser utilizados juntos. |
filterText | O texto que está sendo procurado na coluna fornecida pelo parâmetro filterColumn. Os parâmetros filterColumn e filterText devem ser utilizados juntos. |
O exemplo de expressão de pesquisa abaixo inclui alguns dos parâmetros opcionais para a aparência da pesquisa. Ele preenche uma lista de opções com o conteúdo de um arquivo .csv, usando uma pergunta anterior como texto de pesquisa.
search('csvName', 'matches', 'breed', ${DogQuestion})
Anotação:
As perguntas com a aparência pesquisa são apresentadas no aplicativo da web Survey123 da mesma maneira que as perguntas de seleção com a aparência auto completar.
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 o método integrado, Survey123 Studio e Survey123 Connect criam automaticamente a opção "outro" e a pergunta para coletar a resposta correspondente. 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 esta resposta, Survey123 Studio e Survey123 Connect criam automaticamente um campo adicional na camada de feição usando o nome da sua pergunta de múltipla escolha seguido por _other, por exemplo, favorite_toppings_other. Veja os seguintes exemplos:
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 Studio, Survey123 Connect, Survey123 Mobile e o aplicativo de campo, não no aplicativo da web
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
Anotação:
Esta seção descreve a funcionalidade que está disponível apenas no Survey123 Connect e aplicativo de campo Survey123. Esta funcionalidade não está disponível no Survey123 Studio ou Survey123 Mobile.
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 de que a pesquisa esteja 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 aplicativo de campo.
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
Anotação:
Esta seção descreve a funcionalidade que está disponível apenas no Survey123 Connect e aplicativo de campo Survey123. Esta funcionalidade não está disponível no Survey123 Studio ou Survey123 Mobile.
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