Používateľská príručka softvéru SARTORIUS Sim Api

Softvér SARTORIUS Sim Api

Špecifikácie

• Názov produktu: SimApi Guide
• Dátum vydania: 5. september 2024
• Účel: Poskytovanie údajov produktom Umetrics Suite

Návod na použitie produktu

Úvod do SimApis

• SimApis sa používajú na získavanie údajov na vytváranie projektov a modelovanie v produktoch Umetrics Suite.

Získanie SimApis

• Ak chcete získať SimApis, pozrite si oficiálnu dokumentáciu alebo požiadajte o pomoc zákaznícku podporu.

Funkcie SimApi

• SimApis poskytuje údaje v reálnom čase na monitorovanie, riadenie a vytváranie modelov v SIMCA a SIMCA-online.

Len aktuálne využitie dát

• Pre optimálny výkon sa odporúča používať iba aktuálne údaje a vyhnúť sa historickým údajom.

Príprava na inštaláciu SimApi

• Pred inštaláciou sa uistite, že váš systém spĺňa minimálne požiadavky uvedené v používateľskej príručke.

Inštalácia SimApi

• Pri inštalácii SimApi do vášho systému postupujte podľa podrobných pokynov uvedených v používateľskej príručke.

Nastavenie SimApi pre SIMCA

• Nakonfigurujte nastavenia SimApi v SIMCA podľa poskytnutých pokynov.

Nastavenie SimApi pre SIMCA-online

• Nastavte SimApi na získavanie dát a operácie spätného zápisu v reálnom čase v SIMCA-online.

Testovanie a odstraňovanie problémov

• Po inštalácii vykonajte testovanie, aby ste zaistili správnu funkčnosť. V prípade problémov si pozrite časť o riešení problémov v používateľskej príručke.

Testovanie od SIMCA-online

• Otestujte integráciu SimApi zo SIMCA-online a overte si získavanie údajov.

Riešenie problémov s Log Files

• Použite denník SimApi file identifikovať a vyriešiť akékoľvek problémy s inštaláciou alebo prevádzkou.

Konfigurácia servisného účtu

• Zabezpečte správnu konfiguráciu účtu SIMCA-online služby pre bezproblémovú prevádzku.

Technické detaily

• Podrobné technické informácie o SimApis nájdete v časti 7 používateľskej príručky.

Úvod do SimApis

• SimApi je softvérové ​​rozhranie medzi softvérom Umetrics® Suite a zdrojom údajov. Primárnym účelom SimApi je poskytovať údaje SIMCA®-online alebo SIMCA®.
• Sartorius Stedim Data Analytics AB vyvíja SimApis pre mnoho rôznych zdrojov údajov, ako sú napríklad procesné historické údaje a databázy na všeobecné účely.
• Tento dokument ukazuje, čo je SimApi a ako sa používa v produktoch Umetrics Suite. Dozviete sa, ako naplánovať a nainštalovať SimApi, ako riešiť problémy a ako otestovať inštaláciu. Záverečná kapitola obsahuje technické detaily SimApis určené pre vývojárov.

Účel SimApi: poskytovanie údajov produktom Umetrics Suite

• Primárnym účelom SimApi je poskytovať údaje SIMCA-online alebo SIMCA zo zdroja údajov. Zdroj údajov nie je súčasťou SIMCA-online, ale môže to byť procesný historik alebo iný systém, ktorý uchováva a spravuje údaje.
• SimApi odhaľuje hierarchiu uzlov, ktorá zodpovedá priečinkom v a file systém. Každý uzol môže obsahovať ďalšie uzly, príp tags. A tag zodpovedá premennej. Pre tieto tagsje možné získať údaje. Obrázok ukazuje a tag, Temp, vybraté v uzle
• BakersYeastControlGood v zdroji údajov v SIMCA-online. Zobrazuje tiež najnovšie hodnoty prevzaté zo zdroja údajov.

Použitie SimApi v balíku Umetrics Suite

• Softvér SIMCA pre stolné počítače môže použiť SimApi na získanie údajov na vytvorenie projektu a zostavenie modelu, ako ukazuje nasledujúci obrázok.
• SIMCA-online využíva SimApis na získavanie údajov v reálnom čase na monitorovanie a riadenie, ako aj na spätný zápis údajov do zdroja údajov. Nasledujúci obrázok ukazuje, kde sa SimApi nachádza v systéme pozostávajúcom zo zdroja údajov, SIMCA-online servera a klientov.

Bežne používaný SimApis

• Najpoužívanejšie SimApis sú:
• PI AF SimApi na pripojenie k Aveva (predtým OSIsoft) PI Systems.
• OPC UA SimApi
• ODBC SimApi – pre všeobecný prístup k databázam ako SQL Server alebo Oracle
• Všetky dostupné SimApis sú uvedené spolu s ich funkciami v odseku 3.

DBMaker SimApi pre simulačné dáta

• DBMaker je aplikácia dodávaná s inštaláciou SIMCA-online servera. Simuluje zdroj údajov, ako je napríklad historik procesov, pomocou vopred načítanej tabuľky údajov, kde sa pozorovania poskytujú po jednom do SIMCA-online prostredníctvom DBMaker SimApi.
• DBMaker sa používa iba na demonštračné účely a nemožno ho použiť v produkcii so živými údajmi zo zdroja údajov. Viac informácií o DBMaker nájdete v vstavanom pomocníkovi.

Dodatočná dokumentácia

• Tento dokument je jedným zo súboru súvisiacich dokumentov, z ktorých každý má iné zameranie a cieľovú skupinu:

Zdroj	Čo?	Kde
SIMCA-online web stránku	Úvodné informácie a súbory na stiahnutie	sartorius.com/umetrics-simca- online

SIMCA-online ReadMe a inštalácia.pdf	Inštalácia a ako začať so SIMCA- online demo dátami	V inštalačnom zip file
SIMCA-online Implementačná príručka	Načrtáva funkcionalitu SIMCA-online, dáva ju do kontextu s iným softvérom Umetrics Suite, popisuje požiadavky a osvedčené postupy pre úspešné nasadenie a podrobné pokyny na inštaláciu.	sartorius.com/umetrics-simca- online
Sprievodca SimApi	Príprava a vykonávanie inštalácií SimApi vrátane riešenia problémov. Tiež obsahuje technické podrobnosti o SimApis pre vývojárov.	sartorius.com/umetrics-simapi
Používateľské príručky SimApi	Dokumentácia pre každé publikované SimApi s funkciami, pokynmi na inštaláciu a špecifikáciami konfigurácie.	sartorius.com/umetrics-simapi
SIMCA-online technická príručka	Technická referencia pre plánovanie inštalácie servera SIMCA-online, riešenie problémov a podrobné informácie o tom, ako funguje SIMCA-online.	sartorius.com/umetrics-simca-online
SIMCA-online pomoc	Web-založená pomoc o tom, ako používať SIMCA-online a ako SIMCA-online funguje.	V samotnom softvéri a ďalej sartorius.com/umetrics-simca
SIMCA-online Web Sprievodca inštaláciou klienta	Popisuje inštaláciu SIMCA-online Web Zákazník.	sartorius.com/umetrics-simca-online
Znalostná báza Umetrics	Vyhľadávateľná databáza s článkami o každej vydanej verzii softvéru, technickými článkami a známymi problémami v produktoch Umetrics Suite.	sartorius.com/umetrics-kb
Pomocník SIMCA/používateľská príručka	Ako používať desktopovú SIMCA na vytváranie projektov a modelovanie dát.	V SIMCA a ďalej sartorius.com/umetrics-simca
Podpora web stránku	Ako získať technickú podporu.	sartorius.com/umetrics-support

