Trang chủ › Bài kỹ thuật

Read in English

PI Asset Framework (PI AF): element template, attribute, data reference, PI Analysis Service và event frame

TDL Industrial Automation · Cập nhật lần cuối:

Theo tài liệu AVEVA PI Server 2024 R2: PI AF server và SQL database, element, attribute và cây phân cấp, element template và attribute template, sáu loại data reference, bốn loại analysis (expression, rollup, event frame generation, SQC), lịch event-triggered và periodic, backfilling và recalculation, event frame và cách PI Vision 2025 hiển thị chúng.

PI Asset Framework (PI AF) là mô hình tài sản (asset model) của PI Server: mỗi bơm, mỗi bồn là một element, dữ liệu của nó là các attribute trỏ tới PI point, công thức hay bảng, và template giúp cấu hình một trăm bơm giống nhau chỉ một lần. PI Analysis Service chạy các analysis trên những attribute đó và ghi ra giá trị tính toán hoặc event frame, tức bản ghi một lần dừng máy, một lần vượt ngưỡng hay một mẻ, có thời điểm bắt đầu và kết thúc. Bài này theo tài liệu AVEVA PI Server 2024 R2, bộ tài liệu PI Server mới nhất trên docs.aveva.com, và hướng dẫn sử dụng PI Vision 2025. PI khác AVEVA Historian thế nào: xem bài AVEVA Historian và PI System.

Từ PI point tới event frame: PI AF và PI Analysis ServiceNăm lớp từ trên xuống. Data Archive: PI point chứa dữ liệu time-series từ các interface; output của analysis gán vào attribute PI point cũng được lưu ở đây thành lịch sử. Đọc qua PI point data reference vào PI AF database (SQL Server, qua PI AF Application Service): element template, ví dụ Pump, chứa attribute template và analysis template; mỗi bơm là một element tạo từ template; attribute lấy giá trị qua data reference: PI point, PI point array, Formula, String Builder, Table lookup, URI Builder. PI Analysis Service đọc giá trị attribute, chạy theo lịch periodic hoặc event-triggered: Expression, Rollup, Event frame generation, SQC. Kết quả ghi lại vào PI AF: output attribute, có lịch sử trong PI point, và event frame tạo từ event frame template, tham chiếu element. Client: PI Vision (related events, event details, acknowledge), PI Datalink và PI WebParts, PI OLEDB Enterprise, PI JDBC Driver và PI Web Services cho công cụ báo cáo, PI Notifications Service dựa trên event frame. Theo tài liệu AVEVA PI Server 2024 R2 và PI Vision 2025.Từ PI point tới event frame: PI AF và PI Analysis ServiceData ArchivePI pointPI point chứa dữ liệu time-series từ các interfaceoutput của analysis gán vào attribute PI point cũng lưu ở đâythành lịch sửđọc qua PI point data referencePI AF databaseSQL Server, quaPI AF Application Serviceelement template, ví dụ Pump: attribute templatevà analysis templatemỗi bơm là một element tạo từ templateattribute lấy giá trị qua data reference: PI point, PI point array,Formula, String Builder, Table lookup, URI Builderđọc giá trị attributePI Analysis Servicelịch periodic hoặc event-triggeredExpression · giá trị tính từ biểu thứcRollup · thống kê trên attribute hoặc element conEvent frame generation · start trigger và end triggerSQC · các phép kiểm theo Western Electricghi kết quảKết quảghi lại vào PI AFoutput attribute, lịch sử nằm trong PI pointevent frame tạo từ event frame template, tham chiếu elementhiển thị và sử dụngClientđọc dữ liệu PI AFPI Vision: related events, event details, acknowledgePI Datalink, PI WebPartsPI OLEDB Enterprise, PI JDBC Driver, PI Web Services chocông cụ báo cáoPI Notifications Service: notification rule dựa trên event frameTheo AVEVA, tài liệu PI Server 2024 R2 (Asset Framework and PI System Explorer; Analytics and Notifications;Installation and Configuration) và PI Vision 2025 (đọc 17/11/2026). Pump là tên ví dụ. Hình: TDL tự vẽ.
Hình 1: Từ PI point tới event frame: PI AF và PI Analysis Service. Trên điện thoại, vuốt ngang để xem hết hình.

