Aparência

Você pode alterar a maneira como as perguntas são apresentadas definindo a aparência para cada tipo de pergunta. Adicione uma coluna de aparência na sua planilha para alterar a aparência e a funcionalidade de perguntas da sua pesquisa.

Nem todas as aparências são suportadas com o aplicativo de campo Survey123 e aplicativo da web. Consulte a Referência rápida para uma tabela que descreve quais aparências podem funcionar em cada ambiente. Esta tabela também pode ser encontrada na planilha Aparências do modelo XLSForm Avançado do Survey123.

Dica:

Para ver como as perguntas serão apresentadas em uma pesquisa, consulte a amostra Aparências no Survey123 Connect. Ao publicar a amostra usando sua conta do ArcGIS, você também pode ver como as perguntas serão apresentadas no aplicativo da web Survey123.

Múltiplas aparências

Você pode adicionar múltiplas aparências à coluna aparência para uma pergunta separando as aparências com espaços. As aparências podem estar em qualquer ordem. Por exemplo, uma pergunta de imagem pode ter as três aparências a seguir especificadas na coluna aparência:

annotate new-front multiline

Você pode especificar aparências de largura para perguntas em pesquisas que usam um layout de grade. As larguras podem ser especificadas com qualquer combinação de aparências suportadas para o tipo de pergunta. Por exemplo, uma pergunta de seleção em um layout de grade poderia ter o seguinte na coluna aparência:

w3 likert

Ocultar perguntas

Definindo a aparência para hidden, qualquer tipo de pergunta, incluindo grupos e repetições, pode ficar oculto durante o preenchimento na pesquisa, mas aceitará e enviará valores e cálculos padrão. É mais versátil do que o tipo de pergunta ocultar, pois pode ser aplicado a qualquer tipo de pergunta.

Texto

Definindo a aparência para multiline, uma pergunta de texto é apresentada como uma caixa de texto de múltiplas linhas. Você pode configurar a altura padrão desta caixa de texto configurando um parâmetro defaultHeight na coluna body::esri:style. Por exemplo, inserir defaultHeight=5 na coluna body::esri:style exibirá cinco linhas em uma caixa de texto de múltiplas linhas quando sua pesquisa for aberta. Se isto não estiver configurado, um caixa de texto de múltiplas linhas exibirá três linhas quando sua pesquisa for aberta.

Definindo a aparência para predictivetext ou nopredictivetext, uma pergunta de texto forçará o texto previsto ser ativado ou desativado, respectivamente, em dispositivos móveis. Por padrão, o Android tem o texto previsto desativado para perguntas de texto, enquanto é ativado por padrão no iOS.

Anotação:

O controle de altura das perguntas não é suportado no aplicativo da web Survey123 .

As aparências predictivetext e nopredictivetext não são suportadas no Survey123 web app.

O texto preditivo está desabilitada para perguntas de texto por padrão no Android, o que pode desativar a função de fala para texto em alguns teclados. Aplique a aparência predictivetext a uma pergunta de texto para habilitar a fala em texto para essa pergunta.

Texto InfraMarker

Use as seguintes aparências para ler ou gravar dados em um tag RFID InfraMarker.

Ao definir a aparência de uma pergunta de texto para inframarker, você pode definir as informações a serem gravadas em uma tag. Essas informações podem incluir assetOwner, assetName, latitude e longitude, e os valores podem ser derivados de outras perguntas da pesquisa. Por exemplo, a seguinte expressão na coluna Cálculo grava as respostas das perguntas asset_name, asset_owner, lat e long na tag:

concat("assetName=", ${asset_name}, "&assetOwner=", ${asset_owner}, "&latitude=", ${lat}, "&longitude=", ${long})

Ao definir a aparência de outra pergunta de texto na mesma pesquisa para getinframarkerid, o único ID de tag de 24 caracteres InfraMarker é recuperado e armazenado na pesquisa.

