Modelli compositi personalizzati (componenti) - AWS IoT SiteWise

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à.

Modelli compositi personalizzati (componenti)

Quando si modella un asset industriale particolarmente complesso, ad esempio un macchinario complicato composto da molte parti, può diventare una sfida mantenere i modelli di asset organizzati e gestibili.

In questi casi, puoi aggiungere modelli compositi personalizzati, o componenti, se utilizzi la console, ai modelli di asset e ai modelli di componenti esistenti. Questi vi aiutano a rimanere organizzati raggruppando le proprietà correlate e riutilizzando le definizioni dei sottocomponenti.

Esistono due tipi di modelli compositi personalizzati:

  • I modelli compositi personalizzati in linea definiscono un insieme di proprietà raggruppate che si applicano al modello di asset o al modello di componente a cui appartiene il modello composito personalizzato. Li utilizzate per raggruppare le proprietà correlate. Sono costituiti da un nome, una descrizione e un insieme di proprietà del modello di asset. Non sono riutilizzabili.

  • I modelli compositi omponent-model-based personalizzati C fanno riferimento a un modello di componente che si desidera includere nel modello di asset o nel modello di componente. Li utilizzate per includere sottoassiemi standard nel modello. Sono costituiti da un nome, una descrizione e l'ID del modello di componente a cui fanno riferimento. Non hanno proprietà proprie; il modello di componente a cui si fa riferimento fornisce le proprietà associate a tutti gli asset creati.

Le seguenti sezioni illustrano come utilizzare modelli compositi personalizzati nei progetti.

Modelli compositi personalizzati in linea

I modelli compositi personalizzati in linea consentono di organizzare il modello di asset raggruppando le proprietà correlate.

Ad esempio, supponete di voler modellare un asset robotico. Il robot include un servomotore, un alimentatore e una batteria. Ciascuna di queste parti costituenti ha le proprie proprietà che si desidera includere nel modello. È possibile definire un modello di asset denominato robot_model con proprietà come le seguenti.

  • robot_model

    • servo_status(numero intero)

    • servo_position(doppio)

    • powersupply_status(numero intero)

    • powersupply_temperature(doppio)

    • battery_status(numero intero)

    • battery_charge(doppio)

Tuttavia, in alcuni casi, potrebbero esserci molti sottoassiemi oppure i sottoassiemi stessi potrebbero avere molte proprietà. In questi casi, potrebbero esserci così tante proprietà da rendere complicato il riferimento e la gestione in un unico elenco semplice alla radice del modello, come nell'esempio precedente.

Per gestire tali situazioni, è possibile utilizzare un modello composito personalizzato in linea per raggruppare le proprietà. Un modello composito personalizzato in linea è un modello composito personalizzato che definisce le proprie proprietà. Ad esempio, puoi modellare il tuo robot nel modo seguente.

  • robot_model

    • servo

      • status(numero intero)

      • position(doppio)

    • powersupply

      • status(numero intero)

      • temperature(doppio)

    • battery

      • status(numero intero)

      • charge(doppio)

Nell'esempio precedente, servopowersupply, e battery sono i nomi dei modelli compositi personalizzati in linea definiti all'interno del modello di robot_model asset. Ciascuno di questi modelli compositi definisce quindi le proprie proprietà.

Nota

In questo caso, ogni modello composito personalizzato definisce le proprie proprietà, in modo che tutte le proprietà facciano parte del modello di asset stesso (robot_modelin questo caso). Queste proprietà non sono condivise con altri modelli di asset o modelli di componenti. Ad esempio, se avete creato un altro modello di asset che aveva anche un modello composito personalizzato in linea chiamatoservo, apportare una modifica all'servointerno non robot_model influirebbe sulla servo definizione dell'altro modello di asset.

Se desiderate implementare tale condivisione (ad esempio, avere una sola definizione per un servo, condivisibile da tutti i vostri modelli di asset), dovreste invece creare un modello a componenti relativo al servo e quindi creare modelli component-model-basedcompositi che vi facciano riferimento. Per i dettagli, consultate la sezione seguente.

Per informazioni su come creare modelli compositi personalizzati in linea, vedereCrea modelli compositi personalizzati (componenti).

C modelli compositi omponent-model-based personalizzati

È possibile creare un modello di componente in AWS IoT SiteWise per definire un sottoassieme standard riutilizzabile. Dopo aver creato un modello di componente, potete aggiungere riferimenti ad esso negli altri modelli di asset e modelli di componenti. A tale scopo, aggiungete un modello composito component-model-based personalizzato a qualsiasi modello in cui desiderate fare riferimento al componente. È possibile aggiungere riferimenti al componente da molti modelli o più volte all'interno dello stesso modello.

