Você pode incluir perguntas de texto, número inteiro e decimal em pesquisas para que os usuários digitem respostas em formato de texto e numérico.
Perguntas de texto permitem respostas em texto livre na pesquisa. Por padrão, o formulário exibe uma caixa de texto com entrada de única linha. Se o texto excede o tamanho da caixa de texto, ele permanece do mesmo tamanho e rola horizontalmente sem quebras de linha. Isto é ideal para respostas pequenas. Para forçar a entrada de texto a seguir um determinado formato, você pode aplicar uma máscara de entrada. Você também pode aplicar uma expressão regular para restringir o campo de texto, de modo a rejeitar automaticamente respostas que não estejam em um formato específico, como um endereço de e-mail ou uma URL de site.
Os tipos de pergunta de número inteiro e decimal restringem o usuário à inserção de valores numéricos válidos. Na coluna restrição para esses tipos de pergunta, você pode especificar os valores mínimo e máximo para impedir que o usuário envie a pesquisa, a menos que a resposta esteja dentro do intervalo definido.
Você pode alterar o comportamento desses tipos de pergunta e a maneira como são apresentados definindo a aparência. Para confirmar quais aplicativos de envio oferecem suporte a uma determinada aparência, consulte Aparência.
Aparência do texto
Anotação:
No Survey123 Mobile, apenas a aparência multiline é suportada para perguntas de texto.
No aplicativo da web Survey123, as aparências predictivetext e nopredictivetext não são suportadas.
Ao definir a coluna appearance para multiline, uma pergunta de texto é apresentada como uma caixa de texto de múltiplas linhas. Esta caixa de texto maior é ideal para respostas longas. O texto é quebrado para uma nova linha à medida que é digitado, e o componente aceita quebras de linha.
Anotação:
Para formulários utilizados no aplicativo de campo Survey123, você pode definir a altura padrão da caixa de texto de múltiplas linhas 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 recurso de texto preditivo desativado para perguntas de texto, o que pode desabilitar a função de conversão de fala em texto em alguns teclados. Aplique a aparência predictivetext a uma pergunta de texto para habilitar a fala em texto para essa pergunta. O recurso de texto preditivo está ativado por padrão no iOSiOS.
Ao definir a aparência para geocode, uma pergunta de texto é usada para pesquisar e enviar um endereço geocodificado.
O recurso de aparências também está disponível para obter um ID de tag do InfraMarker e obter um valor de um medidor de distância.
Pesquisar e enviar um endereço geocodificado
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.
Ao definir a coluna appearance para geocode, uma pergunta de texto é usada para pesquisar e enviar um endereço geocodificado. Quando os usuários começam a digitar um endereço, uma série de opções de preenchimento automático é exibida, sugerindo locais com base nos localizadores padrão disponíveis para a organização deles. Se o usuário não estiver conectado, o ArcGIS World Geocoder será usado. A aparência geocode exige uma conexão com a Internet e não funcionará em um ambiente offline.
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 ArcGIS World Geocoding Service 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:
Anotação:
Os parâmetros indicator, proximity, maxResults e suggestions não são suportados com o aplicativo da web Survey123.
- 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 uma 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 o número máximo 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.
Obter um ID de tag do InfraMarker
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.
Use as aparências descritas abaixo para ler ou gravar os dados em uma tag RFID do InfraMarkerInfraMarker.
Ao definir a coluna appearance 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 na 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.
Obter um valor de um medidor de distância a laser
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.
Ao definir a coluna appearance para rangefinder, uma pergunta de texto pode aceitar o objeto JSON completo ou um valor especificado que é retornado de um medidor de distância a laser. Quando usada para aceitar o objeto JSON completo, essa pergunta deve ter bind::esri:fieldLength definido para 1000 para garantir que o valor total seja ajustado.
Ao definir a aparência rangefinder para uma pergunta de número inteiro ou decimal, ela pode aceitar um valor específico retornado pelo medidor de distância a laser. Especifique qual medida armazenar usando um dos seguintes valores na coluna bind::esri:parameters: height, azimuth, horizontalDistance, slopeDistance ou inclination. Por exemplo measurement=height armazenará apenas o valor da altura retornado do telêmetro.
Aparência de número inteiro
Anotação:
No Survey123 Mobile, apenas a aparência spinner é suportada para perguntas de número inteiro.
No aplicativo da web Survey123, nenhuma dessas aparências de número inteiro é suportada.
Ao definir a coluna appearance para spinner, uma pergunta de número inteiro é exibida com botões para aumentar ou diminuir o valor por um. A seleção do botão repete a progressão até o botão ser solto.
Ao definir appearance para numbers, uma pergunta de número 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.
Ao definir appearance para calculator, uma pergunta de inteiro destacada é acompanhada por um teclado numérico personalizado para inserir e modificar um valor.
Ao definir appearance para distress, uma pergunta de número inteiro é exibida como uma escala de danos. Uma escala de angústia é uma escala de 10 pontos utilizada para medir sentimentos como estresse, dor e felicidade.
Aparência de decimal
Anotação:
No Survey123 Mobile, apenas a aparência spinner é suportada para perguntas de decimal.
No aplicativo da web Survey123, nenhuma dessas aparências de decimal são suportadas.
Ao definir a coluna appearance 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.
Ao usar um valor padrão para definir o número de casas decimais de uma pergunta, o seletor numérico segue essa configuração. 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
Ao definir appearance 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.
Ao definir appearance para calculator, uma pergunta de número inteiro destacada é acompanhada por um teclado numérico personalizado para inserir e modificar um valor.
Ao definir appearance para thousands-sep, a resposta para uma pergunta de decimal é exibida 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 é preenchida por um padrão ou cálculo de valores. Os separadores de milhares não aparecem ao inserir manualmente um valor.
