SARTORIUS Sim Api softwarearen erabiltzailearen gida

SARTORIUS Sim Api softwarea

Zehaztapenak

• Produktuaren izena: SimApi Gida
• Argitaratze data: 5ko irailaren 2024a
• Helburua: Umetrics Suite produktuei datuak ematea

Produktuak erabiltzeko jarraibideak

SimApis-en aurkezpena

• SimApis Umetrics Suite produktuetan proiektuak sortzeko eta ereduak eraikitzeko datuak berreskuratzeko erabiltzen dira.

SimApis lortzea

• SimApis lortzeko, jo dokumentazio ofiziala edo jarri harremanetan bezeroarentzako laguntza eskatzeko.

SimApi Ezaugarriak

• SimApis-ek denbora errealeko datuak eskaintzen ditu jarraipena, kontrola eta ereduak eraikitzeko SIMCA eta SIMCA-online-n.

Uneko datuen erabilera soilik

• Uneko datuak soilik erabiltzea eta datu historikoak saihestea gomendatzen da errendimendu optimorako.

SimApi instalazio bat prestatzen

• Instalatu aurretik, ziurtatu zure sistemak erabiltzailearen gidan zehaztutako gutxieneko baldintzak betetzen dituela.

SimApi bat instalatzea

• Jarraitu erabiltzailearen eskuliburuan emandako pausoz pauso argibideak SimApi zure sisteman instalatzeko.

SimApi SIMCArako konfiguratzea

• Konfiguratu SimApi ezarpenak SIMCAn emandako jarraibideen arabera.

SimApi konfiguratzea SIMCA-onlinerako

• Konfiguratu SimApi datuak denbora errealean berreskuratzeko eta idazteko eragiketak SIMCA-online-n.

Probak eta Arazoak Konpontzea

• Instalatu ondoren, egin probak funtzionaltasun egokia ziurtatzeko. Arazoak izanez gero, jo erabiltzailearen gidaliburuko arazoak konpontzeko atala.

SIMCA-online-tik probak

• Probatu SimApi integrazioa SIMCA-onlinetik datuak berreskuratzea egiaztatzeko.

Log-ekin arazoak konpontzea Files

• Erabili SimApi erregistroa file instalazio edo funtzionamendu-arazoak identifikatu eta konpontzeko.

Zerbitzu-kontuaren konfigurazioa

• Ziurtatu SIMCA-online zerbitzuaren kontuaren konfigurazio zuzena ondo funtzionatzeko.

Xehetasun Teknikoak

• Ikus erabiltzailearen gidaren 7. atalean SimApis-i buruzko informazio tekniko sakona lortzeko.

SimApis-en aurkezpena

• SimApi Umetrics® Suite softwarearen eta datu-iturri baten arteko software-interfazea da. SimApi baten helburu nagusia SIMCA®-online edo SIMCA®-ri datuak ematea da.
• Sartorius Stedim Data Analytics AB-k SimApis garatzen du datu-iturri askotarako, hala nola prozesuen historialarientzat eta helburu orokorreko datu-baseetarako.
• Dokumentu honek SimApi bat zer den eta Umetrics Suite produktuetan nola erabiltzen den erakusten du. SimApi bat nola planifikatu eta instalatu, arazoak nola konpondu eta zure instalazioa nola probatu ikasiko duzu. Azken kapituluak garatzaileei zuzendutako SimApis-en xehetasun teknikoak ditu.

SimApiren helburua: Umetrics Suite produktuei datuak ematea

• SimApi baten helburu nagusia SIMCA-online edo SIMCAri datu-iturri batetik datuak ematea da. Datu-iturria ez da SIMCA-online-ren parte, baina prozesuen historialari edo datuak gorde eta kudeatzen dituen beste sistema bat izan daiteke.
• SimApi batek nodoen hierarkia bat erakusten du, karpetei dagozkienak file sistema. Nodo bakoitzak beste nodo batzuk izan ditzake, edo tags. A tag aldagai bati dagokio. Hauentzat tags, datuak lor daitezke. Irudian a ageri da tag, Tenperatura, nodoan hautatua
• BakersYeastControlGood SIMCA-online-ko datu-iturri batean. Datu-iturburutik hartutako azken balioak ere erakusten ditu.

SimApi erabilera Umetrics Suite-n

• SIMCA mahaigaineko softwareak SimApi bat erabil dezake proiektuak sortzeko eta ereduak eraikitzeko datuak berreskuratzeko, hurrengo irudiak erakusten duen bezala.
• SIMCA-online-k SimApis erabiltzen du denbora errealean datuak monitorizatzeko eta kontrolatzeko, baita datu-iturburuan datuak idazteko ere. Hurrengo irudiak SimApi non dagoen erakusten du datu-iturburu batek, SIMCA-online zerbitzariak eta bezeroek osatutako sistema batean.

Gehien erabiltzen den SimApis

• SimApis erabilienak hauek dira:
• PI AF SimApi Aveva (lehen OSIsoft) PI Systems-era konektatzeko.
• OPC UA SimApi
• ODBC SimApi - SQL Server edo Oracle bezalako datu-baseetarako sarbide orokorra lortzeko
• Eskuragarri dauden SimApis guztiak 3. paragrafoan beren ezaugarriekin batera zerrendatzen dira.

DBMaker SimApi simulazio-datuetarako

• DBMaker SIMCA-online zerbitzariaren instalazioarekin hornitutako aplikazioa da. Datu-iturri bat simulatzen du, prozesuen historialari bat adibidez, aurrez kargatutako datu-taula bat erabiliz, non behaketak banan-banan ematen zaizkion SIMCA-online DBMaker SimApi-ren bidez.
• DBMaker erakustaldietarako soilik erabiltzen da eta ezin da produkzioan erabili datu-iturri bateko zuzeneko datuekin. Ikus integratutako laguntza DBMaker-i buruz gehiago jakiteko.

Dokumentazio osagarria

• Dokumentu hau erlazionatutako dokumentu-multzo batekoa da, bakoitza ikuspegi eta xede-publiko ezberdin batekin:

Iturria	Zer	Non
SIMCA-online web orrialdea	Sarrerako informazioa eta deskargak	sartorius.com/umetrics-simca- sarean

SIMCA-online ReadMe eta Instalazioa.pdf	Instalazioa eta SIMCA- online demo datuekin nola hasi	Instalazio zip-ean file
SIMCA-online Ezarpen Gida	SIMCA-online funtzionaltasuna deskribatzen du, beste Umetrics Suite software batekin testuinguruan jartzen du, inplementazio arrakastatsurako eskakizunak eta praktika onak deskribatzen ditu eta urratsez urrats instalatzeko argibideak.	sartorius.com/umetrics-simca- sarean
SimApi Gida	SimApi instalazioak prestatzea eta egitea, arazoak konpontzea barne. Garatzaileentzako SimApis-en xehetasun teknikoak ere baditu.	sartorius.com/umetrics-simapi
SimApi erabiltzailearen gidak	Argitaratutako SimApi bakoitzaren dokumentazioa, ezaugarriekin, instalazio-argibideekin eta konfigurazio bereziekin.	sartorius.com/umetrics-simapi
SIMCA-online Gida Teknikoa	SIMCA-online zerbitzariaren instalazioaren plangintzarako, arazoak konpontzeko eta SIMCA-online-k nola funtzionatzen duen sakontzeko erreferentzia teknikoa.	sartorius.com/umetrics-simca-sarean
SIMCA-online laguntza	WebSIMCA-online nola erabili eta SIMCA-online funtzionamenduari buruzko laguntza.	Softwarean bertan, eta aurrera sartorius.com/umetrics-simca
SIMCA-online Web Bezeroaren Instalazio Gida	SIMCA-online-ren instalazioa deskribatzen du Web Bezeroa.	sartorius.com/umetrics-simca-sarean
Umetrics ezagutza oinarria	Bila daitekeen datu-basea kaleratutako software bertsio bakoitzari buruzko artikuluekin, artikulu teknikoekin eta Umetrics Suite produktuen arazo ezagunekin.	sartorius.com/umetrics-kb
SIMCA laguntza/erabiltzaile-gida	Nola erabili mahaigaineko SIMCA proiektuak sortzeko eta datuak modelatzeko.	SIMCAn eta aurrera sartorius.com/umetrics-simca
Laguntza web orrialdea	Laguntza teknikoa nola lortu.	sartorius.com/umetrics-support

