Usando variáveis em expressões de fórmula

As variáveis representam propriedades AWS IoT SiteWise de ativos em expressões de fórmulas. Use variáveis para inserir valores de outras propriedades do ativo em suas expressões, para que você possa processar dados de propriedades constantes (atributos), fluxos de dados brutos (medidas) e outras propriedades da fórmula.

As variáveis podem representar propriedades de ativos do mesmo modelo de ativo ou de modelos de ativos filho associados. Somente fórmulas métricas podem inserir variáveis de modelos de ativos filho.

Você identifica variáveis por nomes diferentes no console e na API.

• AWS IoT SiteWise console — Use nomes de propriedades de ativos como variáveis em suas expressões.

• AWS IoT SiteWise API (AWS CLI, AWS SDKs) — Defina variáveis com a ExpressionVariableestrutura, o que requer um nome de variável e uma referência a uma propriedade do ativo. O nome da variável pode conter letras minúsculas, números e sublinhados (_). Em seguida, use nomes de variáveis para referenciar propriedades de ativos em suas expressões.

Os nomes de variáveis diferenciam minúsculas de maiúsculas.

Para obter mais informações, consulte Definindo transformações e Definindo de métricas.

Usando variáveis para referenciar propriedades

O valor de uma variável define a propriedade à qual ela faz referência. AWS IoT SiteWise fornece maneiras diferentes de fazer isso.

• Por ID da propriedade: você pode especificar a ID exclusiva da propriedade (UUID) para identificá-la.

• Por nome: se a propriedade estiver no mesmo modelo de ativo, você poderá especificar seu nome no campo ID da propriedade.

• Por caminho: o valor de uma variável pode se referir a uma propriedade por seu caminho. Para ter mais informações, consulte Usando caminhos para referenciar propriedades personalizadas do modelo composto.

nota

As variáveis não são suportadas pelo AWS IoT SiteWise console. Eles são usados pela AWS IoT SiteWise API, incluindo o AWS Command Line Interface AWS CLI) e os AWS SDKs.

Uma variável que você recebe em uma resposta AWS IoT SiteWise inclui informações completas sobre o valor, incluindo a ID e o caminho.

No entanto, ao passar uma variável para AWS IoT SiteWise (por exemplo, em uma chamada de “criar” ou “atualizar”), você só precisa especificar uma delas. Por exemplo, se você especificar o caminho, não precisará fornecer o ID.