SARTORIUS Sim Api sagteware gebruikersgids

SARTORIUS Sim Api sagteware

Spesifikasies

• Produknaam: SimApi-gids
• Vrystellingsdatum: 5 September 2024
• Doel: Verskaf data aan Umetrics Suite-produkte

Produkgebruiksinstruksies

Inleiding tot SimApis

• SimApi's word gebruik om data te herwin vir projekskepping en modelbou in Umetrics Suite-produkte.

Verkryging van SimApis

• Om SimApis te bekom, verwys na die amptelike dokumentasie of kontak kliëntediens vir bystand.

SimApi-kenmerke

• SimApis verskaf intydse data vir monitering, beheer en modelbou in SIMCA en SIMCA-aanlyn.

Slegs huidige datagebruik

• Dit word aanbeveel om slegs huidige data te gebruik en historiese data te vermy vir optimale werkverrigting.

Berei voor vir 'n SimApi-installasie

• Voor installasie, maak seker dat jou stelsel voldoen aan die minimum vereistes gespesifiseer in die gebruikersgids.

Installeer 'n SimApi

• Volg die stap-vir-stap instruksies wat in die gebruikershandleiding verskaf word om die SimApi op jou stelsel te installeer.

Stel SimApi vir SIMCA op

• Konfigureer die SimApi-instellings in SIMCA volgens die riglyne wat verskaf word.

Stel SimApi op vir SIMCA-aanlyn

• Stel die SimApi op vir intydse dataherwinning en terugskryfbewerkings in SIMCA-aanlyn.

Toets en probleemoplossing

• Na die installasie, voer toetse uit om behoorlike funksionaliteit te verseker. In die geval van probleme, verwys na die probleemoplossingsafdeling in die gebruikersgids.

Toets vanaf SIMCA-aanlyn

• Toets die SimApi-integrasie vanaf SIMCA-aanlyn om dataherwinning te verifieer.

Probleemoplossing met Log Files

• Gebruik die SimApi-logboek file om enige installasie- of bedryfsprobleme te identifiseer en op te los.

Diensrekeningkonfigurasie

• Verseker die korrekte opstelling van die SIMCA-aanlyndiensrekening vir naatlose werking.

Tegniese Besonderhede

• Verwys na afdeling 7 van die gebruikersgids vir in-diepte tegniese inligting oor SimApis.

Inleiding tot SimApis

• 'n SimApi is 'n sagteware-koppelvlak tussen die Umetrics® Suite-sagteware en 'n databron. Die primêre doel van 'n SimApi is om data aan SIMCA®-aanlyn of SIMCA® te verskaf.
• Sartorius Stedim Data Analytics AB ontwikkel SimApis vir baie verskillende databronne, soos proseshistorici en algemene doeldatabasisse.
• Hierdie dokument wys wat 'n SimApi is, en hoe dit in Umetrics Suite-produkte gebruik word. Jy sal leer hoe om te beplan en 'n SimApi te installeer, hoe om probleme op te los en hoe om jou installasie te toets. Die laaste hoofstuk bevat tegniese besonderhede van SimApis wat op ontwikkelaars gemik is.

SimApi-doel: verskaf data aan Umetrics Suite-produkte

• Die primêre doel van 'n SimApi is om data aan SIMCA-aanlyn of SIMCA vanaf 'n databron te verskaf. Die databron is nie deel van SIMCA-aanlyn nie, maar kan 'n proseshistorikus of ander stelsel wees wat die data hou en bestuur.
• 'n SimApi stel 'n hiërargie van nodusse bloot, wat ooreenstem met vouers in 'n file stelsel. Elke nodus kan ander nodusse bevat, of tags. A tag ooreenstem met 'n veranderlike. Vir hierdie tags, kan data verkry word. Die prentjie toon a tag, Temp, gekies in die nodus
• BakersYeastControlGoed in 'n databron in SIMCA-aanlyn. Dit wys ook die nuutste waardes wat uit die databron geneem is.

SimApi-gebruik in die Umetrics Suite

• Die rekenaarsagteware SIMCA kan 'n SimApi gebruik om data vir projekskepping en modelbou te herwin soos die volgende prent illustreer.
• SIMCA-online gebruik SimApis om data intyds te verkry vir monitering en beheer, asook om data terug te skryf na die databron. Die volgende prent wys waar die SimApi is in 'n stelsel wat bestaan ​​uit 'n databron, SIMCA-aanlynbediener en kliënte.

Algemene gebruik SimApis

• Die mees gebruikte SimApis is:
• Die PI AF SimApi om aan Aveva (voorheen OSIsoft) PI Systems te koppel.
• Die OPC UA SimApi
• Die ODBC SimApi – vir algemene toegang tot databasisse soos SQL Server of Oracle
• Alle beskikbare SimApi's word saam met hul kenmerke in paragraaf 3 gelys.

Die DBMaker SimApi vir simulasiedata

• DBMaker is 'n toepassing wat saam met die SIMCA-aanlyn bedienerinstallasie voorsien word. Dit simuleer 'n databron, soos 'n proseshistorikus, deur 'n voorafgelaaide datatabel te gebruik waar waarnemings een vir een aan SIMCA-aanlyn verskaf word deur die DBMaker SimApi.
• DBMaker word slegs vir demonstrasiedoeleindes gebruik en kan nie in produksie gebruik word met lewendige data vanaf 'n databron nie. Sien die ingeboude hulp om meer oor DBMaker te wete te kom.

Bykomende dokumentasie

• Hierdie dokument is een van 'n stel verwante dokumente, elk met 'n ander fokus en teikengehoor:

Bron	Wat	Waar
SIMCA-aanlyn web bladsy	Inleidende inligting en aflaaie	sartorius.com/umetrics-simca- aanlyn

SIMCA-aanlyn LeesMy en Installation.pdf	Installasie en hoe om met SIMCA-aanlyn demonstrasiedata te begin	In die installasie zip file
SIMCA-aanlyn implementeringsgids	Skets SIMCA-aanlyn-funksionaliteit, plaas dit in konteks met ander Umetrics Suite-sagteware, beskryf vereistes en beste praktyke vir suksesvolle ontplooiing, en stap-vir-stap installasie-instruksies.	sartorius.com/umetrics-simca- aanlyn
SimApi Gids	Voorbereiding vir en uitvoer van SimApi-installasies, insluitend foutsporing. Bevat ook tegniese besonderhede oor SimApis vir ontwikkelaars.	sartorius.com/umetrics-simapi
SimApi-gebruikersgidse	Dokumentasie vir elke gepubliseerde SimApi met kenmerke, installasie-instruksies en konfigurasiebesonderhede.	sartorius.com/umetrics-simapi
SIMCA-aanlyn Tegniese Gids	Tegniese verwysing vir SIMCA-aanlyn bediener installasie beplanning, probleemoplossing, en in-diepte hoe SIMCA-aanlyn werk.	sartorius.com/umetrics-simca-aanlyn
SIMCA-aanlyn hulp	Web-gebaseerde hulp oor hoe om SIMCA-aanlyn te gebruik en hoe SIMCA-aanlyn werk.	In die sagteware self, en aan sartorius.com/umetrics-simca
SIMCA-aanlyn Web Kliënt Installasie Gids	Beskryf die installering van die SIMCA-aanlyn Web Kliënt.	sartorius.com/umetrics-simca-aanlyn
Umetrie kennisbasis	Soekbare databasis met artikels oor elke vrygestelde sagtewareweergawe, tegniese artikels en bekende probleme in Umetrics Suite-produkte.	sartorius.com/umetrics-kb
SIMCA hulp/gebruikersgids	Hoe om lessenaar SIMCA te gebruik vir die skep van projekte en modellering data.	In SIMCA en aan sartorius.com/umetrics-simca
Ondersteuning web bladsy	Hoe om tegniese ondersteuning te kry.	sartorius.com/umetrics-support