Laguntza teknikoa

• Sartorius lineako laguntza-taldeak SimApisi buruzko galdera teknikoak erantzuten ditu eta SimApis hobetzeko eskaerak ere bidal ditzake pertsona egokiei. Informazio gehiago hemen sartorius.com/umetrics-support.

SimApis lortzea

• Eskuragarri dauden SimApis-en dokumentazioa eta instalazio-programetarako estekak hemen eskaintzen ditugu sartorius.com/umetrics-simapi.
• SimApi bakoitza bere Erabiltzailearen Gidan dokumentatuta dago.
• Ez irakurtzen ari zaren SimApi Gidak informazio hori osatzen du SimApiren informazio osagarriarekin SimApi planifikatzeko, instalatzeko eta arazoak konpontzeko orduan.

SimApi ezaugarriak

• Datu-iturri guztiak ez dira berdinak. SimApi batek ez du zertan inplementatu behar espezifikazioko funtzio guztiak. Arrazoi horiengatik, SimApis ezberdinek funtzionalitate desberdinak eskaintzen dituzte. Hurrengo matrizeak SimApis erabilgarri eta haien ezaugarriak zerrendatzen ditu.
• Ezaugarriak behean azaltzen dira. Kontuan izan taulak zutabe bereiziak dituela erakusteko zein ezaugarri dauden SIMCA-online eta SIMCA-n hurrenez hurren.

Ezaugarri	Helburua	SIMCA-online erabilera	SIMCA erabilera
Egungo datuak	Irakurri datu-iturburuko baliorik berriena duen behaketa bakarra.	Denbora errealeko exekuzio normala	–
Datu historikoak	Irakurri behaketa asko aldi berean datu-iturburuko datu historikoekin.	Harrapatu eta iraganeko datuak aurreikusi, sortu proiektuak erabiliz File > Berria	Datu-basea inportatzeko morroia eredua sortzeko prozesuko datuak inportatzeko.
Datu diskretuak	Irakurri laborategiko/IPC datuak datu-iturburutik. Lote bakoitzeko behaketa asko.	Datu diskretuak berreskuratzeko konfiguratutako faseak edo batch-baldintzak dituzten loteen proiektuetarako.	–
Lotaren datuak	Irakurri lotearen baldintzak eta azken kalitate-atributuak (edo	Loteen baldintzak edo tokiko zentrazioa.	Datu-basea inportatzeko morroia batch baldintzak irakurtzeko

Ezaugarri	Helburua	SIMCA-online erabilera	SIMCA erabilera
	MES motako beste datu batzuk). Lote bakoitzeko behaketa bat.		lote mailako eredua sortzea.
Batch nodoa	Zehaztu hasiera-ordua eta amaiera-ordua (lote aktibo baterako hutsik) lote jakin baterako. Zenbaki ezazu denbora tarte batean zeuden sorta guztiak.	Batch konfigurazioak exekutatzeko beharrezkoa da.	Datu-basea inportatzeko morroia inportatu beharreko loteak hautatzeko.
Idatzi atzera - etengabeko datuak	Idatzi etengabeko datuak, hala nola iragarpenak, datu-iturburura.	Idatzi batch eboluzio-mailako datuak, Kontrol Advisor-erako edo etengabeko konfigurazioetarako	–
Idatzi atzera - diskretua	Idatzi datu diskretuak, hala nola iragarpenak, datu-iturburura.	Idatzi batch konfigurazioetarako lotearen bilakaera mailan, datu diskretuak berreskuratzeko konfiguratutako faseetarako	–
Idatzi itzuli - lotearen datuak	Idatzi lote-mailako datuak, hala nola iragarpenak edo azken kalitate-atributuak, datu-iturburura.	Idatzi itzuli loteen konfigurazioa loteen mailan	–
Nodoen hierarkia	SimApi-k nodoen hierarkia onartzen du, a-ren antzera file sistema. Nodo bakoitzak eduki dezake tags eta beste nodo batzuk. Hierarkiak errazagoa da nodo kopuru handi bat kudeatzea eta tags.	Leku guztietan onartzen da tags erabiltzen dira.
Array tag hedapena	Array bat tag hainbat balio gordetzen ditu. SimApi-k array-a zabaltzen du tag pertsona askorentzat tags, bat matrizeko elementu bakoitzeko.	Onartua non tags etengabeko datuetarako erabiltzen dira. Bakoitza zabaldu zen tag SIMCA proiektuko aldagai batekin mapatu behar da.
Hainbat datu-iturri	SimApi datu-iturri bakar batera baino gehiagora konekta daiteke edo bere buruaren hainbat instantzia onartzen ditu ezarpen eta erregistro indibidualekin files instantzia bakoitzerako.	Konektatu mota bereko hainbat datu-iturri ezberdinetara.	–
Konexioaren erresilientzia	SimApi datu-iturburutik deskonektatzen bada, konexioa automatikoki berrezartzen saiatuko da.	SimApi ez da berrabiarazi behar datu-iturbururako konexioak berrezartzeko.	–
Etxean garatua	SimApi-k garatu, hornitu eta onartzen du

Egungo datuak soilik, datu historikorik gabe, ez dira gomendagarriak

• SimApis batzuek, batez ere OPC DAk, uneko datuak irakurtzen dituzte soilik, eta ez datu historikoak.
• Uneko datuak soilik onartzen dituen SimApi bat ezin da erabili mahaigaineko SIMCAn, ezingo baitu ereduak eraikitzeko datu historikoak irakurri.
• SIMCA-onlinerako, biziki gomendatzen dugu datu-iturburu bat eta SimApi, uneko datuak denbora errealean exekutatzeko ez ezik, datu historikoak ere eskaintzen dituena iraganeko datuak aurreikusteko eta harrapatzeko. SIMCA-online automatikoki aldatzen da denbora errealeko datuen eta datu historikoen artean behar izanez gero eta ezin da desaktibatu.
• Uneko datuak soilik eskaintzen dituen datu-iturri batek, baina ez datu historikoak, etengabeko proiektuetarako funtziona dezake SIMCA-online, baina batch proiektuetarako, datu historikoak behar dira.

SimApi instalazio bat prestatzen

• Atal honek SimApi bat arrakastaz instalatzeko informazio garrantzitsua deskribatzen du.

64 biteko edo 32 biteko SimApis

• SimApi bakoitzaren 32 biteko eta 64 biteko bertsioak daude.
• SIMCA-online eta SIMCA 64 biteko dira eta 64 biteko SimApis aldaerak behar dituzte. 32 biteko SimApis ondarea oraindik erabilgarri dago instalazio zaharretarako.

Erregistrorako kokapena file eta ezarpenak

• SimApi batek bere erregistroa gordetzen du files ezkutuko Program Data karpetan1:
  %programdata%\Umetrics\SimApi, non %programdata% zure ordenagailuko benetako karpetarekin mapatzen den. Lehenespenez C:\ProgramData.
• SimApi bakoitzak bere erregistroa erabiltzen du normalean file, SIMCA-online zerbitzariaren erregistroaren antzera file datu gehiago edo gutxiago edukiko ditu erregistro-mailaren ezarpenaren arabera. Hau file erabilgarria da arazoak konpontzeko. Erregistroa file izena du
  .log non instalatzen ari zaren SimApi da, adibidezample PIAFsimApi. Ikusi SIMCA-online SimApi instantzia-izenen hurrengo atala.
• Karpeta honek SimApi ezarpenak ere baditu XML batean file izendatua .xml.
• SimApi gehienek erabiltzailearen interfaze grafikoak dituzte xml-ko ezarpenak aldatzen dituztenak file, baina batzuentzat aldaketak zuzenean XMLan sartzen dituzu file testu-editore batekin, adibidez, Notepad. Ikusi SimApi bakoitzaren erabiltzailearen gida.

