SARTORIUS Sim Api 소프트웨어 사용자 가이드

내용물 숨다

1 SARTORIUS Sim Api 소프트웨어

2 SimApis 소개

7 SimApis에 대한 기술적 세부 사항

SARTORIUS Sim Api 소프트웨어

명세서

제품 이름: SimApi 가이드
출시일: 5년 2024월 XNUMX일
목적: Umetrics Suite 제품에 데이터 제공

제품 사용 지침

SimApis 소개

SimApis는 Umetrics Suite 제품에서 프로젝트 생성 및 모델 구축을 위해 데이터를 검색하는 데 사용됩니다.

SimApis 얻기

SimApis를 얻으려면 공식 문서를 참조하거나 고객 지원팀에 문의하여 도움을 받으세요.

SimApi 기능

SimApis는 SIMCA 및 SIMCA-online에서 모니터링, 제어, 모델 구축을 위한 실시간 데이터를 제공합니다.

현재 데이터 사용량만

최적의 성능을 위해 과거 데이터는 피하고 현재 데이터만 사용하는 것이 좋습니다.

SimApi 설치 준비

설치하기 전에 시스템이 사용자 안내서에 명시된 최소 요구 사항을 충족하는지 확인하세요.

SimApi 설치

사용자 설명서에 제공된 단계별 지침에 따라 시스템에 SimApi를 설치하세요.

SIMCA를 위한 SimApi 설정

제공된 가이드라인에 따라 SIMCA에서 SimApi 설정을 구성합니다.

SIMCA-online을 위한 SimApi 설정

SIMCA-online에서 실시간 데이터 검색 및 다시 쓰기 작업을 위해 SimApi를 설정합니다.

테스트 및 문제 해결

설치 후 테스트를 수행하여 적절한 기능을 보장합니다. 문제가 있는 경우 사용자 가이드의 문제 해결 섹션을 참조하세요.

SIMCA-online에서 테스트

SIMCA-online에서 SimApi 통합을 테스트하여 데이터 검색을 확인하세요.

로그를 사용한 문제 해결 Files

SimApi 로그를 사용하세요 file 설치 및 운영상의 문제를 파악하고 해결합니다.

서비스 계정 구성

원활한 운영을 위해 SIMCA-online 서비스 계정이 올바르게 구성되었는지 확인하세요.

기술적 세부 사항

SimApis에 대한 자세한 기술 정보는 사용자 가이드의 섹션 7을 참조하세요.

SimApis 소개

SimApi는 Umetrics® Suite 소프트웨어와 데이터 소스 간의 소프트웨어 인터페이스입니다. SimApi의 주요 목적은 SIMCA®-online 또는 SIMCA®에 데이터를 제공하는 것입니다.
Sartorius Stedim Data Analytics AB는 프로세스 이력 관리 및 범용 데이터베이스 등 다양한 데이터 소스를 위한 SimApis를 개발합니다.
이 문서에서는 SimApi가 무엇이고 Umetrics Suite 제품에서 어떻게 사용되는지 보여줍니다. SimApi를 계획하고 설치하는 방법, 문제 해결 방법 및 설치 테스트 방법을 알아봅니다. 마지막 장에는 개발자를 대상으로 하는 SimApi의 기술적 세부 정보가 포함되어 있습니다.

SimApi 목적: Umetrics Suite 제품에 데이터 제공

SimApi의 주요 목적은 데이터 소스에서 SIMCA-online 또는 SIMCA에 데이터를 제공하는 것입니다. 데이터 소스는 SIMCA-online의 일부가 아니지만 데이터를 보관하고 관리하는 프로세스 히스토리언 또는 기타 시스템이 될 수 있습니다.
SimApi는 폴더에 해당하는 노드 계층을 노출합니다. file 시스템. 각 노드는 다른 노드를 포함할 수 있습니다. tags. 아 tag 변수에 해당합니다. 이것들에 대해 tags, 데이터를 얻을 수 있습니다. 그림은 tag, Temp, 노드에서 선택됨
SIMCA-online의 데이터 소스에 있는 BakersYeastControlGood. 또한 데이터 소스에서 가져온 최신 값을 보여줍니다.

Umetrics Suite에서의 SimApi 사용

데스크톱 소프트웨어 SIMCA는 다음 그림과 같이 SimApi를 사용하여 프로젝트 생성 및 모델 구축을 위한 데이터를 검색할 수 있습니다.
SIMCA-online은 SimApis를 사용하여 모니터링 및 제어를 위한 실시간 데이터를 얻고, 데이터 소스에 데이터를 다시 씁니다. 다음 그림은 데이터 소스, SIMCA-online 서버, 클라이언트로 구성된 시스템에서 SimApi가 어디에 있는지 보여줍니다.

일반적으로 사용되는 SimApis

가장 널리 사용되는 SimApi는 다음과 같습니다.
Aveva(구 OSIsoft) PI 시스템에 연결하기 위한 PI AF SimApi.
OPC UA SimApi
ODBC SimApi – SQL Server 또는 Oracle과 같은 데이터베이스에 대한 일반적인 액세스를 위해
사용 가능한 모든 SimApi는 3항에 해당 기능과 함께 나열되어 있습니다.

시뮬레이션 데이터를 위한 DBMaker SimApi

DBMaker는 SIMCA-online 서버 설치와 함께 제공되는 애플리케이션입니다. 사전 로드된 데이터 테이블을 사용하여 프로세스 히스토리언과 같은 데이터 소스를 시뮬레이션합니다. 여기서 관찰은 DBMaker SimApi를 통해 SIMCA-online에 하나씩 제공됩니다.
DBMaker는 데모 목적으로만 사용되며 데이터 소스의 라이브 데이터로 프로덕션에서 사용할 수 없습니다. DBMaker에 대해 자세히 알아보려면 기본 제공 도움말을 참조하세요.

추가 문서

이 문서는 각각 다른 초점과 대상 독자를 가진 관련 문서 세트 중 하나입니다.

원천	무엇	어디
SIMCA-온라인 web 페이지	소개 정보 및 다운로드	사토리우스닷컴/유메트릭스-심카- 온라인

SIMCA-online ReadMe 및 설치.pdf	SIMCA 설치 및 시작 방법 - 온라인 데모 데이터	설치 zip에서 file
SIMCA-online 구현 가이드	SIMCA-online 기능을 간략하게 설명하고, 다른 Umetrics Suite 소프트웨어와 비교하며, 성공적인 배포를 위한 요구 사항과 모범 사례, 단계별 설치 지침을 설명합니다.	사토리우스닷컴/유메트릭스-심카- 온라인
SimApi 가이드	SimApi 설치 준비 및 수행, 문제 해결 포함. 또한 개발자를 위한 SimApis에 대한 기술적 세부 정보도 포함되어 있습니다.	사르토리우스닷컴/유메트릭스-시마피
SimApi 사용자 가이드	각 게시된 SimApi에 대한 기능, 설치 지침, 구성 세부 정보가 담긴 문서입니다.	사르토리우스닷컴/유메트릭스-시마피
SIMCA-online 기술 가이드	SIMCA-online 서버 설치 계획, 문제 해결 및 SIMCA-online 작동 방식에 대한 자세한 내용을 담은 기술 참조 자료입니다.	사토리우스닷컴/유메트릭스-심카-온라인
SIMCA-온라인 도움말	WebSIMCA-online의 사용 방법과 SIMCA-online의 작동 방식에 대한 도움말입니다.	소프트웨어 자체 및 사토리우스닷컴/유메트릭스-심카
SIMCA-온라인 Web 클라이언트 설치 가이드	SIMCA-online 설치에 대해 설명합니다. Web 고객.	사토리우스닷컴/유메트릭스-심카-온라인
Umetrics 지식 기반	Umetrics Suite 제품의 각 릴리스된 소프트웨어 버전, 기술 문서 및 알려진 문제에 대한 문서가 포함된 검색 가능한 데이터베이스입니다.	사토리우스닷컴/유메트릭스-kb
SIMCA 도움말/사용자 가이드	데스크톱 SIMCA를 사용하여 프로젝트를 만들고 데이터를 모델링하는 방법.	SIMCA 및 기타 사토리우스닷컴/유메트릭스-심카
지원하다 web 페이지	기술 지원을 받는 방법.	sartorius.com/umetrics-support

