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

# AWS IoT SiteWise Edge の EMQX ブローカーのメッセージペイロード形式
<a name="connect-broker-payload-format"></a>

IoT SiteWise パブリッシャーコンポーネントが外部アプリケーションからデータを消費して AWS IoT SiteWise クラウドに公開するには、ブローカーに送信されるペイロードが特定の要件を満たしている必要があります。

 AWS IoT SiteWise Edge との MQTT 通信を成功させるには、ペイロード形式を理解することが重要です。接続のセットアッププロセスは後のセクションで説明しますが、実装の計画に役立つペイロード要件を最初に説明します。

## MQTT トピックの要件
<a name="connect-broker-mqtt-requirements"></a>

使用されるレベルや文字の数など、MQTT トピック構造に制限はありません。ただし、トピックはペイロードの `propertyAlias`フィールドと一致することをお勧めします。

**Example プロパティエイリアスの例**  
MQTT トピックが の場合は`site1/line1/compressor1/temperature`、 `propertyAlias` が一致していることを確認します。  

```
{
  "assetId": "compressor_asset_01",
  "propertyAlias": "site1/line1/compressor1/temperature",
  "propertyId": "temperature_sensor_01",
  "propertyValues": [
    {
      "quality": "GOOD",
      "timestamp": {
        "offsetInNanos": 0,
        "timeInSeconds": 1683000000
      },
      "value": {
        "doubleValue": 23.5
      }
    }
  ]
}
```

## JSON ペイロード構造
<a name="connect-broker-json-payload"></a>

MQTT メッセージペイロードは JSON で記述され、 [AWS IoT SiteWise API リファレンス](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetPropertyValueEntry.html)で定義されている`PutAssetPropertyValueEntry`メッセージ形式に従います。

```
{
   "assetId": "string",
   "propertyAlias": "string",
   "propertyId": "string",
   "propertyValues": [
      {
         "quality": "string",
         "timestamp": {
            "offsetInNanos": number,
            "timeInSeconds": number
         },
         "value": {
            "booleanValue": boolean,
            "doubleValue": number,
            "integerValue": number,
            "stringValue": "string"
         }
      }
   ]
}
```

**注記**  
メッセージが有効と見なされるには、次のいずれかの条件のみが該当します。  
`propertyAlias` が設定されている、または
`assetId` と の両方`propertyId`が設定されている
`PutAssetPropertyValueEntry` には、このコンテキストで必須ではない `entryId`フィールドがあります。