配置并测试 Aveva PI Web API 集成

前提条件

• 集成服务器已部署并在平台上注册，且可连接到 PI Web API

• 带有 PI AF（如果检索资产）的 PI System，并已安装和配置 PI Web API

支持的查询类型

• 从一个或多个 PI Point 获取最新值

• 获取 PI AF 资产属性的当前值

支持的功能

• 自动 UoM 支持

• 按类别筛选 PI AF 属性。可以在单个参数中指定多个类别，以逗号分隔。

配置步骤

本指南将描述如何配置 Aveva PI 集成以在 RealityAsset 中检索数据。

配置 Aveva PI 集成的主要步骤如下：

1. 在 RealityPlatform 上注册 Aveva PI 数据源

2. 将集成链接到资产类型

3. 发送测试查询以验证与 PI 的连接

在集成服务器上注册 Aveva PI 数据源

1. 添加新数据源

2. 选择 Aveva_PI_WEB_API 类型

3. 填写所需的参数以建立连接

AVEVA PI Web API 数据源参数

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

baseUrl

Pi Web API 的基础 URL。

username（可选）

基本身份验证的用户名

password（可选）

基本身份验证的密码

authenticationMethod

将用于对 PI Web API 进行身份验证的身份验证方法。

可能的值

• disable

• basic

将资产类型属性链接到 Aveva PI WEB API

在链接之前，请确保你拥有：

• 一个现有的资产类型，其中有一个属性用于保存所需的 Aveva PI WEB API 参数值（例如 PI AF Path）。它必须是 “Short text” 属性类型。

• 一个配置了 Aveva PI WEB API 数据源和查询的集成服务器。

要将资产类型属性链接到 Aveva PI WEB API：

1. 在资产设置 → 资产类型中，打开你想要链接的资产类型。

2. 在 Integration Links 面板（右侧），点击 Create Integration Link。

   

3. 输入链接名称并选择为 Aveva PI WEB API 配置的集成服务器。

4. 选择适当的数据源

5. 选择所需的查询：

   -Get PI AF asset properties
   检索 PI AF 资产的属性及其最新值。

   参数：

   • PiAssetPath

   • CategoryName （可选）

   -Get PI Points values
   检索指定 PI Point 的最新值。

   参数：

   • WebID

6. 对于每个所需参数（例如 PIAssetPath），选择应提供其值的资产类型属性（例如 PI Asset Path）。

   

7. 点击 Save 以创建链接。

将此资产类型分配给资产后，运行集成时链接的属性值将自动传递给 Aveva Connect。

发送测试查询以验证 RealityPlatform 和 Aveva PI WEB API 之间的连接

1. 在资产类型设置页面上，点击针对 Aveva PI WEB API 数据源的集成链接旁边的播放按钮。这将打开测试查询菜单。

2. 在 Parameters 配置下输入 PI AF Asset Path（或 PI Point path，取决于所选查询），然后点击 Test query 查看结果。集成使用标准 PI 路径格式，它们可以直接在 PI System Explorer 或 PI System Management Tools 中找到。

注意

• CategoryName 是可选的，可以在单个参数中指定多个类别，以逗号分隔。

• 此处输入的值仅用于测试目的。它们不会保存到资产类型或链接的资产。此测试模拟当创建资产、分配此资产类型并填写相应属性（例如 PI AF Path）时 RealityTwin 将执行的操作。使用来自 Aveva PI 的任何有效 PI AF Path 或 PI Point 来验证连接。