기술 지원

Sartorius 온라인 지원팀은 SimApis에 대한 기술적인 질문에 답변하고 SimApis 향상 요청을 적절한 사람에게 전달할 수도 있습니다. 자세한 내용은 다음에서 확인하세요. sartorius.com/umetrics-support.

SimApis 얻기

사용 가능한 SimApi에 대한 문서와 설치 프로그램 링크를 제공합니다. 사르토리우스닷컴/유메트릭스-시마피.
각 SimApi는 사용자 가이드에 설명되어 있습니다.
지금 읽고 계신 SimApi 가이드는 SimApi 계획, 설치, 문제 해결과 관련된 SimApi 보완 정보로 해당 정보를 보완합니다.

SimApi 기능

모든 데이터 소스가 동일한 것은 아닙니다. SimApi는 사양의 모든 기능을 구현할 필요가 없습니다. 이러한 이유로 다른 SimApi는 다른 기능을 제공합니다. 다음 매트릭스는 사용 가능한 SimApi와 해당 기능을 나열합니다.
아래에 기능이 설명되어 있습니다. 표에는 SIMCA-online과 SIMCA에서 각각 사용 가능한 기능을 보여주는 별도의 열이 있습니다.

특징	목적	SIMCA-online 사용법	SIMCA 사용법
현재의 데이터	데이터 소스에서 가장 최신 값을 사용하여 단일 관찰 결과를 읽습니다.	실시간 정상 실행	–
역사적 데이터	데이터 소스의 과거 데이터와 함께 여러 관찰 결과를 한 번에 읽습니다.	과거 데이터를 따라잡고 예측하고 이를 사용하여 프로젝트를 만듭니다. File > 새로운	모델 생성을 위해 프로세스 데이터를 가져오는 데이터베이스 가져오기 마법사입니다.
이산 데이터	데이터 소스에서 실험실/IPC 데이터를 읽습니다. 배치당 많은 관찰.	개별 데이터 검색을 위해 구성된 단계 또는 배치 조건이 있는 배치 프로젝트의 경우.	–
배치 데이터	배치 조건 및 최종 품질 속성을 읽습니다(또는	배치 조건 또는 로컬 센터링.	일괄 처리 조건을 읽기 위한 데이터베이스 가져오기 마법사

특징	목적	SIMCA-online 사용법	SIMCA 사용법
	다른 MES 유형 데이터). 배치당 하나의 관찰.		배치 수준 모델 생성.
배치 노드	특정 배치에 대한 시작 시간과 종료 시간(활성 배치의 경우 비어 있음)을 지정합니다. 시간 범위 내에 존재했던 모든 배치를 열거합니다.	배치 구성 실행에 필요합니다.	데이터베이스 가져오기 마법사를 사용하여 가져올 배치를 선택합니다.
다시 쓰기 – 연속 데이터	예측과 같은 연속 데이터를 데이터 소스에 다시 씁니다.	Control Advisor 또는 연속 구성을 위해 배치 진화 수준에서 데이터를 다시 씁니다.	–
다시 쓰기 – 개별	예측 등의 개별 데이터를 데이터 소스에 다시 씁니다.	불연속 데이터 검색을 위해 구성된 단계에 대한 배치 진화 수준에서 배치 구성을 다시 작성합니다.	–
다시 쓰기 – 일괄 데이터	예측이나 최종 품질 속성과 같은 배치 수준 데이터를 데이터 소스에 다시 씁니다.	배치 수준에서 배치 구성을 위해 다시 쓰기	–
노드 계층	SimApi는 노드 계층을 지원합니다. file 시스템. 각 노드에는 다음이 포함될 수 있습니다. tags 및 기타 노드. 계층 구조는 많은 수의 노드를 관리하기 쉽게 만듭니다. tags.	모든 장소에서 지원됨 tags 사용됩니다.
정렬 tag 확장	배열 tag 여러 값을 저장합니다. SimApi는 배열을 확장합니다. tag 많은 개인에게 tags, 배열의 각 요소마다 하나씩.	지원되는 곳 tags 연속 데이터에 사용됩니다. 각각 확장됨 tag SIMCA 프로젝트의 변수에 매핑되어야 합니다.
다중 데이터 소스	SimApi는 하나 이상의 데이터 소스에 연결하거나 개별 설정 및 로그를 사용하여 자체의 여러 인스턴스를 지원할 수 있습니다. file각 인스턴스에 대한 s.	동일한 종류의 여러 데이터 소스에 연결합니다.	–
연결 복원력	SimApi가 데이터 소스에서 연결이 끊어지면 자동으로 연결을 다시 설정하려고 시도합니다.	SimApi를 다시 시작하지 않아도 데이터 소스에 대한 연결을 다시 설정할 수 있습니다.	–
사내에서 개발	SimApi는 다음에 의해 개발, 제공 및 지원됩니다.

과거 데이터 없이 현재 데이터만 사용하는 것은 권장되지 않습니다.

일부 SimApi, 특히 OPC DA는 현재 데이터만 읽고, 과거 데이터는 읽을 수 없습니다.
현재 데이터만 지원하는 SimApi는 데스크톱 SIMCA에서 사용할 수 없습니다. 모델을 구축하는 데 사용할 수 있는 과거 데이터를 읽을 수 없기 때문입니다.
SIMCA-online의 경우, 실시간 실행을 위한 현재 데이터뿐만 아니라 과거 데이터를 예측하고 따라잡을 수 있는 과거 데이터도 제공하는 데이터 소스와 SimApi를 강력히 권장합니다. SIMCA-online은 필요에 따라 실시간 데이터와 과거 데이터 사이를 자동으로 전환하며, 이는 끌 수 없습니다.
현재 데이터만 제공하고 과거 데이터는 제공하지 않는 데이터 소스는 SIMCA-online의 연속 프로젝트에서는 사용할 수 있지만, 배치 프로젝트의 경우 과거 데이터가 필요합니다.

SimApi 설치 준비

이 섹션에서는 SimApi를 성공적으로 설치하는 데 필요한 중요한 정보를 설명합니다.

64비트 또는 32비트 SimApis

각 SimApi에는 32비트와 64비트 버전이 있습니다.
SIMCA-online과 SIMCA는 64비트이며 64비트 SimApis 변형이 필요합니다. 레거시 32비트 SimApis는 이전 설치에서 여전히 사용할 수 있습니다.

로그 위치 file 및 설정

SimApi는 로그를 저장합니다. file숨겨진 프로그램 데이터 폴더1에 있음:
%programdata%\Umetrics\SimApi, 여기서 %programdata%는 컴퓨터의 실제 폴더에 매핑됩니다. 기본값은 C:\ProgramData입니다.
각 SimApi는 일반적으로 자체 로그를 사용합니다. file, SIMCA-online 서버 로그와 유사합니다. file 로그 수준 설정에 따라 더 많거나 적은 데이터가 포함됩니다. file 문제 해결에 유용합니다. 로그 file 이름이 지정됨
.log 어디 예를 들어 설치 중인 SimApi는 다음과 같습니다.ample PIAFSimApi. SIMCA-online SimApi 인스턴스 이름에 대한 다음 섹션도 참조하세요.
이 폴더에는 XML 형식의 SimApi 설정도 포함되어 있습니다. file 명명된 .xml 파일입니다.
대부분의 SimApi에는 xml의 설정을 변경하는 그래픽 사용자 인터페이스가 있습니다. file하지만 일부의 경우 XML에 직접 변경 사항을 입력해야 합니다. file 메모장과 같은 텍스트 편집기로. 각 SimApi에 대한 사용자 가이드를 참조하세요.