Technická podpora

• Online tím podpory spoločnosti Sartorius odpovedá na technické otázky o SimApis a môže tiež posielať žiadosti o vylepšenie SimApis príslušným ľuďom. Viac sa dozviete na sartorius.com/umetrics-support.

Získanie SimApis

• Poskytujeme dokumentáciu pre dostupný SimApis a odkazy na inštalačné programy na sartorius.com/umetrics-simapi.
• Každé SimApi je zdokumentované v jeho používateľskej príručke.
• Sprievodca SimApi, ktorý práve čítate, dopĺňa tieto informácie o SimApi, ktoré dopĺňajú informácie, pokiaľ ide o plánovanie, inštaláciu a riešenie problémov SimApi.

Funkcie SimApi

• Nie všetky zdroje údajov sú rovnaké. SimApi nemusí implementovať všetky funkcie v špecifikácii. Z týchto dôvodov rôzne SimApis ponúkajú rôzne funkcie. Nasledujúca matica uvádza dostupné SimApis a ich funkcie.
• Funkcie sú vysvetlené nižšie. Všimnite si, že tabuľka má samostatné stĺpce, ktoré ukazujú, ktoré funkcie sú dostupné v SIMCA-online a SIMCA.

Funkcia	Účel	SIMCA-online používanie	Použitie SIMCA
Aktuálne údaje	Prečítajte si jedno pozorovanie s najnovšou hodnotou zo zdroja údajov.	Normálne vykonávanie v reálnom čase	–
Historické údaje	Prečítajte si veľa pozorovaní naraz s historickými údajmi zo zdroja údajov.	Doháňať a predvídať minulé dáta, vytvárať projekty pomocou File > Nové	Sprievodca importom databázy na import procesných údajov na vytvorenie modelu.
Diskrétne údaje	Prečítajte si laboratórne/IPC údaje zo zdroja údajov. Veľa pozorovaní na dávku.	Pre dávkové projekty s fázami alebo dávkovými podmienkami nakonfigurovanými na diskrétne získavanie údajov.	–
Údaje o dávke	Prečítajte si podmienky šarže a konečné atribúty kvality (alebo	Podmienky šarže alebo lokálne centrovanie.	Sprievodca importom databázy na čítanie podmienok dávky

Funkcia	Účel	SIMCA-online používanie	Použitie SIMCA
	iné údaje typu MES). Jedno pozorovanie na dávku.		tvorba modelu na úrovni dávky.
Dávkový uzol	Zadajte čas začiatku a čas ukončenia (prázdne pre aktívnu dávku) pre konkrétnu dávku. Vypočítajte všetky dávky, ktoré existovali v časovom rozsahu.	Vyžaduje sa na vykonávanie dávkových konfigurácií.	Sprievodca importom databázy na výber dávok na import.
Spätný zápis – priebežné dáta	Zapisujte nepretržité údaje, ako sú predpovede, späť do zdroja údajov.	Zapíšte si údaje z úrovne vývoja dávky, pre Control Advisor alebo pre kontinuálne konfigurácie	–
Odpíšte – diskrétne	Zapisujte diskrétne údaje, ako sú predpovede, späť do zdroja údajov.	Spätný zápis pre dávkové konfigurácie na úrovni vývoja dávky pre fázy nakonfigurované na diskrétne získavanie údajov	–
Spätný zápis – údaje o dávke	Zapíšte späť údaje na úrovni dávky, ako sú predpovede alebo atribúty konečnej kvality, do zdroja údajov.	Odpíšte pre konfiguráciu dávky na úrovni dávky	–
Hierarchia uzlov	SimApi podporuje hierarchiu uzlov, podobne ako a file systém. Každý uzol môže obsahovať tags a ďalšie uzly. Hierarchia uľahčuje správu veľkého počtu uzlov a tags.	Podporované na všetkých miestach, kde tags sa používajú.
Pole tag rozšírenie	Pole tag ukladá viacero hodnôt. SimApi rozširuje pole tag mnohým jednotlivcom tags, jeden pre každý prvok v poli.	Podporované kde tags sa používajú na nepretržité údaje. Každá sa rozšírila tag musia byť namapované na premennú v projekte SIMCA.
Viaceré zdroje údajov	SimApi sa môže pripojiť k viac ako jednému zdroju údajov alebo podporuje viacero svojich inštancií s individuálnymi nastaveniami a protokolom files pre každý prípad.	Pripojte sa k niekoľkým rôznym zdrojom údajov rovnakého druhu.	–
Odolnosť pripojenia	Ak sa SimApi odpojí od zdroja údajov, automaticky sa pokúsi obnoviť pripojenie.	SimApi sa nemusí reštartovať, aby sa obnovilo pripojenie k zdroju údajov.	–
Vyvinuté interne	SimApi vyvíja, poskytuje a podporuje

Neodporúčajú sa iba aktuálne údaje bez historických údajov

• Niektoré SimApis, najmä OPC DA, podporujú iba čítanie aktuálnych údajov a nie historických údajov.
• SimApi, ktoré podporuje iba aktuálne údaje, nemožno použiť v počítačovej SIMCA, pretože nebude schopné čítať historické údaje, na ktorých by sa dali zostaviť modely.
• Pre SIMCA-online dôrazne odporúčame zdroj údajov a SimApi, ktoré poskytujú nielen aktuálne údaje na vykonávanie v reálnom čase, ale aj historické údaje, aby bolo možné predpovedať a dohnať minulé údaje. SIMCA-online podľa potreby automaticky prepína medzi dátami v reálnom čase a historickými dátami a to sa nedá vypnúť.
• Zdroj údajov, ktorý poskytuje iba aktuálne údaje, ale nie historické údaje, môže fungovať pre nepretržité projekty v SIMCA-online, ale pre dávkové projekty sú potrebné historické údaje.

Príprava na inštaláciu SimApi

• Táto časť popisuje dôležité informácie pre úspešnú inštaláciu SimApi.

64-bitový alebo 32-bitový SimApis

• Existujú 32-bitové a 64-bitové verzie každého SimApi.
• SIMCA-online a SIMCA sú 64-bitové a vyžadujú 64-bitové varianty SimApis. Staršie 32-bitové SimApis sú stále dostupné pre staršie inštalácie.

Miesto pre log file a nastavenia

• SimApi ukladá svoj denník files v skrytom priečinku Program Data1:
  %programdata%\Umetrics\SimApi, kde %programdata% sa mapuje na skutočný priečinok vo vašom počítači. Predvolene je to C:\ProgramData.
• Každé SimApi zvyčajne používa svoj vlastný protokol file, ktorý podobne ako protokol SIMCA-online servera file bude obsahovať viac alebo menej údajov v závislosti od nastavenia úrovne denníka. Toto file je užitočná pri riešení problémov. Denník file je pomenovaný
  .prihlásiť kde je SimApi, ktoré inštalujete, naprample PIAFsimApi. V ďalšej časti nájdete aj názvy inštancií SIMCA-online SimApi.
• Tento priečinok obsahuje aj nastavenia SimApi v XML file pomenovaný .xml.
• Väčšina SimApis má grafické používateľské rozhrania, ktoré menia nastavenia v xml file, no pri niektorých zadávate zmeny priamo do XML file pomocou textového editora, ako je napríklad Poznámkový blok. Pozrite si používateľskú príručku pre každé SimApi.