Tegniese ondersteuning

• Sartorius aanlyn ondersteuningspan beantwoord tegniese vrae oor SimApis en kan ook versoeke vir verbetering van SimApis aan die toepaslike mense deurstuur. Kom meer te wete by sartorius.com/umetrics-support.

Verkryging van SimApis

• Ons verskaf dokumentasie vir beskikbare SimApi's en skakels na installasieprogramme by sartorius.com/umetrics-simapi.
• Elke SimApi word in sy gebruikersgids gedokumenteer.
• Die SimApi-gids, wat jy nou lees, komplementeer daardie inligting met SimApi-aanvullingsinligting wanneer dit kom by SimApi-beplanning, installering en foutsporing.

SimApi kenmerke

• Nie alle databronne is dieselfde nie. 'n SimApi hoef nie alle funksies in die spesifikasie te implementeer nie. Om hierdie redes bied verskillende SimApi's verskillende funksionaliteit. Die volgende matriks lys beskikbare SimApis en hul kenmerke.
• Die kenmerke word hieronder verduidelik. Let daarop dat die tabel aparte kolomme het om te wys watter kenmerke onderskeidelik in SIMCA-aanlyn en SIMCA beskikbaar is.

Kenmerk	Doel	SIMCA-aanlyn gebruik	SIMCA gebruik
Huidige data	Lees 'n enkele waarneming met die mees onlangse waarde uit die databron.	Intydse normale uitvoering	–
Historiese data	Lees baie waarnemings gelyktydig met historiese data uit die databron.	Inhaal en voorspel vorige data, skep projekte met behulp van File > Nuut	Databasis Invoer Wizard om prosesdata in te voer vir modelskepping.
Diskrete data	Lees laboratorium-/IPC-data vanaf die databron. Baie waarnemings per bondel.	Vir bondelprojekte met fases of bondeltoestande wat vir diskrete dataherwinning opgestel is.	–
Batch data	Lees bondel voorwaardes en finale kwaliteit eienskappe (of	Batch toestande of plaaslike sentrering.	Databasis-invoer-assistent om bondelvoorwaardes voor te lees

Kenmerk	Doel	SIMCA-aanlyn gebruik	SIMCA gebruik
	ander MES tipe data). Een waarneming per bondel.		groepvlak model skepping.
