As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Formato de carga útil de mensagem para o corretor EMQX no Edge AWS IoT SiteWise
<a name="connect-broker-payload-format"></a>

Para que o componente do SiteWise editor de IoT consuma dados do seu aplicativo externo e os publique AWS IoT SiteWise na nuvem, a carga útil enviada ao agente deve atender a requisitos específicos.

Compreender o formato da carga útil é fundamental para uma comunicação bem-sucedida do MQTT com AWS IoT SiteWise o Edge. Embora o processo de configuração da conexão seja abordado nas seções posteriores, apresentaremos primeiro os requisitos de carga útil para ajudá-lo a planejar sua implementação.

## Requisitos de tópicos do MQTT
<a name="connect-broker-mqtt-requirements"></a>

Não há restrições na estrutura de tópicos do MQTT, incluindo o número de níveis ou caracteres usados. No entanto, recomendamos que o tópico corresponda ao `propertyAlias` campo na carga.

**Example Exemplo de alias de propriedade**  
Se o tópico do MQTT for`site1/line1/compressor1/temperature`, garanta as `propertyAlias` correspondências.  

```
{
  "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
      }
    }
  ]
}
```

## Estrutura de carga útil JSON
<a name="connect-broker-json-payload"></a>

[A carga útil da mensagem MQTT é escrita em JSON e segue o formato de `PutAssetPropertyValueEntry` mensagem definido na Referência da AWS IoT SiteWise API.](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"
         }
      }
   ]
}
```

**nota**  
Para que uma mensagem seja considerada válida, somente uma das seguintes condições pode ser verdadeira:  
O `propertyAlias` está definido, ou
Ambos `assetId` `propertyId` estão definidos
O `PutAssetPropertyValueEntry` tem um `entryId` campo que não é obrigatório neste contexto.