File mená, keď sa v SIMCA-online používajú pomenované inštancie

• V SIMCA-online má každá inštancia SimApi svoju vlastnú konfiguráciu file a log file pracovať s viacerými inštanciami každého SimApi. Názvy týchto files sú doplnené názvom inštancie, ako je uvedené na karte SimApi v dialógovom okne Možnosti servera SIMCA online.
• Nasledujúce example ukazuje pomenovanie týchto files, kde je potrebné nahradiť názvom SimApi.
• Názov konfigurácie zadaný pri pridávaní inštancie: OmegaServer
• Konfigurácia file meno: OmegaServer.xml
• Log file meno: OmegaServer.log
• Všimnite si, že generické file .log file je stále vytvorený. Tento denník file obsahuje záznamy, ktoré z technických príčin nie je možné nasmerovať do denníka file z prípadov..
• Tento priečinok je v systéme Windows štandardne skrytý. Vidieť to v File Prieskumník, ktorý nakonfigurujete, sa zobrazuje skrytý files. Upozorňujeme, že do skrytého priečinka môžete prejsť zadaním adresy File Panel s adresou prieskumníka.
• Upozorňujeme, že SIMCA nepodporuje viacero inštancií SimApi, a preto používa názvy bez názvu inštancie, ako je opísané vyššie.

Plánovanie siete

• SIMCA-online server by ste mali nájsť blízko zdroja údajov v sieti. To zaisťuje rýchle spojenie medzi SIMCA-online a jej dátovým zdrojom.
• Sieťové zariadenia môžu rušiť spojenie medzi SIMCA-online a zdrojom údajov.

Používateľské účty a povolenia zdroja údajov

• Zdroje údajov zvyčajne riadia prístup k svojim údajom. Zvyčajne sa to robí pomocou používateľských mien a hesiel, ale možno použiť aj obmedzenia založené na IP adrese alebo DNS (napr.ample PI dôveruje systému Aveva PI).
• Používateľské meno a heslo je možné poskytnúť zdroju údajov rôznymi spôsobmi:
• SimApi je spustený ako používateľ systému Windows používateľa so systémom SIMCA pre stolný počítač alebo s účtom služby SIMCA online na serverovom počítači. SimApi sa môže pripojiť k zdroju údajov pomocou tohto účtu. Takto fungujú OPC I a PI SimApi a ODBC, ak pri konfigurácii nezadáte poverenia.
• Pre všeobecné ODBC môžete použiť aplikáciu ODBC Data Sources Administrator, ktorá sa nachádza na Štart v systéme Windows.
• Niektorí poskytovatelia databáz poskytujú svoje vlastné ovládače a nástroje pre svoje databázy. databázy Oracle, napramppoužite súčasti Oracle Data Access Components (ODAC).
• Niektoré SimApis, ako napríklad PI AF a ODBC, majú konfiguračné dialógové okná, ktoré ukladajú zašifrované poverenia v konfigurácii SimApi XML. file.
• PI má tiež rôzne možnosti zabezpečenia dostupné v nástrojoch PI System Management Tools na počítači servera PI. Prečítajte si viac v používateľskej príručke PI AF SimApi. Táto príručka je užitočná, aj keď používate starší OSIsoft PI SimApi.
• OPC DA a HDA používajú DCOM ako prenos medzi zdrojom údajov a SimApi. DCOM je nakonfigurovaný pomocou nástroja Component Services (DCOMCNFG.EXE) v systéme Windows a používa overovanie systému Windows.
• Pre starší OSIsoft PI SimApi (nie novší AF SimApi) sa na nastavenie pripojenia k serveru PI používa aplikácia OSIsoft AboutPI-SDK (PISDKUtility.exe).

Overenie pripojenia zdroja údajov
Ak chcete nainštalovať SimApi do počítača, môže byť užitočné overiť pripojenie z tohto počítača k zdroju údajov pomocou iného nástroja:

• Zdroje údajov ODBC v systéme Windows sa používajú na konfiguráciu a testovanie generického ODBC. Upozorňujeme, že v 64-bitovom systéme Windows existujú dve verzie tohto nástroja: jedna pre 32-bitové aplikácie a jedna pre 64-bitové aplikácie. Na overenie pripojenia k databáze použite tlačidlo Test Data Source na konci sprievodcu konfiguráciou ODBC. Odporúčame, aby ste svoje zdroje údajov nakonfigurovali ako systémové DSN.
• Nástroj na pripojenie špecifický pre databázu od poskytovateľa databázy, ako sú komponenty Oracle Data Access Components.
• PI System Explorer možno použiť na testovanie pripojenia k serveru PI AF. Je súčasťou klienta PI AF, ktorý je nevyhnutným predpokladom pre PI AF SimApi.
• OPC UA Expert od Unified Automation – UaExpert je multiplatformový testovací klient pre OPC UA servery.
• Aplikáciu PI-SDK (PISDKUtility.exe) je možné použiť na testovanie konektivity a na view akékoľvek chybové hlásenia, ktoré mohli byť zaznamenané, keď sa SIMCA-online pokúša pripojiť k serveru PI. Toto sa používa iba pre staršie OSIsoft SimApi, nie PIAF.
• Nástroje na správu systému PI sa používajú na serveri PI na riešenie problémov z tejto strany. Naprample, hľadať bezpečnostné problémy, ktoré bránia prístupu zo SIMCA-online servera. Ďalšie informácie o riešení problémov so systémom PI nájdete v tomto videu YouTube.
• Excel je možné použiť na získanie údajov z pripojenia ODBC a väčšiny ostatných systémov, keď je nainštalovaný vhodný doplnok.
• Matrikon OPC Explorer for Ior HDA (toto sú samostatné nástroje) možno použiť na testovanie OPC konektivity a Matrikon OPC Analyzer možno použiť na diagnostiku problémov s OPC konektivitou. Stiahnite si tieto bezplatné nástroje z https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (pre DInd HDA) z OPC Training Institute web stránka „umožňuje používateľom jednoducho diagnostikovať komunikačné a bezpečnostné problémy a okamžite ich opraviť stlačením tlačidla. To všetko sa dá urobiť bez toho, aby ste sa museli učiť konfigurovať DCOM“

Inštalácia SimApi

Tu je postup, ako nainštalovať SimApi do počítača:

1. Prečítajte si používateľskú príručku pre SimApi, ktoré inštalujete. Obsahuje špecifiká pre toto SimApi, ktoré dopĺňajú všeobecné pokyny, ktoré práve čítate.
2. Nainštalujte a nakonfigurujte všetky predpoklady uvedené v používateľskej príručke SimApi (naprampovládače databázy alebo súpravy SDK)
3. Spustite inštalačný program a nainštalujte SimApi. Nainštalujte 64-bitovú (x64) alebo 32-bitovú (x86) verziu, ktorá zodpovedá softvéru, v ktorom ju budete spúšťať.
4. Nakonfigurujte SimApi v SIMCA-online alebo SIMCA podľa popisu v nasledujúcich častiach a pozrite si používateľskú príručku k SimApi, kde nájdete popisy dostupných nastavení.
5. Spustite SIMCA-online server. Upozorňujeme, že to môže chvíľu trvať, pretože keď je SimApi inicializované, vymenuje všetky tags v zdroji údajov.
6. Otestujte SimApi získaním niektorých údajov. Pre SIMCA-online môžete použiť File > Extrahujte podľa popisu v 6.1.
7. Ak SimApi nefunguje podľa očakávania, pozrite si denník SimApi files na riešenie problémov a na používateľskú príručku SimApi.