Batch node	Spesifiseer die begintyd en die eindtyd (leeg vir 'n aktiewe bondel) vir 'n spesifieke bondel. Noem alle groepe wat in 'n tydreeks bestaan ​​het.	Vereis vir die uitvoering van bondelkonfigurasies.	Databasis Invoer Wizard om bondels te kies om in te voer.
Skryf terug – deurlopende data	Skryf deurlopende data, soos voorspellings, terug na die databron.	Skryf data terug vanaf die joernaal-evolusievlak, vir Control Advisor of vir deurlopende konfigurasies	–
Skryf terug – diskreet	Skryf diskrete data, soos voorspellings, terug na die databron.	Skryf terug vir bondelkonfigurasies op die bondel-evolusievlak vir fases wat vir diskrete dataherwinning opgestel is	–
Skryf terug – bondeldata	Skryf bondelvlakdata, soos voorspellings of finale kwaliteiteienskappe, terug na die databron.	Skryf terug vir bondelkonfigurasie op bondelvlak	–
Nodushiërargie	Die SimApi ondersteun 'n hiërargie van nodusse, soortgelyk aan 'n file stelsel. Elke nodus kan bevat tags en ander nodusse. Die hiërargie maak dit makliker om 'n groot aantal nodusse te bestuur en tags.	Ondersteun op alle plekke waar tags gebruik word.
Skikking tag uitbreiding	'n Skikking tag stoor verskeie waardes. Die SimApi brei die skikking uit tag vir baie individue tags, een vir elke element in die skikking.	Ondersteun waar tags word vir deurlopende data gebruik. Elkeen het uitgebrei tag moet na 'n veranderlike in die SIMCA-projek gekarteer word.
Veelvuldige databronne	Die SimApi kan aan meer as 'n enkele databron koppel of ondersteun verskeie gevalle van homself met individuele instellings en logboek files vir elke geval.	Koppel aan verskeie verskillende databronne van dieselfde soort.	–
Verbinding veerkragtigheid	As die SimApi van die databron ontkoppel word, sal dit probeer om die verbinding outomaties te herstel.	Die SimApi hoef nie herbegin te word om verbindings met die databron te herstel nie.	–
In-huis ontwikkel	Die SimApi word ontwikkel, verskaf en ondersteun deur

Slegs huidige data, sonder historiese data, word nie aanbeveel nie

• Sommige SimApi's, veral OPC DA, ondersteun slegs die lees van huidige data, en nie historiese data nie.
• 'n SimApi wat slegs huidige data ondersteun, kan nie in rekenaar SIMCA gebruik word nie, want dit sal nie historiese data kan lees waarop die modelle gebou kan word nie.
• Vir SIMCA-aanlyn beveel ons 'n databron en SimApi sterk aan wat nie net huidige data vir intydse uitvoering verskaf nie, maar ook historiese data om vorige data te kan voorspel en inhaal. SIMCA-aanlyn skakel outomaties tussen intydse data en historiese data soos nodig en dit kan nie afgeskakel word nie.
• 'n Databron wat slegs huidige data verskaf, maar nie historiese data nie, kan werk vir deurlopende projekte in SIMCA-aanlyn, maar vir bondelprojekte word historiese data vereis.

Berei tans voor vir 'n SimApi-installasie

• Hierdie afdeling beskryf belangrike inligting vir 'n suksesvolle installering van 'n SimApi.

64-bis of 32-bis SimApis

• Daar is 32-bis en 64-bis weergawes van elke SimApi.
• SIMCA-aanlyn en SIMCA is 64-bis en vereis die 64-bis SimApis-variante. Die ou 32-bis SimApis is steeds beskikbaar vir ouer installasies.

Ligging vir log file en instellings

• 'n SimApi stoor sy logboek files in die verborge Program Data-lêergids1:
  %programdata%\Umetrics\SimApi, waar %programdata% na die werklike vouer op jou rekenaar gekoppel word. Dit is verstek na C:\ProgramData.
• Elke SimApi gebruik gewoonlik sy eie logboek file, wat soortgelyk aan die SIMCA-aanlyn-bedienerlogboek file sal meer of minder data bevat, afhangende van 'n logvlak-instelling. Hierdie file is nuttig vir die oplos van probleme. Die log file genoem word
  .log waar is die SimApi wat jy installeer, bvampdie PIAFSimApi. Sien ook die volgende afdeling vir SIMCA-aanlyn SimApi-instansiesname.
• Hierdie vouer bevat ook die SimApi-instellings in 'n XML file genoem .xml.
• Die meeste SimApi's het grafiese gebruikerskoppelvlakke wat die instellings in die xml verander file, maar vir sommige voer jy die veranderinge direk in die XML in file met 'n teksredigeerder, soos Notepad. Sien die gebruikersgids vir elke SimApi.

File name wanneer benoemde gevalle met SIMCA-aanlyn gebruik word

• In SIMCA-aanlyn kry elke SimApi-instansie sy eie konfigurasie file en log file om met veelvuldige gevalle van elke SimApi te werk. Die name hiervan files word agtervoeg met die naam van die instansie soos gegee op die SimApi-oortjie in die SIMCA-aanlyn-bedieneropsies-dialoog.
• Die volgende example toon die benaming hiervan files, waar moet vervang word met die SimApi-naam.
• Konfigurasienaam gegee wanneer die instansie bygevoeg word: OmegaServer
• Konfigurasie file naam: OmegaServer.xml
• Log file naam: OmegaServer.log
• Let daarop dat die generiese file .log file word steeds geskep. Hierdie log file bevat inskrywings wat om tegniese redes nie na die logboek gerig kan word nie file van die gevalle..
• Hierdie gids is by verstek in Windows versteek. Om dit in te sien File Explorer jy konfigureer dit wys verborge files. Let daarop dat jy na 'n versteekte vouer kan navigeer deur 'n adres in te tik File Explorer se adresbalk.
• Let daarop dat SIMCA nie veelvuldige instansies van die SimApi ondersteun nie, en dus die name sonder instansienaam gebruik soos hierbo beskryf.

Netwerkbeplanning

• Jy moet die SIMCA-aanlynbediener naby die databron in die netwerk opspoor. Dit verseker 'n vinnige verbinding tussen SIMCA-aanlyn en sy databron.
• Netwerktoerusting kan inmeng met die verbinding tussen SIMCA-aanlyn en die databron.

Gebruikersrekeninge en databrontoestemmings

• Databronne beheer gewoonlik toegang tot hul data. Dit word gewoonlik met gebruikersname en wagwoorde gedoen, maar IP-adres- of DNS-gebaseerde beperkings kan ook gebruik word (bv.ample PI Trusts in Aveva PI System).
• Die gebruikersnaam en wagwoord kan op verskillende maniere aan die databron verskaf word:
• 'n SimApi word bestuur as die Windows-gebruiker van die gebruiker wat rekenaar-SIMCA of die SIMCA-aanlyndiensrekening op die bedienerrekenaar gebruik. Die SimApi kan met hierdie rekening aan die databron koppel. Dit is hoe die OPC I, en die PI SimApi werk, en ODBC as jy nie geloofsbriewe verskaf wanneer jy dit konfigureer nie.
• Vir generiese ODBC kan jy die ODBC Data Sources Administrator-toepassing gebruik wat op Start in Windows gevind word.
• Sommige databasisverskaffers verskaf hul eie drywers en gereedskap vir hul databasisse. Oracle-databasisse, bvample, gebruik die Oracle Data Access Components (ODAC).
• Sommige SimApi's, soos PI AF en ODBC, het konfigurasiedialoogvensters wat die geënkripteerde geloofsbriewe in die SimApi XML-konfigurasie stoor file.
• PI het ook verskeie sekuriteitsopsies beskikbaar in die PI-stelselbestuurnutsgoed op die PI-bedienerrekenaar. Lees meer in die PI AF SimApi Gebruikersgids. Hierdie gids is nuttig selfs as jy die ouer OSIsoft PI SimApi gebruik.
• OPC DA en HDA gebruik DCOM as die vervoer tussen 'n databron en SimApi. DCOM is opgestel met die Component Services-nutsding (DCOMCNFG.EXE) in Windows en gebruik Windows-verifikasie.
• Vir die ouer OSIsoft PI SimApi (nie die nuwer AF SimApi nie), word die OSIsoft AboutPI-SDK-toepassing (PISDKUtility.exe) gebruik om die verbinding met die PI-bediener op te stel.

Verifieer tans databronverbinding
Wanneer jy 'n SimApi op 'n rekenaar wil installeer, kan dit nuttig wees om die verbinding van daardie rekenaar na die databron met 'n ander hulpmiddel te verifieer:

• ODBC-databronne in Windows word gebruik om generiese ODBC op te stel en te toets. Let daarop dat daar twee weergawes van hierdie hulpmiddel op 64-bis Windows is: een vir 32-bis toepassings en een vir 64-bis. Gebruik die Toets Databron-knoppie aan die einde van die ODBC-konfigurasiewizard om verbinding met die databasis te verifieer. Ons beveel aan dat jy jou databronne opstel as Stelsel-DSN'e.
• 'n Databasis-spesifieke verbindingshulpmiddel van die verskaffer van die databasis, soos die Oracle Data Access Components.
• PI System Explorer kan gebruik word om verbinding met die PI AF-bediener te toets. Dit is deel van die PI AF-kliënt wat 'n voorvereiste vir die PI AF SimApi is.
• OPC UA Expert van Unified Automation - UaExpert is 'n kruisplatform-toetskliënt vir OPC UA-bedieners.
• Die PI-SDK-toepassing (PISDKUtility.exe) kan gebruik word om konnektiwiteit te toets en om view enige foutboodskappe wat dalk aangeteken is wanneer SIMCA-aanlyn probeer om aan die PI-bediener te koppel. Dit word slegs gebruik vir die ouer OSIsoft SimApi, nie PIAF nie.
• PI-stelselbestuurnutsgoed word op die PI-bedienerrekenaar gebruik vir die oplos van foute van daardie kant af. Byvoorbeeldample, om te soek na sekuriteitskwessies wat toegang vanaf die SIMCA-aanlynbediener verhoed. Kom meer te wete oor PI-stelselfoutsporing in hierdie YouTube-video.
• Excel kan gebruik word om data van 'n ODBC-verbinding en meeste ander stelsels te verkry wanneer 'n geskikte inprop geïnstalleer is.
• Matrikon OPC Explorer vir Ior HDA (dit is aparte gereedskap) kan gebruik word om OPC-verbinding te toets, en Matrikon OPC Analyzer kan gebruik word om die OPC-verbindingskwessies te diagnoseer. Laai hierdie gratis gereedskap af van https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (vir DInd HDA) van die OPC Training Institute's web webwerf “stel gebruikers in staat om kommunikasie- en sekuriteitsprobleme maklik te diagnoseer en dit onmiddellik met die druk van 'n knoppie te herstel. Dit alles kan gedoen word sonder om ooit te leer hoe om DCOM op te stel“

Installeer 'n SimApi

Hier is hoe om 'n SimApi op 'n rekenaar te installeer:

1. Lees die gebruikersgids vir die SimApi wat jy installeer. Dit bevat besonderhede vir daardie SimApi wat die algemene instruksies wat jy nou lees, aanvul.
2. Installeer en konfigureer enige voorvereistes wat in die SimApi-gebruikersgids genoem word (bvample databasisbestuurders of SDK's)
3. Begin die opstelprogram om die SimApi te installeer. Installeer die 64-bis (x64) of die 32-bis (x86) weergawe wat ooreenstem met die sagteware waarin jy dit sal laat loop.
4. Konfigureer die SimApi in SIMCA-aanlyn of SIMCA soos beskryf in die volgende afdelings en verwys na die gebruikersgids van die SimApi vir beskrywings van beskikbare instellings.
5. Begin die SIMCA-aanlynbediener. Let daarop dat dit tyd kan neem, want wanneer die SimApi geïnisialiseer word, sal dit alles opsom tags in die databron.
6. Toets die SimApi deur sommige data te verkry. Vir SIMCA-aanlyn, kan jy gebruik File > Onttrek soos beskryf in 6.1.
7. As die SimApi nie werk soos verwag nie, verwys na die SimApi-logboek files vir probleemoplossing, en na die SimApi-gebruikersgids.

Die opstel van die SimApi vir gebruik in SIMCA

Hier is hoe om die SimApi in SIMCA te gebruik:

1.  Begin die databasisinvoer op een van die volgende maniere:
   • a. Om 'n nuwe projek in SIMCA te skep: File > Nuwe gereelde projek of nuwe joernaalprojek. Kies Van databasis op die Tuis-oortjie.
   • b. Om 'n datastel in 'n bestaande projek in SIMCA in te voer: Van datastel op die Data-oortjie van 'n oop SIMCA-projek.
2. Klik Voeg nuwe databron by
3. Kies SimApi as die tipe verbinding, klik die …-knoppie en soek die .dll in die installasiegids, en klik Open.
4. Klik Configure en verwys na die individuele SimApi-gebruikersgids hoe om die instellings te maak.
5. Klik op die Toets databronverbinding om te verifieer dat jy aan die databasis kan koppel. Dit kan lank neem as daar baie is tags in die databron.
6. Klik OK om die konfigurasie te voltooi.
7. Verwys na die SIMCA-hulp vir hoe om met ingevoerde data te werk.

Die opstel van die SimApi vir gebruik in SIMCA-aanlyn

• Belangrik: Om 'n SimApi te kan gebruik, word 'n SIMCA-aanlynbedienerlisensie vereis. 'n Demo-installasie van SIMCA-aanlyn laat nie toe dat SimApis gebruik word nie.
• Om 'n SimApi by die stelsel te voeg, hardloop jy SIMCA-aanlyn bedieneropsies op die bedienerrekenaar. Leer die besonderhedestappe in die SICMA-aanlyn-hulponderwerp Voeg 'n SimApi op die bediener by en konfigureer dit.
• Wenk: As jy veranderinge vir 'n SimApi maak, kan jy daardie SimApi afsonderlik van Bedieneropsies herbegin sonder om die hele bediener te herbegin.
• Om veelvuldige gevalle van hierdie SimApi op te stel, herhaal die bogenoemde stappe en gebruik unieke name vir elke geval. Lees meer oor die verskillende logboek en konfigurasie files vir die gevalle in 4.2.

Toets en oplos van 'n SimApi

• Hierdie hoofstuk handel oor die toets en probleemoplossing van 'n SimApi-installasie.

Toets 'n SimApi vanaf SIMCA-aanlyn

• Sodra die SIMCA-aanlynbediener suksesvol begin is, kan jy jou SimApi in SIMCA-aanlyn toets (indien die bediener nie begin nie, sien 6.2):
• Meld aan by die bediener in die SIMCA-aanlyn kliënt, en navigeer na Uittreksel op die File oortjie. Uittreksel help jou om die SimApi te toets deur data daardeur te verkry:
• Die nodes ("vouers") van die SimApi word in die linkerblokkie vertoon. Tags vir die geselekteerde nodus word regs bo vertoon.
• Huidige data kan vinnig getoets word deur eenvoudig te klik view> aan tags wat deurlopende prosesdata verskaf (sien die skermkiekie)
• Regskliek op 'n nodus om groepe binne 'n tydreeks te vind. Die nodus moet 'n bondelnodus wees wat weet van bondels.
• Kies tags in Onttrek en klik Volgende en voltooi die towenaar om data te verkry deur die verskillende maniere van data-herwinning te gebruik: huidige-, historiese-, bondel- en diskrete data.
• Vergelyk die onttrekde data met wat jy in jou databron sien deur die gereedskap daarvan te gebruik. Kom meer te wete oor die toets en validering van alle kenmerke van 'n SimApi in 7.13.

Los SimApi-probleme op deur die SimApi-logboek te gebruik file

• As die bediener nie begin nie, die SimApi nie werk soos verwag nie of die onttrekking misluk, moet jy die SimApi-logboek raadpleeg file wat jou vertel wat die probleem is. Aktiveer ontfoutingsvlak-logboek in die SimApi-logboek om volledige besonderhede te kry. Sien 4.2.
• Let wel: die SIMCA-aanlyn bediener logs is nie so nuttig hier nie. Hulle sal wys hoe die SimApi deur die bediener gelaai en geïnisialiseer is, maar die SimApi-spesifieke besonderhede is in sy logboek file.

Gebruik die regte SIMCA-aanlyn diensrekening

• Wanneer jy toegang tot die databron toets, onthou dat jy as 'n spesifieke gebruiker op die bedienerrekenaar aangemeld is (tipies jou eie gebruikersrekening in 'n Windows-domein), maar dat die SIMCA-aanlynbedienerdiensrekening 'n ander rekening is, by verstek LocalSystem, wat verskillende toegangsregte het in vergelyking met jou gebruikersrekening.
• Om hierdie rede is dit nie ongewoon dat toetse werk wanneer dit as jou rekening uitgevoer word nie, maar dat SIMCA-aanlyn nie aan die databron koppel nie.
• Om hierdie probleem op te los, moet toegang verleen word vir die rekening wat deur die SIMCA-aanlynbedienerdiens gebruik word. Tipies verander jy LocalSystem na 'n spesifieke domeindiensrekening en verleen regte aan hierdie rekening. Let daarop dat dit nie van toepassing is as die SimApi geloofsbriewe gebruik wat in die SimApi-konfigurasie gestel is nie, want hierdie geloofsbriewe geniet voorkeur.

Tegniese besonderhede oor SimApis

• Hierdie hoofstuk gee tegniese besonderhede oor hoe 'n SimApi werk. Dit is hoofsaaklik gemik op ontwikkelaars wat SimApis wil verstaan ​​om 'n SimApi vir 'n databron te implementeer.
• Ontwikkelaars moet ook die vroeëre dele van hierdie dokument lees vir 'n inleiding tot SimApis en tot die hoëvlakbeskrywings van kenmerke.

Wanneer om te oorweeg om 'n SimApi te ontwikkel en wanneer nie?

Voordat u dit oorweeg om 'n SimApi vir 'n databron te ontwikkel:

1. Ondersoek of daar reeds 'n SimApi is wat jy kan gebruik. Miskien kan jy een of ander kenmerk in jou databron aktiveer om een ​​van die bestaande SimApi's te gebruik, soos OPC UA.
2. Gaan noukeurig deur hierdie dokument en sy verwysings en ondersoek of jou databron aan vereistes voldoen: bvample, dit moet vinnig genoeg wees, nie net huidige data verskaf nie, maar ook historiese data.

• Om hierdie redes beveel ons nie aan om 'n SimApi te ontwikkel wat aan laevlak hardeware of instrumente koppel nie. Dit is beter om daardie instrumente aan 'n proseshistorikus soos Aveva PI System te koppel, en dit te laat data van die instrument verkry, en dit te historieseer. Dan kan die PIAF SimApi gebruik word om data van PI na die Umetrics-produk te verkry.

SimApi-ontwikkeling en die SimApi-spesifikasie

• Die SimApi-spesifikasie, SimApi-v2, bevat dokumentasie vir alle C-funksies in die SimApi wat 'n SimApi DLL moet implementeer, asook 'n paar leiding vir hoe om 'n SimApi te ontwikkel.
• Die implementering van 'n SimApi met C of C++ is in die meeste gevalle op 'n onnodige lae vlak.
• Die aanbevole, en makliker manier om 'n SimApi te implementeer, is om dit op die ExampleSimApi-bronkode wat ons verskaf. Dit is 'n example SimApi implementering wat die C-koppelvlak hanteer en dit vertaal in.NET Framework waar die werklike implementering gemaak word. Dit het ook raamwerkkode vir aanteken, instellings, konfigurasie-GUI en ander raamwerkkode.
• Om 'n SimApi te ontwikkel, benodig die span ontwikkelaars ondervinding in Windows-ontwikkeling, .NET Framework, C of C++. Goeie kennis van die databron waaraan die SimApi moet koppel, word ook vereis, want die doel van 'n SimApi is om dataversoeke van SIMCA-aanlyn of SIMCA na die API van die databron te vertaal. 'n SimApi-implementering is nooit 'n eenmalige projek nie, maar benodig gewoonlik deurlopende ondersteuning en af ​​en toe instandhouding.

Lees of skryf van data

• 'n SimApi het die hooftaak om data vanaf 'n databron te verskaf. Dit word na verwys as leesdata.
• Die meeste SimApi-implementerings ondersteun ook die skryf van data. Dit beteken om data terug te skryf deur die SimApi na die databron. Die skryf van data is 'n opsionele kenmerk in SIMCA-aanlyn.

Tags en Nodusse

• A tag is 'n identifiseerder van 'n kolom of "veranderlike" in 'n databron. A tagse naam word gebruik om die te identifiseer tag. Name binne nodus moet uniek wees. SIMCA-online 18 is die eerste weergawe wat 'n nodus ondersteun wat 'n subnodus en tag met dieselfde naam. Byvoorbeeldample: die nodus Ouer het dalk 'n subnodus genaamd Batch en a tag Batch genoem.
• 'n Nodus is 'n houer van tags. 'n Nodus kan ook ander nodusse bevat, soortgelyk aan hoe a file stelsel het dopgehou in dopgehou.
• Soos in 'n file stelsel, die nodus en tag name kan gekombineer word tot 'n volledige pad wat uniek identifiseer a tag. Die tag paaie word in SIMCA-aanlyn of SIMCA gebruik wanneer dit gekies word tags te gebruik. A tag pad begin met 'n SimApi-instansienaam gevolg deur die nodusstruktuur, en eindig met die tag naam, elke item geskei met 'n dubbelpunt (:). Byvoorbeeldample “:ODBCSQLServer:Node:SensorTag1”.

Die SimApi noem tags en nodusse by opstart

• 'n SimApi-implementering blaai deur die bediener vir nodusse en tags in die databron wanneer die SimApi geïnisialiseer word en hou hulle dop sodat die verskillende SimApi-funksies wat gebruik word vir die opsomming tags en nodus kan geïmplementeer word.
• SimApi-inisialisasie vind nie net by die opstart van die bediener plaas nie, maar kan ook heraktiveer word deur 'n gebruiker in SIMCA-aanlyn met die Refresh SimApi-funksionaliteit.

Hooflettergevoeligheid van tag- en nodusname

• Tag name en nodusname is hooflettersensitief.
• Dus, a tag genoem "tag1" is nie dieselfde as "Tag1" as gevolg van die ander geval van die "T". Ons beveel aan dat dit nie gebruik word nie tags of nodusname wat slegs in geval verskil.

Deurlopende proses nodus 

• Wanneer 'n nodus bevat tags met deurlopende prosesdata, kan daarna verwys word as 'n prosesnodus. Die volgende twee skermkiekies wys 'n tabelvormige voorstelling van 'n prosesnodus met data gevolg deur 'n prent wat wys hoe die nodus lyk wanneer jy kies tags in SIMCA-aanlyn.

Deurlopende proses nodusse moet onafhanklik wees van bondels, lopies of tyd

• Om goed in 'n SimApi te werk, moet 'n nodus onafhanklik wees van bondels, lopies of tyd. Om 'n nodus te hê wat data vir 'n spesifieke bondel of tydreeks bevat, sal nie goed werk in SIMCA-aanlyn nie, want die projekkonfigurasie kon dan net data vir daardie bondel lees en nie vir ander bondels gebruik word nie.
• In plaas daarvan moet 'n nodus gekarteer word na een of meer fisiese eenhede in die proses waar metings uitgevoer word.

Batch ID tag vereis in deurlopende proses nodusse vir bondel projek uitvoering

• Elke deurlopende proses moet 'n hê tag (veranderlik) met die bondel-identifiseerder vir elke waarneming. Hierdie bondelidentifiseerder word deur SIMCA of SIMCA-aanlyn gebruik om te weet aan watter bondel elke waarneming behoort.
• Die $BatchID tag in die skermkiekies in 7.4.3 is so 'n example.
  Alhoewel dit nie nodig is nie, word dit aanbeveel om 'n tag in die proses nodus wat die huidige fase of stap van die proses wys. Hierdie tag kan dan gebruik word in fase uitvoering toestande in SIMCA-aanlyn of in SIMCA wanneer data invoer. Waardes hiervoor tag kan byvoorbeeld weesample “fase1”, “skoonmaak”, “fase2”.

Batch konteks nodus

• 'n Bondelnodus is 'n knooppunt wat boekhou van groepe; hul bondelidentifiseerders, begintye en eindtye. Dit is 'n vereiste vir bondelprojekuitvoering in SIMCA-aanlyn. 'n Databron kan meer as een bondelnodus hê wat bondels op verskillende maniere blootstel. Die gebruiker kies die bondelnodus wat op sy of haar toepassing van toepassing is. Hierdie example stel groepe bloot wat oor twee verskillende eenhede strek:
• /Factory1 –groepe met saamgestelde lewenstye oor beide Eenheid1 en Eenheid2.
• /Factory1/Eenheid1 – groepe met leeftyd slegs in Eenheid1
• /Factory1/Eenheid2 – groepe met leeftyd slegs in Eenheid2
• As jy nie 'n bondelnodus in jou databron het nie, kan jy die joernaalkonteksgenerator in SIMCA-aanlyn gebruik. Sien die ingeboude hulp.
• Opsionele bondeldata
• 'n Bondelnodus kan ook bondeldata bevat; data waarvoor daar net een waarneming vir die hele bondel is. Let daarop dat tags met bondeldata hoef nie in 'n nodus te wees wat die volle funksionaliteit van 'n bondelnodus het nie. Dit is genoeg dat die SimApi die lees van bondeldata vir die tags. Kom meer te wete oor bondeldata in 7.6.
• Hier is 'n example van 'n bondelknoop:
• Let wel: Die skermkiekie hierbo is geneem vanaf DBMaker, saam met SIMCA-aanlyn gebundel. Om dit self in DBMaker te sien, klik die View Data-knoppie op die Bakers Yeast-databasis om twee vensters te vertoon, waarvan een die bondelnodus is, en die ander die prosesdata.

Datatipes: numeriese data, teksdata en ontbrekende data

• Vir elkeen tag, 'n SimApi kan drie tipes data ondersteun: numeries, teks, t en ontbreek:
• Numeriese data is tipies werklike waardes van prosesparameters, bvample 6.5123. Die SimApi kan slegs 32-bis enkelpresisie dryfpuntwaardes hanteer. Enkel-presisie drywende punt formaat -Wikipedia. Alle ander numeriese datatipes in 'n databron moet omgeskakel word na dryf. As sodanig kan hulle beide groot en klein waardes hanteer, maar met slegs ongeveer 6 of 7 beduidende syfers. Kom meer te wete in die Tegniese Gids.
• Dit kan lei tot verlies aan akkuraatheid vir groot heelgetalle of vir reële getalle wat beide groot is en desimale het. Vir meer inligting, sien die Tegniese Gids.
• Teks-/stringdata word gebruik vir bondel-ID's, fase-uitvoeringstoestande of vir kwalitatiewe veranderlikes. Die waardes vir teks tag data is hooflettergevoelig. Dit beteken dat die waarde "hardloop" nie dieselfde is as
  "HARDLOOP". Datum-tyd veranderlikes word nie direk deur die SimApi ondersteun nie, maar hulle kan teruggestuur word as 'n string geformateer as JJ-MM-DD UU:MM (bv.ample “2020-09-07 13:45”).
• Ontbrekende waardes beteken dat daar geen waarde is om terug te gee nie, dit wil sê geen data nie.
• Watter tipe teruggestuur word, hang af van die SimApi-implementering. 'n SimApi weet van die data in die databron en behoort die datatipe te gee wat die beste pas.

Drie maniere van dataherwinning: Deurlopend, Batc,h en Diskreet

• Die SimApi-spesifikasie definieer drie maniere van herwinning vir data, nl. drie verskillende maniere waarop die SimApi data kan verskaf tags in 'n databron (of in die ander rigting: skryf data na tags in 'n databron).
• Deurlopende data-herwinning – dit verwys na data wat deurlopend gelees word, en opeenvolgend, waarneming per waarneming soos die bondel of proses ontwikkel. Data word gelees vir die huidige tyd, of vir 'n spesifieke reeks, met 'n gereelde interval tussen waarnemings. Byvoorbeeldample, alle data tussen 09:00:00 en 10:00:00 sampelke 60 sekondes gelei, wat lei tot 61 waarnemings wanneer eindpunte ingesluit is.
• Batch data herwinning – dit verwys na 'n enkele waarneming met data vir 'n hele bondel (nie geassosieer met 'n spesifieke volwassenheid of tydpunt nie). Batch-kenmerke en plaaslike sentreringsdata word as bondeldata in SIMCA-aanlyn gelees. Bondeltoestande word normaalweg ook as bondeldata gelees (tensy hulle opgestel is vir diskrete dataherwinning).
• Diskrete data-herwinning – diskrete data kan bestaan ​​uit verskeie waarnemings vir baie volwassenes. Maar anders as deurlopende data, word diskrete data nie opeenvolgend gelees nie, maar eerder alle data op een slag vir 'n spesifieke fase van 'n bondel. Data hoef nie met gereelde intervalle van die volwassenheidsveranderlike gespasieer te word nie. Alle data word herlees elke keer as die data aangevra word, met die gekonfigureerde interval.
• Vir enige gegewe tag data kan in enige van die drie modusse aangevra word, maar tipies sal 'n SimApi net een van hierdie modusse vir 'n individu ondersteun tag. Net so word dit toegelaat om te meng tags binne 'n nodus, maar tipies almal tags binne 'n spesifieke nodus ondersteun dieselfde modus van data-herwinning.
• Vir deurlopende data (maar nie vir bondel- of diskrete data2 nie), kan versoeke gemaak word vir huidige data of historiese data wat die onderwerp van die volgende afdeling is.
• Nie alle SimApi's ondersteun alle modusse nie. Sien die kenmerkmatriks hierbo en die SimApi web bladsy vir besonderhede.

Huidige en historiese deurlopende data deur 'n SimApi

• Deurlopende data verwys na prosesdata wat oor tyd verander.

Huidige data

• Om huidige data te lees beteken om die databron te vra vir die nuutste waardes van tags op die tydstip van vra. Let daarop dat die tyd van die eksterne databron nie hier gebruik word nie.
• Die data wat as huidige data gelees word, is wat SIMCA-aanlyn as lewendige data sal wys. Om hierdie rede is dit belangrik dat daar geen onnodige vertragings in die databron is nie. Huidige data moet so onlangs as moontlik wees om goed in SIMCA-aanlyn te werk.
• Die databron kan sy kennis van data en hoe lank waardes geldig is gebruik en besluit om ontbrekende data terug te gee wanneer die rou data vir 'n tydpunt te oud is. Byvoorbeeldample: data word om 15:00:00 aangevra, maar die mees onlangse datapunt in die databron is vanaf 03:00:00. In hierdie geval is die data 12 uur oud, so die SimApi kan besluit om ontbrekende waarde (geen data) terug te gee nie.

Historiese data

• Om historiese data te lees beteken om die databron vir waardes van een of meer te vra tags vir 'n spesifieke tydreeks met 'n spesifieke interval tussen waarnemings. Let daarop dat dit hier die databron se plaaslike tyd is wat gebruik word om die data te vind. Daarom is tydsinchronisasie tussen databron en bedieners belangrik.
• Historiese data bestaan ​​uit 'n matriks van data. Dit is aan die SimApi-implementering om die data van die databron te versoek, en aamplê dit op die gespesifiseerde interval en konstrueer die matriks van data om terug te keer:
• Soms het die databron self samevoegingsfunksies om verwerkte data terug te gee, of sampling-funksies, wat gebruik kan word om die regte data terug te gee.
• Vir ander databronne moet die SimApi alle data in die tydreeks aanvra en dan sample die regte waarnemings om die matriks te konstrueer.
• Data moet vir 'n tydreeks teruggestuur word, al is daar dalk nie rou data in die tydreeks nie, maar net voor die begintyd. Byvoorbeeldample: data bestaan ​​in die databron by tydpunte 10 en 20. Die SimApi versoek data vir tyd 15 en 17. In hierdie geval moet die waardes vir tydpunt 10 teruggestuur word deur die SimApi maar tydstipamped as tyd 15 en 17 aangesien dit die mees onlangse datapunte op daardie tye was. Die waardes vir tags op tyd 10 word na verwys as grenswaardes vir die gevraagde reeks. Vir 'n dieper verduideliking van grenswaardes, sien bvamplees die dokumentasie vir terugkeerBounds by UA Deel 11: Historiese Toegang – 6.4.3 ReadRawModifiedDetails-struktuur
  (opcfoundation.org)
• Interpolasie moet nooit gebruik word om waardes vir toekomstige tydpunte te bereken nie, want data sal nie ooreenstem met wat in reële tyd gelees word as huidige data nie. Vir die example van die vorige kolpunt: as data vir 15 en 17 geïnterpoleer sou word deur die waardes vir item 10 en 20 te gebruik, sal hulle effektief waardes uit die toekoms gebruik, wat nie toegelaat word nie.
• Die databron kan sy kennis van data en hoe lank waardes geldig is gebruik en besluit om ontbrekende data terug te gee wanneer die rou data vir 'n tydpunt te oud is. Byvoorbeeldample: data word vir 15:00:00 aangevra, maar die mees onlangse datapunt in die databron is vanaf 03:00:00. In hierdie geval is die data 12 uur oud, so die SimApi kan besluit om ontbrekende waarde terug te gee (geen data).

Let wel: SIMCA-online versoek gewoonlik nie meer as honderd waarnemings in een oproep tydens normale projekuitvoering nie. Wanneer 'n uittreksel in SIMCA-aanlyn gedoen word, of wanneer 'n rekenaar SIMCA uitgevoer word, kan groter versoeke van data gemaak word. Dit kan lank neem, wat te wagte is.

Huidige data en historiese data moet ooreenstem

• Soms kan daar verskille wees wanneer data gelees word as intydse huidige data of historiese data. Dit veroorsaak probleme in SIMCA-aanlyn omdat die bediener outomaties wissel tussen huidige en historiese data soos nodig.

Lae latensie data-verkryging

• Wanneer 'n databron intyds deur SIMCA-aanlyn gebruik word, is dit belangrik dat die data in die databron aktueel is. Daar behoort geen onnodige vertragings in die dataverkryging in die databron te wees nie. Deurlopende prosesdata vir alle veranderlikes moet terselfdertyd vir elke waarneming beskikbaar wees. Data wat laat inkom vir sommige veranderlikes sal nie deur SIMCA-aanlyn opgetel word nie.

Data kan vir enige tyd gelees word 

• Wanneer SIMCA-aanlyn vra vir 'n waarde van a tag vir tyd t sal dit die waarde van die databron vanaf tyd t ontvang, of die jongste waarneming in die databron voor tyd t, of 'n geïnterpoleerde waarde vir tyd t. Die bediener sal dus altyd 'n waarde kry op elke keer waarvoor dit vra, alhoewel 'n waarneming vir hierdie presiese tydstip dalk nie in die databron bestaan ​​nie.
• Tydigsteamps in die SimApi is altyd UTC. SIMCA-aanlynkliënte en SIMCA bied die tyd as plaaslike tyd aan.

Ryg 

• Die SimApi word by verstek deur 'n enkele draad deur die gebruiker van die SimApi geroep. Dit geld vir alle SIMCA-weergawes en SIMCA-aanlyn tot weergawe 17.
• SIMCA-online 18 ondersteun 'n kenmerkvlag om multi-draad toegang deur SimApi aan te skakel. Lees meer in die hulponderwerp Gelyktydige SimApi-toegang.
• Dit beteken dat SimApis moet voorberei vir multi-threading, indien moontlik, deur die SimApi implementering draad veilig te maak, en dokumenteer dit en enige oorwegings vir gebruikers van die SimApi.

Log file

• 'n SimApi moet aksies, foutboodskappe en waarskuwings in sy logboek aanteken file om probleme op te los. Gebruik die verskillende log vlakke om die belangrikheid van die logboek aan te dui.
• Dit word aanbeveel om "Nie geïmplementeer" aan te teken vir kenmerke wat nie in 'n SimApi geïmplementeer is nie.

Fouthantering

• Wanneer 'n SimApi nie aan 'n versoek van die databron kan voldoen nie, kan dit hierdie probleem op een van twee maniere hanteer; deur ontbrekende waardes (geen data) terug te gee of deur 'n SimApi-fout aan te dui:
• Deur ontbrekende waardes aan die oproeper terug te gee en sukses aan te dui, kan die oproeper normaal voortgaan (maar natuurlik sonder enige data). Dit is 'n aanbevole praktyk vir gedeeltelike foute, soos wanneer data verkry kan word vir sommige, maar nie almal nie, tags in 'n versoek.
• Deur 'n SimApi-fout te sein, laat die beller toe (bvampdie SIMCA-aanlynbediener) om dit onmiddellik te sien en op te tree. Dit is 'n aanbevole praktyk vir versoeke wat heeltemal misluk en glad nie enige data kan terugstuur nie.
• SIMCA-aanlyn hanteer ontbrekende waardes of foutkodes anders, soos beskryf word in die SIMCA-aanlyn Tegniese Gids.

SimApi prestasievereistes

• Die funksies in die SimApi word gebruik om data te verkry.
• As datatoegang stadig is, sal die SimApi nie goed werk nie, wat hierdie bvample wys: As SIMCA-aanlyn data elke sekonde versoek, maar dit neem twee sekondes om te verkry, sal die SIMCA-aanlynbediener nooit intyds kan byhou nie, maar geleidelik al hoe verder agter raak.
• In die onderafdelings sal ons wys hoe SIMCA en SIMCA-aanlyn die datatoegang SimApi-funksies gebruik en hoe gereeld die SimApi-funksies geroep sal word. Dit kan help om prestasievereistes vir 'n SimApi-implementering te stel.

SIMCA se gebruik van SimApi-funksies

• Wanneer rekenaar SIMCA of ander vanlyn produkte 'n SimApi gebruik om data te verkry, sal hierdie versoeke wees vir bondels en verwerk data vir 'n stel veranderlikes in 'n sekere tydsbestek.
• Aangesien hierdie versoeke handmatig deur 'n gebruiker geïnisieer word, gebeur dit nie baie gereeld nie en veroorsaak dit nie 'n beduidende las na 'n databron nie.
• Hierdie SimApi-funksies word gebruik om die data te verkry:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

SIMCA-online se gebruik van SimApi-funksies

• SIMCA-aanlyn word gebruik vir intydse monitering van 'n proses, en daarom versoek dit data deur die SimApi met gereelde tussenposes. Die kortste uitvoeringsinterval wat gebruik kan word, is 1 sekonde. Sommige werklike eksamples van uitvoeringsintervalle is 10 s, 1 minuut of 10 minute.
• 'n Bediener kan baie projekte op dieselfde tyd hê.
• Om die aantal API-oproepe deur die SimApi te verminder, optimaliseer die bediener dataversoeke deur baie gelyktydige kleiner versoeke te groepeer in 'n enkele groter versoek vir alle veranderlikes op dieselfde tyd (kom meer te wete in die hulponderwerp 'Geoptimaliseerde lees van databronne verbeter werkverrigting').
• Die bediener se uitvoeringsalgoritme werk so wanneer dit data versoek deur die SimApi-funksies hieronder gelys:
• Alle fases wat met dieselfde interval uitgevoer word, word in 'n enkele SimApi-oproep gegroepeer om die aantal oproepe te verminder. Die bediener lees die nuutste data vir alle veranderlikes wat gebruik word deur alle modelle wat die interval deel, maw hierdie oproep sal lei tot 'n wye datary wat dan deur alle projekte gebruik word.
  • simapi2_connectionReadCurrentData
• Vir elke bondelprojek moet die bediener ook weet watter bondels aktief is. Dit moet ook gebeur elke keer as 'n projek uitgevoer word:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes word minder gereeld genoem.
• Daarbenewens vereis SIMCA-aanlyn ook historiese data. Hierdie versoeke gebeur slegs wanneer dit nodig is, soos om die begin van 'n bondel in te haal wat begin het voordat SIMCA-aanlyn begin is, of wanneer die bediener agter raak en 'n blok data moet lees:
  • simapi2_connectionReadHistoricalDataEx
• Opsioneel gebruik sommige projekkonfigurasies kenmerke wat bondeldata of diskrete data gebruik wat lei tot SimApi-oproepe na:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Opsioneel, sommige projekkonfigurasies gebruik terugskryf om data terug te stoot na die databron:
  • simapi2_connectionWriteHistoricalDataEx (en ooreenstemmende funksies vir bondeldata, diskrete data)
• Dit is belangrik dat elke oproep na die kernfunksies om data te kry, readCurrentData, getActiveBatches/getBatchTimes, vinnig is en dit is nie rekenaarmatig moeilik vir die databron self nie, gegewe hoe gereeld SIMCA-online daardie funksies kan oproep.

Toets en validering van SimApi-data

• Hierdie afdeling gaan oor die toets van 'n SimApi om te verifieer dat die data wat daaruit teruggestuur word, ooreenstem met data in die databron self. Dit is belangrik om toetse soos hierdie uit te voer nadat SimApi-implementering geskep of verander is, of wanneer die API van 'n databron verander.
• In die praktyk word data-validering gedoen deur SIMCA-aanlyn en sy Onttrek-funksionaliteit te gebruik om data van die databron deur die SimApi te trek en dan met die rou data in die databron te vergelyk. Desktop SIMCA kan nie gebruik word om die intydse aspekte van 'n SimApi te toets nie.

Voorbereidings en vereistes

• Sommige items is opsioneel, maar kan uitgevoer word as die omvang van jou toets dit insluit:

1. Installeer SIMCA-aanlyn soos beskryf in LeesMy en Installasiegids.pdf wat in die produk zip kom.
2. Verkry 'n lisensie vir die SIMCA-aanlynbediener dit en installeer dit. Die SimApi sal nie sonder 'n lisensie werk nie. Die kennisbasisartikel vir SIMCA-aanlyn wys hoe om die produk te lisensieer. Byvoorbeeldample: SIMCA-aanlyn 18 (sartorius.com)
3. Installeer en konfigureer die SimApi wat jy wil toets. Verwys na hoofstukke 4 – 5 in hierdie dokument en die gebruikersgids van die spesifieke SimApi.
   • a. Opsioneel: maak seker dat die gebruikersgids op datum en korrek is.
4. Maak seker jy het 'n hulpmiddel vir jou databron waarmee jy die SimApi-data kan vergelyk.
5. In die SIMCA-aanlyn lessenaarkliënt, meld aan by jou SIMCA-aanlynbediener en gebruik File > Onttrek om data deur die SimApi te verkry.
6. Opsioneel as jou toetsomvang dit insluit: nadat jy klaar getoets het, deïnstalleer die SimApi en verifieer sy files verwyder word.

Wat om te toets

• Die kenmerkmatriks in hoofstuk 3 lys alle moontlike kenmerke, maar 'n gegewe SimApi-implementering kan slegs 'n subset ondersteun. U moet alle kenmerke toets wat deur die gegewe SimApi geïmplementeer word.
• Die volgende toetse is algemeen vir die meeste SimApi-implementerings:
• Verifikasie met gebruikersname en wagwoorde
• Toets die verskillende instellings in die opstelling van die SimApi
• Nodushiërargie: Die nodusse en tags blootgestel deur die SimApi is korrek.
  • Daar moet 'n wees tag blootgestel vir alle "veranderlikes" wat deur die SimApi beskikbaar moet wees. Bvamples: prosesmetings, berekende waardes, konstantes.
• Verbindingsveerkragtigheid: as die databron nie beskikbaar is nie, lei dit tot waarskuwings of foute in die logboek file, maar dat die verbinding met die databron outomaties hervestig word wanneer die databron beskikbaar is.
• Veelvuldige gevalle: dat twee gevalle onafhanklik en gelyktydig gekonfigureer en gebruik kan word, met aparte logs files.
• Huidige data: onttrek huidige data vir tags. Maak seker dat data die laaste bekende waardes van die databron is, of ontbreek vir swak kwaliteit of wanneer data te oud is.
  • Onttrek data elke 10 sekondes (of so) vir 'n minuut.
• Historiese deurlopende data: onttrek historiese data vir tags.
  • Gebruik die tydreeks wat ooreenstem met wanneer jy huidige data onttrek het. Verifieer dat huidige data ooreenstem met historiese data, en die rou data in die databron.
  • Probeer verskillende tydreekse en sampling-intervalle, verifieer dat die data by die databron pas.
  • Probeer data elke 1 s onttrek, wat die kortste moontlike s isampling interval.
  • Probeer verskillende soorte tags in die databron (prosesveranderlikes, ens.), maak seker dat data ooreenstem.
  • Let wel: SIMCA-online kan 'n enkele groot historiese dataversoek in verskeie kleiner stukke verdeel. Dit sal sigbaar wees in die SimApi-logboek.
• Verifieer dat die SimApi met teksdata, numeriese data en ontbrekende data werk.
• SimApi-logboek file. Verifieer dat die logboek redelike inskrywings bevat.
• Batch node: regs-kliek 'n node en doen Soek bondels.
  • Verifieer bondelname, begintye, eindtye vir bondels.
  • Probeer 'n aktiewe bondel wat in die databron loop. Dit behoort nie 'n eindtyd deur die SimApi te hê nie.
• Verwerk nodus-joernaal-identifiseerder tag. As die SimApi bondelnodusfunksionaliteit het (sien vorige kolpunt), moet dit ook 'n bondelidentifiseerder hê tag in die passing proses data nodus. Data hiervoor tag moet die joernaal-identifiseerder (joernaalnaam) wees. Hierdie data word benodig vir bondelprojekte om te identifiseer aan watter bondel 'n ry data behoort.

Afhangende van of die SimApi dit ondersteun, wil jy dalk ook toets:

• Batch data met behulp van File > Onttrek.
• Diskrete data met behulp van File > Onttrek. Let wel: om diskrete data mee te toets File > Onttrek die nodus, die bondelnodus en diskrete datanodus moet in dieselfde SimApi wees (wanneer SIMCA-aanlyn projekte uitvoer, kan dit van verskillende SimApi's wees).
• Skryf terug - stoot data bondel na die databron. Om dit te toets, moet jy 'n projekkonfigurasie in SIMCA-aanlyn konfigureer om datavektore na die databron terug te skryf. Voer dan die projek in SIMCA-aanlyn uit en kontroleer die data wat in die databron teruggeskryf is.
• Deurlopende data word op die Evolution Write Back-bladsy in die projekkonfigurasie gekonfigureer.
• Diskrete data word op dieselfde bladsy gekonfigureer, maar slegs vir 'n fase wat vir diskrete dataherwinning opgestel is.
• Batch data van die Batch Skryf terug

MEER INLIGTING

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Swede
• Telefoon: +46 90-18 48 00
• www.sartorius.com
• Die inligting en syfers vervat in hierdie instruksies stem ooreen met die weergawe datum hieronder gespesifiseer.
• Sartorius behou die reg voor om veranderinge aan die tegnologie, kenmerke, spesifikasies en ontwerp van die toerusting aan te bring sonder kennisgewing. Manlike of vroulike vorms word gebruik om leesbaarheid in hierdie instruksies te vergemaklik en dui altyd gelyktydig alle geslagte aan.
  Kopieregkennisgewing:
• Hierdie instruksies, insluitend alle komponente, word deur kopiereg beskerm.
• Enige gebruik buite die perke van die kopieregwet word nie toegelaat sonder ons goedkeuring nie.
• Dit geld veral vir herdruk, vertaling en redigering, ongeag die tipe media wat gebruik word.

Gereelde vrae

• V: Wat is die doel van SimApis?
  • A: Die hoofdoel van SimApis is om data aan Umetrics Suite-produkte te verskaf vir projekskepping en modelbou.
• V: Hoe kan ek probleme met 'n SimApi-installasie oplos?
  • A: Jy kan probleme oplos deur te toets vanaf SIMCA-aanlyn, deur die SimApi-logboek na te gaan file, en die korrekte diensrekeningkonfigurasie te verseker.