Aveva PI Web API 연동 구성 및 테스트

사전 요구 사항

• PI Web API에 연결할 수 있는, 플랫폼에 배포되고 등록된 Integration Server

• PI Web API가 설치되고 구성된 PI AF가 있는 PI System(에셋을 검색하는 경우)

지원되는 쿼리 유형

• 하나 이상의 PI Point에서 마지막 값 가져오기

• PI AF Asset 속성의 현재 값 가져오기

지원되는 기능

• 자동 UoM 지원

• 카테고리별로 PI AF 속성 필터링. 쉼표로 구분하여 단일 매개변수에 여러 카테고리를 지정할 수 있습니다.

구성 단계

이 가이드는 RealityAsset에서 데이터를 검색하기 위해 Aveva PI 연동을 구성하는 방법을 설명합니다.

Aveva PI 연동을 구성하기 위한 주요 단계는 다음과 같습니다:

1. RealityPlatform에 Aveva PI 데이터 소스 등록

2. 연동을 Asset Type에 연결

3. PI에 대한 연결을 검증하기 위해 테스트 쿼리 전송

Integration Server에 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

Asset Type 속성을 Aveva PI WEB API에 연결

연결하기 전에, 다음을 갖추었는지 확인하세요:

• 필수 Aveva PI WEB API 매개변수 값(예: PI AF Path)을 담을 속성이 있는 기존 Asset Type. 이는 “Short text” 속성 유형이어야 합니다.

• Aveva PI WEB API 데이터 소스와 쿼리로 구성된 Integration Server.

Asset Type 속성을 Aveva PI WEB API에 연결하려면:

1. Asset Settings → Asset Types에서, 연결하려는 Asset Type을 엽니다.

2. Integration Links 패널(오른쪽)에서, Create Integration Link를 클릭합니다.

   

3. 링크 이름을 입력하고 Aveva PI WEB API용으로 구성된 Integration Server를 선택합니다.

4. 적절한 데이터 소스를 선택합니다

5. 원하는 쿼리를 선택합니다:

   -Get PI AF asset properties
   PI AF 에셋의 속성과 최신 값을 검색합니다.

   매개변수:

   • PiAssetPath

   • CategoryName (선택 사항)

   -Get PI Points values
   지정된 PI Point의 최신 값을 검색합니다.

   매개변수:

   • WebID

6. 각 필수 매개변수(예: PIAssetPath)에 대해, 그 값을 제공할 Asset Type 속성(예: PI Asset Path)을 선택합니다.

   

7. Save를 클릭하여 링크를 만듭니다.

이 Asset Type이 에셋에 할당되면, 연동을 실행할 때 연결된 속성 값이 자동으로 Aveva Connect에 전달됩니다.

RealityPlatform과 Aveva PI WEB API 간의 연결을 검증하기 위해 테스트 쿼리 전송

1. Asset Type Settings 페이지에서, Aveva PI WEB API 데이터 소스를 대상으로 하는 연동 링크 옆의 재생 버튼을 클릭합니다. 그러면 테스트 쿼리 메뉴가 열립니다.

2. Parameters 구성 아래에 PI AF Asset Path(또는 선택한 쿼리에 따라 PI Point 경로)를 입력하고 Test query를 클릭하여 결과를 확인합니다. 연동은 표준 PI 경로 형식을 사용하며 PI System Explorer나 PI System Management Tools에서 직접 찾을 수 있습니다.

참고

• CategoryName은 선택 사항이며, 쉼표로 구분하여 단일 매개변수에 여러 카테고리를 지정할 수 있습니다.

• 여기에 입력된 값은 테스트 목적으로만 사용됩니다. Asset Type이나 연결된 에셋에 저장되지 않습니다. 이 테스트는 에셋이 생성되고, 이 Asset Type이 할당되고, 해당 속성(예: PI AF Path)이 채워질 때 RealityTwin이 수행할 작업을 시뮬레이션합니다. Aveva PI의 유효한 PI AF Path나 PI Point를 사용하여 연결을 검증하세요.