Nastavenie SimApi na použitie v SIMCA

Tu je návod, ako používať SimApi v SIMCA:

1.  Spustite import databázy jedným z nasledujúcich spôsobov:
   • a. Vytvorenie nového projektu v SIMCA: File > Nový pravidelný projekt alebo nový dávkový projekt. Na karte Domov vyberte položku Z databázy.
   • b. Import množiny údajov v existujúcom projekte v SIMCA: Z množiny údajov na karte Údaje v otvorenom projekte SIMCA.
2. Kliknite na položku Pridať nový zdroj údajov
3. Ako typ pripojenia vyberte SimApi, kliknite na tlačidlo ... a nájdite .dll v inštalačnom priečinku a kliknite na Otvoriť.
4. Kliknite na Konfigurovať a pozrite si individuálnu používateľskú príručku SimApi, ako vykonať nastavenia.
5. Kliknite na Testovať pripojenie zdroja údajov a overte, či sa môžete pripojiť k databáze. Ak je ich veľa, môže to trvať dlho tags v zdroji údajov.
6. Kliknutím na tlačidlo OK dokončite konfiguráciu.
7. Informácie o tom, ako pracovať s importovanými údajmi, nájdete v pomocníkovi SIMCA.

Nastavenie SimApi na použitie v SIMCA-online

• Dôležité: Aby ste mohli používať SimApi, vyžaduje sa SIMCA-online serverová licencia. Demo inštalácia SIMCA-online neumožňuje používať SimApis.
• Ak chcete pridať SimApi do systému, spustite SIMCA-online Server Options na serverovom PC. Podrobné kroky nájdete v téme online pomocníka SICMA Pridanie a konfigurácia SimApi na serveri.
• Tip: Ak vykonáte zmeny pre SimApi, môžete toto SimApi reštartovať oddelene od Možnosti servera bez reštartovania celého servera.
• Ak chcete nakonfigurovať viacero inštancií tohto SimApi, zopakujte vyššie uvedené kroky a použite jedinečné názvy pre každú inštanciu. Prečítajte si viac o rôznych protokoloch a konfigurácii files pre prípady v 4.2.

Testovanie a riešenie problémov so SimApi

• Táto kapitola je o testovaní a riešení problémov s inštaláciou SimApi.

Testovanie SimApi od SIMCA-online

• Po úspešnom spustení SIMCA-online servera môžete svoje SimApi otestovať v SIMCA-online (ak sa server nespustí, pozrite si 6.2):
• Prihláste sa na server v SIMCA-online klientovi a prejdite na Extract na File tab. Extract vám pomôže otestovať SimApi získavaním údajov prostredníctvom neho:
• V ľavom poli sú zobrazené uzly („priečinky“) SimApi. Tags pre vybraný uzol sú zobrazené vpravo hore.
• Aktuálne údaje je možné rýchlo otestovať jednoduchým kliknutím view> zapnuté tags ktoré poskytujú údaje o nepretržitom procese (pozri snímku obrazovky)
• Kliknite pravým tlačidlom myši na uzol, aby ste našli dávky v časovom rozsahu. Uzol musí byť dávkový uzol, ktorý vie o dávkach.
• Vyberte tags v Extrahovať a kliknite na Ďalej a dokončite sprievodcu na získanie údajov pomocou rôznych režimov získavania údajov: aktuálne, historické, dávkové a diskrétne údaje.
• Porovnajte extrahované údaje s tým, čo vidíte vo svojom zdroji údajov pomocou jeho nástrojov. Zistite viac o testovaní a overovaní všetkých funkcií SimApi v 7.13.

Riešenie problémov so SimApi pomocou denníka SimApi file

• Ak sa server nespustí, SimApi nefunguje podľa očakávania alebo extrahovanie zlyhá, musíte si pozrieť denník SimApi file ktorý vám povie, v čom je problém. Ak chcete získať úplné podrobnosti, povoľte protokolovanie na úrovni ladenia v protokole SimApi. Pozri 4.2.
• Poznámka: Protokoly servera SIMCA online tu nie sú také užitočné. Ukážu, ako bolo SimApi načítané a inicializované serverom, ale špecifické podrobnosti SimApi sú v jeho protokole file.

Použite správny účet SIMCA-online služby

• Keď testujete prístup k zdroju údajov, pamätajte na to, že ste prihlásení ako konkrétny používateľ na serverovom počítači (zvyčajne vaše vlastné používateľské konto v doméne Windows), ale že konto služby SIMCA-online servera je iné konto, predvolene LocalSystem, ktoré má iné prístupové práva v porovnaní s vaším používateľským účtom.
• Z tohto dôvodu nie je nezvyčajné, že testy fungujú, keď sú spustené ako váš účet, ale SIMCA-online sa nedokáže pripojiť k zdroju údajov.
• Na vyriešenie tohto problému je potrebné udeliť prístup pre účet používaný službou SIMCA-online server. Zvyčajne zmeníte LocalSystem na konkrétne konto doménovej služby a tomuto kontu udelíte práva. Upozorňujeme, že to neplatí, ak SimApi používa poverenia, ktoré sú nastavené v konfigurácii SimApi, pretože tieto poverenia majú prednosť.

Technické podrobnosti o SimApis

• Táto kapitola poskytuje technické podrobnosti o tom, ako funguje SimApi. Zameriava sa hlavne na vývojárov, ktorí chcú pochopiť SimApis, aby implementovali SimApi pre zdroj údajov.
• Vývojári by si tiež mali prečítať predchádzajúce časti tohto dokumentu, kde nájdete úvod do SimApis a popisy funkcií na vysokej úrovni.

Kedy zvážiť vývoj SimApi a kedy nie?

Pred zvážením vývoja SimApi pre zdroj údajov:

1. Preskúmajte, či už existuje SimApi, ktoré môžete použiť. Možno môžete povoliť nejakú funkciu vo svojom zdroji údajov, aby ste mohli používať jeden z existujúcich SimApis, ako napríklad OPC UA.
2. Pozorne si prečítajte tento dokument a jeho referencie a zistite, či váš zdroj údajov spĺňa požiadavky: naprample, musí byť dostatočne rýchly, poskytovať nielen aktuálne údaje, ale aj historické údaje.

• Z týchto dôvodov neodporúčame vyvíjať SimApi, ktoré sa pripája k hardvéru alebo nástrojom nízkej úrovne. Je lepšie pripojiť tieto prístroje k procesnému historikovi, akým je Aveva PI System, a nechať ho získať dáta z prístroja a historizovať ich. Potom je možné použiť PIAF SimApi na získanie údajov z PI do produktu Umetrics.

Vývoj SimApi a špecifikácia SimApi

• Špecifikácia SimApi, SimApi-v2, obsahuje dokumentáciu pre všetky C-funkcie v SimApi, ktoré musí SimApi DLL implementovať, ako aj niektoré pokyny na vývoj SimApi.
• Implementácia SimApi pomocou C alebo C++ je vo väčšine prípadov na zbytočne nízkej úrovni.
• Odporúčaný a jednoduchší spôsob implementácie SimApi je založiť ho na ExampleSimApi zdrojový kód, ktorý poskytujeme. Ide o example SimApi implementácia, ktorá spracováva C-rozhranie a prekladá ho do.NET Framework, kde sa vykonáva skutočná implementácia. Má tiež rámcový kód pre protokolovanie, nastavenia, konfiguračné GUI a ďalší rámcový kód.
• Na vývoj SimApi potrebuje tím vývojárov skúsenosti s vývojom pre Windows, .NET Framework, C alebo C++. Vyžaduje sa aj dobrá znalosť zdroja údajov, ku ktorému sa má SimApi pripojiť, pretože účelom SimApi je prekladať požiadavky na údaje zo SIMCA-online alebo SIMCA do API zdroja údajov. Implementácia SimApi nikdy nie je jednorazový projekt, ale zvyčajne potrebuje nepretržitú podporu a občasnú údržbu.