File izenak izendatutako instantziak SIMCA-online-rekin erabiltzen direnean

• SIMCA-online-n, SimApi instantzia bakoitzak bere konfigurazioa lortzen du file eta erregistratu file SimApi bakoitzaren instantzia anitzekin lan egiteko. Hauen izenak fileSimApi fitxan SIMCA-online zerbitzariaren aukerak elkarrizketa-koadroan ematen den instantziaren izenaren atzizkia jartzen dute.
• Hurrengo example hauen izenak erakusten ditu files, non SimApi izenarekin ordezkatu behar da.
• Instantzia gehitzean ematen den konfigurazio-izena: OmegaServer
• Konfigurazioa file izena: OmegaServer.xml
• Erregistroa file izena: OmegaServer.log
• Kontuan izan generikoa dela file .erregistroa file sortu da oraindik. Erregistro hau file Arrazoi teknikoengatik erregistrora bideratu ezin diren sarrerak ditu file kasuen artean..
• Karpeta hau Windows-en ezkutatuta dago lehenespenez. Bertan ikusteko File Explorer konfiguratzen duzun ezkutuan erakusten du files. Kontuan izan ezkutuko karpeta batera nabiga dezakezula helbide bat idatzita File Explorer-en helbide-barra.
• Kontuan izan SIMCAk ez dituela SimApi-ren instantzia anitz onartzen, eta, beraz, instantzia-izenik gabeko izenak erabiltzen dituela goian azaldu bezala.

Sarearen plangintza

• SIMCA-online zerbitzaria sareko datu-iturburutik gertu kokatu behar duzu. Honek SIMCA-online eta bere datu-iturriaren arteko konexio azkarra bermatzen du.
• Sareko ekipoek SIMCA-online eta datu-iturburuaren arteko konexioa oztopatu dezakete.

Erabiltzaile-kontuak eta datu-iturburuaren baimenak

• Datu-iturburuek normalean beren datuetarako sarbidea kontrolatzen dute. Erabiltzaile-izen eta pasahitzekin egiten da normalean, baina IP helbidean edo DNSn oinarritutako murrizketak ere erabil daitezke (adibidezample PIk Aveva PI System-en fidatzen du).
• Erabiltzaile-izena eta pasahitza datu-iturburuari eman diezaiokezu modu ezberdinetan:
• SimApi bat mahaigaineko SIMCA edo SIMCA-online zerbitzu-kontu zerbitzariko ordenagailuan exekutatzen duen erabiltzailearen Windows erabiltzaile gisa exekutatzen da. SimApi datu-iturburura konekta daiteke kontu hau erabiliz. Horrela funtzionatzen dute OPC I, eta PI SimApi, eta ODBC konfiguratzerakoan kredentzialak ematen ez badituzu.
• ODBC generikorako, Windows-en Hasi-n dagoen ODBC Data Sources Administrator aplikazioa erabil dezakezu.
• Datu-base hornitzaile batzuek beren kontrolatzaileak eta tresnak eskaintzen dituzte datu-baseetarako. Oracle datu-baseak, adibidezample, erabili Oracle Data Access Components (ODAC).
• SimApi batzuek, hala nola PI AF eta ODBC, konfigurazio-koadroak dituzte enkriptatutako kredentzialak SimApi XML konfigurazioan gordetzen dituztenak. file.
• PI-k segurtasun-aukera desberdinak ere baditu eskuragarri PI System Management Tools-en PI zerbitzariaren ordenagailuan. Irakurri gehiago PI AF SimApi erabiltzailearen gidan. Gida hau lagungarria da OSIsoft PI SimApi zaharragoa erabiltzen baduzu ere.
• OPC DA eta HDAk DCOM erabiltzen dute datu-iturri baten eta SimApiren arteko garraio gisa. DCOM Component Services tresnarekin (DCOMCNFG.EXE) konfiguratuta dago Windows-en eta Windows autentifikazioa erabiltzen du.
• OSIsoft PI SimApi zaharragoarentzat (ez AF SimApi berriagoa), OSIsoft AboutPI-SDK aplikazioa (PISDKUtility.exe) erabiltzen da PI zerbitzarirako konexioa konfiguratzeko.

Datu-iturburuaren konexioa egiaztatzea
SimApi bat ordenagailu batean instalatu nahi duzunean, erabilgarria izan daiteke ordenagailu horretatik datu-iturbururako konexioa egiaztatzea beste tresna batekin:

• Windows-en ODBC datu-iturburuak ODBC generikoa konfiguratzeko eta probatzeko erabiltzen da. Kontuan izan tresna honen bi bertsio daudela 64 biteko Windows-en: bat 32 biteko aplikazioetarako eta bestea 64 biteko. Erabili Test Data Source botoia ODBC konfigurazio-morroiaren amaieran datu-basearekiko konexioa egiaztatzeko. Zure datu-iturriak Sistema DSN gisa konfiguratzea gomendatzen dizugu.
• Datu-basearen hornitzailearen datu-baserako berariazko konexio-tresna bat, esate baterako, Oracle Data Access Components.
• PI System Explorer erabil daiteke PI AF zerbitzariarekiko konexioa probatzeko. PI AF Bezeroaren parte da, PI AF SimApi-rako aurrebaldintza dena.
• Unified Automation-eko OPC UA aditua - UaExpert OPC UA zerbitzarientzako plataforma anitzeko proba bezeroa da.
• PI-SDK aplikazioa (PISDKUtility.exe) konektibitatea probatzeko erabil daiteke view SIMCA-online PI zerbitzariarekin konektatzen saiatzen denean erregistratu izan daitezkeen errore-mezuak. Hau OSIsoft SimApi zaharragoetarako bakarrik erabiltzen da, ez PIAFentzat.
• PI System Management Tools PI zerbitzariaren ordenagailuan erabiltzen dira alde horretatik arazoak konpontzeko. Adibidezample, SIMCA-online zerbitzaritik sarbidea eragozten duten segurtasun-arazoak bilatzeko. Lortu informazio gehiago PI sistemaren arazoak konpontzeari buruzko YouTube bideo honetan.
• Excel erabil daiteke ODBC konexio batetik eta beste sistema gehienetatik datuak lortzeko plugin egoki bat instalatuta dagoenean.
• Matrikon OPC Explorer Ior HDArako (tresna bereiziak dira) OPC konektibitatea probatzeko erabil daiteke, eta Matrikon OPC Analyzer OPC konektibitate-arazoak diagnostikatzeko erabil daiteke. Deskargatu doako tresna hauek hemendik https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (DInd HDArako) OPC Training Institute-ren eskutik web guneak "erabiltzaileei komunikazio- eta segurtasun-arazoak erraz diagnostikatzeko aukera ematen die, eta berehala konpon ditzakete botoi bat sakatuta. Hori guztia egin daiteke DCOM konfiguratzen ikasi beharrik gabe".

SimApi bat instalatzea

Hona hemen SimApi bat nola instalatu ordenagailu batean:

1. Irakurri instalatzen ari zaren SimApi erabiltzailearen gida. Orain irakurtzen ari zaren argibide orokorrak osatzen dituzten SimApi horretarako xehetasunak ditu.
2. Instalatu eta konfiguratu SimApi erabiltzailearen gidan aipatutako aurrebaldintzak (adibidezampdatu-basearen kontrolatzaileak edo SDK-ak)
3. Exekutatu konfigurazio programa SimApi instalatzeko. Instalatu exekutatu nahi duzun softwarearekin bat datorren 64 biteko (x64) edo 32 biteko (x86) bertsioa.
4. Konfiguratu SimApi SIMCA-online edo SIMCAn hurrengo ataletan deskribatzen den moduan eta jo SimApi-ren erabiltzailearen gida erabilgarri dauden ezarpenen deskribapenetarako.
5. Hasi SIMCA-online zerbitzaria. Kontuan izan honek denbora behar duela, izan ere, SimApi hasieratzen denean, guztiak zerrendatuko ditu tags datu-iturburuan.
6. Probatu SimApi datu batzuk lortuz. SIMCA-onlinerako, erabil dezakezu File > Atera ezazu 6.1.
7. SimApi-k espero bezala funtzionatzen ez badu, ikusi SimApi-ren erregistroa files arazoak konpontzeko eta SimApi erabiltzailearen gidara.