File SIMCA-online에서 명명된 인스턴스가 사용될 때의 이름

SIMCA-online에서 각 SimApi 인스턴스는 자체 구성을 얻습니다. file 그리고 로그 file 각 SimApi의 여러 인스턴스와 함께 작업합니다. 이러한 인스턴스의 이름은 files에는 SIMCA-online 서버 옵션 대화 상자의 SimApi 탭에서 지정한 인스턴스 이름이 접미사로 붙습니다.
다음 예ample는 이것들의 이름을 보여줍니다 files, 어디 SimApi 이름으로 바꿔야 합니다.
인스턴스가 추가될 때 제공되는 구성 이름: OmegaServer
구성 file 이름: 오메가서버.xml
통나무 file 이름: 오메가서버.로그
일반적인 file .통나무 file 여전히 생성 중입니다. 이 로그 file 기술적 이유로 로그로 전송할 수 없는 항목이 포함되어 있습니다. file 인스턴스의..
이 폴더는 기본적으로 Windows에서 숨겨져 있습니다. 보려면 File 탐색기에서 숨겨진 항목을 표시하도록 구성합니다. files. 주소를 입력하면 숨겨진 폴더로 이동할 수 있습니다. File 탐색기의 주소창.
SIMCA는 SimApi의 여러 인스턴스를 지원하지 않으므로 위에 설명한 대로 인스턴스 이름이 없는 이름을 사용합니다.

네트워크 계획

SIMCA-online 서버는 네트워크의 데이터 소스 근처에 위치해야 합니다. 이렇게 하면 SIMCA-online과 데이터 소스 간의 빠른 연결이 보장됩니다.
네트워크 장비가 SIMCA-online과 데이터 소스 간의 연결을 방해할 수 있습니다.

사용자 계정 및 데이터 소스 권한

