View a markdown version of this page

Crea modelli compositi personalizzati (componenti) - AWS IoT SiteWise
Crea un componente in linea (console)Create un modello composito personalizzato in linea (AWS CLI)Crea un componente basato sul modello di componente (console)Create un modello composito personalizzato basato su un modello di componente (AWS CLI)

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 utilizzate 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, vedere. Modelli compositi personalizzati (componenti)

Create un modello composito personalizzato all'interno di un modello di asset o di componente 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 modello di asset o del modello di componente, potete creare un modello composito personalizzato basato sul modello di componente.

Le sezioni seguenti descrivono come utilizzare l' AWS IoT SiteWise API per creare modelli compositi personalizzati.

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 da nessun'altra parte.

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 componenti. Per informazioni dettagliate, consultate 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, effettuate le seguenti operazioni:

    1. Inserite 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 cambiano raramente. Per ulteriori informazioni, consulta Definisci dati statici (attributi).

    3. (Facoltativo) Aggiungi le definizioni misurazione per il modello. Le misurazioni rappresentano i flussi di dati provenienti dalle apparecchiature. Per ulteriori informazioni, consulta Definire i 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 Trasforma i dati (trasformazioni).

    5. (Facoltativo) Aggiungi le definizioni parametro per il modello. Le metriche sono formule che aggregano i dati in intervalli di tempo. Le metriche possono inserire dati dagli asset associati, in modo da poter calcolare valori che rappresentano la tua operazione o un sottoinsieme della tua operazione. Per ulteriori informazioni, consulta Aggrega i dati provenienti da proprietà e altre risorse (metriche).

    6. 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'CreateAssetModelCompositeModeloperazione 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 da nessun'altra parte. 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, per condividerlo tra più modelli di asset o per includere più istanze all'interno di un modello di asset), dovreste invece creare un modello composito basato su un modello di componenti. Per informazioni dettagliate, 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 sul modello di componente (console)

È possibile utilizzare la AWS IoT SiteWise console per creare un componente basato su un modello di componente.

Per creare un componente basato sul modello di 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, effettuate le seguenti operazioni:

    1. Selezionate il modello del componente su cui volete basare il componente.

    2. Inserite 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.

Create un modello composito personalizzato basato su un modello di componente (AWS CLI)

È possibile utilizzare il AWS CLI per creare un modello composito personalizzato basato su modelli di componenti all'interno del modello di asset. Un modello composito personalizzato basato su modelli di componenti è un riferimento a un modello di componente che hai già definito altrove.

Utilizzate l'CreateAssetModelCompositeModeloperazione 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 nella Guida per l'utente di AWS IoT SiteWise . Per un esempio di come creare un modello di componente, vedereCrea un modello di componente (AWS CLI).

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

Poiché è solo un riferimento, un modello composito personalizzato basato su un modello di componente non ha proprietà proprie, a parte un nome.

Se desideri aggiungere più istanze dello stesso componente al tuo modello di asset (ad esempio, una macchina CNC con più servomotori), puoi aggiungere più modelli compositi personalizzati basati su modelli di componenti, ciascuno con il proprio nome ma che fanno tutti lo stesso riferimento. composedAssetModelId

È possibile annidare i componenti all'interno di altri componenti. A tale scopo, potete aggiungere un modello composito basato su un modello di componente, come mostrato in questo esempio, a uno dei vostri modelli di componenti.