Skip To Content

Utiliser des expressions Arcade avec Ajouter des données

La boîte à outils GeoAnalytics Tools contient plusieurs outils permettant d’appliquer une expression:

Les GeoAnalytics Tools qui utilisent des expressions ont des fonctions diverses, mais sont également limités quant aux expressions qu’ils peuvent appliquer. À partir de la version 10.6, toutes les expressions utilisées dans GeoAnalytics Server prennent en charge Arcade.

En savoir plus sur les fonctions Arcade

Expressions dans Append Data (Ajouter des données)

Les expressions sont utilisées dans l’outil Append Data (Ajouter des données) pour calculer les valeurs du champ de couche en entrée. Lorsque vous n’ajoutez pas de valeurs de champ de la couche d’ajout, utilisez des expressions pour déterminer la façon dont chaque entité doit être renseignée. L’expression Append Data (Ajouter des données) doit avoir pour résultat des valeurs du même type que le champ. Les sections suivantes proposent des exemples d’expressions.

Exemples d’opérateur mathématique et de fonction

Les expressions Append Data (Ajouter des données) peuvent traiter les nombres mathématiquement. Le tableau ci-dessous présente des exemples d’opérations disponibles.

En savoir plus sur les opérations mathématiques et les fonctions disponibles dans Arcade

OpérateurExplicationExempleRésultat

a + b

a plus b.

fieldname contient la valeur 1,5.

$feature["nom du champ"] + 2.5

4.0

a - b

a moins b.

fieldname contient la valeur 3,3.

$feature["nom du champ"] - 2.2

1.1

a * b

a multiplié par b.

fieldname contient la valeur 2,0.

$feature["nom du champ"] * 2.2

4.4

a / b

a divisé par b.

fieldname contient la valeur 4,0.

$feature["nom du champ"] / 1.25

3.2

abs( a )

Renvoie la valeur absolue (positive) de a.

fieldname contient la valeur -1,5.

abs($feature["nom du champ"])

1,5

log ( a )

Renvoie le logarithme naturel (base E) de a.

fieldname contient la valeur 1.

journal($feature["nom du champ"])

0

sin ( a )

Renvoie le sinus trigonométrique de a. On suppose que l'entrée est un angle en radians.

fieldname contient la valeur 1,5707.

sin($feature["nom du champ"])

1

cos( a )

Renvoie le cosinus trigonométrique de a. On suppose que l'entrée est un angle en radians.

fieldname contient la valeur 0.

cos($feature["nom du champ"])

1

tan( a )

Renvoie la tangente de a. On suppose que l'entrée est un angle en radians.

fieldname contient la valeur 0.

tan($feature["nom du champ"])

0

sqrt( a )

Renvoie la racine carrée de a.

fieldname contient la valeur 9.

sqrt($feature["nom du champ"])

3

min( a, b )

Renvoie la valeur la plus basse entre a et b.

fieldname contient les valeurs 1,5 et -3.

min($feature["nom du champ"], -3)

-3

max( a, b )

Renvoie la valeur la plus élevée entre a et b.

fieldname1 contient la valeur 1.5 et fieldname2 contient la valeur -3.

max($feature["nom du champ1"], $feature["nom du champ2"])

1,5

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

Renvoie la valeur en entrée si elle est comprise dans les limites de contrainte. Si la valeur en entrée est inférieure à la valeur basse, elle renvoie la valeur basse. Si la valeur en entrée est supérieure à la valeur haute, elle renvoie la valeur haute.

constrain($feature["distance"], 0, 10)

constrain($feature[’Store dist’], 6, distance)

Renvoie 0 si distance est inférieure à 0,10 si distance est supérieure à 10 et distance dans les autres cas.

Renvoie 6 si Store dist est inférieure à 6, distance si Store dist est supérieure à distance et Store dist dans les autres cas.

Un exemple de multiplication pour le calcul d’une valeur de champ est donné.

$feature["Distance"] * 2

Exemples de fonctions de texte