데이터 소스는 일반적으로 데이터에 대한 액세스를 제어합니다. 이는 일반적으로 사용자 이름과 비밀번호로 수행되지만 IP 주소 또는 DNS 기반 제한도 사용할 수 있습니다(예:amp(Aveva PI System의 PI 신탁)
사용자 이름과 비밀번호는 다양한 방법으로 데이터 소스에 제공될 수 있습니다.
SimApi는 데스크톱 SIMCA를 실행하는 사용자의 Windows 사용자 또는 서버 컴퓨터의 SIMCA-online 서비스 계정으로 실행됩니다. SimApi는 이 계정을 사용하여 데이터 소스에 연결할 수 있습니다. 이것이 OPC I, PI SimApi가 작동하는 방식이며, 구성할 때 자격 증명을 제공하지 않으면 ODBC입니다.
일반 ODBC의 경우 Windows 시작 메뉴에서 찾을 수 있는 ODBC 데이터 원본 관리자 애플리케이션을 사용할 수 있습니다.
일부 데이터베이스 제공자는 자체 데이터베이스에 대한 드라이버와 도구를 제공합니다. 예를 들어 Oracle 데이터베이스는ampOracle Data Access Components(ODAC)를 사용하세요.
PI AF 및 ODBC와 같은 일부 SimApi에는 SimApi XML 구성에 암호화된 자격 증명을 저장하는 구성 대화 상자가 있습니다. file.
PI는 또한 PI 서버 컴퓨터의 PI System Management Tools에서 사용할 수 있는 다양한 보안 옵션을 제공합니다. PI AF SimApi 사용자 가이드에서 자세히 읽어보세요. 이 가이드는 이전 OSIsoft PI SimApi를 사용하더라도 유용합니다.
OPC DA와 HDA는 데이터 소스와 SimApi 간의 전송으로 DCOM을 사용합니다. DCOM은 Windows의 구성 요소 서비스 도구(DCOMCNFG.EXE)로 구성되며 Windows 인증을 사용합니다.
이전 OSIsoft PI SimApi(최신 AF SimApi 아님)의 경우 OSIsoft AboutPI-SDK 애플리케이션(PISDKUtility.exe)을 사용하여 PI 서버와의 연결을 설정합니다.

데이터 소스 연결 확인
컴퓨터에 SimApi를 설치하려는 경우 다른 도구를 사용하여 해당 컴퓨터에서 데이터 소스로의 연결을 확인하는 것이 유용할 수 있습니다.

Windows의 ODBC 데이터 소스는 일반 ODBC를 구성하고 테스트하는 데 사용됩니다. 64비트 Windows에는 이 도구의 두 가지 버전이 있습니다. 하나는 32비트 애플리케이션용이고 다른 하나는 64비트용입니다. ODBC 구성 마법사의 끝에 있는 데이터 소스 테스트 버튼을 사용하여 데이터베이스 연결을 확인합니다. 데이터 소스를 시스템 DSN으로 구성하는 것이 좋습니다.
Oracle Data Access Components와 같은 데이터베이스 공급업체가 제공하는 데이터베이스별 연결 도구입니다.
PI System Explorer는 PI AF 서버에 대한 연결을 테스트하는 데 사용할 수 있습니다. PI AF SimApi의 전제 조건인 PI AF 클라이언트의 일부입니다.
Unified Automation의 OPC UA Expert – UaExpert는 OPC UA 서버를 위한 크로스 플랫폼 테스트 클라이언트입니다.
PI-SDK 애플리케이션(PISDKUtility.exe)을 사용하여 연결을 테스트하고 view SIMCA-online이 PI 서버에 연결하려고 할 때 기록되었을 수 있는 모든 오류 메시지. 이는 PIAF가 아닌 이전 OSIsoft SimApi에만 사용됩니다.
PI 시스템 관리 도구는 PI 서버 컴퓨터에서 해당 측면에서 문제를 해결하는 데 사용됩니다. 예를 들어ample, SIMCA-online 서버에서 액세스를 방해하는 보안 문제를 찾습니다. 이 YouTube 비디오에서 PI 시스템 문제 해결에 대해 자세히 알아보세요.
적절한 플러그인이 설치된 경우 Excel을 사용하여 ODBC 연결 및 대부분의 다른 시스템에서 데이터를 가져올 수 있습니다.
Matrikon OPC Explorer for Ior HDA(이들은 별도의 도구)를 사용하여 OPC 연결을 테스트할 수 있으며 Matrikon OPC Analyzer를 사용하여 OPC 연결 문제를 진단할 수 있습니다. 다음에서 이러한 무료 도구를 다운로드하세요. https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
OPC 교육 연구소의 OPC 구조(DInd HDA용) web 사이트 "사용자가 통신 및 보안 문제를 쉽게 진단하고 버튼을 눌러 즉시 복구할 수 있습니다. 이 모든 작업은 DCOM을 구성하는 방법을 배우지 않고도 수행할 수 있습니다."

SimApi 설치

PC에 SimApi를 설치하는 방법은 다음과 같습니다.

설치 중인 SimApi에 대한 사용자 가이드를 읽어보세요. 여기에는 지금 읽고 있는 일반적인 지침을 보완하는 해당 SimApi에 대한 세부 정보가 포함되어 있습니다.
SimApi 사용자 가이드에 언급된 모든 필수 구성 요소를 설치하고 구성합니다(예:ample 데이터베이스 드라이버 또는 SDK)
설치 프로그램을 실행하여 SimApi를 설치합니다. 실행할 소프트웨어에 맞는 64비트(x64) 또는 32비트(x86) 버전을 설치합니다.
다음 섹션에 설명된 대로 SIMCA-online 또는 SIMCA에서 SimApi를 구성하고, 사용 가능한 설정에 대한 설명은 SimApi 사용자 가이드를 참조하세요.
SIMCA-online 서버를 시작합니다. SimApi가 초기화되면 모든 것을 열거하기 때문에 시간이 걸릴 수 있습니다. tags 데이터 소스에서.
일부 데이터를 얻어 SimApi를 테스트합니다. SIMCA-online의 경우 다음을 사용할 수 있습니다. File > 6.1에 설명된 대로 추출합니다.
SimApi가 예상대로 작동하지 않으면 SimApi 로그를 참조하세요. file문제 해결을 위한 s 및 SimApi 사용자 가이드를 참조하세요.

SIMCA에서 사용하기 위한 SimApi 설정

SIMCA에서 SimApi를 사용하는 방법은 다음과 같습니다.

다음 방법 중 하나로 데이터베이스 가져오기를 시작하세요.
- a. SIMCA에서 새 프로젝트를 생성하려면: File > 새 일반 프로젝트 또는 새 배치 프로젝트. 홈 탭에서 데이터베이스에서 선택.
- b. SIMCA에서 기존 프로젝트의 데이터 세트를 가져오려면: 열려 있는 SIMCA 프로젝트의 데이터 탭에 있는 데이터 세트에서.
새 데이터 소스 추가를 클릭하세요
연결 유형으로 SimApi를 선택하고 … 버튼을 클릭한 다음 다음을 찾습니다. 설치 폴더에 .dll을 넣고 열기를 클릭합니다.
구성을 클릭하고 설정 방법은 개별 SimApi 사용자 가이드를 참조하세요.
테스트 데이터 소스 연결을 클릭하여 데이터베이스에 연결할 수 있는지 확인합니다. 많은 데이터가 있는 경우 시간이 오래 걸릴 수 있습니다. tags 데이터 소스에서.
확인을 클릭하여 구성을 완료합니다.
가져온 데이터를 사용하는 방법은 SIMCA 도움말을 참조하세요.

SIMCA-online에서 사용하기 위한 SimApi 설정

중요: SimApi를 사용하려면 SIMCA-online 서버 라이선스가 필요합니다. SIMCA-online 데모 설치에서는 SimApis를 사용할 수 없습니다.
시스템에 SimApi를 추가하려면 서버 PC에서 SIMCA-online Server Options를 실행합니다. SICMA-online 도움말 항목 Add and configure a SimApi on the server에서 자세한 단계를 알아보세요.
팁: SimApi를 변경한 경우 전체 서버를 다시 시작하지 않고도 서버 옵션에서 해당 SimApi를 별도로 다시 시작할 수 있습니다.
이 SimApi의 여러 인스턴스를 구성하려면 위의 단계를 반복하고 각 인스턴스에 고유한 이름을 사용합니다. 다른 로그 및 구성에 대해 자세히 알아보세요. file4.2의 인스턴스에 대한 s입니다.

SimApi 테스트 및 문제 해결

이 장에서는 SimApi 설치 테스트와 문제 해결에 대해 설명합니다.

SIMCA-online에서 SimApi 테스트

SIMCA-online 서버가 성공적으로 시작되면 SIMCA-online에서 SimApi를 테스트할 수 있습니다(서버가 시작되지 않으면 6.2를 참조하세요):
SIMCA-online 클라이언트에서 서버에 로그인하고 Extract로 이동합니다. File 탭. 추출은 SimApi를 통해 데이터를 얻어 테스트하는 데 도움이 됩니다.
SimApi의 노드("폴더")는 왼쪽 상자에 표시됩니다. Tags 선택된 노드에 대한 정보가 오른쪽 상단에 표시됩니다.
클릭만 하면 현재 데이터를 빠르게 테스트할 수 있습니다. view>에 tags 지속적인 프로세스 데이터를 제공합니다(스크린샷 참조)
시간 범위 내에서 배치를 찾으려면 노드를 마우스 오른쪽 버튼으로 클릭합니다. 노드는 배치에 대해 알고 있는 배치 노드여야 합니다.
선택하다 tags 추출에서 다음을 클릭하고 마법사를 완료하여 다양한 데이터 검색 모드(현재 데이터, 과거 데이터, 일괄 처리 데이터 및 이산 데이터)를 사용하여 데이터를 얻습니다.
추출된 데이터를 도구를 사용하여 데이터 소스에서 보는 것과 비교합니다. 7.13에서 SimApi의 모든 기능을 테스트하고 검증하는 방법에 대해 자세히 알아보세요.

SimApi 로그를 사용하여 SimApi 문제 해결 file

서버가 시작되지 않거나 SimApi가 예상대로 작동하지 않거나 추출이 실패하는 경우 SimApi 로그를 참조해야 합니다. file 문제가 무엇인지 알려줍니다. SimApi 로그에서 디버그 수준 로깅을 활성화하여 전체 세부 정보를 얻으세요. 4.2를 참조하세요.
참고: SIMCA-online 서버 로그는 여기서 그다지 유용하지 않습니다. 이 로그는 SimApi가 서버에 의해 로드되고 초기화된 방법을 보여주지만 SimApi 특정 세부 정보는 로그에 있습니다. file.

올바른 SIMCA-online 서비스 계정을 사용하세요

데이터 소스에 대한 액세스를 테스트할 때는 서버 컴퓨터에 특정 사용자(일반적으로 Windows 도메인의 사용자 계정)로 로그인했지만 SIMCA-online 서버 서비스 계정은 다른 계정(기본적으로 LocalSystem)이며, 사용자 계정과 다른 액세스 권한을 가지고 있다는 점을 기억하세요.
이러한 이유로 사용자 계정으로 실행할 경우 테스트는 정상적으로 작동하지만 SIMCA-online이 데이터 소스에 연결하지 못하는 경우가 드물지 않습니다.
이 문제를 해결하려면 SIMCA-online 서버 서비스에서 사용하는 계정에 대한 액세스 권한을 부여해야 합니다. 일반적으로 LocalSystem을 특정 도메인 서비스 계정으로 변경하고 이 계정에 권한을 부여합니다. SimApi가 SimApi 구성에 설정된 자격 증명을 사용하는 경우에는 적용되지 않습니다. 이러한 자격 증명이 우선하기 때문입니다.

SimApis에 대한 기술적 세부 사항

이 장에서는 SimApi가 작동하는 방식에 대한 기술적 세부 정보를 제공합니다. 주로 SimApi를 이해하고 데이터 소스에 대한 SimApi를 구현하려는 개발자를 대상으로 합니다.
개발자는 SimApis에 대한 소개와 기능에 대한 간략한 설명을 알아보려면 이 문서의 앞부분도 읽어야 합니다.

언제 SimApi 개발을 고려해야 하고, 언제는 그렇지 않을까요?

데이터 소스에 대한 SimApi 개발을 고려하기 전에:

이미 사용할 수 있는 SimApi가 있는지 조사하세요. 아마도 OPC UA와 같이 기존 SimApi 중 하나를 사용하도록 데이터 소스에서 일부 기능을 활성화할 수 있을 것입니다.
이 문서와 참조 자료를 주의 깊게 살펴보고 데이터 소스가 요구 사항을 충족하는지 조사하십시오. 예를 들어amp따라서 충분히 빨라야 하며, 현재 데이터뿐만 아니라 과거 데이터도 제공해야 합니다.

이러한 이유로, 저희는 저수준 하드웨어나 계측기에 연결되는 SimApi를 개발하는 것을 권장하지 않습니다. 이러한 계측기를 Aveva PI System과 같은 프로세스 히스토리언에 연결하고 계측기에서 데이터를 얻고 이를 히스토리언트하는 것이 더 좋습니다. 그런 다음 PIAF SimApi를 사용하여 PI에서 Umetrics 제품으로 데이터를 얻을 수 있습니다.

SimApi 개발 및 SimApi 사양

SimApi 사양인 SimApi-v2에는 SimApi DLL이 구현해야 하는 SimApi의 모든 C 함수에 대한 문서와 SimApi를 개발하는 방법에 대한 몇 가지 지침이 포함되어 있습니다.
C나 C++를 사용하여 SimApi를 구현하는 것은 대부분의 경우 불필요하게 낮은 수준입니다.
SimApi를 구현하는 데 권장되고 쉬운 방법은 Ex를 기반으로 하는 것입니다.amp우리가 제공하는 leSimApi 소스 코드입니다. 이것은 전ampC 인터페이스를 처리하고 실제 구현이 이루어지는 .NET Framework로 변환하는 SimApi 구현입니다. 로깅, 설정, 구성 GUI 및 기타 프레임워크 코드를 위한 프레임워크 코드도 있습니다.
SimApi를 개발하려면 개발자 팀은 Windows 개발, .NET Framework, C 또는 C++에 대한 경험이 필요합니다. SimApi가 연결해야 하는 데이터 소스에 대한 충분한 지식도 필요합니다. SimApi의 목적은 SIMCA-online 또는 SIMCA에서 데이터 소스의 API로 데이터 요청을 변환하는 것이기 때문입니다. SimApi 구현은 결코 일회성 프로젝트가 아니며 일반적으로 지속적인 지원과 가끔 유지 관리가 필요합니다.

데이터 읽기 또는 쓰기

SimApi는 데이터 소스에서 데이터를 제공하는 주요 작업을 합니다. 이를 데이터 읽기라고 합니다.
대부분의 SimApi 구현은 데이터 쓰기도 지원합니다. 즉, SimApi를 통해 데이터 소스에 데이터를 다시 쓰는 것을 의미합니다. 데이터 쓰기는 SIMCA-online의 선택 사항입니다.

Tags 그리고 노드

A tag 데이터 소스의 열 또는 "변수"의 식별자입니다. tag'의 이름은 식별하는 데 사용됩니다 tag. 노드 내의 이름은 고유해야 합니다. SIMCA-online 18은 하위 노드를 포함하는 노드를 지원하는 최초의 버전입니다. tag 같은 이름으로. 예를 들어ample: 노드 Parent에는 Batch라는 하위 노드가 있을 수 있습니다. tag 배치라고 부릅니다.
노드는 컨테이너입니다 tags. 노드는 다른 노드를 포함할 수도 있습니다. 이는 노드가 file 시스템에는 폴더가 있습니다.
~처럼 file 시스템, 노드 및 tag 이름은 고유하게 식별되는 전체 경로로 결합될 수 있습니다. tag. 그 tag SIMCA-online 또는 SIMCA에서 경로 선택 시 사용됩니다. tags 사용하다. A tag 경로는 SimApi 인스턴스 이름으로 시작하고 그 뒤에 노드 구조가 이어지며 다음으로 끝납니다. tag 이름, 각 항목은 콜론(:)으로 구분됩니다. 예를 들어ample “:ODBCSQLServer:노드:센서Tag1인치.

SimApi는 다음을 열거합니다. tags 그리고 시작 시 노드

SimApi 구현은 노드를 찾기 위해 서버를 탐색합니다. tags SimApi가 초기화될 때 데이터 소스에서 이를 추적하여 열거에 사용되는 다양한 SimApi 함수를 유지합니다. tags 노드를 구현할 수 있습니다.
SimApi 초기화는 서버 시작 시에만 실행되는 것이 아니라 사용자가 SIMCA-online의 Refresh SimApi 기능을 사용해 다시 실행할 수도 있습니다.

대소문자 구분 tag- 및 노드 이름

Tag 이름과 노드 이름은 대소문자를 구분합니다.
따라서, tag 라고 불리는 "tag1”은 “와 같지 않습니다.Tag1”은 “T”의 대소문자가 다르기 때문에 사용하지 않는 것이 좋습니다. tags 또는 대소문자만 다른 노드 이름.

연속 프로세스 노드

노드에 다음이 포함되어 있는 경우 tags 연속적인 프로세스 데이터를 사용하면 프로세스 노드라고 할 수 있습니다. 다음 두 스크린샷은 데이터가 있는 프로세스 노드의 표 형식 표현과 노드를 선택할 때 노드가 어떻게 보이는지 보여주는 그림을 보여줍니다. tags SIMCA-online에서.

연속 프로세스 노드는 배치, 실행 또는 시간과 독립적이어야 합니다.

SimApi에서 잘 작동하려면 노드는 배치, 실행 또는 시간과 독립적이어야 합니다. 특정 배치 또는 시간 범위에 대한 데이터가 포함된 노드는 SIMCA-online에서 잘 작동하지 않습니다. 그러면 프로젝트 구성이 해당 배치에 대한 데이터만 읽을 수 있고 다른 배치에는 사용할 수 없기 때문입니다.
대신, 노드는 측정이 수행되는 프로세스에서 하나 이상의 물리적 단위에 매핑되어야 합니다.

배치 ID tag 배치 프로젝트 실행을 위한 연속 프로세스 노드에 필요함

각 연속 프로세스에는 다음이 있어야 합니다. tag (변수) 각 관찰에 대한 배치 식별자를 보유합니다. 이 배치 식별자는 SIMCA 또는 SIMCA-online에서 각 관찰이 속하는 배치를 파악하는 데 사용됩니다.
$BatchID입니다 tag 7.4.3의 스크린샷은 그런 예입니다.amp르.
필수는 아니지만 다음을 갖는 것이 좋습니다. tag 프로세스의 현재 단계 또는 단계를 보여주는 프로세스 노드에서. tag 그런 다음 SIMCA-online 또는 SIMCA에서 데이터를 가져올 때 단계 실행 조건에서 사용할 수 있습니다. 이에 대한 값 tag 예를 들어, 다음과 같은 경우가 될 수 있습니다.amp“단계1”, “청소”, “단계2”.

배치 컨텍스트 노드

배치 노드는 배치를 추적하는 노드입니다. 배치 식별자, 시작 시간 및 종료 시간입니다. SIMCA-online에서 배치 프로젝트를 실행하기 위한 요구 사항입니다. 데이터 소스에는 배치를 다양한 방식으로 노출하는 두 개 이상의 배치 노드가 있을 수 있습니다. 사용자는 자신의 애플리케이션에 적용되는 배치 노드를 선택합니다. 이 예ample는 두 개의 서로 다른 단위에 걸쳐 있는 배치를 노출합니다.
/Factory1 – Unit1과 Unit2 모두에 대한 수명이 집계된 배치입니다.
/Factory1/Unit1 – Unit1에만 수명이 있는 배치
/Factory1/Unit2 – Unit2에만 수명이 있는 배치
데이터 소스에 배치 노드가 없는 경우 SIMCA-online의 배치 컨텍스트 생성기를 사용할 수 있습니다. 기본 제공 도움말을 참조하세요.
선택적인 배치 데이터
배치 노드에는 배치 데이터도 포함될 수 있습니다. 배치 전체에 대한 관찰이 단 하나뿐인 데이터입니다. tags 배치 데이터가 있는 노드는 배치 노드의 모든 기능을 갖춘 노드에 있을 필요가 없습니다. SimApi가 배치 데이터 읽기를 지원하는 것으로 충분합니다. tags. 7.6에서 일괄 데이터에 대해 자세히 알아보세요.
여기 전직이 있습니다amp배치 노드의 le:
참고: 위의 스크린샷은 SIMCA-online과 함께 제공되는 DBMaker에서 가져온 것입니다. DBMaker에서 직접 확인하려면 View Bakers Yeast 데이터베이스의 데이터 버튼을 클릭하면 두 개의 창이 표시되는데, 하나는 배치 노드이고 다른 하나는 프로세스 데이터입니다.

데이터 유형: 숫자 데이터, 텍스트 데이터 및 누락된 데이터

각각에 대하여 tagSimApi는 숫자, 텍스트, t 및 누락의 세 가지 유형의 데이터를 지원할 수 있습니다.
숫자 데이터는 일반적으로 프로세스 매개변수의 실제 값입니다. 예를 들어,ample 6.5123. SimApi는 32비트 단정밀도 부동 소수점 값만 처리할 수 있습니다. 단정밀도 부동 소수점 형식 - 위키피디아. 데이터 소스의 다른 모든 숫자 데이터 유형은 float로 변환해야 합니다. 따라서 크고 작은 값을 모두 처리할 수 있지만 유효 숫자는 약 6~7자리에 불과합니다. 기술 가이드에서 자세히 알아보세요.
이는 큰 정수 또는 크고 소수점이 있는 실수의 경우 정밀도가 떨어질 수 있습니다. 자세한 내용은 기술 가이드를 참조하세요.
텍스트/문자열 데이터는 배치 ID, 단계 실행 조건 또는 정성적 변수에 사용됩니다. 텍스트의 값은 tag 데이터는 대소문자를 구분합니다. 즉, 값 "running"은 다음과 같지 않습니다.
"실행 중". Datetime 변수는 SimApi에서 직접 지원되지 않지만 YY-MM-DD HH:MM(예: ) 형식의 문자열로 반환될 수 있습니다.ample “2020-09-07 13:45”).
누락된 값은 반환할 값이 없다는 것을 의미합니다. 즉, 데이터가 없습니다.
어떤 유형이 반환되는지는 SimApi 구현에 달려 있습니다. SimApi는 데이터 소스의 데이터를 알고 있으며 가장 적합한 데이터 유형을 반환해야 합니다.

