Configurare e testare l'integrazione AWS SiteWise

Prerequisiti

• Server di integrazione distribuito e registrato sulla piattaforma

• AWS SiteWise configurato

• Un profilo IAM configurato sulla macchina client o direttamente sul Server di integrazione con i permessi richiesti per accedere ad AWS SiteWise.

Tipi di query supportati

• Ottenere i valori attuali delle proprietà di un asset AWS SiteWise

Funzionalità supportate

• Supporto automatico delle UoM

Passaggi di configurazione

Questa guida descrive come configurare l’integrazione AWS SiteWise per recuperare dati in un RealityAsset. Questa guida presuppone che un profilo IAM con i permessi corretti sia già disponibile.

I passaggi principali per configurare l’integrazione AWS SiteWise sono i seguenti:

1. Registrare l’origine dati AWS SiteWise su RealityPlatform

2. Collegare l’integrazione a un Tipo di asset

3. Inviare una query di prova per verificare la connessione ad AWS

Registrare l’origine dati AWS SiteWise sul Server di integrazione

1. Aggiungi la nuova origine dati

2. Seleziona il tipo AWS_IOT_SITEWISE

3. Compila i parametri richiesti per stabilire la connessione

Parametri dell’origine dati AWS IoT SiteWise

{
  "profile": "exampleProfile",
  "region": "us-west-2"
}

profile (opzionale)

Il profilo IAM che verrà usato per autenticarsi con AWS IoT SiteWise. Se non ne viene selezionato nessuno, verrà usato il profilo predefinito.

region (opzionale)

Il nome della regione AWS a cui l’integrazione si connetterà.

Valori possibili

L’elenco delle regioni supportate è disponibile qui.

Collegare le proprietà del Tipo di asset ad AWS IOT SiteWise

Prima di collegare, assicurati di avere:

• Un Tipo di asset esistente con una proprietà che contenga i valori dei parametri AWS IOT SiteWise richiesti (ad es. Asset ID). Deve essere di tipo proprietà “Testo breve”.

• Un Server di integrazione configurato con un’origine dati AWS IOT SiteWise e delle query.

Per collegare una proprietà di un Tipo di asset ad AWS IOT SiteWise:

1. In Impostazioni asset → Tipi di asset, apri il Tipo di asset che vuoi collegare.

2. Nel pannello Collegamenti di integrazione (lato destro), fai clic su Crea collegamento di integrazione.

   

3. Inserisci un nome per il collegamento e seleziona il Server di integrazione configurato per AWS IOT SiteWise.

4. Scegli l’origine dati appropriata

5. Scegli la query desiderata**:**
   -Get AWS SiteWise Asset attributes values
   Recupera gli attributi dell’asset.

   Parametri:

   • AssetId

6. Per ogni parametro richiesto (ad es. AssetId), seleziona la proprietà del Tipo di asset che dovrebbe fornirne il valore (ad es. Asset ID).

   

7. Fai clic su Salva per creare il collegamento.

Quando questo Tipo di asset viene assegnato agli asset, i valori delle proprietà collegate verranno automaticamente passati ad AWS SiteWise durante l’esecuzione dell’integrazione.

Inviare una query di prova per verificare la connettività tra RealityPlatform e AWS IOT SiteWise

1. Nella pagina Impostazioni del Tipo di asset, fai clic sul pulsante di riproduzione accanto al collegamento di integrazione che punta all’origine dati AWS IOT SiteWise. Questo aprirà il menu della query di prova.

2. Inserisci un Asset ID nella configurazione dei Parametri e fai clic su Test query per vedere il risultato. L’asset id può essere ottenuto direttamente da AWS SiteWise.

Nota

• I valori inseriti qui sono solo a scopo di test. Non vengono salvati nel Tipo di asset né negli asset collegati. Questo test simula ciò che farà RealityTwin quando un asset viene creato, gli viene assegnato questo Tipo di asset e la proprietà corrispondente (ad es. Asset ID) viene compilata. Usa qualsiasi Asset ID valido per verificare la connettività.