View a markdown version of this page

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 Anlagenmodellen 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 dem Definieren eines Anlagenmodells sehr ähnlich. Wie ein Anlagenmodell hat ein Komponentenmodell einen Namen, eine Beschreibung und Anlageneigenschaften. Komponentenmodelle können jedoch keine Definitionen der Asset-Hierarchie enthalten, da die Komponentenmodelle selbst nicht zur direkten Erstellung von Assets verwendet werden können. Komponentenmodelle können auch keine Alarme definieren.

Sie können beispielsweise eine Komponente für einen Servomotor mit Eigenschaften wie 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. Anlagenmodelle enthalten Verweise auf vorhandene 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 Objektmodelle in AWS IoT SiteWise zum Erstellen von benutzerdefinierten Verbundmodellen finden Sie unterErstellen Sie benutzerdefinierte Verbundmodelle (Komponenten).

In den folgenden Abschnitten wird beschrieben, wie Sie die AWS IoT SiteWise API zum Erstellen von Komponentenmodellen verwenden.

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 CreateAssetModel Operation, 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 Datei component-model-payload.json 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 Dokument für alle Anlagemodelle 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 Anlageneigenschaften (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 Tagge dein AWS IoT SiteWise Ressourcen.

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

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

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

    Anmerkung

    Die Erstellung des Komponentenmodells kann bei komplexen Modellen bis zu einigen Minuten dauern. Verwenden Sie die DescribeAssetModel Operation, um den aktuellen Status Ihres Komponentenmodells zu überprüfen, indem Sie den angebenassetModelId. Sobald der Status des Komponentenmodells erreicht istACTIVE, können Sie Verweise auf Ihr Komponentenmodell in Anlagenmodellen 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 ein Beispiel für eine Komponentenmodelldefinition, mit der Sie ein Komponentenmodell mit den AWS IoT SiteWise SDKs AWS CLI und erstellen können. 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 liefert verschiedene Messungen wie Temperaturen und elektrischen Widerstand. Diese Messungen sind als Eigenschaften für Objekte verfügbar, die anhand von 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"
        }
    ]
}