SARTORIUS Sim Api Software User Guide

SARTORIUS Sim Api Software

Spesifikaasjes

• Produkt Namme: SimApi Guide
• Release Date: 5 septimber 2024
• Doel: Jou gegevens oan Umetrics Suite produkten

Produkt Usage Ynstruksjes

Yntroduksje ta SimApis

• SimApis wurde brûkt om gegevens op te heljen foar projekt oanmeitsjen en modelbou yn Umetrics Suite-produkten.

SimApis krije

• Om SimApis te krijen, ferwize nei de offisjele dokumintaasje of nim kontakt op mei klantstipe foar assistinsje.

SimApi-funksjes

• SimApis leverje real-time gegevens foar tafersjoch, kontrôle en modelbou yn SIMCA en SIMCA-online.

Allinnich aktueel gegevensgebrûk

• It is oan te rieden om allinich aktuele gegevens te brûken en histoaryske gegevens te foarkommen foar optimale prestaasjes.

Tariede op in SimApi-ynstallaasje

• Foardat de ynstallaasje, soargje derfoar dat jo systeem foldocht oan de minimale easken spesifisearre yn de brûker hantlieding.

It ynstallearjen fan in SimApi

• Folgje de stap-foar-stap ynstruksjes yn 'e brûkershantlieding om de SimApi op jo systeem te ynstallearjen.

SimApi ynstelle foar SIMCA

• Konfigurearje de SimApi-ynstellingen yn SIMCA neffens de levere rjochtlinen.

SimApi ynstelle foar SIMCA-online

• Stel de SimApi yn foar real-time gegevens opheljen en weromskriuwen operaasjes yn SIMCA-online.

Testen en Troubleshooting

• Nei ynstallaasje, fiere testen om te garandearjen goede funksjonaliteit. Yn gefal fan problemen, ferwize nei de seksje foar probleemoplossing yn 'e brûkershantlieding.

Testen fan SIMCA-online

• Test de SimApi-yntegraasje fan SIMCA-online om it opheljen fan gegevens te ferifiearjen.

Troubleshooting mei Log Files

• Brûk it SimApi-logboek file om alle ynstallaasje- of operasjonele problemen te identifisearjen en op te lossen.

Service Account konfiguraasje

• Soargje foar de juste konfiguraasje fan it SIMCA-online tsjinstaccount foar naadleaze operaasje.

Technyske Details

• Ferwize nei paragraaf 7 fan 'e brûkersgids foar yngeande technyske ynformaasje oer SimApis.

Yntroduksje ta SimApis

• In SimApi is in software-ynterface tusken de Umetrics® Suite-software en in gegevensboarne. It primêre doel fan in SimApi is om gegevens te leverjen oan SIMCA®-online of SIMCA®.
• Sartorius Stedim Data Analytics AB ûntwikkelet SimApis foar in protte ferskillende gegevensboarnen, lykas proseshistoarisy en databases foar algemiene doelen.
• Dit dokumint lit sjen wat in SimApi is, en hoe't it wurdt brûkt yn Umetrics Suite-produkten. Jo sille leare hoe't jo in SimApi kinne planne en ynstallearje, hoe't jo problemen oplosse en hoe't jo jo ynstallaasje kinne testen. It lêste haadstik befettet technyske details fan SimApis rjochte op ûntwikkelders.

SimApi doel: jouwe gegevens oan Umetrics Suite produkten

• It primêre doel fan in SimApi is om gegevens te leverjen oan SIMCA-online of SIMCA fanút in gegevensboarne. De gegevensboarne is gjin diel fan SIMCA-online, mar kin in proseshistoarikus wêze as in oar systeem dat de gegevens byhâldt en beheart.
• In SimApi bleatsteld in hiërargy fan knopen, oerienkommende mei mappen yn in file systeem. Elts knooppunt kin befetsje oare knopen, of tags. IN tag komt oerien mei in fariabele. Foar dizze tags, gegevens kinne wurde krigen. De foto toant a tag, Temp, selektearre yn it knooppunt
• BakersYeastControlGood yn in gegevensboarne yn SIMCA-online. It toant ek de lêste wearden nommen fan 'e gegevensboarne.

SimApi-gebrûk yn 'e Umetrics Suite

• De buroblêdsoftware SIMCA kin in SimApi brûke om gegevens op te heljen foar projekt oanmeitsjen en modelbou, lykas de folgjende ôfbylding yllustrearret.
• SIMCA-online brûkt SimApis om gegevens yn real-time te krijen foar tafersjoch en kontrôle, en ek gegevens werom te skriuwen nei de gegevensboarne. De folgjende ôfbylding lit sjen wêr't de SimApi is yn in systeem besteande út in gegevensboarne, SIMCA-online tsjinner, en kliïnten.

Faak brûkte SimApis

• De meast brûkte SimApis binne:
• De PI AF SimApi foar ferbining mei Aveva (earder OSIsoft) PI Systems.
• De OPC UA SimApi
• De ODBC SimApi - foar algemiene tagong ta databases lykas SQL Server of Oracle
• Alle beskikbere SimApis wurde neamd tegearre mei har funksjes yn paragraaf 3.

De DBMaker SimApi foar simulaasjegegevens

• DBMaker is in applikaasje foarsjoen fan de SIMCA-online tsjinner ynstallaasje. It simulearret in gegevensboarne, lykas in proseshistoarikus, troch in foarladen gegevenstabel te brûken wêrby't observaasjes ien foar ien wurde levere oan SIMCA-online fia de DBMaker SimApi.
• DBMaker wurdt allinich brûkt foar demonstraasjedoelen en kin net brûkt wurde yn produksje mei live gegevens fan in gegevensboarne. Sjoch de ynboude help om mear te learen oer DBMaker.

Oanfoljende dokumintaasje

• Dit dokumint is ien fan in set fan relatearre dokuminten, elk mei in oare fokus en doelgroep:

Boarne	Wat	Wêr
SIMCA-online web side	Ynliedende ynformaasje en downloads	sartorius.com/umetrics-simca- online

SIMCA-online ReadMe and Installation.pdf	Ynstallaasje en hoe te begjinnen mei SIMCA- online demo gegevens	Yn de ynstallaasje zip file
SIMCA-online Implementation Guide	Sketearret SIMCA-online funksjonaliteit, set it yn kontekst mei oare Umetrics Suite software, beskriuwt easken en bêste praktiken foar suksesfolle ynset, en stap-foar-stap ynstallaasje ynstruksjes.	sartorius.com/umetrics-simca- online
SimApi Guide	Tariede op en útfiere SimApi ynstallaasjes, ynklusyf troubleshooting. Befettet ek technyske details oer SimApis foar ûntwikkelders.	sartorius.com/umetrics-simapi
SimApi brûkersgidsen	Dokumintaasje foar elke publisearre SimApi mei funksjes, ynstallaasjeynstruksjes en konfiguraasjespesifikaasjes.	sartorius.com/umetrics-simapi
SIMCA-online Technical Guide	Technyske referinsje foar SIMCA-online tsjinner ynstallaasje planning, troubleshooting, en yngeande hoe't SIMCA-online wurket.	sartorius.com/umetrics-simca-online
SIMCA-online help	Web-basearre help oer hoe't jo SIMCA-online brûke en hoe't SIMCA-online wurket.	Yn de software sels, en op sartorius.com/umetrics-simca
SIMCA-online Web Client ynstallaasje Guide	Beskriuwt de ynstallaasje fan de SIMCA-online Web Kliïnt.	sartorius.com/umetrics-simca-online
Umetrics kennisbasis	Sykjebere databank mei artikels oer elke útbrochte softwareferzje, technyske artikels en bekende problemen yn Umetrics Suite-produkten.	sartorius.com/umetrics-kb
SIMCA help / brûker hantlieding	Hoe kinne jo buroblêd SIMCA brûke foar it meitsjen fan projekten en modellearingsgegevens.	Yn SIMCA en fierder sartorius.com/umetrics-simca
Stypje web side	Hoe te krijen technyske stipe.	sartorius.com/umetrics-support