데이터 검색의 세 가지 모드: 연속, 일괄 및 이산

SimApi 사양은 데이터 검색의 세 가지 모드, 즉 SimApi가 데이터를 제공할 수 있는 세 가지 다른 방법을 정의합니다. tags 데이터 소스에서(또는 다른 방향: 데이터 쓰기) tags 데이터 소스에서).
연속 데이터 검색 - 이는 배치 또는 프로세스가 진화함에 따라 관찰당 관찰을 지속적으로, 순차적으로 읽는 데이터를 말합니다. 데이터는 관찰 사이에 정기적인 간격으로 현재 시간 또는 특정 범위에 대해 읽힙니다. 예를 들어ample, 09:00:00 ~ 10:00:00 s 사이의 모든 데이터amp60초마다 진행되어, 종료 지점을 포함할 경우 61개의 관찰이 이루어집니다.
배치 데이터 검색 - 이는 전체 배치에 대한 데이터가 있는 단일 관찰을 말합니다(특정 성숙도 또는 시점과 연관되지 않음). 배치 속성 및 로컬 센터링 데이터는 SIMCA-online에서 배치 데이터로 읽힙니다. 배치 조건도 일반적으로 배치 데이터로 읽힙니다(이산 데이터 검색을 위해 구성된 경우 제외).
이산 데이터 검색 - 이산 데이터는 여러 만기에 대한 여러 관찰로 구성될 수 있습니다. 그러나 연속 데이터와 달리 이산 데이터는 순차적으로 읽히지 않고 배치의 특정 단계에 대한 모든 데이터를 한 번에 읽습니다. 데이터는 만기 변수의 정기적인 간격으로 간격을 둘 필요가 없습니다. 모든 데이터는 구성된 간격으로 데이터가 요청될 때마다 다시 읽힙니다.
주어진 모든 것에 대해 tag 데이터는 세 가지 모드 중 하나로 요청할 수 있지만 일반적으로 SimApi는 개별 모드 중 하나만 지원합니다. tag. 마찬가지로 혼합하는 것도 허용됩니다. tags 노드 내부이지만 일반적으로 모두 tags 특정 노드 내에서는 동일한 데이터 검색 모드를 지원합니다.
연속 데이터의 경우(일괄 또는 불연속 데이터는 제외2) 현재 데이터나 이전 데이터에 대한 요청을 할 수 있습니다. 이에 대해서는 다음 섹션에서 설명합니다.
모든 SimApi가 모든 모드를 지원하는 것은 아닙니다. 위의 기능 매트릭스와 SimApi를 참조하세요. web 자세한 내용은 페이지를 참조하세요.

