Phần mềm SARTORIUS Sim Api

Thông số kỹ thuật

• Tên sản phẩm: Hướng dẫn SimApi
• Ngày phát hành: 5 tháng 2024 năm XNUMX
• Mục đích: Cung cấp dữ liệu cho các sản phẩm Umetrics Suite

Hướng dẫn sử dụng sản phẩm

Giới thiệu về SimApis

• SimApis được sử dụng để thu thập dữ liệu phục vụ mục đích tạo dự án và xây dựng mô hình trong các sản phẩm Umetrics Suite.

Nhận SimApis

• Để tải SimApis, hãy tham khảo tài liệu chính thức hoặc liên hệ với bộ phận hỗ trợ khách hàng để được trợ giúp.

Tính năng của SimApi

• SimApis cung cấp dữ liệu thời gian thực để giám sát, kiểm soát và xây dựng mô hình trong SIMCA và SIMCA-online.

Chỉ sử dụng dữ liệu hiện tại

• Bạn chỉ nên sử dụng dữ liệu hiện tại và tránh sử dụng dữ liệu lịch sử để có hiệu suất tối ưu.

Chuẩn bị cài đặt SimApi

• Trước khi cài đặt, hãy đảm bảo hệ thống của bạn đáp ứng các yêu cầu tối thiểu được nêu trong hướng dẫn sử dụng.

Cài đặt SimApi

• Làm theo hướng dẫn từng bước có trong sách hướng dẫn sử dụng để cài đặt SimApi trên hệ thống của bạn.

Thiết lập SimApi cho SIMCA

• Cấu hình cài đặt SimApi trong SIMCA theo hướng dẫn được cung cấp.

Thiết lập SimApi cho SIMCA-online

• Thiết lập SimApi để truy xuất dữ liệu theo thời gian thực và thực hiện thao tác ghi lại trong SIMCA-online.

Kiểm tra và xử lý sự cố

• Sau khi cài đặt, hãy thực hiện kiểm tra để đảm bảo chức năng hoạt động bình thường. Trong trường hợp có vấn đề, hãy tham khảo phần khắc phục sự cố trong hướng dẫn sử dụng.

Kiểm tra từ SIMCA-online

• Kiểm tra tích hợp SimApi từ SIMCA-online để xác minh việc truy xuất dữ liệu.

Xử lý sự cố với Nhật ký Files

• Sử dụng nhật ký SimApi file để xác định và giải quyết mọi vấn đề về cài đặt hoặc vận hành.

Cấu hình tài khoản dịch vụ

• Đảm bảo cấu hình đúng tài khoản dịch vụ SIMCA-online để hoạt động liền mạch.

Chi tiết kỹ thuật

• Tham khảo phần 7 của hướng dẫn sử dụng để biết thông tin kỹ thuật chuyên sâu về SimApis.

Giới thiệu về SimApis

• SimApi là giao diện phần mềm giữa phần mềm Umetrics® Suite và nguồn dữ liệu. Mục đích chính của SimApi là cung cấp dữ liệu cho SIMCA®-online hoặc SIMCA®.
• Sartorius Stedim Data Analytics AB phát triển SimApis cho nhiều nguồn dữ liệu khác nhau, chẳng hạn như dữ liệu lịch sử quy trình và cơ sở dữ liệu đa năng.
• Tài liệu này cho biết SimApi là gì và cách sử dụng trong các sản phẩm Umetrics Suite. Bạn sẽ học cách lập kế hoạch và cài đặt SimApi, cách khắc phục sự cố và cách kiểm tra cài đặt của mình. Chương cuối cùng chứa các chi tiết kỹ thuật của SimApis dành cho các nhà phát triển.

Mục đích của SimApi: cung cấp dữ liệu cho các sản phẩm Umetrics Suite

• Mục đích chính của SimApi là cung cấp dữ liệu cho SIMCA-online hoặc SIMCA từ một nguồn dữ liệu. Nguồn dữ liệu không phải là một phần của SIMCA-online nhưng có thể là một trình sử quy trình hoặc hệ thống khác lưu giữ và quản lý dữ liệu.
• SimApi hiển thị một hệ thống phân cấp các nút, tương ứng với các thư mục trong một file hệ thống. Mỗi nút có thể chứa các nút khác hoặc tags. MỘT tag tương ứng với một biến. Đối với những tags, dữ liệu có thể được lấy được. Hình ảnh cho thấy một tag, Temp, được chọn trong nút
• BakersYeastControlGood trong nguồn dữ liệu trong SIMCA-online. Nó cũng hiển thị các giá trị mới nhất lấy từ nguồn dữ liệu.

Sử dụng SimApi trong Umetrics Suite

• Phần mềm máy tính để bàn SIMCA có thể sử dụng SimApi để lấy dữ liệu phục vụ mục đích tạo dự án và xây dựng mô hình như hình minh họa sau đây.
• SIMCA-online sử dụng SimApis để lấy dữ liệu theo thời gian thực để giám sát và kiểm soát, cũng như ghi lại dữ liệu vào nguồn dữ liệu. Hình ảnh sau đây cho thấy SimApi nằm ở đâu trong hệ thống bao gồm nguồn dữ liệu, máy chủ SIMCA-online và máy khách.

SimApis thường được sử dụng

• Các SimApi được sử dụng rộng rãi nhất là:
• PI AF SimApi để kết nối với Hệ thống PI Aveva (trước đây là OSIsoft).
• OPC UA SimApi
• ODBC SimApi – để truy cập chung vào các cơ sở dữ liệu như SQL Server hoặc Oracle
• Tất cả các SimApi có sẵn đều được liệt kê cùng với các tính năng của chúng ở đoạn 3.

DBMaker SimApi cho dữ liệu mô phỏng

• DBMaker là một ứng dụng được cung cấp cùng với cài đặt máy chủ SIMCA-online. Nó mô phỏng một nguồn dữ liệu, chẳng hạn như một trình sử quy trình, bằng cách sử dụng một bảng dữ liệu được tải trước, trong đó các quan sát được cung cấp từng cái một cho SIMCA-online thông qua DBMaker SimApi.
• DBMaker chỉ được sử dụng cho mục đích trình diễn và không thể sử dụng trong sản xuất với dữ liệu trực tiếp từ nguồn dữ liệu. Xem trợ giúp tích hợp để tìm hiểu thêm về DBMaker.

Tài liệu bổ sung

• Tài liệu này là một trong nhiều tài liệu liên quan, mỗi tài liệu có trọng tâm và đối tượng mục tiêu khác nhau:

Nguồn	Cái gì	Ở đâu
SIMCA-trực tuyến web trang	Thông tin giới thiệu và tải xuống	sartorius.com/umetrics-simca- trực tuyến

SIMCA-online ReadMe và Cài đặt.pdf	Cài đặt và cách bắt đầu với SIMCA- dữ liệu demo trực tuyến	Trong file zip cài đặt file
Hướng dẫn triển khai SIMCA-online	Phác thảo chức năng SIMCA-online, đặt nó trong bối cảnh với các phần mềm Umetrics Suite khác, mô tả các yêu cầu và biện pháp tốt nhất để triển khai thành công và hướng dẫn cài đặt từng bước.	sartorius.com/umetrics-simca- trực tuyến
Hướng dẫn SimApi	Chuẩn bị và thực hiện cài đặt SimApi, bao gồm khắc phục sự cố. Cũng bao gồm các chi tiết kỹ thuật về SimApis dành cho nhà phát triển.	sartorius.com/umetrics-simapi
Hướng dẫn sử dụng SimApi	Tài liệu cho từng SimApi đã xuất bản với các tính năng, hướng dẫn cài đặt và thông số cấu hình cụ thể.	sartorius.com/umetrics-simapi
Hướng dẫn kỹ thuật SIMCA-online	Tài liệu tham khảo kỹ thuật về lập kế hoạch cài đặt máy chủ SIMCA-online, khắc phục sự cố và tìm hiểu sâu hơn về cách SIMCA-online hoạt động.	sartorius.com/umetrics-simca-trực tuyến
Trợ giúp trực tuyến SIMCA	Web-trợ giúp về cách sử dụng SIMCA-online và cách SIMCA-online hoạt động.	Trong phần mềm và trên sartorius.com/umetrics-simca
SIMCA-trực tuyến Web Hướng dẫn cài đặt máy khách	Mô tả việc cài đặt SIMCA-online Web Khách hàng.	sartorius.com/umetrics-simca-trực tuyến
Cơ sở kiến ​​thức Umetrics	Cơ sở dữ liệu có thể tìm kiếm với các bài viết về từng phiên bản phần mềm đã phát hành, các bài viết kỹ thuật và các sự cố đã biết trong các sản phẩm Umetrics Suite.	sartorius.com/umetrics-kb
Trợ giúp/hướng dẫn sử dụng SIMCA	Cách sử dụng SIMCA trên máy tính để tạo dự án và mô hình hóa dữ liệu.	Trong SIMCA và trên sartorius.com/umetrics-simca
Ủng hộ web trang	Làm thế nào để có được hỗ trợ kỹ thuật.	sartorius.com/umetrics-support

