Skip To Content

Używanie wyrażeń w języku Arcade z narzędziem Połącz obiekty

W skrzynce narzędziowej GeoAnalytics Tools dostępnych jest wiele narzędzi, które umożliwiają użycie wyrażeń.

Narzędzia GeoAnalytics Tools, w których używane są wyrażenia, mają różne zastosowania, a ponadto obowiązują w ich przypadku różne ograniczenia dotyczące możliwości stosowania wyrażeń. Wszystkie wyrażenia używane na serwerze ArcGIS GeoAnalytics Server obsługują język Arcade.

Dowiedz się więcej o funkcjach języka Arcade

Wyrażenia w narzędziu Połącz obiekty

W narzędziu Połącz obiekty wyrażenia są używane do określania warunków połączenia.

W niektórych przypadkach konieczne jest podanie warunku służącego do wyboru obiektów, które mają być uwzględnione w połączeniu. Możliwe jest wykonywanie prostych warunków połączenia (na przykład pole a > pole c), jak również warunków zaawansowanych. Warunki są porównywane z każdym obiektem w celu ustalenia, co podlega analizie. Obliczenia są wykonywane wtedy, gdy analiza jest uruchamiana na serwerze ArcGIS GeoAnalytics Server.

Notatka:
Narzędzie Złącz obiekty wymaga dwóch warstw wejściowych: warstwy docelowej i warstwy złączenia. W związku z tym w każdym wyrażeniu w języku Arcade używanym w narzędziu Połącz obiekty musi znajdować się informacja o tym, który zestaw danych jest używany. Na przykład operację obliczającą, czy znajdujące się w warstwie docelowej pole o nazwie field1 ma wartość większą niż wartość pola o nazwie field2 w warstwie połączenia, można wyrazić jako $target["field1"] > $join["field2"]. To wyrażenie różni się od wyrażeń używanych w innych narzędziach GeoAnalytics Tools, w przypadku których używany jest format $feature["fieldname"].

Wynikiem warunku połączenia musi być zawsze wartość prawda (true) lub fałsz (false). Przykłady wyrażeń znajdują się w poniższych sekcjach.

Przykłady operatorów i funkcji matematycznych

Wyrażenia mogą matematycznie przetwarzać liczby. Następująca tabela pokazuje przykłady dostępnych działań.

Dowiedz się więcej na temat działań matematycznych i funkcji dostępnych w języku Arcade.

OperatorObjaśnieniePrzykładWynik

a + b

a plus b

fieldname zawiera wartość 1,5.

$feature[„nazwa_pola”] + 2,5

4.0

a - b

a minus b.

fieldname zawiera wartość 3,3.

$target["fieldname"] - 2.2

1.1

a * b

a mnożone przez b.

fieldname zawiera wartość 2,0.

$join["nazwa_pola"] * 2,2

4.4

a / b

a dzielone przez b.

fieldname zawiera wartość 4,0.

$join["nazwa_pola"] / 1,25

3.2

abs(a)

Zwraca wartość bezwzględną (dodatnią) argumentu a.

fieldname zawiera wartość -1,5.

abs($target["nazwa_pola"])

1,5

log(a)

Zwraca logarytm naturalny (o podstawie e) argumentu a.

fieldname zawiera wartość 1.

log($join["nazwa_pola"])

0

sin(a)

Zwraca wartość funkcji trygonometrycznej sinus dla argumentu a. Przyjmuje się, że argument wejściowy jest kątem wyrażonym w radianach.

fieldname zawiera wartość 1,5707.

sin($target["nazwa_pola"])

1

cos(a)

Zwraca wartość funkcji trygonometrycznej cosinus dla argumentu a. Przyjmuje się, że argument wejściowy jest kątem wyrażonym w radianach.

fieldname zawiera wartość 0.

cos($join["nazwa_pola"])

1

tan(a)

Zwraca wartość funkcji tangens dla argumentu a. Przyjmuje się, że argument wejściowy jest kątem wyrażonym w radianach.

fieldname zawiera wartość 0.

tan($target["nazwa_pola"])

