Mappa i flussi di dati industriali sulle proprietà degli asset - AWS IoT SiteWise
Impostare un alias di proprietà (console)Imposta un alias di proprietà ()AWS CLI

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

Mappa i flussi di dati industriali sulle proprietà degli asset

È possibile definire un alias di proprietà sulla proprietà dell'asset. Questo vi aiuta a identificare la proprietà di un asset quando inserite o recuperate i dati di un asset. Se la risorsa ha proprietà di misurazione, è possibile definire gli alias delle proprietà per mappare i flussi di dati a tali proprietà di misurazione.

Questo processo richiede la conoscenza dell'alias della proprietà.

  • Se si importano dati da server OPC UA utilizzando un'origine dati OPC UA in un gateway SiteWise Edge, l'alias di proprietà è il percorso di una variabile nel nodo Oggetti, a partire da. /

    Esempio

    Se il percorso della variabile ècompany/windfarm/3/turbine/7/temperature, allora l'alias della proprietà è. /company/windfarm/3/turbine/7/temperature

    Per ulteriori informazioni sull'architettura delle informazioni OPC UA, vedere Information Model and Address Spacing mapping in OPCUA Online Reference.

    Note

    • Se configuri un prefisso di flusso di dati per la tua fonte OPC UA, devi includere quel prefisso nell'alias di proprietà per tutti i flussi di dati provenienti da quella fonte.

      Esempio

      Se /RentonWA è un prefisso, l'alias precedente è. /RentonWA/company/windfarm/3/turbine/7/temperature

    • Gli alias di proprietà possono contenere fino a 1.000 byte. OPCI percorsi delle variabili UA possono contenere fino a 4.096 byte. Attualmente, AWS IoT SiteWise non supporta l'acquisizione di dati da variabili OPC UA con percorsi lunghi.

  • Se si importano dati da server Modbus utilizzando un'origine TCP dati Modbus in un gateway SiteWise Edge, l'alias della proprietà è:

    Modbus register set tag name

    Utilizzate questo valore per inviare dati da questo set di registri a una proprietà dell'asset.

  • Se importate dati da altre fonti, ad esempio utilizzando AWS IoT regole o il API, dovete definire gli alias delle proprietà. È possibile definire un sistema di denominazione degli alias di proprietà applicabile alla configurazione del dispositivo. Ad esempio, se si inseriscono dati da oggetti AWS IoT , è possibile includere il nome dell'oggetto negli alias di proprietà per identificare in modo univoco i flussi di dati. Per ulteriori informazioni su questo esempio, consulta il tutorial Ingesting data from things. AWS IoT

Gli alias di proprietà devono essere univoci all'interno di una regione e di un account. AWS AWS IoT SiteWise restituisce un errore se si imposta un alias di proprietà su uno che esiste già su un'altra proprietà dell'asset.

Se disponi di più fonti OPC UA con percorsi di flusso di dati identici, aggiungi un prefisso ai percorsi di ciascuna fonte per formare alias unici. Per ulteriori informazioni, consulta OPCFonti di dati UA.

Nota

Questa sezione descrive come impostare gli alias di proprietà per le proprietà di misurazione. Per ulteriori informazioni su come impostare gli alias di proprietà per le proprietà degli stati di allarme esterni, vedere. Mappa i flussi di stato di allarme esterni

Impostare un alias di proprietà (console)

È possibile utilizzare la AWS IoT SiteWise console per impostare un alias per una proprietà della risorsa.

Per impostare un alias di proprietà (console)

  1. Passare alla console AWS IoT SiteWise.

  2. Nel riquadro di navigazione, scegli Asset.

  3. Scegli l'asset per cui vuoi impostare un alias di proprietà.

    Suggerimento

    Puoi scegliere l'icona a forma di freccia per espandere una gerarchia di asset e trovare il tuo asset.

  4. Scegli Modifica.

  5. Individua la proprietà per cui vuoi impostare un alias e quindi immetti l'alias di proprietà.

    AWS IoT SiteWise Schermata della pagina «Modifica risorsa» con un alias di proprietà evidenziato.

  6. Seleziona Salva.