Technyske stipe

• Sartorius online stipeteam beantwurdet technyske fragen oer SimApis en kin ek oanfragen foar ferbettering fan SimApis trochstjoere nei de passende minsken. Learje mear op sartorius.com/umetrics-support.

SimApis krije

• Wy jouwe dokumintaasje foar beskikbere SimApis en keppelings nei ynstallaasje programma by sartorius.com/umetrics-simapi.
• Elke SimApi is dokumintearre yn syn brûkersgids.
• De SimApi-gids, dy't jo no lêze, komplementeart dy ynformaasje mei SimApi-oanfoljende ynformaasje as it giet om SimApi-planning, ynstallaasje en probleemoplossing.

SimApi funksjes

• Net alle gegevensboarnen binne gelyk. In SimApi hoecht net alle funksjes yn 'e spesifikaasje te ymplementearjen. Om dizze redenen biede ferskate SimApis ferskate funksjonaliteit. De folgjende matrix listet beskikbere SimApis en har funksjes.
• De funksjes wurde hjirûnder útlein. Tink derom dat de tabel aparte kolommen hat om te sjen hokker funksjes respektivelik beskikber binne yn SIMCA-online en SIMCA.

Eigenskip	Doel	SIMCA-online gebrûk	SIMCA gebrûk
Aktuele gegevens	Lês ien observaasje mei de meast resinte wearde fan 'e gegevensboarne.	Real-time normale útfiering	–
Histoaryske gegevens	Lês in protte observaasjes tagelyk mei histoaryske gegevens fan 'e gegevensboarne.	Catch-up en foarsizze fan ferline gegevens, meitsje projekten mei help File > nij	Database Ymport Wizard om prosesgegevens te ymportearjen foar model oanmeitsjen.
Diskrete gegevens	Lês laboratoarium / IPC gegevens út de gegevens boarne. In protte observaasjes per batch.	Foar batchprojekten mei fazen of batchbetingsten konfigureare foar diskrete gegevenswinning.	–
Batch gegevens	Lês batchbetingsten en definitive kwaliteitsattributen (of	Batch betingsten of lokale centering.	Database Ymport Wizard te lêzen batch betingsten foar

Eigenskip	Doel	SIMCA-online gebrûk	SIMCA gebrûk
	oare MES-type gegevens). Ien observaasje per batch.		batch nivo model skepping.
Batch node	Spesifisearje de starttiid en de eintiid (leech foar in aktive batch) foar in spesifike batch. Enumerearje alle batches dy't bestien yn in tiid berik.	Fereaske foar it útfieren fan batchkonfiguraasjes.	Wizard Database ymportearje om batches te selektearjen om te ymportearjen.
Skriuw werom - trochgeande gegevens	Skriuw trochgeande gegevens, lykas foarsizzings, werom nei de gegevensboarne.	Skriuw gegevens werom fan it batch-evolúsjenivo, foar Control Advisor of foar trochgeande konfiguraasjes	–
Skriuw werom - diskreet	Skriuw diskrete gegevens, lykas foarsizzings, werom nei de gegevensboarne.	Skriuw werom foar batchkonfiguraasjes op it batch-evolúsjenivo foar fazen konfigureare foar diskrete gegevensopheljen	–
Skriuw werom - batchgegevens	Skriuw batchnivo-gegevens werom, lykas foarsizzings of definitive kwaliteitsattributen, nei de gegevensboarne.	Skriuw werom foar batchkonfiguraasje op batchnivo	–
Node hierargy	De SimApi stipet in hiërargy fan knopen, fergelykber mei in file systeem. Elke node kin befetsje tags en oare knopen. De hiërargy makket is makliker te beheare in grut oantal knopen en tags.	Stipe op alle plakken dêr't tags wurde brûkt.
Array tag útwreiding	In array tag bewarret meardere wearden. De SimApi wreidet de array út tag foar in protte yndividu tags, ien foar elk elemint yn 'e array.	Stipe wêr tags wurde brûkt foar trochgeande gegevens. Elk útwreide tag moat wurde yn kaart brocht oan in fariabele yn it SIMCA-projekt.
Meardere gegevens boarnen	De SimApi kin ferbine mei mear dan ien gegevensboarne of stipet meardere eksimplaren fan himsels mei yndividuele ynstellings en log files foar elk eksimplaar.	Ferbine mei ferskate ferskillende gegevens boarnen fan deselde soarte.	–
Ferbining resiliency	As de SimApi loskeppele wurdt fan de gegevensboarne, sil it besykje de ferbining automatysk opnij te meitsjen.	De SimApi hoecht net opnij te begjinnen om ferbiningen mei de gegevensboarne opnij te meitsjen.	–
Yn-hûs ûntwikkele	De SimApi wurdt ûntwikkele, levere en stipe troch

Allinich aktuele gegevens, sûnder histoaryske gegevens, wurdt net oanrikkemandearre

• Guon SimApis, benammen OPC DA, stipet allinich it lêzen fan aktuele gegevens, en net histoaryske gegevens.
• In SimApi dy't allinich aktuele gegevens stipet, kin net brûkt wurde yn buroblêd SIMCA, om't it gjin histoaryske gegevens kin lêze wêrop de modellen wurde boud.
• Foar SIMCA-online riede wy sterk oan in gegevensboarne en SimApi dy't net allinich aktuele gegevens leverje foar real-time útfiering, mar ek histoaryske gegevens om ferline gegevens te foarsizzen en te fangen. SIMCA-online skeakelt automatysk tusken realtime gegevens en histoaryske gegevens as nedich en dit kin net útskeakele wurde.
• In gegevensboarne dy't allinich aktuele gegevens leveret, mar net histoaryske gegevens, kin wurkje foar trochgeande projekten yn SIMCA-online, mar foar batchprojekten binne histoaryske gegevens nedich.

Tariede op in SimApi ynstallaasje

• Dizze seksje beskriuwt wichtige ynformaasje foar in suksesfolle ynstallaasje fan in SimApi.

64-bit of 32-bit SimApis

• D'r binne 32-bit en 64-bit ferzjes fan elke SimApi.
• SIMCA-online en SIMCA binne 64-bit en fereaskje de 64-bit SimApis farianten. De legacy 32-bit SimApis binne noch beskikber foar âldere ynstallaasjes.

Lokaasje foar log file en ynstellings

• In SimApi bewarret syn logboek files yn 'e ferburgen Program Data map1:
  %programdata%\Umetrics\SimApi, wêrby't %programdata% map is nei de eigentlike map op jo kompjûter. It is standert op C:\ProgramData.
• Elke SimApi brûkt typysk syn eigen log file, dy't fergelykber is mei it SIMCA-online tsjinner log file sil befetsje mear of minder gegevens ôfhinklik fan in log nivo ynstelling. Dit file is nuttich foar it oplossen fan problemen. De log file neamd wurdt
  .log wêr is de SimApi dy't jo ynstallearje, bygelyksample PIAFSimApi. Sjoch ek de folgjende seksje foar SIMCA-online SimApi eksimplarnammen.
• Dizze map befettet ek de SimApi-ynstellingen yn in XML file neamd .xml.
• De measte SimApis hawwe grafyske brûkersynterfaces dy't de ynstellings yn 'e xml feroarje file, mar foar guon jo ynfiere de feroarings direkt yn de XML file mei in tekstbewurker, lykas Notepad. Sjoch de brûkersgids foar elke SimApi.

File nammen as neamde eksimplaren wurde brûkt mei SIMCA-online