0

sqrt(a)

Zwraca pierwiastek kwadratowy z argumentu a.

fieldname zawiera wartość 9.

sqrt($join["nazwa_pola"])

3

min(a, b)

Zwraca najmniejszą wartość spośród argumentów a i b.

fieldname zawiera wartości 1,5 i wartość -3.

min($join["nazwa_pola"], -3)

-3

max(a, b)

Zwraca największą wartość spośród argumentów a i b.

fieldname1 zawiera wartość 1,5, a pole fieldname2 zawiera wartość -3.

max($target["nazwa_pola1"], $join["nazwa_pola2"])

1,5

constrain(<value>,<low>,<high>)

Zwraca wartość wejściową, jeśli mieści się ona w podanych granicach. Jeśli wartość wejściowa jest mniejsza niż wartość minimalna, zwracana jest wartość minimalna. Jeśli wartość wejściowa jest większa od wartości maksymalnej, zwracana jest wartość maksymalna.

constrain($target["odległość"], 0, 10)

constrain($join['Store dist'], 6, odległość)

Zwraca wartość 0, jeśli wartość distance jest mniejsza niż 0, wartość 10, jeśli wartość distance jest większa niż 10 oraz wartość distance, gdy nie zachodzi żaden z poprzednich przypadków.

Zwraca wartość 6, jeśli wartość Store dist jest mniejsza niż 6, wartość distance, jeśli wartość Store dist jest większa niż distance oraz wartość Store dist, gdy nie zachodzi żaden z poprzednich przypadków.

Przykład mnożenia w wyrażeniu warunku połączenia, w którym używane jest pole z docelowego zestawu danych.

$target["Distance"] * 2 > $join["DistField"]

Przykłady funkcji tekstowych

Wyrażenia warunku połączenia mogą przetwarzać tekst. Następująca tabela pokazuje przykłady dostępnych działań.

Dowiedz się więcej na temat funkcji tekstowych dostępnych w języku Arcade.

OperatorObjaśnieniePrzykładWynik

concatenate(<wartości>, <separator>)

Łączy ze sobą wartości i zwraca ciąg znakowy.

  • values — tablica wartości ciągów znakowych do połączenia.
  • separator (opcjonalne) — separator używany przy łączeniu, jeśli parametr values jest tablicą, lub ciąg znakowy do połączenia, jeśli pierwszym parametrem jest pojedyncza wartość. Jeśli nie zostanie podany, będzie pusty.

fieldname zawiera wartość GeoAnalytics

Concatenate ([$target["nazwa_pola"], "jest", "wspaniałe!"], ' ')

Narzędzie GeoAnalytics jest wspaniałe!

find(<wyszukiwany_tekst>, <tekst>, <poz_startowa>)

Znajduje ciąg znakowy wewnątrz ciągu znakowego. Symbole wieloznaczne nie są obsługiwane.

  • searchText — wyszukiwany podciąg znakowy.
  • text — tekst do przeszukania.
  • startPos (opcjonalne) — indeksowana od zera pozycja w ciągu znakowym, od której ma zostać rozpoczęte wyszukiwanie.

fieldname1 zawiera wartość 14NorthStreet, a pole fieldname2 zawiera wartość North.

find($target["nazwa_pola2"], $join["nazwa_pola1"])

2

lower(<wartość>)

Zamienia wszystkie litery ciągu znakowego na małe.

  • value — ciąg znakowy, który ma zostać zapisany małymi literami.

fieldname zawiera wartość GEOANALYTICS.

lower($join["nazwa_pola"])

analiza geoprzestrzenna

Przykłady operacji tekstowych używających funkcji find i lower.

find(("north"), lower("146NorthStreet")) == False

Przykłady funkcji daty

Wyrażenia połączenia mogą przetwarzać daty. Następująca tabela pokazuje przykłady dostępnych działań.

Dowiedz się więcej o funkcjach daty dostępnych w języku Arcade

