Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Format payload pesan untuk broker EMQX di Edge AWS IoT SiteWise
<a name="connect-broker-payload-format"></a>

Agar komponen SiteWise penerbit IoT mengkonsumsi data dari aplikasi eksternal Anda dan mempublikasikannya ke AWS IoT SiteWise cloud, muatan yang dikirim ke broker harus memenuhi persyaratan khusus.

Memahami format payload adalah kunci keberhasilan komunikasi MQTT dengan Edge. AWS IoT SiteWise Sementara proses pengaturan koneksi tercakup dalam bagian selanjutnya, kami menyajikan persyaratan payload terlebih dahulu untuk membantu Anda merencanakan implementasi Anda.

## Persyaratan topik MQTT
<a name="connect-broker-mqtt-requirements"></a>

Tidak ada batasan pada struktur topik MQTT, termasuk jumlah level atau karakter yang digunakan. Namun, kami menyarankan agar topik tersebut cocok dengan `propertyAlias` bidang di payload.

**Example Contoh alias properti**  
Jika topik MQTT adalah`site1/line1/compressor1/temperature`, pastikan kecocokannya. `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
      }
    }
  ]
}
```

## Struktur muatan JSON
<a name="connect-broker-json-payload"></a>

[Payload pesan MQTT ditulis dalam JSON dan mengikuti format `PutAssetPropertyValueEntry` pesan yang ditentukan dalam Referensi API.AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetPropertyValueEntry.html)

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

**catatan**  
Agar pesan dianggap valid, hanya satu dari kondisi berikut yang bisa benar:  
yang `propertyAlias` ditetapkan, atau
Keduanya `assetId` dan `propertyId` diatur
`PutAssetPropertyValueEntry`Memiliki `entryId` bidang yang tidak diperlukan dalam konteks ini.