Para mais informações, consulte a documentação do InfraMarker.

Geocódigo

Definindo a aparência para geocode, uma pergunta de texto é usada para pesquisar e enviar um endereço geocodificado. Comece digitando um endereço e uma série de opções de preenchimento automático aparecerá sugerindo locais com base nos localizadores padrão disponíveis para sua organização. Se o usuário não estiver conectado, o ArcGIS World Geocoder será usado. O endereço final selecionado será enviado para a camada de feição como uma string: no entanto, os dados geocodificados completos são armazenados temporariamente como um objeto JSON antes de serem enviados, permitindo que propriedades individuais sejam extraídas para outros campos.

Para extrair propriedades específicas do objeto JSON, use a função pulldata("@json") na coluna de cálculo de outra pergunta.

pulldata("@json", ${address}, "location.x")

pulldata("@json", ${address}, "searchCandidate")

Todo o objeto JSON pode ser retornado em um único campo de texto, não definindo uma propriedade individual.

pulldata("@json", ${address})

Para obter mais informações sobre a função pulldata("@json"), consulte Recuperar um valor de JSON.

Anotação:
A geocodificação usando Serviço do ArcGIS Geocoding consumirá créditos. Para mais informações, consulte Entender os créditos.

Para definir um localizador específico para retornar resultados, forneça o ID de item do localizador na coluna bind::esri:parameters, por exemplo, geocode=36ff9e8c13e042a58cfce4ad87f55d19. Um localizador usado em uma pesquisa do ArcGIS Online deve ser um item no ArcGIS Online. Um localizador usado em uma pesquisa do ArcGIS Enterprise deve ser um item do mesmo portal da pesquisa.

As propriedades disponíveis serão diferentes dependendo do localizador usado. A exceção a isso é a propriedade searchText, que está disponível independentemente do localizador usado e retorna a string exata usada para pesquisar o endereço ou a opção selecionada em uma lista de resultados.

Você pode controlar ainda mais a apresentação de uma pergunta de aparência de geocódigo, definindo um dos seguintes parâmetros na coluna body::esri:style:

  • indicator—Permite que os resultados geocodificados mostrem a direção e distância da localização atual do dispositivo. Este parâmetro pode ser definido como distance, direction, ambos os valores separados por vírgula ou none. Por padrão, este parâmetro é definido para mostrar apenas a distância.
  • proximity—Controla se os resultados geocodificados mostram apenas resultados dentro de um determinado raio da localização do dispositivo. Este parâmetro aceita um número, seguido por qualquer uma das seguintes unidades padrão: m (metros), km (quilômetros), ft (pés), mi (milhas) ou yd (jardas). Se nenhuma unidade for fornecida, o padrão será metros. Se definido como 0, a proximidade não será contabilizada nos resultados da pesquisa. Por padrão, este parâmetro é definido como on, permitindo que as sugestões sejam classificadas por proximidade sem filtrar nenhum local devido à distância.
  • maxResults—Controla a quantidade máxima de resultados fornecidos. por exemplo, maxResults=10 retornará um máximo de 10 resultados possíveis. Por padrão, esse parâmetro é definido para mostrar no máximo 6 resultados.
  • suggestions—Isso atua como uma interface para operação suggest no ArcGIS REST API. Quando esse parâmetro é definido como yes, a lista suspensa de possíveis locais é preenchida pela operação suggest. Quando este parâmetro é definido como no ou se o serviço de geocódigo não suportar a operação suggest, a lista de locais potenciais é preenchida pela operação findAddressCandidates. Por padrão, este parâmetro é configurado para yes.

A aparência geocode exige uma conexão com a Internet e não funcionará em um ambiente offline.

Anotação:

Os parâmetros indicador, proximidade, maxResults e sugestões não são compatíveis com o aplicativo da web. Survey123.

Telêmetro

