産業データストリームをアセットプロパティにマッピングする - AWS IoT SiteWise

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

産業データストリームをアセットプロパティにマッピングする

アセットプロパティでプロパティエイリアスを定義できます。これにより、アセットデータの取り込みまたは取得時にアセットプロパティを識別できます。アセットに測定プロパティがある場合は、プロパティエイリアスを定義して、データストリームをそのプロパティにマッピングすることができます。

このプロセスでは、プロパティのエイリアスを知っている必要があります。

  • Edge ゲートウェイ の OPC UA データソースを使用して UA サーバーからデータを取り込む場合、プロパティエイリアスは Objects ノードの下の変数へのパスで、 で始まります/OPC SiteWise

    変数へのパスが の場合company/windfarm/3/turbine/7/temperature、プロパティエイリアスは です/company/windfarm/3/turbine/7/temperature

    OPC UA 情報アーキテクチャの詳細については、OPCUA オンラインリファレンス「情報モデルとアドレス間隔マッピング」を参照してください。

    メモ
    • OPC UA ソースのデータストリームプレフィックスを設定する場合は、そのソースからのすべてのデータストリームのプロパティエイリアスにそのプレフィックスを含める必要があります。

      /RentonWA がプレフィックスの場合、以前のエイリアスは です/RentonWA/company/windfarm/3/turbine/7/temperature

    • プロパティのエイリアスは、最大 1,000 バイトまで含むことができます。OPC UA 変数パスには、最大 4,096 バイトを含めることができます。現在、 AWS IoT SiteWise は長いパスを持つ OPC UA 変数からのデータの取り込みをサポートしていません。

  • SiteWise Edge ゲートウェイ の Modbus TCPデータソースを使用して Modbus サーバーからデータを取り込む場合、プロパティエイリアスは次のとおりです。

    Modbus register set tag name

    この値を使用して、このレジスタセットからアセットプロパティにデータを送信します。

  • AWS IoT ルールや など、他のソースからデータを取り込む場合はAPI、プロパティエイリアスを定義する必要があります。デバイス設定に適用可能なプロパティエイリアス命名システムを定義できます。たとえば、 AWS IoT のモノからデータを取り込む場合、プロパティエイリアスにモノの名を含めることで、データストリームを一意に識別できます。この例の詳細については、AWS IoT 「モノからのデータの取り込み」チュートリアルを参照してください。

プロパティエイリアスは、リージョンと AWS account AWS IoT SiteWise 内で一意である必要があります。プロパティエイリアスを別のアセットプロパティに既に存在するものに設定すると、エラーが返されます。

同じデータストリームパスを持つ複数の OPC UA ソースがある場合は、各ソースのパスにプレフィックスを追加して一意のエイリアスを作成します。詳細については、「OPC UA データソース」を参照してください。

注記

このセクションでは、測定プロパティのプロパティエイリアスを設定する方法について説明します。外部アラーム状態プロパティのプロパティエイリアスを設定する方法については、外部アラーム状態ストリームをマッピングする を参照してください。

プロパティエイリアスを設定する (コンソール)

AWS IoT SiteWise コンソールを使用して、アセットプロパティのエイリアスを設定できます。

プロパティエイリアスを設定するには (コンソール)
  1. AWS IoT SiteWise コンソールに移動します。

  2. ナビゲーションペインで [Assets (アセット) ] を選択します。

  3. プロパティエイリアスを設定するアセットを選択します。

    ヒント

    矢印アイコンを選択して、アセット階層を展開してアセットを検索できます。

  4. [編集] を選択します。

  5. エイリアスを設定するプロパティを検索し、プロパティのエイリアスを入力します。

    AWS IoT SiteWise プロパティエイリアスが強調表示された「アセットの編集」ページのスクリーンショット。
  6. [Save] を選択します。

プロパティエイリアスを設定する (AWS CLI)

AWS Command Line Interface (AWS CLI) を使用して、アセットプロパティのエイリアスを設定します。

この手順を完了するには、アセットの assetId とプロパティの propertyId を知っている必要があります。外部 ID を使用することもできます。アセットを作成し、その がわからない場合はassetId、 を使用して特定のモデルのすべてのアセットをListAssetsAPI一覧表示します。DescribeAsset オペレーションを使用して、プロパティ を含むアセットのプロパティを表示しますIDs。

UpdateAssetProperty オペレーションを使用して、データストリームをアセットの プロパティにマッピングします。以下のパラメータを指定します。

  • assetId – アセットの ID または外部 ID。詳細については、AWS IoT SiteWise  ユーザーガイドの 外部でオブジェクトを参照する IDsを参照してください。

  • propertyId – アセットプロパティの ID または外部 ID。

  • propertyAlias - プロパティへのエイリアスへのデータストリームのパス。

  • propertyNotificationState - プロパティ値の通知状態: ENABLED または DISABLED。プロパティのエイリアスを更新するときに、プロパティの既存の通知状態を指定します。DescribeAssetProperty オペレーションを使用して、既存の通知状態を取得できます。

    このパラメータを省略すると、新しい通知状態が DISABLED になります。プロパティ通知の詳細については、「他の AWS サービスとやり取りする」を参照してください。

プロパティエイリアスを設定するには (AWS CLI)
  1. 次のコマンドを実行して、プロパティの現在の通知状態を取得します。置換 asset-id また、property-id アセットプロパティの を使用しますIDs。

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

    このオペレーションは、アセットプロパティの詳細を含むレスポンスを次の形式で返します。プロパティ通知の状態は JSON オブジェクトassetProperty.notification.stateの です。

    { "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. 次のコマンドを実行して、アセットプロパティのエイリアスを設定します。置換 property-alias プロパティエイリアス および を持つ notification-state 通知状態を指定するか、 を省略--property-notification-stateして通知を無効にします。オプションで、アセットの単位を新しい で更新できます。unit および --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. エイリアスが設定されていることを確認するには、以下のコマンドを実行してプロパティの詳細を取得します。置換 asset-id また、property-id アセットプロパティの を使用しますIDs。

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

    このオペレーションは、アセットプロパティの詳細を含むレスポンスを次の形式で返します。プロパティエイリアスは JSON オブジェクトassetProperty.aliasにあり、myAliasこの例では に設定されています。

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