W języku Arcade wartości miesięcy należą do zakresu od 0 (styczeń) do 11 (grudzień), wartości dni do zakresu od1 do 31, wartości godzin do zakresu od (00:00) do 23 (23:00), wartości minut i sekund do zakresu od 0 do 59, a wartości milisekund do zakresu od 0 do 999. Daty w języku Arcade zwracają wartości czasu w lokalizacji GeoAnalytics Server użytkownika.

OperatorObjaśnieniePrzykładWynik

date(<wartość>, <miesiąc>, <dzień>, <godzina>, <minuta>)

Analizuje wartość lub zbiór wartości, tworząc ciąg znakowy daty.

  • value(opcjonalne) — liczba milisekund od 1 stycznia 1970 r. czasu UTC lub liczba reprezentująca rok. Jeśli rok został określony, w kolejnych parametrach należy także określić miesiąc i dzień. Ta wartość może być także ciągiem znakowym daty lub ciągiem znakowym ISO 8601, który ma zostać przekształcony na datę.
  • month (opcjonalne) — miesiąc (0–11), gdzie 0 oznacza styczeń, a 11 oznacza grudzień.
  • day (opcjonalne) — dzień miesiąca (1–31).
  • hour (opcjonalne) — godzina dnia (0–23).
  • minute (opcjonalne) — minuta w godzinie (0–59).
  • second (opcjonalne) — sekunda w minucie (0–59).
  • millisecond (opcjonalne) — milisekunda w sekundzie (0–999).

fieldname zawiera wartość 1476987783555.

Przykład 1: Date($features["fieldname"])

Przykład 2: Date(2017,0,14,0)

Przykład 3: Date()

Przykład 1: 20 października 2016 11:23:03

Przykład 2: 14 stycznia 2017 12:00:00

Przykład 3: zwraca bieżący czas

DateDiff(<data1>, <data2>, <jednostki>)

Odejmuje od siebie dwie daty i zwraca różnicę w podanych jednostkach.

  • date1 — wartość daty, od której ma zostać odjęta druga data.
  • date2 — wartość daty, która ma zostać odjęta od pierwszej podanej daty.
  • units (opcjonalne) — jednostki, w których zostanie zwrócona różnica dwóch podanych dat. Obsługiwane typy jednostek to milliseconds, seconds, minutes, hours, days, months i years. Wartość domyślna to milisekundy.

Przykład 1: DateDiff(Date(2017,1,14,0), Date())

Przykład 2: DateDiff(Date(2017,1,14,0), Date(), "Years")

Wynik zależy od czasu uruchomienia tego polecenia.

Przykład 1: -20532129137

Przykład 2: -0.6546783768647119

Year(<wartość_daty>)

Zwraca rok podanej daty.

  • value — wartość daty, z której ma zostać pobrany rok.

Przykład 1: pole fieldname jest polem typu Date z wartością 09 Oct 2017 04:30:43 pm.

Year($join["nazwa_pola"])

Przykład 2: pole fieldname jest polem znakowym sformatowanym jako ciąg znakowy ISO 8601 o wartości 2012-09-27.

Przykład 2: pole fieldname jest polem znakowym sformatowanym jako ciąg znakowy ISO 8601 o wartości Year(Date($target["fieldname"])).

Przykład 1: 2017

Przykład 2: 2012

Operatory warunkowe

W instrukcjach warunkowych można używać następujących operatorów:

OperatorObjaśnieniePrzykładWyniki

a > b

a < b

a jest większe niż b

a jest mniejsze niż b

10 > 2

Fałsz

a >= b

a <= b

a jest większe lub równe b

a jest mniejsze lub równe b

abs(-10) >= 10

Prawda

a != b

a nie jest równe b

abs(-3) != -3

Prawda

a == b

a jest równe b

abs(-5) == 5

Prawda

<condition1> || <condition2>

Spełniony jest warunek1 lub warunek2.

(abs(-5) == 5) || (10 < 2)

Prawda

<condition1> && <condition2>

Spełniony jest zarówno warunek1 jak i warunek2.

(abs(-5) == 5) && (10 < 2)

Fałsz

Przykłady operatorów logicznych