• Yn SIMCA-online krijt elke SimApi-eksimplaar syn eigen konfiguraasje file en log file om te wurkjen mei meardere eksimplaren fan elke SimApi. De nammen fan dizze files wurde efterheaksel troch de namme fan it eksimplaar lykas jûn op it SimApi ljepblêd yn it SIMCA-online Tsjinner Opsjes dialooch.
• De folgjende eksample toant de nammejouwing fan dizze files, wêr moat ferfongen wurde troch de SimApi-namme.
• Konfiguraasjenamme jûn as de eksimplaar wurdt tafoege: OmegaServer
• Konfiguraasje file namme: OmegaServer.xml
• Lochboek file namme: OmegaServer.log
• Tink derom dat de generike file .lochboek file wurdt noch makke. Dizze log file befettet ynstjoerings dy't om technyske redenen net nei it log kinne wurde rjochte file fan de eksimplaren..
• Dizze map is standert ferburgen yn Windows. Om it yn te sjen File Explorer jo ynstelle it sjen litte ferburgen files. Tink derom dat jo nei in ferburgen map kinne navigearje troch in adres yn te typen File Explorer's adresbalke.
• Tink derom dat SIMCA gjin meardere eksimplaren fan 'e SimApi stipet, en dêrom de nammen sûnder eksimplaarnamme brûkt lykas hjirboppe beskreaun.

Netwurk planning

• Jo moatte de SIMCA-online-tsjinner tichtby de gegevensboarne yn it netwurk fine. Dit soarget foar in rappe ferbining tusken SIMCA-online en syn gegevensboarne.
• Netwurkapparatuer kin ynterferearje mei de ferbining tusken SIMCA-online en de gegevensboarne.

Brûkersakkounts en tagongsrjochten foar gegevensboarnen

• Gegevensboarnen kontrolearje typysk tagong ta har gegevens. Dit wurdt normaal dien mei brûkersnammen en wachtwurden, mar IP-adres- of DNS-basearre beheiningen kinne ek brûkt wurde (bgl.ample PI Trusts in Aveva PI System).
• De brûkersnamme en wachtwurd kinne op ferskate manieren oan 'e gegevensboarne wurde levere:
• In SimApi wurdt útfierd as de Windows-brûker fan de brûker dy't it buroblêd SIMCA draait as it SIMCA-online tsjinstaccount op 'e serverkomputer. De SimApi kin ferbine mei de gegevensboarne mei dit akkount. Dit is hoe't de OPC I, en de PI SimApi wurkje, en ODBC as jo gjin bewiisbrieven leverje by it konfigurearjen.
• Foar generike ODBC kinne jo de ODBC Data Sources Administrator-applikaasje brûke fûn op Start yn Windows.
• Guon databaseproviders leverje har eigen sjauffeurs en ark foar har databases. Oracle-databases, bygelyksample, brûk de Oracle Data Access Components (ODAC).
• Guon SimApi's, lykas PI AF en ODBC, hawwe konfiguraasjedialogen dy't de fersifere referinsjes opslaan yn 'e SimApi XML-konfiguraasje file.
• PI hat ek ferskate befeiligingsopsjes beskikber yn 'e PI System Management Tools op' e PI-tsjinnerkomputer. Lês mear yn 'e PI AF SimApi User Guide. Dizze hantlieding is nuttich, sels as jo de âldere OSIsoft PI SimApi brûke.
• OPC DA en HDA brûke DCOM as it ferfier tusken in gegevensboarne en SimApi. DCOM is konfigurearre mei it Component Services-ark (DCOMCNFG.EXE) yn Windows en brûkt Windows-autentikaasje.
• Foar de âldere OSIsoft PI SimApi (net de nijere AF SimApi), wurdt de OSIsoft AboutPI-SDK-applikaasje (PISDKUtility.exe) brûkt om de ferbining mei de PI-tsjinner yn te stellen.

Ferifiearje gegevens boarne Konnektivität
As jo ​​​​in SimApi op in kompjûter wolle ynstallearje, kin it handich wêze om de ferbining fan dy kompjûter nei de gegevensboarne te kontrolearjen mei in oar ark:

• ODBC-gegevensboarnen yn Windows wurde brûkt om generyske ODBC te konfigurearjen en te testen. Tink derom dat d'r twa ferzjes fan dit ark binne op 64-bit Windows: ien foar 32-bit applikaasjes en ien foar 64-bit. Brûk de knop Testgegevensboarne oan 'e ein fan' e ODBC-konfiguraasjewizard om de ferbining mei de databank te ferifiearjen. Wy riede oan dat jo jo gegevensboarnen ynstelle as Systeem DSN's.
• In databank-spesifike ferbiningsark fan de provider fan de databank, lykas de Oracle Data Access Components.
• PI System Explorer kin brûkt wurde om ferbining te testen mei de PI AF-tsjinner. It is diel fan 'e PI AF Client dy't in betingst is foar de PI AF SimApi.
• OPC UA Expert fan Unified Automation - UaExpert is in cross-platform testkliïnt foar OPC UA-tsjinners.
• De PI-SDK-applikaasje (PISDKUtility.exe) kin brûkt wurde om ferbining te testen en te view alle flaterberjochten dy't mooglik ynlogd binne as SIMCA-online besiket te ferbinen mei de PI-tsjinner. Dit wurdt allinnich brûkt foar de âldere OSIsoft SimApi, net PIAF.
• PI System Management Tools wurde brûkt op de PI tsjinner kompjûter foar troubleshooting fan dy kant. Bygelyksample, om te sykjen nei feiligensproblemen dy't tagong foarkomme fan 'e SIMCA-online-tsjinner. Learje mear oer problemen mei PI-systeem yn dizze YouTube-fideo.
• Excel kin brûkt wurde om gegevens te krijen fan in ODBC-ferbining en de measte oare systemen as in gaadlik plugin ynstalleare is.
• Matrikon OPC Explorer foar Ior HDA (dit binne aparte ark) kin brûkt wurde om OPC-ferbining te testen, en Matrikon OPC Analyzer kin brûkt wurde om de problemen mei OPC-ferbining te diagnostearjen. Download dizze fergese ark fan https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (foar DInd HDA) fan 'e OPC Training Institute's web site " stelt brûkers yn steat om kommunikaasje- en feiligensproblemen maklik te diagnostizen, en se direkt te reparearjen mei de druk op in knop. Dit alles kin dien wurde sûnder oait te learen hoe DCOM te konfigurearjen“

It ynstallearjen fan in SimApi

Hjir is hoe't jo in SimApi op in PC kinne ynstallearje:

1. Lês de brûkersgids foar de SimApi dy't jo ynstallearje. It befettet spesifikaasjes foar dy SimApi dy't de algemiene ynstruksjes oanfolje dy't jo no lêze.
2. Ynstallearje en konfigurearje alle betingsten neamd yn 'e SimApi User Guide (bglample database-bestjoerders of SDK's)
3. Laad it opsetprogramma út om de SimApi te ynstallearjen. Ynstallearje de 64-bit (x64) of de 32-bit (x86) ferzje dy't oerienkomt mei de software wêryn jo it sille útfiere.
4. Konfigurearje de SimApi yn SIMCA-online of SIMCA lykas beskreaun yn 'e folgjende seksjes en ferwize nei de brûkersgids fan' e SimApi foar beskriuwingen fan beskikbere ynstellings.
5. Start de SIMCA-online tsjinner. Tink derom dat dit tiid kin duorje, om't as de SimApi is inisjalisearre, sil it alles opnimme tags yn 'e gegevensboarne.
6. Test de SimApi troch wat gegevens te krijen. Foar SIMCA-online kinne jo brûke File > Extract lykas beskreaun yn 6.1.
7. As de SimApi net wurket lykas ferwachte, ferwize dan nei it SimApi-log files foar probleemoplossing, en nei de SimApi brûkersgids.

It ynstellen fan de SimApi foar gebrûk yn SIMCA

