Wróć do początku

Wyrażenia raportu

W tym temacie

  1. Metody wyrażeń
  2. Słowa kluczowe wyrażeń

Odpowiedź na pytanie może zostać wyświetlona w szablonie raportu przez podanie jej nazwy ujętej w nawiasy klamrowe {} i poprzedzonej znakiem dolara. Każda wartość znakowa zawarta w wyrażeniu musi być ujęta w podwójny cudzysłów.

Poniższy przykład ilustruje wyświetlenie odpowiedzi na pytanie typu tekst o nazwie firstname:

${firstname}

Słów kluczowych można używać nie tylko do wyświetlania w raporcie odpowiedzi na pytanie, ale także do wyświetlania innych użytecznych informacji. Następujące wyrażenie powoduje wyświetlenie bieżącej daty i godziny podczas drukowania raportu:

${$date}

Jeśli wynik jest tablicą, wykonywanie iteracji na tablicy umożliwiają symbol # jako znacznik początkowy oraz symbol / jako znacznik końcowy umieszczone w nawiasach klamrowych. Następujące wyrażenie powoduje wydrukowanie wszystkich obrazów w oddzielnych wierszach:

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

Za pomocą wyrażeń można także doprecyzowywać sposób wyświetlania odpowiedzi. Wyrażeniem może być jedna nazwa pytania lub słowo kluczowe (jak powyżej), obliczenie obejmujące jedno lub więcej pytań lub słów kluczowych albo nazwa pytania lub słowo kluczowe z metodami i parametrami do ograniczenia lub zastosowania stylu względem odpowiedzi. W wyrażeniu jest stosowana następująca notacja:

${questionname or keyword | method:parameter}

Wyrażenie może zawierać wiele metod i parametrów lub może wcale ich nie zawierać. Parametry mogą być albo wartościami pochodzącymi z innych pytań, albo wartościami stałymi.

Poniższe wyrażenie powoduje wyświetlenie obliczenia wyniku dzielenia pytania typu liczba o nazwie floweringtrees przez pytanie typu liczba o nazwie totaltrees. Przy odwoływaniu się do wielu pytań w tym samym wyrażeniu poszczególne nazwy pytań wymagają bezpośredniego nazwania i nie są potrzebne dodatkowe nawiasy klamrowe:

${floweringtrees / totaltrees}

Poniższe wyrażenie powoduje wyświetlenie wartości współrzędnej x z pytania o lokalizację, w którym getValue jest metodą, a x jest parametrem:

${location | getValue:"x"}

Poniższe wyrażenie przyjmie wartość true (prawda), jeśli odpowiedź na pytanie o nazwie fruitcolor nie jest równa red:

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

Ciągi znakowe można sklejać w wyrażeniu, łącząc je za pomocą znaku plus. W następującym wyrażeniu konkatenacja (czyli sklejenie ciągów znakowych) umożliwia przekazanie treści pytania o nazwie field_0 do usługi generowania kodów QR w celu utworzenia kodu QR dla odpowiedzi na pytanie:

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

Przykładowe wyrażenia dla każdego typu pytania są dostępne w następujących tematach:

  • Wyrażenia tekstowe
  • Wyrażenia liczbowe
  • Wyrażenia obrazów i wyrażenia z innymi załącznikami
  • Wyrażenia map w tym geopoint (punkt geograficzny), geotrace (ślad geograficzny) i geoshape (kształt geograficzny)
  • Wyrażenia daty, czasu i daty-czasu
  • Wyrażenia wyboru
  • Wyrażenia powtórzenia

Metody wyrażeń

Nie wszystkie typy pytań obsługują wyrażenia i metody. Poniższa tabela zawiera listę metod i parametrów, które mogą być używane z różnymi typami pytań:

MetodaParametrTyp pytania w aplikacji ConnectTyp pytania w kreatorze internetowymOpis

getValue

-

Wszystkie typy pytań

Wszystkie typy pytań

Pobiera wartość nieprzetworzonych danych z warstwy obiektowej lub nieprzetworzony obraz z załącznika.

getValue

x, y, z, wkid

punkt geograficzny

Mapa

Pobiera poszczególne współrzędne x, y oraz z w podanym odniesieniu przestrzennym. Parametr wkid jest opcjonalny i jeśli zostanie pominięty, jego wartość jest taka sama jak odniesienie przestrzenne warstwy obiektowej.

getValue

długość, pole powierzchni, jednostka, typ pomiaru

ślad geograficzny, kształt geograficzny