1. PI AF nằm ở đâu trong PI Server 2024 R2

AVEVA liệt kê Data Archive, PI AF và PI Notifications Service là các phần của PI Server, còn PI Analysis Service là một server role khác trong cùng bộ cài. Data Archive lưu dữ liệu theo thời gian (time-series); PI AF gắn dữ liệu đó vào tài sản và thiết bị.

PI AF server gồm PI AF Application Service, qua đó client đọc và ghi dữ liệu PI AF, và PI AF SQL database. Ở bản 2024 R2, database này chạy trên SQL Server hoặc trên database đám mây (Microsoft Azure SQL, Azure SQL Managed Instance hoặc Amazon RDS for SQL Server); hai lựa chọn sau là mới ở bản 2024 R2.

Hạng mục Tài liệu 2024 R2 nói gì
Các tầng client hoặc AF SDK, PI AF Application Service, PI AF SQL database; các tầng có thể chung một máy
Thứ tự cài thường cài PI AF server trước, vì PI Analysis Service và PI Notifications Service lưu cấu hình của chúng trong đó
SQL Server Express giới hạn 1 GB bộ nhớ và 10 GB database, không hỗ trợ high availability cho PI AF, không có SQL agent cho các job bảo trì
Ước lượng dung lượng đĩa khoảng 3 GB cho 50.000 element, mỗi element 20 attribute kiểu double; dùng event frame thì cần thêm
High availability nhiều PI AF server cân bằng tải, SQL Server AlwaysOn availability group, mirroring, replication hoặc Windows Server Failover Clustering
Cổng TCP 5457 cho client AF SDK như PI System Explorer và PI Vision, TCP 5459 cho client PI SQL for AF, TCP 1433 từ PI AF server tới SQL Server

AVEVA khuyến nghị đặt PI AF và SQL Server trên các máy riêng, có dự phòng, và đặt Data Archive khác máy với SQL Server. Một PI AF server chứa nhiều PI AF database; database tên Configuration do các client như PI Web API sử dụng, không dùng để chứa dữ liệu ứng dụng.

2. Element, attribute và cây phân cấp

Mỗi thiết bị trong asset model là một element, và dữ liệu của nó là các attribute: một giá trị cố định như đường kính bồn, hoặc tham chiếu tới PI point, công thức, database quan hệ, file và nhiều nguồn khác. Trong ví dụ bơm của AVEVA, người dùng đọc áp suất và nhiệt độ ngay trên element của bơm mà không cần biết tên PI point.

Các element xếp thành cây, giống thư mục trên máy Windows, ví dụ nhóm theo loại thiết bị hoặc theo nhà máy; element reference cho phép một tài sản nằm ở cả hai cây. AVEVA khuyên giữ cây không quá 10 cấp và bắt đầu nhỏ, với một loại tài sản hoặc một nhóm người dùng. Client cũng hiển thị cây này: PI Vision dùng nó để tìm related asset, tức các element dựng từ cùng một template. Category là nhóm do người dùng tự đặt để lọc khi tìm kiếm, mỗi loại object có category riêng.

Kiểu dữ liệu của PI AF và Data Archive không hoàn toàn giống nhau: Int16 của PI AF có dấu, còn Int16 của Data Archive chỉ chứa số dương; Int64 không có kiểu tương ứng trong Data Archive; chuỗi (string) trong Data Archive tối đa 976 ký tự và không phải Unicode.

3. Element template và attribute template