Imposta un alias di proprietà ()AWS CLI

Utilizzate il AWS Command Line Interface (AWS CLI) per impostare un alias per una proprietà dell'asset.

Per completare questa procedura, è necessario conoscere l'elemento assetId dell'asset e l'elemento propertyId della proprietà. Puoi anche usare l'ID esterno. Se avete creato una risorsa e non la conosceteassetId, utilizzate il ListAssetsAPIper elencare tutte le risorse per un modello specifico. Utilizzate l'DescribeAssetoperazione per visualizzare le proprietà della risorsa, inclusa la proprietàIDs.

Utilizzate l'UpdateAssetPropertyoperazione per mappare un flusso di dati alla proprietà della risorsa. Specifica i seguenti parametri:

  • assetId— L'ID o l'ID esterno della risorsa. Per ulteriori informazioni, consulta Oggetti di riferimento con oggetti esterni IDs nella Guida per l'utente di AWS IoT SiteWise .

  • propertyId— L'ID o l'ID esterno della proprietà della risorsa.

  • propertyAlias— Il percorso del flusso di dati verso l'alias della proprietà.

  • propertyNotificationState— Lo stato di notifica del valore della proprietà: ENABLED oDISABLED. Specifica lo stato di notifica esistente della proprietà quando aggiorni l'alias della proprietà. È possibile recuperare lo stato di notifica esistente con l'DescribeAssetPropertyoperazione.

    Se ometti questo parametro, il nuovo stato di notifica è DISABLED. Per ulteriori informazioni sulle notifiche delle proprietà, consulta Interagisci con altri AWS servizi.

Per impostare un alias di proprietà ()AWS CLI

  1. Esegui il comando seguente per recuperare lo stato di notifica corrente della proprietà. Replace (Sostituisci) asset-id e property-id con la proprietà della risorsa. IDs

    aws iotsitewise describe-asset-property \
  --asset-id asset-id \
  --property-id property-id

    L'operazione restituisce una risposta contenente i dettagli della proprietà di asset nel formato seguente. Lo stato di notifica della proprietà si trova assetProperty.notification.state nell'JSONoggetto.

    {
  "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
  "assetName": "Wind Turbine 7",
  "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
  "assetProperty": {
    "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
    "name": "Wind Speed",
    "notification": {
      "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "state": "ENABLED"
    },
    "dataType": "DOUBLE",
    "unit": "m/s",
    "type": {
      "measurement": {}
    }
  }
}

  2. Esegui il comando seguente per impostare l'alias della proprietà di asset. Replace (Sostituisci) property-alias con l'alias della proprietà e notification-state con lo stato di notifica o ometti --property-notification-state per disabilitare le notifiche. Facoltativamente, puoi aggiornare l'unità dell'asset con una nuova unit e. --property-unit

    aws iotsitewise update-asset-property \
  --asset-id asset-id \
  --property-id property-id \
  --property-alias property-alias \
  --property-notification-state notification-state \
  --property-unit unit

  3. Per verificare che l'alias sia stato impostato, esegui il comando seguente per recuperare i dettagli della proprietà. Replace (Sostituisci) asset-id e property-id con la proprietà della risorsa. IDs

    aws iotsitewise describe-asset-property \
  --asset-id asset-id \
  --property-id property-id

    L'operazione restituisce una risposta contenente i dettagli della proprietà di asset nel formato seguente. L'alias della proprietà si trova assetProperty.alias nell'JSONoggetto ed è impostato su myAlias in questo esempio.

    {
  "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
  "assetName": "Wind Turbine 7",
  "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
  "assetProperty": {
    "alias": "myAlias",
    "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
    "name": "Wind Speed",
    "notification": {
      "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "state": "ENABLED"
    },
    "dataType": "DOUBLE",
    "unit": "m/s",
    "type": {
      "measurement": {}
    }
  }
}