Utilisation de fonctions dans des expressions de formule

Vous pouvez utiliser les fonctions suivantes pour agir sur les données de vos expressions de formule.

Les transformations et les métriques prennent en charge différentes fonctions. Le tableau suivant indique les types de fonctions compatibles avec chaque type de propriété de formule.

Note

Vous pouvez inclure un maximum de 10 fonctions dans une expression de formule.

Type de fonction	Transformations	Métriques
Utilisation de fonctions courantes dans les expressions de formule	Oui	Oui
Utilisation de fonctions de comparaison dans des expressions de formule	Oui	Oui
Utilisation de fonctions conditionnelles dans les expressions de formule	Oui	Oui
Utilisation de fonctions de chaîne dans des expressions de formule	Oui	Oui
Utilisation de fonctions d'agrégation dans des expressions de formule	Non	Oui
Utilisation de fonctions temporelles dans les expressions de formules	Oui	Oui
Utilisation des fonctions de date et d'heure dans les expressions de formule	Oui	Oui

Syntaxe des fonctions

Vous pouvez utiliser la syntaxe suivante pour créer des fonctions :

Syntaxe régulière

Avec la syntaxe normale, le nom de la fonction est suivi de parenthèses contenant zéro argument ou plus.

function_name(argument1, argument2, argument3, ...). Par exemple, les fonctions dont la syntaxe est normale peuvent ressembler à log(x) etcontains(s, substring).

Syntaxe uniforme des appels de fonction (UFCS)

L'UFCS vous permet d'appeler des fonctions en utilisant la syntaxe des appels de méthode dans la programmation orientée objet. Avec UFCS, le premier argument est suivi par point (.), puis le nom de la fonction et les autres arguments (le cas échéant) entre parenthèses.

argument1.function_name(argument2, argument3, ...). Par exemple, les fonctions associées à l'UFCS peuvent ressembler à x.log() ets.contains(substring).

Vous pouvez également utiliser l'UFCS pour enchaîner les fonctions suivantes. AWS IoT SiteWise utilise le résultat de l'évaluation de la fonction en cours comme premier argument de la fonction suivante.

Par exemple, vous pouvez utiliser à la message.jp('$.status').lower().contains('fail') place decontains(lower(jp(message, '$.status')),'fail').

Pour plus d'informations, consultez le site Web du langage de programmation D.

Note

Vous pouvez utiliser l'UFCS pour toutes les AWS IoT SiteWise fonctions.

AWS IoT SiteWise les fonctions ne distinguent pas les majuscules et minuscules. Par exemple, vous pouvez utiliser lower(s) et de Lower(s) manière interchangeable.