Mapa

Zwraca długość polilinii albo obwód lub pole powierzchni poligonu w podanych jednostkach, a także informacje o tym, czy pomiary są planarne, czy geodezyjne. Domyślny typ to pomiar geodezyjny.

getValue

nazwa, rozmiar

obraz, dźwięk, plik

Obraz, Podpis, Dźwięk, Plik

Zwraca nazwę pliku lub rozmiar załącznika.

getValue

szerokość, wysokość, x, y, data, czas, kierunek

image

Obraz, Podpis

Szerokość i wysokość zwracają wartość całkowitą szerokości i wysokości obrazu w pikselach, a x, y, data, czas i kierunek zwracają wartości odczytane z informacji EXIF obrazu, jeśli istnieją.

getValue

liczba

rozpocznij powtórzenie, obraz, dźwięk, plik

Powtórzenie, Obraz, Podpis, Dźwięk, Plik

Zwraca łączną liczbę powtórzeń lub załączników.

getValue

pozycja

rozpocznij powtórzenie, obraz, dźwięk, plik

Powtórzenie, Obraz, Podpis, Dźwięk, Plik

Zwraca liczbę całkowitą równą pozycji w tablicy o indeksach rozpoczynających się od 1.

getValue

czas trwania

dźwięk, plik

Dźwięk, Plik

Zwraca długość nagrań dźwiękowych w sekundach

Uwaga:

Czas trwania nie jest zwracany w odpowiedziach zgromadzonych w aplikacji internetowej, jeśli jest używana przeglądarka Safari.

appearance

multiline (wielowierszowe)

text

Tekst wielowierszowy

Zachowuje podział wierszy w ciągu znakowym. Jeśli nie zostanie podana wartość wyglądu, zwracany jest jednowierszowy ciąg znakowy.

appearance

punktory

select_multiple

Wybór wielokrotny

Zwraca odpowiedź w formacie listy wypunktowanej.

zaznaczone

nazwa możliwości wyboru

select_one, select_multiple

Wybór wielokrotny, Wybór pojedynczy, Siatka typu Wybór pojedynczy, Menu rozwijane, Skala Likerta, Ocena

Zwraca zaznaczone pole wyboru, jeśli wartość pola jest równa nazwie możliwości wyboru, w przeciwnym razie zwraca niezaznaczone pole wyboru.

wybrane

nazwa możliwości wyboru

select_one, select_multiple

Wybór wielokrotny, Wybór pojedynczy, Siatka typu Wybór pojedynczy, Menu rozwijane, Skala Likerta, Ocena

Jeśli istnieje domena wartości kodowych, zwraca wartość true (prawda), jeśli wartość pola jest równa nazwie możliwości wyboru, w przeciwnym razie zwraca wartość false (fałsz).

countSelected

-

select_one, select_multiple

Wybór wielokrotny, Wybór pojedynczy, Siatka typu Wybór pojedynczy, Menu rozwijane, Skala Likerta, Ocena

Zwraca liczbę wybranych możliwości wyboru.

selectedAt

indeks

select_one, select_multiple

Wybór wielokrotny, Wybór pojedynczy, Siatka typu Wybór pojedynczy, Menu rozwijane, Skala Likerta, Ocena

Zwraca ciąg znakowy w pozycji indeksu na liście wyboru. Indeks rozpoczyna się od zera.

ustawienia regionalne

kod języka

data, dateTime (data i czas), początek, koniec, decimal

Data, Data i czas, Liczba

Zwraca zlokalizowaną datę, czas i liczbę.

format

formatuj ciąg znakowy

data, dateTime (data i czas), liczba całkowita, liczba dziesiętna, początek, koniec

Data, Data i czas

Zwraca sformatowany ciąg znakowy

utcOffset

wartość przesunięcia

data, dateTime (data i czas), początek, koniec

Data, Data i czas

Zwraca wartość daty lub daty i czasu przesuniętą o wartość przesunięcia UTC.

mapSettings

ID elementu mapy internetowej, skala mapy

geopoint (geopunkt), geotrace (ślad geograficzny), geoshape (kształt geograficzny)

Mapa

Określa mapę bazową i skalę przy drukowaniu obrazu mapy.

Wcześniejsze:

Ta metoda została zastąpiona przez map i mapScale.

mapExtent

xmin, ymin, xmax, ymax, wkid

geopoint (geopunkt), geotrace (ślad geograficzny), geoshape (kształt geograficzny)

Mapa