SimApi를 통한 현재 및 과거 연속 데이터

연속 데이터는 시간이 지남에 따라 변경되는 프로세스 데이터를 말합니다.

현재의 데이터

현재 데이터를 읽는다는 것은 데이터 소스에 최신 값을 요청하는 것을 의미합니다. tags 질문할 때. 외부 데이터 소스의 시간은 여기서 사용되지 않는다는 점에 유의하세요.
현재 데이터로 읽은 데이터는 SIMCA-online에서 라이브 데이터로 표시하는 것입니다. 이러한 이유로 데이터 소스에 불필요한 지연이 없는 것이 중요합니다. 현재 데이터는 SIMCA-online에서 잘 작동하려면 가능한 한 최신이어야 합니다.
데이터 소스는 데이터에 대한 지식과 값의 유효 기간을 사용하고 시간 지점의 원시 데이터가 너무 오래되었을 때 누락된 데이터를 반환하기로 결정할 수 있습니다. 예를 들어ample: 데이터는 15:00:00에 요청되었지만 데이터 소스의 가장 최근 데이터 포인트는 03:00:00입니다. 이 경우 데이터는 12시간 전의 것이므로 SimApi는 누락된 값(데이터 없음)을 반환하기로 결정할 수 있습니다.

역사적 데이터

과거 데이터를 읽는다는 것은 데이터 소스에 하나 이상의 값을 요청하는 것을 의미합니다. tags 특정 관찰 간격이 있는 특정 시간 범위에 대해. 여기서는 데이터를 찾는 데 데이터 소스의 로컬 시간이 사용된다는 점에 유의하세요. 따라서 데이터 소스와 서버 간의 시간 동기화가 중요합니다.
과거 데이터는 데이터 매트릭스로 구성됩니다. 데이터 소스에서 데이터를 요청하는 것은 SimApi 구현에 달려 있으며,amp지정된 간격으로 배치하고 반환할 데이터 행렬을 구성합니다.
때로는 데이터 소스 자체에 처리된 데이터를 반환하기 위한 집계 함수가 있거나amp올바른 데이터를 반환하는 데 사용할 수 있는 ling 함수입니다.
다른 데이터 소스의 경우 SimApi는 시간 범위 내의 모든 데이터를 요청한 다음 s를 실행해야 합니다.amp행렬을 구성하기 위한 올바른 관찰이 필요합니다.
원시 데이터가 시간 범위에 없더라도 시작 시간 바로 전에만 데이터가 반환되어야 합니다. 예를 들어,ample: 데이터는 시간 지점 10과 20에서 데이터 소스에 존재합니다. SimApi는 시간 지점 15와 17에 대한 데이터를 요청합니다. 이 경우 SimApi는 시간 지점 10에 대한 값을 반환해야 하지만 시간 지점 XNUMX에 대한 값은 반환되지 않습니다.amp15와 17은 그 당시 가장 최근의 데이터 포인트였기 때문에 시간으로 ed되었습니다. tags 시간 10에서 요청된 범위에 대한 경계 값이라고 합니다. 경계 값에 대한 자세한 설명은 예를 들어 다음을 참조하세요.ampUA Part 11: Historical Access – 6.4.3 ReadRawModifiedDetails 구조의 returnBounds에 대한 설명서
(opc재단)
보간은 미래 시간 지점의 값을 계산하는 데 사용해서는 안 됩니다. 데이터가 실시간으로 읽은 현재 데이터와 일치하지 않기 때문입니다.amp이전 항목에서: 15와 17의 데이터를 10과 20의 값을 사용하여 보간하면 사실상 미래의 값을 사용하게 되는데, 이는 허용되지 않습니다.
데이터 소스는 데이터에 대한 지식과 값의 유효 기간을 사용하여 원시 데이터가 시간 지점에 너무 오래되었을 때 누락된 데이터를 반환하기로 결정할 수 있습니다. 예를 들어ample: 데이터는 15:00:00에 요청되었지만 데이터 소스의 가장 최근 데이터 포인트는 03:00:00입니다. 이 경우 데이터는 12시간 전의 것이므로 SimApi는 누락된 값(데이터 없음)을 반환하기로 결정할 수 있습니다.

