Ga naar inhoud
Prevu3D

De Aveva PI Web API-integratie configureren en testen

Vereisten

Section titled “Vereisten”

  • Integratieserver geïmplementeerd en geregistreerd op het platform die verbinding kan maken met de PI Web API

  • PI System met PI AF (indien assets worden opgehaald) met de PI Web API geïnstalleerd en geconfigureerd

Ondersteunde querytypen

Section titled “Ondersteunde querytypen”

  • De laatste waarde ophalen uit een of meerdere PI Points

  • De huidige waarde ophalen van de eigenschappen van een PI AF Asset

Ondersteunde functies

Section titled “Ondersteunde functies”

  • Automatische UoM-ondersteuning

  • PI AF-eigenschappen filteren op categorieën. Meerdere categorieën kunnen in één parameter worden opgegeven door ze met komma’s te scheiden.

Configuratiestappen

Section titled “Configuratiestappen”

Deze gids beschrijft hoe u de Aveva PI-integratie configureert om gegevens op te halen in een RealityAsset.

De belangrijkste stappen om de Aveva PI-integratie te configureren zijn de volgende:

  1. De Aveva PI-gegevensbron registreren op RealityPlatform

  2. De integratie koppelen aan een assettype

  3. Een testquery verzenden om de verbinding met PI te valideren

De Aveva PI-gegevensbron registreren op de integratieserver

Section titled “De Aveva PI-gegevensbron registreren op de integratieserver”

  1. Voeg de nieuwe gegevensbron toe

  2. Selecteer het type Aveva_PI_WEB_API

  3. Vul de vereiste parameters in om de verbinding tot stand te brengen

Parameters van de Aveva PI Web API-gegevensbron

Section titled “Parameters van de Aveva PI Web API-gegevensbron”
{
  "baseUrl": "https://example.avevapiwebapi.com",
  "authenticationMethod": "Basic",
  "ignoreSslCertificateErrors": false,
  "username": "johnDoe",
  "password": "password"
}

baseUrl

Section titled “baseUrl”

De basis-URL van de PI Web API.

username (optioneel)

Section titled “username (optioneel)”

Gebruikersnaam voor basisverificatie

password (optioneel)

Section titled “password (optioneel)”

Wachtwoord voor basisverificatie

authenticationMethod

Section titled “authenticationMethod”

De verificatiemethode die wordt gebruikt om te authenticeren bij de PI Web API.

Mogelijke waarden
Section titled “Mogelijke waarden”

  • disable

  • basic

Assettype-eigenschappen koppelen aan de Aveva PI WEB API

Section titled “Assettype-eigenschappen koppelen aan de Aveva PI WEB API”

Zorg er vóór het koppelen voor dat u het volgende hebt:

  • Een bestaand assettype met een eigenschap om de vereiste Aveva PI WEB API-parameterwaarden te bevatten (bijv. PI AF Path). Dit moet een eigenschapstype “Korte tekst” zijn.

  • Een integratieserver die is geconfigureerd met een Aveva PI WEB API-gegevensbron en query’s.

Om een assettype-eigenschap aan de Aveva PI WEB API te koppelen:

  1. Open in Assetinstellingen → Assettypen het assettype dat u wilt koppelen.

  2. Klik in het paneel Integratiekoppelingen (rechterkant) op Integratiekoppeling aanmaken.

  3. Voer een koppelingsnaam in en selecteer de integratieserver die voor de Aveva PI WEB API is geconfigureerd.

  4. Kies de juiste gegevensbron

  5. Kies de gewenste query:

    -Get PI AF asset properties
    Haalt de attributen van een PI AF-asset en hun meest recente waarden op.

    Parameters:

    • PiAssetPath

    • CategoryName (optioneel)

    -Get PI Points values
    Haalt de meest recente waarde van een opgegeven PI Point op.

    Parameters:

    • WebID

  6. Selecteer voor elke vereiste parameter (bijv. PIAssetPath) de assettype-eigenschap die de waarde ervan moet leveren (bijv. PI Asset Path).

  7. Klik op Opslaan om de koppeling aan te maken.

Wanneer dit assettype aan assets wordt toegewezen, worden de gekoppelde eigenschapwaarden automatisch doorgegeven aan Aveva Connect bij het uitvoeren van de integratie.

Een testquery verzenden om de connectiviteit tussen RealityPlatform en de Aveva PI WEB API te valideren

Section titled “Een testquery verzenden om de connectiviteit tussen RealityPlatform en de Aveva PI WEB API te valideren”
  1. Klik op de pagina Assettype-instellingen op de afspeelknop naast de integratiekoppeling die de Aveva PI WEB API-gegevensbron target. Dit opent het testquerymenu.

  1. Voer een PI AF Asset Path (of een PI Point-pad, afhankelijk van de geselecteerde query) in onder de parameterconfiguratie en klik op Testquery om het resultaat te zien. De integratie gebruikt het standaard PI-padformaat en deze zijn rechtstreeks terug te vinden in PI System Explorer of PI System Management Tools.