Hỗ trợ kỹ thuật

• Nhóm hỗ trợ trực tuyến của Sartorius trả lời các câu hỏi kỹ thuật về SimApis và cũng có thể chuyển tiếp các yêu cầu cải tiến SimApis đến những người phù hợp. Tìm hiểu thêm tại sartorius.com/umetrics-support.

Nhận SimApis

• Chúng tôi cung cấp tài liệu cho SimApis có sẵn và liên kết đến các chương trình cài đặt tại sartorius.com/umetrics-simapi.
• Mỗi SimApi đều được ghi chép trong Hướng dẫn sử dụng.
• Hướng dẫn SimApi mà bạn đang đọc sẽ bổ sung thông tin đó bằng thông tin bổ sung về SimApi khi nói đến việc lập kế hoạch, cài đặt và khắc phục sự cố SimApi.

Tính năng của SimApi

• Không phải tất cả các nguồn dữ liệu đều giống nhau. SimApi không cần phải triển khai tất cả các chức năng trong thông số kỹ thuật. Vì những lý do này, các SimApi khác nhau cung cấp các chức năng khác nhau. Ma trận sau đây liệt kê các SimApi có sẵn và các tính năng của chúng.
• Các tính năng được giải thích bên dưới. Lưu ý rằng bảng có các cột riêng biệt để hiển thị các tính năng có sẵn trong SIMCA-online và SIMCA tương ứng.

Tính năng	Mục đích	Sử dụng SIMCA-online	Sử dụng SIMCA
Dữ liệu hiện tại	Đọc một quan sát duy nhất có giá trị gần đây nhất từ ​​nguồn dữ liệu.	Thực hiện bình thường theo thời gian thực	–
Dữ liệu lịch sử	Đọc nhiều quan sát cùng lúc với dữ liệu lịch sử từ nguồn dữ liệu.	Bắt kịp và dự đoán dữ liệu trong quá khứ, tạo dự án bằng cách sử dụng File > Mới	Trình hướng dẫn nhập cơ sở dữ liệu để nhập dữ liệu quy trình nhằm tạo mô hình.
Dữ liệu rời rạc	Đọc dữ liệu phòng thí nghiệm/IPC từ nguồn dữ liệu. Nhiều quan sát trên mỗi lô.	Dành cho các dự án hàng loạt có các giai đoạn hoặc điều kiện hàng loạt được cấu hình để truy xuất dữ liệu rời rạc.	–
Dữ liệu lô	Đọc các điều kiện lô và các thuộc tính chất lượng cuối cùng (hoặc	Điều kiện lô hoặc định tâm cục bộ.	Trình hướng dẫn nhập cơ sở dữ liệu để đọc các điều kiện hàng loạt cho

Tính năng	Mục đích	Sử dụng SIMCA-online	Sử dụng SIMCA
	dữ liệu loại MES khác). Một quan sát cho mỗi lô.		tạo mô hình cấp lô.
Nút hàng loạt	Chỉ định thời gian bắt đầu và thời gian kết thúc (để trống đối với lô đang hoạt động) cho một lô cụ thể. Liệt kê tất cả các lô hàng tồn tại trong một khoảng thời gian.	Cần thiết để thực hiện cấu hình hàng loạt.	Trình hướng dẫn nhập cơ sở dữ liệu để chọn các lô cần nhập.
Viết lại – dữ liệu liên tục	Ghi dữ liệu liên tục, chẳng hạn như dự đoán, trở lại nguồn dữ liệu.	Ghi lại dữ liệu từ mức tiến hóa hàng loạt, cho Control Advisor hoặc cho các cấu hình liên tục	–
Viết lại – rời rạc	Ghi dữ liệu rời rạc, chẳng hạn như dự đoán, trở lại nguồn dữ liệu.	Viết lại cho các cấu hình hàng loạt ở cấp độ tiến hóa hàng loạt cho các giai đoạn được cấu hình để truy xuất dữ liệu rời rạc	–
Viết lại – dữ liệu hàng loạt	Ghi lại dữ liệu cấp lô, chẳng hạn như dự đoán hoặc thuộc tính chất lượng cuối cùng, vào nguồn dữ liệu.	Viết lại để cấu hình hàng loạt ở cấp độ hàng loạt	–
Hệ thống phân cấp nút	SimApi hỗ trợ một hệ thống phân cấp các nút, tương tự như một file hệ thống. Mỗi nút có thể chứa tags và các nút khác. Hệ thống phân cấp giúp quản lý dễ dàng hơn một số lượng lớn các nút và tags.	Được hỗ trợ ở mọi nơi tags được sử dụng.
Mảng tag sự mở rộng	Một mảng tag lưu trữ nhiều giá trị. SimApi mở rộng mảng tag đến nhiều cá nhân tags, một cho mỗi phần tử trong mảng.	Được hỗ trợ ở đâu tags được sử dụng cho dữ liệu liên tục. Mỗi dữ liệu mở rộng tag phải được ánh xạ tới một biến trong dự án SIMCA.
Nhiều nguồn dữ liệu	SimApi có thể kết nối với nhiều nguồn dữ liệu hoặc hỗ trợ nhiều phiên bản của chính nó với các thiết lập và nhật ký riêng lẻ files cho mỗi trường hợp.	Kết nối với nhiều nguồn dữ liệu khác nhau cùng loại.	–
Khả năng phục hồi kết nối	Nếu SimApi bị ngắt kết nối khỏi nguồn dữ liệu, nó sẽ cố gắng tự động thiết lập lại kết nối.	SimApi không cần phải khởi động lại để thiết lập lại kết nối với nguồn dữ liệu.	–
Được phát triển nội bộ	SimApi được phát triển, cung cấp và hỗ trợ bởi

Chỉ dữ liệu hiện tại, không có dữ liệu lịch sử, không được khuyến khích

• Một số SimApi, đáng chú ý là OPC DA, chỉ hỗ trợ đọc dữ liệu hiện tại chứ không phải dữ liệu lịch sử.
• SimApi chỉ hỗ trợ dữ liệu hiện tại không thể được sử dụng trong SIMCA trên máy tính để bàn vì nó không thể đọc dữ liệu lịch sử để xây dựng mô hình.
• Đối với SIMCA-online, chúng tôi đặc biệt khuyên dùng nguồn dữ liệu và SimApi không chỉ cung cấp dữ liệu hiện tại để thực hiện theo thời gian thực mà còn cung cấp dữ liệu lịch sử để có thể dự đoán và bắt kịp dữ liệu trong quá khứ. SIMCA-online tự động chuyển đổi giữa dữ liệu thời gian thực và dữ liệu lịch sử khi cần và không thể tắt tính năng này.
• Nguồn dữ liệu chỉ cung cấp dữ liệu hiện tại nhưng không cung cấp dữ liệu lịch sử có thể hoạt động cho các dự án liên tục trong SIMCA-online, nhưng đối với các dự án hàng loạt thì cần có dữ liệu lịch sử.

Chuẩn bị cài đặt SimApi

• Phần này mô tả thông tin quan trọng để cài đặt SimApi thành công.

SimApis 64-bit hoặc 32-bit

• Mỗi SimApi đều có phiên bản 32 bit và 64 bit.
• SIMCA-online và SIMCA là 64-bit và yêu cầu các biến thể SimApis 64-bit. SimApis 32-bit cũ vẫn khả dụng cho các cài đặt cũ hơn.

Vị trí cho nhật ký file và cài đặt

• SimApi lưu trữ nhật ký của nó files trong thư mục Dữ liệu chương trình ẩn1:
  %programdata%\Umetrics\SimApi, trong đó %programdata% ánh xạ tới thư mục thực tế trên máy tính của bạn. Mặc định là C:\ProgramData.
• Mỗi SimApi thường sử dụng nhật ký riêng của mình file, tương tự như nhật ký máy chủ SIMCA-online file sẽ chứa nhiều hay ít dữ liệu tùy thuộc vào cài đặt mức nhật ký. Điều này file hữu ích cho việc khắc phục sự cố. Nhật ký file được đặt tên
  .log ở đâu là SimApi mà bạn đang cài đặt, ví dụample PIAFSimApi. Ngoài ra, hãy xem phần tiếp theo để biết tên phiên bản SimApi của SIMCA-online.