Les expressions Append Data (Ajouter des données) peuvent traiter du texte. Le tableau ci-dessous présente des exemples d’opérations disponibles.

En savoir plus sur les fonctions de texte disponibles dans Arcade

OpérateurExplicationExempleRésultat

concatenate( <valeurs>, <séparateur>)

Concatène les valeurs et renvoie une chaîne.

  • values : une matrice de valeurs de chaînes à concaténer.
  • separator (facultatif) : un séparateur à utiliser pour la concaténation si le paramètre values est une matrice, ou une chaîne à concaténer si une valeur unique est fournie pour le premier paramètre. Si elle n’est pas renseignée, elle sera vide.

fieldname contient la valeur GeoAnalytics.

Concatenate ([$features["fieldname"], "is", "great!"], ' ')

GeoAnalytics est super !

find(<searchText>, <text>, <startPos>)

Trouve une chaîne à l’intérieur d’une chaîne. Les caractères génériques ne sont pas pris en charge.

  • searchText : la sous-chaîne à rechercher.
  • text : le texte à rechercher.
  • startPos (facultatif) : l’index en base zéro de l’emplacement dans la chaîne où s’effectue la recherche.

fieldname1 contient la valeur 14NorthStreet et fieldname2 contient la valeur North.

find($feature["nom du champ2"], $feature["nom du champ1"])

2

lower(<value>)

Convertit une chaîne en minuscule.

  • value : la chaîne à convertir en minuscules.

fieldname contient la valeur GEOANALYTICS.

lower($feature["nom du champ"])

GeoAnalytics

Un exemple de texte utilisant find et lower est affiché.

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

Exemples de fonctions de date

Les expressions Append Data (Ajouter des données) peuvent traiter des dates. Le tableau ci-dessous présente des exemples d’opérations disponibles.

En savoir plus sur les fonctions de date disponibles dans Arcade

Dans Arcade, les valeurs de mois vont de 0 (janvier) à 11 (décembre), les jours vont de 1 à 31, les heures vont de 0 (minuit) à 23 (23 h), les minutes et secondes vont de 0 à 59 et les millisecondes, de 0 à 999. Les dates Arcade renvoient des valeurs de temps dans l’emplacement de votre GeoAnalytics Server.

OpérateurExplicationExempleRésultat

date( <value>, <month>, <day>, <hour>, <minute>)

Analyse une valeur ou un ensemble de valeurs dans une chaîne de date.

  • value (facultatif) : nombre de millisecondes écoulées depuis le 1er janvier 1970 UTC. Peut aussi être un nombre représentant une année. Si une année est spécifiée, le mois et le jour doivent être également renseignés dans les paramètres suivants. Cette valeur peut également être une chaîne de date ou une chaîne ISO 8601 à convertir en date.
  • month (facultatif) : le mois (de 0 à 11), où « 0 » correspond à janvier et « 11 » à décembre.
  • day (facultatif) : le jour du mois (de 1 à 31).
  • hour (facultatif) : l’heure de la journée (de 0 à 23).
  • minute (facultatif) : la minute de l'heure (de 0 à 59).
  • second (facultatif) : la seconde de la minute (de 0 à 59).
  • millisecond (facultatif) : la milliseconde de la seconde (de 0 à 999).

fieldname contient la valeur 1476987783555.

Exemple 1 : Date($features["nom de champ"])

Exemple 2 : Date(2017,0,14,0)

Exemple 3 : Date()

Exemple 1 : 20 Oct 2016 11:23:03

Exemple 2 : 14 Jan 2017 00:00:00

Exemple 3 : renvoie l'heure actuelle

DateDiff(<date1>, <date2>, <unités>)

Opère une soustraction entre deux dates et renvoie la différence dans les unités spécifiées.

  • date1 : la valeur de date à partir de laquelle on soustrait une deuxième date.
  • date2 : la valeur de date à soustraire de la première date indiquée.
  • units (facultatif) : les unités dans lesquelles renvoyer la différence entre les deux dates données. Les unités prises en charge incluent les milliseconds, seconds, minutes, hours, days, months et years. Les millisecondes sont la valeur par défaut.