Ao definir a aparência para telêmetro, uma pergunta de texto pode aceitar o objeto JSON completo ou um valor especificado que é retornado de um telêmetro. Quando usada para aceitar o objeto JSON completo, essa pergunta deve ter bind::esri:fieldLength definido para 1000 para garantir que o valor total caberá.

Ao definir a aparência do telêmetro, uma pergunta inteira ou decimal pode aceitar um valor específico que é retornado de um telêmetro. Especifique qual medida armazenar usando um dos seguintes valores na coluna bind::esri:parameters: altura, azimute, horizontalDistance, slopeDistance, inclinação. Por exemplo measurement=height armazenará apenas o valor da altura retornado do telêmetro.

Data

Definindo a aparência para year, uma pergunta de data é apresentada como um botão de ano somente, com setas para aumentar ou diminuir o valor do ano.

Seletor de ano

Definindo a aparência para month-year, uma pergunta de data é apresentada como um par de botões, um para o mês e outro para o ano. Cada um tem setas para aumentar ou diminuir o valor.

Seletor de mês de ano
Anotação:

As aparências year e month-year aparecem quando a pesquisa é carregada com valores para o mês e ano atuais. No entanto, eles ainda não contêm estes valores e enviarão um valor em branco, a menos que tenham sido editados manualmente ou que um padrão ou cálculo tenha sido aplicado.

Definindo a aparência para week-number, uma pergunta de data ainda é apresentada com um seletor de calendário para escolher a data, mas uma vez selecionada, o resultado é exibido como o número de semana equivalente do ano. Por exemplo, se você 27 de Abril de 2016, a Semana 17 será exibida como resultado.

Número de semana
Anotação:

A aparência week-number não é suportada no Survey123 web app.

Select_one

Definindo a aparência para minimal, uma pergunta select_one é apresentada em um menu suspenso.

Aparência minimal para select_one

Definindo a aparência para horizontal, as opções para uma pergunta select_one são apresentadas em uma coluna horizontal de largura idêntica.

Aparência horizontal para select_one

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.

Você pode especificar um número máximo de colunas para a aparência compact fornecendo um número separado por um hífen. Por exemplo, compact-3 limita a pergunta para um máximo de três colunas.

As aparências compact e horizontal-compact são idênticas. No Survey123 web app, em vez de usar colunas, essas aparências se ajustam aos rótulos de opção para uma pergunta de select_one lado a lado em linhas sem espaçamento adicional.

Definindo a aparência para likert, uma pergunta select_one é apresentada como uma escala de 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.

Aparência de likert para selecionar um

Definindo a aparência para autocomplete, uma pergunta select_one é 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.

Aparência autocomplete para select_one

Definindo a aparência para image-map, uma pergunta select_one é apresentada como a imagem referida na coluna media::image, com regiões selecionáveis da imagem como opções. Para função, esta aparência exige um arquivo SVG para ser fornecido na pasta de mídia da pesquisa e os valores de nome da lista de opções para corresponder ao IDs do caminho das regiões do arquivo SVG. Para mais informações, consulte Trabalhar com arquivos SVG.

Aparência Image-map para selecionar um
Anotação:

A aparência image-map não é suportada no Survey123 web app.

Select_multiple

Definindo a aparência para minimal, uma pergunta select_multiple é apresentada em um menu suspenso.

Definindo a aparência para horizontal, as opções para uma pergunta select_multiple 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.

Você pode especificar um número máximo de colunas para a aparência compact fornecendo um número separado por um hífen. Por exemplo, compact-3 limita a pergunta para um máximo de três colunas.

As aparências compact e horizontal-compact são idênticas. No Survey123 web app, em vez de usar colunas, essas aparências se ajustam aos rótulos de opção para uma pergunta de select_multiple lado a lado em linhas sem espaçamento adicional.

