Usa le variabili nelle espressioni delle formule

Le variabili rappresentano le proprietà AWS IoT SiteWise degli asset nelle espressioni delle formule. Utilizzate le variabili per inserire valori da altre proprietà degli asset nelle espressioni, in modo da poter elaborare i dati provenienti da proprietà costanti (attributi), flussi di dati non elaborati (misurazioni) e altre proprietà delle formule.

Le variabili possono rappresentare le proprietà degli asset dello stesso modello di asset o dei modelli di asset secondari associati. Solo le formule metriche possono inserire variabili da modelli di asset secondari.

Le variabili vengono identificate con nomi diversi nella console e in. API

• AWS IoT SiteWise console: utilizza i nomi delle proprietà degli asset come variabili nelle espressioni.

• AWS IoT SiteWise API(AWS CLI, AWS SDKs) — Definite le variabili con la ExpressionVariablestruttura, che richiede un nome di variabile e un riferimento a una proprietà dell'asset. Il nome della variabile può contenere lettere minuscole, numeri e caratteri di sottolineatura. Quindi, utilizzate i nomi delle variabili per fare riferimento alle proprietà delle risorse nelle espressioni.

I nomi delle variabili distinguono tra maiuscole e minuscole

Per ulteriori informazioni, consulta Definizione delle trasformazioni e Definizione delle metriche.

Utilizzate le variabili per fare riferimento alle proprietà

Il valore di una variabile definisce la proprietà a cui fa riferimento. AWS IoT SiteWise offre diversi modi per eseguire questa operazione.

• Per ID della proprietà: è possibile specificare l'ID univoco della proprietà (UUID) per identificarla.

• Per nome: se la proprietà appartiene allo stesso modello di asset, è possibile specificarne il nome nel campo ID della proprietà.

• Per percorso: un valore variabile può fare riferimento a una proprietà tramite il relativo percorso. Per ulteriori informazioni, consulta Utilizzate i percorsi per fare riferimento alle proprietà personalizzate del modello composito.

Nota

Le variabili non sono supportate dalla AWS IoT SiteWise console. Sono utilizzate da AWS IoT SiteWise API, incluso il AWS Command Line Interface AWS CLI) e AWS SDKs.

Una variabile ricevuta in una risposta da AWS IoT SiteWise include informazioni complete sul valore, inclusi l'ID e il percorso.

Tuttavia, quando si passa una variabile a AWS IoT SiteWise (ad esempio, in una chiamata «crea» o «aggiorna»), è sufficiente specificare solo una di queste. Ad esempio, se si specifica il percorso, non è necessario fornire l'ID.