O ArcGIS Survey123 suporta uma grande quantidade de especificações do XLSForm. Este guia de referência fornece um resumo de recursos do XLSForm que você pode utilizar no Survey123. As pesquisas podem ser criadas no Survey123 Connect ou site da web Survey123 ; alguns recursos estão disponíveis somente em um ou outro, e alguns estão disponíveis em ambos.
Tipos de perguntas
A tabela a seguir descreve os tipos de perguntas disponíveis noSurvey123 Connect, o Survey123 field app, o Survey123 web designer e Survey123 web app. Em algumas perguntas, há diferenças de comportamento e implementação entre plataformas; para as diferenças, consulte as notas após a tabela.
| Tipo de perguntas do Survey123 Connect | Tipo de pergunta do designer da web do Survey123 | Descrição | Suportado no Survey123 field app | Suportado no Survey123 web app |
|---|---|---|---|---|
| áudio⁴ | Áudio⁴ ⁶ | Grava um clipe de áudio no aplicativo de campo. Grava um clipe de áudio ou aceita um arquivo de áudio carregado no aplicativo da web. | Sim | Sim |
| código de barras | Escaneia um código de barras ou código QR. | Sim | Sim | |
| começar grupo | Inicia um grupo de perguntas. | Sim | Sim | |
| begin repeat | Não Aplicável | Inicia um conjunto de repetições de perguntas. | Sim | Sim |
| calcular | Não Aplicável | Executa um cálculo em valores no formulário. O campo de cálculo contém o resultado do cálculo. | Sim | Sim |
| decimal¹ | Entrada de decimal. | Sim | Sim | |
| data | Entrada de data. | Sim | Sim | |
| dateTime | Entrada de data e hora. | Sim | Sim | |
| ID de dispositivo | Não Aplicável | O UUID representando o dispositivo específico no qual a pesquisa foi realizada. | Sim | Não |
| e-mail² | Não Aplicável | Quando registrado com uma conta organizacional, esta pergunta é automaticamente preenchida com o endereço de e-mail da conta. | Sim | Sim |
| finalizar | Não Aplicável | Finaliza a data e hora da pesquisa. | Sim | Sim |
| finalizar grupo | Finaliza um grupo de perguntas. | Sim | Sim | |
| finalizar repetição | Não Aplicável | Finaliza um conjunto de repetições de perguntas. | Sim | Sim |
| arquivo | Aceita um arquivo no dispositivo. | Sim | Sim | |
| ponto geográfico³ | Coleta uma coordenada de GPS fornecida. Este padrão é a localização atual. | Sim | Sim | |
| forma geográfica³ | Coleta um polígono no mapa. | Sim | Sim | |
| traçado geográfico³ | Coleta uma linha no mapa. | Sim | Sim | |
| oculto | Não Aplicável | Cria um campo em sua camada de feição que não é exibida no formulário. Utilize as colunas bind::esri:fieldType e bind::esri:fieldLength para especificar o esquema de dados para este campo. | Sim | Sim |
| inteiro¹ | Entrada de número inteiro. | Sim | Sim | |
| imagem | Aceita uma imagem dos arquivos do dispositivo ou uma foto tirada diretamente. | Sim | Sim | |
| anotação | Exibe o texto na tela. Nota também pode lidar com cálculos ocultos. | Sim | Sim | |
| intervalo | Controle Deslizante⁶ | Entrada para um intervalo de números fornecidos. | Sim | Sim |
| rank list_name | Pergunta de classificação; solicita uma lista de opções. Substitua list_name pelo nome da sua lista de opções. | Sim | Sim | |
| select_one list_name | Lista Suspensa⁵ ⁶, Escala de Likert⁵ ⁶, Classificação⁶, Única seleção⁶,Grade de única seleção⁶ | Pergunta de múltipla escolha; somente uma resposta pode ser selecionada. Substitua list_name pelo nome da sua lista de opções. | Sim | Sim |
| select_one_from_file file_name.csv | Não Aplicável | Pergunta de múltipla escolha; somente uma resposta pode ser selecionada. Substitua file_name.csv pelo nome do arquivo localizado na pasta de mídia da pesquisa que contém a lista de opções. | Sim | Sim |
| select_multiple list_name | Pergunta de múltipla escolha; múltiplas respostas podem ser selecionadas. Substitua list_name pelo nome da sua lista de opções. | Sim | Sim | |
| select_multiple_from_file file_name.csv | Não Aplicável | Pergunta de múltipla escolha; múltiplas respostas podem ser selecionadas. Substitua file_name.csv pelo nome do arquivo localizado na pasta de mídia da pesquisa que contém a lista de opções. | Sim | Sim |
| iniciar | Não Aplicável | Inicia a data e hora da pesquisa. | Sim | Sim |
| texto | Endereço⁶, E-mail⁶, Texto de múltiplas linhas⁵ ⁶, Texto de única linha⁶, Site da web⁶ | Resposta de texto livre. Uma expressão regular é aplicada no E-mail e Site da Web. A aparência do geocódigo é aplicada ao Endereço. | Sim | Sim |
| hora | Entrada de hora. | Sim | Sim | |
| username | Não Aplicável | Quando registrado com uma conta organizacional, esta pergunta é automaticamente preenchida com o nome do usuário da conta. | Sim | Sim |
¹O designer da web combina perguntas inteiro e decimal em um tipo de pergunta única denominado Número. Uma caixa de seleção nas propriedades da pergunta permita ao designer da pesquisa para definir qual entrada é exigida.
²Os tipos de perguntas de e-mail fornecidos no Survey123 Connect e Survey123 designer da web são implementados diferentemente. A implementação no Survey123 Connect preenche automaticamente com o endereço de e-mail da conta organizacional que o usuário é registrado. A implementação no Survey123 web designer é , ao contrário, um campo de texto que somente aceita formatação que corresponda a um endereço de e-mail.
³As perguntas de ponto geográfico, traço geográfico e forma geográfica foram combinadas em um único tipo de pergunta denominada Mapa. Uma caixa de seleção nas propriedades da pergunta permita ao designer da pesquisa para definir qual entrada é exigida. Perguntas de ponto geográfico, geográfico e forma geográfica foram combinadas em um único tipo de pergunta denominada Mapa.
⁴As perguntas de áudio não permitem transferir no Survey123 field app como no aplicativo da web. Para permitir a transferência de áudio no aplicativo de campo, use uma pergunta File.
⁵Diversas aparências disponíveis no Survey123 Connect estão ao contrário, disponíveis como tipos de perguntas separadas no Survey123 web designer. Estas incluem texto de Múltiplas Linhas, Lista Suspensa e Escala de Likert.
⁶Para cada pergunta, o web designer oferece uma opção de armazenar a resposta em cache. No aplicativo da web, após o envio de um registro de pesquisa, a resposta à pergunta será armazenada em cache no navegador e pré-carregada no próximo envio feito para esta pesquisa no dispositivo. O armazenamento em cache de uma resposta pode ser definido para todos os tipos de pergunta, exceto Áudio, Imagem, Transferência de arquivo e Assinatura.
Colunas da planilha de pesquisa
A seguinte tabela contém todas as colunas suportadas do Survey123. Essas colunas estão incluídas na planilha de pesquisa no modelo Avançado e são listadas nesta tabela na ordem em que aparecem na planilha.
| Coluna | Descrição |
|---|---|
| tipo | Selecione um tipo de pergunta a partir da lista fornecida. Insira um nome de lista válida se utilizar uma pergunta select_one ou select_multiple. |
| nome | O nome do campo na camada de feição. |
| rótulo | O rótulo da pergunta exibido em sua pesquisa. |
| sugestão | As informações que podem ajudar a responder a pergunta de pesquisa. |
| guidance_hint | informações adicionais, exibidas somente apos pressionar um ícone. |
| aparência | Selecione a aparência deste campo em sua pesquisa. |
| exigido | Selecione sim para exigir um valor neste campo antes de completar a pesquisa. |
| required_message | Quando um campo exigido não tiver nenhuma resposta, a mensagem nesta coluna parecerá para iniciar uma resposta. |
| somente para leitura | Selecione sim para configurar os valores neste campo para somente leitura. Estes valores não podem ser editados na pesquisa. |
| padrão | Configure o valor padrão deste campo. Isto pré-preencherá a pesquisa com o valor padrão. Isto pode ser utilizado para economizar tempo ao fornecer uma resposta utilizada comumente ou mostrar o tipo de escolha de resposta que é esperada. |
| cálculo | Execute os cálculos utilizando os valores de perguntas precedentes (por exemplo, ${number} * 100). Referencie o campo de cálculo para exibir o resultado (por exemplo,The answer is ${calc}). |
| restrição | Limite a faixa de números que podem ser inseridos (por exemplo, .>0 e .<100). A função pode ser utilizada com todos os tipos de pergunta. |
| constraint_message | Quando as condições de restrição não são atendidas, esta mensagem parecerá para iniciar uma resposta válida. |
| relevante | Isto permite a você pular perguntas ou fazer perguntas adicionais parecerem com base na resposta para uma pergunta anterior. Uma pergunta se torna visível ao atender as condições na coluna relevante (por exemplo, ${name} = 'value'). Uma pergunta oculta por esta coluna envia somente valores nulos. |
| choice_filter | Ao utilizar seleção em cascata, este campo mantém a expressão para corresponder às colunas de atributo adicional na guia de opções (por exemplo, attribute = ${value}). |
| repeat_count | Este valor especifica o número de registros disponíveis em uma repetição. Após a contagem de repetição ter sido especificada, os registros não podem ser adicionados ou excluídos a partir da repetição. |
| media::audio | Copie um arquivo de áudio na subpasta de mídia para seu projeto e insira o nome do seu arquivo de áudio (por exemplo, audio.mp3) para apresentar o áudio com sua pergunta. |
| media::image | Copie um arquivo de imagem na subpasta de mídia do seu projeto e digite o nome do arquivo de imagem (por exemplo, image.jpg) para exibir uma imagem com sua pergunta. |
| bind::type | Um tipo de campo que substitui o tipo de campo padrão da pergunta. |
| bind::esri:fieldType | Define o tipo de campo alvo na camada de feição. Isto pode ser utilizado para substituir o tipo de campo padrão (por exemplo, campos calculate e select_one são strings por padrão. Para salvar os valores na camada de feição como inteiros, selecione (esriFieldTypeInteger). |
| bind::esri:fieldLength | Define o comprimento do campo de destino na camada de feição. Você pode usar isso para substituir o comprimento do campo padrão. |
| bind::esri:fieldAlias | Fornece valores para o nome alternativo do campo na camada de feição. Você pode usar isso para substituir os valores de nome alternativo de campo padrão, que são derivados do rótulo da pergunta. |
| body::esri:style | Fornece expressões para definir o estilo e o comportamento de uma pergunta (por exemplo, a cor de fundo para grupos e repetições). |
| bind::esri:parameters | Fornece parâmetros para uma pergunta que são específicos para Survey123 (por exemplo, parâmetros para controlar o comportamento de repetições ao editar sua pesquisa). |
| bind::esri:workflow | Fornece parâmetros para permitir que uma pesquisa esteja disponível para um modo de medição de telêmetro. |
| parametros | Fornece parâmetros XLSForm padrão para uma pergunta (por exemplo, os parâmetros start, end e step para uma pergunta de intervalo). |
| body::accept | Defina os tipos de arquivo aceitos para a pergunta do arquivo. Aceita extensões de arquivo, com várias extensões de arquivo separadas por vírgulas (por exemplo, .jpg, .png). |
| body::esri:visible | Isto permite a você pular perguntas ou fazer perguntas adicionais parecerem com base na resposta para uma pergunta anterior. Uma pergunta se torna visível ao atender as condições na coluna body::esri:visible (por exemplo, ${name} = 'value'). Uma pergunta oculta por esta coluna ainda contém e envia valores. |
| body::esri:inputMask | Forneça uma expressão para utilizar uma máscara de entrada para fornecer um configurar de configuração para entrada de dados utilizando caracteres e símbolos. |
| label::language (xx) | Forneça traduções para seus rótulos de perguntas. O idioma deve ser especificado por seu nome e código (por exemplo, label::Español (es)). Adicione uma nova coluna para cada idioma. A lista de idiomas aparecerá no menu suspenso na pesquisa. |
| hint::language (xx) | Forneça traduções para suas dicas de perguntas. O idioma deve ser especificado por seu nome e código (por exemplo, hint::Español (es)). Adicione uma nova coluna para cada idioma. A lista de idiomas aparecerá no menu suspenso na pesquisa. |
| guidance_hint::language (xx) | Forneça traduções para suas dicas de orientação. Você deve especificar o idioma por seu nome e código (por exemplo, guidance_hint::Español (es)). Adicione uma nova coluna para cada idioma. A lista de idiomas aparecerá no menu suspenso na pesquisa. |
| required_message::language (xx) | Forneça traduções para a mensagem que aparece se uma pergunta obrigatória não for respondida. O idioma deve ser especificado por seu nome e código (por exemplo, required_message::Español (es)). Adicione uma nova coluna para cada idioma. A lista de idiomas aparecerá no menu suspenso na pesquisa. |
| body::accuracyThreshold | Forneça um valor numérico para o limite (em metros) acima do qual os valores de posição não serão aceitos. Aplica-se ao ponto geográfico e aos vértices das perguntas de forma geográfica e traçado geográfico. |
| bind::esri:warning | Aplique uma expressão que mostre avisos se as condições não forem atendidas. |
| bind::esri:warning_message | A mensagem que exibe se as condições de bind::esri:warning não são atendidas. |
| bind::saveIncomplete | Configure para verdadeiro se o aplicativo for salvar automaticamente a resposta após a pergunta. |
Aparências
Você pode inserir os seguintes valores na coluna de aparência para tipos específicos de perguntas para alterar como eles aparecem ou se comportam. Para mais informações sobre isto, consulte Aparência.
| Aparência | Tipo de pergunta aplicável | Descrição | Suportado no Survey123 field app | Suportado no Survey123 web app |
|---|---|---|---|---|
| anotar | imagem | Permite ao usuário abrir uma janela de tela na qual esboçar que também suporta anotação em imagens. | Sim | Sim |
| autocomplete | select_one | As opções de resposta aparecem em um menu suspenso com entrada de texto para reduzir as opções. | Sim | Sim |
| calculadora | inteiro, decimal | Exibe um widget de calculadora personalizado para esta pergunta. | Sim | Não |
| compact | select_one, select_multiple, begin group, begin repeat | Para perguntas select_one e select_multiple, apresenta as opções horizontalmente de maneira eficiente em termos de espaço. Para grupos e repetições, apresenta perguntas em um estado recolhido na inicialização, que pode ser expandido pelo usuário. | Sim | Sim |
compact-n | select_one, select_multiple | Apresenta opções horizontalmente de maneira eficiente em termos de espaço, com um número máximo de colunas especificado por n. Por exemplo, compact-3 limita a pergunta para um máximo de três colunas. | Sim | Sim |
| distress | inteiro | Exibe a pergunta como escala colorida gradual. | Sim | Não |
| desenhar | imagem | Permite ao usuário abrir uma janela de tela na qual esboçar. | Sim | Sim |
| field-list | begin group, begin repeat | Exibe o grupo de perguntas em uma página separada quando o estilo da pesquisa está configurado para páginas. | Sim | Sim |
geocodificar | texto | Pesquise e envie um endereço geocodificado. | Sim | Sim |
getinframarkerid | texto | Recupere e armazene um ID de tag InfraMarker exclusivo de 24 caracteres. | Sim | Não |
oculto | Todos | Oculta a pergunta da visualização, embora ainda aceite padrões e cálculos. | Sim | Sim |
| hide-input | ponto geográfico | Recolhe a seção da entrada de coordenadas quando a pesquisa é aberta em um aplicativo da web. | Não | Sim |
| Horizontal | select_one, select_multiple | Exibe opções de respostas horizontalmente e em colunas. | Sim | Sim |
| horizontal-compact | select_one, select_multiple | Mesmo que a aparência compact | Sim | Sim |
| image-map | select_one, select_multiple | Exibe uma imagem .svg anexada com regiões selecionáveis. | Sim | Não |
inframarker | texto | Forneça informações a serem gravadas em uma tag do InfraMaker. | Sim | Não |
| likert | select_one | Faz com que as opções de resposta apareçam como uma escala de Likert. | Sim | Sim |
| mínimo | select_one, select_multiple, barcode, begin repeat | Apresenta múltiplas respostas (select_one, select_multiple), múltiplas perguntas (repetições), caixa de texto (código de barras) em um estilo oculto ou minimizado. | Sim | Sim |
| minimal compact | begin repeat | Apresenta perguntas dentro de uma repetição como ambas as opções de recolhidas (compacta) e ocultas (mínima). | Sim | Sim |
| month-year | data | Seleciona somente um mês e ano para data. | Sim | Sim |
| múltiplas linhas | texto, imagem, arquivo | Apresenta uma pergunta de texto como uma caixa de texto de várias linhas. Ele permite vários anexos para uma pergunta de imagem ou arquivo. | Sim | Sim |
nova-frontal | imagem | Limita a pergunta a apenas tirar uma foto, usando a câmera frontal como padrão. | Sim | Não |
nova-traseira | imagem | Limita a pergunta a apenas tirar uma foto, usando a câmera traseira como padrão. | Sim | Não |
sem-ticks | intervalo | Exibe o controle deslizante de intervalo sem posições, valores mínimos ou valores máximos. | Sim | Sim |
nopredictivetext | texto | Desativa a previsão de texto para dispositivos móveis. | Sim | Não |
| números | inteiro, decimal | Exibe um teclado numérico personalizado para esta pergunta. | Sim | Não |
predictivetext | texto | Ativa a previsão de texto para dispositivos móveis. | Sim | Não |
press-to-locate | ponto geográfico, traço geográfico, forma geográfica | Para perguntas de ponto geográfico, só aceita um local depois que o usuário interage com a pergunta. Para pergunta de traçado geográfico ou forma geográfica, ele centraliza a localização do usuário sem capturar um ponto ao interagir pela primeira vez com a pergunta. | Somente para ponto geográfico | Sim |
telêmetro | texto | Aceita o objeto JSON completo ou um valor especificado retornado de um telêmetro. | Sim | Não |
pesquisar | texto | Preenche a lista de opções com valores de uma tabela CSV na pasta de mídia da pesquisa ou, de uma camada de feição ou tabela existente. | Sim | Não |
| assinatura | imagem | Apresenta uma UI para captura de assinatura. A assinatura é adicionada à feição como um anexo. | Sim | Sim |
spike | imagem | Requer um dispositivo Spike e um aplicativo Spike. Ele usa a integração do Spike para medir a distância e a localização em uma foto. | Sim | Não |
spike-medida-completa | imagem | Requer um dispositivo Spike e um aplicativo Spike. Ele usa a integração do Spike para medir distância, localização, área e comprimentos em uma foto. | Sim | Não |
spike-ponto-a-ponto | imagem | Requer um dispositivo Spike e um aplicativo Spike. Ele usa a integração Spike para medir a distância entre dois pontos fotografados. | Sim | Não |
| cata-vento | inteiro, decimal | Adiciona botões para aumentar e diminuir o valor. | Sim | Não |
tabela-lista | começar grupo | Apresenta um conjunto de perguntas select_one dentro de um grupo com uma lista de escolha comum em formato de tabela. | Sim | Sim |
| thousands-sep | decimal | Exibe respostas com separadores de milhares. Aplica-se apenas às respostas pré-preenchidas. | Sim | Não |
| week-number | data | Seleciona um número de semana. | Sim | Não |
| ano | data | Seleciona somente um ano para data. | Sim | Sim |
Parâmetros
Alguns tipos de perguntas no XLSForm têm parâmetros adicionais que permitem controlar o estilo ou o comportamento das perguntas em uma pesquisa. Em alguns casos, esses parâmetros complementam as aparências que um tipo de pergunta suporta. Para obter uma visão geral dos parâmetros suportados por cada tipo de pergunta, consulte Parâmetros XLSForm.
Valores padrão
Inserir today() na coluna default de uma pergunta de data define o valor padrão para ser a data de hoje.
Insira o nome da opção (não o rótulo da opção) para os valores padrão das perguntas select_one.
As respostas para tipos de perguntas de select_multiple funcionam de forma diferente dos outros, com cada resposta verificada inserida na ordem na qual foi selecionada, separadas por vírgulas. Para definir diversos valores como padrões em uma pergunta de select_multiple, separe-os com vírgulas, por exemplo item1,item2,item3.
Validação dos dados
Inserir sim como um valor na coluna exigido faz com que a pergunta da pesquisa exija que a pergunta contenha um valor antes que o formulário possa ser finalizado.
Operadores
Os operadores listados na tabela a seguir podem ser usados em colunas XLSForm que suportam expressões, incluindo as colunas restrição, calculation, e relevante.
Para mais informações sobre cálculos e restrições, consulte Fórmulas, e para mais informações sobre o uso da coluna relevante, consulte Expressões do formulário.
| Operador | Descrição | Exemplo |
|---|---|---|
| . | A resposta atual | .=1 |
| + | Adição | ${question_one} + 4 |
| - | Subtração | ${question_one} - 4 |
| * | Multiplicação | ${question_one} * 4 |
| div | Divisão | ${question_one} div 4 |
| = | Igual | ${price}=9.80 |
| != | Diferente de | ${price}!=9.80 |
| < | Menor que | ${price}<9.80 |
| <= | Menor ou igual a | ${price}<=9.80 |
| > | Maior que | ${price}>9.80 |
| >= | Maior ou igual a | ${price}>=9.80 |
| and | E | ${price}>9.00 and ${price}<9.90 |
| mod | Módulos (divisão remanescente) | ${question_one} mod ${question_two} |
| or | Ou | ${price}=9.80 or ${price}=9.70 |
Funções
As funções seguintes são suportadas no Survey123:
| Função | Descrição | Exemplo |
|---|---|---|
| boolean(question, expression, or value) | Retorna verdadeiro se o valor fornecido não for nulo. É recomendado a você utilizar boolean-from-string () ao vez disto. Aviso:Essa função sempre retorna verdadeiro no aplicativo da web Survey123. Para alternativas, consulte Valores vazios. | boolean(${question_one}) |
| boolean-from-string() | Retorna verdadeiro se a string fornecida for 'true' ou '1'. Caso contrário, retorna falso. | boolean-from-string(${question_one}) |
| coalesce(value1, value2) | Retorna o primeiro valor não vazio. Esta função suporta apenas dois valores. | coalesce(${question_one}, ${question_two}) |
| concat(value1, value2, …) | Retorna a concatenação dos valores de string. | concat(${question_one}, ' and ', ${question_two}) |
| contains(string, substring) | Retorna verdadeiro se a string fornecida tiver uma substring. | contains(${question_one}, 'red') |
| count(repeat) | Retorna a quantidade de respostas para uma pergunta fornecida através de repeticões. Para mais informações, consulte Funções de Agregar. Anotação:Quando utilizada na aplicação de campo Survey123, esta função pode ser colocada dentro ou fora da repetição. Se a função for usada no aplicativo da web Survey123, ela deve ser colocada fora da repetição. Um valor de contagem de fora da repetição pode ser referenciado em um cálculo dentro da repetição. | count(${question}) |
| count-selected(question) | Retorna o número de respostas selecionadas para select_one e perguntas select_multiple. Esta função retorna o número de arquivos anexados para as perguntas de imagem, áudio e arquivo usando a aparência multilinha. | count-selected(${question_one}) |
| date(question, expression, or value) | Converte um número ou string para um objeto de data, sem preservar tempo. | date('2017-05-28T04:39:02+10:00') |
| date-time(question, expression, or string) | Converte um número ou string para um objeto de data. | date-time('2017-05-28T04:39:02+10:00') |
| Converte um objeto de data em um número de data-hora decimal. | decimal-date-time(${date_question}) | |
| decimal-time(question, expression, or string) | Converte um objeto de tempo em um número que representa um dia fracionário no fuso horário do dispositivo. | decimal-time(${time_question}) |
| ends-with(string, substring) | Retorna verdadeiro se a string fornecida finalizar com uma substring. | ends-with(${question_one}, 'hand.') |
| false() | Falso | false() |
Ajusta um valor de data ou hora existente a um formato definido. | format-date(${previous_time}, '%H:%M') | |
| if(condition, a, b) | Se a condição for avaliada como verdadeira, retorna a; caso contrário, retorna b. | if(selected(${question_one}, 'yes') and selected(${question_two}, 'yes'), 'yes', 'no') |
indexed-repeat(question, repeat, index number) | Retorna o valor de uma pergunta específica em um registro de repetição. Para mais informações, consulte Repetições. | indexed-repeat(${room_no}, ${floor}, 3) |
| int(question, expression, or value) | Converte para inteiro. A conversão varia dependendo do tipo de dados. Anotação:Se esta função estiver vazia, ela retornará NaN e a pergunta permanecerá vazia. | int(${question_one}) |
| join(separator, question) | Concatena todas as respostas para uma determinada pergunta em uma repetição, separadas pelo separador fornecido. Anotação:Quando utilizada na aplicação de campo Survey123, esta função pode ser colocada dentro ou fora da repetição. Se a função for usada no aplicativo da web Survey123, ela deve ser colocada fora da repetição. Um valor de ligação de fora da repetição pode ser referenciado em um cálculo dentro da repetição. | join(',', ${question_in_repeat}) |
| jr:choice-name(choice_name, 'question') | Utilizado para peruntas select_one. Retorna o rótulo associado ao nome da opção na pergunta fornecida. Esteja ciente que a pergunta deve ser definida dentro de aspas. | jr:choice-name(${select_one}, '${select_one}') |
Utilizado para perguntas select_multiple. Retorna o rótulo associado ao nome da opção na pergunta fornecida. A função selected-at() deve ser usada para extrair o rótulo de respostas individuais. Esteja ciente que a pergunta deve ser definida dentro de aspas. | jr:choice-name(selected-at(${select_multiple}, 3), '${select_multiple}') | |
| max(value1, value2, ...) | Retorna o valor máximo em um intervalo fornecido ou para uma única pergunta através das repetições. | max(${question_one}, ${question_two}) |
| min(value1, value2, ...) | Retorna o valor mínimo em um intervalo fornecido ou para uma única pergunta através das repetições. | min(${question_one}, ${question_two}) |
| not(expression) | Retorna um valor falso se a expressão retornar verdadeiro e um valor verdadeiro se a expressão retornar falso. | not(selected(., 'yes')) |
| now() | Retorna um espaço de tempo para este momento. Esta função é usada em perguntas de tempo e data/hora. Ele se comporta da mesma forma que today() em perguntsas de data. | now() |
| number(question, expression, or value) | Converte para número. A conversão varia dependendo do tipo de dados. Anotação:Se esta função estiver vazia, ela retornará NaN e a pergunta permanecerá vazia. | number(${question_one}) |
| once() | Se uma pergunta já tiver um valor, retorna o valor existente. Esta função é útil ao usar random() ou uuid() em uma pergunta repetida para garantir que o valor não mude quando você navegar pelos registros repetidos no formulário. | once(uuid()) |
position(..) | Retorna o índice do registro atual em uma repetição. Para mais informações, consulte Repetições. | position(..) |
| pulldata() | Retorna um valor de um arquivo CSV externo. Para obter mais informações, consulte Recuperar um valor de CSV. | pulldata('users', 'email', 'name', ${respondent_name}) |
pulldata("@exif") | Retorna um valor dos metadados EXIF em uma imagem. Para obter mais informações, consulte Extrair metadados de imagem. | pulldata("@exif", ${photo}, "GpsLatitude") |
pulldata("@geopoint") | Retorna um valor de uma pergunta de ponto geográfico. Para obter mais informações, consulte Extrair valores de pontos geográficos. | pulldata("@geopoint", ${location}, "horizontalAccuracy") |
pulldata("@javascript") | Executa uma função JavaScript no formulário e retorna o resultado. Para obter mais informações, consulte Funções JavaScript em formulários de pesquisa. | pulldata("@javascript", "functions.js", "uniqueID", ${buildings}) |
pulldata("@json") | Retorna um valor de um objeto JSON. Para mais informações, consulte Recuperar um valor de JSON. | pulldata("@json", ${json_output}, "attributes.ZIP_CODE") |
pulldata("@layer") | Consulta uma camada de feição do ArcGIS, tabela de feição ou serviço de mapa habilitado para consulta e retorna o resultado. Para mais informações, consulte Consultar uma camada de feição. | pulldata("@layer", "getRecordAt", "https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/World_Time_Zones/FeatureServer/0", ${location}) |
pulldata("@property") | Retorna informações sobre o dispositivo ou usuário conectado. Para obter mais informações, consulte Propriedades do dispositivo e do usuário. | pulldata("@property", 'username') |
| random() | Retorna um valor aleatório entre 0 (inclusivo) e 1 (exclusivo). | random() |
regex() | Aplica uma expressão regular à entrada da pergunta. Retorna verdadeiro se o padrão for correspondido. Para mais informações, consulte Expressões regulares. | regex(., '^\d{5}$') |
selected(question, value) | Verifica se a resposta está selecionada. Esta função é utilizada para perguntas select_one e select_multiple. | selected(${question_one}, 'a') |
| selected-at(question, number) | Utilizado para perguntas select_multiple. Retorna o nome da opção selecionada para o número fornecido, contado a partir de zero; por exemplo, '2' retornará a terceira opção selecionada. | selected-at(${question_one}, 2) |
| starts-with(string, substring) | Retorna verdadeiro se a string fornecida iniciar com uma substring. | starts-with(${question_one}, 'The') |
| string(question, expression, or value) | Converte para string. A conversão varia dependendo do tipo de dados. | string(${question_one}) |
| string-length(question, expression, or value) | Retorna o comprimento de uma string não vazia. | string-length(${question_one}) |
| substr(question, start, end) | Retorna a substring começando no início especificado e estende até o caractere no índice final -1, onde início e final começa em 0. | substr(${question_one}, 1, 2) |
| sum(repeat) | Retorna a soma de todas as respostas para uma pergunta fornecida através de repetições. Para mais informações, consulte Funções de Agregar. Anotação:Quando utilizada na aplicação de campo Survey123, esta função pode ser colocada dentro ou fora da repetição. Se a função for usada no aplicativo da web Survey123, ela deve ser colocada fora da repetição. Um valor de soma de fora da repetição pode ser referenciado em um cálculo dentro da repetição. | sum(${question}) |
| today() | Retorna a data de hoje, armazenada internamente como meio-dia local. Esta função é usada em perguntas de data. | today() |
| true() | Verdadeiro | true() |
| uuid() | Retorna uma string UUID aleatória. | uuid() |
| version() | Retorna a versão da pesquisa definida nas configurações da planilha. | version() |
As seguintes funções matemáticas são suportadas no Survey123:
| Função | Descrição | Exemplo |
|---|---|---|
| acos(value) | Retorna o arco cosseno do valor. | acos(${question_one}) |
| asin(value) | Retorna o arco seno do valor. | asin(${question_one}) |
| atan(value) | Retorna o arco tangente do valor. | atan(${question_one}) |
| atan2(value1, value2) | Retorna o arco-tangente do quociente dos valores. | atan2(${question_one}, ${question_two}) |
| cos(value) | Retorna o cosseno do valor como um ângulo em radianos. | cos(${question_one}) |
| sin(value) | Retorna o seno do valor como um ângulo em radianos. | sin(${question_one}) |
| tan(value) | Retorna a tangente do valor como um ângulo em radianos. | tan(${question_one}) |
| exp(value) | Retorna o expoente natural do valor. | exp(${question_one}) |
| exp10(value) | Retorna 10 para a potência do valor. | exp10(${question_one}) |
| log(value) | Retorna o logaritmo natural do valor. | log(${question_one}) |
| log10(value) | Retorna o logaritmo de base dez do valor. | log10(${question_one}) |
| pi() | Retorna pi. | pi() |
| pow(value, power) | Retorna o valor da potência especificada. | pow(${question_one}, 3) |
| round(value, places) | Retorna o valor arredondado. | round(${question_one}, 5) |
| sqrt(value) | Retorna a raiz quadrada do valor. | sqrt(${question_one}) |
Formatação de HTML
Você pode utilizar a formatação de HTML em rótulos e dicas da pergunta, como também, em rótulos das listas de opções. A formatação de HTML suportada é como segue:
| Tag | Atributo |
|---|---|
a | href, style |
abbr | title |
audio¹ | autoplay, controls, loop, muted, preload |
b, strong, i, em, u, ul, ol, li, tbody, br, hr | |
dd, dl, dt | style |
div¹ | style, align |
figcaption | style |
figure | style |
font | size, color, style |
h1, h2, h3, h4, h5, h6 | style |
img | src, width, height, border, alt, style |
p | style |
source¹ | media, src, type |
span | style |
sub | style |
sup | style |
table | width, height, cellpadding, cellspacing, border, style |
| td, th | height, width, valign, align, colspan, rowspan, nowrap, style |
tr | height, valign, align, style |
video¹ | autoplay, controls, height, loop, muted, poster, preload, width |
¹Suportado apenas no aplicativo da web Survey123.
Dica:
Por padrão, um hiperlink criado com formatação de HTML aberto no aplicativo da web Survey123 abrirá o destino na mesma guia da pesquisa. Para abrir este link em uma nova guia, adicione target="_blank" à tag a href, por exemplo:
<a href="https://www.esri.com" target="_blank">Link to Esri website</a>
Expressões regulares
As expressões regulares são sequências de caracteres que definem um padrão de pesquisa. Eles podem ser utilizados em uma pergunta para determinar seu valor baseado em outras perguntas ou restringir a entrada de dados. Uma expressão regular pode ser construída a partir de subexpressões listadas na seguinte tabela. Para mais informações, consulte Fórmulas.
| Subexpressão | Combinar |
|---|---|
| ^ | Corresponde o início da linha. |
| $ | Corresponde o fim da linha. |
| . | Corresponde qualquer caractere único exceto nova linha. |
| [...] | Corresponde qualquer caractere único em parênteses. |
| [^...] | Corresponde qualquer caractere único não em parênteses. |
| (re) | Agrupa expressões regulares e lembra o texto correspondente. |
| (?: re) | Agrupa expressões regulares sem lembrar do texto correspondido. |
| a| b | Corresponde a ou b. |
| \A | Início de string inteira. |
| \b | Corresponde aos limites da palavra quando estiver fora dos colchetes e corresponde ao backspace (0x08) quando estiver dentro dos colchetes. |
| \B | Corresponde limites sem palavra. |
| \d | Corresponde dígitos. É equivalente a [0 até 9]. |
| \D | Corresponde não dígitos. |
| \G | Corresponde o ponto onde último correspondente finalizou. |
| \n, \t, \e, e assim por diante | Corresponde a nova linha, guia, escape e assim por diante. |
| \N | Referência anterior para capturar o número do grupo N. |
| re* | Corresponde 0 ou mais ocorrências de expressão precedente. |
| re+ | Corresponde 1 ou mais ocorrências de expressão precedente. |
| re? | Corresponde 0 ou 1 ocorrência de expressão precedente. |
| re{ n} | Corresponde número exato de ocorrências de expressão anterior definida no local de n. |
| re{ n,} | Corresponde n ou mais ocorrências de expressão precedente. |
| re{ n, m} | Corresponde pelo menos ao número de ocorrências definidas por n, e no máximo, definidas por m na expressão precedente. |
| \s | Corresponde a um caractere de espaço em branco: guia, feed de linha, feed de formulário, quebra de linha ou espaço. |
| \S | Corresponde não espaço em branco. |
| \w | Corresponde caracteres de palavra. |
| \W | Corresponde caracteres sim palavra. |
| \z | Fim de string inteira. |
| \Z | Fim de string inteira exceto finalizador de linha final permissível. |
Por exemplo, a expressão regular regex(.,'^[A-Za-z]*$') exige que o usuário insira somente letras, nenhum número ou caracteres especiais, em uma pergunta de string.
Tipos de campo da Esri
A coluna bind::esri:fieldType pode ser utilizada para substituir o tipo de campo padrão por um dos seguintes valores. Para mais informações, consulte Colunas personalizadas da Esri .
| Valor de campo | Resultado |
|---|---|
| esriFieldTypeDate | Valores de data e hora |
esriFieldTypeDateOnly | Valores de data apenas sem valores de hora |
esriFieldTypeTimeOnly | Valores de hora apenas sem valores de data |
esriFieldTypeTimestampOffset | Data, hora e deslocamento do valor UTC |
| esriFieldTypeDouble | Números de ponto flutuante de precisão dupla |
| esriFieldTypeGUID | Identificador Único Global |
| esriFieldTypeInteger | Números inteiros (32 bits) |
| esriFieldTypeBigInteger | Números inteiros de (64 bits) |
| esriFieldTypePointZ | Habilita captura de altitude em geopontos |
| esriFieldTypeString | Uma série de símbolos alfanuméricos |
| nulo | Campo nulo, não armazena valores |
Caracteres especiais
Nomes de perguntas e nomes de opções não devem conter caracteres especiais, como espaços, vírgulas, hífens, parênteses, colchetes ou caracteres como $, % e #. É importante que os nomes das opções para perguntas de select_multiple não contenham espaços ou vírgulas.