As colunas personalizadas da Esri para XLSForm fornecem funcionalidade adicional para usuários do Survey123 .
Tipo de campo
Use a coluna personalizada bind::esri:fieldType para controlar o tipo e comprimento de um campo a ser criado no ArcGIS para perguntas da pesquisa. Para obter mais informações sobre os tipos de campo suportados, consulte Tipos de dados de campo ArcGIS.
Para algumas perguntas, você pode alterar o tipo de campo que o Survey123 atribui por padrão. A tabela a seguir lista alguns exemplos:
| Tipo de perguntas | Tipo de campo padrão | Comentários |
|---|---|---|
select_one | esriFieldTypeString | Para garantir que a escolha seja armazenada como um número inteiro, altere para esriFieldTypeInteger. |
date | esriFieldTypeDate | esriFieldTypeDate sempre inclui um elemento de tempo. Para armazenar apenas uma data, mude para esriFieldTypeDateOnly. |
dateTime | esriFieldTypeDate | esriFieldTypeDate não fornece indicação de fuso horário. Para incluir o fuso horário no campo, altere para esriFieldTypeTimestampOffset. Quando esriFieldTypeTimestampOffset é definido, um seletor de fuso horário é exibido no formulário para a pergunta dateTime. O fuso horário atual do dispositivo será aplicado por padrão. |
time | esriFieldTypeString | Para armazenar o tempo como um valor de tempo, altere para esriFieldTypeTimeOnly. |
Para controlar o tipo de campo, forneça um dos seguintes valores na coluna bind::esri:fieldType:
- esriFieldTypeString
- esriFieldTypeDate
- esriFieldTypeDateOnly
- esriFieldTypeTimeOnly
- esriFieldTypeTimestampOffset
- esriFieldTypeInteger
- esriFieldTypeBigInteger
- esriFieldTypeSingle
- esriFieldTypeDouble
- esriFieldTypeSmallInteger
- esriFieldTypePointZ
- esriFieldTypeGUID
Note que bind::esri:fieldType controla somente o tipo de campo criado na camada de feição. Para controlar o tipo de campo para uma pergunta durante uma pesquisa, utilize a coluna bind::type . Por exemplo, fornecer o valor int na coluna bind::type para uma pergunta calculate trata o campo como um inteiro, ao invés de seu tipo de campo padrão de string. Os valores aceitos pela coluna bind::type são os seguintes:
- int
- decimal
- texto
- data
- dateTime
- hora
A coluna bind::esri:fieldType também aceita o valor null, o que faz com que a pergunta seja omitida na camada de feição criada. Embora a pergunta ainda esteja presente na pesquisa e se comporte normalmente, a resposta não é enviada à camada de feição e não fica presente ao revisar as respostas. Isso é ideal para cálculos, restrições ou outras questões que devem estar presentes para fins de apresentação, mas não são necessários nos resultados.
Os seguintes tipos de perguntas não suportam um tipo de campo nulo:
- select_one or other
- select_multiple or other
- hidden
Anotação:
As perguntas de ponto geográfico, traço geográfico e forma geográfica suportam um tipo de campo nulo somente se a pesquisa incluir pelo menos uma outra pergunta de ponto geográfico, traço geográfico e forma geográfica que não tenha um tipo de campo nulo ou se o ponto geográfico, traço geográfico e forma geográfica estiver repetido.
Comprimento do campo
Use a coluna personalizada bind::esri:fieldLength para controlar o comprimento dos campos de string (texto) a serem criados no ArcGIS para perguntas da sua pesquisa.
Anotação:
Você não pode controlar pergntas de inteiro e decimal desta maneira. Os bancos de dados não especificam o comprimento de um campo numérico; o intervalo de valores válidos é regido pelo tipo de campo numérico. Por exemplo, um campo inteiro armazena qualquer valor inteiro entre -2.147.483.648 e 2.147.483.647.
Nomes alternativos do campo
Por padrão, um nome alternativo do campo de pesquisa herda o mesmo valor que o rótulo de campo, referido principalmente quando a pesquisa é aberta no ArcGIS. Você pode alterar isto fornecendo um valor na coluna bind::esri:fieldAlias, que então se torna o novo nome alternativo do campo.
Pelo fato das perguntas ocultas e calculadas não serem exibidas em um formulário, o conteúdo do campo de rótulo não é preservado. Isto significa que quando você visualiza os registros de pesquisa no site da web Survey123 ou ArcGIS, você visualiza o nome da pergunta exibido no cabeçalho da coluna para estes tipos de perguntas. Para forçar o cabeçalho da coluna a ocultar e calcular perguntas para mostrar um rótulo, utilize a coluna bind::esri:fieldAlias na planilha para especificar um rótulo.
Máscara de entrada
As máscaras de entrada fornecem um formato definido para perguntas de texto usando caracteres e símbolos. Quando você aplicar uma máscara de entrada para uma questão, todas as respostas devem seguir o padrão específico definido pela máscara de entrada. No aplicativo de campo Survey123 e no aplicativo da web, as respostas da pesquisa não podem ser enviadas até que todas as máscaras de entrada sejam satisfeitas.
Dica:
As máscaras de entrada só podem ser aplicadas ao tipo de pergunta text. Para tipos de perguntas integer ou decimal, utilize a coluna constraint limitar as respostas. Para mais informações, consulteRestrições.
Para aplicar uma máscara de entrada para pergunta, defina a máscara na coluna body::esri:inputMask. A seguinte tabela lista os caracteres e símbolos que você pode utilizar em uma máscara de entrada:
| Caractere | Significado |
|---|---|
| A | Caractere alfabético de ASCII exigido. Os caracteres podem ser de A até Z e de a até z. |
| a | Caractere alfabético de ASCII permitido mas não exigido. |
| N | Caractere alfanumérico de ASCII exigido. Os caracteres podem ser de A até Z, de a até z, e de 0 a 9. |
n | Caractere alfanumérico de ASCII permitido mas não exigido. |
X | Qualquer caractere não em branco exigido. |
x | Qualquer caractere não em branco permitido, mas não exigido. |
| 9 | Dígito ASCII exigido. Os dígitos podem ser de 0 a 9. |
0 | Dígito ASCII permitido mas não exigido. Os dígitos podem ser de 0 a 9. |
| D | Dígito ASCII exigido. Os dígitos podem ser de 1 a 9. |
d | Dígito ASCII permitido mas não exigido. Os dígitos podem ser de 1 a 9. |
# | Dígito ASCII, ou sinais de mais ou menos, permitidos, mas não exigidos. |
| A | Caractere hexadecimal exigido. Os caracteres podem ser de A até F, de a até f, e de 0 a 9. |
h | Caractere hexadecimal permitido mas não exigido. |
| B | Caractere binário exigido. Os caracteres podem ser de 0 a 1. |
b | Caractere binário permitido mas não exigido. |
| > | Todos os caracteres alfabéticos seguintes são de letra maiúscula. |
| < | Todos os caracteres alfabéticos seguintes são de letra minúscula. |
| ! | Troque a conversão de maiúscula e minúscula. |
| \ | Escape dos caracteres especiais listados acima para utilizá-los como separadores. |
A máscara consiste em uma sequência de caracteres e separadores, opcionalmente seguido por um ponto e vírgula para finalizar a máscara de entrada e um caractere a ser usado para espaços em branco. Os caracteres em branco são removidos do texto após a edição. A tabela seguinte lista máscaras de exemplo:
| Máscara de exemplo | Descrição |
|---|---|
| >A<xxxxxxxxxxxx | Texto que começa com uma letra maiúscula seguido por qualquer letra minúscula. |
| AAA-AAA-AAA;_ | Identificador exclusivo que usa traços como separadores, com um ponto e vírgula no final da máscara de entrada seguido por um sublinhado para representar cada caractere a ser preenchido. |
| B9.99;- | Representa uma valor de pH. O número é limitado para iniciar somente com 0 ou 1 e pode incluir somente 2 casas decimais. Um ponto e vírgula termina a máscara de entrada, seguido por um traço usado para representar cada caractere que deve ser preenchido. |
| 999-99-9999 | Número do Seguro Social dos Estados Unidos. |
| (999) 999-9999 | Número de telefone dos Estados Unidos. |
| 900 kg | Peso em quilogramas entre 0 e 999. |
| 99999 | Código postal de 5 dígitos dos Estados Unidos. |
| AAA | Código de aeroporto IATA. |
Fluxo de Trabalho
Use a coluna personalizada bind::esri:workflow para indicar que o campo pode ser preenchido a partir do mosaico de Telêmetro lançado da galeria. Esta coluna é suportada apenas por perguntas de texto e os seguintes valores são aceitos pela coluna bind::esri:workflow:
- rangefinderMode=height
- rangefinderMode=offset
- rangefinderMode=height,offset
- rangefinderMode=offset
Cada um dos valores rangefinderMode permite uma experiência de usuário semelhante para o trabalhador de campo. Após o fluxo de trabalho do telêmetro desejado for selecionado, o usuário será direcionado para selecionar uma pesquisa e tirar 1 a 3 fotos com o instrumento e, em seguida, a pesquisa é iniciada automaticamente para que o trabalhador de campo responda a quaisquer outras perguntas.
O valor rangefinderHeight é único, pois permite ao trabalhador de campo navegar por cada pergunta da pesquisa configurada para receber um valor de altura, usando as setas para frente e para trás. Depois que todas as alturas forem medidas, o trabalhador de campo toca em Concluído e prossegue com a pesquisa para responder a quaisquer outras perguntas.