Čítanie alebo zápis údajov

• Hlavnou úlohou SimApi je poskytovať údaje zo zdroja údajov. Toto sa označuje ako čítanie údajov.
• Väčšina implementácií SimApi podporuje aj zápis údajov. To znamená spätný zápis údajov cez SimApi do zdroja údajov. Zapisovanie údajov je voliteľná funkcia v SIMCA-online.

Tags a Uzly

• A tag je identifikátor stĺpca alebo „premennej“ v zdroji údajov. A tagmeno sa používa na identifikáciu tag. Názvy v rámci uzla musia byť jedinečné. SIMCA-online 18 je prvou verziou, ktorá podporuje uzol, ktorý obsahuje poduzlový uzol a tag s rovnakým názvom. Naprample: uzol Parent môže mať poduzol s názvom Batch a a tag s názvom Batch.
• Uzol je kontajner z tags. Uzol môže obsahovať aj iné uzly, podobne ako a file systém má priečinky v priečinkoch.
• Ako v a file systém, uzol a tag mená môžu byť kombinované do úplnej cesty, ktorá jednoznačne identifikuje a tag. The tag cesty sa používajú v SIMCA-online alebo SIMCA pri výbere tags používať. A tag cesta začína názvom inštancie SimApi, za ktorým nasleduje štruktúra uzla a končí sa tag názov, každá položka oddelená dvojbodkou (:). Naprample “:ODBCSQLServer:Node:SensorTag1“.

Enumeruje SimApi tags a uzly pri spustení

• Implementácia SimApi prehľadáva server a hľadá uzly a tags v zdroji údajov, keď sa SimApi inicializuje, a sleduje ich, takže rôzne funkcie SimApi, ktoré sa používajú na enumeráciu tags a uzol je možné implementovať.
• Inicializácia SimApi neprebieha len pri štarte servera, ale môže byť znovu spustená aj používateľom v SIMCA-online pomocou funkcie Refresh SimApi.

Rozlišovanie malých a veľkých písmen tag- a názvy uzlov

• Tag názvy a názvy uzlov rozlišujú veľké a malé písmená.
• Teda a tag s názvom “tag1“ nie je to isté ako „Tag1“ z dôvodu odlišného prípadu „T“. Odporúčame nepoužívať tags alebo názvy uzlov, ktoré sa líšia iba veľkosťou písmen.

Uzol nepretržitého procesu 

• Keď uzol obsahuje tags s nepretržitými procesnými dátami ho možno označiť ako procesný uzol. Nasledujúce dve snímky obrazovky zobrazujú tabuľkovú reprezentáciu uzla procesu s údajmi, za ktorými nasleduje obrázok znázorňujúci, ako uzol vyzerá pri výbere tags v SIMCA-online.

Uzly nepretržitého procesu musia byť nezávislé od dávok, chodov alebo času

• Aby dobre fungoval v SimApi, uzol musí byť nezávislý od dávok, chodov alebo času. Mať uzol, ktorý obsahuje údaje pre konkrétnu dávku alebo časový rozsah, by v SIMCA-online nefungovalo dobre, pretože konfigurácia projektu by potom mohla čítať iba údaje pre túto dávku a nemohla by sa použiť pre iné dávky.
• Namiesto toho by mal byť uzol mapovaný na jednu alebo viac fyzických jednotiek v procese, kde sa vykonávajú merania.

ID šarže tag potrebné v uzloch nepretržitého procesu na vykonávanie dávkového projektu

• Každý nepretržitý proces musí mať a tag (premenná) s identifikátorom dávky pre každé pozorovanie. Tento identifikátor šarže používa SIMCA alebo SIMCA-online, aby vedel, do ktorej šarže patrí každé pozorovanie.
• $ BatchID tag na screenshotoch v 7.4.3 je taký example.
  Aj keď sa to nevyžaduje, odporúča sa mať a tag v uzle procesu, ktorý zobrazuje aktuálnu fázu alebo krok procesu. Toto tag možno potom použiť v podmienkach vykonávania fázy v SIMCA-online alebo v SIMCA pri importe údajov. Hodnoty pre toto tag môže byť naprample „fáza 1“, „čistenie“, „fáza 2“.

Dávkový kontextový uzol

• Dávkový uzol je uzol, ktorý sleduje dávky; ich identifikátory dávok, časy začiatku a časy ukončenia. Je to požiadavka na dávkové vykonávanie projektu v SIMCA-online. Zdroj údajov môže mať viac ako jeden dávkový uzol, ktorý sprístupňuje dávky rôznymi spôsobmi. Používateľ si vyberie dávkový uzol, ktorý sa vzťahuje na jeho aplikáciu. Tento example odhaľuje dávky, ktoré zahŕňajú dve rôzne jednotky:
• /Factory1 – dávky s agregovanou životnosťou počas Unit1 a Unit2.
• /Factory1/Unit1 – dávky s životnosťou len v Unit1
• /Factory1/Unit2 – dávky s životnosťou len v Unit2
• Ak nemáte dávkový uzol vo svojom zdroji údajov, môžete použiť dávkový kontextový generátor v SIMCA-online. Pozrite si vstavaného pomocníka.
• Voliteľné údaje o šarži
• Uzol dávky môže obsahovať aj údaje o dávke; údaje, pre ktoré existuje len jedno pozorovanie pre celú dávku. Všimnite si to tags s údajmi o dávke nemusia byť v uzle, ktorý má plnú funkčnosť uzla dávky. Stačí, že SimApi podporuje čítanie dávkových údajov pre tags. Viac informácií o údajoch o dávkach nájdete v 7.6.
• Tu je bývalýample dávkového uzla:
• Poznámka: Vyššie uvedená snímka obrazovky je prevzatá z DBMaker, dodávaného so SIMCA-online. Ak si to chcete pozrieť v DBMaker, kliknite na View Tlačidlo Údaje v databáze Bakers Droždie na zobrazenie dvoch okien, z ktorých jedno je uzol šarže a druhé údaje procesu.

Typy údajov: číselné údaje, textové údaje a chýbajúce údaje

• Pre každého tagSimApi môže podporovať tri typy údajov: numerické, textové, t a chýbajúce:
• Číselné údaje sú typicky reálne hodnoty parametrov procesu, naprample 6.5123. SimApi dokáže spracovať iba 32-bitové hodnoty s jednoduchou presnosťou. Formát s plávajúcou desatinnou čiarkou s jednou presnosťou - Wikipedia. Všetky ostatné typy číselných údajov v zdroji údajov by sa mali skonvertovať na pohyblivé. Ako také môžu pracovať s veľkými aj malými hodnotami, ale iba so 6 alebo 7 platnými číslicami. Viac sa dozviete v Technickej príručke.
• To môže viesť k strate presnosti pre veľké celé čísla alebo pre reálne čísla, ktoré sú veľké aj desatinné. Ďalšie informácie nájdete v Technickej príručke.
• Textové/reťazcové údaje sa používajú pre ID dávok, podmienky vykonávania fázy alebo pre kvalitatívne premenné. Hodnoty pre text tag údaje rozlišujú veľké a malé písmená. To znamená, že hodnota „beží“ nie je rovnaká ako
  „BEH“. Premenné dátumu a času nie sú podporované priamo SimApi, ale môžu byť vrátené ako reťazec vo formáte RR-MM-DD HH:MM (napr.ample “2020-09-07 13:45”).
