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à.
# Crea modelli compositi personalizzati (componenti)
I modelli compositi personalizzati, o componenti, se utilizzi la console, forniscono un altro livello di organizzazione per i modelli di asset e i modelli di componenti. Puoi usarli per strutturare i tuoi modelli raggruppando le proprietà o facendo riferimento ad altri modelli. Per ulteriori informazioni sull'utilizzo di modelli compositi personalizzati, consulta. [Modelli compositi personalizzati (componenti)](custom-composite-models.md)
È possibile creare un modello composito personalizzato all'interno di un modello di asset o di componenti esistente. Esistono due tipi di modelli compositi personalizzati. Per raggruppare le proprietà correlate all'interno di un modello, è possibile creare un modello composito personalizzato **in linea**. Per fare riferimento a un modello di componente all'interno del vostro modello di asset o modello di componente, potete creare un modello composito personalizzato **basato su un modello di componenti**.
Le sezioni seguenti descrivono come utilizzare l'AWS IoT SiteWiseAPI per creare modelli compositi personalizzati.
**Topics**
+ [Crea un componente in linea (console)](#create-inline-component-console)
+ [Create un modello composito personalizzato in linea (AWS CLI)](#create-inline-composite-models-cli)
+ [Crea un componente basato su un modello di componenti (console)](#create-component-console)
+ [Create un modello composito personalizzato basato su un modello di componenti (AWS CLI)](#create-component-based-composite-model-cli)
## Crea un componente in linea (console)
È possibile utilizzare la AWS IoT SiteWise console per creare un componente in linea che definisce le proprie proprietà.
**Nota**
Poiché si tratta di un componente *in linea*, queste proprietà si applicano solo al modello di asset corrente e non sono condivise altrove.
Se avete bisogno di produrre un modello riutilizzabile (ad esempio, per condividerlo tra più modelli di asset o per includere più istanze all'interno di un modello di asset), dovreste invece creare un componente basato su un modello di componente. Per i dettagli, consulta la sezione seguente.
**Per creare un componente (console)**
1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Nel riquadro di navigazione selezionare **Models (Modelli)**.
1. Scegliete il modello di asset a cui desiderate aggiungere un componente.
1. Nella scheda **Proprietà**, scegliete **Componenti**.
1. Scegli **Crea componente**.
1. Nella pagina **Crea componente**, procedi come segue:
1. Immettete un **nome** per il componente, ad esempio **ServoMotor** o**ServoMotor Model**. Questo nome deve essere univoco per tutti i componenti del tuo account in questa regione.
1. (Facoltativo) Aggiungi le **definizioni attributi** per il modello. Gli attributi rappresentano informazioni che vengono modificate raramente. Per ulteriori informazioni, consulta [Definisci dati statici (attributi)](attributes.md).
1. (Facoltativo) Aggiungi le **definizioni misurazione ** per il modello. Le misurazioni rappresentano flussi di dati provenienti dall'apparecchiatura. Per ulteriori informazioni, consulta [Definisci i flussi di dati provenienti dalle apparecchiature (misurazioni)](measurements.md).
1. (Facoltativo) Aggiungi le **definizioni di trasformazione** per il modello. Le trasformazioni sono formule che mappano i dati da un modulo all'altro. Per ulteriori informazioni, consulta [Trasforma i dati (trasformazioni)](transforms.md).
1. (Facoltativo) Aggiungi le **definizioni parametro** per il modello. Le metriche sono formule che aggregano i dati su intervalli di tempo. Le metriche possono inserire dati dalle risorse associate, in modo da poter calcolare valori che rappresentano l'operazione o un sottoinsieme dell'operazione. Per ulteriori informazioni, consulta [Aggrega i dati provenienti da proprietà e altre risorse (metriche)](metrics.md).
1. Scegliete **Crea componente**.
## Create un modello composito personalizzato in linea (AWS CLI)
È possibile utilizzare AWS Command Line Interface (AWS CLI) per creare un modello composito personalizzato in linea che definisce le proprie proprietà.
Utilizzate l'[CreateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModelCompositeModel.html)operazione per creare un modello in linea con proprietà. Questa operazione prevede un payload con la seguente struttura.
**Nota**
Poiché si tratta di un modello composito *in linea*, queste proprietà si applicano solo al modello di asset corrente e non sono condivise altrove. Ciò che lo rende «in linea» è che non fornisce un valore per il `composedAssetModelId` campo.
Se avete bisogno di produrre un modello riutilizzabile (ad esempio, da condividere tra più modelli di asset o per includere più istanze all'interno di un unico modello di asset), dovreste invece creare un modello composito basato su un modello *di componenti*. Per i dettagli, consultate la sezione seguente.
```
{
"assetModelCompositeModelName": "CNCLathe_ServoMotorA",
"assetModelCompositeModelType": "CUSTOM",
"assetModelCompositeModelProperties": [
{
"dataType": "DOUBLE",
"name": "Servo Motor Temperature",
"type": {
"measurement": {}
},
"unit": "Celsius"
},
{
"dataType": "DOUBLE",
"name": "Spindle speed",
"type": {
"measurement": {}
},
"unit": "rpm"
}
]
}
```
## Crea un componente basato su un modello di componenti (console)
È possibile utilizzare la AWS IoT SiteWise console per creare un componente basato su un modello di componente.
**Per creare un componente basato su un modello di componenti (console)**
1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Nel riquadro di navigazione selezionare **Models (Modelli)**.
1. Scegliete il modello di asset a cui desiderate aggiungere un componente.
1. Nella scheda **Proprietà**, scegliete **Componenti**.
1. Scegli **Crea componente**.
1. Nella pagina **Crea componente**, procedi come segue:
1. Seleziona il modello di componente su cui vuoi basare il componente.
1. Immettete un **nome** per il componente, ad esempio **ServoMotor** o**ServoMotor Model**. Questo nome deve essere univoco per tutti i componenti del tuo account in questa regione.
1. Scegli **Crea componente**.
## Create un modello composito personalizzato basato su un modello di componenti (AWS CLI)
Puoi utilizzarlo AWS CLI per creare un modello composito personalizzato basato su un modello di componenti all'interno del tuo modello di asset. Un modello composito personalizzato basato su un modello di componenti è un riferimento a un modello di componente che avete già definito altrove.
Utilizzate l'[CreateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModelCompositeModel.html)operazione per creare un modello composito personalizzato basato su un modello di componenti. Questa operazione prevede un payload con la seguente struttura.
**Nota**
In questo esempio, il valore di `composedAssetModelId` è l'ID del modello di asset o l'ID esterno di un modello di componente esistente. Per ulteriori informazioni, consulta [Oggetti di riferimento con ID esterni](object-ids.md#external-id-references) nella *Guida per l'utente di AWS IoT SiteWise*. Per un esempio di come creare un modello di componente, vedete[Creare un modello di componente (AWS CLI)](create-component-models.md#create-component-model-cli).
```
{
"assetModelCompositeModelName": "CNCLathe_ServoMotorA",
"assetModelCompositeModelType": "CUSTOM",
"composedAssetModelId": {{component model ID}}
]
```
Poiché si tratta solo di un riferimento, un modello composito personalizzato basato su un modello di componenti non ha proprietà proprie, a parte un nome.
Se desiderate aggiungere più istanze dello stesso componente al vostro modello di asset (ad esempio, una macchina CNC con più servomotori), potete aggiungere più modelli compositi personalizzati basati su modelli di componenti, ognuno con il proprio nome ma che fanno tutti lo stesso riferimento. `composedAssetModelId`
È possibile annidare i componenti all'interno di altri componenti. A tale scopo, è possibile aggiungere un modello composito basato su un modello di componente, come mostrato in questo esempio, a uno dei modelli di componenti.