Konfigurieren und testen Sie die Aveva PI Web API Integration

Voraussetzungen

• Integration Server, der auf der Plattform implementiert und registriert ist, die eine Verbindung zur PI Web API herstellen kann

• PI System mit PI AF (beim Abrufen von Assets) mit installierter und konfigurierter PI Web API

Unterstützte Abfragetypen

• Holen Sie sich den letzten Wert aus einem oder mehreren PI Points

• Abrufen des aktuellen Werts einer PI AF Asset-Eigenschaft

Unterstützte Funktionen

• Automatische ME-Unterstützung

• Filtern Sie PI AF-Eigenschaften nach Kategorien. Mehrere Kategorien können in einem einzigen Parameter angegeben werden, indem sie durch Kommas getrennt werden.

Schritte zur Konfiguration

In dieser Anleitung wird beschrieben, wie Sie die Aveva PI-Integration konfigurieren, um Daten in einem RealityAsset abzurufen.

Die wichtigsten Schritte zur Konfiguration der Aveva PI-Integration sind die folgenden:

1. Registrieren Sie die Aveva PI-Datenquelle auf RealityPlatform

2. Verknüpfen Sie die Integration mit einem Asset-Typ

3. Senden einer Testabfrage, um die Verbindung mit PI zu validieren

Registrieren Sie die Aveva PI-Datenquelle auf dem Integration Server

1. Fügen Sie das Symbol new data source

2. Wählen Sie den Aveva_PI_WEB_API Typ aus

3. Füllen Sie die erforderlichen parameters Felder aus, um die Verbindung herzustellen

Parameter der Aveva PI Web API Datenquelle

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

baseUrl

Die Basis-URL der Pi Web API.

Benutzername (optional)

Benutzername für die Basisauthentifizierung

Passwort (optional)

Passwort für die Basisauthentifizierung

authenticationMethod

Die Authentifizierungsmethode, die für die Authentifizierung bei der PI-Web-API verwendet wird.

Mögliche Werte

• abschalten

• grundlegend

Verknüpfen von Asset-Typ-Eigenschaften mit der Aveva PI WEB API

Stellen Sie vor dem Verknüpfen sicher, dass Sie über Folgendes verfügen:

• Ein vorhandenes Asset Type Element mit einer Eigenschaft, die die erforderlichen Aveva PI WEB API-Parameterwerte enthält (z. B. PI AF Path). Es muss sich um den Eigenschaftstyp “Kurztext” handeln.

• Ein Integrationsserver , der mit einer Aveva PI WEB API-Datenquelle und Abfragen konfiguriert ist.

So verknüpfen Sie eine Asset Type-Eigenschaft mit der Aveva PI WEB API:

1. Öffnen Sie unter Asset-Einstellungen → Asset-Typen den Asset-Typ, den Sie verknüpfen möchten.

2. Klicken Sie im Bereich Integrationsverknüpfungen (rechte Seite) auf Integrationsverknüpfung erstellen.

   

3. Geben Sie einen Linknamen ein und wählen Sie den Integrationsserver aus, der für die Aveva PI WEB API konfiguriert ist.

4. Auswählen der geeigneten Datenquelle

5. Wählen Sie die gewünschte Abfrage aus:

   -Abrufen von PI AF-Asset-Eigenschaften
   Ruft die Attribute eines PI AF-Assets und deren neueste Werte ab.

   Parameter:

   • PiAssetPath

   • CategoryName (optional)

   -Abrufen von PI Points-Werten
   Ruft den neuesten Wert eines angegebenen PI Point ab.

   Parameter:

   • WebID

6. Wählen Sie für jeden erforderlichen Parameter (z. B. PIAssetPath) die Eigenschaft Asset-Typ aus, die ihren Wert angeben soll (z. B PI Asset Path. ).

   

7. Klicken Sie auf Speichern , um den Link zu erstellen.

Wenn dieser Asset-Typ Assets zugewiesen wird, werden die verknüpften Eigenschaftswerte automatisch an Aveva Connect übergeben, wenn die Integration ausgeführt wird.

Senden einer Testabfrage zur Validierung der Konnektivität zwischen RealityPlatform und Aveva PI WEB API

1. Klicken Sie auf der Seite “Asset-Typ-Einstellungen” auf die Schaltfläche “Abspielen” neben dem Integrationslink, der auf die Aveva PI WEB API-Datenquelle abzielt. Dadurch wird das Menü für die Testabfrage geöffnet.

2. Geben Sie unter der Parameterkonfiguration einen PI AF Asset Path (oder einen PI Point-Pfad, je nach ausgewählter Abfrage) ein und klicken Sie auf Abfrage testen, um das Ergebnis zu sehen. Die Integration verwendet das Standard-PI-Pfadformat und ist direkt im PI System Explorer oder in den PI System Management Tools zu finden.

Hinweis

• CategoryName ist optional, mehrere Kategorien können in einem einzigen Parameter angegeben werden, indem sie durch Kommas getrennt werden.

• Die hier eingegebenen Werte dienen nur zu Testzwecken. Sie werden nicht im Asset-Typ oder in verknüpften Assets gespeichert. Dieser Test simuliert, was RealityTwin tun wird, wenn ein Asset erstellt, diesem Asset-Typ zugewiesen wird und die entsprechende Eigenschaft (z. B. PI AF Path) ausgefüllt wird. Verwenden Sie einen gültigen PI AF Path oder PI Point von Aveva PI, um die Konnektivität zu validieren.