Template là mô hình của một loại tài sản. Mỗi element tạo từ template có một attribute cho mỗi attribute template, kèm toàn bộ thuộc tính của nó, nhưng từng attribute vẫn cần giá trị riêng. Sửa template thì mọi element dựng từ template đó đều đổi theo, và AVEVA khuyên gần như lúc nào cũng nên dựng element từ template. Event frame, transfer, model và notification cũng có template.

  • Base template và derived template. Base template truyền attribute, port và analysis của nó cho các derived template. Template đánh dấu Base Template Only không tạo element trực tiếp được. Derived template ghi đè một attribute kế thừa bằng attribute cùng tên, và có thể ẩn nó khỏi client như PI Vision bằng thuộc tính Excluded.
  • Extension. Nếu template cho phép, từng element có thể mang thêm attribute và port riêng.
  • Xóa template cũng xóa luôn các analysis template và notification template trỏ tới nó.

Attribute template có PI point data reference còn tạo được PI point, đặt tên bằng substitution parameter như %Element%, khi chạy lệnh Create or Update Data Reference trên element. Lệnh này đồng thời khóa (lock in) data reference: các thay đổi sau đó trên template không còn áp vào attribute, cho tới khi attribute được reset về template.

4. Data reference

Data reference cho attribute biết lấy giá trị từ đâu. PI Server 2024 R2 mô tả sáu loại:

Data reference Trả về gì
PI point giá trị của một PI point, hoặc giá trị tổng hợp (summary) hay phép tính khác trên nó
PI point array một giá trị từ một mảng PI point
Formula kết quả tính từ các attribute khác
String Builder chuỗi ghép từ giá trị attribute và text; không đổi đơn vị, không tính toán
Table lookup giá trị từ một bảng PI AF, nhập ngay trong PI AF, import hoặc liên kết từ nguồn ngoài như SQL Server
URI Builder đường link động (web hoặc PI Vision) dựng từ giá trị attribute

Tham chiếu PI point trực tiếp ghi tên server và tên point, ví dụ \\MyPIServer\sinusoid, hoặc \\%Server%\sinusoid trong template để dùng Data Archive mặc định của database. Tham chiếu gián tiếp trỏ tới một attribute PI point khác: trong ví dụ của AVEVA, attribute Level của bồn có các attribute con cho giá trị trung bình, nhỏ nhất và lớn nhất trong ngày, nên khi đổi point thì chỉ cần sửa Level. Một tham chiếu PI point trả về giá trị tại một thời điểm, hoặc kết quả tính trên một khoảng thời gian, ví dụ trung bình mỗi giờ.

Đơn vị đo (UOM) theo hệ SI và nằm trong một UOM database dùng chung cho mọi PI AF database; client tự đổi đơn vị, ví dụ từ mét sang feet. AVEVA lưu ý table lookup không được thiết kế cho dữ liệu time-series, loại dữ liệu này nên nằm trong PI point, và không khuyến khích dùng file Excel làm bảng liên kết.

5. Analysis và PI Analysis Service

Một analysis đọc giá trị attribute PI AF, tính toán theo lịch và ghi kết quả vào attribute khác hoặc tạo event frame. Mỗi analysis gắn với một element hoặc element template, và PI Analysis Service chạy toàn bộ analysis của PI AF server. Có bốn loại:

Loại Làm gì
Expression một hoặc nhiều biểu thức, mỗi biểu thức một dòng, tính từ trên xuống; ít nhất một dòng phải gán vào output attribute
Rollup Sum, Average, Minimum, Maximum, Count, Median và độ lệch chuẩn tổng thể hoặc mẫu, tính trên attribute của chính element hoặc của các element con; giá trị lỗi (bad) bị bỏ qua
Event frame generation mở và đóng event frame theo điều kiện trigger
SQC các phép kiểm Statistical Quality Control theo Western Electric SQC Handbook: Outside Control, Outside 2 Sigma, Outside 1 Sigma, One Side of Center Line, Stratification, Mixture và Trend

Analysis template đặt trên element template sẽ cho mọi element của template đó cùng một analysis, với input và output riêng của từng element. Thay đổi đã check in được áp dụng ngay, kể cả khi analysis đang chạy.

