SARTORIUS Sim Api Software

Speċifikazzjonijiet

• Isem tal-Prodott: Gwida SimApi
• Data ta’ Ħruġ: 5 ta’ Settembru, 2024
• Għan: Ipprovdi data lill-prodotti Umetrics Suite

Istruzzjonijiet għall-Użu tal-Prodott

Introduzzjoni għal SimApis

• SimApis jintużaw biex tiġi rkuprata data għall-ħolqien ta 'proġetti u l-bini ta' mudelli fil-prodotti Umetrics Suite.

Il-ksib ta' SimApis

• Biex tikseb SimApis, irreferi għad-dokumentazzjoni uffiċjali jew ikkuntattja l-appoġġ tal-klijent għall-għajnuna.

Karatteristiċi SimApi

• SimApis jipprovdi dejta f'ħin reali għall-monitoraġġ, il-kontroll u l-bini tal-mudelli f'SIMCA u SIMCA-online.

Użu tad-Dejta Kurrenti biss

• Huwa rakkomandat li tuża data kurrenti biss u tevita data storika għall-aħjar prestazzjoni.

Tħejjija għal Installazzjoni SimApi

• Qabel l-installazzjoni, kun żgur li s-sistema tiegħek tissodisfa r-rekwiżiti minimi speċifikati fil-gwida għall-utent.

Installazzjoni ta' SimApi

• Segwi l-istruzzjonijiet pass pass ipprovduti fil-manwal tal-utent biex tinstalla s-SimApi fis-sistema tiegħek.

Twaqqif ta' SimApi għal SIMCA

• Ikkonfigura s-settings ta' SimApi f'SIMCA skont il-linji gwida pprovduti.

Twaqqif ta' SimApi għal SIMCA-online

• Stabbilixxi s-SimApi għall-irkupru tad-dejta f'ħin reali u operazzjonijiet ta' write-back f'SIMCA-online.

Ittestjar u Soluzzjoni ta' Problemi

• Wara l-installazzjoni, wettaq l-ittestjar biex tiżgura funzjonalità xierqa. F'każ ta' kwistjonijiet, irreferi għat-taqsima dwar is-soluzzjoni tal-problemi fil-gwida tal-utent.

Ittestjar minn SIMCA-online

• Ittestja l-integrazzjoni SimApi minn SIMCA-online biex tivverifika l-irkupru tad-dejta.

Issolvi l-problemi bil-Log Files

• Uża l-log SimApi file biex tidentifika u ssolvi kwalunkwe problema ta' installazzjoni jew operattiva.

Konfigurazzjoni tal-Kont tas-Servizz

• Żgura l-konfigurazzjoni korretta tal-kont tas-servizz SIMCA-online għal tħaddim bla xkiel.

Dettalji Tekniċi

• Irreferi għat-taqsima 7 tal-gwida għall-utent għal informazzjoni teknika fil-fond dwar SimApis.

Introduzzjoni għal SimApis

• SimApi huwa interface tas-softwer bejn is-softwer Umetrics® Suite u sors tad-dejta. L-iskop primarju ta' SimApi huwa li jipprovdi data lil SIMCA®-online jew SIMCA®.
• Sartorius Stedim Data Analytics AB jiżviluppa SimApis għal ħafna sorsi ta 'dejta differenti, bħal storiċi tal-proċess u databases għal skopijiet ġenerali.
• Dan id-dokument juri x'inhu SimApi, u kif jintuża fil-prodotti Umetrics Suite. Int ser titgħallem kif tippjana għal, u tinstalla SimApi, kif issolvi l-problemi u kif tittestja l-installazzjoni tiegħek. Il-kapitolu finali fih dettalji tekniċi ta 'SimApis immirati għall-iżviluppaturi.

Għan SimApi: ipprovdi data lill-prodotti Umetrics Suite

• L-iskop primarju ta' SimApi huwa li jipprovdi data lil SIMCA-online jew SIMCA minn sors ta' data. Is-sors tad-dejta mhuwiex parti minn SIMCA-online iżda jista' jkun storiku tal-proċess jew sistema oħra li żżomm u timmaniġġja d-dejta.
• SimApi jesponi ġerarkija ta' nodi, li jikkorrispondu għal folders f'a file sistema. Kull node jista' jkun fih nodi oħra, jew tags. A tag jikkorrispondi għal varjabbli. Għal dawn tags, id-dejta tista' tinkiseb. L-istampa turi a tag, Temp, magħżula fin-node
• BakersYeastControlGood f'sors tad-dejta f'SIMCA-online. Juri wkoll l-aħħar valuri meħuda mis-sors tad-dejta.

Użu ta' SimApi fil-Umetrics Suite

• Is-softwer tad-desktop SIMCA jista’ juża SimApi biex jirkupra data għall-ħolqien tal-proġett u l-bini tal-mudelli kif turi l-istampa li ġejja.
• SIMCA-online juża SimApis biex jikseb dejta f'ħin reali għall-monitoraġġ u l-kontroll, kif ukoll jikteb lura d-dejta lis-sors tad-dejta. L-istampa li ġejja turi fejn is-SimApi jinsab f'sistema li tikkonsisti f'sors tad-dejta, server SIMCA-online, u klijenti.

SimApis użat b'mod komuni

• L-aktar SimApis użati huma:
• Il-PI AF SimApi għall-konnessjoni ma' Aveva (qabel OSIsoft) PI Systems.
• L-OPC UA SimApi
• L-ODBC SimApi - għal aċċess ġenerali għal databases bħal SQL Server jew Oracle
• Is-SimApis kollha disponibbli huma elenkati flimkien mal-karatteristiċi tagħhom fil-paragrafu 3.

Id-DBMaker SimApi għal data ta' simulazzjoni

• DBMaker hija applikazzjoni pprovduta bl-installazzjoni tas-server SIMCA-online. Jissimula sors tad-dejta, bħal storiku tal-proċess, billi juża tabella tad-dejta mgħobbija minn qabel fejn l-osservazzjonijiet huma pprovduti wieħed wieħed lil SIMCA-online permezz tad-DBMaker SimApi.
• DBMaker jintuża biss għal skopijiet ta 'dimostrazzjoni u ma jistax jintuża fil-produzzjoni b'dejta diretta minn sors ta' dejta. Ara l-għajnuna integrata biex titgħallem aktar dwar DBMaker.

Dokumentazzjoni addizzjonali

• Dan id-dokument huwa wieħed minn sett ta' dokumenti relatati, kull wieħed b'fokus u udjenza fil-mira differenti:

Sors	X'inhu	Fejn
SIMCA-online web paġna	Informazzjoni introduttorja u downloads	sartorius.com/umetrics-simca- onlajn

SIMCA-online ReadMe u Installazzjoni.pdf	Installazzjoni u kif tibda bid-data demo SIMCA-online	Fl-istallazzjoni zip file
Gwida ta' Implimentazzjoni SIMCA-online	Jiddeskrivi l-funzjonalità SIMCA-online, ipoġġiha f'kuntest ma' softwer Umetrics Suite ieħor, jiddeskrivi r-rekwiżiti u l-aħjar prattiki għal skjerament b'suċċess, u istruzzjonijiet ta 'installazzjoni pass pass.	sartorius.com/umetrics-simca- onlajn
Gwida SimApi	Tħejjija għal u twettaq installazzjonijiet SimApi, inkluż is-soluzzjoni tal-problemi. Fih ukoll dettalji tekniċi dwar SimApis għall-iżviluppaturi.	sartorius.com/umetrics-simapi
Gwidi għall-Utent SimApi	Dokumentazzjoni għal kull SimApi ppubblikata b'karatteristiċi, struzzjonijiet ta 'installazzjoni, u ispeċifiċitajiet ta' konfigurazzjoni.	sartorius.com/umetrics-simapi
SIMCA-online Gwida Teknika	Referenza teknika għall-ippjanar tal-installazzjoni tas-server SIMCA-online, is-soluzzjoni tal-problemi, u fil-fond kif jaħdem SIMCA-online.	sartorius.com/umetrics-simca-onlajn
SIMCA-għajnuna onlajn	Web-għajnuna bbażata fuq kif tuża SIMCA-online u kif jaħdem SIMCA-online.	Fis-softwer innifsu, u fuq sartorius.com/umetrics-simca
SIMCA-online Web Gwida għall-Installazzjoni tal-Klijent	Jiddeskrivi l-installazzjoni tas-SIMCA-online Web Klijent.	sartorius.com/umetrics-simca-onlajn
Bażi ta 'għarfien Umetrics	Database li tista' titfittex b'artikoli dwar kull verżjoni tas-softwer rilaxxata, artikoli tekniċi, u kwistjonijiet magħrufa fil-prodotti Umetrics Suite.	sartorius.com/umetrics-kb
Għajnuna SIMCA/gwida għall-utent	Kif tuża SIMCA tad-desktop għall-ħolqien ta 'proġetti u l-immudellar tad-dejta.	Fis-SIMCA u fuq sartorius.com/umetrics-simca
Appoġġ web paġna	Kif tikseb appoġġ tekniku.	sartorius.com/umetrics-support

