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

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

アセットプロパティへの産業データストリームのマッピング

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

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

  • ゲートウェイを使用して OPC-UA サーバーからデータを取り込む場合、プロパティエイリアスは、Objects ノードの下の変数へのパスです。 で始まり/ます。 たとえば、変数へのパスが の場合company/windfarm/3/turbine/7/temperature、プロパティエイリアスは です/company/windfarm/3/turbine/7/temperature。OPC-UA 情報アーキテクチャの詳細については、OPC UA オンラインリファレンス「情報モデルとアドレス空間のマッピング」を参照してください。

    Notes
    • OPC-UA ソースのデータストリームプレフィックスを設定する場合は、そのソースからのすべてのデータストリームのプロパティエイリアスにそのプレフィックスを含める必要があります。たとえば、/RentonWA をプレフィックスとして使用する場合、前のエイリアスは /RentonWA/company/windfarm/3/turbine/7/temperature. です。

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

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

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

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

注記

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

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

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

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

  1. AWS IoT SiteWise コンソール に移動します。

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

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

    ヒント

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

    
        AWS IoT SiteWise アセット階層が強調表示された  の「アセット」ページのスクリーンショット。
  4. Edit.] を選択します。

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

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

プロパティエイリアスの設定 (CLI)

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

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

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

  • assetId – アセットの ID。

  • propertyId – アセットプロパティの ID。

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

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

    このパラメータを省略した場合、新しい通知状態は になりますDISABLED。 プロパティ通知の詳細については、「」Interacting with other AWS servicesを参照してください。

プロパティエイリアスを設定するには (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": "DISABLED | ENABLED" }, "dataType": "DOUBLE", "unit": "m/s", "type": { "measurement": {} } } }
  2. 次のコマンドを実行して、アセットプロパティのエイリアスを設定します。置換 property-alias プロパティエイリアス および を持つ notification-state 通知状態を持つ 、または を省略--property-notification-stateして通知を無効にします。

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