Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Comprendi la relazione tra modello interfaccia-asset
Le interfacce e i modelli di asset collaborano in una relazione complementare:
**Interfacce e modelli di asset**
| Aspetto | Interfacce | Modelli di asset |
| --- | --- | --- |
| Scopo | Definisci gli standard e applica la coerenza | Rappresenta risorse fisiche o logiche |
| Creazione di risorse | Impossibile creare risorse direttamente | Utilizzato per creare risorse |
| Properties | Definire le proprietà standard che devono essere implementate nei modelli | Può avere proprietà uniche e applicate all'interfaccia |
| Metriche | Definire calcoli standard | Implementa metriche di interfaccia e può avere metriche aggiuntive |
| Gerarchie | Definisci le relazioni gerarchiche di calcolo dei dati per le metriche di rollup | Definisci le relazioni gerarchiche fisiche per le associazioni di asset |
Quando applicate un'interfaccia a un modello di asset:
+ Il modello di asset deve mappare tutte le proprietà definite nell'interfaccia.
+ Le mappature delle proprietà definiscono in che modo le proprietà dell'interfaccia corrispondono alle proprietà del modello di asset.
+ Le proprietà del modello di asset mappato devono rimanere sincronizzate con le proprietà di interfaccia corrispondenti e non possono essere modificate in modo da causare incoerenze tra le due.
+ Le proprietà dell'interfaccia non mappate vengono create automaticamente nel modello di asset.
+ Il modello di asset può avere proprietà aggiuntive oltre a quelle definite nell'interfaccia.
+ Il modello di asset implementa le metriche dell'interfaccia. Le modifiche alle metriche di interfaccia si propagano a tutti i modelli di asset che utilizzano l'interfaccia.
+ Le gerarchie di interfaccia vengono utilizzate per calcolare le metriche di rollup. Le gerarchie dei modelli di asset possono essere definite indipendentemente e il servizio le mapperà automaticamente durante il calcolo delle metriche di rollup.
Questa relazione garantisce la standardizzazione e consente al contempo la flessibilità necessaria per rappresentare diversi tipi di apparecchiature.
## Standardizza i modelli di asset esistenti
Sebbene le interfacce siano utili quando si progettano nuovi modelli di asset partendo da zero, sono altrettanto potenti per standardizzare i modelli di asset esistenti che potrebbero essersi evoluti indipendentemente nel tempo.
Quando lavori con modelli di asset esistenti, puoi applicare interfacce per standardizzare metriche e proprietà:
1. Identifica metriche e proprietà comuni tra i tuoi modelli di asset esistenti
1. Create un'interfaccia che definisca queste proprietà e metriche standard
1. Applica l'interfaccia ai tuoi modelli di asset esistenti utilizzando la mappatura delle proprietà
1. Utilizzate le metriche di rollup per aggregare i dati in tutta la gerarchia degli asset
Ad esempio, se disponi di modelli di asset di macchine CNC esistenti con nomi di proprietà diversi ma dati simili, come,,) `temp_celsius``temperature_c`, `machine_temp` puoi:
1. Creare un `CNC-INTERFACE` con una proprietà standardizzata `Temperature-in-C`
1. Applica questa interfaccia a ciascun modello di asset CNC, mappando le proprietà di temperatura esistenti alle proprietà dell'interfaccia `Temperature-in-C`
1. Definite le metriche di rollup nell'interfaccia che calcola le statistiche su tutte le macchine (ad esempio, la temperatura media)
Questo approccio consente di mantenere i modelli di asset esistenti, ottenendo al contempo i vantaggi della standardizzazione e del calcolo semplificato delle metriche.
## Relazioni gerarchiche
Gerarchia delle interfacce
Definisce le relazioni per il calcolo e l'aggregazione dei dati tra diverse interfacce. Ad esempio, in un'impostazione di fabbrica, una gerarchia di interfacce potrebbe collegare interfacce di monitoraggio della temperatura a diversi livelli per calcolare le temperature medie. Ad esempio: macchina, linea di produzione e impianto. Quando si definisce una metrica di rollup, ad esempio`AverageTemperature`, la gerarchia dell'interfaccia determina il modo in cui tale metrica aggrega i dati dai livelli inferiori ai livelli superiori.
Gerarchia dei modelli di asset
Rappresenta l'effettiva struttura fisica o logica degli asset. Ad esempio, un modello di asset di una macchina CNC potrebbe far parte di un modello di asset di linea di produzione, che a sua volta appartiene a un modello di asset di fabbrica. Questa gerarchia riflette le relazioni con il mondo reale e aiuta a organizzare gli asset in modo che corrispondano alla loro disposizione fisica o alla loro struttura aziendale. Se combinate con le gerarchie di interfacce, le gerarchie dei modelli di asset aiutano il sistema a capire quali risorse devono essere incluse nei calcoli di rollup.
Questi due tipi di gerarchia funzionano insieme: le gerarchie di interfaccia definiscono come calcolare le metriche aggregate, mentre le gerarchie dei modelli di asset definiscono quali risorse specifiche devono essere incluse in tali calcoli.
## Metriche dell'interfaccia e calcoli di rollup
Le interfacce eccellono nella definizione di metriche standardizzate che possono essere applicate a diversi modelli di asset. Ciò è particolarmente utile per le metriche di rollup che aggregano i dati provenienti da più asset.
Quando definisci le metriche in un'interfaccia, queste vengono applicate automaticamente a tutti i modelli di asset che implementano l'interfaccia. Le metriche possono fare riferimento a proprietà definite nell'interfaccia, utilizzare funzioni di aggregazione per calcolare le statistiche sugli asset e garantire calcoli coerenti su tutti i modelli di asset implementati. Ad esempio, puoi definire una metrica di disponibilità in un'interfaccia che calcola il rapporto tra tempo di esecuzione e tempo totale:
```
{
"name": "Availability",
"dataType": "DOUBLE",
"type": {
"metric": {
"expression": "Running-time / (Running-time + Down-time) * 100",
"variables": [
{
"name": "Running-time",
"value": {
"propertyId": "${Running-time}"
}
},
{
"name": "Down-time",
"value": {
"propertyId": "${Down-time}"
}
}
],
"window": {
"tumbling": {
"interval": "1h"
}
}
}
},
"unit": "Percent"
}
```
Quando questa interfaccia viene applicata a più modelli di asset, la metrica di disponibilità viene calcolata in modo uniforme per tutti, anche se i nomi delle proprietà sottostanti sono diversi (grazie alla mappatura delle proprietà).
Per ulteriori informazioni sulla definizione delle metriche e sull'utilizzo delle funzioni di aggregazione, consulta. [Aggrega i dati provenienti da proprietà e altre risorse (metriche)](metrics.md)
### Metriche di rollup con interfacce
Le interfacce possono anche definire metriche di rollup che aggregano i dati tra le risorse in una gerarchia. Quando definite una gerarchia in un'interfaccia e la applicate a un modello di asset, potete creare metriche che aggregano i dati degli asset secondari.
Ad esempio, puoi definire una metrica che calcola la temperatura media di tutte le macchine CNC di una fabbrica:
```
{
"name": "AverageTemperature",
"dataType": "DOUBLE",
"type": {
"metric": {
"expression": "avg(Temperature-in-C)",
"variables": [
{
"name": "Temperature-in-C",
"value": {
"propertyId": "${Temperature-in-C}",
"hierarchyId": "${CNC-machines}"
}
}
],
"window": {
"tumbling": {
"interval": "1h"
}
}
}
},
"unit": "Celsius"
}
```
Questa metrica utilizza la funzione di `avg()` aggregazione per calcolare la temperatura media di tutte le macchine CNC della gerarchia. Il `hierarchyId` parametro specifica quale gerarchia utilizzare per l'aggregazione.
Quando questa interfaccia viene applicata a un modello di asset, la metrica di rollup aggrega automaticamente i dati di tutte le risorse secondarie che corrispondono alla mappatura gerarchica.