SimApi SIMCAn erabiltzeko konfiguratzea

Hona hemen SimApi SIMCAn nola erabili:

1.  Hasi datu-basearen inportazioa modu hauetako batean:
   • a. SIMCAn proiektu berri bat sortzeko: File > Ohiko Proiektu Berria edo Batch Proiektu Berria. Hautatu Datu-basetik Hasiera fitxan.
   • b. SIMCAn lehendik dagoen proiektu batean datu-multzo bat inportatzeko: irekitako SIMCA proiektu baten Datuak fitxako datu-multzotik.
2. Sakatu Gehitu datu-iturburu berria
3. Hautatu SimApi konexio mota gisa, egin klik…-botoia eta kokatu .dll instalazio karpetan eta sakatu Ireki.
4. Sakatu Konfiguratu eta ikusi ezarpenak nola egin SimApi Erabiltzailearen Gida indibiduala.
5. Sakatu Probatu datu-iturburuaren konexioa datu-basera konekta zaitezkeela egiaztatzeko. Honek denbora luzea izan dezake asko badira tags datu-iturburuan.
6. Sakatu Ados konfigurazioa osatzeko.
7. Ikus SIMCA laguntza inportatutako datuekin nola lan egin jakiteko.

SimApi konfiguratzea SIMCA-online-n erabiltzeko

• Garrantzitsua: SimApi bat erabili ahal izateko, SIMCA lineako zerbitzariaren lizentzia behar da. SIMCA-online-ren demo-instalazio batek ez du onartzen SimApis erabiltzea.
• Sistemari SimApi bat gehitzeko, SIMCA-online Server Options exekutatzen duzu zerbitzariaren ordenagailuan. Ikasi xehetasunen urratsak SICMA-online laguntza-gaian Gehitu eta konfiguratu SimApi bat zerbitzarian.
• Aholkua: SimApi batean aldaketak egiten badituzu, SimApi hori berrabiarazi dezakezu Zerbitzariaren Aukeretatik bereizita, zerbitzari osoa berrabiarazi gabe.
• SimApi honen hainbat instantzia konfiguratzeko, errepikatu goiko urratsak eta erabili izen esklusiboak instantzia bakoitzeko. Irakurri gehiago erregistro eta konfigurazio desberdinei buruz files 4.2.ko kasuetarako.

SimApi bat probatu eta konpontzea

• Kapitulu hau SimApi instalazio bat probatzeari eta arazoak konpontzeari buruzkoa da.

SIMCA-online-tik SimApi bat probatzen

• SIMCA-online zerbitzaria behar bezala abiarazi ondoren, zure SimApi probatu dezakezu SIMCA-online-n (zerbitzaria abiarazten ez bada, ikusi 6.2):
• Hasi saioa SIMCA-online bezeroan zerbitzarian eta joan Extract-era File fitxa. Extract-ek SimApi probatzen laguntzen dizu haren bidez datuak lortuz:
• SimApi-ren nodoak ("karpetak") ezkerreko koadroan bistaratzen dira. Tags hautatutako nodorako goi-eskuinean bistaratzen dira.
• Uneko datuak azkar probatu daitezke klik eginda view> aktibatuta tags prozesu etengabeko datuak ematen dituztenak (ikus pantaila-argazkia)
• Egin klik eskuineko botoiarekin nodo batean denbora tarte batean loteak aurkitzeko. Nodoak loteei buruz dakien batch-nodoa izan behar du.
• Hautatu tags Extract atalean eta sakatu Hurrengoa eta amaitu morroia datuak eskuratzeko modu desberdinak erabiliz datuak eskuratzeko: uneko datuak, historikoak, lotekoak eta diskretuak.
• Konparatu ateratako datuak zure datu-iturburuan ikusten duzunarekin bere tresnak erabiliz. Lortu informazio gehiago SimApi baten ezaugarri guztiak probatu eta balioztatzeko 7.13.

Konpondu SimApi-ren arazoak SimApi erregistroa erabiliz file

• Zerbitzaria abiarazten ez bada, SimApi-k ez badu espero bezala funtzionatzen edo ateratzeak huts egiten badu, SimApi-ren erregistroa kontsultatu behar duzu file horrek esaten dizu zein den arazoa. Gaitu Arazte-mailako erregistroa SimApi erregistroan xehetasun guztiak lortzeko. Ikus 4.2.
• Oharra: SIMCA-online zerbitzariaren erregistroak ez dira hain erabilgarriak hemen. Zerbitzariak SimApi nola kargatu eta hasieratu zuen erakutsiko dute, baina SimApiren xehetasun zehatzak bere erregistroan daude. file.

Erabili SIMCA-online zerbitzu-kontu egokia

• Datu-iturbururako sarbidea probatzen ari zarenean, gogoratu zerbitzariko ordenagailuan erabiltzaile zehatz gisa hasi duzula saioa (normalean zure erabiltzaile-kontua Windows domeinu batean), baina SIMCA-online zerbitzariaren zerbitzu-kontua beste kontu bat dela, lehenespenez LocalSystem, zure erabiltzaile-kontuarekin alderatuta sarbide-eskubide desberdinak dituena.
• Hori dela eta, ez da arraroa probak zure kontu gisa exekutatzen direnean funtzionatzea, baina SIMCA-online datu-iturburura konektatzen ez izatea.
• Arazo hau konpontzeko, SIMCA-online zerbitzari-zerbitzuak erabiltzen duen konturako sarbidea eman behar zaio. Normalean, LocalSystem domeinu-zerbitzu-kontu zehatz batera aldatzen duzu eta kontu honetarako eskubideak ematen dituzu. Kontuan izan hau ez dela aplikatzen SimApi-k SimApi konfigurazioan ezarritako kredentzialak erabiltzen baditu, kredentzial horiek lehentasuna dutelako.

SimApis-en xehetasun teknikoak

• Kapitulu honek SimApi baten funtzionamenduari buruzko xehetasun teknikoak ematen ditu. Batez ere SimApis ulertu nahi duten garatzaileei zuzenduta dago datu-iturburu baterako SimApi bat ezartzeko.
• Garatzaileek dokumentu honen aurreko zatiak ere irakurri beharko lituzkete SimApis-en sarrerarako eta funtzioen goi-mailako deskribapenetarako.

Noiz kontuan hartu SimApi bat garatzea eta noiz ez?

Datu-iturburu baterako SimApi bat garatzea pentsatu aurretik:

1. Ikertu dagoeneko erabil dezakezun SimApi bat dagoen. Agian zure datu-iturburuan eginbideren bat gaitu dezakezu lehendik dagoen SimApis bat erabiltzeko, adibidez, OPC UA.
2. Aztertu arretaz dokumentu hau eta bere erreferentziak eta ikertu zure datu-iturburuak baldintzak betetzen dituen: adibidezample, nahikoa azkarra izan behar du, egungo datuak ez ezik, datu historikoak ere eman behar ditu.

• Arrazoi hauengatik, ez dugu gomendatzen maila baxuko hardware edo tresnekin konektatzen den SimApi bat garatzea. Hobe da tresna horiek Aveva PI System bezalako prozesuen historialari batekin konektatzea, eta tresnatik datuak eskuratzen uztea eta historiatzen uztea. Ondoren, PIAF SimApi erabil daiteke PItik Umetrics produkturako datuak lortzeko.

SimApi garapena eta SimApi zehaztapena