AVEVA khuyên gán output vào attribute có PI point data reference: lịch sử kết quả nằm trong Data Archive để xem trend, và PI AF chạy nhanh hơn. Data Archive áp compression cho các output này, không dùng exception. Output gán vào analysis data reference chỉ được tính khi client yêu cầu, hợp với giá trị chỉ cần kết quả mới nhất.

6. Lịch chạy, backfilling và recalculation

Lịch event-triggered là mặc định: analysis chạy khi input thay đổi, mặc định là bất kỳ input nào. Lịch periodic chạy theo giờ UTC, tối đa 120 lần mỗi giây; nếu chu kỳ không chia hết một ngày, ví dụ 7 phút, lịch sẽ bắt đầu lại lúc nửa đêm. Output mang thời điểm trigger, trừ khi đặt độ lệch thời gian hoặc một giờ cố định trong ngày.

Tùy chọn Làm gì
Backfilling tính bù kết quả còn thiếu trong một khoảng thời gian, giữ nguyên kết quả đã có
Recalculation xóa kết quả trong khoảng đó rồi tính lại; với analysis event frame generation, bước này xóa event frame cùng annotation, acknowledgement và reason code của chúng
Automatic backfilling tự lấp khoảng trống khi PI Analysis Service ngừng chạy, mặc định tối đa 72 giờ (MaximumAllowedAutoBackfillingSpanInHours)
Automatic recalculation tự tính lại khi input đến trễ hoặc sai thứ tự; bật chung cho cả hệ, nhưng phải bật cho từng analysis hoặc template; không áp dụng cho analysis tạo event frame

Analysis expression, rollup và SQC chỉ backfill hoặc recalculate được khi output gán vào attribute PI point, và người dùng cần quyền Execute, ví dụ qua identity Asset Analytics Recalculation. Cả hai cách đều có thể ghi event sai thứ tự (out-of-order), và Data Archive lưu các event này không qua compression. Mặc định service chờ 5 giây trước mỗi lần tính real-time (CalculationWaitTimeInSeconds) để đón input đến trễ, và bỏ qua các lần tính cũ nhất khi hàng đợi vượt 50, trừ khi tắt load shedding.

7. Event frame

Một event frame có tên, thời điểm bắt đầu, thời điểm kết thúc, các attribute và một hoặc nhiều element được tham chiếu. AVEVA nêu hai kiểu dùng: sự kiện theo dõi như công việc thường ngày, ví dụ ca làm việc hay sản phẩm, và sự kiện bất thường như dừng máy hay vượt ngưỡng. Nhiều event frame có thể chồng nhau trên một element, và mẻ (batch) chỉ là một loại sự kiện. Event frame template định nghĩa attribute cho từng loại sự kiện, ví dụ reason code hay nhiệt độ cao nhất, và có thể đánh index cho các attribute hay được tìm. Đường dẫn kiểu .\Elements[.]|RPM đọc attribute của chính element mà event frame tham chiếu, nên một template dùng được cho nhiều tài sản.

AVEVA đặc biệt khuyên dùng asset analytics để tạo event frame; PI EFGen, các PI interface cho hệ batch và MES, và chương trình viết bằng AF SDK cũng tạo được, còn tạo bằng tay thì AVEVA khuyên tránh hẳn. Các thiết lập của một analysis event frame generation:

Thiết lập Làm gì
Start trigger mở event frame và giữ mở khi điều kiện còn đúng; AVEVA khuyên chỉ dùng start trigger
End trigger không bắt buộc; nếu hai trigger cùng đúng một lúc có thể sinh event frame dài 0 giây
True for điều kiện bắt đầu phải đúng liên tục trong khoảng này mới mở event frame, để chống nhiễu gai (spike); thời điểm bắt đầu không bị dời
Pulse, step, step continuous các chế độ có từ bản 2018, mở và đóng event frame theo thay đổi của attribute kiểu số nguyên, chuỗi hoặc enumeration
Nhiều start trigger mỗi trigger có mức severity từ None tới Critical; khi trigger hiệu lực đổi thì sinh event frame con
Root cause event frame con ghi lại khoảng thời gian ngay trước sự kiện
Outputs at Close ghi giá trị vào attribute của event frame khi đóng; element của analysis là primary referenced element

