Utiliser des variables dans les expressions de formule

Les variables représentent les propriétés des AWS IoT SiteWise actifs dans les expressions de formule. Utilisez des variables pour saisir des valeurs provenant d'autres propriétés d'actifs dans vos expressions, afin de pouvoir traiter les données issues de propriétés constantes (attributs), de flux de données brutes (mesures) et d'autres propriétés de formule.

Les variables peuvent représenter les propriétés des actifs à partir du même modèle d'actif ou à partir de modèles d'actifs enfants associés. Seules les formules métriques peuvent saisir des variables à partir de modèles d'actifs enfants.

Vous identifiez les variables sous différents noms dans la console et dans leAPI.

• AWS IoT SiteWise console — Utilisez les noms des propriétés des actifs comme variables dans vos expressions.

• AWS IoT SiteWise API(AWS CLI, AWS SDKs) — Définissez les variables avec la ExpressionVariablestructure, qui nécessite un nom de variable et une référence à une propriété d'actif. Le nom de la variable peut contenir des lettres minuscules, des chiffres et des traits de soulignement. Utilisez ensuite des noms de variables pour référencer les propriétés des actifs dans vos expressions.

Les noms de variables distinguent les majuscules et minuscules.

Pour plus d'informations, consultez les sections Définition des transformations et Définition des métriques.

Utiliser des variables pour référencer les propriétés

La valeur d'une variable définit la propriété à laquelle elle fait référence. AWS IoT SiteWise propose différentes manières de le faire.

• Par identifiant de propriété : vous pouvez spécifier l'identifiant unique de la propriété (UUID) pour l'identifier.

• Par nom : si la propriété utilise le même modèle d'actif, vous pouvez spécifier son nom dans le champ ID de propriété.

• Par chemin : la valeur d'une variable peut faire référence à une propriété par son chemin. Pour de plus amples informations, veuillez consulter Utiliser des chemins pour référencer les propriétés personnalisées du modèle composite.

Note

Les variables ne sont pas prises en charge par AWS IoT SiteWise la console. Ils sont utilisés par AWS IoT SiteWise API, y compris le AWS Command Line Interface AWS CLI) et AWS SDKs.

Une variable que vous recevez dans une réponse AWS IoT SiteWise inclut des informations complètes sur la valeur, notamment l'ID et le chemin.

Toutefois, lorsque vous transmettez une variable à AWS IoT SiteWise (par exemple, lors d'un appel « créer » ou « mettre à jour »), il vous suffit de spécifier l'une de ces variables. Par exemple, si vous spécifiez le chemin, vous n'avez pas besoin de fournir l'ID.