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 **component-model-based**personalizzato.
Le sezioni seguenti descrivono come utilizzare l' AWS IoT SiteWise API 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 component-model-based componente (console)](#create-component-console)
+ [Crea un modello composito component-model-based personalizzato (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. Scegliete **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 il 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 *component-model-based*composito. 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 component-model-based componente (console)
È possibile utilizzare la AWS IoT SiteWise console per creare un componente basato su un modello di componente.
**Per creare un component-model-based 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. Scegliete **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**.
## Crea un modello composito component-model-based personalizzato (AWS CLI)
Puoi utilizzarli AWS CLI per creare un modello composito component-model-based personalizzato all'interno del tuo modello di asset. Un modello composito component-model-based personalizzato è un riferimento a un modello di componente che hai già definito altrove.
Utilizzate l'[CreateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModelCompositeModel.html)operazione per creare un modello composito component-model-based personalizzato. 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 oggetti esterni IDs](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[Crea 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 component-model-based personalizzato 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 component-model-based personalizzati che hanno ciascuno il proprio nome ma che fanno tutti lo stesso riferimento. `composedAssetModelId`
È possibile annidare i componenti all'interno di altri componenti. A tale scopo, puoi aggiungere un modello component-model-based composito, come mostrato in questo esempio, a uno dei tuoi modelli di componenti.