Appoġġ tekniku

• It-tim ta' appoġġ onlajn ta' Sartorius iwieġeb mistoqsijiet tekniċi dwar SimApis u jista' wkoll jgħaddi talbiet għal titjib ta' SimApis lin-nies xierqa. Tgħallem aktar fuq sartorius.com/umetrics-support.

Il-ksib ta' SimApis

• Aħna nipprovdu dokumentazzjoni għal SimApis disponibbli u links għal programmi ta 'installazzjoni fuq sartorius.com/umetrics-simapi.
• Kull SimApi huwa dokumentat fil-Gwida għall-Utent tiegħu.
• Il-Gwida SimApi, li qed taqra le, tikkumplimenta dik l-informazzjoni b'SimApi li tikkumplimenta l-informazzjoni meta niġu għall-ippjanar, l-installazzjoni u s-soluzzjoni tal-problemi ta' SimApi.

Karatteristiċi ta' SimApi

• Mhux is-sorsi tad-dejta kollha huma l-istess. SimApi m'għandux għalfejn jimplimenta l-funzjonijiet kollha fl-ispeċifikazzjoni. Għal dawn ir-raġunijiet, SimApis differenti joffru funzjonalità differenti. Il-matriċi li ġejja telenka SimApis disponibbli u l-karatteristiċi tagħhom.
• Il-karatteristiċi huma spjegati hawn taħt. Innota li t-tabella għandha kolonni separati biex juru liema karatteristiċi huma disponibbli f'SIMCA-online u SIMCA rispettivament.

Karatteristika	Għan	SIMCA-użu onlajn	Użu SIMCA
Dejta kurrenti	Aqra osservazzjoni waħda bl-aktar valur riċenti mis-sors tad-dejta.	Eżekuzzjoni normali f'ħin reali	–
Data storika	Aqra ħafna osservazzjonijiet f'daqqa b'dejta storika mis-sors tad-dejta.	Tlaħħaq u tbassar tad-dejta tal-passat, toħloq proġetti bl-użu File > Ġdid	Database Import Wizard biex timporta data tal-proċess għall-ħolqien tal-mudell.
Dejta diskreta	Aqra d-dejta tal-laboratorju/IPC mis-sors tad-dejta. Ħafna osservazzjonijiet għal kull lott.	Għal proġetti tal-lott b'fażijiet jew kundizzjonijiet tal-lott konfigurati għall-irkupru tad-dejta diskreti.	–
Dejta tal-lott	Aqra l-kundizzjonijiet tal-lott u l-attributi tal-kwalità finali (jew	Kundizzjonijiet tal-lott jew ċentru lokali.	Database Import Wizard biex taqra l-kundizzjonijiet tal-lott għalihom

Karatteristika	Għan	SIMCA-użu onlajn	Użu SIMCA
	data oħra tat-tip MES). Osservazzjoni waħda għal kull lott.		ħolqien ta' mudell ta' livell ta' lott.
Nodu tal-lott	Speċifika l-ħin tal-bidu u l-ħin tat-tmiem (vojta għal lott attiv) għal lott speċifiku. Enumera l-lottijiet kollha li kienu jeżistu f'medda ta' żmien.	Meħtieġa għall-eżekuzzjoni tal-konfigurazzjonijiet tal-lott.	Database Import Wizard biex tagħżel lottijiet biex timporta.
Ikteb lura - data kontinwa	Ikteb dejta kontinwa, bħal tbassir, lura għas-sors tad-dejta.	Ikteb lura d-dejta mil-livell tal-evoluzzjoni tal-lott, għall-Konsulent tal-Kontroll jew għal konfigurazzjonijiet kontinwi	–
Ikteb lura – diskreti	Ikteb data diskreta, bħal tbassir, lura fis-sors tad-data.	Ikteb lura għall-konfigurazzjonijiet tal-lott fil-livell tal-evoluzzjoni tal-lott għal fażijiet konfigurati għall-irkupru tad-dejta diskreti	–
Ikteb lura – data tal-lott	Ikteb lura d-dejta tal-livell tal-lott, bħal tbassir jew attributi tal-kwalità finali, lis-sors tad-dejta.	Ikteb lura għall-konfigurazzjoni tal-lott fil-livell tal-lott	–
Ġerarkija tan-nodi	Is-SimApi jappoġġja ġerarkija ta' nodi, b'mod simili għal a file sistema. Kull node jista' jkun fih tags u nodi oħra. Il-ġerarkija tagħmel huwa aktar faċli biex jimmaniġġjaw numru kbir ta 'nodi u tags.	Appoġġjati fil-postijiet kollha fejn tags jintużaw.
Array tag espansjoni	Array tag jaħżen valuri multipli. Is-SimApi jespandi l-firxa tag lil ħafna individwi tags, wieħed għal kull element fil-firxa.	Appoġġjati fejn tags jintużaw għal data kontinwa. Kull estiża tag iridu jiġu mmappjati għal varjabbli fil-proġett SIMCA.
Sorsi tad-dejta multipli	Is-SimApi jista 'jgħaqqad ma' aktar minn sors ta 'dejta wieħed jew jappoġġja każijiet multipli tiegħu nnifsu b'settings u log individwali files għal kull istanza.	Qabbad ma 'diversi sorsi ta' dejta differenti tal-istess tip.	–
Reżiljenza tal-konnessjoni	Jekk is-SimApi jiġi skonnettjat mis-sors tad-dejta, jipprova jerġa' jistabbilixxi l-konnessjoni awtomatikament.	Is-SimApi m'għandux għalfejn jerġa' jinbeda biex jerġa' jistabbilixxi konnessjonijiet mas-sors tad-dejta.	–
Żviluppat internament	Is-SimApi huwa żviluppat, ipprovdut u appoġġjat minn

Id-dejta attwali biss, mingħajr dejta storika, mhix rakkomandata

• Xi SimApis, notevolment OPC DA, jappoġġja biss il-qari tad-dejta attwali, u mhux dejta storika.
• SimApi li jappoġġa biss data kurrenti ma jistax jintuża fid-desktop SIMCA, minħabba li mhux se jkun jista 'jaqra data storika li fuqha jibni l-mudelli.
• Għal SIMCA-online, nirrakkomandaw bil-qawwa sors tad-dejta u SimApi li jipprovdu mhux biss dejta kurrenti għal eżekuzzjoni f'ħin reali, iżda wkoll dejta storika biex tkun tista' tbassar u tlaħħaq id-dejta tal-passat. SIMCA-online jaqleb awtomatikament bejn data f'ħin reali u data storika kif meħtieġ u din ma tistax tintefa.
• Sors tad-dejta li jipprovdi biss dejta kurrenti, iżda mhux dejta storika, jista 'jaħdem għal proġetti kontinwi f'SIMCA-online, iżda għal proġetti tal-lott, hija meħtieġa dejta storika.

Tħejjija għal installazzjoni SimApi

• Din it-taqsima tiddeskrivi informazzjoni importanti għal installazzjoni b'suċċess ta' SimApi.

SimApis 64-bit jew 32-bit

• Hemm verżjonijiet 32-bit u 64-bit ta 'kull SimApi.
• SIMCA-online u SIMCA huma 64-bit u jeħtieġu l-varjanti SimApis 64-bit. Is-SimApis 32-bit tal-legat għadhom disponibbli għal installazzjonijiet anzjani.

Post għal log file u settings

• SimApi jaħżen il-log tiegħu files fil-folder moħbi tad-Data tal-Programm1:
  %programdata%\Umetrics\SimApi, fejn %programdata% jimmappa mal-folder attwali fuq il-kompjuter tiegħek. Huwa default għal C:\ProgramData.
• Kull SimApi tipikament juża log tiegħu stess file, li b'mod simili għall-log tas-server SIMCA-online file se jkun fih aktar jew inqas dejta skont issettjar tal-livell tal-log. Dan file huwa utli għas-soluzzjoni tal-problemi. Il-log file huwa msemmi
  .log fejn huwa s-SimApi li qed tinstalla, pereżempjuample PIAFSiApi. Ara wkoll it-taqsima li jmiss għall-ismijiet tal-istanzi SIMCA-online SimApi.
• Dan il-folder fih ukoll is-settings ta' SimApi f'XML file jismu .xml.
• Ħafna SimApis għandhom interfaces tal-utent grafiċi li jibdlu s-settings fl-xml file, iżda għal xi wħud iddaħħal il-bidliet direttament fl-XML file b'editur tat-test, bħal Notepad. Ara l-gwida għall-utent għal kull SimApi.

File ismijiet meta l-istanzi msemmija jintużaw ma' SIMCA-online