Exemple 1 : DateDiff(Date(2017,1,14,0), Date())

Example 2 : DateDiff(Date(2017,1,14,0), Date(), "Années")

Le résultat dépend du moment où est exécutée cette commande.

Exemple 1 : -20532129137

Exemple 2 : -0.6546783768647119

Year(<dateValue>)

Renvoie l'année de la date donnée.

  • value : une valeur de date à partir de laquelle on récupère l’année.

Exemple 1 : fieldname est un champ de type Date dont la valeur est 09 Oct 2017 04:30:43 pm.

Year($feature["nom de champ"])

Exemple 2 : fieldname est un champ de type chaîne au format chaîne ISO 8601 dont la valeur est 2012-09-27.

Exemple 1 : 2017

Exemple 2 : 2012

Opérateurs conditionnels

Les instructions conditionnelles peuvent utiliser les opérateurs suivants.

OpérateurExplicationExempleRésultats

a > b

a < b

a est supérieur à b

a est inférieur à b

10 > 2

False

a >= b

a <= b

a est supérieur ou égal à b

a est inférieur ou égal à b

abs(-10) >= 10

True

a != b

a est différent de b

abs(-3) != -3

True

a == b

a est égal à b

abs(-5) == 5

True

<condition1> || <condition2>

La condition 1 ou la condition 2 est satisfaite.

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

True

<condition1> && <condition2>

La condition 1 et la condition 2 sont satisfaites.

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

False

Exemples d’opérateurs logiques

Outre les opérateurs conditionnels, des opérateurs logiques plus avancés peuvent être utilisés pour calculer les valeurs de champ.

En savoir plus sur les fonctions logiques disponibles dans Arcade

FonctionExplicationExempleRésultat

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

Renvoie une valeur si une condition est true et une autre valeur si la condition est false.

<true value> et <false value> peuvent être :

  • Un champ numérique. Si le nom du champ renferme un espace, utilisez des crochets.
  • Un nombre.
  • Une fonction.

iif($feature["field1"] > $feature["field2"], $feature["field1"], 0)

iif($feature["field1"] > $feature["field2"], iif($feature["field2"] = 0, $feature["field3"], $feature["field4"]), 0)

Renvoie field1 si field1 est supérieur à field2 et 0 dans les autres cas.

Renvoie le résultat de la deuxième fonction iif si field1 est supérieur à field2 et 0 dans les autres cas.

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

Évalue une série d’expressions jusqu’à ce que l’une soit true.

  • expression : une expression.
  • result : un nombre ou un champ.
  • default : une valeur facultative si les expressions ne font l’objet d’aucune correspondance.

when(($feature["champ1"] + 10) > 1, 1,($feature["champ2"] + 10) > 2 , 2, $feature["champ3"])

Si field1 + 10 est supérieur à 1, renvoie 1. Sinon, vérifie si field2 + 10 est supérieur à 2. Si c’est le cas, elle renvoie 2. Si ce n’est pas le cas, renvoie field3.

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

La fonction decode évalue une expression et compare sa valeur aux paramètres suivants. Si l’expression correspond, elle renvoie la valeur du paramètre suivant. Si aucune correspondance n’est trouvée, le dernier paramètre peut être une valeur de renvoi par défaut.

  • conditional val : un champ ou une expression.
  • case : une valeur à comparer à la conditional val.
  • result : le résultat si le cas correspond à la conditional val.
  • defaultValue : une valeur facultative si aucune autre valeur n'est true.

decode($feature["champ1"] + 3 , $feature["champ1"], 1, $feature["champ2"], 2, 0)

Compare l’égalité entre la valeur conditionnelle conditional val field1 + 3 et cas1 field1. Si la condition est true, renvoie 1. Si la condition est false, compare l’égalité entre field1 + 3 et field2. Si la condition est true, renvoie 2 ; sinon, renvoie 0.