• SimApi zehaztapenak, SimApi-v2, SimApi DLL batek inplementatu behar dituen SimApi-ko C-funtzio guztien dokumentazioa du, baita SimApi bat garatzeko jarraibide batzuk ere.
• C edo C++ erabiliz SimApi bat ezartzea kasu gehienetan alferrikako maila baxuan dago.
• SimApi bat ezartzeko gomendatutako eta errazagoa den Ex-an oinarritzea daampGuk ematen dugun leSimApi iturburu-kodea. Ex. bat daample SimApi inplementazioa C-interfazea kudeatzen duena eta benetako inplementazioa egiten den.NET Framework-era itzultzen duena. Erregistrorako, ezarpenetarako, konfigurazio GUIrako eta beste esparru-kode batzuk ere baditu.
• SimApi bat garatzeko, garatzaile-taldeak esperientzia behar du Windows garapenean, .NET Framework, C edo C++. SimApi-k konektatu behar duen datu-iturburua ondo ezagutzea ere beharrezkoa da, SimApi baten helburua SIMCA-online edo SIMCA-tik datu-eskaerak datu-iturburuko APIra itzultzea baita. SimApi inplementazioa ez da inoiz proiektu bakarra, baina normalean etengabeko laguntza eta noizbehinkako mantentze-lanak behar ditu.

Datuak irakurtzea edo idaztea

• SimApi batek datu-iturri batetik datuak ematea du zeregin nagusia. Hau irakurketa datuak deritzo.
• SimApi inplementazio gehienek ere datuak idazteko onartzen dute. Horrek esan nahi du datuak SimApi bidez datu-iturburura idaztea. Datuak idaztea SIMCA-online aukerako eginbide bat da.

Tags eta Nodoak

• A tag datu-iturburu bateko zutabe edo "aldagai" baten identifikatzaile bat da. A tagren izena identifikatzeko erabiltzen da tag. Nodo barruko izenek bakarrak izan behar dute. SIMCA-online 18 azpinodo bat duen nodo bat onartzen duen lehen bertsioa da eta tag izen berarekin. Adibidezample: Guraso nodoak Batch izeneko azpinodo bat izan dezake eta a tag Batch izenekoa.
• Nodo bat edukiontzi bat da tags. Nodo batek beste nodo batzuk ere izan ditzake, nola a file sistemak karpetak ditu karpetetan.
• batean bezala file sistema, nodoa eta tag izenak modu esklusiboan identifikatzen duen bide oso batera konbina daitezke tag. The tag bideak SIMCA-online edo SIMCA-n erabiltzen dira hautatzerakoan tags erabiltzeko. A tag bidea SimApi instantzia-izen batekin hasten da, nodo-egituraren ondoren, eta amaieran tag izena, elementu bakoitza bi puntuz (:) bereizita. Adibidezample “:ODBCSQLServer:Nodo:SensorTag1”.

SimApi-k zerrendatzen du tags eta nodoak abiaraztean

• SimApi inplementazio batek zerbitzaria arakatzen du nodoen bila eta tags datu-iturburuan SimApi hasieratzen denean eta horien jarraipena egiten du, zenbatzeko erabiltzen diren SimApi funtzio desberdinak izan daitezen. tags eta nodoa inplementa daiteke.
• SimApi hasieratzea ez da zerbitzaria abiaraztean gertatzen, baizik eta SIMCA-online erabiltzaile batek berriro abiarazi dezake Fresh SimApi funtzionalitatearekin.

Maiuskulak eta minuskulak bereiztea tag- eta nodoen izenak

• Tag izenek eta nodoen izenak maiuskulak eta minuskulak bereizten dituzte.
• Horrela, a tag izenekoatag1" ez da berdina "Tag1” “T”-aren kasu ezberdina delako. Ez erabiltzea gomendatzen dugu tags edo nodo-izenak zein kasutan bakarrik desberdinak.

Etengabeko prozesu-nodoa 

• Nodo batek daukanean tags prozesu etengabeko datuekin, prozesu-nodo gisa dei daiteke. Hurrengo bi pantaila-argazkiek prozesu-nodo baten irudikapen taula bat erakusten dute datuekin eta ondoren nodoa hautatzen denean nola ikusten den erakusten duen irudi batekin. tags SIMCA-online-n.

Etengabeko prozesuko nodoek lote, exekuzio edo denboraren independenteak izan behar dute

• SimApi batean ondo funtzionatzeko nodo batek lote, exekuzio edo denboraren independentea izan behar du. Lote edo denbora-tarte jakin baterako datuak dituen nodo bat izateak ez luke ondo funtzionatuko SIMCA-online-n, proiektuaren konfigurazioak lote horretako datuak soilik irakurriko lituzkeelako eta beste lote batzuetarako ez bailitzateke erabili.
• Horren ordez, nodo bat unitate fisiko batera edo gehiagorekin mapatu behar da neurketak egiten diren prozesuan.

Lotearen IDa tag Batch proiektuen exekuziorako prozesu etengabeko nodoetan behar da

• Etengabeko prozesu bakoitzak bat izan behar du tag (aldagaia) behaketa bakoitzeko lote-identifikatzailea edukitzea. Lote-identifikatzaile hau SIMCA edo SIMCA-online-k erabiltzen du behaketa bakoitza zein loteri dagokion jakiteko.
• $BatchID tag 7.4.3-ko pantaila-argazkietan halako bat dagoample.
  Beharrezkoa ez den arren, bat edukitzea gomendatzen da tag prozesuaren uneko fasea edo urratsa erakusten duen prozesu-nodoan. Hau tag ondoren, faseen exekuzio baldintzetan erabil daiteke SIMCA-online edo SIMCAn datuak inportatzerakoan. Horretarako balioak tag izan daiteke adibidezample “fase1”, “garbiketa”, “fase2”.

Batch testuinguru-nodoa

• Batch nodo bat loteen jarraipena egiten duen nodo bat da; haien lote-identifikatzaileak, hasiera-orduak eta amaiera-orduak. Batch proiektuak SIMCA-online exekutatzeko baldintza bat da. Datu-iturburu batek lote-nodo bat baino gehiago izan dezake, sortak modu ezberdinetan erakusten dituena. Erabiltzaileak bere aplikazioari dagokion lote-nodoa hautatzen du. Adibampbi unitate ezberdin hartzen dituzten loteak erakusten ditu:
• /Factory1 –Unitate1 eta 2 unitateko iraupen agregatuak dituzten loteak.
• /Factory1/Unit1 – Unitatean soilik iraupena duten loteak
• /Factory1/Unit2 – Unitatean soilik iraupena duten loteak
• Zure datu-iturburuan batch nodorik ez baduzu, Batch Context Generator erabil dezakezu SIMCA-online-n. Ikusi integratutako laguntza.
• Aukerako lotearen datuak
• Batch nodo batek lotearen datuak ere eduki ditzake; lote osorako behaketa bakarra dagoen datuak. Kontuan izan tags batch datuekin ez da zertan batch nodo baten funtzionaltasun osoa duen nodo batean egon. Nahikoa da SimApi-k batch datuak irakurtzea onartzen duela tags. Lortu informazio gehiago lotearen datuei buruz 7.6.
• Hona hemen exampbatch nodo baten fitxategia:
• Oharra: Goiko pantaila-argazkia DBMaker-etik hartua da, SIMCA-online-rekin batera. Hau zuk zeuk ikusteko DBMaker-en, egin klik View Bakers Yeast datu-baseko datuak botoia bi leiho bistaratzeko, horietako bat lote-nodoa eta bestea prozesuko datuak.

Datu motak: zenbakizko datuak, testu datuak eta falta diren datuak

• Bakoitzerako tag, SimApi batek hiru datu mota onartzen ditu: zenbakizkoak, texkoak, t eta falta direnak:
• Zenbakizko datuak normalean prozesu-parametroen balio errealak dira, adibidezample 6.5123. SimApi-k 32 biteko doitasun bakarreko koma mugikorreko balioak soilik kudea ditzake. Doitasun bakarreko koma mugikorreko formatua -Wikipedia. Datu-iturburu bateko beste zenbakizko datu mota guztiak float bihurtu behar dira. Horrela, balio handi zein txikiekin jorratu ditzakete, baina 6 edo 7 zifra esanguratsurekin soilik. Informazio gehiago Gida Teknikoan.
• Horrek zehaztasuna galtzea ekar dezake zenbaki oso handietarako edo biak handiak diren eta hamartarrak dituzten zenbaki errealetarako. Informazio gehiago lortzeko, ikusi Gida Teknikoa.
• Testu/katearen datuak loteen IDetarako, faseen exekuzio baldintzetarako edo aldagai kualitatiboetarako erabiltzen dira. Testuaren balioak tag datuak maiuskulak eta minuskulak bereizten dira. Horrek esan nahi du "running" balioa ez dela berdina
  “KORRIKA”. Data-orduaren aldagaiak ez ditu zuzenean onartzen SimApi-k, baina YY-MM-DD HH:MM gisa formateatutako kate gisa itzul daitezke (adibidezample “2020-09-07 13:45”).
