配置并测试 Aveva Connect 集成

前提条件

• 集成服务器已部署并在平台上注册

• 对 Aveva Connect Data Services 的访问权限

支持的查询类型

• 从一个或多个 SDS Stream 获取最新值

支持的功能

• 自动 UoM 支持

配置步骤

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

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

1. 从 Aveva Connect 获取客户端身份验证令牌

2. 在 RealityPlatform 上注册 Aveva Connect 数据源

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

4. 发送测试查询以验证与 Connect 的连接

从 Aveva Connect 获取客户端身份验证令牌

1. 登录 Aveva Connect 并导航到 Aveva Data Services

2. 导航到 Security → Clients 并点击右上角的 Add Client 按钮

3. 选择适当的权限并生成客户端令牌。集成将至少需要对将访问的流的读取权限。

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

1. 添加新数据源

2. 选择 AVEVA_CONNECT 类型

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

AVEVA Connect 数据源参数

{
  "baseUrl": "https://example.avevaconnect.com",
  "namespaceId": "exampleNamespaceId",
  "tenantId": "exampleTenantId",
  "communityId": "exampleCommunityId",
  "clientId": "exampleClientId",
  "clientSecret": "exampleClientSecret"
}

baseUrl

Aveva Connect 服务的基础 URL。

nameSpaceId

Aveva Connect 服务的命名空间 ID。

tenantId

Aveva Connect 服务的 tenantId。

CommunityId（可选）

托管数据的社区的 id（如适用）。

clientId

分配给集成服务安装的客户端的 Id。

clientSecret

分配给集成服务安装的客户端密钥。

将资产类型属性链接到 Aveva Connect

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

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

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

要将资产类型属性链接到 Aveva Connect：

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

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

   

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

4. 选择适当的 Aveva Connect 数据源和查询。

5. 对于每个所需参数（例如 StreamId），选择应提供其值的资产类型属性（例如 Stream Ids）。

   

6. 点击 Save 以创建链接。

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

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

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

2. 在 Parameters 配置下输入一个或多个以逗号分隔的流 ID，然后点击 Test query 查看结果。流 ID 可以直接从 Aveva Connect 获取。

注意

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