• Chýbajúce hodnoty znamenajú, že neexistuje žiadna hodnota na vrátenie, tj žiadne údaje.
• Aký typ sa vráti, závisí od implementácie SimApi. SimApi vie o údajoch v zdroji údajov a mal by vrátiť typ údajov, ktorý najlepšie vyhovuje.

Tri režimy získavania údajov: nepretržité, batc, ha a diskrétne

• Špecifikácia SimApi definuje tri režimy získavania údajov, tj. Tri rôzne spôsoby, ako môže SimApi poskytovať údaje tags v zdroji údajov (alebo v opačnom smere: zapisovať údaje do tags v zdroji údajov).
• Nepretržité získavanie údajov – ide o údaje, ktoré sa čítajú nepretržite a sekvenčne, pozorovania na každé pozorovanie, ako sa dávka alebo proces vyvíja. Údaje sa čítajú pre aktuálny čas alebo pre určitý rozsah v pravidelnom intervale medzi pozorovaniami. Naprample, všetky údaje medzi 09:00:00 a 10:00:00 sampvedené každých 60 sekúnd, čo viedlo k 61 pozorovaniam, ak sú zahrnuté aj koncové body.
• Hromadné získavanie údajov – ide o jedno pozorovanie s údajmi pre celú dávku (nie je spojené s konkrétnou splatnosťou alebo časovým bodom). Atribúty dávky a údaje o lokálnom centrovaní sa v SIMCA-online čítajú ako údaje o dávkach. Dávkové podmienky sa normálne čítajú aj ako dávkové dáta (pokiaľ nie sú nakonfigurované na diskrétne získavanie dát).
• Diskrétne získavanie údajov – diskrétne údaje môžu pozostávať z niekoľkých pozorovaní pre mnohé splatnosti. Na rozdiel od nepretržitých údajov sa však diskrétne údaje nečítajú postupne, ale všetky údaje naraz pre konkrétnu fázu dávky. Údaje nemusia byť oddelené pravidelnými intervalmi premennej splatnosti. Všetky údaje sa znova načítajú pri každom vyžiadaní údajov v nakonfigurovanom intervale.
• Za akúkoľvek danosť tag údaje možno požadovať v ktoromkoľvek z troch režimov, ale zvyčajne SimApi podporuje iba jeden z týchto režimov pre jednotlivca tag. Rovnako sa nechá premiešať tags v rámci uzla, ale zvyčajne všetky tags v rámci špecifického uzla podporujú rovnaký režim získavania údajov.
• Pre spojité údaje (ale nie pre dávkové alebo diskrétne údaje2) možno zadať aktuálne údaje alebo historické údaje, čo je témou nasledujúcej časti.
• Nie všetky SimApis podporujú všetky režimy. Pozrite si maticu funkcií vyššie a SimApi web pre podrobnosti.

Aktuálne a historické nepretržité údaje prostredníctvom SimApi

• Nepretržité údaje sa týkajú údajov o procese, ktoré sa časom menia.

Aktuálne údaje

• Čítanie aktuálnych údajov znamená požiadať zdroj údajov o najnovšie hodnoty tags v čase dopytovania. Všimnite si, že čas externého zdroja údajov sa tu nepoužíva.
• Údaje načítané ako aktuálne údaje SIMCA-online zobrazí ako živé údaje. Z tohto dôvodu je dôležité, aby v zdroji údajov nedochádzalo k zbytočným oneskoreniam. Aktuálne údaje by mali byť čo najaktuálnejšie, aby dobre fungovali v SIMCA-online.
• Zdroj údajov môže využiť svoje znalosti údajov a toho, ako dlho sú hodnoty platné, a rozhodnúť sa vrátiť chýbajúce údaje, keď sú nespracované údaje pre určitý časový bod príliš staré. Naprample: údaje sa vyžadujú o 15:00:00, ale posledný údajový bod v zdroji údajov je z 03:00:00. V tomto prípade sú dáta staré 12 hodín, takže SimApi sa môže rozhodnúť vrátiť chýbajúcu hodnotu (žiadne dáta).

Historické údaje

• Čítanie historických údajov znamená požiadať zdroj údajov o hodnoty jednej alebo viacerých tags pre konkrétny časový rozsah so špecifickým intervalom medzi pozorovaniami. Všimnite si, že tu ide o miestny čas zdroja údajov, ktorý sa používa na vyhľadanie údajov. Preto je dôležitá časová synchronizácia medzi zdrojom údajov a servermi.
• Historické údaje pozostávajú z matice údajov. Je na implementácii SimApi, aby si vyžiadala údaje zo zdroja údajov a sampnechajte ho v zadanom intervale a vytvorte maticu údajov, ktorá vráti:
• Niekedy má samotný zdroj údajov agregačné funkcie na vrátenie spracovaných údajov alebo sampling funkcie, ktoré možno použiť na vrátenie správnych údajov.
• Pre iné zdroje údajov musí SimApi vyžiadať všetky údaje v časovom rozsahu a potom sample správne pozorovania na zostavenie matice.
• Údaje sa musia vrátiť pre určitý časový rozsah, aj keď v časovom rozsahu nemusia byť nespracované údaje, ale iba tesne pred časom začiatku. Naprample: údaje existujú v zdroji údajov v časových bodoch 10 a 20. SimApi požaduje údaje pre čas 15 a 17. V tomto prípade by hodnoty pre časový bod 10 malo vrátiť SimApi, ale timestamped ako čas 15 a 17, pretože v tom čase to boli najnovšie údaje. Hodnoty pre tags v čase 10 sa označujú ako medzné hodnoty pre požadovaný rozsah. Pre hlbšie vysvetlenie hodnôt hraníc pozri naprampdokumentácia pre returnBounds v UA, časť 11: Historický prístup – 6.4.3 ReadRawModifiedDetails štruktúra
  (opcfoundation.org)
• Interpolácia by sa nikdy nemala používať na výpočet hodnôt pre budúce časové body, pretože údaje sa nezhodujú s tým, čo sa číta v reálnom čase ako aktuálne údaje. Pre example z predchádzajúcej odrážky: ak by sa údaje pre 15 a 17 mali interpolovať pomocou hodnôt pre položky 10 a 20, efektívne by použili hodnoty z budúcnosti, čo nie je povolené.
• Zdroj údajov môže využiť svoje znalosti údajov a toho, ako dlho sú hodnoty platné, a rozhodnúť sa vrátiť chýbajúce údaje, keď sú nespracované údaje za určitý časový bod staré. Napríkladample: údaje sa vyžadujú o 15:00:00, ale najnovší údajový bod v zdroji údajov je z 03:00:00. V tomto prípade sú dáta staré 12 hodín, takže SimApi sa môže rozhodnúť vrátiť chýbajúcu hodnotu (žiadne dáta).

Poznámka: SIMCA-online zvyčajne počas bežnej realizácie projektu nepožaduje viac ako sto pozorovaní v jednej výzve. Pri extrakcii v SIMCA-online alebo pri spustení desktopovej SIMCA je možné vykonať väčšie požiadavky na dáta. Tieto môžu trvať dlho, čo sa dá očakávať.