메모: SIMCA-online은 일반적으로 정상적인 프로젝트 실행 중에 한 번의 호출에서 100개 이상의 관찰을 요청하지 않습니다. SIMCA-online에서 추출을 수행하거나 데스크톱 SIMCA를 실행할 때 더 많은 데이터 요청을 할 수 있습니다. 이는 예상대로 오랜 시간이 걸릴 수 있습니다.

현재 데이터와 과거 데이터가 일치해야 합니다.

때때로 데이터를 실시간 현재 데이터 또는 과거 데이터로 읽을 때 차이가 있을 수 있습니다. 이는 서버가 필요에 따라 현재 데이터와 과거 데이터 사이를 자동으로 전환하기 때문에 SIMCA-online에서 문제를 일으킵니다.

저지연 데이터 수집

SIMCA-online에서 실시간으로 데이터 소스를 사용하는 경우 데이터 소스의 데이터가 최신 상태여야 합니다. 데이터 소스에서 데이터 수집에 불필요한 지연이 없어야 합니다. 모든 변수에 대한 연속 프로세스 데이터는 모든 관찰에 대해 동시에 사용할 수 있어야 합니다. 일부 변수에 대해 늦게 들어오는 데이터는 SIMCA-online에서 수집되지 않습니다.

언제든지 데이터를 읽을 수 있습니다

SIMCA-online에서 값을 묻는 경우 tag 시간 t에 대해 시간 t의 데이터 소스에서 값을 받거나, 시간 t 이전의 데이터 소스에서 최신 관찰치 또는 시간 t에 대한 보간된 값을 받습니다. 따라서 서버는 이 정확한 시간 지점에 대한 관찰치가 데이터 소스에 존재하지 않더라도 요청할 때마다 항상 값을 받습니다.
가장 타임스트ampSimApi의 s는 항상 UTC입니다. SIMCA-online 클라이언트와 SIMCA는 시간을 현지 시간으로 표시합니다.

스레딩

SimApi는 기본적으로 SimApi 사용자가 단일 스레드로 호출합니다. 이는 모든 SIMCA 버전과 SIMCA-online(버전 17까지)에 해당합니다.
SIMCA-online 18은 SimApi를 통한 멀티스레드 액세스를 켜는 기능 플래그를 지원합니다. 자세한 내용은 도움말 항목 동시 SimApi 액세스를 참조하세요.
즉, 가능하다면 SimApi 구현을 스레드로부터 안전하게 만들어 멀티스레딩에 대비해야 하며, 이를 포함한 SimApi 사용자를 위한 고려 사항을 문서화해야 합니다.

통나무 file

SimApi는 작업, 오류 메시지 및 경고를 로그에 기록해야 합니다. file 문제 해결을 돕기 위해. 로깅의 중요성을 나타내기 위해 다양한 로그 레벨을 사용합니다.
SimApi에 구현되지 않은 기능에 대해서는 "구현되지 않음"을 기록하는 것이 좋습니다.

오류 처리

SimApi가 데이터 소스의 요청을 충족할 수 없는 경우 다음 두 가지 방법 중 하나로 문제를 처리할 수 있습니다. 누락된 값(데이터 없음)을 반환하거나 SimApi 오류를 신호로 보내는 것입니다.
호출자에게 누락된 값을 반환하고 성공을 알리면 호출자는 정상적으로 계속할 수 있습니다(물론 데이터 없이). 이는 일부에 대한 데이터를 얻을 수 있지만 모든 데이터는 얻을 수 없는 경우와 같이 부분 오류에 권장되는 관행입니다. tags 요청으로.
SimApi 오류를 신호로 보내면 호출자가 (예:ample SIMCA-online 서버)를 통해 즉시 확인하고 조치를 취하십시오. 이는 완전히 실패하고 데이터를 전혀 반환할 수 없는 요청에 권장되는 관행입니다.
SIMCA-online은 누락된 값이나 오류 코드를 다르게 처리합니다. 자세한 내용은 SIMCA-online 기술 가이드에 설명되어 있습니다.

SimApi 성능 요구 사항

SimApi의 함수는 데이터를 얻는 데 사용됩니다.
데이터 접근이 느리면 SimApi가 제대로 작동하지 않습니다.ample는 다음과 같이 보여줍니다: SIMCA-online이 1초마다 데이터를 요청하지만, 이를 얻는 데 2초가 걸린다면, SIMCA-online 서버는 결코 실시간으로 따라갈 수 없고 점점 더 뒤처지게 될 것입니다.
하위 섹션에서는 SIMCA와 SIMCA-online이 데이터 액세스 SimApi 함수를 사용하는 방법과 SimApi 함수가 얼마나 자주 호출되는지 보여드리겠습니다. 이는 SimApi 구현에 대한 성능 요구 사항을 설정하는 데 도움이 될 수 있습니다.

SIMCA의 SimApi 기능 사용

데스크톱 SIMCA 또는 기타 오프라인 제품이 SimApi를 사용하여 데이터를 얻는 경우, 이러한 요청은 특정 시간 범위 내의 일련의 변수에 대한 배치 및 프로세스 데이터에 대한 것입니다.
이러한 요청은 사용자가 수동으로 시작하므로 자주 발생하지 않으며 데이터 소스에 상당한 부하를 일으키지 않습니다.
다음 SimApi 함수는 데이터를 얻는 데 사용됩니다.
simapi2_nodeGetActiveBatches
simapi2_nodeGetBatchTimes
simapi2_connectionReadHistoricalDataEx

SIMCA-online의 SimApi 기능 사용

SIMCA-online은 프로세스의 실시간 모니터링에 사용되므로 정기적으로 SimApi를 통해 데이터를 요청합니다. 사용할 수 있는 가장 짧은 실행 간격은 1초입니다. 일부 실제 examp실행 간격의 종류는 10초, 1분 또는 10분입니다.
서버에서는 동시에 여러 프로젝트를 실행할 수 있습니다.
SimApi를 통한 API 호출 수를 줄이기 위해 서버는 동시에 발생하는 여러 작은 요청을 모든 변수에 대한 하나의 큰 요청으로 그룹화하여 데이터 요청을 최적화합니다(도움말 항목 '데이터 소스에서의 최적화된 읽기로 성능이 향상됩니다'에서 자세히 알아보세요).
서버의 실행 알고리즘은 아래 나열된 SimApi 함수를 사용하여 데이터를 요청할 때 다음과 같이 작동합니다.
동일한 간격으로 실행되는 모든 단계는 호출 수를 줄이기 위해 단일 SimApi 호출로 그룹화됩니다. 서버는 간격을 공유하는 모든 모델에서 사용하는 모든 변수에 대한 최신 데이터를 읽습니다. 즉, 이 호출은 모든 프로젝트에서 사용되는 광범위한 데이터 행을 생성합니다.
- simapi2_connection현재 데이터 읽기
각 배치 프로젝트의 경우 서버는 또한 어떤 배치가 활성화되어 있는지 알아야 합니다. 이는 또한 프로젝트가 실행될 때마다 발생해야 합니다.
- simapi2_nodeGetActiveBatches
- simapi2_nodeGetBatchTimes가 덜 자주 호출됩니다.
또한 SIMCA-online은 과거 데이터도 요구합니다. 이러한 요청은 SIMCA-online이 시작되기 전에 시작된 배치의 시작 부분을 따라잡거나 서버가 뒤처져서 데이터 블록을 읽어야 할 때와 같이 필요할 때만 발생합니다.
- simapi2_connectionReadHistoricalDataEx
선택적으로 일부 프로젝트 구성에서는 일괄 데이터나 개별 데이터를 사용하는 기능을 사용하며, 이는 다음을 위한 SimApi 호출을 초래합니다.
- simapi2_connectionReadBatchData
- simapi2_connectionReadDiscreteEx
선택적으로 일부 프로젝트 구성에서는 쓰기 다시 쓰기를 사용하여 데이터를 데이터 소스로 다시 푸시합니다.
- simapi2_connectionWriteHistoricalDataEx(및 일괄 데이터, 이산 데이터에 대한 해당 함수)
데이터를 가져오기 위한 핵심 함수인 readCurrentData, getActiveBatches/getBatchTimes에 대한 각 호출이 빠르고, SIMCA-online이 해당 함수를 얼마나 자주 호출하는지 감안할 때 데이터 소스 자체에 대한 컴퓨팅 측면에서 어렵지 않은 것이 중요합니다.