• F'SIMCA-online, kull istanza SimApi tikseb il-konfigurazzjoni tagħha stess file u log file biex taħdem ma 'istanzi multipli ta' kull SimApi. L-ismijiet ta' dawn files huma suffissi bl-isem tal-istanza kif mogħti fit-tab SimApi fid-djalogu tal-Għażliet tas-Server SIMCA-online.
• L-eżample turi l-ismijiet ta 'dawn files, fejn jeħtieġ li jiġi sostitwit bl-isem SimApi.
• Isem tal-konfigurazzjoni mogħti meta tiżdied l-istanza: OmegaServer
• Konfigurazzjoni file isem: OmegaServer.xml
• Log file isem: OmegaServer.log
• Innota li l-ġeneriku file .log file għadu maħluq. Dan il-log file fih entrati li għal raġunijiet tekniċi ma jistgħux jiġu diretti lejn il-ġurnal file tal-istanzi..
• Dan il-folder huwa moħbi fil-Windows b'mod awtomatiku. Biex taraha fi File Explorer inti tikkonfigurah juru moħbija files. Innota li tista’ tinnaviga għal folder moħbi billi tikteb indirizz File Il-bar tal-indirizz tal-Explorer.
• Innota li SIMCA ma jappoġġjax każijiet multipli tas-SimApi, u għalhekk juża l-ismijiet mingħajr isem tal-istanza kif deskritt hawn fuq.

Ippjanar tan-netwerk

• Għandek issib is-server SIMCA-online qrib is-sors tad-dejta fin-netwerk. Dan jiżgura konnessjoni mgħaġġla bejn SIMCA-online u s-sors tad-dejta tagħha.
• It-tagħmir tan-netwerking jista' jinterferixxi mal-konnessjoni bejn SIMCA-online u s-sors tad-dejta.

Kontijiet tal-utent u permessi tas-sors tad-dejta

• Is-sorsi tad-dejta tipikament jikkontrollaw l-aċċess għad-dejta tagħhom. Dan normalment isir bl-ismijiet tal-utent u l-passwords iżda jistgħu jintużaw ukoll restrizzjonijiet ibbażati fuq l-indirizz IP jew id-DNS (eż.ample PI Trusts fis-Sistema Aveva PI).
• L-isem tal-utent u l-password jistgħu jiġu pprovduti lis-sors tad-dejta b'modi differenti:
• SimApi jitmexxa bħala l-utent tal-Windows tal-utent li jħaddem id-desktop SIMCA jew il-kont tas-servizz SIMCA-online fuq il-kompjuter server. Is-SimApi jista’ jgħaqqad mas-sors tad-dejta billi juża dan il-kont. Dan huwa kif l-OPC I, u l-PI SimApi jaħdmu, u ODBC jekk ma tipprovdix kredenzjali meta tikkonfigurah.
• Għal ODBC ġeneriku tista' tuża l-applikazzjoni ODBC Data Sources Administrator li tinsab fuq Start fil-Windows.
• Xi fornituri tad-databases jipprovdu s-sewwieqa u l-għodod tagħhom stess għad-databases tagħhom. Databases Oracle, pereżempjuample, uża l-Oracle Data Access Components (ODAC).
• Xi SimApis, bħal PI AF u ODBC, għandhom dialogs tal-konfigurazzjoni li jaħżnu l-kredenzjali kriptati fil-konfigurazzjoni XML SimApi file.
• PI għandu wkoll diversi għażliet ta 'sigurtà disponibbli fl-Għodod ta' Ġestjoni tas-Sistema PI fuq il-kompjuter server PI. Aqra aktar fil-Gwida għall-Utent PI AF SimApi. Din il-gwida hija utli anki jekk tuża l-OSIsoft PI SimApi antik.
• OPC DA u HDA jużaw DCOM bħala t-trasport bejn sors tad-dejta u SimApi. DCOM huwa kkonfigurat bl-għodda tas-Servizzi tal-Komponenti (DCOMCNFG.EXE) fil-Windows u juża l-awtentikazzjoni tal-Windows.
• Għall-OSIsoft PI SimApi eqdem (mhux l-aktar ġdid AF SimApi), l-applikazzjoni OSIsoft AboutPI-SDK (PISDKUtility.exe) tintuża biex titwaqqaf il-konnessjoni mas-server PI.

Verifika tal-konnettività tas-sors tad-dejta
Meta trid tinstalla SimApi fuq kompjuter, jista 'jkun utli li tivverifika l-konnettività minn dak il-kompjuter għas-sors tad-dejta b'għodda oħra:

• Sorsi tad-Data ODBC fil-Windows jintuża biex jiġi kkonfigurat u ttestjat ODBC ġeneriku. Innota li hemm żewġ verżjonijiet ta 'din l-għodda fuq Windows 64-bit: waħda għal applikazzjonijiet 32-bit u waħda għal 64-bit. Uża l-buttuna Sors tad-Data tat-Test fl-aħħar tal-wizard tal-konfigurazzjoni ODBC biex tivverifika l-konnettività mad-database. Nirrakkomandaw li tikkonfigura s-sorsi tad-dejta tiegħek bħala System DSNs.
• Għodda ta' konnessjoni speċifika għal database mill-fornitur tad-database, bħall-Oracle Data Access Components.
• PI System Explorer jista' jintuża biex tittestja l-konnettività mas-server PI AF. Huwa parti mill-PI AF Client li huwa prerekwiżit għall-PI AF SimApi.
• Espert OPC UA minn Unified Automation - UaExpert huwa klijent tat-test ta 'cross-platform għal servers OPC UA.
• L-applikazzjoni PI-SDK (PISDKUtility.exe) tista' tintuża biex tittestja l-konnettività u biex view kwalunkwe messaġġ ta' żball li setgħu ġew illoggjati meta SIMCA-online tipprova tikkonnettja mas-server PI. Dan jintuża biss għall-OSIsoft SimApi anzjani, mhux PIAF.
• L-Għodod ta' Ġestjoni tas-Sistema PI jintużaw fuq il-kompjuter tas-server PI biex issolvi l-problemi minn dik in-naħa. Per example, biex tfittex kwistjonijiet ta 'sigurtà li jipprevjenu aċċess mis-server SIMCA-online. Tgħallem aktar dwar is-soluzzjoni tal-problemi tas-sistema PI f'dan il-video ta' YouTube.
• Excel jista 'jintuża biex tinkiseb data minn konnessjoni ODBC u ħafna sistemi oħra meta plugin adattat ikun installat.
• Matrikon OPC Explorer għal Ior HDA (dawn huma għodod separati) jistgħu jintużaw biex jittestjaw il-konnettività OPC, u Matrikon OPC Analyzer jista 'jintuża biex jiddijanjostika l-kwistjonijiet ta' konnettività OPC. Niżżel dawn l-għodda b'xejn minn https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (għal DInd HDA) mill-OPC Training Institute's web is-sit “jippermetti lill-utenti jiddijanjostikaw faċilment il-problemi ta’ komunikazzjoni u sigurtà, u jsewwuhom istantanjament billi tagħfas buttuna. Dan kollu jista 'jsir mingħajr qatt ma jkollok bżonn titgħallem tikkonfigura DCOM "

Installazzjoni ta' SimApi

Hawn hu kif tinstalla SimApi fuq PC:

1. Aqra l-Gwida għall-Utent għas-SimApi li qed tinstalla. Fih ispeċifiċitajiet għal dak SimApi li jikkumplimentaw l-istruzzjonijiet ġenerali li qed taqra issa.
2. Installa u kkonfigurat kwalunkwe prerekwiżit imsemmi fil-Gwida għall-Utent SimApi (eżampsewwieqa tad-database le jew SDKs)
3. Mexxi l-programm tas-setup biex tinstalla s-SimApi. Installa l-verżjoni 64-bit (x64) jew 32-bit (x86) li taqbel mas-software li se tħaddem fih.
4. Ikkonfigura s-SimApi f'SIMCA-online jew SIMCA kif deskritt fit-taqsimiet li ġejjin u irreferi għall-gwida għall-utent tas-SimApi għal deskrizzjonijiet tas-settings disponibbli.
5. Ibda s-server SIMCA-online. Innota li dan jista 'jieħu ż-żmien, għaliex meta s-SimApi jiġi inizjalizzat, se jelenka kollox tags fis-sors tad-dejta.
6. Ittestja s-SimApi billi tikseb xi dejta. Għal SIMCA-online, tista 'tuża File > Estratt kif deskritt f'6.1.
7. Jekk is-SimApi jonqos milli jaħdem kif mistenni, irreferi għar-reġistru SimApi files għas-soluzzjoni tal-problemi, u għall-gwida għall-utent SimApi.

Twaqqif tas-SimApi għall-użu fis-SIMCA

Hawn kif tuża s-SimApi f'SIMCA:

1.  Ibda l-importazzjoni tad-database b'wieħed mill-modi li ġejjin:
   • a. Biex toħloq proġett ġdid fis-SIMCA: File > Proġett Regolari Ġdid jew Proġett Ġdid tal-Lott. Agħżel Minn database fuq it-tab Home.
   • b. Biex timporta sett ta' dejta fi proġett eżistenti f'SIMCA: Minn sett ta' dejta fuq it-tab tad-Data ta' proġett SIMCA miftuħ.
2. Ikklikkja Żid sors ta' dejta ġdid
3. Agħżel SimApi bħala t-tip ta' konnessjoni, ikklikkja l-buttuna ... u sib il- .dll fil-folder tal-installazzjoni, u kklikkja Iftaħ.
4. Ikklikkja Ikkonfigura u irreferi għall-Gwida għall-Utent SimApi individwali kif tagħmel is-settings.
5. Ikklikkja l-konnessjoni tas-sors tad-dejta tat-Test biex tivverifika li tista’ tikkonnettja mad-database. Dan jista 'jieħu żmien twil jekk ikun hemm ħafna tags fis-sors tad-dejta.
6. Ikklikkja OK biex tlesti l-konfigurazzjoni.
7. Irreferi għall-għajnuna SIMCA għal kif taħdem b'dejta importata.

Twaqqif tas-SimApi għall-użu fis-SIMCA-online

• Importanti: Biex tkun tista' tuża SimApi, hija meħtieġa liċenzja ta' server SIMCA-online. Installazzjoni demo ta' SIMCA-online ma tippermettix li jintuża SimApis.
• Biex iżżid SimApi mas-sistema, inti tħaddem l-Għażliet tas-Server SIMCA-online fuq il-PC tas-server. Tgħallem il-passi tad-dettalji fis-suġġett tal-għajnuna SICMA-online Żid u kkonfigura SimApi fuq is-server.
• Tip: Jekk tagħmel bidliet għal SimApi, tista' terġa' tibda dik SimApi separatament minn Server Options mingħajr ma terġa' tibda s-server kollu.
• Biex tikkonfigura każijiet multipli ta 'dan SimApi, irrepeti l-passi ta' hawn fuq u uża ismijiet uniċi għal kull istanza. Aqra aktar dwar il-log u l-konfigurazzjoni differenti files għall-każijiet f'4.2.

Ittestjar u soluzzjoni tal-problemi ta' SimApi

• Dan il-kapitolu huwa dwar l-ittestjar u s-soluzzjoni tal-problemi ta' installazzjoni ta' SimApi.

Ittestjar ta' SimApi minn SIMCA-online

• Ladarba s-server SIMCA-online ikun inbeda b'suċċess tista' tittestja s-SimApi tiegħek f'SIMCA-online (jekk is-server ma jibdax, ara 6.2):
• Idħol fis-server fil-klijent SIMCA-online, u naviga għal Extract fuq il- File tab. Estratt jgħinek tittestja s-SimApi billi tikseb dejta permezz tiegħu:
• In-nodi ("folders") tas-SimApi jintwerew fil-kaxxa tax-xellug. Tags għan-nodu magħżul jintwerew fuq il-lemin.
• Id-dejta kurrenti tista' tiġi ttestjata malajr sempliċement billi tikklikkja view> fuq tags li jipprovdu dejta tal-proċess kontinwu (ara l-screenshot)
• Ikklikkja bil-lemin fuq nodu biex Sib lottijiet f'medda ta' żmien. In-nodu għandu jkun node tal-lott li jkun jaf dwar il-lottijiet.
• Agħżel tags f'Estratt u kklikkja Li jmiss u spiċċa l-wizard biex tikseb data billi tuża l-modi differenti ta 'rkupru tad-data: data kurrenti, storika, lott u diskreta.
• Qabbel id-dejta estratta ma 'dak li tara fis-sors tad-dejta tiegħek billi tuża l-għodod tagħha. Tgħallem aktar dwar l-ittestjar u l-validazzjoni tal-karatteristiċi kollha ta' SimApi f'7.13.

Issolvi problemi SimApi billi tuża l-log SimApi file

• Jekk is-server ma jibdax, is-SimApi ma jaħdimx kif mistenni jew l-estratt jonqos, għandek bżonn tikkonsulta l-log SimApi file li jgħidlek x'inhi l-problema. Ippermetti l-illoggjar fil-livell ta' Debug fil-log SimApi biex tikseb id-dettalji kollha. Ara 4.2.
• Nota: il-logs tas-server SIMCA-online mhumiex daqshekk utli hawn. Huma se juru kif is-SimApi kien mgħobbi u inizjalizzat mis-server, iżda d-dettalji speċifiċi ta 'SimApi huma fil-log tiegħu file.

Uża l-kont tas-servizz SIMCA-online it-tajjeb

