Erstellen von benutzerdefinierten Verbundmodellen (Komponenten)

Benutzerdefinierte Verbundmodelle oder Komponenten, wenn Sie die Konsole verwenden, bieten eine weitere Organisationsebene für Ihre Asset- und Komponentenmodelle. Sie können sie verwenden, um Ihre Modelle zu strukturieren, indem Sie Eigenschaften gruppieren oder auf andere Modelle verweisen. Weitere Informationen zum Arbeiten mit benutzerdefinierten Verbundmodellen finden Sie unter. Benutzerdefinierte zusammengesetzte Modelle (Komponenten)

Sie erstellen ein benutzerdefiniertes Verbundmodell innerhalb eines vorhandenen Objekt- oder Komponentenmodells. Es gibt zwei Arten von benutzerdefinierten Verbundmodellen. Um verwandte Eigenschaften innerhalb eines Modells zu gruppieren, können Sie ein benutzerdefiniertes Verbundmodell erstellen. Um in Ihrem Objekt- oder Komponentenmodell auf ein Komponentenmodell zu verweisen, können Sie ein auf einem Komponentenmodell basierendes benutzerdefiniertes Verbundmodell erstellen.

In den folgenden Abschnitten wird beschrieben, wie Sie mithilfe der AWS IoT SiteWise API benutzerdefinierte Verbundmodelle erstellen.

Erstellen einer Inline-Komponente (Konsole)

Sie können die AWS IoT SiteWise Konsole verwenden, um eine Inline-Komponente zu erstellen, die ihre eigenen Eigenschaften definiert.

Anmerkung

Da es sich um eine Inline-Komponente handelt, gelten diese Eigenschaften nur für das aktuelle Asset-Modell und werden nirgendwo anders gemeinsam genutzt.

Wenn Sie ein wiederverwendbares Modell erstellen müssen (z. B. um mehrere Objektmodelle gemeinsam zu nutzen oder um mehrere Instanzen in ein Objektmodell einzubeziehen), sollten Sie stattdessen eine Komponente erstellen, die auf einem Komponentenmodell basiert. Einzelheiten finden Sie im folgenden Abschnitt.

Um eine Komponente (Konsole) zu erstellen

1. Navigieren Sie zur AWS IoT SiteWise -Konsole.

2. Klicken Sie im Navigationsbereich auf Models (Modelle).

3. Wählen Sie das Asset-Modell aus, zu dem Sie eine Komponente hinzufügen möchten.

4. Wählen Sie auf der Registerkarte Eigenschaften die Option Komponenten aus.

5. Wählen Sie Komponente erstellen.

6. Gehen Sie auf der Seite Komponente erstellen wie folgt vor:

   1. Geben Sie einen Namen für die Komponente ein, z. B. ServoMotor oderServoMotor Model. Dieser Name muss für alle Komponenten in Ihrem Konto in dieser Region eindeutig sein.

   2. (Optional) Fügen Sie Attributdefinitionen für das Modell hinzu. Attribute stellen Informationen dar, die sich selten ändern. Weitere Informationen finden Sie unter Definition statischer Daten (Attribute).

   3. (Optional) Fügen Sie Messungsdefinitionen für das Modell hinzu. Messungen stellen Datenströme von Ihren Geräten dar. Weitere Informationen finden Sie unter Definition von Datenströmen aus Geräten (Messungen).

   4. (Optional) Fügen Sie Transformationsdefinitionen für das Modell hinzu. Transformationen sind Formeln, die Daten von einem Formular auf ein anderes abbilden. Weitere Informationen finden Sie unter Daten transformieren (transformiert).

   5. (Optional) Fügen Sie Metrik-Definitionen für das Modell hinzu. Metriken sind Formeln, die Daten über Zeitintervalle aggregieren. Mit Metriken können Daten aus zugehörigen Anlagen eingegeben werden, sodass Sie Werte berechnen können, die Ihren Betrieb oder einen Teil Ihres Betriebs repräsentieren. Weitere Informationen finden Sie unter Aggregieren von Daten aus Immobilien und anderen Vermögenswerten (Metriken).

   6. Wählen Sie Komponente erstellen.