• Thư mục này cũng chứa các thiết lập SimApi trong XML file được đặt tên .xml.
• Hầu hết SimApis đều có giao diện người dùng đồ họa thay đổi các thiết lập trong xml file, nhưng đối với một số bạn nhập các thay đổi trực tiếp vào XML file bằng trình soạn thảo văn bản, chẳng hạn như Notepad. Xem hướng dẫn sử dụng cho từng SimApi.

File tên khi các trường hợp được đặt tên được sử dụng với SIMCA-online

• Trong SIMCA-online, mỗi phiên bản SimApi đều có cấu hình riêng file và ghi nhật ký file để làm việc với nhiều phiên bản của mỗi SimApi. Tên của những files được thêm hậu tố là tên của phiên bản được cung cấp trên tab SimApi trong hộp thoại Tùy chọn máy chủ SIMCA-online.
• Các ví dụ sau đâyample cho thấy việc đặt tên của những files, ở đâu cần phải thay thế bằng tên SimApi.
• Tên cấu hình được cung cấp khi phiên bản được thêm vào: OmegaServer
• Cấu hình file tên: OmegaServer.xml
• Nhật ký file tên: OmegaServer.log
• Lưu ý rằng chung file .log file vẫn được tạo ra. Nhật ký này file chứa các mục nhập mà vì lý do kỹ thuật không thể chuyển hướng đến nhật ký file của các trường hợp..
• Thư mục này được ẩn trong Windows theo mặc định. Để xem nó trong File Explorer bạn cấu hình nó hiện ẩn files. Lưu ý rằng bạn có thể điều hướng đến một thư mục ẩn bằng cách nhập địa chỉ vào File Thanh địa chỉ của Explorer.
• Lưu ý rằng SIMCA không hỗ trợ nhiều phiên bản của SimApi, do đó sử dụng tên không có tên phiên bản như mô tả ở trên.

Quy hoạch mạng lưới

• Bạn nên đặt máy chủ SIMCA-online gần nguồn dữ liệu trong mạng. Điều này đảm bảo kết nối nhanh giữa SIMCA-online và nguồn dữ liệu của nó.
• Thiết bị mạng có thể gây nhiễu kết nối giữa SIMCA-online và nguồn dữ liệu.

Tài khoản người dùng và quyền nguồn dữ liệu

• Các nguồn dữ liệu thường kiểm soát quyền truy cập vào dữ liệu của họ. Điều này thường được thực hiện bằng tên người dùng và mật khẩu nhưng cũng có thể sử dụng các hạn chế dựa trên địa chỉ IP hoặc DNS (ví dụ:ample PI Trusts trong Hệ thống Aveva PI).
• Tên người dùng và mật khẩu có thể được cung cấp cho nguồn dữ liệu theo nhiều cách khác nhau:
• SimApi được chạy như người dùng Windows của người dùng chạy SIMCA trên máy tính để bàn hoặc tài khoản dịch vụ SIMCA-online trên máy tính chủ. SimApi có thể kết nối với nguồn dữ liệu bằng tài khoản này. Đây là cách OPC I và PI SimApi hoạt động, và ODBC nếu bạn không cung cấp thông tin xác thực khi cấu hình.
• Đối với ODBC chung, bạn có thể sử dụng ứng dụng ODBC Data Sources Administrator nằm ở Start trong Windows.
• Một số nhà cung cấp cơ sở dữ liệu cung cấp trình điều khiển và công cụ riêng cho cơ sở dữ liệu của họ. Ví dụ: cơ sở dữ liệu Oracleample, sử dụng Oracle Data Access Components (ODAC).
• Một số SimApi, chẳng hạn như PI AF và ODBC, có hộp thoại cấu hình lưu trữ thông tin xác thực được mã hóa trong cấu hình XML SimApi file.
• PI cũng có nhiều tùy chọn bảo mật khác nhau có sẵn trong PI System Management Tools trên máy chủ PI. Đọc thêm trong PI AF SimApi User Guide. Hướng dẫn này hữu ích ngay cả khi bạn sử dụng OSIsoft PI SimApi cũ hơn.
• OPC DA và HDA sử dụng DCOM làm phương tiện truyền tải giữa nguồn dữ liệu và SimApi. DCOM được cấu hình bằng công cụ Component Services (DCOMCNFG.EXE) trong Windows và sử dụng xác thực Windows.
• Đối với OSIsoft PI SimApi cũ (không phải AF SimApi mới), ứng dụng OSIsoft AboutPI-SDK (PISDKUtility.exe) được sử dụng để thiết lập kết nối với máy chủ PI.

Xác minh kết nối nguồn dữ liệu
Khi bạn muốn cài đặt SimApi trên máy tính, bạn có thể kiểm tra kết nối từ máy tính đó đến nguồn dữ liệu bằng một công cụ khác:

• Nguồn dữ liệu ODBC trong Windows được sử dụng để cấu hình và kiểm tra ODBC chung. Lưu ý rằng có hai phiên bản của công cụ này trên Windows 64 bit: một cho các ứng dụng 32 bit và một cho 64 bit. Sử dụng nút Kiểm tra nguồn dữ liệu ở cuối trình hướng dẫn cấu hình ODBC để xác minh kết nối với cơ sở dữ liệu. Chúng tôi khuyên bạn nên cấu hình nguồn dữ liệu của mình dưới dạng DSN hệ thống.
• Một công cụ kết nối dành riêng cho cơ sở dữ liệu từ nhà cung cấp cơ sở dữ liệu, chẳng hạn như Oracle Data Access Components.
• PI System Explorer có thể được sử dụng để kiểm tra kết nối với máy chủ PI AF. Nó là một phần của PI AF Client, là điều kiện tiên quyết cho PI AF SimApi.
• OPC UA Expert từ Unified Automation – UaExpert là một ứng dụng thử nghiệm đa nền tảng dành cho máy chủ OPC UA.
• Ứng dụng PI-SDK (PISDKUtility.exe) có thể được sử dụng để kiểm tra kết nối và view bất kỳ thông báo lỗi nào có thể đã được ghi lại khi SIMCA-online cố gắng kết nối với máy chủ PI. Điều này chỉ được sử dụng cho OSIsoft SimApi cũ hơn, không phải PIAF.
• Công cụ quản lý hệ thống PI được sử dụng trên máy chủ PI để khắc phục sự cố từ phía đó. Ví dụample, để tìm kiếm các vấn đề bảo mật ngăn chặn truy cập từ máy chủ SIMCA-online. Tìm hiểu thêm về cách khắc phục sự cố hệ thống PI trong video YouTube này.
• Có thể sử dụng Excel để lấy dữ liệu từ kết nối ODBC và hầu hết các hệ thống khác khi cài đặt plugin phù hợp.
• Matrikon OPC Explorer cho Ior HDA (đây là các công cụ riêng biệt) có thể được sử dụng để kiểm tra kết nối OPC và Matrikon OPC Analyzer có thể được sử dụng để chẩn đoán các vấn đề kết nối OPC. Tải xuống các công cụ miễn phí này từ https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (dành cho DInd HDA) từ Viện đào tạo OPC web trang web “cho phép người dùng dễ dàng chẩn đoán các vấn đề về truyền thông và bảo mật, và sửa chữa chúng ngay lập tức chỉ bằng một nút bấm. Tất cả những điều này có thể được thực hiện mà không cần phải học cách cấu hình DCOM“

Cài đặt SimApi

Sau đây là cách cài đặt SimApi trên PC:

1. Đọc Hướng dẫn sử dụng cho SimApi mà bạn đang cài đặt. Hướng dẫn này chứa các thông tin cụ thể cho SimApi đó bổ sung cho các hướng dẫn chung mà bạn đang đọc.
2. Cài đặt và cấu hình bất kỳ điều kiện tiên quyết nào được đề cập trong Hướng dẫn sử dụng SimApi (ví dụ:amptrình điều khiển cơ sở dữ liệu hoặc SDK)
3. Chạy chương trình thiết lập để cài đặt SimApi. Cài đặt phiên bản 64-bit (x64) hoặc 32-bit (x86) phù hợp với phần mềm bạn sẽ chạy.
4. Cấu hình SimApi trong SIMCA-online hoặc SIMCA như mô tả trong các phần sau và tham khảo hướng dẫn sử dụng SimApi để biết mô tả về các cài đặt có sẵn.
5. Khởi động máy chủ SIMCA-online. Lưu ý rằng việc này có thể mất thời gian, vì khi SimApi được khởi tạo, nó sẽ liệt kê tất cả tags trong nguồn dữ liệu.
6. Kiểm tra SimApi bằng cách lấy một số dữ liệu. Đối với SIMCA-online, bạn có thể sử dụng File > Trích xuất như mô tả trong 6.1.
7. Nếu SimApi không hoạt động như mong đợi, hãy tham khảo nhật ký SimApi fileđể khắc phục sự cố và hướng dẫn sử dụng SimApi.