Definindo a aparência para image-map, uma pergunta select_multiple é apresentada como a imagem referida na coluna media::image, com regiões selecionáveis da imagem como opções. Para função, esta aparência exige um arquivo SVG para ser fornecido na pasta de mídia da pesquisa e os valores de nome da lista de opções para corresponder ao IDs do caminho das regiões do arquivo SVG. Para mais informações, consulte Trabalhar com arquivos SVG.

Anotação:

A aparência image-map não é suportada no Survey123 web app.

Pesquisar

Selecione uma e selecione várias perguntas também 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 de mídia 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.

Lista de opções de pesquisa na planilha de pesquisa

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.

Lista de opções de pesquisa na planilha de pesquisa

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"

Parâmetros adicionais são opcionais, mas podem ser usados ​​para restringir os resultados fornecidos pela pesquisa.

ParâmetroDescriçã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, parâmetros de filtro podem ser adicionados à expressão de pesquisa para refinar ainda mais os valores da lista de opções:

ParâmetroDescriçã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.

A seguir está um exemplo de expressão de pesquisa que 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 Survey123 web app da mesma maneira que as perguntas select_one e a aparência auto completar.

Perguntas de mapa

Definindo a aparência para press-to-locate, uma pergunta de ponto geográfico aceitará somente um valor de localização quando o usuário interagir com a pergunta, em vez do comportamento padrão de capturar imediatamente a localização assim que o formulário for carregado. Uma pergunta de traçado geográfico ou forma geográfica será centralizada na localização do usuário sem capturar um ponto ao interagir pela primeira vez com o mapa.

Anotação:

A aparência de pressionar para localizar não é compatível com perguntas de traçado geográfico e forma geográfica no aplicativo de campo Survey123.

Ponto Geográfico

Definindo a aparência para hide-input, uma pergunta de ponto geográfico visualizada no Survey123 web app aparece com um valor de coordenada de somente leitura, em oposição à caixa de entrada de coordenadas padrão.

Aparência de ocultar entrada para pontos geográficos
Anotação:

A aparência hide-input não é suportada no Survey123 field app.

Imagem

Definindo a aparência para signature, uma pergunta de imagem apresenta um pop-up para capturar uma assinatura.

Aparência signature para imagem

Uma assinatura é salva como um anexo de imagem .jpg com as mesmas dimensões do pop-up. Por padrão, a largura do pop-up se estende até a largura da tela do dispositivo, com uma altura fixa de 200 pixels. Você pode definir a largura máxima para este pop-up definindo um valor de max-pixels na coluna parâmetros, por exemplo, max-pixels=400.

Você também pode fornecer uma imagem na coluna padrão para definir um plano de fundo personalizado para a assinatura. As dimensões da imagem padrão determinarão a proporção da imagem do pop-up.

A largura do pop-up será a menor das seguintes:

  • O valor de max-pixels
  • A largura da imagem padrão
  • A largura da tela do dispositivo

A altura será de 200 pixels, a menos que uma imagem padrão seja fornecida.

Ao projetar uma pesquisa usando a aparência da assinatura, certifique-se de levar em consideração o tamanho da tela de todos os dispositivos alvo.

O texto do rodapé pode ser fornecido para um pop-up de pergunta de assinatura usando o parâmetro footerText na coluna body::esri:style. Ao usar apenas o parâmetro footerText sem valor, a dica de orientação da pergunta aparecerá abaixo da assinatura. Isso pode ser alterado para a dica da pergunta usando footerText=@[hint]. A dica ou dica de orientação usada para o texto do rodapé não aparecerá no local padrão abaixo do nome da pergunta. Para obter mais informações sobre dicas, consulte Dicas.

Definindo a aparência para multiline, uma pergunta de imagem aceita múltiplas imagens em uma pergunta de única imagem. Esta aparência pode ser combinada com outras aparências de imagem, definindo ambas as aparências separadas por um espaço, como anotação de múltiplas linhas.

Você pode controlar o número de imagens que podem ser enviadas usando a função count-selected na coluna restrição. For example, count-selected(${image_question}) <= 5 irá limitar o número de imagens que podem ser enviadas a um máximo de cinco.

