Ordnen Sie industrielle Datenströme den Eigenschaften von Anlagen zu - AWS IoT SiteWise
Legen Sie einen Eigenschaftsalias fest (Konsole)Legen Sie einen Eigenschaftsalias fest (AWS CLI)

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.

Ordnen Sie industrielle Datenströme den Eigenschaften von Anlagen zu

Sie können einen Eigenschaftsalias für eine Anlageeigenschaft definieren. Auf diese Weise können Sie eine Anlageneigenschaft identifizieren, wenn Sie Anlagendaten aufnehmen oder abrufen. Wenn Ihr Asset über Messeigenschaften verfügt, können Sie die Eigenschaftsaliase definieren, um Ihre Datenströme diesen Messeigenschaften zuzuordnen.

Für diesen Vorgang müssen Sie den Aliasnamen Ihrer Immobilie kennen.

  • Wenn Sie Daten von OPC UA-Servern mithilfe einer OPCUA-Datenquelle in einem SiteWise Edge-Gateway aufnehmen, ist Ihr Eigenschaftsalias der Pfad zu einer Variablen unter dem Objektknoten, beginnend mit/.

    Beispiel

    Wenn der Pfad zu Ihrer Variablen lautetcompany/windfarm/3/turbine/7/temperature, dann ist /company/windfarm/3/turbine/7/temperature Ihr Eigenschaftsalias.

    Weitere Informationen zur OPC UA-Informationsarchitektur finden Sie unter Informationsmodell und Zuordnung von Adressabständen in der OPCUA-Online-Referenz.

    Hinweise

    • Wenn Sie ein Datenstream-Präfix für Ihre OPC UA-Quelle konfigurieren, müssen Sie dieses Präfix in den Eigenschaftsalias für alle Datenströme aus dieser Quelle aufnehmen.

      Beispiel

      Wenn /RentonWA es ein Präfix ist, dann ist es der vorherige Alias/RentonWA/company/windfarm/3/turbine/7/temperature.

    • Eigenschaftsaliase können bis zu 1.000 Byte enthalten. OPCUA-Variablenpfade können bis zu 4.096 Byte enthalten. Unterstützt derzeit AWS IoT SiteWise nicht das Einlesen von Daten aus OPC UA-Variablen mit langen Pfaden.

  • Wenn Sie Daten von Modbus-Servern mithilfe einer TCPModbus-Datenquelle in einem SiteWise Edge-Gateway aufnehmen, lautet Ihr Eigenschaftsalias:

    Modbus register set tag name

    Verwenden Sie diesen Wert, um Daten aus diesem Registersatz an eine Anlageneigenschaft zu senden.

  • Wenn Sie Daten aus anderen Quellen aufnehmen, z. B. mithilfe von AWS IoT Regeln oder dem API, müssen Sie Ihre Eigenschafts-Aliase definieren. Sie können ein Benennungssystem für Eigenschaftenalias definieren, das auf Ihre Gerätekonfiguration anwendbar ist. Wenn Sie beispielsweise Daten aus AWS IoT -Dingen aufnehmen, können Sie den Namen der Sache in Eigenschaftenaliasnamen aufnehmen, um Datenströme eindeutig zu identifizieren. Weitere Informationen zu diesem Beispiel finden Sie im Tutorial Daten aus AWS IoT Dingen aufnehmen.

Aliase für Immobilien müssen innerhalb einer Region und AWS eines Kontos eindeutig sein. AWS IoT SiteWise gibt einen Fehler zurück, wenn Sie einen Eigenschaftsalias auf einen Alias setzen, der bereits in einer anderen Vermögenseigenschaft vorhanden ist.

Wenn Sie über mehrere OPC UA-Quellen mit identischen Datenstream-Pfaden verfügen, fügen Sie den Pfaden jeder Quelle ein Präfix hinzu, um eindeutige Aliase zu bilden. Weitere Informationen finden Sie unter OPCUA-Datenquellen.

Anmerkung

In diesem Abschnitt wird beschrieben, wie Eigenschaftsaliase für Messeigenschaften festgelegt werden. Weitere Informationen zum Festlegen von Eigenschaftsaliasnamen für externe Alarmstatuseigenschaften finden Sie unter. Ordnen Sie externe Alarmstatus-Streams zu

Legen Sie einen Eigenschaftsalias fest (Konsole)

Sie können die AWS IoT SiteWise Konsole verwenden, um einen Alias für eine Asset-Eigenschaft festzulegen.

