

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à.

# Crea dashboard con AWS CLI
<a name="create-dashboards-ai-dashboard-cli"></a>

**Nota**  
La funzione SiteWise Monitor non è più disponibile per i nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [SiteWise Monitorare la modifica della disponibilità](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html).

Quando si definiscono visualizzazioni (o widget) nei dashboard utilizzando il AWS CLI, è necessario specificare le seguenti informazioni nel documento JSON. `dashboardDefinition` Questa definizione è un parametro delle operazioni and. [CreateDashboard[UpdateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateDashboard.html)](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html)

`displaySettings`  
Le impostazioni dello schermo con i seguenti parametri:  
+ `numRows`— Numero di righe nel layout della dashboard. Ogni riga ha la larghezza di **CellSize**.
+ `numColumbs`— Numero di colonne nel layout del pannello di controllo. Ogni colonna ha una larghezza di **CellSize**.
+ `cellSize`— (Facoltativo) La dimensione di una cella nel layout in pixel. Deve essere un numero positivo. L'impostazione predefinita è 10.
+ `significantDigits`— (Facoltativo) Numero di cifre significative da visualizzare nella dashboard. L'impostazione predefinita è 4.

`querySettings`  
Le informazioni sulla query con il seguente parametro:  
+ `refreshRate`— (Facoltativo) La velocità con cui i dati si aggiornano, in millisecondi. Accetta i seguenti valori: 1000, 5000, 10000, 60000, 300000.

`defaultViewport`  
Se non viene fornito, il valore predefinito è quello degli ultimi cinque minuti. Contiene i seguenti parametri:  
+ `duration`— (Facoltativo) Determina a che punto del passato interrogare i dati a partire dal tempo presente.
+ `start`— (Facoltativo) È di tipo Date. L'intervallo di tempo di inizio dell'interrogazione dei dati. Richiede una `end` data specificata.
+ `end`— (Facoltativo) È di tipo Data. L'intervallo di tempo di fine dell'interrogazione dei dati. Richiede una `start` data specificata.

`widgets`  
Un elenco di strutture di definizione dei widget che contengono le seguenti informazioni:    
`type`  
Il tipo di widget. AWS IoT SiteWise fornisce i seguenti tipi di widget:  
+ <a name="xy-plot"></a>`xy-plot`— Un grafico a linee o un grafico a dispersione a seconda della configurazione. 
+ <a name="bar-chart"></a>`bar-chart`— Un grafico a barre. 
+ <a name="kpi-chart"></a>`kpi-chart`— Un grafico degli indicatori chiave delle prestazioni. 
+ <a name="status-timeline"></a>`status-timeline`— Un widget di stato che visualizza e naviga tra i dati delle serie temporali provenienti da una o più fonti di dati. 
+ <a name="text-widget"></a>`text`— Un widget di testo. 
+ <a name="table-widget"></a>`table`— Un widget da tabella.   
`id`  
Un identificatore univoco per il widget.  
`x`  
La posizione orizzontale del widget, a partire dalla sinistra della dashboard. Questo valore si riferisce alla posizione del widget nella griglia del pannello di controllo.  
`y`  
La posizione verticale del widget, a partire dalla parte superiore della dashboard. Questo valore si riferisce alla posizione del widget nella griglia del pannello di controllo.  
`z`  
L'ordine relativo dei widget. Un widget con valore Z più grande viene visualizzato davanti al widget con valore Z inferiore, se si sovrappongono.  
`width`  
La larghezza del widget, espressa in numero di celle sulla dashboard.  
`height`  
L'altezza del widget, espressa in numero di celle sulla dashboard.  
`properties`  
Un elenco di proprietà del widget. Varia in base al tipo di widget. Vedi [IoT App Kit](https://awslabs.github.io/iot-app-kit/?path=/docs/components-statustimeline--docs) per i dettagli.

**Example Esempio di definizione del pannello di controllo**  
L'esempio seguente definisce un pannello di controllo da un payload archiviato in un file JSON.  

```
aws iotsitewise create-dashboard \
  --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
  --dashboard-name "Example Dashboard" \
  --dashboard-definition file://dashboard-definition.json
```
L’esempio JSON seguente per `dashboard-definition.json` definisce il pannello di controllo con i seguenti widget di visualizzazione:  

```
{
    "displaySettings": {
        "numColumns": 200,
        "numRows": 1000,
        "cellSize": 20,
        "significantDigits": 4
    },
    "widgets": [{
        "id": "Ot73JcxUoc6oEXAMPLE",
        "type": "xy-plot",
        "width": 33,
        "height": 20,
        "x": 0,
        "y": 0,
        "z": 0,
        "properties": {
            "aggregationType": "AVERAGE",
            "queryConfig": {
                "source": "iotsitewise",
                "query": {
                    "assets": [{
                        "assetId": "97c97abf-e883-47bb-a3f4-EXAMPLE",
                        "properties": [{
                            "propertyId": "97cc61f4-57a4-4c5f-a82c-EXAMPLE",
                            "refId": "692ce941-f3d9-4074-a297-EXAMPLE",
                            "aggregationType": "AVERAGE",
                            "color": "#7d2105",
                            "resolution": "1m"
                        }]
                    }],
                    "properties": [],
                    "assetModels": [],
                    "alarms": [],
                    "alarmModels": []
                }
            },
            "line": {
                "connectionStyle": "linear",
                "style": "solid"
            },
            "symbol": {
                "style": "filled-circle"
            },
            "axis": {
                "yVisible": true,
                "xVisible": true
            },
            "legend": {
                "visible": true,
                "position": "right",
                "width": "30%",
                "height": "30%",
                "visibleContent": {
                    "unit": true,
                    "asset": true,
                    "latestValue": true,
                    "latestAlarmStateValue": true,
                    "maxValue": false,
                    "minValue": false
                }
            }
        }
    }, {
        "id": "fto7rF40Ny1EXAMPLE-G",
        "type": "bar-chart",
        "width": 33,
        "height": 20,
        "x": 0,
        "y": 20,
        "z": 0,
        "properties": {
            "aggregationType": "AVERAGE",
            "queryConfig": {
                "source": "iotsitewise",
                "query": {
                    "assets": [{
                        "assetId": "97c97abf-e883-47bb-a3f4-EXAMPLE",
                        "properties": [{
                            "propertyId": "c84ca8f3-3dea-478a-afec-EXAMPLE",
                            "aggregationType": "AVERAGE",
                            "refId": "2960b958-2034-4d6e-bcc2-EXAMPLE"
                        }]
                    }],
                    "properties": [],
                    "assetModels": [],
                    "alarms": [],
                    "alarmModels": [],
                    "requestSettings": {
                        "aggregation": "AVERAGE"
                    }
                }
            },
            "axis": {
                "showX": true,
                "showY": true
            },
            "styleSettings": {
                "2960b958-2034-4d6e-bcc2-360f1f02e505": {
                    "color": "#7d2105"
                }
            }
        }
    }],
    "querySettings": {
        "refreshRate": 5000
    }
}
```