As seleções em cascata são usadas para restringir uma lista de respostas disponíveis com base na resposta de uma pergunta anterior, e seu conteúdo pode ser armazenado no próprio XLSForm ou em um arquivo externo.
Seleções em cascata
As seleções em cascata são utilizadas para restringir uma lista de respostas disponíveis com base na resposta a uma pergunta anterior. Isto tornará as pesquisas mais fáceis de utilizar, mantendo as listas de opções pequenas, apresentando somente opções relevantes para os usuários.
Para cada lista de opções na hierarquia, complete o seguinte:
- Insira os valores para as listas de opções na guia choices.
- Adicione uma ou mais colunas para os critérios de seleção em cascata (por exemplo, país, estado, cidade, subúrbio).
- Insira o valor relevante para cada opção nas colunas extras.
Não é recomendado incluir nomes de opções duplicados em uma lista de opções. Para mais informações, consulte Perguntas de múltipla escolha.
Uma vez que as listas de escolha foram concluídas, você deve criar uma coluna choice_filter na guia pesquisa. Esta coluna conterá a expressão utilizada para restringir suas listas de opções. A coluna choice_filter pode aceitar o conteúdo de outro campo, por exemplo, state=${state_1}, ou uma expressão, por exemplo, selected(${states_visited},state_code).
Para visualizar as seleções em cascata em ação, consulte o exemplo Seleções em Cascata no Survey123 Connect.
Você pode usar seleções em cascata com perguntas select_one, select_multiple e rank. As seleções em cascata não são suportadas em perguntas rank no Survey123 web app.
Dica:
Ao revisar os resultados de uma pesquisa com uma pergunta que usa uma seleção em cascata, apenas o nome da escolha enviada será exibido. Isto é diferente do comportamento de select_one ou perguntas select_multiple sem um filtro de escolha, onde o rótulo da escolha é exibido ao invés.
Utilize a função jr:choice-name() em outra pergunta para retornar e armazenar o rótulo associado com a escolha de uma pergunta. Conceitualmente, isto pode ser representado por jr:choice-name(string value, 'question name').
Em jr:choice-name(${city_choice}, '${city_choice}'), o primeiro parâmetro representa o valor selecionado e o segundo é o nome da pergunta. Você deve definir o nome de sua pergunta entre aspas.
Para perguntas select_multiple, você deve usar a função selected-at() para extrair o rótulo para respostas individuais. Por exemplo:
jr:choice-name(selected-at(${city_choice}, 1), '${city_choice}')
Você pode usar a função jr:choice-name() em qualquer pergunta de string. Ao usar uma pergunta oculta, defina também suabind::esri:fieldType e bind::esri:fieldAlias.
Aviso:
A partir do Survey123 versão 3.12, as listas de opções são gerenciadas por meio de um banco de dados interno. Isto significa que você não pode usar teclados reservados do SQLite para nomes de coluna em cascata e seleções externas.
Seleções externas
As listas de opções associadas às seleções em cascata podem se tornar grandes e afetar o desempenho de seus formulários. O Survey123 tem a opção de salvar essas listas em um arquivo externo e carregá-las na pesquisa sob demanda.
Para implementar esta opção, crie uma guia na planilha para sua pesquisa denominada external_choices. Esta nova guia deve conter os mesmos cabeçalhos de coluna que a guia de opções. Quando a pesquisa for publicada, valores da guia external_choices serão salvos em um arquivo denominado itemsets.csv na pasta de mídia do seu projeto de pesquisa, ao invés de como parte de item do formulário. Para referenciar as listas de opções na guia external_choices, utilize select_one_external para prefixar o nome da lista.
As seleções externas são diferentes de uma lista de escolha externa, que não requer uma planilha external_choices.
Anotação:
As seleções externas somente são possíveis para perguntas select_one. Elas não são suportadas para perguntas select_multiple.
As seleções externas são projetadas para trabalhar com listas de opções associadas somente com uma seleção em cascata. Apenas as opções com um filtro de escolha aplicado são adicionadas ao arquivo itemsets.csv.