Uso de variables en expresiones de fórmula

Las variables representan las propiedades AWS IoT SiteWise de los activos en las expresiones de fórmula. Utilice variables para introducir valores de otras propiedades de activos en sus expresiones, de modo que pueda procesar datos de propiedades constantes (atributos), flujos de datos sin procesar (mediciones) y otras propiedades de la fórmula.

Las variables pueden representar propiedades de activos del mismo modelo de activo o de modelos de entidades secundarias asociadas. Solo las fórmulas métricas pueden introducir variables procedentes de modelos de entidades secundarias.

Las variables se identifican con nombres diferentes en la consola y en la API.

• AWS IoT SiteWise consola: utilice los nombres de las propiedades de los activos como variables en sus expresiones.

• AWS IoT SiteWise API (AWS CLI, AWS SDK): defina las variables con la ExpressionVariableestructura, que requiere un nombre de variable y una referencia a una propiedad de activo. El nombre puede contener letras en mayúsculas y minúsculas, números y guiones bajos. A continuación, utilice nombres de variables para hacer referencia a las propiedades de los activos en sus expresiones.

Los nombres de las variables distinguen mayúsculas de minúsculas.

Para obtener más información, consulte Definición de transformaciones y Definición de métricas.

Uso de variables para hacer referencia a propiedades

El valor de una variable define la propiedad a la que hace referencia. AWS IoT SiteWise proporciona diferentes formas de hacerlo.

• Por identificador de propiedad: puede especificar el identificador único (UUID) de la propiedad para identificarla.

• Por nombre: si la propiedad pertenece al mismo modelo de activos, puede especificar su nombre en el campo ID de la propiedad.

• Por ruta: un valor variable puede hacer referencia a una propiedad por su ruta. Para obtener más información, consulte Uso de rutas para hacer referencia a las propiedades de los modelos compuestos personalizados.

nota

La AWS IoT SiteWise consola no admite variables. Las utilizan la AWS IoT SiteWise API (incluidos los AWS Command Line Interface AWS CLI) y AWS los SDK.

Una variable de la que recibas una respuesta AWS IoT SiteWise incluye información completa sobre el valor, incluidos el ID y la ruta.

Sin embargo, cuando pasas una variable a AWS IoT SiteWise (por ejemplo, en una llamada de «creación» o «actualización»), solo necesitas especificar una de estas variables. Por ejemplo, si especificas la ruta, no necesitas proporcionar el ID.