Thiết lập SimApi để sử dụng trong SIMCA

Sau đây là cách sử dụng SimApi trong SIMCA:

1.  Bắt đầu nhập cơ sở dữ liệu theo một trong những cách sau:
   • a. Để tạo một dự án mới trong SIMCA: File > Dự án thường xuyên mới hoặc Dự án hàng loạt mới. Chọn Từ cơ sở dữ liệu trên tab Trang chủ.
   • b. Để nhập một tập dữ liệu vào một dự án hiện có trong SIMCA: Từ tập dữ liệu trên tab Dữ liệu của một dự án SIMCA đang mở.
2. Nhấp vào Thêm nguồn dữ liệu mới
3. Chọn SimApi làm loại kết nối, nhấp vào nút … và định vị .dll trong thư mục cài đặt và nhấp vào Mở.
4. Nhấp vào Cấu hình và tham khảo Hướng dẫn sử dụng SimApi riêng lẻ để biết cách thực hiện cài đặt.
5. Nhấp vào Kiểm tra kết nối nguồn dữ liệu để xác minh rằng bạn có thể kết nối với cơ sở dữ liệu. Việc này có thể mất nhiều thời gian nếu có nhiều tags trong nguồn dữ liệu.
6. Nhấp vào OK để hoàn tất cấu hình.
7. Tham khảo trợ giúp SIMCA để biết cách làm việc với dữ liệu đã nhập.

Thiết lập SimApi để sử dụng trong SIMCA-online

• Quan trọng: Để có thể sử dụng SimApi, cần có giấy phép máy chủ SIMCA-online. Cài đặt demo SIMCA-online không cho phép sử dụng SimApis.
• Để thêm SimApi vào hệ thống, bạn chạy SIMCA-online Server Options trên PC máy chủ. Tìm hiểu các bước chi tiết trong chủ đề trợ giúp SICMA-online Thêm và cấu hình SimApi trên máy chủ.
• Mẹo: Nếu bạn thực hiện thay đổi cho SimApi, bạn có thể khởi động lại SimApi đó riêng biệt với Tùy chọn máy chủ mà không cần khởi động lại toàn bộ máy chủ.
• Để cấu hình nhiều phiên bản của SimApi này, hãy lặp lại các bước trên và sử dụng tên duy nhất cho mỗi phiên bản. Đọc thêm về nhật ký và cấu hình khác nhau files cho các trường hợp trong 4.2.

Kiểm tra và khắc phục sự cố SimApi

• Chương này nói về việc kiểm tra và khắc phục sự cố cài đặt SimApi.

Kiểm tra SimApi từ SIMCA-online

• Sau khi máy chủ SIMCA-online khởi động thành công, bạn có thể kiểm tra SimApi của mình trong SIMCA-online (nếu máy chủ không khởi động, hãy xem 6.2):
• Đăng nhập vào máy chủ trong máy khách SIMCA-online và điều hướng đến Trích xuất trên File tab. Trích xuất giúp bạn kiểm tra SimApi bằng cách lấy dữ liệu thông qua nó:
• Các nút (“thư mục”) của SimApi được hiển thị ở hộp bên trái. Tags đối với nút được chọn sẽ hiển thị ở góc trên bên phải.
• Dữ liệu hiện tại có thể được kiểm tra nhanh chóng chỉ bằng cách nhấp vào view> trên tags cung cấp dữ liệu quy trình liên tục (xem ảnh chụp màn hình)
• Nhấp chuột phải vào một nút để Tìm các lô trong một khoảng thời gian. Nút phải là một nút lô biết về các lô.
• Lựa chọn tags trong Trích xuất và nhấp vào Tiếp theo và hoàn tất trình hướng dẫn để lấy dữ liệu bằng các chế độ truy xuất dữ liệu khác nhau: dữ liệu hiện tại, dữ liệu lịch sử, dữ liệu theo lô và dữ liệu rời rạc.
• So sánh dữ liệu đã trích xuất với những gì bạn thấy trong nguồn dữ liệu của mình bằng các công cụ của nó. Tìm hiểu thêm về việc kiểm tra và xác thực tất cả các tính năng của SimApi trong 7.13.

Khắc phục sự cố SimApi bằng cách sử dụng nhật ký SimApi file

• Nếu máy chủ không khởi động, SimApi không hoạt động như mong đợi hoặc trích xuất không thành công, bạn cần tham khảo nhật ký SimApi file cho bạn biết vấn đề là gì. Bật ghi nhật ký cấp độ gỡ lỗi trong nhật ký SimApi để biết đầy đủ thông tin chi tiết. Xem 4.2.
• Lưu ý: nhật ký máy chủ SIMCA-online không hữu ích ở đây. Chúng sẽ hiển thị cách SimApi được tải và khởi tạo bởi máy chủ, nhưng các chi tiết cụ thể của SimApi nằm trong nhật ký của nó file.

Sử dụng đúng tài khoản dịch vụ SIMCA-online

• Khi bạn đang kiểm tra quyền truy cập vào nguồn dữ liệu, hãy nhớ rằng bạn đã đăng nhập với tư cách là một người dùng cụ thể trên máy chủ (thường là tài khoản người dùng của riêng bạn trong miền Windows), nhưng tài khoản dịch vụ máy chủ SIMCA-online là một tài khoản khác, theo mặc định là LocalSystem, có quyền truy cập khác so với tài khoản người dùng của bạn.
• Vì lý do này, không hiếm trường hợp các bài kiểm tra hoạt động khi chạy bằng tài khoản của bạn nhưng SIMCA-online lại không kết nối được với nguồn dữ liệu.
• Để giải quyết vấn đề này, phải cấp quyền truy cập cho tài khoản được dịch vụ máy chủ SIMCA-online sử dụng. Thông thường, bạn thay đổi LocalSystem thành một tài khoản dịch vụ miền cụ thể và cấp quyền cho tài khoản này. Lưu ý rằng điều này không áp dụng nếu SimApi sử dụng thông tin xác thực được đặt trong cấu hình SimApi vì các thông tin xác thực này được ưu tiên.

Chi tiết kỹ thuật về SimApis

• Chương này cung cấp thông tin chi tiết về kỹ thuật về cách thức hoạt động của SimApi. Chương này chủ yếu hướng đến các nhà phát triển muốn hiểu SimApi để triển khai SimApi cho nguồn dữ liệu.
• Các nhà phát triển cũng nên đọc các phần trước của tài liệu này để biết phần giới thiệu về SimApis và mô tả chi tiết về các tính năng.

Khi nào nên cân nhắc phát triển SimApi và khi nào thì không?

Trước khi cân nhắc phát triển SimApi cho nguồn dữ liệu:

1. Hãy tìm hiểu xem đã có SimApi nào mà bạn có thể sử dụng chưa. Có lẽ bạn có thể bật một số tính năng trong nguồn dữ liệu của mình để sử dụng một trong những SimApi hiện có, chẳng hạn như OPC UA.
2. Hãy cẩn thận xem xét tài liệu này và các tài liệu tham khảo của nó và điều tra xem nguồn dữ liệu của bạn có đáp ứng các yêu cầu hay không: ví dụampLe, nó cần phải đủ nhanh, cung cấp không chỉ dữ liệu hiện tại mà còn cả dữ liệu lịch sử.

• Vì những lý do này, chúng tôi không khuyến nghị phát triển SimApi kết nối với phần cứng hoặc thiết bị cấp thấp. Tốt hơn là kết nối các thiết bị đó với một trình sử quy trình như Aveva PI System và để nó lấy dữ liệu từ thiết bị và lịch sử hóa dữ liệu. Sau đó, có thể sử dụng PIAF SimApi để lấy dữ liệu từ PI đến sản phẩm Umetrics.

Phát triển SimApi và đặc tả SimApi

• Đặc tả SimApi, SimApi-v2, chứa tài liệu hướng dẫn cho tất cả các hàm C trong SimApi mà một SimApi DLL cần triển khai cũng như một số hướng dẫn về cách phát triển SimApi.
• Việc triển khai SimApi bằng C hoặc C++ trong hầu hết các trường hợp chỉ ở mức độ thấp không cần thiết.
• Cách được khuyến nghị và dễ dàng hơn để triển khai SimApi là dựa trên ExampMã nguồn leSimApi mà chúng tôi cung cấp. Đây là một example SimApi implementation xử lý giao diện C và dịch nó thành .NET Framework nơi thực hiện triển khai thực tế. Nó cũng có mã khung cho ghi nhật ký, cài đặt, GUI cấu hình và mã khung khác.
• Để phát triển SimApi, nhóm phát triển cần có kinh nghiệm trong phát triển Windows, .NET Framework, C hoặc C++. Cũng cần có kiến ​​thức tốt về nguồn dữ liệu mà SimApi nên kết nối, vì mục đích của SimApi là dịch các yêu cầu dữ liệu từ SIMCA-online hoặc SIMCA sang API của nguồn dữ liệu. Việc triển khai SimApi không bao giờ là một dự án một lần, nhưng thường cần hỗ trợ liên tục và bảo trì thỉnh thoảng.

