Você pode preencher previamente as respostas no Survey123 de várias maneiras.
Respostas padrão
Você pode definir as respostas padrão para as perguntas da pesquisa na coluna padrão da sua planilha ao projetá-la. Isso preenche sua pergunta da pesquisa com a mesma resposta sempre que você iniciar uma pesquisa ou quando uma pergunta se tornar relevante. Isto é especialmente útil quando a resposta para sua pergunta de pesquisa for a mesma na maioria das vezes. Você ainda pode editar a resposta padrão, se necessário, mas definir a resposta padrão pode economizar tempo ao preencher suas pesquisas. As respostas padrão podem conter constantes como strings e números.
Respostas para perguntas select_multiple funcionam diferentemente de outras, com cada resposta marcada inserida na ordenar que foi selecionada, separada por vírgulas. Para definir diversos valores como padrões em um campo de select_multiple, separe-os com vírgulas, por exemplo item1,item2,item3.
As perguntas de ponto geográfico, traço geográfico e forma geográfica suportam respostas padrões. Para mais informações sobre como definir um padrão, consultePontos geográficos e Traçado geográfico ou forma geográfica.
Cálculos
Os cálculos são semelhantes aos padrões, mas há diferenças. Diferentemente da coluna padrão , que é avaliada somente quando a pesquisa é aberta ou a pergunta se torna relevante, os cálculos são avaliados toda vez que as respostas em sua pesquisa que são entradas para o cálculo alteram ou se tornam relevantes. Os cálculos podem utilizar respostas existentes em seu formulário. Por exemplo, a expressão 100 - (${integer1} + ${integer2}) inserida na coluna de cálculo de uma pergunta soma os valores das perguntas inteiro1 e inteiro2, subtrai esse valor de 100 e define esse valor como sua resposta. O usuário poderá substituir este valor, mas o cálculo pode fornecer uma resposta de início para guiar o usuário.
Dica:
Se o resultado de um cálculo for editado manualmente, você pode usar o botão que aparece para apagar o valor editado e executar o cálculo novamente.
Modo de cálculo
O parâmetro calculationMode inserido na coluna bind::esri:parameters controla quando os cálculos em perguntas são calculados, por exemplo, calculationMode=manual. Há quatro valores suportados:
- auto—Calcule quando a pergunta está vazia ou não foi modificada anteriormente pelo usuário. Se nenhum valor for fornecido, este será o comportamento de cálculo padrão.
- manual—A pergunta calculará somente quando o botão Calcular ao lado da pergunta for pressionado.
- always—Calcule quando qualquer valor referenciado na expressão de cálculo for alterado. Isso inclui funções dinâmicas, como now().
- whenEmpty—Calcule até que um valor não vazio seja retornado. Após um valor não vazio ser retornado, a pergunta se comporta da mesma maneira que o 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 whenEmpty é ú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 a partir da Caixa de Entrada.
Os seguintes tipos de pergunta suportam o parâmetro calculationMode:
- texto
- decimal
- inteiro
- anotação
- data
- hora
- dateTime
- select_one
- select_multiple
- ponto geográfico
- calcular
- oculto
Anotação:
O parâmetro calculationMode não é compatível com o aplicativo da web Survey123.
Propriedades do dispositivo e usuário
A função pulldata("@property") permite extrair informações sobre os dispositivos dos quais as respostas da pesquisa são enviadas e os usuários conectados que enviam essas respostas. Esta função é útil para registrar detalhes técnicos e informações sobre o contexto em que sua pesquisa foi realizada.
A função retorna um dispositivo ou propriedade do usuário usando o formato pulldata("@property", '<property name>'). O seguinte exemplo retorna o deslocamento UTC do dispositivo, permitindo aos usuários registrar o fuso horário no qual uma pesquisa foi realizada.
pulldata("@property", 'utcOffset')
A função pulldata("@property") pode ser utilizada para detectar a maneira como o usuário está interagindo no momento com sua resposta à pesquisa utilizando o seguinte:
pulldata("@property", 'mode')
A propriedade mode tem três valores possíveis, retornando new se o usuário estiver produzindo uma nova resposta à pesquisa (incluindo uma copiada de uma pesquisa existente), retornando edit se o usuário estiver editando uma resposta existente e retornando view se o usuário estiver visualizando uma resposta existente no modo de somente leitura. O seguinte exemplo, quando colocado na coluna de somente leitura, detecta se o usuário está editando uma resposta existente e o impede de editar a pergunta escolhida:
pulldata("@property", 'mode') = 'edit'
A função pulldata("@property") também pode ser utilizada para determinar onde uma pesquisa foi aberta. O seguinte exemplo determina se a pesquisa foi aberta na caixa de entrada:
pulldata("@property", 'status') = 'inbox'
Aviso:
Recomenda-se que você não armazene os resultados das propriedades mode ou status em uma pergunta oculta ou calculada e não habilite ou desabilite perguntas usando essas propriedades na coluna relevante. Isto pode fazer com que a exclusão de conteúdo destes campos ou valores não seja atualizada conforme o esperado.
A função pulldata("@property") suporta as seguintes propriedades:
| Propriedade | Descrição |
|---|---|
| pulldata("@property", 'portalUrl') | A URL do portal no qual a pesquisa é enviada. |
| pulldata("@property", 'token') | O token enviado à camada de feição. |
| pulldata("@property", 'portalInfo') | Todas as informações do portal, como um objeto JSON. |
pulldata("@property", 'submissionUrl') | 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. |
| pulldata("@property", 'online') | Um valor Boolean. O valor é verdadeiro se o dispositivo tiver atividade de rede, caso contrário, é falso. |
| pulldata("@property", 'utcOffset') | Deslocamento em horas a partir do UTC para o fuso horário local. |
| pulldata("@property", 'language') | Idioma usado na pesquisa atual. |
pulldata("@property", 'locale')¹ | A ferramenta Localizar objeto utilizada na pesquisa atual. |
pulldata("@property", 'localeInfo')¹ | O objeto AppStudioLocaleInfo usado na pesquisa atual contendo o código do idioma em várias notações. |
| pulldata("@property", 'timeZone') | Código de fuso-horário. |
pulldata("@property", 'username') | Nome de usuário da conta organizacional do ArcGIS do usuário conectado no momento. |
pulldata("@property", 'email') | Endereço de e-mail da conta organizacional do ArcGIS do usuário atualmente conectado. |
pulldata("@property", 'userFullName') | Nome e sobrenome do usuário conectado no momento. |
pulldata("@property", 'userFirstName')² | Nome do usuário conectado no momento. |
pulldata("@property", 'userLastName')² | Sobrenome do usuário conectado no momento. |
pulldata("@property", 'deviceId')³ | ID Único gerado no Survey123 representando o dispositivo específico no qual a pesquisa foi realizada. Isto é diferente da International Mobile Equipment Identity (IMEI) de um dispositivo móvel, pois o Survey123 executa em dispositivos que podem não ter um IMEI. |
pulldata("@property", 'deviceModel')³ | Nome do modelo de dispositivo do usuário. |
pulldata("@property", 'OS')³ | Nome do sistema operacional de dispositivo do usuário. |
pulldata("@property", 'appVersion') | Número da versão do aplicativo de campo ou número da compilação do aplicativo da web. |
pulldata("@property", 'surveyName') | Nome da pesquisa. |
pulldata("@property", 'userAgent') | String de agente do usuário para o dispositivo do usuário. |
pulldata("@property", 'mode') | Retorna new se o usuário estiver criando uma resposta à pesquisa, edit se estiver editando uma resposta existente ou view se estiver visualizando uma resposta no modo somente leitura. |
pulldata("@property", 'status') | Retorna draft, submitted, sent, ou inbox se a pesquisa foi aberta Rascunhos, Caixa de saída, Enviados, ou Caixa de entrada, respectivamente. Uma string vazia é retornada se a resposta for nova. |
¹Para uso apenas com a função pulldata("@javascript").
²Esses parâmetros dependem do que está presente na configuração do provedor de identidade e podem não estar disponíveis em organizações que usam autenticação diferente da autenticação interna.
³O Survey123 field app somente.
Respostas favoritas
Após inserir as respostas no Survey123 field app e enviá-las ou salvar a pesquisa como rascunho, você poderá usá-las em pesquisas subsequentes definindo suas respostas favoritas. Com a utilização do menu no canto direito superior, você pode definir o estado atual de sua pesquisa para atuar como respostas dos favoritos.
Após você definir suas respostas dos favoritos, você poderá inseri-las em novas pesquisas abrindo o menu favoritos e clicando em Colar respostas dos favoritos.
Se em qualquer momento você precisar alterar suas respostas dos favoritos, insira as respostas em sua pesquisa atual e clique em Configurar como respostas dos favoritos. Se você inserir informações repetitivas em um campo, poderá usar suas respostas atuais para preencher as pesquisas subsequentes. A pesquisa que você usa para definir suas respostas favoritas é marcada com uma estrela.
Anotação:
Se a pasta Enviado foi desativada, você não poderá usar uma pesquisa enviada para respostas favoritas. Nesse caso, salvar sua pesquisa com respostas favoritas como rascunho permitirá que opção Colar respostas do favorito funcione.
Dados CSV
Preencher respostas com informações que você armazenou em seu dispositivo pode minimizar o tempo que leva para completar sua pesquisa. As informações podem ser dados coletados de uma pesquisa anterior ou podem fornecer múltiplas respostas baseadas na entrada do usuário de uma única resposta.
O pré-preenchimento de respostas é útil em pesquisas de inspeção de ativos. Ao inserir um número de ID de recurso (digitando ou escaneando um código de barras), os detalhes deste recurso poderão ser recuperados a partir do arquivo .csv e utilizado para responder outras perguntas, tais como, localização, última data de inspeção e condição na hora da última inspeção.
Para obter detalhes adicionais sobre como preencher as respostas dessa maneira, consulte Recuperar um valor de CSV.
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 .csv não será importado para a pesquisa.