Ao definir a aparência para new-frontal ou new-rear, uma pergunta de imagem será limitada ao uso apenas da câmera do dispositivo, usando a câmera frontal ou traseira, respectivamente, como padrão. Estas aparências podem ser combinadas com annotate definindo ambas as aparências separadas por um espaço, como new-front annotate.

Anotação:

O Survey123 web app não oferece suporte a múltiplas linhas, parâmetro max-pixels ou padrões quando aplicados à aparência signature.

As aparências new-front e new-rear não são suportadas no Survey123 web app .

A função pulldata("@exif") não funcionará para perguntas de multiline image. Se você precisar extrair dados de formato de arquivo de imagem intercambiável (EXIF) de várias imagens enviadas para a mesma pergunta, considere usar uma repetição.

Desenhar e anotar

Definindo a aparência para draw, uma pergunta de imagem exibe um botão para carregar uma tela para desenhar. Na paleta de ferramentas de desenho, você pode alternar entre as ferramentas de desenho e também controlar as configurações de cada ferramenta, como tamanho do texto, largura da linha, cor e assim por diante. Para obter informações sobre a interface do canvas, consulte Desenhar e anotar. Você pode criar paletas personalizadas que permitem configurar ferramentas de desenho e anotação para atender às suas necessidades. Para obter mais informações, consulte Paletas de desenhar e anotar.

Aparência draw para imagem

Definindo a aparência para annotate, uma pergunta sobre imagem exibe um botão para abrir a câmera do dispositivo e tirar uma foto que você pode anotar com gráficos e texto. Na paleta de ferramentas de desenho, você pode alternar entre as ferramentas de desenho e também controlar as configurações de cada ferramenta, como tamanho do texto, largura da linha, cor e assim por diante. Para obter informações sobre a interface do canvas, consulte Desenhar e anotar. Você pode criar paletas personalizadas que permitem configurar ferramentas de desenho e anotação para atender às suas necessidades. Para obter mais informações, consulte Paletas de desenhar e anotar.

Aparência annotate para imagem
Dica:

A partir do Survey123 3.13, os dados EXIF ​​são copiados da imagem de origem para a imagem anotada.

Como alternativa, você pode permitir que o usuário anote uma imagem existente do armazenamento do dispositivo ou uma captura instantânea de um mapa. Para fazer isso, defina body::esri:style para essa pergunta method=browse, method=camera ou method=map. O comportamento padrão para a aparência da anotação é idêntico ao fornecer method=camera. Você pode definir a pergunta para fornecer várias opções para a imagem de origem fornecendo várias opções separadas por vírgulas, por exemplo, method=camera,browse.

Aviso:

Independentemente do método definido, o aplicativo da web Survey123 exibe apenas uma opção de procura de arquivo.

Padrões e cálculos se comportam de forma diferente com perguntas de imagem utilizando draw e annotate. Se o nome do arquivo de uma imagem na pasta de mídia da pesquisa for utilizado como um valor padrão ou o resultado de um cálculo, a imagem será utilizada como um plano de fundo inicial para a tela. Com anotar, essa imagem é substituída por uma imagem fornecida e é exibida apenas se o usuário se recusar especificamente a fornecer uma imagem ou redefinir a imagem já fornecida.

Anotação:

Você pode definir a resolução de uma imagem definindo um valor max-pixels na coluna parâmetros. Para uma pergunta de desenho, a configuração max-pixels=1000 definirá a tela para uma imagem quadrada de 1000x1000 pixels. Para uma pergunta de anotação, a configuração max-pixels=1000 definirá o lado mais longo da imagem em 1000 pixels, preservando a proporção da imagem fornecida. Se max-pixels não estiver definido, o tamanho da imagem será definido pela configuração do tamanho da imagem nas configurações de Opções para sua pesquisa no Survey123 Connect.