Đọc hoặc ghi dữ liệu

• SimApi có nhiệm vụ chính là cung cấp dữ liệu từ nguồn dữ liệu. Điều này được gọi là đọc dữ liệu.
• Hầu hết các triển khai SimApi cũng hỗ trợ ghi dữ liệu. Điều này có nghĩa là ghi lại dữ liệu thông qua SimApi vào nguồn dữ liệu. Ghi dữ liệu là một tính năng tùy chọn trong SIMCA-online.

Tags và các nút

• A tag là một định danh của một cột hoặc “biến” trong một nguồn dữ liệu. tagtên của được sử dụng để xác định tag. Tên trong nút phải là duy nhất. SIMCA-online 18 là phiên bản đầu tiên hỗ trợ một nút có chứa một nút con và tag với cùng tên. Ví dụample: nút Parent có thể có một nút con được gọi là Batch và một tag gọi là Batch.
• Một nút là một container của tags. Một nút cũng có thể chứa các nút khác, tương tự như cách một file hệ thống có các thư mục trong các thư mục.
• Giống như trong một file hệ thống, nút và tag tên có thể được kết hợp thành một đường dẫn đầy đủ để xác định duy nhất một tag. Các tag đường dẫn được sử dụng trong SIMCA-online hoặc SIMCA khi lựa chọn tags để sử dụng. A tag đường dẫn bắt đầu bằng tên phiên bản SimApi theo sau là cấu trúc nút và kết thúc bằng tag tên, mỗi mục được phân cách bằng dấu hai chấm (:). Ví dụample “:ODBCSQLServer:Node:SensorTag1”.

SimApi liệt kê tags và các nút khi khởi động

• Một triển khai SimApi duyệt máy chủ để tìm các nút và tags trong nguồn dữ liệu khi SimApi được khởi tạo và theo dõi chúng để các hàm SimApi khác nhau được sử dụng để liệt kê tags và nút có thể được triển khai.
• Việc khởi tạo SimApi không chỉ diễn ra khi khởi động máy chủ mà còn có thể được người dùng kích hoạt lại trong SIMCA-online bằng chức năng Làm mới SimApi.

Phân biệt chữ hoa chữ thường tag- và tên nút

• Tag tên và tên nút phân biệt chữ hoa chữ thường.
• Vì vậy, một tag gọi điện "tag1” không giống với “Tag1” vì chữ “T” có cách viết khác nhau. Chúng tôi khuyên bạn không nên sử dụng tags hoặc tên nút chỉ khác nhau về chữ hoa và chữ thường.

Nút quy trình liên tục 

• Khi một nút chứa tags với dữ liệu quy trình liên tục, nó có thể được gọi là một nút quy trình. Hai ảnh chụp màn hình sau đây hiển thị biểu diễn dạng bảng của một nút quy trình với dữ liệu theo sau là hình ảnh cho thấy nút trông như thế nào khi chọn tags trong SIMCA-online.

Các nút quy trình liên tục phải độc lập với các lô, lượt chạy hoặc thời gian

• Để hoạt động tốt trong SimApi, một nút phải độc lập với các đợt, lần chạy hoặc thời gian. Việc có một nút chứa dữ liệu cho một đợt hoặc phạm vi thời gian cụ thể sẽ không hoạt động tốt trong SIMCA-online vì cấu hình dự án sau đó chỉ có thể đọc dữ liệu cho đợt đó và không được sử dụng cho các đợt khác.
• Thay vào đó, một nút phải được ánh xạ tới một hoặc nhiều đơn vị vật lý trong quá trình thực hiện phép đo.

ID lô tag yêu cầu trong các nút quy trình liên tục để thực hiện dự án hàng loạt

• Mỗi quá trình liên tục phải có một tag (biến) giữ mã định danh lô cho mỗi quan sát. Mã định danh lô này được SIMCA hoặc SIMCA-online sử dụng để biết mỗi quan sát thuộc lô nào.
• $BatchID tag trong ảnh chụp màn hình ở 7.4.3 là một ví dụ như vậyamplà.
  Mặc dù không bắt buộc, nhưng bạn nên có tag trong nút quy trình hiển thị giai đoạn hoặc bước hiện tại của quy trình. Điều này tag sau đó có thể được sử dụng trong điều kiện thực hiện pha trong SIMCA-online hoặc trong SIMCA khi nhập dữ liệu. Giá trị cho điều này tag có thể là cho examp“giai đoạn 1”, “làm sạch”, “giai đoạn 2”.

Nút ngữ cảnh hàng loạt

• Một nút hàng loạt là một nút theo dõi các lô; mã định danh lô, thời gian bắt đầu và thời gian kết thúc của chúng. Đây là yêu cầu để thực hiện dự án hàng loạt trong SIMCA-online. Một nguồn dữ liệu có thể có nhiều hơn một nút hàng loạt để hiển thị các lô theo những cách khác nhau. Người dùng chọn nút hàng loạt áp dụng cho ứng dụng của mình. Ví dụ nàyample hiển thị các lô trải dài trên hai đơn vị khác nhau:
• /Factory1 – các lô có thời gian sống tổng hợp trên cả Unit1 và Unit2.
• /Factory1/Unit1 – các lô có thời gian tồn tại chỉ trong Unit1
• /Factory1/Unit2 – các lô có thời gian tồn tại chỉ trong Unit2
• Nếu bạn không có nút hàng loạt trong nguồn dữ liệu của mình, bạn có thể sử dụng Trình tạo bối cảnh hàng loạt trong SIMCA-online. Xem trợ giúp tích hợp sẵn.
• Dữ liệu lô tùy chọn
• Một nút lô cũng có thể chứa dữ liệu lô; dữ liệu mà chỉ có một quan sát cho toàn bộ lô. Lưu ý rằng tags với dữ liệu hàng loạt không cần phải nằm trong một nút có đầy đủ chức năng của một nút hàng loạt. Chỉ cần SimApi hỗ trợ đọc dữ liệu hàng loạt cho tags. Tìm hiểu thêm về dữ liệu hàng loạt trong 7.6.
• Đây là một ví dụampcủa một nút hàng loạt:
• Lưu ý: Ảnh chụp màn hình ở trên được lấy từ DBMaker, được đóng gói cùng với SIMCA-online. Để tự mình xem ảnh này trong DBMaker, hãy nhấp vào View Nút Dữ liệu trên cơ sở dữ liệu Bakers Yeast để hiển thị hai cửa sổ, một là nút mẻ và cửa sổ còn lại là dữ liệu quy trình.

Kiểu dữ liệu: dữ liệu số, dữ liệu văn bản và dữ liệu bị thiếu

• Đối với mỗi tag, SimApi có thể hỗ trợ ba loại dữ liệu: số, văn bản và dữ liệu bị thiếu:
• Dữ liệu số thường là giá trị thực của các tham số quy trình, ví dụample 6.5123. SimApi chỉ có thể xử lý các giá trị dấu phẩy động độ chính xác đơn 32 bit. Định dạng dấu phẩy động độ chính xác đơn -Wikipedia. Tất cả các kiểu dữ liệu số khác trong nguồn dữ liệu phải được chuyển đổi thành float. Do đó, chúng có thể xử lý cả giá trị lớn và nhỏ nhưng chỉ có khoảng 6 hoặc 7 chữ số có nghĩa. Tìm hiểu thêm trong Hướng dẫn kỹ thuật.
• Điều này có thể dẫn đến mất độ chính xác đối với các số nguyên lớn hoặc đối với các số thực vừa lớn vừa có phần thập phân. Để biết thêm thông tin, hãy xem Hướng dẫn kỹ thuật.
• Dữ liệu văn bản/chuỗi được sử dụng cho ID lô, điều kiện thực hiện giai đoạn hoặc cho các biến định tính. Các giá trị cho văn bản tag dữ liệu phân biệt chữ hoa chữ thường. Điều này có nghĩa là giá trị “đang chạy” không giống với
  “CHẠY”. Các biến Datetime không được SimApi hỗ trợ trực tiếp, nhưng chúng có thể được trả về dưới dạng chuỗi được định dạng là YY-MM-DD HH:MM (ví dụample “2020-09-07 13:45”).