Podczas łączenia obiektów oprócz operatorów warunkowych można używać bardziej zaawansowanych operatorów logicznych.

Dowiedz się więcej o funkcjach logicznych dostępnych w języku Arcade

FunkcjaObjaśnieniePrzykładWynik

constrain(<value>,<low>,<high>)

Zwraca wartość wejściową, jeśli mieści się ona w podanych granicach. Jeśli wartość wejściowa jest mniejsza niż wartość minimalna, zwracana jest wartość minimalna. Jeśli wartość wejściowa jest większa od wartości maksymalnej, zwracana jest wartość maksymalna.

constrain( $target["odległość"], 0, 10)

constrain($join['Store dist'], 6, odległość)

Zwraca wartość 0, jeśli wartość distance jest mniejsza niż 0, wartość 10, jeśli wartość distance jest większa niż 10 oraz wartość distance, gdy nie zachodzi żaden z poprzednich przypadków.

Zwraca wartość 6, jeśli wartość Store dist jest mniejsza niż 6, wartość distance, jeśli wartość Store dist jest większa niż distance oraz wartość Store dist, gdy nie zachodzi żaden z poprzednich przypadków.

iif(<condition>,<true value>,<false value>)

Zwraca jedną wartość, jeśli warunek przyjmuje wartość true i inną wartość, jeśli warunek przyjmuje wartość false.

Wartości <true value> i <false value> mogą być następujące:

  • Pole liczbowe. Jeśli w nazwie pola występuje spacja, należy użyć nawiasów kwadratowych.
  • Liczba.
  • Funkcja.

iif($target["pole1"] > $join["pole2"], $join["pole1"], 0)

iif($target["pole1"] > $join["pole2"], iif($target["pole2"] = 0, $join["pole3"], $target["pole4"]), 0)

Zwraca wartość field1, jeśli wartość field1 jest większa niż wartość field2 i 0 w przeciwnym razie.

Zwraca wynik działania drugiej funkcji iif, jeśli wartość field1 jest większa niż wartość field2 i 0 w przeciwnym razie.

when(<expression1> , <result1> , <expression2> , <result2> , ... , <expressionN> , <resultN>, <default>)

Wylicza wartości serii wyrażeń do chwili, aż jedno z nich będzie miało wartość true.

  • expression — wyrażenie.
  • result — może być liczbą lub polem.
  • default — wartość opcjonalna, jeśli żadne z wyrażeń nie będzie miało odpowiedniej wartości.

when(($target["pole1"] + 10) > 1, 1,($join["pole2"] + 10) > 2 , 2, $target["pole3"])

Jeśli wartość field1 + 10 jest większa niż 1, zwraca wartość 1. W przeciwnym razie sprawdzane jest, czy wartość field2 + 10 jest większa niż 2. Jeśli tak, zwraca wartość 2. Jeśli nie, zwraca wartość field3.

decode(<conditional val> , <case1> , <result1>, <case2>, <result2>, ... <caseN>, <resultN>, <defaultValue> )

Funkcja decode wylicza wartość wyrażenia, a następnie porównuje ją z kolejnymi parametrami. W przypadku zgodności zwracana jest wartość następnego parametru. Przy braku zgodności istnieje opcja ustawienia ostatniego parametru jako wartości zwracanej domyślnie.

  • conditional val — może być polem lub wyrażeniem.
  • case — wartość, która ma zostać porównana z wartością conditional val.
  • result — wynik, jeśli odpowiedni przypadek jest zgodny z wartością conditional val.
  • defaultValue — opcjonalna wartość używana, gdy żadna inna wartość nie jest równa true.

decode($target["pole1"] + 3 , $join["pole1"], 1, $target["pole2"], 2, 0)

Sprawdza równość wartości warunkowej (conditional val) field1 + 3 i pierwszego przypadku (case1) równego field1. Jeśli wynikiem jest true, zwraca wartość 1. Jeśli wynikiem jest false, sprawdza równość wartości field1 + 3 i wartości field2. Jeśli wynikiem jest true, zwraca wartość 2. W przeciwnym razie zwraca wartość 0.