SimApi 데이터 테스트 및 검증

이 섹션은 SimApi를 테스트하여 반환된 데이터가 데이터 소스 자체의 데이터와 일치하는지 확인하는 것에 관한 것입니다. 이와 같은 테스트를 실행하는 것은 SimApi 구현을 만들거나 변경한 후 또는 데이터 소스의 API가 변경될 때 중요합니다.
실제로 데이터 검증은 SIMCA-online과 그 추출 기능을 사용하여 SimApi를 통해 데이터 소스에서 데이터를 끌어온 다음 데이터 소스의 원시 데이터와 비교합니다. 데스크톱 SIMCA는 SimApi의 실시간 측면을 테스트하는 데 사용할 수 없습니다.

준비물 및 요구사항

일부 항목은 선택 사항이지만 테스트 범위에 포함되는 경우 수행할 수 있습니다.

제품 zip 파일에 들어 있는 ReadMe 및 설치 안내서.pdf에 설명된 대로 SIMCA-online을 설치하세요.
SIMCA-online 서버에 대한 라이센스를 취득하고 설치합니다. SimApi는 라이센스 없이는 작동하지 않습니다. SIMCA-online에 대한 지식 기반 문서는 제품 라이센스를 지정하는 방법을 보여줍니다. 예를 들어amp르: SIMCA-online 18 (sartorius.com)
테스트하려는 SimApi를 설치하고 구성합니다. 이 문서의 4~5장과 특정 SimApi의 사용자 가이드를 참조하세요.
- a. 선택 사항: 사용자 안내서가 최신이고 정확한지 확인하세요.
SimApi 데이터를 비교하는 데 사용할 수 있는 데이터 소스용 도구가 있는지 확인하세요.
SIMCA-online 데스크톱 클라이언트에서 SIMCA-online 서버에 로그인하고 다음을 사용합니다. File > SimApi를 통해 데이터를 추출합니다.
테스트 범위에 포함되는 경우 선택 사항: 테스트를 마친 후 SimApi를 제거하고 확인합니다. file제거됩니다.

무엇을 테스트 할 것인가

3장의 기능 매트릭스는 모든 가능한 기능을 나열하지만, 주어진 SimApi 구현은 하위 집합만 지원할 수 있습니다. 주어진 SimApi에 의해 구현된 모든 기능을 테스트해야 합니다.
다음 테스트는 대부분의 SimApi 구현에 공통적입니다.
사용자 이름과 비밀번호를 사용한 인증
SimApi 구성의 다양한 설정을 테스트하세요
노드 계층: 노드와 tags SimApi에서 노출된 내용은 정확합니다.
- 있어야 합니다 tag SimApi를 통해 사용할 수 있는 모든 "변수"에 대해 노출됩니다.amples: 프로세스 측정값, 계산된 값, 상수.
연결 복원력: 데이터 소스를 사용할 수 없는 경우 로그에 경고 또는 오류가 발생합니다. file하지만 데이터 소스를 사용할 수 있게 되면 데이터 소스에 대한 연결이 자동으로 다시 설정됩니다.
다중 인스턴스: 두 인스턴스를 별도의 로그로 독립적으로 동시에 구성하고 사용할 수 있습니다. files.
현재 데이터: 현재 데이터를 추출합니다. tags. 데이터가 데이터 소스에서 마지막으로 알려진 값인지 확인하고, 품질이 좋지 않거나 데이터가 너무 오래된 경우에는 누락된 데이터인지 확인하세요.
- 10분 동안 XNUMX초마다 데이터를 추출합니다.
과거 연속 데이터: 과거 데이터 추출 tags.
- 현재 데이터를 추출할 때와 일치하는 시간 범위를 사용합니다. 현재 데이터가 과거 데이터와 데이터 소스의 원시 데이터와 일치하는지 확인합니다.
- 다양한 시간 범위와 s를 시도해보세요amp간격을 두고 데이터가 데이터 소스와 일치하는지 확인합니다.
- 가능한 가장 짧은 시간인 1초마다 데이터를 추출해보세요.amp링 간격.
- 다양한 유형을 시도해보세요 tags 데이터 소스(프로세스 변수 등)에서 데이터가 일치하는지 확인합니다.
- 참고: SIMCA-online은 단일 대규모 과거 데이터 요청을 여러 개의 작은 청크로 분할할 수 있습니다. 이는 SimApi 로그에서 볼 수 있습니다.
SimApi가 텍스트 데이터, 숫자 데이터 및 누락된 데이터로 작동하는지 확인합니다.
SimApi 로그 file. 로그에 적절한 항목이 포함되어 있는지 확인하세요.
배치 노드: 노드를 마우스 오른쪽 버튼으로 클릭하고 배치 찾기를 실행합니다.
- 배치 이름, 시작 시간, 종료 시간을 배치별로 확인합니다.
- 데이터 소스에서 실행 중인 활성 배치를 시도해 보세요. SimApi를 통해 종료 시간이 없어야 합니다.
프로세스 노드 배치 식별자 tag. SimApi에 배치 노드 기능이 있는 경우(이전 항목 참조) 배치 식별자도 있어야 합니다. tag 매칭 프로세스 데이터 노드에서. 이것에 대한 데이터 tag 배치 식별자(배치 이름)여야 합니다. 이 데이터는 배치 프로젝트에서 데이터 행이 속하는 배치를 식별하는 데 필요합니다.

SimApi가 지원하는지 여부에 따라 다음을 테스트할 수도 있습니다.

배치 데이터를 사용하여 File > 추출.
이산 데이터를 사용하여 File > 추출. 참고: 이산 데이터를 테스트하려면 File > 노드 추출, 배치 노드 및 개별 데이터 노드는 동일한 SimApi에 있어야 합니다(SIMCA-online이 프로젝트를 실행할 때 이들은 서로 다른 SimApi에 있을 수 있음).
다시 쓰기 - 데이터 소스에 데이터 배치를 푸시합니다. 이를 테스트하려면 SIMCA-online에서 프로젝트 구성을 구성하여 데이터 벡터를 데이터 소스에 다시 써야 합니다. 그런 다음 SIMCA-online에서 프로젝트를 실행하고 데이터 소스에 다시 쓰여진 데이터를 확인합니다.
연속 데이터는 프로젝트 구성의 Evolution Write Back 페이지에서 구성됩니다.
개별 데이터는 동일한 페이지에 구성되지만, 개별 데이터 검색을 위해 구성된 단계에만 해당됩니다.
배치 쓰기 백의 배치 데이터

더 많은 정보

Sartorius Stedim 데이터 분석 AB Östra Strandgatan 24 903 33 Umeå 스웨덴
전화 번호 : + 46 90-18 48 00
www.sartorius.com
이 지침에 포함된 정보 및 그림은 아래에 지정된 버전 날짜와 일치합니다.
이는 특히 사용된 미디어 유형에 관계없이 재인쇄, 번역 및 편집에 적용됩니다.

자주 묻는 질문

질문: SimApis의 목적은 무엇인가요?
- 답변: SimApis의 주요 목적은 프로젝트 생성 및 모델 구축을 위해 Umetrics Suite 제품에 데이터를 제공하는 것입니다.
질문: SimApi 설치와 관련된 문제는 어떻게 해결할 수 있나요?
- A: SIMCA-online에서 테스트하고 SimApi 로그를 확인하여 문제를 해결할 수 있습니다. file서비스 계정이 올바르게 구성되었는지 확인합니다.

문서 / 리소스

SARTORIUS Sim Api 소프트웨어 [PDF 파일] 사용자 가이드
Sim Api 소프트웨어, Api 소프트웨어, 소프트웨어

참고문헌

사용자 설명서