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:
No aplicativo de campo Survey123, se o resultado de um cálculo for editado manualmente, você poderá usar o botão que aparece para apagar o valor editado e executar o cálculo novamente.
Modo de cálculo
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.
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. Quando um valor não vazio é retornado, a pergunta muda para o modo manual. A pergunta permanecerá no modo manual mesmo que seu valor seja apagado. 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
Propriedades do dispositivo, usuário e pesquisa.
A função pulldata("@property") permite extrair informações sobre o seguinte:
- O dispositivo a partir do qual as respostas da pesquisa são enviadas.
- O usuário registrado que enviou estas respostas.
- A pesquisa para a qual as respostas foram enviadas.
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:
Dispositivo
| Propriedade | Descrição |
|---|---|
| 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", 'timeZone') | Código de fuso-horário. |
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", 'userAgent') | String de agente do usuário para o dispositivo do usuário. |
*Não suportado no aplicativo da web Survey123.
Usuário
| Propriedade | Descrição |
|---|---|
pulldata("@property", 'email') | Endereço de e-mail da conta organizacional do ArcGIS do usuário atualmente conectado. |
pulldata("@property", 'username') | Nome de usuário da conta organizacional do ArcGIS do usuário conectado no momento. |
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", 'portalUrl') | A URL de organização do ArcGIS do usuário atualmente registrado. |
| pulldata("@property", 'portalInfo') | Todas as informações do portal, como um objeto JSON. |
| pulldata("@property", 'token') | O token de acesso do usuário atualmente registrado. |
*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.
Pesquisa
| Propriedade | Descrição |
|---|---|
pulldata("@property", 'submissionUrl')* | A URL de REST da camada de feição (ou da camada principal do formulário, quando esta tem repetições) à qual a pesquisa é enviada. Usado para expressões de pesquisa ou busca de dados que consultam envios de pesquisas existentes. |
| pulldata("@property", 'language') | Idioma usado na pesquisa atual. |
pulldata("@property", 'locale')* | A localidade usada na pesquisa atual. Para uso apenas com a função pulldata("@javascript"). |
pulldata("@property", 'localeInfo')* | A localidade usada na pesquisa atual contendo o código do idioma em várias notações. Para uso apenas com a função pulldata("@javascript"). |
pulldata("@property", 'surveyName') | Nome da pesquisa. |
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. |
*Não Suportado no Survey123 Mobile.
Respostas favoritas
Anotação:
Esta seção descreve a funcionalidade que está disponível apenas no aplicativo de campo Survey123. Esta funcionalidade não está disponível no Survey123 Mobile.
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
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.
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.