Creazione di modelli compositi personalizzati (Componenti)

I modelli compositi personalizzati, o i 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 proprietà o facendo riferimento ad altri modelli. Per ulteriori informazioni sull'utilizzo di modelli compositi personalizzati, consulta. Modelli compositi personalizzati (componenti)

È 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 SiteWise API per creare modelli compositi personalizzati.

Creazione di 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.

2. Nel riquadro di navigazione selezionare Models (Modelli).

3. Scegliete il modello di asset a cui desiderate aggiungere un componente.

4. Nella scheda Proprietà, scegliete Componenti.

5. Scegliete Crea componente.

6. Nella pagina Crea componente, procedi come segue:

   1. Immettete un nome per il componente, ad esempio ServoMotor oServoMotor Model. Questo nome deve essere univoco per tutti i componenti del tuo account in questa regione.

   2. (Facoltativo) Aggiungi le definizioni attributi per il modello. Gli attributi rappresentano informazioni che vengono modificate raramente. Per ulteriori informazioni, consulta Definizione di dati statici (attributi).

   3. (Facoltativo) Aggiungi le definizioni misurazione per il modello. Le misurazioni rappresentano flussi di dati provenienti dall'apparecchiatura. Per ulteriori informazioni, consulta Definizione dei flussi di dati provenienti dalle apparecchiature (misurazioni).

   4. (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 Trasformazione dei dati (trasformazioni).

   5. (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 Aggregazione di dati da proprietà e altre risorse (metriche).

   6. Scegliete Crea componente.

Creazione di 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'operazione CreateAssetModelCompositeModel 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"
        }
    ]
}

Creazione di 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.

2. Nel riquadro di navigazione selezionare Models (Modelli).

3. Scegliete il modello di asset a cui desiderate aggiungere un componente.

4. Nella scheda Proprietà, scegliete Componenti.

5. Scegliete Crea componente.

6. Nella pagina Crea componente, procedi come segue:

   1. Seleziona il modello di componente su cui vuoi basare il componente.

   2. Immettete un nome per il componente, ad esempio ServoMotor oServoMotor Model. Questo nome deve essere univoco per tutti i componenti del tuo account in questa regione.

   3. Scegli Crea componente.

Creazione di 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'operazione CreateAssetModelCompositeModel 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 Riferimento a oggetti con ID esterni nella Guida per l'utente di AWS IoT SiteWise . Per un esempio di come creare un modello di componente, vedeteCreazione di un modello di componente (AWS CLI).

{
    "assetModelCompositeModelName": "CNCLathe_ServoMotorA",
    "assetModelCompositeModelType": "CUSTOM",
    "composedAssetModelId": component model ID
]

Poiché è solo 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.