Hjir is hoe't jo de SimApi brûke yn SIMCA:

1.  Begjin de databankymport op ien fan 'e folgjende manieren:
   • a. Om in nij projekt te meitsjen yn SIMCA: File > Nij gewoan projekt as nij batchprojekt. Selektearje Fan databank op it ljepblêd Thús.
   • b. Om in gegevensset te ymportearjen yn in besteand projekt yn SIMCA: Fan dataset op it ljepblêd Gegevens fan in iepen SIMCA-projekt.
2. Klikje Nije gegevensboarne taheakje
3. Selektearje SimApi as ferbiningstype, klikje op de …-knop en sykje de .dll yn 'e ynstallaasjemap, en klikje op Iepenje.
4. Klikje Konfigurearje en ferwize nei de yndividuele SimApi-brûkersgids hoe't jo de ynstellings meitsje.
5. Klikje op de Test gegevensboarneferbining om te kontrolearjen dat jo ferbine kinne mei de databank. Dit kin lang duorje as d'r in protte binne tags yn 'e gegevensboarne.
6. Klikje OK om de konfiguraasje te foltôgjen.
7. Ferwize nei de SIMCA-help foar hoe't jo wurkje mei ymporteare gegevens.

De SimApi ynstelle foar gebrûk yn SIMCA-online

• Wichtich: Om in SimApi te brûken, is in SIMCA-online serverlisinsje nedich. In demo-ynstallaasje fan SIMCA-online lit SimApis net brûkt wurde.
• Om in SimApi ta te foegjen oan it systeem, rinne jo SIMCA-online Server Options op de server PC. Learje de details stappen yn it SICMA-online helpûnderwerp Foegje in SimApi ta en konfigurearje op de tsjinner.
• Tip: As jo ​​wizigingen meitsje foar in SimApi, kinne jo dizze SimApi apart fan Tsjinneropsjes opnij starte sûnder de folsleine tsjinner opnij te begjinnen.
• Om meardere eksimplaren fan dizze SimApi te konfigurearjen, werhelje de boppesteande stappen en brûk unike nammen foar elke eksimplaar. Lês mear oer de ferskillende log en konfiguraasje files foar de gefallen yn 4.2.

Testen en problemen oplosse in SimApi

• Dit haadstik giet oer it testen en oplossen fan in SimApi-ynstallaasje.

Testen fan in SimApi fan SIMCA-online

• Sadree't de SIMCA-online tsjinner mei súkses opstart is, kinne jo jo SimApi testen yn SIMCA-online (as de tsjinner net begjint, sjoch 6.2):
• Oanmelde by de tsjinner yn de SIMCA-online client, en navigearje nei Extract op de File tab. Extract helpt jo de SimApi te testen troch gegevens dêrtroch te krijen:
• De knooppunten ("mappen") fan 'e SimApi wurde werjûn yn it linkerfak. Tags foar it selektearre knooppunt wurde rjochtsboppe werjûn.
• Aktuele gegevens kinne fluch wurde hifke troch gewoan te klikken view> oan tags dy't trochgeande prosesgegevens leverje (sjoch it skermôfbylding)
• Rjochts-klikke op in knooppunt om batches te finen binnen in tiidbereik. It knooppunt moat in batchknooppunt wêze dat wit oer batches.
• Selektearje tags yn Extract en klikje op Folgjende en foltôgje de wizard om gegevens te krijen mei de ferskillende manieren fan gegevensopheljen: aktuele, histoaryske, batch- en diskrete gegevens.
• Fergelykje de ekstrahearre gegevens mei wat jo sjogge yn jo gegevensboarne mei har ark. Learje mear oer it testen en validearjen fan alle funksjes fan in SimApi yn 7.13.

SimApi-problemen oplosse mei it SimApi-logboek file

• As de tsjinner net begjint, de SimApi wurket net as ferwachte of it útpakken mislearret, moatte jo it SimApi-log rieplachtsje file dy't jo fertelt wat it probleem is. Skeakelje logboek op debug-nivo yn it SimApi-loch yn om folsleine details te krijen. Sjoch 4.2.
• Opmerking: de SIMCA-online tsjinner logs binne hjir net sa nuttich. Se sille sjen litte hoe't de SimApi waard laden en inisjalisearre troch de tsjinner, mar de SimApi spesifike details binne yn syn log file.

Brûk it juste SIMCA-online tsjinstkonto

• As jo ​​​​tagong testen ta de gegevensboarne, tink dan oan dat jo binne oanmeld as in spesifike brûker op 'e serverkompjûter (typysk jo eigen brûkersaccount yn in Windows-domein), mar dat it SIMCA-online-tsjinner tsjinstkonto in oar akkount is, standert LocalSystem, dat oare tagongsrjochten hat yn ferliking mei jo brûkersaccount.
• Om dizze reden is it net ûngewoan dat tests wurkje as se rinne as jo akkount, mar dat SIMCA-online net slagget om te ferbinen mei de gegevensboarne.
• Om dit probleem op te lossen, moat tagong wurde ferliend foar it akkount dat wurdt brûkt troch de SIMCA-online tsjinner tsjinst. Typysk feroarje jo LocalSystem nei in spesifyk domeintsjinstaccount, en jouwe rjochten oan dit akkount. Tink derom dat dit net jildt as de SimApi bewiisbrieven brûkt dy't yn 'e SimApi-konfiguraasje ynsteld binne, om't dizze bewiisbrieven foarrang hawwe.

Technyske details oer SimApis

• Dit haadstik jout technyske details oer hoe't in SimApi wurket. It is benammen rjochte op ûntwikkelders dy't SimApis wolle begripe om in SimApi te ymplementearjen foar in gegevensboarne.
• Ûntwikkelers moatte ek lêze de eardere dielen fan dit dokumint foar in yntroduksje ta SimApis en de hege-nivo beskriuwingen fan funksjes.

Wannear moatte jo beskôgje it ûntwikkeljen fan in SimApi en wannear net?

Foardat jo beskôgje it ûntwikkeljen fan in SimApi foar in gegevensboarne:

1. Undersykje as d'r al in SimApi is dy't jo kinne brûke. Miskien kinne jo wat funksje yn jo gegevensboarne ynskeakelje om ien fan 'e besteande SimApis te brûken, lykas OPC UA.
2. Gean foarsichtich troch dit dokumint en syn ferwizings en ûndersiikje oft jo gegevensboarne foldocht oan easken: bygelyksample, it moat wêze fluch genôch, jouwe net allinnich aktuele gegevens, mar ek histoaryske gegevens.

• Om dizze redenen riede wy net oan om in SimApi te ûntwikkeljen dy't oanslút op hardware of ynstruminten op leech nivo. It is better om te ferbinen dy ynstruminten oan in proses histoarikus lykas Aveva PI System, en lit it krije gegevens út it ynstrumint, en histoarje it. Dan kin de PIAF SimApi brûkt wurde om gegevens te krijen fan PI nei it Umetrics-produkt.

SimApi-ûntwikkeling en de SimApi-spesifikaasje

• De SimApi-spesifikaasje, SimApi-v2, befettet dokumintaasje foar alle C-funksjes yn 'e SimApi dy't in SimApi DLL moat ymplementearje, lykas wat begelieding foar hoe't jo in SimApi ûntwikkelje kinne.
• It ymplementearjen fan in SimApi mei C of C++ is yn de measte gefallen op in ûnnedich leech nivo.
• De oanrikkemandearre, en makliker, manier om in SimApi te ymplementearjen is it te basearjen op 'e ExampleSimApi boarnekoade dy't wy leverje. It is in eksample SimApi ymplemintaasje dy't behannelet de C-ynterface en oerset yn.NET Framework dêr't de eigentlike ymplemintaasje wurdt makke. It hat ek ramtkoade foar logging, ynstellings, konfiguraasje GUI, en oare ramtkoade.
• Om in SimApi te ûntwikkeljen hat it team fan ûntwikkelders ûnderfining nedich yn Windows-ûntwikkeling, .NET Framework, C, of ​​C++. Goede kennis fan de gegevensboarne dêr't de SimApi mei ferbine moat, is ek fereaske, om't it doel fan in SimApi is om gegevensoanfragen fan SIMCA-online of SIMCA oer te setten nei de API fan 'e gegevensboarne. In SimApi-ymplemintaasje is nea in ienmalig projekt, mar hat typysk trochgeande stipe en ynsidintele ûnderhâld nedich.