So legen Sie einen Eigenschaftenalias fest (Konsole)

  1. Navigieren Sie zur AWS IoT SiteWise -Konsole.

  2. Wählen Sie im linken Navigationsbereich Komponenten aus.

  3. Wählen Sie die Komponente aus, für die Sie einen Eigenschaftenalias festlegen möchten.

    Tipp

    Sie können eine Komponentenhierarchie mithilfe des Pfeilsymbols erweitern, um nach Ihrer Komponente zu suchen.

  4. Wählen Sie Edit (Bearbeiten) aus.

  5. Suchen Sie die Eigenschaft, für die Sie einen Alias festlegen möchten, und geben Sie dann den Eigenschaftenalias ein.

    AWS IoT SiteWise Screenshot der Seite „Asset bearbeiten“ mit hervorgehobenem Eigenschaftsalias.

  6. Wählen Sie Save (Speichern) aus.

Legen Sie einen Eigenschaftsalias fest (AWS CLI)

Verwenden Sie AWS Command Line Interface (AWS CLI), um einen Alias für eine Asset-Eigenschaft festzulegen.

Um dieses Verfahren abzuschließen, müssen Sie die assetId Ihrer Komponenten und die propertyId Ihrer Eigenschaft kennen. Sie können auch die externe ID verwenden. Wenn Sie ein Asset erstellt haben und es nicht kennenassetId, verwenden Sie das, ListAssetsAPIum alle Assets für ein bestimmtes Modell aufzulisten. Verwenden Sie den DescribeAssetVorgang, um die Eigenschaften Ihres Objekts einschließlich der Immobilien anzuzeigenIDs.

Verwenden Sie die UpdateAssetPropertyOperation, um der Immobilie Ihres Vermögenswerts einen Datenstrom zuzuordnen. Geben Sie die folgenden Parameter an:

  • assetId— Die ID oder externe ID des Vermögenswerts. Weitere Informationen finden Sie unter Referenzobjekte mit externen IDs im AWS IoT SiteWise -Benutzerhandbuch.

  • propertyId— Die ID oder externe ID der Asset-Immobilie.

  • propertyAlias— Der Pfad des Datenstroms zum Alias für die Eigenschaft.

  • propertyNotificationState— Status der Benachrichtigung über den Eigenschaftswert: ENABLED oderDISABLED. Geben Sie den vorhandenen Benachrichtigungsstatus der Eigenschaft an, wenn Sie den Eigenschaftenalias aktualisieren. Sie können den vorhandenen Benachrichtigungsstatus mit der DescribeAssetPropertyOperation abrufen.

    Wenn Sie diesen Parameter auslassen, ist der neue Benachrichtigungsstatus DISABLED. Weitere Informationen zu Eigenschaftenbenachrichtigungen finden Sie unter Interagiere mit anderen AWS Diensten.

Um einen Eigenschaftsalias (AWS CLI) festzulegen

  1. Führen Sie den folgenden Befehl aus, um den aktuellen Benachrichtigungsstatus der Eigenschaft abzurufen. Ersetzen asset-id and property-id mit den Eigenschaften der AnlageIDs.

    aws iotsitewise describe-asset-property \
  --asset-id asset-id \
  --property-id property-id

    Die Operation gibt eine Antwort zurück, die Informationen zur Komponenteneigenschaft im folgenden Format enthält. Der Status der Eigenschaftsbenachrichtigung ist assetProperty.notification.state im JSON Objekt aktiviert.

    {
  "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
  "assetName": "Wind Turbine 7",
  "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
  "assetProperty": {
    "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
    "name": "Wind Speed",
    "notification": {
      "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "state": "ENABLED"
    },
    "dataType": "DOUBLE",
    "unit": "m/s",
    "type": {
      "measurement": {}
    }
  }
}

  2. Führen Sie den folgenden Befehl aus, um den Alias der Komponenteneigenschaft festzulegen. Ersetzen property-alias mit dem Eigenschaftsalias und notification-state mit dem Benachrichtigungsstatus oder lassen Sie es aus, um Benachrichtigungen --property-notification-state zu deaktivieren. Sie können die Einheit des Assets optional mit einer neuen aktualisieren unit und--property-unit.

    aws iotsitewise update-asset-property \
  --asset-id asset-id \
  --property-id property-id \
  --property-alias property-alias \
  --property-notification-state notification-state \
  --property-unit unit

  3. Um zu überprüfen, ob der Alias festgelegt wurde, führen Sie den folgenden Befehl aus, um die Details der Eigenschaft abzurufen. Ersetzen asset-id and property-id mit den Eigenschaften der AnlageIDs.

    aws iotsitewise describe-asset-property \
  --asset-id asset-id \
  --property-id property-id

    Die Operation gibt eine Antwort zurück, die Informationen zur Komponenteneigenschaft im folgenden Format enthält. Der Eigenschaftsalias befindet sich assetProperty.alias im JSON Objekt und ist myAlias in diesem Beispiel auf eingestellt.

    {
  "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
  "assetName": "Wind Turbine 7",
  "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
  "assetProperty": {
    "alias": "myAlias",
    "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
    "name": "Wind Speed",
    "notification": {
      "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "state": "ENABLED"
    },
    "dataType": "DOUBLE",
    "unit": "m/s",
    "type": {
      "measurement": {}
    }
  }
}