• Baloreak falta direla esan nahi du ez dagoela itzultzeko baliorik, hau da, daturik ez dagoela.
• Zer mota itzultzen den SimApi inplementazioari dagokio. SimApi batek datu-iturburuko datuak ezagutzen ditu eta hobekien egokitzen den datu-mota itzuli beharko luke.

Datuak berreskuratzeko hiru modu: Etengabea, Batc,h eta Discretua

• SimApi zehaztapenak datuak berreskuratzeko hiru modu definitzen ditu, hau da,. SimApi-k datuak emateko hiru modu desberdinetatik tags datu-iturri batean (edo beste norabidean: idatzi datuak tags datu-iturri batean).
• Etengabeko datuak berreskuratzea: etengabe irakurtzen diren datuei eta sekuentzialki, behaketa bakoitzeko lote edo prozesua eboluzionatzen den heinean aipatzen da. Datuak uneko ordurako edo tarte zehatz baterako irakurtzen dira, behaketen arteko tarte erregularrean. Adibidezample, datu guztiak 09:00:00 eta 10:00:00 s arteanamp60 segunduro zuzenduta, 61 behaketa lortuz amaierako puntuak barne hartzen dituztenean.
• Batch datuen berreskurapena - lote oso baten datuak dituen behaketa bakar bati egiten dio erreferentzia (ez dago heldutasun edo denbora-puntu zehatz batekin lotuta). Lote-atributuak eta tokiko zentratze-datuak lote-datu gisa irakurtzen dira SIMCA-online-n. Batch baldintzak normalean lote-datu gisa ere irakurtzen dira (datu diskretuak berreskuratzeko konfiguratuta ez badaude).
• Datu diskretuak berreskuratzea: datu diskretuak hainbat behaketa izan daitezke heldutasun askotarako. Baina datu jarraituak ez bezala, datu diskretuak ez dira sekuentzialki irakurtzen, baizik eta datu guztiak aldi berean lote baten fase zehatz baterako. Datuak ez dira heldutasun-aldagaiaren tarte erregularrekin tartekatu behar. Datu guztiak berriro irakurtzen dira datuak eskatzen diren bakoitzean, konfiguratutako tartean.
• Emandako edozeinentzat tag datuak hiru moduetako edozeinetan eska daitezke, baina normalean SimApi batek modu horietako bat bakarrik onartzen du banakako tag. Era berean, nahastea onartzen da tags nodo baten barruan, baina normalean guztiak tags nodo zehatz baten barruan datuak berreskuratzeko modu bera onartzen dute.
• Etengabeko datuetarako (baina ez sortarako edo datu diskretuetarako2), hurrengo ataleko gaia den uneko datuetarako edo datu historikoetarako eskaerak egin daitezke.
• SimApis guztiek ez dituzte modu guztiak onartzen. Ikusi goiko ezaugarrien matrizea eta SimApi web orrialdea xehetasunetarako.

Uneko eta Historiako etengabeko datuak SimApi baten bidez

• Etengabeko datuak denboran zehar aldatzen diren prozesuko datuak aipatzen dira.

Egungo datuak

• Uneko datuak irakurtzeak datu-iturburuari azken balioak eskatzea esan nahi du tags galdetzeko unean. Kontuan izan hemen kanpoko datu-iturburuaren ordua ez dela erabiltzen.
• Uneko datu gisa irakurritako datuak SIMCA-online-k zuzeneko datu gisa erakutsiko ditu. Horregatik, garrantzitsua da datu-iturburuan alferrikako atzerapenik ez egotea. Uneko datuek ahalik eta berrienak izan behar dute SIMCA-online-n ondo funtzionatzeko.
• Datu-iturburuak datuen ezagutza eta balioak zenbat denboran balio duen erabil dezake eta falta diren datuak itzultzea erabaki dezake denbora-puntu bateko datu gordinak zaharregiak direnean. Adibidezample: datuak 15:00:00etan eskatzen dira baina datu-iturburuko datu-punturik berriena 03:00:00etakoa da. Kasu honetan datuek 12 ordu dituzte, beraz, SimApi-k falta den balioa itzultzea erabaki dezake (daturik ez).

Datu historikoak

• Datu historikoak irakurtzeak datu-iturburuari baten edo gehiagoren balioak eskatzea esan nahi du tags denbora tarte zehatz baterako, behaketen arteko tarte zehatz batekin. Kontuan izan hemen datu-iturburuaren tokiko ordua dela datuak aurkitzeko erabiltzen dena. Hori dela eta, garrantzitsua da datu-iturburuaren eta zerbitzarien arteko denbora-sinkronizazioa.
• Datu historikoak datu-matrize batez osatuta daude. SimApi inplementazioari dagokio datuak eskatzea datu-iturburutik, eta samputzi zehaztutako tartean eta eraiki itzultzeko datu-matrizea:
• Batzuetan, datu-iturburuak berak agregazio-funtzioak ditu prozesatutako datuak itzultzeko, edo sampling funtzioak, datu egokiak itzultzeko erabil daitezkeenak.
• Beste datu-iturri batzuetarako, SimApi-k denbora tarteko datu guztiak eskatu behar ditu eta gero sample behaketa egokiak matrizea eraikitzeko.
• Datuak denbora-tarte baterako itzuli behar dira, nahiz eta baliteke denbora-tartean datu gordinak ez egotea, baina hasiera-ordua baino lehen. Adibidezample: datuak datu-iturburuan daude 10. eta 20. denbora-puntuetan. SimApi-k 15. eta 17. denborarako datuak eskatzen ditu. Kasu honetan, 10. denbora-puntuaren balioak SimApi-k itzuli beharko lituzke baina denbora gehienamped 15. eta 17. denbora gisa, garai haietan datu berrienak zirenez. Baloreak tags unean 10 eskatutako barrutirako muga-balio gisa aipatzen dira. Mugen balioen azalpen sakonagorako, ikus adibidezampLege ezazu itzuleraren inguruko dokumentazioa UA 11. zatian: Sarbide historikoa - 6.4.3 ReadRawModifiedDetails egitura
  (opcfoundation.org)
• Interpolazioa ez da inoiz erabili behar etorkizuneko denbora-puntuen balioak kalkulatzeko, datuak ez direlako bat etorriko denbora errealean irakurtzen denarekin uneko datu gisa. Adibampaurreko buletaren le: 15. eta 17. datuak 10. eta 20. elementuaren balioak erabiliz interpolatuko balira, etorkizuneko balioak eraginkortasunez erabiliko lituzkete, eta hori ez dago onartzen.
• Datu-iturburuak datuen ezagutza eta balioak zenbat denboran balio duen erabil dezake eta falta diren datuak itzultzea erabaki dezake denbora-puntu bateko datu gordinak zaharrak direnean. Adibidezample: datuak 15:00:00etarako eskatzen dira baina datu-iturburuko datu-punturik berriena 03:00:00etakoa da. Kasu honetan, datuek 12 ordu dituzte, beraz, SimApi-k falta den balioa itzultzea erabaki dezake (daturik ez).

Oharra: SIMCA-online-k normalean ez ditu ehun behaketa baino gehiago eskatzen deialdi batean proiektuaren exekuzio arruntean. SIMCA-online erauzketa egitean edo mahaigaineko SIMCA exekutatzen denean, datu-eskaera handiagoak egin daitezke. Hauek denbora luzea izan dezakete, eta hori espero da.