• Giá trị bị thiếu có nghĩa là không có giá trị nào trả về, tức là không có dữ liệu.
• Kiểu dữ liệu trả về tùy thuộc vào triển khai SimApi. SimApi biết về dữ liệu trong nguồn dữ liệu và sẽ trả về kiểu dữ liệu phù hợp nhất.

Ba chế độ truy xuất dữ liệu: Liên tục, Batc,h và Rời rạc

• Đặc tả SimApi định nghĩa ba chế độ truy xuất dữ liệu, tức là ba cách khác nhau mà SimApi có thể cung cấp dữ liệu từ tags trong một nguồn dữ liệu (hoặc theo hướng khác: ghi dữ liệu vào tags trong một nguồn dữ liệu).
• Truy xuất dữ liệu liên tục – điều này đề cập đến dữ liệu được đọc liên tục và tuần tự, theo từng quan sát khi lô hoặc quy trình phát triển. Dữ liệu được đọc cho thời điểm hiện tại hoặc cho một phạm vi cụ thể, theo khoảng thời gian đều đặn giữa các lần quan sát. Ví dụample, tất cả dữ liệu giữa 09:00:00 và 10:00:00 sampđược thực hiện sau mỗi 60 giây, tạo ra 61 quan sát khi các điểm cuối bao gồm nhau.
• Truy xuất dữ liệu theo lô – điều này đề cập đến một quan sát duy nhất với dữ liệu cho toàn bộ lô (không liên quan đến thời điểm cụ thể hoặc độ chín). Thuộc tính lô và dữ liệu định tâm cục bộ được đọc dưới dạng dữ liệu lô trong SIMCA-online. Điều kiện lô thường cũng được đọc dưới dạng dữ liệu lô (trừ khi chúng được cấu hình để truy xuất dữ liệu rời rạc).
• Truy xuất dữ liệu rời rạc – dữ liệu rời rạc có thể bao gồm một số quan sát cho nhiều thời hạn. Nhưng không giống như dữ liệu liên tục, dữ liệu rời rạc không được đọc tuần tự mà là tất cả dữ liệu cùng một lúc cho một giai đoạn cụ thể của một lô. Dữ liệu không cần phải được phân cách với các khoảng thời gian đều đặn của biến thời hạn. Tất cả dữ liệu được đọc lại mỗi lần dữ liệu được yêu cầu, theo khoảng thời gian được cấu hình.
• Đối với bất kỳ tag dữ liệu có thể được yêu cầu ở bất kỳ chế độ nào trong ba chế độ, nhưng thông thường SimApi sẽ chỉ hỗ trợ một trong các chế độ này cho một cá nhân tag. Tương tự như vậy, nó được phép trộn tags trong một nút, nhưng thông thường tất cả tags trong một nút cụ thể hỗ trợ cùng một chế độ truy xuất dữ liệu.
• Đối với dữ liệu liên tục (nhưng không phải dữ liệu theo lô hoặc dữ liệu rời rạc2), có thể yêu cầu dữ liệu hiện tại hoặc dữ liệu lịch sử, đây là chủ đề của phần tiếp theo.
• Không phải tất cả SimApi đều hỗ trợ tất cả các chế độ. Xem ma trận tính năng ở trên và SimApi web trang để biết thêm chi tiết.

Dữ liệu liên tục hiện tại và lịch sử thông qua SimApi

• Dữ liệu liên tục đề cập đến dữ liệu quy trình thay đổi theo thời gian.

Dữ liệu hiện tại

• Đọc dữ liệu hiện tại có nghĩa là yêu cầu nguồn dữ liệu cung cấp các giá trị mới nhất của tags tại thời điểm hỏi. Lưu ý rằng thời gian của nguồn dữ liệu bên ngoài không được sử dụng ở đây.
• Dữ liệu được đọc dưới dạng dữ liệu hiện tại là những gì SIMCA-online sẽ hiển thị dưới dạng dữ liệu trực tiếp. Vì lý do này, điều quan trọng là không có sự chậm trễ không cần thiết trong nguồn dữ liệu. Dữ liệu hiện tại phải càng mới càng tốt để hoạt động tốt trong SIMCA-online.
• Nguồn dữ liệu có thể sử dụng kiến ​​thức về dữ liệu và thời gian giá trị có hiệu lực và quyết định trả về dữ liệu bị thiếu khi dữ liệu thô cho một thời điểm quá cũ. Ví dụ:ample: dữ liệu được yêu cầu lúc 15:00:00 nhưng điểm dữ liệu gần đây nhất trong nguồn dữ liệu là từ 03:00:00. Trong trường hợp này, dữ liệu đã cũ 12 giờ nên SimApi có thể quyết định trả về giá trị bị thiếu (không có dữ liệu).

Dữ liệu lịch sử

• Đọc dữ liệu lịch sử có nghĩa là yêu cầu nguồn dữ liệu cung cấp giá trị của một hoặc nhiều tags cho một khoảng thời gian cụ thể với khoảng thời gian cụ thể giữa các lần quan sát. Lưu ý rằng ở đây, thời gian cục bộ của nguồn dữ liệu được sử dụng để tìm dữ liệu. Do đó, việc đồng bộ hóa thời gian giữa nguồn dữ liệu và máy chủ là rất quan trọng.
• Dữ liệu lịch sử bao gồm một ma trận dữ liệu. Việc yêu cầu dữ liệu từ nguồn dữ liệu phụ thuộc vào việc triển khai SimApi vàamptheo khoảng thời gian đã chỉ định và xây dựng ma trận dữ liệu để trả về:
• Đôi khi nguồn dữ liệu tự nó có các hàm tổng hợp để trả về dữ liệu đã xử lý hoặcampcác hàm ling có thể được sử dụng để trả về dữ liệu phù hợp.
• Đối với các nguồn dữ liệu khác, SimApi phải yêu cầu tất cả dữ liệu trong phạm vi thời gian và sau đó sampđưa ra những quan sát đúng để xây dựng ma trận.
• Dữ liệu phải được trả về trong một khoảng thời gian, ngay cả khi có thể không có dữ liệu thô trong khoảng thời gian đó, nhưng chỉ ngay trước thời gian bắt đầu. Ví dụample: dữ liệu tồn tại trong nguồn dữ liệu tại thời điểm 10 và 20. SimApi yêu cầu dữ liệu cho thời điểm 15 và 17. Trong trường hợp này, các giá trị cho thời điểm 10 sẽ được trả về bởi SimApi nhưng timestampđược coi là thời điểm 15 và 17 vì đây là những điểm dữ liệu gần đây nhất tại thời điểm đó. Các giá trị cho tags tại thời điểm 10 được gọi là giá trị giới hạn cho phạm vi được yêu cầu. Để biết giải thích sâu hơn về giá trị giới hạn, hãy xem ví dụampđọc tài liệu hướng dẫn cho returnBounds tại UA Phần 11: Truy cập lịch sử – 6.4.3 Cấu trúc ReadRawModifiedDetails
  (opcfoundation.org)
• Nội suy không bao giờ được sử dụng để tính toán giá trị cho các điểm thời gian trong tương lai, vì dữ liệu sẽ không khớp với những gì được đọc theo thời gian thực như dữ liệu hiện tại. Đối với ví dụamptừ mục trước: nếu dữ liệu cho mục 15 và 17 được nội suy bằng cách sử dụng các giá trị cho mục 10 và 20, thì về cơ bản chúng sẽ sử dụng các giá trị từ tương lai, điều này là không được phép.
• Nguồn dữ liệu có thể sử dụng kiến ​​thức về dữ liệu và thời gian giá trị có hiệu lực và quyết định trả về dữ liệu bị thiếu khi dữ liệu thô cho một thời điểm quá cũ. Ví dụ:ample: dữ liệu được yêu cầu cho 15:00:00 nhưng điểm dữ liệu gần đây nhất trong nguồn dữ liệu là từ 03:00:00. Trong trường hợp này, dữ liệu đã cũ 12 giờ nên SimApi có thể quyết định trả về giá trị bị thiếu (không có dữ liệu).

Ghi chú: SIMCA-online thường không yêu cầu hơn một trăm quan sát trong một lần gọi trong quá trình thực hiện dự án thông thường. Khi thực hiện trích xuất trong SIMCA-online hoặc khi chạy SIMCA trên máy tính để bàn, có thể thực hiện các yêu cầu dữ liệu lớn hơn. Những yêu cầu này có thể mất nhiều thời gian, điều này là bình thường.

Dữ liệu hiện tại và dữ liệu lịch sử phải khớp nhau

• Đôi khi có thể có sự khác biệt khi dữ liệu được đọc là dữ liệu hiện tại theo thời gian thực hoặc dữ liệu lịch sử. Điều này gây ra sự cố trong SIMCA-online vì máy chủ tự động chuyển đổi giữa dữ liệu hiện tại và dữ liệu lịch sử khi cần.