Lêzen of skriuwen fan gegevens

• In SimApi hat de haadtaak om gegevens te leverjen fan in gegevensboarne. Dit wurdt oantsjutten as it lêzen fan gegevens.
• De measte SimApi-ymplemintaasjes stypje ek it skriuwen fan gegevens. Dit betsjut dat jo gegevens weromskriuwe fia de SimApi nei de gegevensboarne. Gegevens skriuwe is in opsjonele funksje yn SIMCA-online.

Tags en Knooppunten

• A tag is in identifier fan in kolom as "fariabele" yn in gegevensboarne. IN tagsyn namme wurdt brûkt om te identifisearjen de tag. Nammen binnen node moatte unyk wêze. SIMCA-online 18 is de earste ferzje te stypjen in knooppunt dat befettet in sub knooppunt en tag mei deselde namme. Bygelyksample: de knooppunt Parent kin hawwe in sub knooppunt neamd Batch en in tag neamd Batch.
• In knooppunt is in kontener fan tags. In knooppunt kin ek befetsje oare knopen, fergelykber mei hoe a file systeem hat mappen yn mappen.
• Lykas yn a file systeem, it knooppunt en tag nammen kinne wurde kombinearre ta in folslein paad dat unyk identifisearret a tag. De tag paden wurde brûkt yn SIMCA-online as SIMCA by it selektearjen tags te brûken. IN tag paad begjint mei in SimApi eksimplaar namme folge troch de node-struktuer, en einiget mei de tag namme, elk item skieden mei in kolon (:). Bygelyksample “:ODBCSQLServer:Node:SensorTag1".

De SimApi telt tags en knopen by it opstarten

• In SimApi ymplemintaasje blêdzje de tsjinner foar knopen en tags yn 'e gegevensboarne as de SimApi is inisjalisearre en hâldt se by, sadat de ferskate SimApi-funksjes dy't brûkt wurde foar opsomming tags en node kin wurde útfierd.
• SimApi-initialisearring bart net allinich by it opstarten fan 'e tsjinner, mar kin ek opnij wurde triggered troch in brûker yn SIMCA-online mei de SimApi-funksjonaliteit ferfarskje.

Case gefoelichheid fan tag- en node nammen

• Tag nammen en node nammen binne haadlettergefoel.
• Sa, a tag neamd "tag1" is net itselde as "Tag1" fanwegen it oare gefal fan 'e "T". Wy riede oan tsjin it brûken tags of node nammen dy't ferskille allinnich yn gefal.

Trochrinnende proses node 

• Wannear't in knooppunt befettet tags mei trochgeande proses data, it kin oantsjutten as in proses node. De folgjende twa skermôfbyldings litte in tabelfoarming sjen fan in prosesknooppunt mei gegevens folge troch in ôfbylding dy't toant hoe't it knooppunt derút sjocht by it selektearjen tags yn SIMCA-online.

Trochrinnende prosesknooppunten moatte ûnôfhinklik wêze fan batches, runs of tiid

• Om goed te wurkjen yn in SimApi moat in knooppunt ûnôfhinklik wêze fan batches, runs of tiid. It hawwen fan in knooppunt dat befettet gegevens foar in spesifike batch of tiid berik soe net wurkje goed yn SIMCA-online omdat de projekt konfiguraasje dan koe allinnich lêze gegevens foar dy batch en net brûkt wurde foar oare batches.
• Ynstee, in knooppunt moat wurde yn kaart brocht oan ien of mear fysike ienheden yn it proses dêr't mjittings wurde útfierd.

Batch ID tag nedich yn trochgeande proses knopen foar batch projekt útfiering

• Elts trochgeande proses moat hawwe in tag (fariabele) holding de batch identifier foar eltse observaasje. Dizze batch-identifikaasje wurdt brûkt troch SIMCA of SIMCA-online om te witten by hokker batch elke observaasje heart.
• De $BatchID tag yn 'e skermôfbyldings yn 7.4.3 is sa'n eksample.
  Wylst net fereaske, is it oan te rieden om te hawwen in tag yn it prosesknooppunt dat de aktuele faze as stap fan it proses toant. Dit tag kin dan brûkt wurde yn faze-útfierbetingsten yn SIMCA-online of yn SIMCA by it ymportearjen fan gegevens. Wearden foar dit tag kin wêze foar eksample "phase1", "skjinmeitsjen", "phase2".

Batch kontekst node

• In batchknooppunt is in knooppunt dat batches byhâldt; harren batch-identifikaasjes, begjintiden en eintiden. It is in eask foar batchprojektútfiering yn SIMCA-online. In gegevensboarne kin mear as ien batchknooppunt hawwe dy't batches op ferskate manieren bleatstelle. De brûker selekteart it batchknooppunt dat jildt foar syn of har applikaasje. Dizze eksample bleatstelt batches dy't twa ferskillende ienheden spanne:
• /Factory1 -batches mei aggregearre libbenstiden oer sawol Unit1 as Unit2.
• /Factory1/Unit1 - batches mei lifetimes allinich yn Unit1
• /Factory1/Unit2 - batches mei lifetimes allinich yn Unit2
• As jo ​​​​gjin batchknooppunt hawwe yn jo gegevensboarne, kinne jo de Batch Context Generator brûke yn SIMCA-online. Sjoch de ynboude help.
• Opsjonele batchgegevens
• In batchknooppunt kin ek batchgegevens befetsje; gegevens dêr't mar ien observaasje foar is foar de hiele batch. Merk op dat tags mei batch gegevens hoege net te wêzen yn in knooppunt dat hat de folsleine funksjonaliteit fan in batch knooppunt. It is genôch dat de SimApi stipet lêzen batch gegevens foar de tags. Learje mear oer batchgegevens yn 7.6.
• Hjir is in eksample fan in batchknooppunt:
• Opmerking: It boppesteande skermôfbylding is nommen fan DBMaker, bondele mei SIMCA-online. Om dit sels te sjen yn DBMaker, klikje op de View Gegevensknop op 'e Bakers Yeast-database om twa finsters te werjaan, wêrfan ien de batchknooppunt is, en de oare de prosesgegevens.

Gegevenstypen: numerike gegevens, tekstgegevens en ûntbrekkende gegevens

• Foar elk tag, in SimApi kin trije soarten gegevens stypje: numerike, tekst, t en ûntbrekkend:
• Numerike gegevens binne typysk echte wearden fan prosesparameters, bygelyksample 6.5123. De SimApi kin allinich 32-bit single-precision driuwende puntwearden behannelje. Single-precision floating-point format -Wikipedia. Alle oare numerike gegevenstypen yn in gegevensboarne moatte wurde omboud ta float. As sadanich kinne se omgean mei sawol grutte as lytse wearden, mar mei mar sawat 6 of 7 wichtige sifers. Learje mear yn 'e Technyske Gids.
• Dit kin liede ta ferlies fan krektens foar grutte heule getallen as foar echte getallen dy't beide grut binne en desimalen hawwe. Foar mear ynformaasje, sjoch de Technyske Gids.
• Tekst-/stringgegevens wurde brûkt foar batch-ID's, faze-útfierbetingsten of foar kwalitative fariabelen. De wearden foar tekst tag gegevens binne haadlettergefoel. Dit betsjut dat de wearde "rinnend" is net itselde as
  "TE RINNEN". Datum-tiidfariabelen wurde net direkt stipe troch de SimApi, mar se kinne weromjûn wurde as in tekenrige opmakke as JJ-MM-DD UU:MM (bgl.ample “2020-09-07 13:45”).