Uneko datuek eta datu historikoek bat egin behar dute

• Batzuetan, desberdintasunak egon daitezke datuak denbora errealeko uneko datu gisa edo datu historiko gisa irakurtzen direnean. Horrek arazoak sortzen ditu SIMCA-online-n, zerbitzariak automatikoki uneko eta datu historikoen artean aldatzen duelako behar den moduan.

Latentzia baxuko datuak eskuratzea

• SIMCA-online-k datu-iturburu bat denbora errealean erabiltzen duenean, garrantzitsua da datu-iturburuko datuak unekoak izatea. Ez da beharrezkoa alferrikako atzerapenik egon behar datu-iturburuan datuak eskuratzean. Aldagai guztien prozesu etengabeko datuak aldi berean eskuragarri egon behar dira behaketa guztietan. Aldagai batzuengatik berandu sartzen diren datuak SIMCA-online-k ez ditu jasoko.

Datuak edozein unetan irakur daitezke 

• SIMCA-online-k a-ren balioa eskatzen duenean tag t denborarako datu-iturburuko balioa t denboratik jasoko du, edo datu-iturburuko azken behaketa t denbora baino lehen, edo t denborarako balio interpolatua. Horrela, zerbitzariak beti jasoko du balio bat eskatzen duen bakoitzean, nahiz eta datu-iturburuan denbora-puntu zehatz horretarako behaketarik ez egon.
• DenboralenaampSimApi-n beti UTC dira. SIMCA-online bezeroek eta SIMCAk ordua tokiko ordu gisa aurkezten dute.

Harikatzea 

• SimApi-ra, lehenespenez, hari bakar batek deitzen du SimApi-ren erabiltzaileak. Hau egia da SIMCA bertsio guztietan eta SIMCA-online 17 bertsiora arte.
• SIMCA-online 18-k eginbide-marka bat onartzen du SimApi bidez hari anitzeko sarbidea aktibatzeko. Irakurri gehiago laguntza-gaian SimApi-ren aldibereko sarbidea.
• Horrek esan nahi du SimApis-ek hari anitzeko harietarako prestatu beharko lukeela, ahal bada, SimApi inplementazio-haria seguru eginez, eta hau eta SimApi-ren erabiltzaileentzako gogoetak dokumentatu behar ditu.

Erregistroa file

• SimApi batek ekintzak, errore-mezuak eta abisuak erregistratu beharko lituzke bere erregistroan file arazoak konpontzen laguntzeko. Erabili erregistro-maila desberdinak erregistroaren garrantzia adierazteko.
• SimApi batean inplementatu ez diren funtzioetarako "Inplementatu gabe" saioa erregistratzea gomendatzen da.

Erroreak kudeatzea

• SimApi batek datu-iturburuko eskaera bat bete ezin duenean, arazo hau bi modutan kudea dezake; falta diren balioak itzuliz (daturik ez) edo SimApi errore bat adieraziz:
• Deitzaileari falta diren balioak itzultzeak eta arrakastaren seinaleztapenak deitzaileak normalean jarraitzeko aukera ematen du (baina daturik gabe noski). Praktika gomendagarria da akats partzialetarako, esate baterako, batzuentzat datuak lor daitezkeenean, baina ez guztientzat. tags eskaera batean.
• SimApi errore bat seinaleztatzeak deitzen duenari aukera ematen dio (adibidezampSIMCA-online zerbitzaria) hau berehala ikusteko eta jarduteko. Praktika gomendagarria da guztiz huts egiten duten eta inolako daturik itzuli ezin duten eskaeretarako.
• SIMCA-online-k falta diren balioak edo errore-kodeak modu ezberdinean kudeatzen ditu, SIMCA-online Gida Teknikoan azaltzen den bezala.

SimApi errendimendu-eskakizunak

• SimApi-ko funtzioak datuak lortzeko erabiltzen dira.
• Datuen sarbidea motela bada, SimApi-k ez du ondo funtzionatuko, adibidezampLe erakusten du: SIMCA-online datuak segundoro eskatzen baditu, baina bi segundo behar baditu lortzeko, SIMCA-online zerbitzariak ezingo du inoiz denbora errealean jarraitu, baina pixkanaka gero eta atzerago geratuko da.
• Azpi-ataletan SIMCA eta SIMCA-online-k datuetarako sarbidea SimApi funtzioak nola erabiltzen dituzten erakutsiko dugu eta SimApi funtzioak zenbateko maiztasunarekin deituko diren. Honek SimApi inplementazio baten errendimendu-eskakizunak ezartzen lagun dezake.

SIMCAk SimApi funtzioen erabilera

• Mahaigaineko SIMCA edo lineaz kanpoko beste produktu batzuek SimApi bat erabiltzen dutenean datuak lortzeko, eskaera hauek denbora tarte jakin bateko aldagai multzo baterako sorta eta datuak prozesatzeko izango dira.
• Eskaera hauek erabiltzaile batek eskuz abiarazten dituenez, ez dira oso maiz gertatzen eta ez diote karga handirik eragiten datu-iturburu bati.
• SimApi funtzio hauek datuak lortzeko erabiltzen dira:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

SIMCA-online-k SimApi funtzioen erabilera

• SIMCA-online prozesu baten denbora errealean monitorizatzeko erabiltzen da, eta, horregatik, datuak eskatzen ditu SimApi-ren bidez aldizka. Erabil daitekeen exekuzio-tarte laburrena segundo 1 da. Mundu errealeko zenbait adibideampexekuzio-tarteen fitxategiak 10 s, 1 minutu edo 10 minutukoak dira.
• Zerbitzari batek proiektu asko izan ditzake aldi berean exekutatzen.
• SimApi-ren bidez API dei-kopurua murrizteko, zerbitzariak datu-eskaerak optimizatzen ditu aldi berean eskaera txikiago asko aldagai guztien eskaera handiago bakar batean bilduz aldi berean (lortu informazio gehiago "Datu iturrien irakurketa optimizatuak errendimendua hobetzen du" laguntza-gaian).
• Zerbitzariaren exekuzio algoritmoak honela funtzionatzen du behean zerrendatutako SimApi funtzioak erabiliz datuak eskatzen dituenean:
• Tarte berean exekutatzen diren fase guztiak SimApi dei bakarrean biltzen dira dei kopurua murrizteko. Zerbitzariak tartea partekatzen duten modelo guztiek erabiltzen dituzten aldagai guztien azken datuak irakurtzen ditu, hau da, deialdi honek datu errenkada zabala sortuko du eta gero proiektu guztiek erabiltzen dute.
  • simapi2_connectionReadCurrentData
• Batch-proiektu bakoitzeko zerbitzariak ere jakin behar du zein lote dauden aktibo. Hau ere proiektu bat exekutatzen den bakoitzean gertatu behar da:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes deitzen da gutxiagotan.
• Horrez gain, SIMCA-online-k datu historikoak ere eskatzen ditu. Eskaera hauek behar denean bakarrik gertatzen dira, hala nola SIMCA-online hasi baino lehen hasitako lote baten hasiera atzematea edo zerbitzaria atzeratuta dagoenean eta datu-bloke bat irakurri behar duenean:
  • simapi2_connectionReadHistoricalDataEx
• Aukeran, proiektuaren konfigurazio batzuek lote-datuak edo datu diskretuak erabiltzen dituzten ezaugarriak erabiltzen dituzte eta horrek SimApi-ren deiak sortzen ditu:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Aukeran, proiektuaren konfigurazio batzuek idazketa erabiltzen dute datuak datu-iturburura itzultzeko:
  • simapi2_connectionWriteHistoricalDataEx (eta dagozkien funtzioak batch datuetarako, datu diskretuak)
• Garrantzitsua da datuak lortzeko oinarrizko funtzioei dei bakoitza, readCurrentData, getActiveBatches/getBatchTimes, azkarra izatea eta hori ez da konputazionalki zaila datu-iturburuarentzat, SIMCA-online-k zenbateko maiztasunarekin dei dezakeen funtzio horiei.