Thu thập dữ liệu độ trễ thấp

• Khi một nguồn dữ liệu được SIMCA-online sử dụng theo thời gian thực, điều quan trọng là dữ liệu trong nguồn dữ liệu phải là dữ liệu hiện tại. Không được có sự chậm trễ không cần thiết nào trong quá trình thu thập dữ liệu trong nguồn dữ liệu. Dữ liệu quy trình liên tục cho tất cả các biến phải có sẵn cùng lúc cho mọi quan sát. Dữ liệu đến muộn đối với một số biến sẽ không được SIMCA-online thu thập.

Dữ liệu có thể được đọc bất cứ lúc nào 

• Khi SIMCA-online yêu cầu giá trị của tag đối với thời điểm t, nó sẽ nhận được giá trị từ nguồn dữ liệu từ thời điểm t, hoặc quan sát mới nhất trong nguồn dữ liệu trước thời điểm t, hoặc giá trị nội suy cho thời điểm t. Do đó, máy chủ sẽ luôn nhận được giá trị tại mỗi thời điểm nó yêu cầu, ngay cả khi quan sát cho thời điểm chính xác này có thể không tồn tại trong nguồn dữ liệu.
• Thời gianamptrong SimApi luôn là UTC. Máy khách SIMCA-online và SIMCA hiển thị thời gian theo giờ địa phương.

Xâu chuỗi 

• Theo mặc định, SimApi được gọi bằng một luồng duy nhất bởi người dùng SimApi. Điều này đúng với tất cả các phiên bản SIMCA và SIMCA-online cho đến phiên bản 17.
• SIMCA-online 18 hỗ trợ cờ tính năng để bật truy cập đa luồng thông qua SimApi. Đọc thêm trong chủ đề trợ giúp Truy cập SimApi đồng thời.
• Điều này có nghĩa là SimApis nên chuẩn bị cho đa luồng, nếu có thể, bằng cách làm cho luồng triển khai SimApi an toàn và ghi lại điều này cùng mọi cân nhắc cho người dùng SimApi.

Nhật ký file

• SimApi sẽ ghi lại các hành động, thông báo lỗi và cảnh báo vào nhật ký của nó file để giúp khắc phục sự cố. Sử dụng các mức nhật ký khác nhau để biểu thị tầm quan trọng của việc ghi nhật ký.
• Nên ghi vào ô “Chưa triển khai” cho những tính năng chưa được triển khai trong SimApi.

Xử lý lỗi

• Khi SimApi không thể thực hiện yêu cầu từ nguồn dữ liệu, nó có thể xử lý vấn đề này theo một trong hai cách; bằng cách trả về các giá trị bị thiếu (không có dữ liệu) hoặc bằng cách báo hiệu lỗi SimApi:
• Trả về các giá trị bị thiếu cho người gọi và báo hiệu thành công cho phép người gọi tiếp tục như bình thường (nhưng tất nhiên là không có dữ liệu nào). Đây là một thực hành được khuyến nghị cho các lỗi một phần như khi dữ liệu có thể thu được cho một số, nhưng không phải tất cả, tags trong một yêu cầu.
• Việc báo hiệu lỗi SimApi cho phép người gọi (ví dụ:ampmáy chủ SIMCA-online) để xem ngay lập tức và hành động. Đây là biện pháp được khuyến nghị cho các yêu cầu không thành công hoàn toàn và không thể trả về bất kỳ dữ liệu nào.
• SIMCA-online xử lý các giá trị bị thiếu hoặc mã lỗi theo cách khác nhau, như được mô tả trong Hướng dẫn kỹ thuật SIMCA-online.

Yêu cầu về hiệu suất của SimApi

• Các chức năng trong SimApi được sử dụng để lấy dữ liệu.
• Nếu truy cập dữ liệu chậm, SimApi sẽ không hoạt động tốt, ví dụ nàyample cho thấy: Nếu SIMCA-online yêu cầu dữ liệu mỗi giây nhưng phải mất hai giây để lấy được dữ liệu thì máy chủ SIMCA-online sẽ không bao giờ có thể theo kịp thời gian thực mà còn ngày càng tụt hậu.
• Trong các phần phụ, chúng tôi sẽ trình bày cách SIMCA và SIMCA-online sử dụng các hàm SimApi truy cập dữ liệu và tần suất các hàm SimApi sẽ được gọi. Điều này có thể giúp thiết lập các yêu cầu về hiệu suất cho việc triển khai SimApi.

Việc sử dụng các chức năng SimApi của SIMCA

• Khi SIMCA trên máy tính để bàn hoặc các sản phẩm ngoại tuyến khác sử dụng SimApi để lấy dữ liệu, các yêu cầu này sẽ dành cho các lô và xử lý dữ liệu cho một tập hợp các biến trong một khoảng thời gian nhất định.
• Vì những yêu cầu này được người dùng khởi tạo thủ công nên chúng không xảy ra thường xuyên và không gây quá tải đáng kể cho nguồn dữ liệu.
• Các hàm SimApi sau đây được sử dụng để lấy dữ liệu:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

Việc sử dụng các chức năng SimApi của SIMCA-online

• SIMCA-online được sử dụng để theo dõi thời gian thực của một quy trình và do đó nó yêu cầu dữ liệu thông qua SimApi theo các khoảng thời gian đều đặn. Khoảng thời gian thực hiện ngắn nhất có thể sử dụng là 1 giây. Một số ví dụ thực tếampKhoảng cách thực hiện là 10 giây, 1 phút hoặc 10 phút.
• Một máy chủ có thể chạy nhiều dự án cùng một lúc.
• Để giảm số lượng lệnh gọi API thông qua SimApi, máy chủ sẽ tối ưu hóa các yêu cầu dữ liệu bằng cách nhóm nhiều yêu cầu nhỏ đồng thời thành một yêu cầu lớn hơn cho tất cả các biến cùng một lúc (tìm hiểu thêm trong chủ đề trợ giúp 'Tối ưu hóa việc đọc từ nguồn dữ liệu giúp cải thiện hiệu suất').
• Thuật toán thực thi của máy chủ hoạt động như sau khi yêu cầu dữ liệu bằng các hàm SimApi được liệt kê bên dưới:
• Tất cả các giai đoạn thực hiện cùng một khoảng thời gian được nhóm vào một lệnh gọi SimApi duy nhất để giảm số lượng lệnh gọi. Máy chủ đọc dữ liệu mới nhất cho tất cả các biến được sử dụng bởi tất cả các mô hình chia sẻ khoảng thời gian, tức là lệnh gọi này sẽ tạo ra một hàng dữ liệu rộng sau đó được sử dụng bởi tất cả các dự án.
  • simapi2_connectionĐọcDữliệuHiệntại
• Đối với mỗi dự án hàng loạt, máy chủ cũng cần biết những lô nào đang hoạt động. Điều này cũng cần xảy ra mỗi khi một dự án thực thi:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes được gọi ít thường xuyên hơn.
• Ngoài ra, SIMCA-online cũng yêu cầu dữ liệu lịch sử. Những yêu cầu này chỉ xảy ra khi cần thiết, chẳng hạn như bắt kịp phần đầu của một lô đã bắt đầu trước khi SIMCA-online được khởi động hoặc khi máy chủ bị chậm và cần đọc một khối dữ liệu:
  • simapi2_connectionReadHistoricalDataEx
• Tùy chọn, một số cấu hình dự án sử dụng các tính năng sử dụng dữ liệu hàng loạt hoặc dữ liệu rời rạc dẫn đến các lệnh gọi SimApi tới:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Tùy chọn, một số cấu hình dự án sử dụng write-back để đẩy dữ liệu trở lại nguồn dữ liệu:
  • simapi2_connectionWriteHistoricalDataEx (và các hàm tương ứng cho dữ liệu hàng loạt, dữ liệu rời rạc)
• Điều quan trọng là mỗi lệnh gọi đến các hàm cốt lõi để lấy dữ liệu, readCurrentData, getActiveBatches/getBatchTimes, đều phải nhanh và không gây khó khăn về mặt tính toán cho chính nguồn dữ liệu, xét đến tần suất SIMCA-online có thể gọi các hàm đó.

Kiểm tra và xác thực dữ liệu SimApi

