Erstellen Sie Komponentenmodelle - AWS IoT SiteWise
Erstellen Sie ein Komponentenmodell (AWS CLI)Beispiel für ein Komponentenmodell

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erstellen Sie Komponentenmodelle

Verwenden Sie AWS IoT SiteWise Komponentenmodelle, um Unterbaugruppen zu definieren, auf die Sie anhand von Objektmodellen oder anderen Komponentenmodellen verweisen können. Auf diese Weise können Sie die Definition der Komponente in mehreren anderen Modellen oder mehrfach innerhalb desselben Modells wiederverwenden.

Der Prozess der Definition eines Komponentenmodells ist der Definition eines Asset-Modells sehr ähnlich. Wie ein Asset-Modell hat auch ein Komponentenmodell einen Namen, eine Beschreibung und Asset-Eigenschaften. Komponentenmodelle können jedoch keine Definitionen der Asset-Hierarchie enthalten, da die Komponentenmodelle selbst nicht zur direkten Erstellung von Objekten verwendet werden können. Komponentenmodelle können auch keine Alarme definieren.

Sie können beispielsweise eine Komponente für einen Servomotor mit Eigenschaften für Motortemperatur, Encodertemperatur und Isolationswiderstand definieren. Anschließend können Sie ein Anlagenmodell für Geräte definieren, die Servomotoren enthalten, z. B. eine CNC Maschine.

Anmerkung

  • Es empfiehlt sich, bei der Modellierung mit den Knoten der untersten Ebene zu beginnen. Erstellen Sie beispielsweise Ihre Servomotorkomponente, bevor Sie das Anlagenmodell Ihrer CNC Maschine erstellen. Objektmodelle enthalten Verweise auf bestehende Komponentenmodelle.

  • Sie können ein Asset nicht direkt aus einem Komponentenmodell erstellen. Um ein Asset zu erstellen, das Ihre Komponente verwendet, müssen Sie ein Asset-Modell für Ihr Asset erstellen. Anschließend erstellen Sie dafür ein benutzerdefiniertes Verbundmodell, das auf Ihre Komponente verweist. Weitere Informationen zum Erstellen von Objektmodellen finden Sie unter Weitere Informationen Erstellen Sie Asset-Modelle zum Erstellen von benutzerdefinierten Verbundmodellen finden Sie unterErstellen Sie benutzerdefinierte Verbundmodelle (Komponenten).

In den folgenden Abschnitten wird beschrieben, wie Sie AWS IoT SiteWise API mit dem Komponentenmodelle erstellen können.

Erstellen Sie ein Komponentenmodell (AWS CLI)

Sie können das AWS Command Line Interface (AWS CLI) verwenden, um ein Komponentenmodell zu erstellen.

Verwenden Sie die CreateAssetModelOperation, um ein Komponentenmodell mit Eigenschaften zu erstellen. Für diesen Vorgang wird eine Nutzlast mit der folgenden Struktur erwartet:

