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. Nem todos os parâmetros são suportados em todos os aplicativos de envio (Survey123 Mobile, o aplicativo de campo Survey123 e aplicativo web Survey123). Para mais informações sobre o suporte do aplicativo, consulte as tabelas de parâmetros abaixo, organizadas por tipo de pergunta e a coluna do XLSForm na planilha da pesquisa que aceita cada parâmetro.
Você pode adicionar vários parâmetros para uma pergunta à mesma coluna separando os parâmetros com espaços. Por exemplo, uma pergunta range pode ter os parâmetros startColor, endColor e color na coluna body::esri:style, como segue:startColor=Orange endColor=White color=#FF6347
Geral
Esta seção descreve os parâmetros que você pode usar nas colunas bind::esri:parameters e body::esri:style do XLSForm para diversos tipos de pergunta.
A tabela a seguir descreve o parâmetro que você pode usar na coluna bind::esri:parameters do XLSForm para os tipos de pergunta text, integer, decimal, note, date, time, dateTime, select_one, select_multiple, geopoint, calculate e hidden.
bind::esri:parameters
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| calculationMode | Controle quando o cálculo em uma pergunta é calculado. Valores: auto | manual | always | whenEmpty Exemplos: | Aplicativo da web Aplicativo de campo |
A tabela a seguir descreve o parâmetro que você pode usar na coluna body::esri:style do XLSForm para os tipos de pergunta text, integer, decimal, select_one (com a aparência autocomplete), select_multiple (com a aparência autocomplete)*, e barcode.
body::esri:style
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| placeholderText | Especifique o texto que aparece na área de entrada da pergunta quando a pergunta está vazia. Valores: @[hint] | @[guidance_hint] Exemplos: | Survey123 Mobile Aplicativo de campo |
*Suportado somente pelo Survey123 Mobile
Áudio
A tabela a seguir descreve os parâmetros que você pode usar na coluna bind::esri:parameters do XLSForm para o tipo de pergunta audio.
bind::esri:parameters
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| codec | Especifique o codec preferido para uma gravação de áudio. Vários codecs podem ser fornecidos, separados por vírgulas. O primeiro codec compatível com o dispositivo será usado. Valor: <codec name> Exemplo: | Survey123 Mobile Aplicativo de campo |
| fileName | Especifique o nome do arquivo. Valores: <expression> Exemplos: | Aplicativo da web |
| duração máxima | Especifique a duração máxima em segundos para uma gravação de áudio. A duração padrão no aplicativo web é 600 (10 minutos). Valor: <seconds> Exemplo: | Survey123 Mobile Aplicativo da web Aplicativo de campo |
| tamanho máximo | Especifique o tamanho máximo do arquivo em megabytes para uma gravação de áudio. O tamanho padrão no aplicativo de campo é 10 MB. Valor: <megabytes> Exemplo: | Survey123 Mobile Aplicativo de campo |
Código de barras
A tabela a seguir descreve os parâmetros que você pode usar na coluna body::esri:style do XLSForm para o tipo de pergunta barcode.
body::esri:style
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
Especifique os tipos de códigos de barras que os usuários podem digitalizar. Vários tipos podem ser fornecidos, separados por vírgulas. Quando o parâmetro barcodeType não é fornecido, todos os tipos de código de barras suportados podem ser lidos, exceto aztec, code39, datamatrix, maxicode e pdf417. Valores: all | 1d | 2d | <barcode types>
Tipos unidimensionais: codabar | code128 | code39 | code93 | ean13 | ean8 | itf | upca | upce | upceanextension Tipos bidimensionais: aztec | datamatrix | maxicode | pdf417 | qrcode | rss14 | rssexpanded Exemplos: | Aplicativo de campo |
Arquivo
A tabela a seguir descreve os parâmetros que você pode usar na coluna bind::esri:parameters do XLSForm para o tipo de pergunta file.
bind::esri:parameters
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| fileName | Especifique o nome do arquivo. Valores: <expression> Exemplos: | Aplicativo da web |
| max-size | Especifique o tamanho máximo do arquivo em megabytes. O padrão é 10 MB. Valor: <megabytes> Exemplo: | Aplicativo da web |
Grupos
A tabela a seguir descreve os parâmetros que você pode usar na coluna body::esri:style do XLSForm para o tipo de pergunta begin group.
body::esri:style
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| backgroundColor borderColor | Defina as cores do plano de fundo e da borda de um grupo ou página. Para obter mais informações, consulte Grupo, página e cores repetidas. Valores: <HTML color name> | <hex color code> Exemplos:
| Survey123 Mobile Aplicativo de campo |
| Defina o estilo de layout de grade para um grupo. Valores: dynamic-grid | fixed-grid Exemplo: | Aplicativo de campo |
Imagens
Esta seção descreve os parâmetros que você pode usar nas colunas do XLSForm especificadas para o tipo de pergunta image.
A tabela a seguir descreve os parâmetros que você pode usar na coluna bind::esri:parameters do XLSForm.
bind::esri:parameters
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| allowAdds | Desabilite a adição de novas imagens ao editar registros existentes. Valor: false Exemplo: | Aplicativo de campo |
| fileName | Especifique o nome do arquivo. Valores: <expression> Exemplos: | Aplicativo da web Aplicativo de campo |
| tamanho máximo | Especifique o tamanho máximo do arquivo em megabytes. O padrão é 10 MB. Valor: <megabytes> Exemplo: | Aplicativo da web |
Para uma pergunta de imagem com aparência anotar, gera automaticamente gráficos de anotação de rótulos e caixas delimitadoras ao redor dos objetos detectados. Anexe essas propriedades para definir o estilo e a formatação da anotação. Propriedade exigida: <model_name> Propriedades opcionais: minScore | cameraPreview | label | class | boundingBoxes | outlineWidth | fontSize | font | bold | italic Exemplos: | Aplicativo de campo | |
Realize detecção de objetos ou classificação de imagens e use os resultados EXIF em sua pesquisa. Propriedade exigida: <model_name> Propriedades opcionais: minScore | cameraPreview | label | class Exemplos: | Aplicativo de campo | |
Gere automaticamente ou adicione manualmente caixas delimitadoras e aplique efeitos de edição na região de destino. Propriedade exigida: <model_name> | @faces | @manual Propriedades opcionais: minScore | cameraPreview | label | class | effect | symbol | fillColor | scale Exemplos: | Aplicativo de campo | |
watermark topLeftWatermark topCenterWatermark topRightWatermark leftCenterWatermark centerWatermark rightCenterWatermark bottomLeftWatermark bottomCenterWatermark bottomRightWatermark | Especifique a posição de uma marca d'água de imagem. Anexe propriedades para definir o conteúdo e a formatação. Para obter mais informações, consulte Marcas d'água. Propriedades: text | color | outlineColor | outlineWidth | haloColor | size | font | bold | italic | margin | image | imageSize Exemplos: | Aplicativo de campo |
A tabela a seguir descreve os parâmetros que você pode usar na coluna body::esri:style do XLSForm para o tipo de pergunta image.
body::esri:style
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| allowRename | Especifique se os usuários podem editar manualmente o nome do arquivo. Valores: true | false Exemplo: | Aplicativo de campo |
| fileNameVisible | Especifique se o nome do arquivo é visível na pesquisa. Valores: true | false Exemplo: | Aplicativo de campo |
| footerText | Para uma pergunta de imagem com aparência de assinatura, especifique o texto a ser exibido na parte inferior do pop-up de assinatura. Se nenhum valor for especificado, a dica de orientação da pergunta aparecerá abaixo da assinatura. Isso pode ser alterado para a dica da pergunta usando footerText=@[hint]. Valores: <none> | @[hint] Exemplos: | Survey123 Mobile Aplicativo de campo |
| método | Especifique o método de captura para uma pergunta de imagem. O valor map somente é compatível com perguntas de imagem com aparência de anotação. Valores: browse | camera | map Exemplos: | Aplicativo da web Aplicativo de campo |
| palette | Para uma pergunta de imagem com aparência de desenho ou anotação, especifique uma paleta de ferramentas de desenho personalizada. Valor: <palette name> Exemplo: | Aplicativo de campo |
| previewHeight | Defina a altura da visualização da imagem após a imagem ser selecionada. Utilize previewHeight=0 se você desejar que sua visualização de imagem seja do tamanho máximo sem o espaço em branco desnecessário. Valores: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels Exemplos: | Aplicativo de campo |
A tabela a seguir descreve o parâmetro que você pode usar na coluna parameters do XLSForm para o tipo de pergunta image.
parameters
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| max-pixels | Para uma pergunta de imagem, defina o tamanho máximo da imagem na borda mais longa, preservando a proporção original. Para uma pergunta de imagem com aparência de assinatura, defina a largura máxima do pop-up de assinatura. Para uma pergunta de imagem com aparência de desenho, defina a tela para uma imagem quadrada (1:1). Valor: <pixels> Exemplos: | Aplicativo da web Aplicativo de campo |
Perguntas de mapa
A tabela a seguir descreve os parâmetros que você pode utilizar nas colunas do XLSForm especificadas para os tipos de pergunta geopoint, geotrace e geoshape.
A tabela a seguir descreve o parâmetro que você pode usar na coluna bind::esri:parameters do XLSForm.
bind::esri:parameters
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
Defina o localizador para retornar resultados geocodificados. Valor: <locator item ID> Exemplo: | Aplicativo da web Aplicativo de campo |
A tabela a seguir descreve os parâmetros que você pode utilizar na coluna body::esri:style do XLSForm para os tipos de pergunta geopoint, geotrace e geoshape.
body::esri:style
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| height | Defina a altura da visualização do mapa. Valores: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels Exemplos: | Aplicativo de campo |
lineColor2 fillColor3 | Especifique as cores de linha e preenchimento para a feição de linha ou polígono. Isso se aplica à visualização do mapa somente no Survey123. Para obter mais informações, consulte Simbologia da geometria. Valores: <HTML color name> | <hex color code> Exemplo: | Survey123 Mobile Aplicativo de campo |
| lineWidth2 | Especifique a largura da linha em pixels para a feição de linha ou polígono. Isso se aplica à visualização do mapa somente no Survey123. Valor: <pixels> Exemplos: | Survey123 Mobile Aplicativo de campo |
| map | Definir um mapa base padrão. Valores: <map name> | <map item ID> Exemplos: | Aplicativo da web Aplicativo de campo |
mapTools | Controle as ferramentas de mapa que estão disponíveis para questões de ponto geográfico, traço geográfico e forma geográfica. Valores: search | mapSwitcher | zoom | home | locate Exemplos: | Aplicativo de campo |
| method2 | Especifique o método de captura. Ao usar o método de vértice, parâmetros adicionais podem ser definidos. Valores: sketch | vertex Valores adicionais para vértice, aplicáveis apenas no aplicativo de campo: streaming | beep | haptic | edit Exemplos: | Aplicativo da web Aplicativo de campo |
| minCaptureZoomLevel | Especifique o nível mínimo no qual a geometria pode ser capturada. Valor: <integer> Exemplo: | Aplicativo da web |
| overlay | Exiba localizações de pontos da primeira pergunta de ponto geográfico em uma repetição em qualquer outra pergunta de ponto geográfico, forma geográfica ou traçado geográfico em sua pesquisa. Acrescente propriedades para definir o conteúdo e o estilo. Valor: <repeat name> Propriedades: view | preview | icon | iconColor | iconOutlineColor | iconSize | label | labelColor | labelOutlineColor | fontSize Exemplos: | Aplicativo de campo |
precision | Especifique o número de casas decimais que serão capturadas na pergunta do mapa e mostradas no painel de resposta individual da pesquisa. Quando este parâmetro não está definido, todas as casas decimais disponíveis são capturadas na pergunta do mapa, mas apenas seis casas decimais serão mostradas no painel de resposta individual. Valor: <integer> Exemplo: | Aplicativo da web |
| snapMode | Especifique o comportamento de ajuste. Pontos podem ser ajustados a outras feições e linhas e polígonos podem ser ajustados a outras feições ou a si mesmos. Disponível apenas quando method=vertex. Valores: feature | self2 Exemplo: | Aplicativo da web |
| symbol1 | Especifique um arquivo .png para usar como marcador de ponto no mapa. Anexe propriedades para definir a posição e a escala. Valor: <file name>.png Propriedades: x | y | scale Exemplo: | Aplicativo de campo |
1—suportado apenas com o tipo de pergunta de ponto geográfico.
2—suportado apenas com o tipo de pergunta de forma geográfica e traçado geográfico.
3—suportado apenas com o tipo de pergunta de forma geográfica.
Perguntas de múltipla escolha
A tabela a seguir descreve o parâmetro que você pode usar na coluna parameters do XLSForm para os tipos de pergunta select_one, select_multiple e rank.
parameters
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| randomizar | Randomize a ordem das escolhas em uma lista de opções. Valores: true Exemplo: | Aplicativo da web Aplicativo de campo |
Intervalo
Esta seção descreve os parâmetros que você pode usar nas colunas do XLSForm especificadas para o tipo de pergunta range. Ao combinar, os parâmetros devem ser separados por um espaço.
A tabela a seguir descreve os parâmetros que você pode usar na coluna body::esri:style do XLSForm. Para obter mais informações, consulte Opções de estilo.
body::esri:style
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
startColor endColor color | Especifique as cores para o controle deslizante de intervalo:
Valores: <HTML color name> | <hex color code> Exemplos: | Survey123 Mobile Aplicativo da web Aplicativo de campo |
A tabela a seguir descreve os parâmetros que você pode usar na coluna parameters do XLSForm para o tipo de pergunta range. Para mais informações, consulte Parâmetros do controle deslizante de intervalo.
parameters
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
start end step | Especifique os valores inicial, final e de etapa do controle deslizante de intervalo. Valores: <integer> | <decimal> Exemplos: | Survey123 Mobile Aplicativo da web Aplicativo de campo |
Repetições
Esta seção descreve os parâmetros que você pode usar nas colunas do XLSForm especificadas para o tipo de pergunta begin repeat.
A tabela a seguir descreve os parâmetros que você pode usar na coluna bind::esri:parameters do XLSForm.
bind::esri:parameters
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| allowAdds | Permitir que novos registros repetidos sejam adicionados. Valores: true | false Exemplo: | Aplicativo de campo |
| allowUpdates | Permitir que os registros repetidos existentes sejam modificados. Valores: true | false Exemplo: | Aplicativo de campo |
| query | Permitir que os registros repetidos existentes sejam mostrados no formulário. Especifique parâmetros de consulta adicionais para filtrar os registros disponíveis. Valores: <none> | "SQL statement" Exemplos: | Aplicativo de campo |
A tabela a seguir descreve os parâmetros que você pode usar na coluna body::esri:style do XLSForm para o tipo de pergunta begin repeat.
body::esri:style
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| backgroundColor borderColor | Defina as cores do plano de fundo e da borda para uma repetição. Para obter mais informações, consulte Grupo, página e cores repetidas. Valores: <HTML color name> | <hex color code> Exemplos:
| Survey123 Mobile Aplicativo de campo |
Para uma repetição com aparência tabular, especifique o modo para o botão Adicionar registro e a opção Copiar para novo registro na visualização tabular. O padrão é row. Quando o valor é row, o novo registro é anexado à visualização tabular. Quando o valor é form, o novo registro é aberto na visualização de formulário. Valores: row | form Exemplo: | Survey123 Mobile | |
Para uma repetição com aparência tabular, mostre ou oculte a opção Editar na visualização de formulário na visualização tabular. O padrão é true. Anotação:Quando a repetição apresenta erros, a opção Editar na visualização de formulário é habilitada mesmo quando o parâmetro editInFormView está definido como false. Valores: true | false Exemplo: | Survey123 Mobile | |
Para uma repetição com aparência tabular, mostre ou oculte a opção Copiar para novo registro na visualização tabular. Esta opção permite aos usuários duplicar um registro na repetição. O padrão é true. O parâmetro addRecordMode determina como o registro duplicado é adicionado. Valores: true | false Exemplo: | Survey123 Mobile | |
Para uma repetição com aparência tabular, habilite ou desabilite a edição na visualização tabular. O padrão é true. Quando o valor é false, todas as células na visualização tabular são de somente leitura. Valores: true | false Exemplo: | Survey123 Mobile |
A tabela a seguir descreve o parâmetro que você pode usar na coluna body::esri:style do XLSForm para perguntas em repetições tabulares.
body::esri:style
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
Para uma repetição com aparência tabular, mostre a pergunta como uma coluna na visualização tabular. O padrão é false. Valores: true | false Exemplo: | Survey123 Mobile |
Texto
Esta seção descreve os parâmetros que você pode usar nas colunas do XLSForm especificadas para o tipo de pergunta text.
A tabela a seguir descreve os parâmetros que você pode usar na coluna bind::esri:parameters do XLSForm.
bind::esri:parameters
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| geocodificar | Para uma pergunta de texto com aparência de geocódigo, defina o localizador para retornar resultados geocodificados ao usar a aparência de geocódigo. Valor: <locator item ID> Exemplo: | Aplicativo da web Aplicativo de campo |
A tabela a seguir descreve os parâmetros que você pode usar na coluna body::esri:style do XLSForm para o tipo de pergunta text.
body::esri:style
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
| defaultHeight | Para uma pergunta de texto com aparência de várias linhas, defina a altura inicial da caixa de texto. A altura da caixa de texto aumentará para acomodar o texto de resposta. Valor: <number of lines> Exemplo: | Aplicativo de campo |
| indicator | Para uma pergunta de texto com aparência de geocódigo, permita que os resultados geocodificados mostrem a direção e a distância da localização atual do dispositivo. Valores: direction | distance | none Exemplos: | Aplicativo de campo |
| maxResults | Para uma pergunta de texto com aparência de geocódigo, especifique o número máximo de resultados a serem retornados. O padrão é 6. Valor: <number of results> Exemplo: | Aplicativo da web Aplicativo de campo |
| proximidade | Para uma pergunta de texto com aparência de geocódigo, especifique se os resultados geocodificados mostram apenas resultados dentro de um determinado raio da localização do dispositivo. Valores: <distance>m | km | ft | mi | yd Exemplos: | Aplicativo de campo |
| sugestões | Para uma pergunta de texto com aparência de geocódigo, altere a maneira como as sugestões são preenchidas. O padrão é Sim. Valores: yes | no Exemplo: | Aplicativo de campo |
Telêmetro
A tabela a seguir descreve o parâmetro que você pode usar na coluna bind::esri:parameters do XLSForm para os tipos de pergunta text, integer e decimal, para obter valores de um medidor de distância a laser.
bind::esri:parameters
| Parâmetro | Descrição | Aplicativo de envio |
|---|---|---|
medição | Para uma pergunta de texto, decimal ou inteiro com aparência de telêmetro, defina quais medidas serão armazenadas na pergunta. Coloque a lista de valores entre aspas se os valores incluírem espaços. Valores: height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights Exemplos: | Aplicativo de campo |