• Untbrekkende wearden betsjut dat d'r gjin wearde is om werom te jaan, dat wol sizze gjin gegevens.
• Hokker type wurdt weromjûn is oan 'e SimApi-ymplemintaasje. In SimApi wit oer de gegevens yn 'e gegevensboarne en moat it gegevenstype weromjaan dat it bêste past.

Trije modi foar opheljen fan gegevens: kontinu, batc, h en diskreet

• De SimApi-spesifikaasje definiearret trije manieren fan opheljen foar gegevens, ie. trije ferskillende wizen wêrfan de SimApi gegevens kin leverje tags yn in gegevensboarne (of yn 'e oare rjochting: gegevens skriuwe nei tags yn in gegevensboarne).
• Trochrinnende gegevens opheljen - dit ferwiist nei gegevens lêzen kontinu, en sequentially, observaasje per observaasje as de batch of proses evoluearret. Gegevens wurde lêzen foar de aktuele tiid, of foar in spesifyk berik, op in reguliere ynterval tusken observaasjes. Bygelyksample, alle gegevens tusken 09:00:00 en 10:00:00 sampled eltse 60 sekonden, resultearret yn 61 observaasjes as ein punten binne ynklusyf.
• Batch gegevens opheljen - dit ferwiist nei in inkele observaasje mei gegevens foar in hiele batch (net assosjearre mei in spesifike folwoeksenheid of tiid punt). Batch-attributen en lokale sintrumgegevens wurde lêzen as batchgegevens yn SIMCA-online. Batchbetingsten wurde normaal ek lêzen as batchgegevens (útsein as se binne konfigureare foar diskrete gegevensopheljen).
• Diskrete gegevens opheljen - diskrete gegevens kinne bestean út ferskate observaasjes foar in protte maturities. Mar oars as trochgeande gegevens, wurde diskrete gegevens net sequentieel lêzen, mar leaver alle gegevens tagelyk foar in spesifike faze fan in batch. Gegevens hoege net te spalten mei regelmjittige yntervallen fan 'e maturity fariabele. Alle gegevens wurde opnij lêzen elke kear as de gegevens wurde oanfrege, op it ynstelde ynterval.
• Foar elke jûn tag gegevens kinne wurde oanfrege yn ien fan 'e trije modi, mar typysk sil in SimApi mar ien fan dizze modi stypje foar in yndividu tag. Likegoed is it tastien om te mingjen tags binnen in knooppunt, mar typysk allegear tags binnen in spesifike knooppunt stypje deselde modus fan gegevens opheljen.
• Foar trochgeande gegevens (mar net foar batch- of diskrete gegevens2), kinne oanfragen dien wurde foar aktuele gegevens of histoaryske gegevens dy't it ûnderwerp fan 'e folgjende paragraaf is.
• Net alle SimApis stypje alle modi. Sjoch de funksjematrix hjirboppe en de SimApi web side foar details.

Aktuele en histoaryske trochgeande gegevens fia in SimApi

• Trochrinnende gegevens ferwiist nei prosesgegevens dy't oer de tiid feroarje.

Aktuele gegevens

• It lêzen fan aktuele gegevens betsjut it freegjen fan de gegevensboarne foar de lêste wearden fan tags op it momint fan freegjen. Tink derom dat de tiid fan 'e eksterne gegevensboarne hjir net brûkt wurdt.
• De gegevens lêzen as aktuele gegevens is wat SIMCA-online sil sjen litte as live gegevens. Om dizze reden is it wichtich dat d'r gjin ûnnedige fertragingen binne yn 'e gegevensboarne. Aktuele gegevens moatte sa resint mooglik wêze om goed te wurkjen yn SIMCA-online.
• De gegevensboarne kin syn kennis fan gegevens brûke en hoe lang wearden jildich binne en beslute om ûntbrekkende gegevens werom te jaan as de rauwe gegevens foar in tiidpunt te âld binne. Bygelyksample: gegevens wurde frege om 15:00:00, mar it meast resinte gegevenspunt yn 'e gegevensboarne is fan 03:00:00. Yn dit gefal binne de gegevens 12 oeren âld, sadat de SimApi kin beslute om ûntbrekkende wearde werom te jaan (gjin gegevens).

Histoaryske gegevens

• It lêzen fan histoaryske gegevens betsjut it freegjen fan de gegevensboarne foar wearden fan ien of mear tags foar in spesifyk tiidgebiet mei in spesifyk ynterval tusken observaasjes. Tink derom dat hjir de lokale tiid fan de gegevensboarne wurdt brûkt om de gegevens te finen. Dêrom is tiidsyngronisaasje tusken gegevensboarne en servers wichtich.
• Histoaryske gegevens bestiet út in matrix fan gegevens. It is oan de SimApi-ymplemintaasje om de gegevens fan 'e gegevensboarne te freegjen, en sample it op it opjûne ynterval en konstruearje de matrix fan gegevens om werom te kommen:
• Soms hat de gegevensboarne sels aggregaasjefunksjes om ferwurke gegevens werom te jaan, of sampling funksjes, dat kin brûkt wurde om werom de goede gegevens.
• Foar oare gegevensboarnen moat de SimApi alle gegevens yn it tiidbereik oanfreegje en dan sample de juste observaasjes om de matrix te konstruearjen.
• Gegevens moatte weromjûn wurde foar in tiidbereik, ek al binne d'r miskien gjin rûge gegevens yn it tiidbereik, mar allinich krekt foar de starttiid. Bygelyksample: gegevens bestean yn 'e gegevensboarne op tiidpunten 10 en 20. De SimApi freget gegevens foar tiid 15 en 17. Yn dit gefal moatte de wearden foar tiidpunt 10 weromjûn wurde troch de SimApi, mar tiidstipamped as tiid 15 en 17 sûnt dit wiene de meast resinte gegevens punten op dy tiden. De wearden foar tags op tiid 10 wurde oantsjutten as grinzen wearden foar de frege berik. Foar in djipper útlis fan grinzen wearden, sjoch bygelyksamplês de dokumintaasje foar returnBounds by UA Part 11: Histoaryske tagong - 6.4.3 ReadRawModifiedDetails-struktuer
  (opcfoundation.org)
• Ynterpolaasje moat nea brûkt wurde om wearden foar takomstige tiidpunten te berekkenjen, om't gegevens net oerienkomme mei wat yn realtime lêzen wurdt as aktuele gegevens. Foar de eksample fan 'e foarige kûgel: as gegevens foar 15 en 17 wurde ynterpolearre mei de wearden foar item 10 en 20, soene se effektyf wearden brûke út 'e takomst, wat net tastien is.
• De gegevensboarne kin har kennis fan gegevens brûke en hoe lang wearden jildich binne en beslute om ûntbrekkende gegevens werom te jaan as de rauwe gegevens foar in tiidpunt te âld binne. Bygelyksample: gegevens wurde frege foar 15:00:00, mar de meast resinte gegevens punt yn de gegevens boarne is fan 03:00:00. Yn dit gefal binne de gegevens 12 oeren âld, sadat de SimApi kin beslute om ûntbrekkende wearde werom te jaan (gjin gegevens).

Noat: SIMCA-online freget typysk net mear as hûndert observaasjes yn ien oprop by normale projektútfiering. By it dwaan fan extract yn SIMCA-online, of by it útfieren fan buroblêd SIMCA, kinne gruttere oanfragen fan gegevens makke wurde. Dizze kinne lang duorje, dat is te ferwachtsjen.

Aktuele gegevens en histoaryske gegevens moatte oerienkomme

• Soms kinne d'r ferskillen wêze as gegevens wurde lêzen as aktuele gegevens yn realtime of histoaryske gegevens. Dit soarget foar problemen yn SIMCA-online omdat de tsjinner automatysk skeakelt tusken aktuele en histoaryske gegevens as nedich.

Gegevenswinning mei lege latency

• As in gegevensboarne wurdt brûkt troch SIMCA-online yn real-time, is it wichtich dat de gegevens yn 'e gegevensboarne aktueel binne. D'r moatte gjin ûnnedige fertragingen wêze yn 'e gegevenswinning yn' e gegevensboarne. Trochrinnende prosesgegevens foar alle fariabelen moatte tagelyk beskikber wêze foar elke observaasje. Gegevens dy't te let komme foar guon fariabelen wurde net ophelle troch SIMCA-online.

Gegevens kinne foar elk momint lêzen wurde 

• Wannear't SIMCA-online freget om in wearde fan in tag foar tiid t sil it de wearde krije fan 'e gegevensboarne fan tiid t, of de lêste observaasje yn 'e gegevensboarne foar tiid t, of in ynterpolearre wearde foar tiid t. Sa sil de tsjinner altyd in wearde krije op elke kear wêr't er om freget, ek al is in observaasje foar dit krekte tiidpunt mooglik net yn 'e gegevensboarne.
• Tydlikamps yn de SimApi binne altyd UTC. SIMCA-online kliïnten en SIMCA presintearje de tiid as lokale tiid.

Threading 

• De SimApi wurdt, standert, neamd troch in inkele thread troch de brûker fan de SimApi. Dit is wier foar alle SIMCA-ferzjes en SIMCA-online oant ferzje 17.
• SIMCA-online 18 stipet in funksjeflagge om multi-threaded tagong fia SimApi yn te skeakeljen. Lês mear yn it helpûnderwerp Concurrent SimApi-tagong.
• Dit betsjut dat SimApis har tariede op multi-threading, as it mooglik is, troch de SimApi ymplemintaasje thread feilich te meitsjen, en dit en alle oerwagings foar brûkers fan de SimApi dokumintearje.

Lochboek file

• In SimApi moat aksjes, flaterberjochten en warskôgings yn har log logje file te helpen by it oplossen fan problemen. Brûk de ferskate lognivo's om it belang fan 'e logging oan te jaan.
• It is oan te rieden om "Net ymplementearre" oan te melden foar funksjes dy't net binne ymplementearre yn in SimApi.

Flater ôfhanneling

• Wannear't in SimApi in fersyk fan 'e gegevensboarne net folbringe kin, kin it dit probleem op ien fan twa manieren behannelje; troch ûntbrekkende wearden werom te jaan (gjin gegevens) of troch in SimApi-flater te sinjalearjen:
• It werombringen fan ûntbrekkende wearden oan de beller en it sinjalearjen fan sukses lit de beller trochgean as normaal (mar fansels sûnder gegevens). Dit is in oanrikkemandearre praktyk foar dielflaters, lykas wannear't gegevens kinne wurde krigen foar guon, mar net allegear, tags yn in fersyk.
• It sinjalearjen fan in SimApi-flater lit de beller (bglample de SIMCA-online tsjinner) om dit fuortendaliks te sjen en te hanneljen. Dit is in oanrikkemandearre praktyk foar oanfragen dy't folslein mislearje en hielendal gjin gegevens kinne weromjaan.
• SIMCA-online behannelet ûntbrekkende wearden of flaterkoades oars, lykas beskreaun yn de SIMCA-online Technical Guide.

SimApi prestaasjes easken

• De funksjes yn 'e SimApi wurde brûkt om gegevens te krijen.
• As gegevens tagong is stadich, de SimApi sil net wurkje goed dat dit example shows: As SIMCA-online freget gegevens eltse sekonde, mar it duorret twa sekonden te krijen, de SIMCA-online tsjinner sil nea by steat wêze om te hâlden up yn real-time, mar stadichoan falle fierder en fierder efter.
• Yn 'e subseksjes sille wy sjen litte hoe't SIMCA en SIMCA-online de SimApi-funksjes foar gegevenstagong brûke en hoe faak de SimApi-funksjes sille wurde neamd. Dit kin helpe by it ynstellen fan prestaasjeseasken foar in SimApi-ymplemintaasje.

SIMCA's gebrûk fan SimApi-funksjes

• Wannear't buroblêd SIMCA of oare offline produkten brûke in SimApi te krijen gegevens, dizze oanfragen sille wêze foar batches en proses gegevens foar in set fan fariabelen yn in bepaalde tiid berik.
• Om't dizze oanfragen mei de hân wurde inisjearre troch in brûker, komme se net heul faak foar en feroarsaakje se gjin signifikante lading foar in gegevensboarne.
• Dizze SimApi-funksjes wurde brûkt om de gegevens te krijen:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

SIMCA-online's gebrûk fan SimApi-funksjes

• SIMCA-online wurdt brûkt foar real-time tafersjoch fan in proses, en dêrom freget it gegevens fia de SimApi op regelmjittige yntervallen. It koartste útfieringsinterval dat brûkt wurde kin is 1 sekonde. Guon echte wrâld eksamples fan útfieringsintervallen binne 10 s, 1 minút of 10 minuten.
• In tsjinner kin in protte projekten tagelyk rinne.
• Om it oantal API-oproppen fia de SimApi te ferminderjen, optimalisearret de tsjinner gegevensoanfragen troch in protte tagelyk lytsere oanfragen te groepearjen yn ien grutter fersyk foar alle fariabelen tagelyk (lear mear yn it helpûnderwerp 'Optimalisearre lêzen fan gegevensboarnen ferbetteret prestaasjes').
• It útfieringsalgoritme fan de tsjinner wurket sa as it gegevens freget mei de hjirûnder neamde SimApi-funksjes:
• Alle fazen dy't mei itselde ynterval útfiere wurde groepearre yn ien SimApi-oprop om it oantal oproppen te ferminderjen. De tsjinner lêst de lêste gegevens foar alle fariabelen brûkt troch alle modellen dy't diele it ynterval, ie, dizze oprop sil resultearje yn in brede gegevens rige dy't dan wurdt brûkt troch alle projekten.
  • simapi2_connectionReadCurrentData
• Foar elk batchprojekt moat de tsjinner ek witte hokker batches aktyf binne. Dit moat ek barre elke kear as in projekt útfiert:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes wurdt minder faak oanroppen.
• Derneist fereasket SIMCA-online ek histoaryske gegevens. Dizze oanfragen passe allinich as it nedich is, lykas it begjin fan in batch ophelje dy't begon foardat SIMCA-online begon wie, of as de tsjinner efter falt en in blok gegevens moat lêze:
  • simapi2_connectionReadHistoricalDataEx
• Opsjoneel brûke guon projektkonfiguraasje funksjes dy't batchgegevens brûke as diskrete gegevens dy't resultearje yn SimApi-oproppen nei:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Opsjoneel brûke guon projektkonfiguraasje weromskriuwing om gegevens werom te triuwen nei de gegevensboarne:
  • simapi2_connectionWriteHistoricalDataEx (en oerienkommende funksjes foar batchgegevens, diskrete gegevens)
• It is wichtich dat elke oprop nei de kearnfunksjes foar it heljen fan gegevens, readCurrentData, getActiveBatches/getBatchTimes, fluch is en dat is net komputerysk dreech foar de gegevensboarne sels, jûn hoe faak SIMCA-online dy funksjes neame kin.

SimApi-gegevens testen en validearje

• Dizze seksje giet oer it testen fan in SimApi om te kontrolearjen dat de gegevens dy't derút weromjûn binne oerienkomme mei gegevens yn 'e gegevensboarne sels. It útfieren fan testen lykas dit is wichtich nei it meitsjen of feroarjen fan SimApi-ymplemintaasje, of as de API fan in gegevensboarne feroaret.
• Yn 'e praktyk wurdt gegevensvalidaasje dien mei SIMCA-online en syn Extract-funksjonaliteit om gegevens fan' e gegevensboarne fia de SimApi te lûken en dan te fergelykjen mei de rauwe gegevens yn 'e gegevensboarne. Desktop SIMCA kin net brûkt wurde om de real-time aspekten fan in SimApi te testen.

Tariedingen en easken

• Guon items binne opsjoneel, mar kinne wurde útfierd as de omfang fan jo testen it omfettet:

1. Ynstallearje SIMCA-online lykas beskreaun yn ReadMe en Ynstallaasje Guide.pdf dat komt yn it produkt zip.
2. Krij in lisinsje foar de SIMCA-online tsjinner en ynstallearje it. De SimApi sil net wurkje sûnder in lisinsje. It kennisbasisartikel foar SIMCA-online lit sjen hoe't jo it produkt lisinsje kinne. Bygelyksample: SIMCA-online 18 (sartorius.com)
3. Ynstallearje en konfigurearje de SimApi dy't jo wolle testen. Ferwize nei haadstikken 4 – 5 yn dit dokumint en de brûkersgids fan de spesifike SimApi.
   • a. Opsjoneel: soargje derfoar dat de brûkersgids bywurke en korrekt is.
4. Soargje derfoar dat jo in ark hawwe foar jo gegevensboarne wêrmei jo de SimApi-gegevens kinne fergelykje.
5. Yn de SIMCA-online buroblêd client, log yn op jo SIMCA-online tsjinner en brûk File > Ekstrahearje om gegevens te krijen fia de SimApi.
6. Opsjoneel as jo testomfang it omfettet: nei it foltôgjen fan testen, ferwiderje de SimApi en ferifiearje syn files wurde fuorthelle.

Wat te testen

• De funksjematrix yn haadstik 3 listet alle mooglike funksjes, mar in opjûne SimApi-ymplemintaasje kin allinich in subset stypje. Jo moatte alle funksjes testen dy't wurde ymplementearre troch de opjûne SimApi.
• De folgjende tests binne mienskiplik foar de measte SimApi-ymplemintaasjes:
• Ferifikaasje mei brûkersnammen en wachtwurden
• Test de ferskate ynstellingen yn 'e konfiguraasje fan' e SimApi
• Node hierargy: De knopen en tags bleatsteld troch de SimApi binne korrekt.
  • Der moat in tag bleatsteld foar alle "fariabelen" dy't beskikber wêze moatte fia de SimApi. Examples: proses mjittingen, berekkene wearden, konstanten.
• Ferbiningsbestendigens: as de gegevensboarne net beskikber is, resultearret dit yn warskôgings of flaters yn it log file, mar dat de ferbining mei de gegevensboarne automatysk opnij ynsteld wurdt as de gegevensboarne beskikber is.
• Meardere eksimplaren: dat twa eksimplaren kinne wurde konfigureare en ûnôfhinklik en tagelyk brûkt, mei aparte logs files.
• Aktuele gegevens: ekstrahearje aktuele gegevens foar tags. Soargje derfoar dat gegevens de lêste bekende wearden binne fan 'e gegevensboarne, of ûntbrekke foar minne kwaliteit of as gegevens te âld binne.
  • Ekstrahearje gegevens elke 10 sekonden (of sa) foar in minút.
• Histoaryske trochgeande gegevens: extract histoaryske gegevens foar tags.
  • Brûk it tiidbereik dat oerienkomt as jo aktuele gegevens ekstrahearje. Kontrolearje dat aktuele gegevens oerienkomme mei histoaryske gegevens, en de rauwe gegevens yn 'e gegevensboarne.
  • Besykje ferskillende tiid berik en sampling yntervallen, ferifiearje de gegevens oerienkomt mei de gegevens boarne.
  • Besykje gegevens elke 1 s út te heljen, dat is de koartst mooglike sampling ynterval.
  • Besykje ferskate soarten tags yn 'e gegevensboarne (prosesfariabelen, ensfh.), Soargje derfoar dat gegevens oerienkomme.
  • Opmerking: SIMCA-online kin in inkele grutte histoaryske gegevensfersyk splitse yn ferskate lytsere stikken. Dit sil sichtber wêze yn it SimApi-logboek.
• Kontrolearje dat de SimApi wurket mei tekstgegevens, numerike gegevens en ûntbrekkende gegevens.
• SimApi log file. Ferifiearje dat it log reedlike yngongen befettet.
• Batchknooppunt: Rjochtsklik op in knooppunt en doch Batches fine.
  • Ferifiearje batchnammen, begjintiden, eintiden foar batches.
  • Besykje in aktive batch dy't rint yn gegevensboarne. It moat gjin eintiid hawwe troch de SimApi.
• Process node batch identifier tag. As de SimApi batchknooppuntfunksjonaliteit hat (sjoch foarige kûgel), moat it ek in batch-identifikaasje hawwe tag yn de oerienkommende proses gegevens node. Gegevens foar dit tag moat de batch-identifikaasje (batchnamme) wêze. Dizze gegevens binne nedich foar batchprojekten om te identifisearjen by hokker batch in rige gegevens heart.

Ofhinklik fan as de SimApi it stipet, kinne jo ek wolle testen:

• Batch gegevens mei help fan File > Úttreksel.
• Diskrete gegevens mei help fan File > Úttreksel. Opmerking: om diskrete gegevens mei te testen File > Pake it knooppunt út, it batchknooppunt en diskrete gegevensknooppunt moatte yn deselde SimApi wêze (as SIMCA-online projekten útfiert, kinne se fan ferskate SimApis wêze).
• Skriuw werom - triuwe gegevens batch nei de gegevens boarne. Om dit te testen, moatte jo in projektkonfiguraasje yn SIMCA-online konfigurearje om gegevensvectors werom te skriuwen nei de gegevensboarne. Fier dan it projekt út yn SIMCA-online en kontrolearje de gegevens dy't weromskreaun binne yn 'e gegevensboarne.
• Trochrinnende gegevens wurde konfigureare op 'e Evolution Write Back-side yn' e projektkonfiguraasje.
• Diskrete gegevens is konfigurearre op deselde side, mar allinnich foar in faze konfigurearre foar diskrete gegevens opheljen.
• Batchgegevens fan 'e Batch Write werom

MEAR INFO

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Sweden
• Tillefoan: +46 90-18 48 00
• www.sartorius.com
• De ynformaasje en sifers befette yn dizze ynstruksjes oerienkomme mei de ferzje datum spesifisearre hjirûnder.
• Sartorius behâldt it rjocht foar om feroarings te meitsjen oan de technology, funksjes, spesifikaasjes en ûntwerp fan 'e apparatuer sûnder notice. Manlike of froulike foarmen wurde brûkt om lêsberens yn dizze ynstruksjes te fasilitearjen en altyd tagelyk alle geslachten oan te jaan.
  Copyright notice:
• Dizze ynstruksjes, ynklusyf alle komponinten, wurde beskerme troch auteursrjocht.
• Elk gebrûk bûten de grinzen fan 'e copyrightwet is net tastien sûnder ús goedkarring.
• Dat jildt benammen foar it werprintsjen, oersetten en bewurkjen, nettsjinsteande it type media dat brûkt wurdt.

FAQ

• F: Wat is it doel fan SimApis?
  • A: It haaddoel fan SimApis is om gegevens te leverjen oan Umetrics Suite-produkten foar projekt oanmeitsjen en modelbou.
• F: Hoe kin ik problemen oplosse mei in SimApi-ynstallaasje?
  • A: Jo kinne problemen oplosse troch te testen fan SIMCA-online, troch it SimApi-log te kontrolearjen file, en soargje foar de juste tsjinst account konfiguraasje.