Aktuálne údaje a historické údaje sa musia zhodovať

• Niekedy môžu existovať rozdiely, keď sa údaje čítajú ako aktuálne údaje v reálnom čase alebo historické údaje. To spôsobuje problémy v SIMCA-online, pretože server podľa potreby automaticky prepína medzi aktuálnymi a historickými údajmi.

Zber údajov s nízkou latenciou

• Keď SIMCA-online používa zdroj údajov v reálnom čase, je dôležité, aby údaje v zdroji údajov boli aktuálne. Pri získavaní údajov v zdroji údajov by nemalo dochádzať k zbytočným oneskoreniam. Priebežné procesné dáta pre všetky premenné musia byť dostupné v rovnakom čase pre každé pozorovanie. Údaje, ktoré prídu neskoro pre niektoré premenné, SIMCA-online nezoberie.

Dáta je možné čítať kedykoľvek 

• Keď SIMCA-online požaduje hodnotu a tag pre čas t dostane hodnotu zo zdroja údajov od času t, alebo posledného pozorovania v zdroji údajov pred časom t, alebo interpolovanú hodnotu pre čas t. Server teda vždy dostane hodnotu vždy, keď o to požiada, aj keď v zdroji údajov nemusí existovať pozorovanie pre tento presný časový bod.
• Časamps v SimApi sú vždy UTC. SIMCA-online klienti a SIMCA prezentujú čas ako miestny čas.

Navliekanie závitov 

• SimApi je štandardne volané jedným vláknom užívateľom SimApi. To platí pre všetky verzie SIMCA a SIMCA-online až do verzie 17.
• SIMCA-online 18 podporuje príznak funkcie na zapnutie viacvláknového prístupu cez SimApi. Prečítajte si viac v téme pomocníka Súčasný prístup k SimApi.
• To znamená, že SimApis by sa mal pripraviť na multi-threading, ak je to možné, zabezpečením implementačného vlákna SimApi a zdokumentovať toto a akékoľvek úvahy pre používateľov SimApi.

Log file

• SimApi by malo zaznamenávať akcie, chybové hlásenia a varovania do svojho denníka file pomôcť pri riešení problémov. Použite rôzne úrovne protokolov na vyjadrenie dôležitosti protokolovania.
• Pre funkcie, ktoré neboli implementované v SimApi, sa odporúča prihlásiť „Neimplementované“.

Spracovanie chýb

• Keď SimApi nemôže splniť požiadavku zo zdroja údajov, môže tento problém vyriešiť jedným z dvoch spôsobov; vrátením chýbajúcich hodnôt (žiadne údaje) alebo signalizáciou chyby SimApi:
• Vrátenie chýbajúcich hodnôt volajúcemu a signalizácia úspechu umožňuje volajúcemu pokračovať ako obvykle (ale samozrejme bez akýchkoľvek údajov). Toto je odporúčaný postup pre čiastočné chyby, napríklad keď je možné získať údaje pre niektoré, ale nie všetky, tags v žiadosti.
• Signalizácia chyby SimApi umožňuje volajúcemu (naprampna SIMCA-online server), aby ste to okamžite videli a mohli konať. Toto je odporúčaný postup pre požiadavky, ktoré úplne zlyhajú a nemôžu vrátiť žiadne údaje.
• SIMCA-online zaobchádza s chýbajúcimi hodnotami alebo chybovými kódmi inak, ako je popísané v technickej príručke SIMCA-online.

Požiadavky na výkon SimApi

• Funkcie v SimApi sa používajú na získavanie údajov.
• Ak je prístup k údajom pomalý, SimApi nebude fungovať dobre, čo naprample ukazuje: Ak SIMCA-online požaduje dáta každú sekundu, ale ich získanie trvá dve sekundy, SIMCA-online server nikdy nebude schopný držať krok v reálnom čase, ale postupne bude stále viac a viac zaostávať.
• V podsekciách si ukážeme, ako SIMCA a SIMCA-online využívajú funkcie SimApi pre prístup k dátam a ako často budú funkcie SimApi volané. To môže pomôcť pri nastavovaní požiadaviek na výkon pre implementáciu SimApi.

Používanie funkcií SimApi SIMCA

• Keď počítačová SIMCA alebo iné offline produkty používajú na získanie údajov SimApi, tieto požiadavky sa budú týkať dávok a údajov spracovania pre množinu premenných v určitom časovom rozsahu.
• Keďže tieto požiadavky spúšťa manuálne používateľ, nevyskytujú sa príliš často a nespôsobujú významné zaťaženie zdroja údajov.
• Na získanie údajov sa používajú tieto funkcie SimApi:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

Používanie funkcií SimApi SIMCA-online

• SIMCA-online sa používa na monitorovanie procesu v reálnom čase, a preto v pravidelných intervaloch vyžaduje údaje cez SimApi. Najkratší interval vykonania, ktorý je možné použiť, je 1 sekunda. Niektorí bývalí v reálnom sveteampintervaly vykonávania sú 10 s, 1 minúta alebo 10 minút.
• Server môže mať spustených viacero projektov súčasne.
• Aby sa znížil počet volaní API prostredníctvom SimApi, server optimalizuje požiadavky na údaje zoskupením mnohých súbežných menších požiadaviek do jednej väčšej požiadavky pre všetky premenné súčasne (viac sa dozviete v téme pomocníka „Optimalizované čítanie zo zdrojov údajov zlepšuje výkon“).
• Algoritmus vykonávania servera funguje takto, keď požaduje údaje pomocou funkcií SimApi uvedených nižšie:
• Všetky fázy, ktoré sa vykonávajú v rovnakom intervale, sú zoskupené do jedného volania SimApi, aby sa znížil počet volaní. Server načíta najnovšie údaje pre všetky premenné používané všetkými modelmi, ktoré zdieľajú interval, tj výsledkom tohto volania bude široký riadok údajov, ktorý potom používajú všetky projekty.
  • simapi2_connectionReadCurrentData
• Pre každý dávkový projekt musí server tiež vedieť, ktoré dávky sú aktívne. Toto sa tiež musí stať vždy, keď sa projekt vykonáva:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes sa volá menej často.
• Okrem toho SIMCA-online vyžaduje aj historické údaje. Tieto požiadavky sa vyskytujú iba vtedy, keď je to potrebné, ako je dobehnutie začiatku dávky, ktorá sa začala pred spustením SIMCA-online, alebo keď server zaostáva a potrebuje prečítať blok údajov:
  • simapi2_connectionReadHistoricalDataEx
• Voliteľne niektoré konfigurácie projektu používajú funkcie, ktoré používajú dávkové údaje alebo diskrétne údaje, čo vedie k volaniam SimApi:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Voliteľne niektoré konfigurácie projektu používajú spätný zápis na vrátenie údajov späť do zdroja údajov:
  • simapi2_connectionWriteHistoricalDataEx (a zodpovedajúce funkcie pre dávkové dáta, diskrétne dáta)
• Je dôležité, aby každé volanie základných funkcií na získanie údajov, readCurrentData, getActiveBatches/getBatchTimes, bolo rýchle a aby to nebolo výpočtovo náročné pre samotný zdroj údajov, vzhľadom na to, ako často môže SIMCA-online volať tieto funkcie.

Testovanie a overovanie údajov SimApi