SimApi datuak probatu eta baliozkotzea

• Atal hau SimApi bat probatzeari buruzkoa da, bertatik itzulitako datuak datu-iturburuko datuekin bat datozela egiaztatzeko. Horrelako probak egitea garrantzitsua da SimApi inplementazioa sortu edo aldatu ondoren, edo datu-iturburu baten APIa aldatzen denean.
• Praktikan, datuen baliozkotzea SIMCA-online eta bere Extract funtzionalitatea erabiliz egiten da datu-iturburuko datuak SimApi-ren bidez ateratzeko eta, ondoren, datu-iturburuko datu gordinak alderatzeko. Mahaigaineko SIMCA ezin da erabili SimApi baten denbora errealeko alderdiak probatzeko.

Prestaketak eta eskakizunak

• Elementu batzuk aukerakoak dira, baina egin daitezke zure probaren esparruak barne hartzen badu:

1. Instalatu SIMCA-online produktuaren zip-ean datorren ReadMe and Installation Guide.pdf-n deskribatzen den moduan.
2. Lortu SIMCA-online zerbitzarirako lizentzia bat eta instalatu. SimApi-k ez du funtzionatuko lizentziarik gabe. SIMCA-online-ren ezagutza-basearen artikuluak produktuaren lizentzia nola eman erakusten du. Adibidezample: SIMCA-online 18 (sartorius.com)
3. Instalatu eta konfiguratu probatu nahi duzun SimApi. Ikusi dokumentu honetako 4. – 5. kapituluetara eta SimApi espezifikoko erabiltzailearen gida.
   • a. Aukerakoa: ziurtatu erabiltzailearen gida eguneratua eta zuzena dela.
4. Ziurtatu zure datu-iturbururako tresna bat duzula SimApi-ren datuak konparatzeko erabil dezakezuna.
5. SIMCA-online mahaigaineko bezeroan, hasi saioa zure SIMCA-online zerbitzarian eta erabili File > Erauzi datuak SimApi-ren bidez lortzeko.
6. Aukerakoa zure proba-esparruak barne hartzen badu: probak amaitu ondoren, desinstalatu SimApi eta egiaztatu files kentzen dira.

Zer probatu

• 3. kapituluko ezaugarri-matrizeak eginbide posible guztiak zerrendatzen ditu, baina SimApi inplementazio jakin batek azpimultzo bat soilik onartzen du. Emandako SimApi-k inplementatzen dituen eginbide guztiak probatu behar dituzu.
• Proba hauek ohikoak dira SimApi inplementazio gehienetan:
• Erabiltzaile-izen eta pasahitzekin autentifikazioa
• Probatu hainbat ezarpen SimApi-ren konfigurazioan
• Nodoen hierarkia: nodoak eta tags SimApi-k azaldutakoak zuzenak dira.
  • bat egon behar du tag SimApi-ren bidez erabilgarri egon beharko luketen "aldagai" guztientzat agerian. Adibamples: prozesu-neurketak, kalkulatutako balioak, konstanteak.
• Konexioaren erresilientzia: datu-iturburua erabilgarri ez badago, horrek abisuak edo akatsak sortzen ditu erregistroan file, baina datu-iturbururako konexioa automatikoki berrezartzen dela datu-iturburua erabilgarri dagoenean.
• Instantzia anitz: bi instantzia independentean eta aldi berean konfiguratu eta erabil daitezkeela, erregistro bereiziekin files.
• Uneko datuak: atera uneko datuak tags. Ziurtatu datuak datu-iturburutik ezagutzen diren azken balioak direla, edo falta direla kalitate txarragatik edo datuak zaharregiak direnean.
  • Atera datuak 10 segundoro (edo) minutu batez.
• Datu historiko jarraituak: datu historikoak ateratzeko tags.
  • Erabili uneko datuak atera dituzunean bat datorren denbora tartea. Egiaztatu uneko datuak bat datozela datu historikoekin eta datu-iturburuko datu gordinak.
  • Saiatu denbora tarte eta s desberdinakampling tarteak, egiaztatu datuak datu-iturburuarekin bat datozela.
  • Saiatu datuak ateratzen 1 s behin, hau da, ahalik eta s laburrenaampling tartea.
  • Saiatu hainbat motatakoak tags datu-iturburuan (prozesu-aldagaiak, etab.), datuak bat datozela ziurtatuz.
  • Oharra: SIMCA-online-k datu historiko handien eskaera bakar bat zati txikiagotan zati dezake. Hau SimApi erregistroan egongo da ikusgai.
• Egiaztatu SimApi-k testu-datuekin, zenbakizko datuekin eta falta diren datuekin funtzionatzen duela.
• SimApi erregistroa file. Egiaztatu erregistroak arrazoizko sarrerak dituela.
• Batch nodoa: egin klik eskuineko botoiarekin nodo batean eta egin Bilatu loteak.
  • Egiaztatu loteen izenak, hasiera-orduak eta loteen amaiera-orduak.
  • Probatu datu-iturburuan exekutatzen ari den lote aktibo bat. Ez luke amaiera-ordurik izan behar SimApi-ren bidez.
• Prozesu-nodoaren lote-identifikatzailea tag. SimApi-k lote-nodoen funtzionaltasuna badu (ikus aurreko buleta), lotearen identifikatzaile bat ere izan behar du tag bat etortzeko prozesuaren datu-nodoan. Horretarako datuak tag lotearen identifikatzailea (lotaren izena) izan behar du. Datu horiek beharrezkoak dira batch-proiektuek datu-lerro bat zein loteri dagokion identifikatzeko.

SimApi-k onartzen duen ala ez, baliteke proba ere egin nahi izatea:

• Batch datuak erabiliz File > Atera.
• Datu diskretuak erabiliz File > Atera. Oharra: datu diskretuak probatzeko File > Erauzi nodoa, batch nodoa eta datu diskretuen nodoa SimApi berean egon behar dute (SIMCA-online proiektuak exekutatzen dituenean, SimApis ezberdinetakoak izan daitezke).
• Idatzi berriro - datu-sorta datu-iturburura bultzatzea. Hau probatzeko, proiektuaren konfigurazio bat konfiguratu behar duzu SIMCA-online-n datu-bektoreak datu-iturburuan idazteko. Ondoren, exekutatu proiektua SIMCA-online-n eta egiaztatu datu-iturburuan berriro idatzitako datuak.
• Etengabeko datuak Evolution Write Back orrian konfiguratzen dira proiektuaren konfigurazioan.
• Datu diskretuak orri berean konfiguratzen dira, baina datu diskretuak berreskuratzeko konfiguratutako fase baterako soilik.
• Batch Write back-eko lotearen datuak

INFORMAZIO GEHIAGO

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Suedia
• Telefonoa: + 46 90-18 48 00
• www.sartorius.com
• Argibide hauetan jasotako informazioa eta zifrak behean zehaztutako bertsio-datarekin bat datoz.
• Sartorius-ek ekipoaren teknologian, ezaugarrietan, zehaztapenetan eta diseinuan aldaketak egiteko eskubidea du abisurik gabe. Argibide hauetan irakurgarritasuna errazteko forma maskulinoak edo femeninoak erabiltzen dira eta beti aldi berean genero guztiak adierazten dituzte.
  Copyright-oharra:
• Argibide hauek, osagai guztiak barne, copyright bidez babestuta daude.
• Egile-eskubideen legearen mugetatik kanpo ez da onartzen gure baimenik gabe.
• Berrargitalpen, itzulpen eta edizioetan aplikatzen da bereziki, erabilitako euskarri mota edozein dela ere.

Ohiko galderak

• G: Zein da SimApis-en helburua?
  • E: SimApis-en helburu nagusia Umetrics Suite produktuei datuak ematea da, proiektuak sortzeko eta ereduak eraikitzeko.
• G: Nola konpondu ditzaket arazoak SimApi instalazio batekin?
  • E: Arazoak konpon ditzakezu SIMCA-online-tik probatuz, SimApi erregistroa egiaztatuz file, eta zerbitzu-kontuaren konfigurazio zuzena ziurtatzea.