Voltar

Expressões do relatório

Neste tópico

  1. Métodos de expressão
  2. Palavras-chaves da expressão

A resposta a uma pergunta pode ser exibida em um modelo de relatório fornecendo seu nome entre chaves {} e precedido por um cifrão. Qualquer valor de string incluído em uma expressão deve ser colocado entre aspas duplas.

O seguinte exemplo exibe a resposta de uma pergunta de um texto denominada firstname:

${firstname}

Além de exibir a resposta a uma pergunta em um relatório, palavras-chaves podem ser usadas para exibir outras informações úteis. O seguinte exibe a data e hora atuais ao imprimir um relatório:

${$date}

Se o resultado for uma matriz, a matriz poderá ser iterada usando # como tag inicial e /como tag final entre chaves. O seguinte imprime todos os arquivos de imagem em linhas separadas:

${#image1}
${$file}
${/}

Você também pode usar expressões para refinar a maneira como as respostas são exibidas. Uma expressão pode ser um único nome de pergunta ou palavra-chave (como acima), um cálculo envolvendo uma ou mais perguntas ou palavras-chaves, ou um nome de pergunta ou palavra-chave com métodos e parâmetros para restringir ou aplicar estilo à resposta. Uma expressão usa a seguinte notação:

${questionname or keyword | method:parameter}

Uma expressão pode incluir vários métodos e parâmetros ou nenhum. Os parâmetros podem ser valores de outras perguntas ou um valor fixo.

A seguinte expressão exibe o cálculo de uma pergunta de número denominada floweringtrees dividida por uma pergunta de número denominada totaltrees. Ao fazer referência a várias perguntas na mesma expressão, os nomes das perguntas individuais precisam apenas ser nomeados diretamente e não precisam de colchetes adicionais.

${floweringtrees / totaltrees}

A expressão a seguir exibe o valor da coordenada x da pergunta de localização em que getValue é o método e x é o parâmetro:

${location | getValue:"x"}

A expressão a seguir será avaliada como verdadeira se a resposta a uma pergunta denominada fruitcolor não for igual a red:

${if fruitcolor!="red"}The fruit is not red.${/}

Strings podem ser concatenadas em uma expressão juntando-as com um sinal de mais. Essa expressão usa essa concatenação para passar o conteúdo de uma pergunta denominada field_0 para um serviço de geração de código QR, criando um código QR para a resposta da pergunta:

${$image | src:"https://barcode.tec-it.com/barcode.ashx?code=QRCode&data="+field_0}

Exemplos de expressões para cada tipo de pergunta estão disponíveis nos seguintes tópicos:

  • Expressões de texto
  • Expressões de número
  • Imagens e outras expressões de anexo
  • Expressões de mapa (inclui ponto geográfico, traço geográfico e forma geográfica)
  • Data, hora e expressões de data e hora
  • Expressões de opção
  • Expressões de repetição

Métodos de expressão

Nem todos os tipos de perguntas oferecem suporte a expressões e métodos. A seguinte tabela lista quais métodos e parâmetros você pode usar com vários tipos de perguntas:

MétodoParâmetroTipo de pergunta do ConnectTipo de pergunta do web designerDescrição

getValue

-

Todos os tipos de perguntas

Todos os tipos de perguntas

Recupera o valor dos dados brutos da camada de feição ou imagem bruta de um anexo.

getValue

x, y, z, wkid

ponto geográfico

Mapa

Recupera as coordenadas x, y, z individualmente em uma referência espacial especificada. O parâmetro wkid é opcional e seu valor será o mesmo que a referência espacial da camada de feição se omitido.

getValue

tipo de medição, unidade, área, comprimento

traçado geográfico, formato geográfico

Mapa

Retorna o comprimento de uma polilinha, ou o perímetro ou área de um polígono, em unidades fornecidas e especifica se as medidas são planas ou geodésicas. O tipo de medição padrão é geodésico.

getValue

nome, tamanho

imagem, áudio arquivo

Imagem, Assinatura, Áudio, Arquivo

Retorna o nome de arquivo ou tamanho de um anexo.

getValue

largura, altura, x, y, data, hora, direção

imagem

Imagem, Assinatura

A largura e altura retornam o valor inteiro da largura e altura da imagem em pixels, e x, y, data, hora e direção, retornam valores lidos da imagem EXIF, se houver.

getValue

contagem

começar repetição, imagem, áudio, arquivo

Repetir, Imagem, Assinatura, Áudio, Arquivo

Retorna a contagem total de repetições ou anexos.

getValue

posição

começar repetição, imagem, áudio, arquivo

Repetir, Imagem, Assinatura, Áudio, Arquivo

Retorna um número inteiro igual à posição indexada em 1 na matriz.

getValue

duração

áudio, arquivo

Áudio, Arquivo

Retorna a duração das gravações de áudio em segundos.

Aviso:

A duração não é retornada nas respostas coletadas no aplicativo da web ao usar Safari.

aparência

múltiplas linhas

texto

Texto de múltiplas linhas

Mantém as quebras de linha na string. Se nenhum valor de aparência for especificado, uma única string de linha será retornada.

aparência

marcadores

select_multiple

Múltipla seleção

Retorna uma resposta em formato de bala.

marcado

opção de nome

select_one, select_multiple

Múltipla seleção, Única seleção, Grade de única seleção, Lista Suspensa, Escala de Likert, Classificação

Retorna uma caixa de seleção marcada se o valor do campo for igual ao nome da opção; caso contrário, retorna uma caixa de seleção desmarcada.

selecionado

opção de nome

select_one, select_multiple

Múltipla seleção, Única seleção, Grade de única seleção, Lista Suspensa, Escala de Likert, Classificação

Se existir domínio de valor codificado, retorna verdadeiro se o valor do campo for igual ao valor de nome da opção; caso contrário, retorna falso.

countSelected

-

select_one, select_multiple

Múltipla seleção, Única seleção, Grade de única seleção, Lista Suspensa, Escala de Likert, Classificação

Retorna o número de opções selecionadas.

selectedAt

Índice

select_one, select_multiple

Múltipla seleção, Única seleção, Grade de única seleção, Lista Suspensa, Escala de Likert, Classificação

Retorna a string na posição de índice na lista de opções. O índice começa no zero.

local

código do idioma

data, dataHora, início, término, decimal

Data, Data e Hora, Número

Retorna data, hora e número localizados.

formato

formato da string

data, dateTime, integero, decimal, inicial, final

Data, Data e Hora

Retorna uma string de data formatada.

utcOffset

valor de deslocamento

data, dateTime, inicial, final

Data, Data e Hora

Retorna um valor de data ou data-hora que é deslocado pelo valor de deslocamento UTC.

mapSettings

ID do item de mapa da web, escala do mapa

ponto geográfico, traço geográfico, forma geográfica

Mapa

Especifica o mapa base e a escala ao imprimir a imagem do mapa.

Validado:

Este método foi substituído por map e mapScale.

mapExtent

xmin, ymin, xmax, ymax, wkid

ponto geográfico, traço geográfico, forma geográfica

Mapa

Especifica a extensão do mapa fixa ao imprimir a imagem do mapa. O parâmetro wkid é opcional e será definido como 4326 (WGS84) se omitido.

mapa

ID do item de mapa da web

ponto geográfico, traço geográfico, forma geográfica

Mapa

Especifica o mapa base ao imprimir a imagem do mapa.

mapScale

escala do mapa

ponto geográfico, traço geográfico, forma geográfica

Mapa

Especifica a escala de mapa ao imprimir a imagem do mapa.

mapFilters

ID da camada no JSON de mapa da web, parâmetros de consulta

ponto geográfico, traço geográfico, forma geográfica

Mapa

Especifica um ou mais filtros de camadas de feição em um mapa da web ao imprimir a imagem do mapa.

rotacionar

graus

ponto geográfico, traço geográfico, forma geográfica, imagem

Mapa, Imagem

Especifica o ângulo de rotação do mapa ou imagem.

drawingInfo

currentLayer, URL da camada de feição

ponto geográfico, traço geográfico, forma geográfica

Mapa

Especifica as informações do desenho ao imprimir a imagem do mapa, incluindo símbolo, etiqueta e transparência.

src

URL da imagem

-

-

Especifica a URL de origem de um elemento de imagem dinâmica.

tamanho

largura, altura, largura máxima, altura máxima

imagem

Imagem

Especifica o tamanho da imagem impressa.

ao redor

lugares

decimal, ponto geográfico, traço geográfico, forma geográfica

Número

Arredonda um número decimal para casas decimais especificadas.

useGrouping

booleano

decimal

Número

Se verdadeiro, retorna um número com separadores de agrupamento determinados pela localidade, se falso, nenhum separador será usado.

toFixed

lugares

decimal, ponto geográfico, traço geográfico, forma geográfica

Número

Especifica um número fixo de dígitos após o separador decimal. Preencherá zero se necessário para atender a um número fixo de dígitos.

attachmentsDefExp

Expressões SQL

imagem, áudio arquivo

Imagem, Assinatura, Áudio, Arquivo

Identifica anexos para uma pergunta ou a feição atual usando a palavra-chave $attachment.

Palavras-chaves da expressão

A tabela a seguir lista todas as palavras-chaves que podem ser usadas em uma expressão.

Palavra-ChaveDescrição

$date

Insere a data e hora atuais ao imprimir o relatório. Por padrão, ele exibe a data atual usando o formato de localidade atual.

Exemplos:

${$date | format:"MM/DD/YYYY"}
$($date | utcOffset:"+08:00"}
$($date | locale:"zh-cn"}

$image

Insere um elemento de imagem no relatório. Use o método src para especificar a URL da imagem.

Exemplo:

${$image | src:"https://upload.wikimedia.org/wikipedia/commons/1/13/Esri_Headquarters%2C_Building_Q.jpg"}

$map

Insere um elemento de mapa no relatório sem fazer referência a uma pergunta da pesquisa.

Exemplo:

${$map | map:"10df2279f9684e4a9f6a7f08febac2a9" | mapScale:4000000 | size:200:100}

$shape

Imprime a geometria (ponto, polilinha ou polígono) da feição atual em um mapa.

Exemplos:

${$shape}
${$shape | map:"10df2279f9684e4a9f6a7f08febac2a9" | mapScale:4000000 | size:200:100}

$attachment

Representa o primeiro anexo ou todos os anexos da feição atual.

Exemplos:

${$attachment | getValue:"name"}
${$attachment | getValue:"size"}
${$attachment | size:200:300}

Para iterar todos os anexos, inclua tags inicial e final:

${#$attachment}
${$file}
${/}

$file

Representa o arquivo atual ao iterar vários arquivos de uma pergunta de pesquisa de anexo ou anexos de uma feição.

Exemplos:

${#image1}
${$file | size:460:0}
{/}

${#$attachment}
${$file | getValue:"position"}. ${$file | getValue:"name"}
${/}

$feature

Representa a feição atual em uma matriz de feições.

Exemplo:

{#repeat1}
{$feature | getValue: "position"}
{/}

$layers["<layername>"] ou

$layers[<layerId>]

Referencia qualquer camada por nome ou ID no mesmo serviço da feição que a camada de pesquisa.

Exemplos:

${$layers["cities"] | where:”1=1 !important” | stats:”count,objectid”}
${#$layers["states"]}...${/}

Comentário neste tópico?

Neste tópico
  1. Métodos de expressão
  2. Palavras-chaves da expressão