Configurare e testare l'integrazione Aveva Connect

Prerequisiti

• Server di integrazione distribuito e registrato sulla piattaforma

• Accesso ad Aveva Connect Data Services

Tipi di query supportati

• Ottenere l’ultimo valore da uno o più SDS Stream

Funzionalità supportate

• Supporto automatico delle UoM

Passaggi di configurazione

Questa guida descrive come configurare l’integrazione Aveva Connect per recuperare dati in un RealityAsset.

I passaggi principali per configurare l’integrazione Aveva Connect sono i seguenti:

1. Ottenere un token di autenticazione client da Aveva Connect

2. Registrare l’origine dati Aveva Connect su RealityPlatform

3. Collegare l’integrazione a un Tipo di asset

4. Inviare una query di prova per verificare la connessione a Connect

Ottenere un token di autenticazione client da Aveva Connect

1. Accedi ad Aveva Connect e naviga in Aveva Data Services

2. Naviga in Security → Clients e fai clic sul pulsante Add Client in alto a destra

3. Seleziona i permessi appropriati e genera un token client. L’integrazione avrà bisogno almeno dell’accesso in lettura agli stream a cui accederà.

Registrare l’origine dati Aveva Connect sul Server di integrazione

1. Aggiungi la nuova origine dati

2. Seleziona il tipo AVEVA_CONNECT

3. Compila i parametri richiesti per stabilire la connessione

Parametri dell’origine dati Aveva Connect

{
  "baseUrl": "https://example.avevaconnect.com",
  "namespaceId": "exampleNamespaceId",
  "tenantId": "exampleTenantId",
  "communityId": "exampleCommunityId",
  "clientId": "exampleClientId",
  "clientSecret": "exampleClientSecret"
}

baseUrl

L’URL di base del servizio Aveva Connect.

nameSpaceId

L’ID del namespace del servizio Aveva Connect.

tenantId

Il tenantId del servizio Aveva Connect.

CommunityId (Opzionale)

L’id della community che ospita i dati, se applicabile.

clientId

L’Id del client assegnato all’installazione dell’integration service.

clientSecret

Il client secret assegnato all’installazione dell’integration service.

Collegare le proprietà del Tipo di asset ad Aveva Connect

Prima di collegare, assicurati di avere:

• Un Tipo di asset esistente con una proprietà che contenga i valori dei parametri Aveva Connect richiesti (ad es. Stream Ids). Deve essere di tipo proprietà “Testo breve”.

• Un Server di integrazione configurato con un’origine dati Aveva Connect e delle query.

Per collegare una proprietà di un Tipo di asset ad Aveva Connect:

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 Aveva Connect.

4. Scegli l’origine dati e la query Aveva Connect appropriate.

5. Per ogni parametro richiesto (ad es. StreamId), seleziona la proprietà del Tipo di asset che dovrebbe fornirne il valore (ad es. Stream Ids).

   

6. 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 Aveva Connect durante l’esecuzione dell’integrazione.

Inviare una query di prova per verificare la connettività tra RealityPlatform e Aveva Connect

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

2. Inserisci uno o più stream ID, separati da virgole, nella configurazione dei Parametri e fai clic su Test query per vedere il risultato. Gli stream Id possono essere ottenuti direttamente da Aveva Connect.

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. Stream Ids) viene compilata. Usa qualsiasi stream ID valido di Aveva Connect per verificare la connettività.