Aveva PI Web API 統合の設定とテスト

  • 公開日 Sep 5, 2025
  • 1 分で読めます
Prev Next

前提 条件

  • PI Web API に接続できるプラットフォームに展開および登録された統合サーバー

  • 円周率PI Web API をインストールして構成した PI AF を備えたシステム (アセットを取得する場合)

サポートされているクエリの種類

  • 1つまたは複数の PI ポイントから最後の値を取得

  • PI AF アセットの現在の値を取得するプロパティ

サポートされている機能

  • 自動 単位 のサポート

  • PI AF プロパティをカテゴリでフィルタリングします。複数のカテゴリは、カンマで区切ることで 1 つのパラメーターで指定できます。

構成手順

このガイドでは、RealityAsset内のデータを取得するためにAveva PI 統合を設定する方法について説明します。

Aveva PI 統合を構成するための主な手順は次のとおりです。

  1. RealityPlatform に Aveva PI データソースを登録する

  2. 統合をアセットタイプにリンクする

  3. PI への接続を検証するためにテストクエリを送信します

Aveva PI データソースを統合サーバーに登録する

  1. 追加 new data source

  2. Aveva_PI_WEB_APIタイプを選択します

  3. 接続を確立するために必要な parameters を入力します

Aveva PI Web API データソースのパラメーター

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

ベース URL

Pi Web API のベース URL。

username (オプション)

基本認証のユーザー名

パスワード (オプション)

基本認証のパスワード

認証メソッド

PI Web API に対する認証に使用される認証方法。

可能な値

  • 無効にする

  • 基本的な

アセットタイプのプロパティを Aveva PI WEB API にリンクする

リンクする前に、次のものがあることを確認してください。

  • 必要な Aveva PI WEB API パラメーター値 (PI AF Path など) を保持するプロパティを持つ既存のAsset Type。「短いテキスト」プロパティタイプである必要があります。

  • Aveva PI WEB API データソースとクエリで構成された 統合サーバー 。

アセットタイププロパティをAveva PI WEB API にリンクするには:

  1. [アセット設定] → [アセット タイプ] で、リンクするアセット タイプを開きます。

  2. [ 統合リンク] パネル (右側) で、[ 統合リンクの作成] をクリックします。

  3. リンク名を入力し、Aveva PI WEB API 用に構成された統合サーバーを選択します。

  4. 適切なデータソースを選択する

  5. 目的のクエリを選択します 。

    -PI AFアセットプロパティを取得する
    PI AF アセットの属性とその最新の値を取得します。

    パラメーター：

    • PiAssetパス

    • CategoryName (オプション)

    -PIポイント値を取得する
    指定したPIポイントの最新の値を読み込みます。

    パラメーター：

    • WebID

  6. 必要なパラメータ ( PIAssetPath など) ごとに、その値を指定する [アセット タイプ] プロパティ ( PI Asset Path など) を選択します。

  7. [保存] をクリックしてリンクを作成します。

このアセットタイプがアセットに割り当てられると、統合の実行時にリンクされたプロパティ値が自動的にAveva Connectに渡されます。

image-20250516-161704.png

テストクエリを送信して、RealityPlatform と Aveva PI WEB API 間の接続を検証します。

  1. [アセットタイプの設定] ページで、Aveva PI WEB API データソースを対象とする統合リンクの横にある再生ボタンをクリックします。これにより、テストクエリメニューが開きます。

image-20250516-161820.png

  1. [パラメータ] 設定の下に [PI AF アセット パス] (選択したクエリに応じて PI ポイント パス) を入力し、[クエリのテスト] をクリックして結果を確認します。統合では標準の PI パス形式が使用され、 PI System Explorer または PI System Management Tools で直接見つけることができます。

手記

  • CategoryName はオプションで、複数のカテゴリをカンマで区切ることで 1 つのパラメーターで指定できます。

  • ここに入力された値は 、テストのみを目的としています。これらは、資産タイプまたはリンクされた資産には保存されません。このテストでは、アセットが作成され、このアセットタイプが割り当てられ、対応するプロパティ( PI AF Pathなど)が入力されたときにRealityTwinが何をするかをシミュレートします。Aveva PIの有効なPI AFパスまたはPIポイントを使用して、接続を検証します。

image-20250516-162050.png