• Meta tkun qed tittestja l-aċċess għas-sors tad-dejta, ftakar li int illoggjat bħala utent speċifiku fuq il-kompjuter server (tipikament il-kont tal-utent tiegħek stess f'dominju tal-Windows), iżda li l-kont tas-servizz tas-server SIMCA-online huwa kont differenti, b'mod awtomatiku LocalSystem, li għandu drittijiet ta' aċċess differenti meta mqabbel mal-kont tal-utent tiegħek.
• Għal din ir-raġuni, mhux rari li t-testijiet jaħdmu meta jitmexxew bħala l-kont tiegħek, iżda li SIMCA-online tonqos milli tikkonnettja mas-sors tad-dejta.
• Biex issolvi din il-kwistjoni, irid jingħata aċċess għall-kont użat mis-servizz tas-server SIMCA-online. Tipikament, tibdel LocalSystem għal kont ta' servizz ta' dominju speċifiku, u tagħti drittijiet għal dan il-kont. Innota li dan ma japplikax jekk is-SimApi juża kredenzjali li huma stabbiliti fil-konfigurazzjoni SimApi minħabba li dawn il-kredenzjali jieħdu preċedenza.

Dettalji tekniċi fuq SimApis

• Dan il-kapitolu jagħti dettalji tekniċi dwar kif jaħdem SimApi. Hija mmirata prinċipalment għal żviluppaturi li jridu jifhmu SimApis biex jimplimentaw SimApi għal sors ta 'dejta.
• L-iżviluppaturi għandhom jaqraw ukoll il-partijiet preċedenti ta 'dan id-dokument għal introduzzjoni għal SimApis u għad-deskrizzjonijiet ta' livell għoli tal-karatteristiċi.

Meta tikkunsidra l-iżvilupp ta' SimApi u meta le?

Qabel ma tikkunsidra l-iżvilupp ta' SimApi għal sors ta' dejta:

1. Investiga jekk diġà hemmx SimApi li tista' tuża. Forsi tista 'tippermetti xi karatteristika fis-sors tad-dejta tiegħek biex tuża waħda mis-SimApis eżistenti, bħal OPC UA.
2. Għaddi bir-reqqa dan id-dokument u r-referenzi tiegħu u investiga jekk is-sors tad-dejta tiegħek jissodisfax ir-rekwiżiti: pereżempjuample, jeħtieġ li jkun mgħaġġel biżżejjed, jipprovdi mhux biss data kurrenti, iżda wkoll data storika.

• Għal dawn ir-raġunijiet, aħna ma nirrakkomandawx li tiżviluppa SimApi li jgħaqqad ma 'ħardwer jew strumenti ta' livell baxx. Huwa aħjar li tikkonnettja dawk l-istrumenti ma 'storiku tal-proċess bħal Aveva PI System, u ħalliha tikseb data mill-istrument, u storizzaha. Imbagħad il-PIAF SimApi jista 'jintuża biex tinkiseb data minn PI għall-prodott Umetrics.

Żvilupp SimApi u l-ispeċifikazzjoni SimApi

• L-ispeċifikazzjoni SimApi, SimApi-v2, fiha dokumentazzjoni għall-funzjonijiet C kollha fis-SimApi li SimApi DLL jeħtieġ li timplimenta kif ukoll xi gwida dwar kif tiżviluppa SimApi.
• L-implimentazzjoni ta' SimApi bl-użu ta' C jew C++ f'ħafna każijiet hija f'livell baxx bla bżonn.
• Il-mod rakkomandat, u aktar faċli, biex timplimenta SimApi huwa li tibbażaha fuq l-Exampkodiċi sors leSimApi li nipprovdu. Huwa example SimApi implimentazzjoni li tieħu ħsieb is-C-interface u tittraduċiha fi.NET Framework fejn issir l-implimentazzjoni attwali. Għandu wkoll kodiċi qafas għall-illoggjar, settings, GUI tal-konfigurazzjoni, u kodiċi qafas ieħor.
• Biex tiżviluppa SimApi, it-tim tal-iżviluppaturi jeħtieġ esperjenza fl-iżvilupp tal-Windows, .NET Framework, C, jew C++. Huwa meħtieġ ukoll għarfien tajjeb tas-sors tad-dejta li s-SimApi għandu jgħaqqad miegħu, minħabba li l-għan ta 'SimApi huwa li jittraduċi talbiet tad-dejta minn SIMCA-online jew SIMCA għall-API tas-sors tad-dejta. Implimentazzjoni SimApi qatt mhi proġett ta' darba, iżda tipikament teħtieġ appoġġ kontinwu u manutenzjoni okkażjonali.

Qari jew kitba tad-data

• SimApi għandu l-kompitu ewlieni li jipprovdi data minn sors tad-data. Dan jissejjaħ il-qari tad-dejta.
• Ħafna mill-implimentazzjonijiet SimApi jappoġġjaw ukoll il-kitba tad-dejta. Dan ifisser li tikteb lura d-dejta permezz tas-SimApi lis-sors tad-dejta. Il-kitba tad-dejta hija karatteristika fakultattiva fis-SIMCA-online.

Tags u Nodes

• A tag huwa identifikatur ta' kolonna jew "varjabbli" f'sors tad-dejta. A tagisem 's huwa użat biex jidentifika l- tag. L-ismijiet fi ħdan in-nodu għandhom ikunu uniċi. SIMCA-online 18 hija l-ewwel verżjoni li tappoġġja node li fih sub node u tag bl-istess isem. Per example: in-node Parent jista' jkollu sub node imsejjaħ Lott u a tag imsejjaħ Lott.
• A node huwa kontenitur ta ' tags. Node jista' jkun fih ukoll nodi oħra, b'mod simili għal kif a file sistema għandha folders fil-folders.
• Bħal fi a file sistema, in-nodu u tag l-ismijiet jistgħu jingħaqdu ma' mogħdija sħiħa li tidentifika unikament a tag. Il- tag mogħdijiet huma użati fil SIMCA-online jew SIMCA meta tagħżel tags għall-użu. A tag mogħdija tibda b'isem istanza SimApi segwit mill-istruttura node, u jispiċċa bil- tag isem, kull oġġett separat b'kolon (:). Per example “:ODBCSQLServer:Node:SensorTag1”.

Is-SimApi jelenka tags u nodi fl-istartjar

• Implimentazzjoni SimApi tfittex is-server għal nodi u tags fis-sors tad-dejta meta s-SimApi jiġi inizjalizzat u jżomm kont tagħhom sabiex il-funzjonijiet varji SimApi li jintużaw għall-enumerazzjoni tags u node jistgħu jiġu implimentati.
• L-inizjalizzazzjoni ta' SimApi ma sseħħx biss fl-istartjar tas-server iżda tista' terġa' tiġi attivata wkoll minn utent f'SIMCA-online bil-funzjonalità Refresh SimApi.

Is-sensittività tal-każ ta' tag- u l-ismijiet tan-nodi

• Tag l-ismijiet u l-ismijiet tan-nodi huma sensittivi għall-każ.
• Għalhekk, a tag imsejħa "tag1” mhix l-istess bħal “Tag1” minħabba l-każ differenti tat-“T”. Nirrakkomandaw kontra l-użu tags jew ismijiet ta' nodi li jvarjaw biss fil-każ.

Nodu tal-proċess kontinwu 

• Meta node fih tags b'dejta tal-proċess kontinwu, jista 'jissejjaħ node tal-proċess. Iż-żewġ screenshots li ġejjin juru rappreżentazzjoni tabulari ta’ nodu ta’ proċess b’dejta segwita minn stampa li turi kif jidher in-nodu meta tagħżel tags f'SIMCA-online.

In-nodi tal-proċess kontinwu għandhom ikunu indipendenti minn lottijiet, ġirjiet jew ħin

• Biex jaħdem tajjeb f'SimApi node għandu jkun indipendenti minn lottijiet, ġirjiet, jew ħin. Li jkollok node li jkun fih dejta għal lott speċifiku jew medda ta 'żmien ma taħdimx tajjeb f'SIMCA-online minħabba li l-konfigurazzjoni tal-proġett allura tista' taqra biss dejta għal dak il-lott u ma tintużax għal lottijiet oħra.
• Minflok, nodu għandu jiġi mmappjat għal unità fiżika waħda jew aktar fil-proċess fejn jitwettaq il-kejl.

ID tal-lott tag meħtieġa f'nodi ta 'proċess kontinwu għall-eżekuzzjoni tal-proġett tal-lott

• Kull proċess kontinwu għandu jkollu a tag (varjabbli) iżżomm l-identifikatur tal-lott għal kull osservazzjoni. Dan l-identifikatur tal-lott jintuża minn SIMCA jew SIMCA-online biex tkun taf għal liema lott jappartjeni kull osservazzjoni.
• Il-$BatchID tag fil-screenshots f'7.4.3 huwa tali example.
  Filwaqt li mhux meħtieġ, huwa rakkomandat li jkollok a tag fin-nodu tal-proċess li juri l-fażi kurrenti jew il-pass tal-proċess. Dan tag imbagħad jista 'jintuża f'kundizzjonijiet ta' eżekuzzjoni tal-fażi f'SIMCA-online jew f'SIMCA meta tkun qed timporta data. Valuri għal dan tag jista' jkun per example “phase1”, “cleaning”, “phase2”.

Node tal-kuntest tal-lott

• Nodu tal-lott huwa node li jżomm kont tal-lottijiet; l-identifikaturi tal-lott tagħhom, il-ħinijiet tal-bidu u l-ħinijiet tat-tmiem. Huwa rekwiżit għall-eżekuzzjoni tal-proġett tal-lott f'SIMCA-online. Sors tad-dejta jista’ jkollu aktar minn nodu ta’ lott wieħed li jesponi lottijiet b’modi differenti. L-utent jagħżel in-node tal-lott li japplika għall-applikazzjoni tiegħu jew tagħha. Dan example tesponi lottijiet li jkopru żewġ unitajiet differenti:
• /Factory1 – lottijiet b'ħajjiet aggregati kemm fuq Unit1 kif ukoll Unit2.
• /Factory1/Unit1 – lottijiet b'ħajjiet fl-Unità1 biss
• /Factory1/Unit2 – lottijiet b'ħajjiet fl-Unità2 biss
• Jekk m'għandekx node tal-lott fis-sors tad-dejta tiegħek, tista' tuża l-Ġeneratur tal-Kuntest tal-lott f'SIMCA-online. Ara l-għajnuna integrata.
• Data tal-lott mhux obbligatorja
• Nodu tal-lott jista' jkun fih ukoll data tal-lott; data li għaliha hemm osservazzjoni waħda biss għall-lott kollu. Innota li tags b'data tal-lott m'hemmx għalfejn tkun f'node li għandu l-funzjonalità sħiħa ta 'node tal-lott. Huwa biżżejjed li s-SimApi jappoġġja l-qari tad-dejta tal-lott għall- tags. Tgħallem aktar dwar id-dejta tal-lott f'7.6.
• Hawn example ta' node tal-lott:
• Nota: Il-screenshot ta 'hawn fuq hija meħuda minn DBMaker, miġbura ma' SIMCA-online. Biex tara dan lilek innifsek f'DBMaker, ikklikkja l- View Buttuna tad-Data fuq id-database Bakers Yeast biex turi żewġ twieqi, li waħda minnhom hija n-nodu tal-lott, u l-oħra d-data tal-proċess.

Tipi ta' dejta: dejta numerika, dejta tat-test, u dejta nieqsa

• Għal kull wieħed tag, SimApi jista 'jappoġġja tliet tipi ta' data: numerika, tex,t u nieqsa:
• Id-dejta numerika huma tipikament valuri reali tal-parametri tal-proċess, pereżempjuample 6.5123. Is-SimApi jista' jimmaniġġja biss valuri ta' punt li jvarja b'preċiżjoni waħda ta' 32 bit. Format ta' punt li jvarja b'preċiżjoni waħda - Wikipedija. It-tipi l-oħra kollha tad-dejta numerika f'sors tad-dejta għandhom jiġu kkonvertiti f'float. Bħala tali, jistgħu jittrattaw kemm valuri kbar kif ukoll żgħar iżda b'madwar 6 jew 7 ċifri sinifikanti biss. Tgħallem aktar fil-Gwida Teknika.
• Dan jista 'jwassal għal telf ta' preċiżjoni għal interi kbar jew għal numri reali li huma t-tnejn kbar u għandhom deċimali. Għal aktar informazzjoni, ara l-Gwida Teknika.
• Id-dejta tat-test/sekwenza tintuża għall-IDs tal-lott, il-kundizzjonijiet tal-eżekuzzjoni tal-fażi jew għal varjabbli kwalitattivi. Il-valuri għat-test tag id-data hija sensittiva għall-każ. Dan ifisser li l-valur "running" mhuwiex l-istess bħal
  “ĠEJR”. Il-varjabbli Datetime mhumiex appoġġjati direttament mis-SimApi, iżda jistgħu jintbagħtu lura bħala string ifformattjat bħala SS-MM-JJ HH:MM (eż.ample “2020-09-07 13:45”).
• Valuri neqsin tfisser li m'hemm l-ebda valur x'jirritorna, jiġifieri, l-ebda data.
• Liema tip huwa rritornat huwa f'idejn l-implimentazzjoni SimApi. SimApi jaf dwar id-dejta fis-sors tad-dejta u għandu jirritorna t-tip tad-dejta li jaqbel l-aħjar.

Tliet modi ta 'rkupru tad-data: Kontinwu, Batc, h u Diskreti

• L-ispeċifikazzjoni SimApi tiddefinixxi tliet modi ta' rkupru għad-data, jiġifieri,. tliet modi differenti minn fejn is-SimApi jista’ jipprovdi data tags f'sors tad-dejta (jew fid-direzzjoni l-oħra: ikteb id-dejta lil tags f'sors tad-dejta).
• L-irkupru kontinwu tad-dejta - dan jirreferi għal dejta li tinqara kontinwament, u b'mod sekwenzjali, osservazzjoni għal kull osservazzjoni hekk kif il-lott jew il-proċess jevolvi. Id-dejta tinqara għall-ħin kurrenti, jew għal medda speċifika, f'intervall regolari bejn l-osservazzjonijiet. Per example, id-data kollha bejn 09:00:00 u 10:00:00 sampmmexxija kull 60 sekonda, li jirriżulta f'61 osservazzjoni meta l-punti tat-tmiem huma inklużivi.
• L-irkupru tad-dejta tal-lott - dan jirreferi għal osservazzjoni waħda b'dejta għal lott kollu (mhux assoċjat ma' maturità speċifika jew punt ta' żmien). L-attributi tal-lott u d-dejta tal-iċċentrazzjoni lokali jinqraw bħala dejta tal-lott f'SIMCA-online. Il-kundizzjonijiet tal-lott huma normalment jinqraw bħala data tal-lott ukoll (sakemm ma jkunux ikkonfigurati għall-irkupru tad-data diskreti).
• Irkupru ta' data diskreta - data diskreta tista' tikkonsisti f'diversi osservazzjonijiet għal ħafna maturitajiet. Iżda b'differenza għal data kontinwa, data diskreta ma tinqarax b'mod sekwenzjali iżda pjuttost id-data kollha f'daqqa għal fażi speċifika ta' lott. Id-dejta m'hemmx għalfejn tiġi spazjata b'intervalli regolari tal-varjabbli tal-maturità. Id-dejta kollha terġa' tinqara kull darba li tintalab id-dejta, fl-intervall konfigurat.
• Għal kull partikolari tag id-dejta tista’ tintalab fi kwalunkwe mit-tliet modi, iżda tipikament SimApi jappoġġa biss waħda minn dawn il-modi għal individwu tag. Bl-istess mod, huwa permess li jitħallat tags fi ħdan node, iżda tipikament kollha tags fi ħdan node speċifiku jappoġġja l-istess mod ta 'rkupru tad-data.
• Għal data kontinwa (iżda mhux għal data tal-lott jew diskreta2), jistgħu jsiru talbiet għal data kurrenti jew data storika li hija s-suġġett tat-taqsima li jmiss.
• Mhux is-SimApis kollha jappoġġjaw il-modi kollha. Ara l-matriċi tal-karatteristiċi hawn fuq u s-SimApi web paġna għad-dettalji.

Dejta kontinwa kurrenti u Storika permezz ta' SimApi

• Data kontinwa tirreferi għal data tal-proċess li tinbidel maż-żmien.

Dejta kurrenti

• Il-qari tad-dejta attwali jfisser li titlob lis-sors tad-dejta għall-aħħar valuri ta’ tags fil-ħin li tistaqsi. Innota li l-ħin tas-sors estern tad-dejta mhux użat hawn.
• Id-dejta tinqara bħala dejta kurrenti hija dik li SIMCA-online se turi bħala dejta diretta. Għal din ir-raġuni, huwa importanti li ma jkunx hemm dewmien bla bżonn fis-sors tad-dejta. Id-dejta kurrenti għandha tkun kemm jista' jkun riċenti biex taħdem tajjeb f'SIMCA-online.
• Is-sors tad-dejta jista’ juża l-għarfien tiegħu dwar id-dejta u għal kemm żmien il-valuri huma validi u jiddeċiedi li jirritorna d-dejta nieqsa meta d-dejta mhux ipproċessata għal punt ta’ żmien tkun antika wisq. Per example: id-dejta tintalab f'15:00:00 iżda l-aktar punt reċenti tad-dejta fis-sors tad-dejta huwa mit-03:00:00. F'dan il-każ id-dejta għandha 12-il siegħa u għalhekk is-SimApi jista' jiddeċiedi li jirritorna l-valur nieqes (l-ebda dejta).

Data storika

• Il-qari tad-dejta storika jfisser li titlob lis-sors tad-dejta għal valuri ta’ wieħed jew aktar tags għal medda ta’ żmien speċifika b’intervall speċifiku bejn l-osservazzjonijiet. Innota li hawnhekk huwa l-ħin lokali tas-sors tad-dejta li jintuża biex issib id-dejta. Għalhekk, is-sinkronizzazzjoni tal-ħin bejn is-sors tad-dejta u s-servers hija importanti.
• Data storika tikkonsisti minn matriċi ta 'data. Huwa f'idejn l-implimentazzjoni SimApi li titlob id-dejta mis-sors tad-dejta, u sampħalliha fl-intervall speċifikat u ibni l-matriċi tad-dejta biex tirritorna:
• Xi drabi s-sors tad-data innifsu għandu funzjonijiet ta 'aggregazzjoni biex jirritorna data pproċessata, jew sampfunzjonijiet ling, li jistgħu jintużaw biex jirritornaw id-data t-tajba.
• Għal sorsi ta' dejta oħra, is-SimApi għandu jitlob id-dejta kollha fil-medda ta' żmien u mbagħad sample l-osservazzjonijiet dritt biex tinbena l-matriċi.
• Id-dejta trid tiġi rritornata għal medda ta 'żmien, anke jekk jista' ma jkunx hemm dejta mhux maħduma fil-medda ta 'żmien, iżda biss eżatt qabel il-ħin tal-bidu. Per example: id-dejta teżisti fis-sors tad-dejta fil-punti tal-ħin 10 u 20. Is-SimApi jitlob dejta għall-ħin 15 u 17. F'dan il-każ, il-valuri għall-punt tal-ħin 10 għandhom jintbagħtu lura mis-SimApi iżda l-ħinijietamped bħala l-ħin 15 u 17 peress li dawn kienu l-aktar punti tad-dejta riċenti f'dawk iż-żminijiet. Il-valuri għal tags fil-ħin 10 jissejħu valuri tal-limiti għall-medda mitluba. Għal spjegazzjoni aktar profonda tal-valuri tal-limiti, ara għal eżample id-dokumentazzjoni għal returnBounds f'UA Parti 11: Aċċess Storiku – 6.4.3 Struttura ReadRawModifiedDetails
  (opcfoundation.org)
• L-interpolazzjoni m'għandha qatt tintuża biex tikkalkula l-valuri għal punti ta' żmien futuri, minħabba li d-dejta mhux se taqbel ma' dak li jinqara f'ħin reali bħala dejta attwali. Għall-eżample mill-bullet preċedenti: kieku d-dejta għal 15 u 17 kellha tiġi interpolata bl-użu tal-valuri għall-oġġett 10 u 20, huma effettivament jużaw valuri mill-futur, li mhux permess.
• Is-sors tad-dejta jista’ juża l-għarfien tiegħu dwar id-dejta u għal kemm żmien il-valuri huma validi u jiddeċiedi li jirritorna d-dejta nieqsa meta d-dejta mhux ipproċessata għal punt ta’ żmien tkun antika. Per example: id-dejta hija mitluba għal 15:00:00 iżda l-aktar punt reċenti tad-dejta fis-sors tad-dejta huwa mit-03:00:00. F'dan il-każ, id-dejta għandha 12-il siegħa u għalhekk is-SimApi jista' jiddeċiedi li jirritorna l-valur nieqes (l-ebda dejta).

Nota: SIMCA-online tipikament ma jitlobx aktar minn mitt osservazzjoni f'sejħa waħda waqt l-eżekuzzjoni normali tal-proġett. Meta tagħmel estratt f'SIMCA-online, jew meta tħaddem id-desktop SIMCA, jistgħu jsiru talbiet akbar ta 'dejta. Dawn jistgħu jieħdu żmien twil, li huwa mistenni.

Id-dejta kurrenti u d-dejta storika għandhom jaqblu

• Xi drabi jista' jkun hemm differenzi meta d-dejta tinqara bħala dejta kurrenti f'ħin reali jew dejta storika. Dan jikkawża problemi fis-SIMCA-online minħabba li s-server awtomatikament jaqleb bejn id-dejta attwali u storika kif meħtieġ.

Akkwist tad-dejta b'latenza baxxa

• Meta sors tad-dejta jintuża minn SIMCA-online f'ħin reali, huwa importanti li d-dejta fis-sors tad-dejta tkun kurrenti. M'għandux ikun hemm dewmien bla bżonn fl-akkwist tad-dejta fis-sors tad-dejta. Id-dejta tal-proċess kontinwu għall-varjabbli kollha għandha tkun disponibbli fl-istess ħin għal kull osservazzjoni. Data li tidħol tard għal xi varjabbli mhux se tinġabar minn SIMCA-online.

Id-dejta tista' tinqara għal kwalunkwe ħin 

• Meta SIMCA-online jitlob valur ta' a tag għall-ħin t se tirċievi l-valur mis-sors tad-dejta mill-ħin t, jew l-aħħar osservazzjoni fis-sors tad-dejta qabel il-ħin t, jew valur interpolat għall-ħin t. Għalhekk, is-server dejjem se jikseb valur kull darba li jitlob, anke jekk osservazzjoni għal dan il-punt ta 'żmien eżatt jista' ma teżistix fis-sors tad-dejta.
• Timestamps fis-SimApi huma dejjem UTC. Il-klijenti SIMCA-online u SIMCA jippreżentaw il-ħin bħala ħin lokali.

Threading 

• Is-SimApi huwa, awtomatikament, imsejjaħ b'ħajt wieħed mill-utent tas-SimApi. Dan jgħodd għall-verżjonijiet SIMCA kollha u SIMCA-online sal-verżjoni 17.
• SIMCA-online 18 jappoġġa bandiera tal-karatteristika biex tixgħel l-aċċess multi-threaded permezz ta 'SimApi. Aqra aktar fis-suġġett tal-għajnuna Aċċess SimApi Konkorrenti.
• Dan ifisser li SimApis għandu jipprepara għal multi-threading, jekk possibbli, billi jagħmel il-ħajt ta 'implimentazzjoni SimApi sigur, u jiddokumenta dan u kwalunkwe konsiderazzjoni għall-utenti tas-SimApi.

Log file

• SimApi għandu jirreġistra azzjonijiet, messaġġi ta' żball u twissijiet fil-log tiegħu file biex tgħin issolvi l-problemi. Uża l-livelli differenti tal-log biex turi l-importanza tal-qtugħ.
• Huwa rakkomandat li tilloggja "Mhux implimentat" għal karatteristiċi li ma ġewx implimentati f'SimApi.

Immaniġġjar ta' żbalji

• Meta SimApi ma jkunx jista' jwettaq talba mis-sors tad-dejta jista' jimmaniġġja din il-problema b'wieħed minn żewġ modi; billi tirritorna l-valuri neqsin (l-ebda data) jew billi tindika żball SimApi:
• Ir-ritorn tal-valuri neqsin lil min iċempel u s-suċċess tas-sinjalar jippermetti lil min iċempel ikompli b'mod normali (iżda ovvjament mingħajr ebda data). Din hija prattika rakkomandata għal żbalji parzjali bħal meta tista' tinkiseb data għal xi wħud, iżda mhux għal kulħadd, tags f’talba.
• Is-sinjalar ta' żball SimApi jippermetti lil min iċempel (eżample is-server SIMCA-online) biex tara dan immedjatament u biex taġixxi. Din hija prattika rakkomandata għal talbiet li jfallu kompletament u li ma jistgħux jirritornaw l-ebda dejta.
• SIMCA-online jimmaniġġja l-valuri neqsin jew il-kodiċi ta' żball b'mod differenti, kif deskritt fil-Gwida Teknika SIMCA-online.

Rekwiżiti tal-prestazzjoni SimApi

• Il-funzjonijiet fis-SimApi jintużaw biex tinkiseb data.
• Jekk l-aċċess għad-dejta huwa bil-mod, is-SimApi mhux se jaħdem tajjeb li dan example turi: Jekk SIMCA-online titlob dejta kull sekonda, iżda tieħu żewġ sekondi biex tikseb, is-server SIMCA-online qatt ma jkun jista 'jlaħħaq f'ħin reali iżda progressivament jaqa' aktar u aktar lura.
• Fis-subsezzjonijiet aħna ser nuru kif SIMCA u SIMCA-online juża l-funzjonijiet SimApi tal-aċċess għad-dejta u kemm sejrin jissejħu l-funzjonijiet SimApi. Dan jista' jgħin fl-istabbiliment ta' rekwiżiti ta' prestazzjoni għal implimentazzjoni ta' SimApi.

L-użu ta' SIMCA tal-funzjonijiet SimApi

• Meta desktop SIMCA jew prodotti offline oħra jużaw SimApi biex jiksbu dejta, dawn it-talbiet se jkunu għal lottijiet u proċessar ta 'dejta għal sett ta' varjabbli f'ċertu medda ta 'żmien.
• Peress li dawn it-talbiet jinbdew manwalment minn utent, ma jseħħux ta' spiss u ma jikkawżawx tagħbija sinifikanti lil sors tad-dejta.
• Dawn il-funzjonijiet SimApi jintużaw biex tinkiseb id-dejta:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

L-użu ta' SIMCA-online tal-funzjonijiet SimApi

• SIMCA-online jintuża għall-monitoraġġ f'ħin reali ta 'proċess, u għalhekk jitlob dejta permezz tas-SimApi f'intervalli regolari. L-iqsar intervall ta 'eżekuzzjoni li jista' jintuża huwa 1 sekonda. Xi ex tad-dinja realiampl-intervalli ta' eżekuzzjoni huma 10 s, 1 minuta, jew 10 minuti.
• Server jista' jkollu ħafna proġetti li jaħdmu fl-istess ħin.
• Biex jitnaqqas in-numru ta' sejħiet API permezz tas-SimApi, is-server jottimizza t-talbiet tad-dejta billi jiġbor bosta talbiet iżgħar konkorrenti f'talba akbar waħda għall-varjabbli kollha fl-istess ħin (tgħallem aktar fis-suġġett ta' għajnuna 'Qari ottimizzat minn sorsi ta' dejta jtejjeb il-prestazzjoni').
• L-algoritmu ta' eżekuzzjoni tas-server jaħdem bħal dan meta jitlob dejta billi juża l-funzjonijiet SimApi elenkati hawn taħt:
• Il-fażijiet kollha li jwettqu fl-istess intervall huma miġbura f'sejħa SimApi waħda biex jitnaqqas in-numru ta 'sejħiet. Is-server jaqra l-aħħar dejta għall-varjabbli kollha użati mill-mudelli kollha li jaqsmu l-intervall, jiġifieri, din is-sejħa se tirriżulta f'ringiela ta 'dejta wiesgħa li mbagħad tintuża mill-proġetti kollha.
  • simapi2_connectionReadCurrentData
• Għal kull proġett ta 'lott is-server jeħtieġ ukoll li jkun jaf liema lottijiet huma attivi. Dan jeħtieġ li jiġri wkoll kull darba li proġett iwettaq:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes jissejjaħ inqas spiss.
• Barra minn hekk, SIMCA-online teħtieġ ukoll data storika. Dawn it-talbiet iseħħu biss meta jkun meħtieġ, bħal jaqbdu l-bidu ta’ lott li beda qabel ma nbeda SIMCA-online, jew meta s-server ikun qed jaqa’ lura u jeħtieġ jaqra blokka ta’ dejta:
  • simapi2_connectionReadHistoricalDataEx
• B'għażla, xi konfigurazzjoni tal-proġett tuża karatteristiċi li jużaw data tal-lott jew data diskreta li tirriżulta f'sejħiet SimApi lil:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• B'għażla, xi konfigurazzjoni tal-proġett tuża l-kitba lura biex timbotta d-dejta lura lejn is-sors tad-dejta:
  • simapi2_connectionWriteHistoricalDataEx (u funzjonijiet korrispondenti għal data tal-lott, data diskreta)
• Huwa importanti li kull sejħa għall-funzjonijiet ewlenin għall-ksib tad-data, readCurrentData, getActiveBatches/getBatchTimes, tkun veloċi u li mhix komputazzjoni diffiċli għas-sors tad-data innifsu, meta wieħed iqis kemm-il darba SIMCA-online jista’ jsejjaħ dawk il-funzjonijiet.

Ittestjar u validazzjoni tad-dejta SimApi

• Din it-taqsima hija dwar l-ittestjar ta' SimApi biex tivverifika li d-dejta rritornata minnu taqbel mad-dejta fis-sors tad-dejta innifsu. It-twettiq ta 'testijiet bħal dan huwa importanti wara li tinħoloq jew tibdel l-implimentazzjoni ta' SimApi, jew meta l-API ta 'sors tad-dejta tinbidel.
• Fil-prattika, il-validazzjoni tad-dejta ssir bl-użu ta’ SIMCA-online u l-funzjonalità tal-Estratt tagħha biex tiġbed id-dejta mis-sors tad-dejta permezz tas-SimApi u mbagħad titqabbel mad-dejta mhux ipproċessata fis-sors tad-dejta. Desktop SIMCA ma jistax jintuża biex jittestja l-aspetti f'ħin reali ta 'SimApi.

Preparazzjonijiet u rekwiżiti

• Xi oġġetti huma fakultattivi iżda jistgħu jitwettqu jekk l-ambitu tal-ittestjar tiegħek jinkludih:

1. Installa SIMCA-online kif deskritt fil ReadMe and Installation Guide.pdf li jiġi fl-zip tal-prodott.
2. Ikseb liċenzja għas-server SIMCA-online u installaha. Is-SimApi mhux se jaħdem mingħajr liċenzja. L-artikolu tal-bażi tal-għarfien għal SIMCA-online juri kif liċenzjar il-prodott. Per example: SIMCA-online 18 (sartorius.com)
3. Installa u kkonfigurat is-SimApi li trid tittestja. Irreferi għall-kapitoli 4 – 5 f'dan id-dokument u l-gwida għall-utent tas-SimApi speċifiku.
   • a. Fakultattiv: kun żgur li l-gwida għall-utent hija aġġornata u korretta.
4. Kun żgur li għandek għodda għas-sors tad-dejta tiegħek li tista' tuża biex tqabbel id-dejta SimApi magħha.
5. Fil-klijent tad-desktop SIMCA-online, idħol fis-server SIMCA-online tiegħek u uża File > Estratt biex tinkiseb data permezz tas-SimApi.
6. Mhux obbligatorju jekk l-ambitu tal-ittestjar tiegħek jinkludiha: wara li tispiċċa l-ittestjar, iddiżinstalla s-SimApi u vverifikah files jitneħħew.

X'għandek tittestja

• Il-matriċi tal-karatteristiċi f'kapitolu 3 telenka l-karatteristiċi kollha possibbli, iżda implimentazzjoni partikolari ta' SimApi tista' tappoġġja biss subsett. Għandek tittestja l-karatteristiċi kollha li huma implimentati mis-SimApi mogħti.
• It-testijiet li ġejjin huma komuni għall-biċċa l-kbira tal-implimentazzjonijiet SimApi:
• Awtentikazzjoni bl-ismijiet tal-utent u l-passwords
• Ittestja d-diversi settings fil-konfigurazzjoni tas-SimApi
• Ġerarkija tan-nodi: In-nodi u tags esposti mis-SimApi huma korretti.
  • Għandu jkun hemm a tag esposti għall-“varjabbli” kollha li għandhom ikunu disponibbli permezz tas-SimApi. Eżamples: kejl tal-proċess, valuri kkalkulati, kostanti.
• Reżiljenza tal-konnessjoni: jekk is-sors tad-dejta ma jkunx disponibbli dan jirriżulta fi twissijiet jew żbalji fil-log file, iżda li l-konnessjoni mas-sors tad-dejta tiġi stabbilita mill-ġdid awtomatikament meta s-sors tad-dejta jkun disponibbli.
• Każijiet multipli: li żewġ istanzi jistgħu jiġu kkonfigurati u użati b'mod indipendenti u simultanju, bi zkuk separati files.
• Dejta kurrenti: estratt id-dejta kurrenti għal tags. Kun żgur li d-dejta hija l-aħħar valuri magħrufa mis-sors tad-dejta, jew nieqsa għal kwalità ħażina jew meta d-dejta tkun antika wisq.
  • Oħroġ id-dejta kull 10 sekondi (jew hekk) għal minuta.
• Dejta storika kontinwa: estratt dejta storika għal tags.
  • Uża l-medda ta 'żmien li taqbel meta estratt id-dejta kurrenti. Ivverifika li d-dejta attwali taqbel mad-dejta storika, u d-dejta mhux ipproċessata fis-sors tad-dejta.
  • Ipprova meded ta 'żmien differenti u sampling intervalli, ivverifika d-data taqbel mas-sors tad-data.
  • Ipprova estratt data kull 1 s, li hija l-iqsar s possibbliampling intervall.
  • Ipprova tipi varji ta ' tags fis-sors tad-dejta (varjabbli tal-proċess, eċċ.), li tiżgura li d-dejta taqbel.
  • Nota: SIMCA-online jista' jaqsam talba waħda kbira ta' dejta storika f'diversi biċċiet iżgħar. Dan se jkun viżibbli fil-log SimApi.
• Ivverifika li s-SimApi jaħdem b'dejta tat-test, dejta numerika, u dejta nieqsa.
• log SimApi file. Ivverifika li r-reġistru fih entrati raġonevoli.
• Nodu tal-lott: ikklikkja bil-lemin fuq nodu u agħmel Sib lottijiet.
  • Ivverifika l-ismijiet tal-lott, il-ħinijiet tal-bidu, il-ħinijiet tat-tmiem għall-lottijiet.
  • Ipprova lott attiv li qed jaħdem fis-sors tad-dejta. M'għandux ikollu ħin tat-tmiem permezz tas-SimApi.
• Identifikatur tal-lott tan-node tal-proċess tag. Jekk is-SimApi għandu funzjonalità tan-node tal-lott (ara l-bullet preċedenti), għandu jkollu wkoll identifikatur tal-lott tag fin-nodu tad-data tal-proċess ta' tqabbil. Data għal dan tag għandu jkun l-identifikatur tal-lott (isem tal-lott). Din id-dejta hija meħtieġa għall-proġetti tal-lott biex jidentifikaw għal liema lott tappartjeni ringiela ta' dejta.

Skont jekk is-SimApi jappoġġjahx, tista' wkoll tkun trid tittestja:

• Data tal-lott bl-użu File > Estratt.
• Data diskreta bl-użu File > Estratt. Nota: biex tittestja data diskreta bi File > Oħroġ in-node, in-nodu tal-lott u n-nodu tad-dejta diskreti għandhom ikunu fl-istess SimApi (meta SIMCA-online tesegwixxi proġetti, jistgħu jkunu minn SimApis differenti).
• Ikteb lura – timbotta l-lott tad-dejta lejn is-sors tad-dejta. Biex tittestja dan, trid tikkonfigura konfigurazzjoni tal-proġett f'SIMCA-online biex tikteb lura l-vettori tad-dejta lis-sors tad-dejta. Imbagħad tesegwixxi l-proġett f'SIMCA-online u ċċekkja d-dejta li tinkiteb lura fis-sors tad-dejta.
• Id-dejta kontinwa hija kkonfigurata fuq il-paġna Evolution Write Back fil-konfigurazzjoni tal-proġett.
• Id-dejta diskreta hija kkonfigurata fuq l-istess paġna, iżda biss għal fażi kkonfigurata għall-irkupru tad-dejta diskreta.
• Dejta tal-lott mill-lott Ikteb lura

AKTAR INFORMAZZJONI

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå L-Isvezja
• Telefon: +46 90-18 48 00
• www.sartorius.com
• L-informazzjoni u ċ-ċifri li jinsabu f'dawn l-istruzzjonijiet jikkorrispondu mad-data tal-verżjoni speċifikata hawn taħt.
• Sartorius jirriserva d-dritt li jagħmel bidliet fit-teknoloġija, il-karatteristiċi, l-ispeċifikazzjonijiet u d-disinn tat-tagħmir mingħajr avviż. Forom maskili jew femminili huma wżati biex jiffaċilitaw il-leġibilità f'dawn l-istruzzjonijiet u dejjem fl-istess ħin jindikaw is-sess kollha.
  Avviż dwar id-drittijiet tal-awtur:
• Dawn l-istruzzjonijiet, inklużi l-komponenti kollha, huma protetti bid-drittijiet tal-awtur.
• Kwalunkwe użu lil hinn mil-limiti tal-liġi tad-drittijiet tal-awtur mhuwiex permess mingħajr l-approvazzjoni tagħna.
• Dan japplika b'mod partikolari għall-istampar mill-ġdid, it-traduzzjoni u l-editjar irrispettivament mit-tip ta' midja użata.

FAQ

• Q: X'inhu l-iskop ta 'SimApis?
  • A: L-għan ewlieni ta 'SimApis huwa li jipprovdi dejta lill-prodotti Umetrics Suite għall-ħolqien ta' proġett u l-bini ta 'mudelli.
• Q: Kif nista' nsolvi l-problemi b'installazzjoni SimApi?
  • A: Tista' ssolvi l-problemi billi tittestja minn SIMCA-online, tivverifika l-log SimApi file, u tiżgura l-konfigurazzjoni korretta tal-kont tas-servizz.

Dokumenti / Riżorsi

SARTORIUS Sim Api Software [pdfGwida għall-Utent Sim Api Software, Api Software, Software

Referenzi

• Manwal għall-Utent