• Phần này nói về việc kiểm tra SimApi để xác minh rằng dữ liệu trả về từ nó khớp với dữ liệu trong chính nguồn dữ liệu. Việc chạy các bài kiểm tra như thế này rất quan trọng sau khi tạo hoặc thay đổi triển khai SimApi hoặc khi API của nguồn dữ liệu thay đổi.
• Trong thực tế, xác thực dữ liệu được thực hiện bằng SIMCA-online và chức năng Trích xuất của nó để kéo dữ liệu từ nguồn dữ liệu thông qua SimApi và sau đó so sánh với dữ liệu thô trong nguồn dữ liệu. Không thể sử dụng SIMCA trên máy tính để bàn để kiểm tra các khía cạnh thời gian thực của SimApi.

Chuẩn bị và yêu cầu

• Một số mục là tùy chọn nhưng có thể thực hiện nếu phạm vi thử nghiệm của bạn bao gồm:

1. Cài đặt SIMCA-online như mô tả trong ReadMe và Hướng dẫn cài đặt.pdf có trong tệp zip của sản phẩm.
2. Nhận giấy phép cho máy chủ SIMCA-online và cài đặt nó. SimApi sẽ không hoạt động nếu không có giấy phép. Bài viết cơ sở kiến ​​thức về SIMCA-online cho biết cách cấp phép cho sản phẩm. Ví dụample: SIMCA-online 18 (sartorius.com)
3. Cài đặt và cấu hình SimApi bạn muốn kiểm tra. Tham khảo chương 4 – 5 trong tài liệu này và hướng dẫn sử dụng của SimApi cụ thể.
   • a. Tùy chọn: đảm bảo hướng dẫn sử dụng được cập nhật và chính xác.
4. Hãy đảm bảo bạn có một công cụ cho nguồn dữ liệu của mình mà bạn có thể sử dụng để so sánh dữ liệu SimApi.
5. Trong máy khách SIMCA-online, hãy đăng nhập vào máy chủ SIMCA-online của bạn và sử dụng File > Trích xuất để lấy dữ liệu thông qua SimApi.
6. Tùy chọn nếu phạm vi thử nghiệm của bạn bao gồm: sau khi hoàn tất thử nghiệm, hãy gỡ cài đặt SimApi và xác minh nó files được loại bỏ.

Cần kiểm tra những gì

• Ma trận tính năng trong chương 3 liệt kê tất cả các tính năng có thể, nhưng một triển khai SimApi nhất định chỉ có thể hỗ trợ một tập hợp con. Bạn nên kiểm tra tất cả các tính năng được triển khai bởi SimApi nhất định.
• Các bài kiểm tra sau đây là phổ biến đối với hầu hết các triển khai SimApi:
• Xác thực bằng tên người dùng và mật khẩu
• Kiểm tra các thiết lập khác nhau trong cấu hình của SimApi
• Hệ thống phân cấp nút: Các nút và tags được SimApi tiết lộ là chính xác.
  • Phải có một tag được hiển thị cho tất cả các “biến” có thể có thông qua SimApi. Ví dụamples: phép đo quy trình, giá trị tính toán, hằng số.
• Khả năng phục hồi kết nối: nếu nguồn dữ liệu không khả dụng, điều này sẽ dẫn đến cảnh báo hoặc lỗi trong nhật ký filenhưng kết nối với nguồn dữ liệu sẽ được tự động thiết lập lại khi nguồn dữ liệu khả dụng.
• Nhiều phiên bản: hai phiên bản có thể được cấu hình và sử dụng độc lập và đồng thời, với các nhật ký riêng biệt files.
• Dữ liệu hiện tại: trích xuất dữ liệu hiện tại cho tags. Đảm bảo dữ liệu là giá trị cuối cùng được biết từ nguồn dữ liệu hoặc bị thiếu do chất lượng kém hoặc khi dữ liệu quá cũ.
  • Trích xuất dữ liệu cứ sau 10 giây (hoặc lâu hơn) trong một phút.
• Dữ liệu liên tục lịch sử: trích xuất dữ liệu lịch sử cho tags.
  • Sử dụng phạm vi thời gian khớp với thời điểm bạn trích xuất dữ liệu hiện tại. Xác minh rằng dữ liệu hiện tại khớp với dữ liệu lịch sử và dữ liệu thô trong nguồn dữ liệu.
  • Hãy thử các khoảng thời gian khác nhau vàampKhoảng thời gian, xác minh dữ liệu khớp với nguồn dữ liệu.
  • Hãy thử trích xuất dữ liệu sau mỗi 1 giây, đây là khoảng thời gian ngắn nhất có thểampkhoảng thời gian ling.
  • Hãy thử nhiều loại khác nhau tags trong nguồn dữ liệu (biến quy trình, v.v.), đảm bảo dữ liệu khớp nhau.
  • Lưu ý: SIMCA-online có thể chia một yêu cầu dữ liệu lịch sử lớn thành nhiều phần nhỏ hơn. Điều này sẽ hiển thị trong nhật ký SimApi.
• Xác minh rằng SimApi hoạt động với dữ liệu văn bản, dữ liệu số và dữ liệu bị thiếu.
• Nhật ký SimApi file. Xác minh rằng nhật ký chứa các mục hợp lý.
• Nút hàng loạt: nhấp chuột phải vào một nút và chọn Tìm hàng loạt.
  • Xác minh tên lô, thời gian bắt đầu, thời gian kết thúc của các lô.
  • Hãy thử một lô đang hoạt động đang chạy trong nguồn dữ liệu. Nó không nên có thời gian kết thúc thông qua SimApi.
• Mã định danh hàng loạt nút xử lý tag. Nếu SimApi có chức năng nút hàng loạt (xem mục trước), nó cũng phải có một mã định danh hàng loạt tag trong nút dữ liệu quá trình khớp. Dữ liệu cho điều này tag phải là mã định danh lô (tên lô). Dữ liệu này là bắt buộc đối với các dự án lô để xác định một hàng dữ liệu thuộc về lô nào.

Tùy thuộc vào việc SimApi có hỗ trợ hay không, bạn cũng có thể muốn kiểm tra:

• Dữ liệu hàng loạt sử dụng File > Trích xuất.
• Dữ liệu rời rạc sử dụng File > Trích xuất. Lưu ý: để kiểm tra dữ liệu rời rạc với File > Trích xuất nút, nút hàng loạt và nút dữ liệu rời rạc phải nằm trong cùng một SimApi (khi SIMCA-online thực thi các dự án, chúng có thể nằm từ các SimApi khác nhau).
• Viết lại – đẩy dữ liệu hàng loạt vào nguồn dữ liệu. Để kiểm tra điều này, bạn phải cấu hình cấu hình dự án trong SIMCA-online để ghi lại các vectơ dữ liệu vào nguồn dữ liệu. Sau đó, thực hiện dự án trong SIMCA-online và kiểm tra dữ liệu được ghi lại trong nguồn dữ liệu.
• Dữ liệu liên tục được cấu hình trên trang Evolution Write Back trong cấu hình dự án.
• Dữ liệu rời rạc được cấu hình trên cùng một trang, nhưng chỉ dành cho một pha được cấu hình để truy xuất dữ liệu rời rạc.
• Dữ liệu hàng loạt từ Batch Write back

THÔNG TIN THÊM

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Thụy Điển
• Điện thoại: + 46 90-18 48 00
• www.sartorius.com
• Thông tin và số liệu trong các hướng dẫn này tương ứng với ngày phiên bản được chỉ định bên dưới.
• Sartorius có quyền thay đổi công nghệ, tính năng, thông số kỹ thuật và thiết kế của thiết bị mà không cần thông báo trước. Các hình thức nam tính hoặc nữ tính được sử dụng để tạo điều kiện dễ đọc trong các hướng dẫn này và luôn biểu thị đồng thời tất cả các giới tính.
  Thông báo bản quyền:
• Những hướng dẫn này, bao gồm tất cả các thành phần, được bảo vệ bản quyền.
• Bất kỳ việc sử dụng nào vượt quá giới hạn của luật bản quyền đều không được phép nếu không có sự chấp thuận của chúng tôi.
• Điều này đặc biệt áp dụng cho việc in lại, dịch thuật và biên tập bất kể loại phương tiện nào được sử dụng.

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

• H: Mục đích của SimApis là gì?
  • A: Mục đích chính của SimApis là cung cấp dữ liệu cho các sản phẩm Umetrics Suite để tạo dự án và xây dựng mô hình.
• H: Tôi có thể khắc phục sự cố khi cài đặt SimApi như thế nào?
  • A: Bạn có thể khắc phục sự cố bằng cách kiểm tra từ SIMCA-online, kiểm tra nhật ký SimApi filevà đảm bảo cấu hình tài khoản dịch vụ chính xác.

Tài liệu / Tài nguyên

Phần mềm SARTORIUS Sim Api [tập tin pdf] Hướng dẫn sử dụng Phần mềm Sim Api, Phần mềm Api, Phần mềm

Tài liệu tham khảo

• Hướng dẫn sử dụng