Configurare e testare l'integrazione Aveva PI Web API

Prerequisiti

• Server di integrazione distribuito e registrato sulla piattaforma in grado di connettersi alla PI Web API

• PI System con PI AF (se si recuperano asset) con PI Web API installata e configurata

Tipi di query supportati

• Ottenere l’ultimo valore da uno o più PI Point

• Ottenere il valore attuale delle proprietà di un PI AF Asset

Funzionalità supportate

• Supporto automatico delle UoM

• Filtraggio delle proprietà PI AF per categorie. È possibile specificare più categorie in un singolo parametro separandole con virgole.

Passaggi di configurazione

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

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

1. Registrare l’origine dati Aveva PI su RealityPlatform

2. Collegare l’integrazione a un Tipo di asset

3. Inviare una query di prova per verificare la connessione a PI

Registrare l’origine dati Aveva PI sul Server di integrazione

1. Aggiungi la nuova origine dati

2. Seleziona il tipo Aveva_PI_WEB_API

3. Compila i parametri richiesti per stabilire la connessione

Parametri dell’origine dati Aveva PI Web API

{
  "baseUrl": "https://example.avevapiwebapi.com",
  "authenticationMethod": "Basic",
  "ignoreSslCertificateErrors": false,
  "username": "johnDoe",
  "password": "password"
}

baseUrl

L’URL di base della PI Web API.

username (Opzionale)

Nome utente per l’autenticazione di base

password (Opzionale)

Password per l’autenticazione di base

authenticationMethod

Il metodo di autenticazione che verrà usato per autenticarsi con la PI Web API.

Valori possibili

• disable

• basic

Collegare le proprietà del Tipo di asset ad Aveva PI WEB API

Prima di collegare, assicurati di avere:

• Un Tipo di asset esistente con una proprietà che contenga i valori dei parametri Aveva PI WEB API richiesti (ad es. PI AF Path). Deve essere di tipo proprietà “Testo breve”.

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

Per collegare una proprietà di un Tipo di asset ad Aveva PI WEB API:

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 PI WEB API.

4. Scegli l’origine dati appropriata

5. Scegli la query desiderata**:**

   -Get PI AF asset properties
   Recupera gli attributi di un PI AF asset e i loro valori più recenti.

   Parametri:

   • PiAssetPath

   • CategoryName (Opzionale)

   -Get PI Points values
   Recupera il valore più recente di un PI Point specificato.

   Parametri:

   • WebID

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

   

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

Inviare una query di prova per verificare la connettività tra RealityPlatform e Aveva PI WEB API

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 PI WEB API. Questo aprirà il menu della query di prova.

2. Inserisci un PI AF Asset Path (o un PI Point path, a seconda della query selezionata) nella configurazione dei Parametri e fai clic su Test query per vedere il risultato. L’integrazione usa il formato di percorso PI standard e possono essere trovati direttamente in PI System Explorer o PI System Management Tools.

Nota

• CategoryName è opzionale, è possibile specificare più categorie in un singolo parametro separandole con virgole.

• 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. PI AF Path) viene compilata. Usa qualsiasi PI AF Path o PI Point valido di Aveva PI per verificare la connettività.