Ambas as formas de configuração da resolução da imagem são substituídas, fornecendo uma imagem padrão para a pergunta, caso em que a resolução da imagem padrão será aplicada. Isso pode ser usado para garantir uma resolução padrão para todas as imagens enviadas. Fornecer um instantâneo de um mapa para anotação também substituirá quaisquer outras configurações de resolução de imagem, com a imagem sendo definida para o tamanho da área de tela visível.

Imagens do Spike

As perguntas de imagem suportam aparências para integrar Survey123 com Spike, uma solução de medição à laser desenvolvida pelo ikeGPS que permite capturar as medições e localização de um objeto a partir de uma foto. Definindo a aparência para spike, spike-full-measure ou spike-point-to-point, uma pergunta de imagem exibe um botão para abrir o aplicativo móvel Spike em dispositivos iOS e Android.

Aparência Spike para imagens

Uma foto tirada com o aplicativo Spike e dispositivo laser permite gravar as coordenadas e distância do objeto, e medir as dimensões dos objetos na foto ao desenhar áreas e linhas. A foto com marcação de medição é então, anexada à sua pesquisa, e os metadados da foto, como coordenadas e medições ficam disponíveis para serem gravadas. Metadados de medição e Spike associado são gravados no arquivo de imagem utilizando as tags do Exchangeable Image File (EXIF) padrão. As informações do EXIF podem então ser extraídas e utilizadas para preencher outros campos.

A diferença entre as aparências Spike é a extensão dos valores armazenados na imagem. A aparência spike mede somente a distância e localização, enquanto a aparência spike-full-measure mede distância, localização, área e comprimento. A aparência spike-point-to-point captura uma série de valores exclusivos para ela, denotados por nomes de propriedade que começam com P2P.

Para obter mais informações sobre essas tags EXIF, consulte a integração do Spike . Para mais informações sobre Spike, consulte o site da web Spike .

Anotação:

Spike a integração não é compatível com o aplicativo da web Survey123.

Inteiro

Definindo a aparência para distress, uma pergunta de inteiro será exibida como uma escala de angústia. Uma escala de angústia é uma escala de 10 pontos utilizada para medir sentimentos como estresse, dor e felicidade.

Aparência distress para inteiro

Definindo a aparência para spinner, uma pergunta de inteiro é exibida com botões de mais e menos, para aumentar ou diminuir o valor por um. A seleção do botão repete a progressão até o botão ser solto.

Definindo a aparência para numbers, uma pergunta de inteiro destacada é acompanhada por um teclado numérico personalizado para inserir um valor. O teclado também inclui um botão para tornar o valor positivo ou negativo.

Aparência numbers para inteiro

Definindo a aparência para calculator, uma pergunta de inteiro destacada é acompanhada por um teclado numérico personalizado para inserir e modificar um valor.

Aparência da calculadora para inteiro
Anotação:

As aparências distress, spinner, numbers e calculator são suportadas noSurvey123 web app.

Decimal

Definindo a aparência para spinner, uma pergunta de decimal é exibida com botões para aumentar ou diminuir o último dígito do valor por um. A seleção de um botão repete a progressão até o botão ser solto.

Aparência de giratório para decimais

Utilize um padrão para definir o número de casas decimais para uma pergunta, e o girador adere a ela. O seguinte são exemplos de como o girador manipula diferentes valores decimais:

  • 1.0 aumenta para 1.1, 1.2, 1.3, 1.4
  • 3.07 aumenta para 3.08, 3.09, 3.10, 3.11
  • 2.000000 aumenta para 2.000001, 2.000002, 2.000003

Definindo a aparência para numbers, uma pergunta de decimal é acompanhada por um teclado numérico personalizado para inserir um valor. O teclado também inclui um botão para tornar o valor positivo ou negativo.

Definindo a aparência para calculator, uma pergunta de inteiro destacada é acompanhada por um teclado numérico personalizado para inserir e modificar um valor.