{
  "assetModelType": "COMPONENT_MODEL",
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
}
Um ein Komponentenmodell zu erstellen ()AWS CLI

  1. Erstellen Sie eine Datei mit dem Namen component-model-payload.json und kopieren Sie dann das folgende JSON Objekt in die Datei:

    {
  "assetModelType": "COMPONENT_MODEL",
  "assetModelName": "",
  "assetModelDescription": "",
  "assetModelProperties": [

  ]
}

  2. Verwenden Sie Ihren bevorzugten JSON Texteditor, um die component-model-payload.json Datei für Folgendes zu bearbeiten:

    1. Geben Sie einen Namen (assetModelName) für das Komponentenmodell ein, z. B. Servo Motor oderServo Motor Model. Dieser Name muss in diesem Fall für alle Asset- und Komponentenmodelle in Ihrem Konto eindeutig sein AWS-Region.

    2. (Optional) Geben Sie eine externe ID (assetModelExternalId) für das Komponentenmodell ein. Dies ist eine benutzerdefinierte ID. Weitere Informationen finden Sie unter Referenzobjekte mit externen IDs im AWS IoT SiteWise -Benutzerhandbuch.

    3. (Optional) Geben Sie eine Beschreibung (assetModelDescription) für das Komponentenmodell ein oder entfernen Sie das assetModelDescription-Schlüssel-Wert-Paar.

    4. (Optional) Definieren Sie Asset-Eigenschaften (assetModelProperties) für das Komponentenmodell. Weitere Informationen finden Sie unter Definieren Sie Dateneigenschaften.

    5. (Optional) Fügen Sie Tags (tags) für das Komponentenmodell hinzu. Weitere Informationen finden Sie unter Kennzeichnen Sie Ihre AWS IoT SiteWise Ressourcen.

  3. Führen Sie den folgenden Befehl aus, um aus der Definition in der JSON Datei ein Komponentenmodell zu erstellen.

    aws iotsitewise create-asset-model --cli-input-json file://component-model-payload.json

    Der Vorgang gibt eine Antwort zurück, die die Antwort enthält, auf assetModelId die Sie sich beziehen, wenn Sie einen Verweis auf Ihr Komponentenmodell in einem Objektmodell oder einem anderen Komponentenmodell hinzufügen. Die Antwort enthält auch den Zustand des Modells (assetModelStatus.state), der anfänglich CREATING lautet. Der Status des Komponentenmodells ist so CREATING lange gültig, bis die Änderungen übernommen werden.

    Anmerkung

    Die Erstellung des Komponentenmodells kann bei komplexen Modellen bis zu einigen Minuten dauern. Um den aktuellen Status Ihres Komponentenmodells zu überprüfen, verwenden Sie den DescribeAssetModelVorgang, indem Sie den angebenassetModelId. Sobald der Status des Komponentenmodells lautetACTIVE, können Sie Verweise auf Ihr Komponentenmodell in Objektmodellen oder anderen Komponentenmodellen hinzufügen. Weitere Informationen finden Sie unter Komponenten- und Modellzustände.

  4. (Optional) Erstellen Sie benutzerdefinierte Verbundmodelle für Ihr Komponentenmodell. Bei benutzerdefinierten Verbundmodellen können Sie Eigenschaften innerhalb des Modells gruppieren oder eine Unterbaugruppe einbeziehen, indem Sie auf ein anderes Komponentenmodell verweisen. Weitere Informationen finden Sie unter Erstellen Sie benutzerdefinierte Verbundmodelle (Komponenten).

Beispiel für ein Komponentenmodell

Dieser Abschnitt enthält eine Beispieldefinition für ein Komponentenmodell, mit der Sie ein Komponentenmodell mit dem AWS CLI und erstellen können AWS IoT SiteWise SDKs. Dieses Komponentenmodell stellt einen Servomotor dar, der in einem anderen Gerät, z. B. einer CNC Maschine, verwendet werden kann.

Komponentenmodell des Servomotors

Das folgende Komponentenmodell stellt einen Servomotor dar, der in Geräten wie CNC Maschinen verwendet werden kann. Der Servomotor bietet verschiedene Messwerte, z. B. für Temperaturen und elektrischen Widerstand. Diese Messungen sind als Eigenschaften für Objekte verfügbar, die aus Objektmodellen erstellt wurden, die auf das Komponentenmodell des Servomotors verweisen.

{
    "assetModelName": "ServoMotor",
    "assetModelType": "COMPONENT_MODEL",
    "assetModelProperties": [
        {
            "dataType": "DOUBLE",
            "name": "Servo Motor Temperature",
            "type": {
            "measurement": {}
            },
            "unit": "Celsius"
        },
        {
            "dataType": "DOUBLE",
            "name": "Spindle speed",
            "type": {
            "measurement": {}
            },
            "unit": "rpm"
        }
    ]
}