Określa ustalony zasięg mapy przy drukowaniu obrazu mapy. Parametr wkid jest opcjonalny i w przypadku jego pominięcia jest konfigurowany na wartość 4326 (WGS84).

mapa

ID elementu mapy internetowej

geopoint (geopunkt), geotrace (ślad geograficzny), geoshape (kształt geograficzny)

Mapa

Określa mapę bazową przy drukowaniu obrazu mapy.

mapScale

skala mapy

geopoint (geopunkt), geotrace (ślad geograficzny), geoshape (kształt geograficzny)

Mapa

Określa skalę przy drukowaniu obrazu mapy.

mapFilters

identyfikator warstwy w pliku JSON mapy internetowej, parametry zapytania

geopoint (geopunkt), geotrace (ślad geograficzny), geoshape (kształt geograficzny)

Mapa

Określa jeden lub większą liczbę filtrów warstw obiektowych na mapie internetowej przy drukowaniu obrazu mapy.

obróć

stopnie

geopoint (geopunkt), geotrace (ślad geograficzny), geoshape (kształt geograficzny), image (obraz)

Mapa, Obraz

Określa kąt obrotu mapy lub obrazu.

drawingInfo (informacje o rysunku)

currentLayer (bieżąca warstwa), adres URL warstwy obiektowej

geopoint (geopunkt), geotrace (ślad geograficzny), geoshape (kształt geograficzny)

Mapa

Określa informacje o rysunku przy drukowaniu obrazu mapy, włącznie z symbolem, etykietą i przezroczystością.

src

adres URL obrazu

-

-

Określa źródłowy adres URL dynamicznego elementu obrazu.

rozmiar

szerokość, wysokość, szerokość maksymalna, wysokość maksymalna

image

Obraz

Określa rozmiar drukowanego obrazu.

okrągłe

miejsca

liczba dziesiętna, geopoint (geopunkt), geoshape (kształt geograficzny), geotrace (ślad geograficzny)

Numer

Służy do zaokrąglania liczby dziesiętnej do podanych miejsc dziesiętnych.

useGrouping

wartość logiczna

decimal

Numer

Jeśli ma wartość true, zwracana jest liczba z separatorami grupowania określonymi przez ustawienia regionalne. Jeśli ma wartość false, separatory nie są używane.

toFixed

miejsca

liczba dziesiętna, geopoint (geopunkt), geoshape (kształt geograficzny), geotrace (ślad geograficzny)

Numer

Określa stałą liczbę cyfr po separatorze dziesiętnym. Jeśli będzie to konieczne, nastąpi dopełnienie zerami, aby osiągnąć stałą liczbę cyfr.

attachmentsDefExp

Wyrażenia SQL

obraz, dźwięk, plik

Obraz, Podpis, Dźwięk, Plik

Identyfikuje załączniki dla pytania lub bieżącego obiektu za pomocą słowa kluczowego $attachment.

Słowa kluczowe wyrażeń

Poniższa tabela zawiera wszystkie słowa kluczowe, których można użyć w wyrażeniu:

Słowo kluczoweOpis

$date

Wstawia bieżącą datę i godzinę podczas drukowania raportu. Domyślnie bieżąca data jest wyprowadzana w formacie bieżących ustawień narodowych.

Przykłady:

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

$image

Wstawia w raporcie element obrazu. Adres URL obrazu można określić za pomocą metody src.

Przykład:

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

$map

Wstawia element mapy w raporcie bez odwoływania się do pytania w ankiecie.

Przykład:

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

$shape

Drukuje geometrię (punkt, polilinia lub poligon) bieżącego obiektu na mapie.

Przykłady:

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

$attachment

Reprezentuje pierwszy załącznik lub wszystkie załączniki bieżącego obiektu.

Przykłady:

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

Aby wykonać iteracje po wszystkich załącznikach, należy dołączyć znaczniki początkowy i końcowy.

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

$file

Reprezentuje bieżący plik podczas iteracyjnego przetwarzania wielu plików załącznika pytania ankiety lub załączników obiektu.

Przykłady:

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

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

$feature

Reprezentuje bieżący obiekt w tablicy obiektów.

Przykład:

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

$layers["<nazwa_warstwy>"] lub

$layers[<id_warstwy>]

Odnosi się do dowolnej warstwy według nazwy lub identyfikatora w tej samej usłudze obiektowej co warstwa ankiety.

Przykłady:

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

Opinia na ten temat?

W tym temacie
  1. Metody wyrażeń
  2. Słowa kluczowe wyrażeń