Definindo a aparência para thousands-sep, a resposta para uma pergunta de decimal aparece com separadores de milhares. Isto não afeta o valor enviado como parte da resposta da pesquisa, apenas a exibição no aplicativo. Os separadores são definidos pela localidade do dispositivo e são aplicados somente na abertura de uma pesquisa a partir das pastas Rascunhos, Caixa de Saída, Caixa de Entrada ou Enviados ou quando a resposta for preenchida por um padrão ou cálculo. Os separadores de milhares não aparecem ao inserir manualmente um valor.

Aparência thousands-sep para decimal
Anotação:

As aparências spinner, numbers, calculator e thousands-sep não são suportadas noSurvey123 web app.

Intervalo

Definindo a aparência para no-ticks, uma pergunta de intervalo é exibida sem as linhas para mostrar as posições no controle deslizante de intervalo ou os valores de mínimo e máximo. Isto não altera o comportamento da pergunta, somente da visualização. Para mais informações sobre o tipo de pergunta intervalo, consulte Intervalo.

Código de barras

Definindo a aparência para mínimo, uma pergunta de código de barras é exibida com apenas um único botão para iniciar o scanner. A caixa de texto que contém o valor para a pergunta do código de barras não é visível. Para obter mais informações sobre o tipo de pergunta de código de barras, consulte Códigos de barras.

Aparência mínima para código de barras
Anotação:

Este tipo de pergunta código de barras não é suportado no Survey123 web app.

Grupo

Definindo a aparência de uma pergunta begin group para compact, um grupo de perguntas aparece recolhido na inicialização e pode ser expandido pelo usuário. Isto é útil para pesquisas longas que podem ser difíceis para o usuário ler e navegar. Esta aparência é definida na pergunta de grupo inicial.

Grupo recolhido comparado ao grupo expandido

A aparência minimal não tem nenhum efeito em perguntas de grupo.

Definindo a aparência da pergunta begin group para table-list, as perguntas select_one no grupo com uma lista de opções comum aparece em um formato de tabela, com a linha superior exibindo os rótulos da lista de opções e a coluna à esquerda exibindo os rótulos da pergunta.

A aparência de lista da tabela de um grupo com perguntas de select_one

Definindo a coluna style na folha settings para pages e a aparência de cada pergunta begin group para field-list, cada grupo é exibido em uma página separada da pesquisa. Você pode navegar nas páginas usando os botões de voltar e avançar na parte inferior do aplicativo. Você pode manter esses botões pressionados para navegar até o início ou o final da pesquisa. Você também pode selecionar o número da página para convertê-lo em um campo gravável e digitar um novo número de página. Isto é ideal para quebrar a visualização da sua pesquisa, organizando e diminuindo os tempos de carregamento.

Aviso:

Ao usar o estilo de páginas, cada pergunta na pesquisa deve estar em um grupo que usa a aparência de lista de campos.

Múltiplas páginas em uma única pesquisa

A difinição da coluna style na folha settings para grupos fixed-grid ou dynamic-grid, em sua pesquisa pode ser definido para exibir as perguntas contidas em uma grade.

O estilo de grade fixa cria um espaço reservado para cada pergunta, incluindo aquelas com uma aparência oculta. Uma pergunta aparecerá se suas condições relevantes forem atendidas; caso contrário, um espaço em branco ocupará esse lugar no formulário.

O estilo de grade dinâmica permite que perguntas e grupos se movam no formulário, dependendo das condições relevantes para fazer o melhor uso do espaço na tela do dispositivo.

O estilo de layout de grade na planilha de configurações é uma configuração global que se aplica a toda pesquisa. Você também pode aplicar um estilo de layout de grade para grupos individuais ou repetições, permitindo que estilos diferentes sejam usados ​​para diferentes partes da sua pesquisa. A configuração global pode ser substituída inserindo um dos seguintes na coluna body::esri:style do grupo ou pergunta repetida:

  • layout=dynamic-grid
  • layout=fixed-grid