In questo modo, è possibile evitare di duplicare le stesse definizioni tra i modelli. Inoltre, semplifica la manutenzione dei modelli, poiché qualsiasi modifica apportata a un modello componente si rifletterà su tutti i modelli di asset che lo utilizzano.

Ad esempio, supponete che l'impianto industriale disponga di molti tipi di apparecchiature che utilizzano tutte lo stesso tipo di servomotore. Alcuni di essi hanno molti servomotori in un'unica apparecchiatura. Crei un modello di asset per ogni tipo di apparecchiatura, ma non vuoi duplicare la definizione di servo ogni volta. Volete modellarlo una sola volta e utilizzarlo nei vari modelli di asset. Se successivamente apporti una modifica alla definizione diservo, questa verrà aggiornata in tutti i tuoi modelli e asset.

Per modellare il robot dell'esempio precedente in questo modo, potete definire servomotori, alimentatori e batterie come modelli di componenti, in questo modo.

  • servo_component_model

    • status(numero intero)

    • position(doppio)

  • powersupply_component_model

    • status(numero intero)

    • temperature(doppio)

  • battery__component_model

    • status(numero intero)

    • charge(doppio)

È quindi possibile definire modelli di asset, ad esempio robot_model che fanno riferimento a questi componenti. Più modelli di asset possono fare riferimento allo stesso modello di componente. È inoltre possibile fare riferimento allo stesso modello di componente più volte in un unico modello di asset, ad esempio se il robot è dotato di più servomotori.

  • robot_model

    • servo1(riferimento:) servo_component_model

    • servo2(riferimento:servo_component_model)

    • servo3(riferimento:servo_component_model)

    • powersupply(riferimento:powersupply_component_model)

    • battery(riferimento:battery_component_model)

Per informazioni su come creare modelli di componenti, vedereCrea modelli di componenti.

Per informazioni su come fare riferimento ai modelli di componenti in altri modelli, vedereCrea modelli compositi personalizzati (componenti).

Utilizzate i percorsi per fare riferimento alle proprietà personalizzate del modello composito

Quando create una proprietà su un modello di asset, un modello di componente o un modello composito personalizzato, potete farvi riferimento da altre proprietà che ne utilizzano il valore, come trasformazioni e metriche.

AWS IoT SiteWise offre diversi modi per fare riferimento alla proprietà. Il modo più semplice è spesso quello di utilizzare l'ID della proprietà. Tuttavia, se la proprietà a cui desiderate fare riferimento si trova su un modello composito personalizzato, potrebbe essere più utile farvi riferimento invece tramite il percorso.

Un percorso è una sequenza ordinata di segmenti di percorso che specifica una proprietà in termini di posizione tra i modelli compositi annidati all'interno di un modello di asset e di un modello composito.

Ottieni i percorsi delle proprietà

Puoi ottenere il percorso di una proprietà dal path campo della sua AssetModelProperty.

Ad esempio, supponete di avere un modello di asset robot_model che contiene un modello composito personalizzatoservo, dotato di una proprietàposition. Se chiami DescribeAssetModelCompositeModelonservo, la position proprietà elencherà un path campo simile al seguente:

"path": [ { "id": "asset model ID", "name": "robot_model" }, { "id": "composite model ID", "name": "servo" }, { "id": "property ID", "name": "position" } ]

Utilizzo dei percorsi delle proprietà

È possibile utilizzare un percorso di proprietà quando si definisce una proprietà che fa riferimento ad altre proprietà, ad esempio una trasformazione o una metrica.

Una proprietà utilizza una variabile per fare riferimento a un'altra proprietà. Per ulteriori informazioni sull'utilizzo delle variabili, vedereUsa le variabili nelle espressioni delle formule.

Quando si definisce una variabile per fare riferimento a una proprietà, è possibile utilizzare l'ID della proprietà o il relativo percorso.

Per definire una variabile che utilizza il percorso della proprietà di riferimento, specificate il propertyPath campo del relativo valore.

Ad esempio, per definire un modello di asset con una metrica che fa riferimento a una proprietà utilizzando un percorso, potete passare un payload come questo a: CreateAssetModel

{ ... "assetModelProperties": [ { ... "type": { "metric": { ... "variables": [ { "name": "variable name", "value": { "propertyPath": [ path segments ] } } ], ... } }, ... }, ... ], ... }