Capture Values lưu giá trị attribute vào PI AF database để hiển thị nhanh hơn và không đổi về sau. Template bật Can Be Acknowledged thì event frame mới acknowledge được, người dùng cần quyền Annotate; notification rule có thể dựa trên event frame từ bất kỳ nguồn nào.

PI Datalink, PI Vision và PI WebParts hiển thị được event frame, còn PI OLEDB Enterprise, PI JDBC Driver và PI Web Services đưa chúng sang các công cụ báo cáo khác; PI BatchView và PI Manual Logger thì không. PI Vision 2025 so sánh nhiều sự kiện trên một trend, và trên trang event details cho người dùng acknowledge, ghi chú, đính kèm file và chọn reason. AVEVA khuyên người dùng PI Batch chuyển sang event frame.

Những gì chúng tôi kiểm trước

Đây là cách làm của TDL, không phải yêu cầu của AVEVA.

  • Phiên bản PI Server, PI AF và PI Analysis Service trên từng node, và edition SQL Server bên dưới PI AF database.
  • Các element không dựng từ template, các template cho phép extension, và các data reference đã bị khóa.
  • Output nào của analysis ghi vào PI point, và các point đó đặt tên ra sao.
  • Tab Service Summary và Service Details của PI Analysis Service trước khi thêm analysis.
  • Annotation, acknowledgement và reason code trên event frame trước khi recalculate bất kỳ analysis event frame generation nào.
  • Khi thiếu dữ liệu, kiểm interface và buffering trước: xem bài sửa lỗi PI System.

TDL làm việc này thế nào

TDL Industrial Automation là thành viên AVEVA Partner Ecosystem với vai trò System Integrator. Trang dịch vụ AVEVA của chúng tôi liệt kê AVEVA PI System trong số các phần mềm AVEVA mà chúng tôi xây dựng, mở rộng và bảo trì ứng dụng SCADA, HMI, batch và historian. Khi lên kế hoạch một mô hình PI AF, chúng tôi bắt đầu từ những người sẽ tìm dữ liệu, rồi dựng mỗi loại tài sản một template trước khi tạo element. Đọc thêm: Historian là gì, đối tác AVEVA tại Việt Nam và SCADA, HMI và tích hợp dữ liệu nhà máy.

Câu hỏi thường gặp

Element và element template trong PI AF khác nhau thế nào?

Element đại diện cho một thiết bị, ví dụ một bơm, và chứa các attribute của nó. Element template là mô hình của loại tài sản: mọi element tạo từ template có cùng các attribute, và sửa template thì tất cả đều đổi theo.

PI Analysis Service chạy những loại analysis nào?

Bốn loại: expression, rollup, event frame generation và SQC (Statistical Quality Control). Mỗi analysis gắn với một element hoặc element template, và analysis template cho mọi element của một template cùng một analysis.

Lịch mặc định của analysis là event-triggered hay periodic?

Mặc định là event-triggered, chạy khi bất kỳ input attribute nào thay đổi. Lịch periodic chạy theo giờ UTC, tối đa 120 lần mỗi giây.

Recalculate một analysis event frame generation thì event frame ra sao?

Các event frame trong khoảng thời gian đã chọn bị xóa rồi tạo lại, và annotation, acknowledgement, reason code của chúng bị mất.

PI AF có cần SQL Server không?

Có. PI AF server gồm PI AF Application Service và PI AF SQL database; ở PI Server 2024 R2, database này chạy trên SQL Server hoặc trên Azure SQL, Azure SQL Managed Instance hay Amazon RDS for SQL Server. SQL Server Express giới hạn 1 GB bộ nhớ và 10 GB database, và không hỗ trợ high availability cho PI AF.

Nguồn

Đọc ngày 17/11/2026. Bài viết diễn giải, không trích nguyên văn; đọc tài liệu gốc trước khi thiết kế hoặc thao tác.

Dịch vụ liên quan:
SCADA & historian AVEVA (Wonderware)