Defina a aparência da largura de um grupo como w seguido pelo número de colunas usadas para dividir sua grade. Por exemplo, w4 divide cada linha de sua grade em quatro colunas. O parâmetro largura também pode ser aplicado a uma pergunta dentro de um grupo ou repetir para controlar quantas colunas do grupo pai ou repetição a pergunta deve abranger. Quando as larguras declaradas das questões somam o número de colunas definidas para o grupo, as próximas questões estarão em uma nova linha. Estas larguras podem ser definidas junto com a maioria das outras aparências.

No exemplo a seguir, as aparências de largura para temperatura da água, oxigênio dissolvido, pH e condutividade são w1, e a aparência de largura para o local da amostra de água é w2.

Um grupo de perguntas em uma grade

No exemplo a seguir, o grupo tem uma largura de três colunas (w3). Na primeira repetição, duas colunas são definidas e essas duas colunas abrangem duas das colunas pai (w2: 2). Na segunda repetição, duas colunas são definidas e essas duas colunas abrangem uma das colunas pai (w2: 1).

Perguntas repetidas aninhadas dentro de um grupo na planilha

A imagem a seguir mostra como essas repetições aninhadas aparecem no grupo no formulário.

Perguntas repetidas aninhadas dentro de um grupo no formulário
Anotação:

A aparência table-list não suporta perguntas select_multiple e não suporta mídia em listas de opções.

A aparência table-list não funcionará se posicionada em um grupo theme-grid.

Anteriormente, o estilo de grade dinâmica era chamado de grade de tema. O estilo de grade de tema ainda é suportado para compatibilidade com versões anteriores, mas para novas pesquisas, é recomendável usar o estilo de grade dinâmica ou grade fixa.

Estilos de layout de grade não são suportados no aplicativo da web Survey123.

Grupos no estilo de layout de grade não suportam borderColor.

Arquivo

Definindo a aparência para multiline, uma pergunta de imagem aceita múltiplos arquivos em uma pergunta de único arquivo. Você pode controlar o número de arquivos que podem ser enviados usando a função count-selected na coluna restrição. Por exemplo, count-selected(${file_question}) <= 5 limitará o número de arquivos que podem ser enviados a um máximo de cinco.

Aparência de múltiplas linhas para arquivo

Repetir

Definindo a aparência de uma pergunta begin repeat para minimal, uma coleção repetível de perguntas não é visível na inicialização. O usuário deve clicar no botão de adição para visualizar as perguntas na repetição. Isto é útil quando perguntas repetidas não precisam ser completadas em uma pesquisa. Esta aparência é definida na pergunta de begin repeat.

Aparência mínima para repetição

Se a repetição for configurada para minimal e tiver uma contagem de repetição de zero, os controles de repetição e seu rótulo estarão invisíveis.

Definindo a aparência de uma pergunta begin repeat para compact, uma coleção repetível de perguntas aparece em um estado recolhido na inicialização, que pode ser expandido pelo usuário. Isto é útil para pesquisas grandes que podem ser difíceis para o usuário ler e navegar. Esta aparência é definida na pergunta de begin repeat.

Diferentemente de outras aparências, as repetições podem utilizar minimal e compact ao mesmo tempo configurando a aparência para minimal compact. Isto apresenta as perguntas em uma repetição em ambas as maneiras de recolhido (compacto) e oculto (mínimo).

Definindo a coluna style na folha settings para pages e a aparência de cada pergunta begin repeat para field-list, cada coleção repetível de perguntas é exibida em uma página separada da pesquisa. Este comportamento é igual ao de um grupo.

A definição da coluna style na folha settings para grupos fixed-grid ou dynamic-grid, em sua pesquisa pode ser definido para exibir as perguntas contidas em um layout de grade. Este comportamento é igual ao de um grupo.

Anotação:

Estilos de layout de grade não são suportados no aplicativo da web Survey123.