Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
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 SDKs): 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 hacer esto.
-
Por ID de propiedad: puede especificar el ID único (UUID) de la propiedad para identificarla.
-
Por nombre: si la propiedad está en el mismo modelo de activos, puede especificar su nombre en el campo de ID de propiedad.
-
Por ruta: un valor de variable puede hacer referencia a una propiedad por su ruta. Para obtener más información, consulte Uso de rutas para hacer referencia a propiedades de modelos compuestos personalizados.
nota
La AWS IoT SiteWise consola no admite variables. Las utiliza la AWS IoT SiteWise API, incluidas las AWS Command Line Interface AWS CLI) y AWS SDKs.
Una variable de la que reciba 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 especifica la ruta, no necesita proporcionar el ID.