• Táto časť je o testovaní rozhrania SimApi, aby sa overilo, či sa údaje vrátené z neho zhodujú s údajmi v samotnom zdroji údajov. Spustenie takýchto testov je dôležité po vytvorení alebo zmene implementácie SimApi alebo keď sa zmení rozhranie API zdroja údajov.
• V praxi sa validácia údajov vykonáva pomocou SIMCA-online a jej funkcie Extrahovať na získanie údajov zo zdroja údajov cez SimApi a potom na porovnanie s nespracovanými údajmi v zdroji údajov. Desktop SIMCA nemožno použiť na testovanie aspektov SimApi v reálnom čase.

Prípravy a požiadavky

• Niektoré položky sú voliteľné, ale možno ich vykonať, ak to zahŕňa rozsah vášho testovania:

1. Nainštalujte SIMCA-online podľa popisu v súbore ReadMe and Installation Guide.pdf, ktorý je súčasťou zipsu produktu.
2. Získajte licenciu pre SIMCA-online server a nainštalujte ho. SimApi nebude fungovať bez licencie. Článok databázy znalostí pre SIMCA-online ukazuje, ako licencovať produkt. Naprample: SIMCA-online 18 (sartorius.com)
3. Nainštalujte a nakonfigurujte SimApi, ktoré chcete otestovať. Pozrite si kapitoly 4 – 5 v tomto dokumente a používateľskú príručku konkrétneho SimApi.
   • a. Voliteľné: uistite sa, že používateľská príručka je aktuálna a správna.
4. Uistite sa, že máte pre svoj zdroj údajov nástroj, s ktorým môžete porovnávať údaje SimApi.
5. V desktopovom klientovi SIMCA-online sa prihláste na svoj server SIMCA-online a používajte ho File > Extrahujte, aby ste získali údaje cez SimApi.
6. Voliteľné, ak to váš rozsah testovania zahŕňa: po dokončení testovania odinštalujte SimApi a overte ho files sú odstránené.

Čo testovať

• Matica funkcií v kapitole 3 uvádza všetky možné funkcie, ale daná implementácia SimApi môže podporovať iba podmnožinu. Mali by ste otestovať všetky funkcie, ktoré sú implementované daným SimApi.
• Nasledujúce testy sú spoločné pre väčšinu implementácií SimApi:
• Autentifikácia pomocou používateľských mien a hesiel
• Vyskúšajte rôzne nastavenia v konfigurácii SimApi
• Hierarchia uzlov: Uzly a tags vystavené SimApi sú správne.
  • Musí tam byť a tag vystavené pre všetky „premenné“, ktoré by mali byť dostupné cez SimApi. Napramples: procesné merania, vypočítané hodnoty, konštanty.
• Odolnosť pripojenia: ak je zdroj údajov nedostupný, výsledkom sú upozornenia alebo chyby v protokole file, ale že pripojenie k zdroju údajov sa automaticky obnoví, keď bude zdroj údajov dostupný.
• Viacnásobné inštancie: že dve inštancie môžu byť nakonfigurované a používané nezávisle a súčasne, so samostatnými protokolmi files.
• Aktuálne údaje: extrahujte aktuálne údaje pre tags. Uistite sa, že údaje sú poslednými známymi hodnotami zo zdroja údajov alebo chýbajú pre nízku kvalitu alebo keď sú údaje príliš staré.
  • Extrahujte dáta každých 10 sekúnd (alebo tak) po dobu jednej minúty.
• Historické nepretržité údaje: extrahujte historické údaje pre tags.
  • Použite časový rozsah, ktorý sa zhoduje s časom extrahovania aktuálnych údajov. Overte, či sa aktuálne údaje zhodujú s historickými údajmi a nespracovanými údajmi v zdroji údajov.
  • Vyskúšajte rôzne časové rozsahy a sampling intervaly, overte, či sa údaje zhodujú so zdrojom údajov.
  • Skúste extrahovať dáta každú 1 s, čo je najkratšia možná sampling interval.
  • Vyskúšajte rôzne druhy tags v zdroji údajov (procesné premenné atď.), pričom sa uistite, že sa údaje zhodujú.
  • Poznámka: SIMCA-online môže rozdeliť jednu veľkú požiadavku na historické údaje na niekoľko menších častí. Toto bude viditeľné v denníku SimApi.
• Overte, či SimApi pracuje s textovými údajmi, číselnými údajmi a chýbajúcimi údajmi.
• denník SimApi file. Skontrolujte, či denník obsahuje primerané položky.
• Dávkový uzol: kliknite pravým tlačidlom myši na uzol a vykonajte Nájsť dávky.
  • Overte názvy dávok, časy začiatku a konca dávok.
  • Vyskúšajte aktívnu dávku, ktorá je spustená v zdroji údajov. Cez SimApi by nemal mať čas ukončenia.
• Identifikátor dávky uzla procesu tag. Ak má SimApi funkciu dávkového uzla (pozri predchádzajúcu odrážku), musí mať aj identifikátor dávky tag v uzle zodpovedajúcich údajov procesu. Údaje na to tag by mal byť identifikátor šarže (názov šarže). Tieto údaje sú potrebné pre dávkové projekty na identifikáciu, do ktorej dávky patrí riadok údajov.

V závislosti od toho, či to SimApi podporuje, môžete tiež vyskúšať:

• Dávkové údaje pomocou File > Extrahovať.
• Použitie diskrétnych údajov File > Extrahovať. Poznámka: na testovanie diskrétnych údajov pomocou File > Extrahujte uzol, dávkový uzol a diskrétny dátový uzol musia byť v rovnakom SimApi (keď SIMCA-online vykonáva projekty, môžu byť z rôznych SimApis).
• Write back – odoslanie dávky údajov do zdroja údajov. Aby ste to otestovali, musíte nakonfigurovať konfiguráciu projektu v SIMCA-online na spätné zapisovanie vektorov údajov do zdroja údajov. Potom spustite projekt v SIMCA-online a skontrolujte údaje, ktoré sú zapísané späť v zdroji údajov.
• Nepretržité údaje sa konfigurujú na stránke Evolution Write Back v konfigurácii projektu.
• Diskrétne údaje sú nakonfigurované na tej istej stránke, ale iba pre fázu nakonfigurovanú na získavanie diskrétnych údajov.
• Dáta dávky zo spätného zápisu dávky

VIAC INFO

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Švédsko
• Telefón: + 46 90-18 48 00
• www.sartorius.com
• Informácie a obrázky uvedené v tomto návode zodpovedajú nižšie uvedenému dátumu verzie.
• Sartorius si vyhradzuje právo vykonávať zmeny v technológii, vlastnostiach, špecifikáciách a dizajne zariadenia bez upozornenia. Mužské alebo ženské tvary sa používajú na uľahčenie čitateľnosti v týchto pokynoch a vždy súčasne označujú všetky pohlavia.
  Upozornenie o autorských právach:
• Tento návod vrátane všetkých komponentov je chránený autorským právom.
• Akékoľvek použitie nad rámec autorského zákona nie je povolené bez nášho súhlasu.
• To platí najmä pre dotlač, preklad a úpravu bez ohľadu na typ použitého média.

FAQ

• Otázka: Aký je účel SimApis?
  • Odpoveď: Hlavným účelom SimApis je poskytovať dáta produktom Umetrics Suite na vytváranie projektov a vytváranie modelov.
• Otázka: Ako môžem riešiť problémy s inštaláciou SimApi?
  • Odpoveď: Problém môžete vyriešiť testovaním zo SIMCA-online kontrolou protokolu SimApi filea zabezpečenie správnej konfigurácie servisného účtu.