Erstellen eines benutzerdefinierten Inline-Verbundmodells (AWS CLI)

Sie können das AWS Command Line Interface (AWS CLI) verwenden, um ein benutzerdefiniertes Inline-Verbundmodell zu erstellen, das seine eigenen Eigenschaften definiert.

Verwenden Sie die Operation CreateAssetModelCompositeModel, um ein Inline-Modell mit Eigenschaften zu erstellen. Diese Operation erwartet eine Nutzlast mit der folgenden Struktur.

Anmerkung

Da es sich um ein zusammengesetztes Inline-Modell handelt, gelten diese Eigenschaften nur für das aktuelle Anlagenmodell und werden nirgendwo anders verwendet. Was es „inline“ macht, ist, dass es keinen Wert für das composedAssetModelId Feld bereitstellt.

Wenn Sie ein wiederverwendbares Modell erstellen müssen (z. B. um es von mehreren Asset-Modellen gemeinsam zu nutzen oder um mehrere Instanzen in ein Asset-Modell einzubeziehen), sollten Sie stattdessen ein auf einem Komponentenmodell basierendes Verbundmodell erstellen. Einzelheiten finden Sie im folgenden Abschnitt.

{
    "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"
        }
    ]
}

Eine component-model-based Komponente (Konsole) erstellen

Sie können die AWS IoT SiteWise Konsole verwenden, um eine Komponente zu erstellen, die auf einem Komponentenmodell basiert.

Um eine component-model-based Komponente (Konsole) zu erstellen

1. Navigieren Sie zur AWS IoT SiteWise -Konsole.

2. Klicken Sie im Navigationsbereich auf Models (Modelle).

3. Wählen Sie das Asset-Modell aus, zu dem Sie eine Komponente hinzufügen möchten.

4. Wählen Sie auf der Registerkarte Eigenschaften die Option Komponenten aus.

5. Wählen Sie Komponente erstellen.

6. Gehen Sie auf der Seite Komponente erstellen wie folgt vor:

   1. Wählen Sie das Komponentenmodell aus, auf dem die Komponente basieren soll.

   2. Geben Sie einen Namen für die Komponente ein, z. B. ServoMotor oderServoMotor Model. Dieser Name muss für alle Komponenten in Ihrem Konto in dieser Region eindeutig sein.

   3. Wählen Sie Komponente erstellen aus.

Erstellen eines component-model-based benutzerdefinierten Verbundmodells (AWS CLI)

Sie können das verwenden AWS CLI , um ein component-model-based benutzerdefiniertes Verbundmodell innerhalb Ihres Asset-Modells zu erstellen. Ein component-model-based benutzerdefiniertes Verbundmodell ist ein Verweis auf ein Komponentenmodell, das Sie bereits an anderer Stelle definiert haben.

Verwenden Sie die Operation CreateAssetModelCompositeModell, um ein component-model-based benutzerdefiniertes Verbundmodell zu erstellen. Diese Operation erwartet eine Nutzlast mit der folgenden Struktur.

Anmerkung

In diesem Beispiel composedAssetModelId ist der Wert von die Objektmodell-ID oder die externe ID eines vorhandenen Komponentenmodells. Weitere Informationen finden Sie unter Objekte mit externen IDs referenzieren im AWS IoT SiteWise -Benutzerhandbuch. Ein Beispiel für die Erstellung eines Komponentenmodells finden Sie unterErstellen eines Komponentenmodells (AWS CLI).

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

Da es sich nur um eine Referenz handelt, hat ein component-model-based benutzerdefiniertes Verbundmodell außer einem Namen keine eigenen Eigenschaften.

Wenn Sie Ihrem Objektmodell mehrere Exemplare derselben Komponente hinzufügen möchten (z. B. eine CNC-Maschine mit mehreren Servomotoren), können Sie mehrere component-model-based benutzerdefinierte Verbundmodelle hinzufügen, die jeweils einen eigenen Namen haben, aber alle auf denselben Namen verweisencomposedAssetModelId.

Sie können Komponenten innerhalb anderer Komponenten verschachteln. Dazu können Sie einem Ihrer Komponentenmodelle ein component-model-based zusammengesetztes Modell hinzufügen, wie in diesem Beispiel gezeigt.