Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Formato di payload dei messaggi per il broker EMQX su Edge AWS IoT SiteWise
<a name="connect-broker-payload-format"></a>

Affinché il componente SiteWise editore IoT utilizzi i dati dall'applicazione esterna e li pubblichi sul AWS IoT SiteWise cloud, il payload inviato al broker deve soddisfare requisiti specifici.

La comprensione del formato del payload è fondamentale per una comunicazione MQTT efficace con Edge. AWS IoT SiteWise Sebbene il processo di configurazione della connessione sia trattato nelle sezioni successive, presentiamo innanzitutto i requisiti del payload per aiutarvi a pianificare l'implementazione.

## Requisiti dell'argomento MQTT
<a name="connect-broker-mqtt-requirements"></a>

Non ci sono restrizioni sulla struttura degli argomenti MQTT, incluso il numero di livelli o caratteri utilizzati. Tuttavia, è consigliabile che l'argomento corrisponda al `propertyAlias` campo del payload.

**Example Esempio di alias di proprietà**  
Se l'argomento MQTT è`site1/line1/compressor1/temperature`, assicurati che le `propertyAlias` corrispondano.  

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

## Struttura del payload JSON
<a name="connect-broker-json-payload"></a>

[Il payload dei messaggi MQTT è scritto in JSON e segue il formato del `PutAssetPropertyValueEntry` messaggio definito nell'API Reference.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"
         }
      }
   ]
}
```

**Nota**  
Affinché un messaggio sia considerato valido, può essere soddisfatta solo una delle seguenti condizioni:  
`propertyAlias`è impostato, oppure
Entrambe `assetId` e due `propertyId` sono impostate
`PutAssetPropertyValueEntry`Ha un `entryId` campo che non è obbligatorio in questo contesto.