SARTORIUS Sim Api Software

Specifikimet

• Emri i produktit: SimApi Guide
• Data e publikimit: 5 shtator 2024
• Qëllimi: Siguroni të dhëna për produktet e Umetrics Suite

Udhëzimet e përdorimit të produktit

Hyrje në SimApis

• SimApis përdoren për të marrë të dhëna për krijimin e projektit dhe ndërtimin e modeleve në produktet Umetrics Suite.

Marrja e SimApis

• Për të marrë SimApis, referojuni dokumentacionit zyrtar ose kontaktoni mbështetjen e klientit për ndihmë.

Karakteristikat e SimApi

• SimApis ofron të dhëna në kohë reale për monitorimin, kontrollin dhe ndërtimin e modeleve në SIMCA dhe SIMCA-online.

Vetëm përdorimi aktual i të dhënave

• Rekomandohet të përdorni vetëm të dhënat aktuale dhe të shmangni të dhënat historike për performancë optimale.

Përgatitja për një instalim SimApi

• Përpara instalimit, sigurohuni që sistemi juaj të plotësojë kërkesat minimale të specifikuara në udhëzuesin e përdoruesit.

Instalimi i një SimApi

• Ndiqni udhëzimet hap pas hapi të dhëna në manualin e përdoruesit për të instaluar SimApi në sistemin tuaj.

Konfigurimi i SimApi për SIMCA

• Konfiguro cilësimet e SimApi në SIMCA sipas udhëzimeve të dhëna.

Konfigurimi i SimApi për SIMCA-online

• Konfiguro SimApi për rikthimin e të dhënave në kohë reale dhe operacionet e rikthimit në SIMCA-online.

Testimi dhe zgjidhja e problemeve

• Pas instalimit, kryeni testimin për të siguruar funksionimin e duhur. Në rast problemesh, referojuni seksionit të zgjidhjes së problemeve në udhëzuesin e përdoruesit.

Testimi nga SIMCA-online

• Testoni integrimin SimApi nga SIMCA-online për të verifikuar marrjen e të dhënave.

Zgjidhja e problemeve me Log Files

• Përdorni regjistrin e SimApi file për të identifikuar dhe zgjidhur çdo problem instalimi ose funksionimi.

Konfigurimi i llogarisë së shërbimit

• Siguroni konfigurimin e saktë të llogarisë së shërbimit SIMCA-online për funksionim pa probleme.

Detajet Teknike

• Referojuni seksionit 7 të udhëzuesit të përdorimit për informacion të thelluar teknik mbi SimApis.

Hyrje në SimApis

• Një SimApi është një ndërfaqe softuerike midis softuerit Umetrics® Suite dhe një burimi të dhënash. Qëllimi kryesor i një SimApi është të sigurojë të dhëna për SIMCA®-online ose SIMCA®.
• Sartorius Stedim Data Analytics AB zhvillon SimApis për shumë burime të ndryshme të të dhënave, si historianët e proceseve dhe bazat e të dhënave për qëllime të përgjithshme.
• Ky dokument tregon se çfarë është një SimApi dhe si përdoret në produktet Umetrics Suite. Do të mësoni se si të planifikoni dhe instaloni një SimApi, si të zgjidhni problemet dhe si të testoni instalimin tuaj. Kapitulli i fundit përmban detaje teknike të SimApis që synojnë zhvilluesit.

Qëllimi i SimApi: të sigurojë të dhëna për produktet e Umetrics Suite

• Qëllimi kryesor i një SimApi është të sigurojë të dhëna për SIMCA-online ose SIMCA nga një burim të dhënash. Burimi i të dhënave nuk është pjesë e SIMCA-online, por mund të jetë një historian procesi ose një sistem tjetër që ruan dhe menaxhon të dhënat.
• Një SimApi ekspozon një hierarki nyjesh, që korrespondojnë me dosjet në a file sistemi. Çdo nyje mund të përmbajë nyje të tjera, ose tags. A tag korrespondon me një ndryshore. Për këto tags, mund të merren të dhëna. Fotografia tregon një tag, Temp, e zgjedhur në nyjë
• BakersYeastControlGood në një burim të dhënash në SIMCA-online. Ai gjithashtu tregon vlerat më të fundit të marra nga burimi i të dhënave.

Përdorimi i SimApi në Umetrics Suite

• Softueri i desktopit SIMCA mund të përdorë një SimApi për të marrë të dhëna për krijimin e projektit dhe ndërtimin e modelit, siç ilustron fotografia e mëposhtme.
• SIMCA-online përdor SimApis për të marrë të dhëna në kohë reale për monitorim dhe kontroll, si dhe për të shkruar të dhënat në burimin e të dhënave. Fotografia e mëposhtme tregon se ku ndodhet SimApi në një sistem të përbërë nga një burim të dhënash, serveri SIMCA-online dhe klientë.

SimApis i përdorur zakonisht

• SimApis më të përdorura janë:
• PI AF SimApi për t'u lidhur me sistemet PI Aveva (dikur OSIsoft).
• OPC UA SimApi
• ODBC SimApi – për qasje të përgjithshme në bazat e të dhënave si SQL Server ose Oracle
• Të gjitha SimApi-t e disponueshme janë renditur së bashku me veçoritë e tyre në paragrafin 3.

DBMaker SimApi për të dhënat e simulimit

• DBMaker është një aplikacion i ofruar me instalimin e serverit SIMCA-online. Ai simulon një burim të dhënash, si një historian procesi, duke përdorur një tabelë të dhënash të ngarkuar paraprakisht, ku vëzhgimet ofrohen një nga një në SIMCA-online përmes DBMaker SimApi.
• DBMaker përdoret vetëm për qëllime demonstrimi dhe nuk mund të përdoret në prodhim me të dhëna të drejtpërdrejta nga një burim të dhënash. Shikoni ndihmën e integruar për të mësuar më shumë rreth DBMaker.

Dokumentacion shtesë

• Ky dokument është një nga një sërë dokumentesh të ndërlidhura, secili me një fokus dhe audiencë të ndryshme të synuar:

Burimi	Çfarë	Ku
SIMCA-në internet web faqe	Informacion prezantues dhe shkarkime	sartorius.com/umetrics-simca- online

SIMCA-online ReadMe and Installation.pdf	Instalimi dhe si të filloni me të dhënat demo në internet SIMCA	Në zip instalimi file
SIMCA-online Udhëzues Zbatimi	Përvijon funksionalitetin SIMCA-online, e vendos atë në kontekst me softuerët e tjerë Umetrics Suite, përshkruan kërkesat dhe praktikat më të mira për vendosjen e suksesshme dhe udhëzimet hap pas hapi të instalimit.	sartorius.com/umetrics-simca- online
Udhëzues SimApi	Përgatitja dhe kryerja e instalimeve SimApi, duke përfshirë zgjidhjen e problemeve. Gjithashtu përmban detaje teknike në SimApis për zhvilluesit.	sartorius.com/umetrics-simapi
Udhëzuesit e përdorimit të SimApi	Dokumentacioni për çdo SimApi të publikuar me veçori, udhëzime instalimi dhe specifika të konfigurimit.	sartorius.com/umetrics-simapi
Udhëzues Teknik SIMCA-online	Referencë teknike për planifikimin e instalimit të serverit SIMCA-online, zgjidhjen e problemeve dhe në thellësi se si funksionon SIMCA-online.	sartorius.com/umetrics-simca-online
Ndihmë SIMCA-online	Web-ndihmë e bazuar se si të përdorni SIMCA-online dhe si funksionon SIMCA-online.	Në vetë softuerin dhe me radhë sartorius.com/umetrics-simca
SIMCA-në internet Web Udhëzuesi i instalimit të klientit	Përshkruan instalimin e SIMCA-online Web Klient	sartorius.com/umetrics-simca-online
Baza e njohurive për Umetrikën	Baza e të dhënave e kërkueshme me artikuj për çdo version të lëshuar të softuerit, artikuj teknikë dhe çështje të njohura në produktet e Umetrics Suite.	sartorius.com/umetrics-kb
Ndihma/udhëzuesi i përdorimit të SIMCA	Si të përdorni SIMCA desktop për krijimin e projekteve dhe modelimin e të dhënave.	Në SIMCA dhe në vazhdim sartorius.com/umetrics-simca
Mbështetje web faqe	Si të merrni mbështetje teknike.	sartorius.com/umetrics-support

Mbështetje teknike

• Ekipi i mbështetjes në internet i Sartorius u përgjigjet pyetjeve teknike në lidhje me SimApis dhe gjithashtu mund të përcjellë kërkesat për përmirësimin e SimApis tek njerëzit e duhur. Mësoni më shumë në sartorius.com/umetrics-support.

Marrja e SimApis

• Ne ofrojmë dokumentacion për SimApis të disponueshëm dhe lidhje me programet e instalimit në sartorius.com/umetrics-simapi.
• Çdo SimApi është i dokumentuar në Udhëzuesin e tij të Përdoruesit.
• Udhëzuesi SimApi, të cilin po e lexoni jo, e plotëson atë informacion me informacionin plotësues të SimApi kur bëhet fjalë për planifikimin, instalimin dhe zgjidhjen e problemeve të SimApi.

Karakteristikat e SimApi

• Jo të gjitha burimet e të dhënave janë të njëjta. Një SimApi nuk ka nevojë të zbatojë të gjitha funksionet në specifikim. Për këto arsye, SimApis të ndryshëm ofrojnë funksionalitete të ndryshme. Matrica e mëposhtme liston SimApis të disponueshme dhe veçoritë e tyre.
• Karakteristikat janë shpjeguar më poshtë. Vini re se tabela ka kolona të veçanta për të treguar se cilat veçori janë të disponueshme përkatësisht në SIMCA-online dhe SIMCA.

Veçori	Qëllimi	Përdorimi në internet i SIMCA	Përdorimi i SIMCA
Të dhënat aktuale	Lexoni një vëzhgim të vetëm me vlerën më të fundit nga burimi i të dhënave.	Ekzekutimi normal në kohë reale	–
Të dhëna historike	Lexoni shumë vëzhgime menjëherë me të dhëna historike nga burimi i të dhënave.	Kapni dhe parashikoni të dhënat e kaluara, krijoni projekte duke përdorur File > E re	Baza e të dhënave Import Wizard për të importuar të dhënat e procesit për krijimin e modelit.
Të dhëna diskrete	Lexoni të dhënat e laboratorit/IPC nga burimi i të dhënave. Shumë vëzhgime për grup.	Për projektet e grupeve me faza ose kushte grupi të konfiguruara për marrjen e të dhënave diskrete.	–
Të dhënat e grupit	Lexoni kushtet e grupit dhe atributet përfundimtare të cilësisë (ose	Kushtet e grupit ose përqendrimi lokal.	Magjistari i importit të bazës së të dhënave për të lexuar kushtet e grupit

Veçori	Qëllimi	Përdorimi në internet i SIMCA	Përdorimi i SIMCA
	të dhëna të tjera të tipit MASH). Një vëzhgim për grup.		krijimi i modelit në nivel grupi.
Nyja e grupit	Specifikoni kohën e fillimit dhe kohën e përfundimit (bosh për një grup aktiv) për një grup specifik. Numëroni të gjitha grupet që ekzistonin në një interval kohor.	Kërkohet për ekzekutimin e konfigurimeve të grupit.	Magjistari i importit të bazës së të dhënave për të zgjedhur grupe për import.
Shkruaj prapa - të dhëna të vazhdueshme	Shkruani të dhëna të vazhdueshme, të tilla si parashikimet, përsëri në burimin e të dhënave.	Shkruani të dhënat nga niveli i evolucionit të grupit, për Këshilltarin e Kontrollit ose për konfigurime të vazhdueshme	–
Shkruaj përsëri - diskrete	Shkruani të dhëna diskrete, të tilla si parashikimet, përsëri në burimin e të dhënave.	Shkruaj përsëri për konfigurimet e grupit në nivelin e evolucionit të grupit për fazat e konfiguruara për marrjen e të dhënave diskrete	–
Shkruani përsëri - të dhënat e grupit	Shkruani të dhënat e nivelit të grupit, të tilla si parashikimet ose atributet përfundimtare të cilësisë, në burimin e të dhënave.	Shkruani përsëri për konfigurimin e grupit në nivelin e grupit	–
Hierarkia e nyjeve	SimApi mbështet një hierarki nyjesh, ngjashëm me a file sistemi. Çdo nyje mund të përmbajë tags dhe nyje të tjera. Hierarkia e bën më të lehtë menaxhimin e një numri të madh nyjesh dhe tags.	Mbështetur në të gjitha vendet ku tags përdoren.
Array tag zgjerimi	Një grup tag ruan vlera të shumta. SimApi zgjeron grupin tag për shumë individë tags, një për çdo element në grup.	Mbështetur ku tags përdoren për të dhëna të vazhdueshme. Secili u zgjerua tag duhet të hartohet në një variabël në projektin SIMCA.
Burime të shumta të të dhënave	SimApi mund të lidhet me më shumë se një burim të vetëm të dhënash ose të mbështet shembuj të shumtë të vetvetes me cilësime dhe regjistra individualë files për çdo rast.	Lidhu me disa burime të ndryshme të dhënash të të njëjtit lloj.	–
Rezistenca e lidhjes	Nëse SimApi shkëputet nga burimi i të dhënave, ai do të përpiqet të rivendosë lidhjen automatikisht.	SimApi nuk duhet të riniset për të rivendosur lidhjet me burimin e të dhënave.	–
Zhvilluar në shtëpi	SimApi është zhvilluar, ofruar dhe mbështetur nga

Vetëm të dhënat aktuale, pa të dhëna historike, nuk rekomandohen

• Disa SimApis, veçanërisht OPC DA, mbështet vetëm leximin e të dhënave aktuale dhe jo të dhënave historike.
• Një SimApi që mbështet vetëm të dhënat aktuale nuk mund të përdoret në SIMCA desktop, sepse nuk do të jetë në gjendje të lexojë të dhëna historike mbi të cilat do të ndërtohen modelet.
• Për SIMCA-online, ne rekomandojmë fuqimisht një burim të dhënash dhe SimApi që ofrojnë jo vetëm të dhëna aktuale për ekzekutim në kohë reale, por edhe të dhëna historike për të qenë në gjendje të parashikojnë dhe kapin të dhënat e kaluara. SIMCA-online kalon automatikisht ndërmjet të dhënave në kohë reale dhe të dhënave historike sipas nevojës dhe kjo nuk mund të çaktivizohet.
• Një burim i të dhënave që ofron vetëm të dhëna aktuale, por jo të dhëna historike, mund të funksionojë për projekte të vazhdueshme në SIMCA-online, por për projektet e grupit kërkohen të dhëna historike.

Përgatitja për një instalim SimApi

• Ky seksion përshkruan informacione të rëndësishme për një instalim të suksesshëm të një SimApi.

SimApis 64-bit ose 32-bit

• Ekzistojnë versione 32-bit dhe 64-bit të secilit SimApi.
• SIMCA-online dhe SIMCA janë 64-bit dhe kërkojnë variantet 64-bit SimApis. SimApis 32-bit i trashëguar janë ende në dispozicion për instalimet e vjetra.

Vendndodhja për regjistrin file dhe cilësimet

• Një SimApi ruan regjistrin e tij files në dosjen e fshehur të të dhënave të programit1:
  %programdata%\Umetrics\SimApi, ku %programdata% përshtatet në dosjen aktuale në kompjuterin tuaj. Parazgjedhja është në C:\ProgramData.
• Çdo SimApi zakonisht përdor regjistrin e vet file, i cili në mënyrë të ngjashme me regjistrin e serverit SIMCA-online file do të përmbajë pak a shumë të dhëna në varësi të cilësimeve të nivelit të regjistrit. Kjo file është i dobishëm për zgjidhjen e problemeve. Regjistri file është emërtuar
  .log ku është SimApi që po instaloni, p.shample PIAFSimApi. Shihni gjithashtu seksionin tjetër për emrat e shembujve SimApi në internet SIMCA.
• Kjo dosje përmban gjithashtu cilësimet SimApi në një XML file emërtuar .xml.
• Shumica e SimApis kanë ndërfaqe grafike të përdoruesit që ndryshojnë cilësimet në xml file, por për disa ju futni ndryshimet drejtpërdrejt në XML file me një redaktues teksti, siç është Notepad. Shihni udhëzuesin e përdoruesit për çdo SimApi.

File emrat kur instancat e emërtuara përdoren me SIMCA-online

• Në SIMCA-online, çdo shembull SimApi merr konfigurimin e vet file dhe log file për të punuar me instanca të shumta të secilit SimApi. Emrat e këtyre files janë prapashtesë me emrin e shembullit siç është dhënë në skedën SimApi në dialogun SIMCA-online Server Options.
• Ish-i i mëposhtëmample tregon emërtimin e këtyre files, ku duhet të zëvendësohet me emrin SimApi.
• Emri i konfigurimit jepet kur shtohet shembulli: OmegaServer
• Konfigurimi file emri: OmegaServer.xml
• Regjistrohu file emri: OmegaServer.log
• Vini re se gjenerike file .log file është krijuar ende. Ky regjistër file përmban shënime që për arsye teknike nuk mund të drejtohen në regjistër file e rasteve..
• Kjo dosje është e fshehur në Windows si parazgjedhje. Për ta parë atë në File Explorer që ju konfiguroni të shfaqet i fshehur files. Vini re se mund të lundroni në një dosje të fshehur duke shtypur një adresë File Shiriti i adresave të Explorer.
• Vini re se SIMCA nuk mbështet instanca të shumta të SimApi, dhe për këtë arsye përdor emrat pa emrin e shembullit siç përshkruhet më sipër.

Planifikimi i rrjetit

• Ju duhet të gjeni serverin SIMCA-online afër burimit të të dhënave në rrjet. Kjo siguron një lidhje të shpejtë midis SIMCA-online dhe burimit të tij të të dhënave.
• Pajisjet e rrjetit mund të ndërhyjnë në lidhjen midis SIMCA-online dhe burimit të të dhënave.

Llogaritë e përdoruesve dhe lejet e burimit të të dhënave

• Burimet e të dhënave zakonisht kontrollojnë aksesin në të dhënat e tyre. Kjo zakonisht bëhet me emrat e përdoruesve dhe fjalëkalimet, por mund të përdoren gjithashtu kufizime të bazuara në adresën IP ose DNS (p.sh.ample PI Trusts në Aveva PI System).
• Emri i përdoruesit dhe fjalëkalimi mund t'i jepen burimit të të dhënave në mënyra të ndryshme:
• Një SimApi ekzekutohet si përdorues i Windows i përdoruesit që ekzekuton SIMCA desktop ose llogarinë e shërbimit SIMCA-online në kompjuterin e serverit. SimApi mund të lidhet me burimin e të dhënave duke përdorur këtë llogari. Kështu funksionojnë OPC I dhe PI SimApi, dhe ODBC nëse nuk jepni kredencialet kur e konfiguroni atë.
• Për ODBC gjenerike mund të përdorni aplikacionin ODBC Data Sources Administrator që gjendet në Start në Windows.
• Disa ofrues të bazës së të dhënave ofrojnë drejtuesit dhe mjetet e tyre për bazat e të dhënave të tyre. Bazat e të dhënave Oracle, për shembullample, përdorni Oracle Data Access Components (ODAC).
• Disa SimApis, të tilla si PI AF dhe ODBC, kanë dialog konfigurimi që ruajnë kredencialet e koduara në konfigurimin SimApi XML file.
• PI ka gjithashtu opsione të ndryshme sigurie të disponueshme në Veglat e Menaxhimit të Sistemit PI në kompjuterin e serverit PI. Lexoni më shumë në Udhëzuesin e Përdoruesit PI AF SimApi. Ky udhëzues është i dobishëm edhe nëse përdorni OSIsoft PI SimApi më të vjetër.
• OPC DA dhe HDA përdorin DCOM si transport midis një burimi të dhënash dhe SimApi. DCOM është konfiguruar me mjetin e Shërbimeve të Komponentit (DCOMCNFG.EXE) në Windows dhe përdor vërtetimin e Windows.
• Për OSIsoft PI SimApi më i vjetër (jo SimApi AF më i ri), aplikacioni OSIsoft AboutPI-SDK (PISDKUtility.exe) përdoret për të konfiguruar lidhjen me serverin PI.

Verifikimi i lidhjes së burimit të të dhënave
Kur dëshironi të instaloni një SimApi në një kompjuter, mund të jetë e dobishme të verifikoni lidhjen nga ai kompjuter me burimin e të dhënave me një mjet tjetër:

• Burimet e të dhënave ODBC në Windows përdoren për të konfiguruar dhe testuar ODBC gjenerike. Vini re se ekzistojnë dy versione të këtij mjeti në Windows 64-bit: një për aplikacionet 32-bit dhe një për 64-bit. Përdorni butonin Test Burimi i të Dhënave në fund të magjistarit të konfigurimit ODBC për të verifikuar lidhjen me bazën e të dhënave. Ne ju rekomandojmë që të konfiguroni burimet tuaja të të dhënave si DSN të sistemit.
• Një mjet lidhjeje specifike për bazën e të dhënave nga ofruesi i bazës së të dhënave, siç është Oracle Data Access Components.
• PI System Explorer mund të përdoret për të testuar lidhjen me serverin PI AF. Është pjesë e klientit PI AF që është një parakusht për PI AF SimApi.
• OPC UA Expert nga Unified Automation – UaExpert është një klient testimi ndër-platformë për serverët OPC UA.
• Aplikacioni PI-SDK (PISDKUtility.exe) mund të përdoret për të testuar lidhjen dhe për të view çdo mesazh gabimi që mund të jetë regjistruar kur SIMCA-online përpiqet të lidhet me serverin PI. Kjo përdoret vetëm për OSIsoft SimApi më të vjetër, jo PIAF.
• Mjetet e menaxhimit të sistemit PI përdoren në kompjuterin e serverit PI për zgjidhjen e problemeve nga ajo anë. Për shembullample, për të kërkuar çështje sigurie që pengojnë aksesin nga serveri SIMCA-online. Mësoni më shumë për zgjidhjen e problemeve të sistemit PI në këtë video në YouTube.
• Excel mund të përdoret për të marrë të dhëna nga një lidhje ODBC dhe nga shumica e sistemeve të tjera kur instalohet një shtesë e përshtatshme.
• Matrikon OPC Explorer për Ior HDA (këto janë mjete të veçanta) mund të përdoret për të testuar lidhjen OPC dhe Matrikon OPC Analyzer mund të përdoret për të diagnostikuar problemet e lidhjes OPC. Shkarkoni këto mjete falas nga https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (për DInd HDA) nga Instituti i Trajnimit OPC web faqja “u mundëson përdoruesve të diagnostikojnë lehtësisht problemet e komunikimit dhe sigurisë dhe t'i riparojnë ato në çast me shtypjen e një butoni. E gjithë kjo mund të bëhet pa pasur nevojë të mësoni të konfiguroni DCOM"

Instalimi i një SimApi

Ja se si të instaloni një SimApi në një PC:

1. Lexoni Udhëzuesin e Përdoruesit për SimApi që po instaloni. Ai përmban specifika për atë SimApi që plotësojnë udhëzimet e përgjithshme që po lexoni tani.
2. Instaloni dhe konfiguroni çdo kusht paraprak të përmendur në Udhëzuesin e Përdoruesit SimApi (për shembullampdrejtuesit e bazës së të dhënave ose SDK-të)
3. Drejtoni programin e konfigurimit për të instaluar SimApi. Instaloni versionin 64-bit (x64) ose 32-bit (x86) që përputhet me softuerin ku do ta ekzekutoni.
4. Konfiguroni SimApi në SIMCA-online ose SIMCA siç përshkruhet në seksionet e mëposhtme dhe referojuni udhëzuesit të përdoruesit të SimApi për përshkrimet e cilësimeve të disponueshme.
5. Nisni serverin SIMCA-online. Vini re se kjo mund të marrë kohë, sepse kur SimApi të inicializohet, ai do t'i numërojë të gjitha tags në burimin e të dhënave.
6. Testoni SimApi duke marrë disa të dhëna. Për SIMCA-online, mund të përdorni File > Ekstrakt siç përshkruhet në 6.1.
7. Nëse SimApi nuk funksionon siç pritej, referojuni regjistrit SimApi files për zgjidhjen e problemeve dhe në udhëzuesin e përdoruesit SimApi.

Konfigurimi i SimApi për përdorim në SIMCA

Ja se si të përdorni SimApi në SIMCA:

1.  Filloni importimin e bazës së të dhënave në një nga mënyrat e mëposhtme:
   • a. Për të krijuar një projekt të ri në SIMCA: File > Projekti i ri i rregullt ose Projekti i grupit të ri. Zgjidhni Nga baza e të dhënave në skedën Home.
   • b. Për të importuar një grup të dhënash në një projekt ekzistues në SIMCA: Nga grupi i të dhënave në skedën Të dhëna të një projekti të hapur SIMCA.
2. Klikoni Shto burim të ri të dhënash
3. Zgjidhni SimApi si lloj lidhjeje, klikoni në butonin … dhe gjeni vendndodhjen .dll në dosjen e instalimit dhe klikoni Hap.
4. Klikoni Konfiguro dhe referojuni udhëzuesit individual të përdoruesit SimApi se si të bëni cilësimet.
5. Klikoni lidhjen e burimit të të dhënave Test për të verifikuar që mund të lidheni me bazën e të dhënave. Kjo mund të zgjasë shumë nëse ka shumë tags në burimin e të dhënave.
6. Kliko OK për të përfunduar konfigurimin.
7. Referojuni ndihmës SIMCA për mënyrën e punës me të dhënat e importuara.

Konfigurimi i SimApi për përdorim në SIMCA-online

• E rëndësishme: Për të qenë në gjendje të përdorni një SimApi, kërkohet një licencë e serverit SIMCA në internet. Një instalim demo i SIMCA-online nuk lejon përdorimin e SimApis.
• Për të shtuar një SimApi në sistem, ju ekzekutoni opsionet e serverit SIMCA-online në kompjuterin e serverit. Mësoni hapat e detajeve në temën e ndihmës SICMA-online Shtoni dhe konfiguroni një SimApi në server.
• Këshillë: Nëse bëni ndryshime për një SimApi, mund ta rinisni atë SimApi veçmas nga "Opsionet e serverit" pa rifilluar të gjithë serverin.
• Për të konfiguruar shembuj të shumtë të këtij SimApi, përsëritni hapat e mësipërm dhe përdorni emra unikë për secilin shembull. Lexoni më shumë rreth regjistrit dhe konfigurimit të ndryshëm files për rastet në 4.2.

Testimi dhe zgjidhja e problemeve të një SimApi

• Ky kapitull ka të bëjë me testimin dhe zgjidhjen e problemeve të një instalimi SimApi.

Testimi i një SimApi nga SIMCA-online

• Pasi serveri SIMCA-online të jetë nisur me sukses, ju mund të testoni SimApi-n tuaj në SIMCA-online (nëse serveri nuk fillon, shihni 6.2):
• Hyni në server në klientin SIMCA-online dhe lundroni te Ekstrakt në File skedën. Ekstrakt ju ndihmon të testoni SimApi duke marrë të dhëna përmes tij:
• Nyjet (“dosjet”) të SimApi shfaqen në kutinë e majtë. Tags për nyjen e zgjedhur shfaqen lart djathtas.
• Të dhënat aktuale mund të testohen shpejt thjesht duke klikuar view> në tags që ofrojnë të dhëna të vazhdueshme të procesit (shih pamjen e ekranit)
• Klikoni me të djathtën në një nyje për të gjetur grupe brenda një intervali kohor. Nyja duhet të jetë një nyje grupi që di për grupet.
• Zgjidhni tags në Ekstrakt dhe klikoni Next dhe përfundoni magjistarin për të marrë të dhëna duke përdorur mënyra të ndryshme të marrjes së të dhënave: të dhëna aktuale, historike, grupore dhe diskrete.
• Krahasoni të dhënat e nxjerra me atë që shihni në burimin tuaj të të dhënave duke përdorur mjetet e tij. Mësoni më shumë për testimin dhe vërtetimin e të gjitha veçorive të një SimApi në 7.13.

Zgjidhja e problemeve të SimApi duke përdorur regjistrin e SimApi file

• Nëse serveri nuk fillon, SimApi nuk funksionon siç pritej ose ekstrakti dështon, duhet të konsultoheni me regjistrin e SimApi file e cila ju tregon se cili është problemi. Aktivizo regjistrimin e nivelit të korrigjimit në regjistrin e SimApi për të marrë detaje të plota. Shih 4.2.
• Shënim: regjistrat e serverëve SIMCA-online nuk janë aq të dobishëm këtu. Ata do të tregojnë se si SimApi është ngarkuar dhe inicializuar nga serveri, por detajet specifike të SimApi janë në regjistrin e tij file.

Përdorni llogarinë e duhur të shërbimit SIMCA-online

• Kur jeni duke testuar aksesin në burimin e të dhënave, mbani mend se jeni identifikuar si një përdorues specifik në kompjuterin e serverit (zakonisht llogaria juaj e përdoruesit në një domen Windows), por që llogaria e shërbimit të serverit në internet SIMCA është një llogari tjetër, si parazgjedhje LocalSystem, e cila ka të drejta të ndryshme aksesi në krahasim me llogarinë tuaj të përdoruesit.
• Për këtë arsye, nuk është e pazakontë që testet të funksionojnë kur ekzekutohen si llogaria juaj, por që SIMCA-online dështon të lidhet me burimin e të dhënave.
• Për të zgjidhur këtë problem, duhet të jepet qasja për llogarinë e përdorur nga shërbimi i serverit SIMCA-online. Në mënyrë tipike, ju ndryshoni LocalSystem në një llogari të veçantë shërbimi domeni dhe jepni të drejta për këtë llogari. Vini re se kjo nuk zbatohet nëse SimApi përdor kredencialet që janë vendosur në konfigurimin e SimApi sepse këto kredenciale kanë përparësi.

Detaje teknike në SimApis

• Ky kapitull jep detaje teknike se si funksionon një SimApi. Ai u drejtohet kryesisht zhvilluesve që duan të kuptojnë SimApis për të zbatuar një SimApi për një burim të dhënash.
• Zhvilluesit duhet të lexojnë gjithashtu pjesët e mëparshme të këtij dokumenti për një hyrje në SimApis dhe në përshkrimet e nivelit të lartë të veçorive.

Kur të mendoni për zhvillimin e një SimApi dhe kur jo?

Përpara se të shqyrtoni zhvillimin e një SimApi për një burim të dhënash:

1. Hetoni nëse tashmë ekziston një SimApi që mund të përdorni. Ndoshta mund të aktivizoni ndonjë veçori në burimin tuaj të të dhënave për të përdorur një nga SimApi-t ekzistues, siç është OPC UA.
2. Kaloni me kujdes këtë dokument dhe referencat e tij dhe hetoni nëse burimi juaj i të dhënave plotëson kërkesat: p.shampLe, duhet të jetë mjaft i shpejtë, të sigurojë jo vetëm të dhëna aktuale, por edhe të dhëna historike.

• Për këto arsye, ne nuk rekomandojmë zhvillimin e një SimApi që lidhet me pajisje ose instrumente të nivelit të ulët. Është më mirë t'i lidhni ato instrumente me një historian procesi siç është Aveva PI System, dhe ta lini të marrë të dhëna nga instrumenti dhe t'i tregojë ato në histori. Pastaj PIAF SimApi mund të përdoret për të marrë të dhëna nga PI në produktin Umetrics.

Zhvillimi i SimApi dhe specifikimi SimApi

• Specifikimi SimApi, SimApi-v2, përmban dokumentacion për të gjitha funksionet C në SimApi që duhet të zbatojë një DLL SimApi, si dhe disa udhëzime se si të zhvillohet një SimApi.
• Zbatimi i një SimApi duke përdorur C ose C++ është në shumicën e rasteve në një nivel të ulët të panevojshëm.
• Mënyra e rekomanduar dhe më e lehtë për të zbatuar një SimApi është ta bazoni atë në ExampKodi burimor leSimApi që ne ofrojmë. Është një ishampLe implementimi SimApi që trajton ndërfaqen C dhe e përkthen atë në.NET Framework ku realizohet zbatimi aktual. Ai gjithashtu ka kodin e kornizës për regjistrimin, cilësimet, GUI-në e konfigurimit dhe kode të tjera të kornizës.
• Për të zhvilluar një SimApi, ekipi i zhvilluesve ka nevojë për përvojë në zhvillimin e Windows, .NET Framework, C ose C++. Kërkohet gjithashtu njohuri e mirë e burimit të të dhënave me të cilin duhet të lidhet SimApi, sepse qëllimi i një SimApi është të përkthejë kërkesat e të dhënave nga SIMCA-online ose SIMCA në API të burimit të të dhënave. Një zbatim SimApi nuk është kurrë një projekt i vetëm, por zakonisht ka nevojë për mbështetje të vazhdueshme dhe mirëmbajtje të rastësishme.

Leximi ose shkrimi i të dhënave

• Një SimApi ka detyrën kryesore për të siguruar të dhëna nga një burim i të dhënave. Kjo referohet si të dhëna leximi.
• Shumica e implementimeve të SimApi mbështesin gjithashtu shkrimin e të dhënave. Kjo do të thotë kthimin e të dhënave përmes SimApi në burimin e të dhënave. Shkrimi i të dhënave është një veçori opsionale në SIMCA-online.

Tags dhe Nyjet

• A tag është një identifikues i një kolone ose "ndryshore" në një burim të dhënash. A tagEmri i 's përdoret për të identifikuar tag. Emrat brenda nyjës duhet të jenë unikë. SIMCA-online 18 është versioni i parë që mbështet një nyje e cila përmban një nënnyje dhe tag me të njëjtin emër. Për shembullample: nyja Parent mund të ketë një nënnyje të quajtur Batch dhe a tag i quajtur Batch.
• Një nyje është një enë e tags. Një nyje mund të përmbajë edhe nyje të tjera, në mënyrë të ngjashme me mënyrën se si a file sistemi ka dosje në dosje.
• Ashtu si në një file sistemi, nyja dhe tag emrat mund të kombinohen në një shteg të plotë që identifikon në mënyrë unike a tag. Të tag shtigjet përdoren në SIMCA-online ose SIMCA kur zgjidhni tags për të përdorur. A tag shtegu fillon me një emër shembulli SimApi i ndjekur nga struktura e nyjes dhe përfundon me tag emri, çdo artikull i ndarë me dy pika (:). Për shembullample “:ODBCSQLSserver:Nyja:SensorTag1”.

SimApi numëron tags dhe nyjet në fillim

• Një zbatim SimApi shfleton serverin për nyje dhe tags në burimin e të dhënave kur SimApi inicializohet dhe i mban gjurmët e tyre në mënyrë që funksionet e ndryshme SimApi që përdoren për numërimin tags dhe nyja mund të zbatohet.
• Inicializimi i SimApi nuk ndodh vetëm në fillimin e serverit, por gjithashtu mund të rindizet nga një përdorues në SIMCA-online me funksionalitetin Refresh SimApi.

Ndjeshmëria ndaj rastit të tag- dhe emrat e nyjeve

• Tag emrat dhe emrat e nyjeve janë të ndjeshme ndaj shkronjave të vogla.
• Kështu, a tag i quajtur "tag1” nuk është e njëjtë me “Tag1” për shkak të rastit të ndryshëm të “T”. Ne rekomandojmë kundër përdorimit tags ose emrat e nyjeve që ndryshojnë vetëm sipas rastit.

Nyja e procesit të vazhdueshëm 

• Kur një nyje përmban tags me të dhëna të vazhdueshme të procesit, mund të referohet si një nyje procesi. Dy pamjet e mëposhtme të ekranit tregojnë një paraqitje tabelare të një nyje procesi me të dhëna të ndjekura nga një fotografi që tregon se si duket nyja kur zgjedh tags në SIMCA-online.

Nyjet e procesit të vazhdueshëm duhet të jenë të pavarura nga grupet, ekzekutimet ose koha

• Për të punuar mirë në një SimApi, një nyje duhet të jetë e pavarur nga grupet, ekzekutimet ose koha. Të kesh një nyje që përmban të dhëna për një grup specifik ose interval kohor nuk do të funksiononte mirë në SIMCA-online sepse konfigurimi i projektit mund të lexonte vetëm të dhëna për atë grup dhe të mos përdorej për grupe të tjera.
• Në vend të kësaj, një nyje duhet të hartohet në një ose më shumë njësi fizike në procesin ku kryhen matjet.

ID-ja e grupit tag kërkohet në nyjet e procesit të vazhdueshëm për ekzekutimin e projektit në grup

• Çdo proces i vazhdueshëm duhet të ketë një tag (ndryshore) që mban identifikuesin e grupit për çdo vëzhgim. Ky identifikues i grupit përdoret nga SIMCA ose SIMCA-online për të ditur se cilës grup i përket çdo vëzhgim.
• $BatchID tag në pamjet e ekranit në 7.4.3 është një shembull i tillëample.
  Edhe pse nuk kërkohet, rekomandohet të keni një tag në nyjen e procesit që tregon fazën ose hapin aktual të procesit. Kjo tag më pas mund të përdoret në kushtet e ekzekutimit fazor në SIMCA-online ose në SIMCA kur importoni të dhëna. Vlerat për këtë tag mund të jetë për shembullample "faza 1", "pastrimi", "faza 2".

Nyja e kontekstit të grupit

• Një nyje grupi është një nyje që mban gjurmët e grupeve; identifikuesit e tyre të grupit, oraret e fillimit dhe oraret e mbarimit. Është një kërkesë për ekzekutimin e projektit në grup në SIMCA-online. Një burim i të dhënave mund të ketë më shumë se një nyje grupi që ekspozon grupet në mënyra të ndryshme. Përdoruesi zgjedh nyjen e grupit që zbatohet për aplikacionin e tij ose të saj. Ky ishampekspozon grupe që përfshijnë dy njësi të ndryshme:
• /Fabrika1 – tufa me jetëgjatësi të agreguar si në Njësinë1 ashtu edhe në Njësinë2.
• /Fabrika1/Njësia1 – tufa me jetëgjatësi vetëm në Njësinë1
• /Fabrika1/Njësia2 – tufa me jetëgjatësi vetëm në Njësinë2
• Nëse nuk keni një nyje grupi në burimin tuaj të të dhënave, mund të përdorni gjeneruesin e kontekstit të grupit në SIMCA-online. Shikoni ndihmën e integruar.
• Të dhëna opsionale të grupit
• Një nyje grupi mund të përmbajë gjithashtu të dhëna të grupit; të dhëna për të cilat ka vetëm një vëzhgim për të gjithë grupin. Vini re se tags me të dhënat e grupit nuk duhet të jetë në një nyje që ka funksionalitetin e plotë të një nyje batch. Mjafton që SimApi të mbështesë leximin e të dhënave të grupit për tags. Mësoni më shumë për të dhënat e grupit në 7.6.
• Këtu është një ishample të një nyje grupi:
• Shënim: Pamja e mësipërme e ekranit është marrë nga DBMaker, e bashkuar me SIMCA-online. Për ta parë këtë vetë në DBMaker, klikoni View Butoni i të dhënave në bazën e të dhënave Bakers Yeast për të shfaqur dy dritare, njëra prej të cilave është nyja e grupit dhe tjetra të dhënat e procesit.

Llojet e të dhënave: të dhëna numerike, të dhëna tekstuale dhe të dhëna që mungojnë

• Për secilin tag, një SimApi mund të mbështesë tre lloje të dhënash: numerike, tekst, t dhe që mungojnë:
• Të dhënat numerike janë zakonisht vlera reale të parametrave të procesit, p.shample 6.5123. SimApi mund të trajtojë vetëm vlerat e pikës lundruese me saktësi të vetme 32-bit. Formati me pikë lundruese me saktësi të vetme -Wikipedia. Të gjitha llojet e tjera të të dhënave numerike në një burim të dhënash duhet të konvertohen në float. Si të tilla, ato mund të merren me vlera të mëdha dhe të vogla, por vetëm me rreth 6 ose 7 shifra të rëndësishme. Mësoni më shumë në Udhëzuesin Teknik.
• Kjo mund të çojë në humbje të saktësisë për numrat e plotë të mëdhenj ose për numrat realë që janë të mëdhenj dhe kanë dhjetorë. Për më shumë informacion, shihni Udhëzuesin Teknik.
• Të dhënat e tekstit/stringut përdoren për ID-të e grupit, kushtet e ekzekutimit të fazave ose për variablat cilësore. Vlerat për tekstin tag të dhënat janë të ndjeshme ndaj rasteve. Kjo do të thotë se vlera "running" nuk është e njëjtë me
  "DREJTIMI". Variablat e datës nuk mbështeten drejtpërdrejt nga SimApi, por ato mund të kthehen si një varg i formatuar si YY-MM-DD HH:MM (për shembullample “2020-09-07 13:45”).
• Mungojnë vlerat do të thotë se nuk ka vlerë për t'u kthyer, dmth., nuk ka të dhëna.
• Çfarë lloji është kthyer varet nga zbatimi SimApi. Një SimApi di për të dhënat në burimin e të dhënave dhe duhet të kthejë llojin e të dhënave që përshtatet më mirë.

Tre mënyra të marrjes së të dhënave: e vazhdueshme, Batc, h dhe diskrete

• Specifikimi SimApi përcakton tre mënyra të marrjes së të dhënave, dmth. tre mënyra të ndryshme nga të cilat SimApi mund të sigurojë të dhëna tags në një burim të dhënash (ose në drejtimin tjetër: shkruani të dhënat në tags në një burim të dhënash).
• Rikthimi i vazhdueshëm i të dhënave – kjo i referohet të dhënave të lexuara në mënyrë të vazhdueshme dhe sekuenciale, vëzhgimit për çdo vëzhgim ndërsa grupi ose procesi evoluon. Të dhënat lexohen për kohën aktuale, ose për një interval të caktuar, në një interval të rregullt midis vëzhgimeve. Për shembullample, të gjitha të dhënat ndërmjet orës 09:00:00 dhe 10:00:00 sampudhëhequr çdo 60 sekonda, duke rezultuar në 61 vëzhgime kur pikat e fundit janë përfshirëse.
• Marrja e të dhënave të grupit - kjo i referohet një vëzhgimi të vetëm me të dhëna për një grup të tërë (jo të lidhur me një maturim ose pikë kohore specifike). Atributet e grupit dhe të dhënat e përqendrimit lokal lexohen si të dhëna grupi në SIMCA-online. Kushtet e grupit normalisht lexohen gjithashtu si të dhëna të grupit (përveç nëse ato janë konfiguruar për marrjen e të dhënave diskrete).
• Marrja e të dhënave diskrete – të dhënat diskrete mund të përbëhen nga disa vëzhgime për shumë maturime. Por ndryshe nga të dhënat e vazhdueshme, të dhënat diskrete nuk lexohen në mënyrë sekuenciale, por të gjitha të dhënat menjëherë për një fazë specifike të një grupi. Të dhënat nuk duhet të ndahen me intervale të rregullta të ndryshores së maturimit. Të gjitha të dhënat rilexohen sa herë që kërkohen të dhënat, në intervalin e konfiguruar.
• Për çdo të dhënë tag të dhënat mund të kërkohen në cilindo nga tre mënyrat, por zakonisht një SimApi do të mbështesë vetëm një nga këto mënyra për një individ tag. Po kështu, lejohet të përzihet tags brenda një nyje, por zakonisht të gjitha tags brenda një nyje specifike mbështesin të njëjtën mënyrë të marrjes së të dhënave.
• Për të dhëna të vazhdueshme (por jo për të dhëna grupore ose diskrete2), mund të bëhen kërkesa për të dhëna aktuale ose të dhëna historike që është tema e seksionit vijues.
• Jo të gjitha SimApis mbështesin të gjitha mënyrat. Shihni matricën e veçorive më sipër dhe SimApi web faqe për detaje.

Të dhëna të vazhdueshme aktuale dhe historike përmes një SimApi

• Të dhënat e vazhdueshme i referohen të dhënave të procesit që ndryshojnë me kalimin e kohës.

Të dhënat aktuale

• Të lexosh të dhënat aktuale do të thotë të kërkosh nga burimi i të dhënave për vlerat më të fundit të tags në momentin e pyetjes. Vini re se koha e burimit të jashtëm të të dhënave nuk përdoret këtu.
• Të dhënat e lexuara si të dhëna aktuale janë ato që SIMCA-online do të shfaqë si të dhëna të drejtpërdrejta. Për këtë arsye, është e rëndësishme që të mos ketë vonesa të panevojshme në burimin e të dhënave. Të dhënat aktuale duhet të jenë sa më të fundit që të jetë e mundur për të funksionuar mirë në SIMCA-online.
• Burimi i të dhënave mund të përdorë njohuritë e tij për të dhënat dhe për sa kohë vlerat janë të vlefshme dhe të vendosë të kthejë të dhënat që mungojnë kur të dhënat e papërpunuara për një moment kohor janë shumë të vjetra. Për shembullample: të dhënat kërkohen në orën 15:00:00, por pika më e fundit e të dhënave në burimin e të dhënave është nga ora 03:00:00. Në këtë rast, të dhënat janë 12 orë të vjetra, kështu që SimApi mund të vendosë të kthejë vlerën që mungon (pa të dhëna).

Të dhëna historike

• Leximi i të dhënave historike do të thotë të kërkosh nga burimi i të dhënave vlerat e një ose më shumë tags për një interval kohor të caktuar me një interval të caktuar midis vëzhgimeve. Vini re se këtu është ora lokale e burimit të të dhënave që përdoret për të gjetur të dhënat. Prandaj, sinkronizimi i kohës midis burimit të të dhënave dhe serverëve është i rëndësishëm.
• Të dhënat historike përbëhen nga një matricë të dhënash. I takon zbatimit të SimApi të kërkojë të dhënat nga burimi i të dhënave, dhe sampLëreni atë në intervalin e specifikuar dhe ndërtoni matricën e të dhënave për t'u kthyer:
• Ndonjëherë vetë burimi i të dhënave ka funksione grumbullimi për të kthyer të dhënat e përpunuara, ose sampfunksionet ling, që mund të përdoren për të kthyer të dhënat e duhura.
• Për burime të tjera të dhënash, SimApi duhet të kërkojë të gjitha të dhënat në intervalin kohor dhe më pas sample vëzhgimet e duhura për të ndërtuar matricën.
• Të dhënat duhet të kthehen për një interval kohor, edhe pse mund të mos ketë të dhëna të papërpunuara në intervalin kohor, por vetëm pak përpara kohës së fillimit. Për shembullample: të dhënat ekzistojnë në burimin e të dhënave në pikat kohore 10 dhe 20. SimApi kërkon të dhëna për kohën 15 dhe 17. Në këtë rast, vlerat për pikën kohore 10 duhet të kthehen nga SimApi por kohëzgjatjaamped si koha 15 dhe 17 pasi këto ishin pikat më të fundit të të dhënave në ato kohë. Vlerat për tags në kohën 10 referohen si vlera kufitare për diapazonin e kërkuar. Për një shpjegim më të thellë të vlerave të kufijve, shihni p.shample dokumentacionin për kufijtë e kthimit në UA Pjesa 11: Qasja Historike – 6.4.3 Struktura ReadRawModified Details
  (opcfoundation.org)
• Interpolimi nuk duhet të përdoret kurrë për të llogaritur vlerat për pikat e ardhshme kohore, sepse të dhënat nuk do të përputhen me atë që lexohet në kohë reale si të dhëna aktuale. Për ishample nga pika e mëparshme: nëse të dhënat për 15 dhe 17 do të interpolohen duke përdorur vlerat për pikat 10 dhe 20, ato do të përdorin në mënyrë efektive vlerat nga e ardhmja, gjë që nuk lejohet.
• Burimi i të dhënave mund të përdorë njohuritë e tij për të dhënat dhe për sa kohë vlerat janë të vlefshme dhe të vendosë të kthejë të dhënat që mungojnë kur të dhënat e papërpunuara për një moment kohor janë të vjetra. Për shembullample: të dhënat kërkohen për orën 15:00:00, por pika më e fundit e të dhënave në burimin e të dhënave është nga ora 03:00:00. Në këtë rast, të dhënat janë 12 orë të vjetra, kështu që SimApi mund të vendosë të kthejë vlerën që mungon (pa të dhëna).

Shënim: SIMCA-online zakonisht nuk kërkon më shumë se njëqind vëzhgime në një telefonatë gjatë ekzekutimit normal të projektit. Kur bëni ekstrakt në SIMCA-online, ose kur përdorni SIMCA desktop, mund të bëhen kërkesa më të mëdha të të dhënave. Këto mund të zgjasin shumë, gjë që pritet.

Të dhënat aktuale dhe të dhënat historike duhet të përputhen

• Ndonjëherë mund të ketë dallime kur të dhënat lexohen si të dhëna aktuale në kohë reale ose të dhëna historike. Kjo shkakton probleme në SIMCA-online sepse serveri kalon automatikisht midis të dhënave aktuale dhe historike sipas nevojës.

Marrja e të dhënave me vonesë të ulët

• Kur një burim i të dhënave përdoret nga SIMCA-online në kohë reale, është e rëndësishme që të dhënat në burimin e të dhënave të jenë aktuale. Nuk duhet të ketë vonesa të panevojshme në marrjen e të dhënave në burimin e të dhënave. Të dhënat e procesit të vazhdueshëm për të gjitha variablat duhet të jenë të disponueshme në të njëjtën kohë për çdo vëzhgim. Të dhënat që vijnë me vonesë për disa variabla nuk do të merren nga SIMCA-online.

Të dhënat mund të lexohen për çdo kohë 

• Kur SIMCA-online kërkon një vlerë prej a tag për kohën t do të marrë vlerën nga burimi i të dhënave nga koha t, ose vëzhgimi më i fundit në burimin e të dhënave përpara kohës t, ose një vlerë të interpoluar për kohën t. Kështu, serveri do të marrë gjithmonë një vlerë në çdo kohë që kërkon, edhe pse një vëzhgim për këtë pikë të saktë kohore mund të mos ekzistojë në burimin e të dhënave.
• Me kohëamps në SimApi janë gjithmonë UTC. Klientët SIMCA-online dhe SIMCA e paraqesin kohën si kohë lokale.

Fije 

• SimApi, si parazgjedhje, thirret nga një fije e vetme nga përdoruesi i SimApi. Kjo është e vërtetë për të gjitha versionet SIMCA dhe SIMCA-online deri në versionin 17.
• SIMCA-online 18 mbështet një flamur veçori për të aktivizuar aksesin me shumë fije përmes SimApi. Lexoni më shumë në temën e ndihmës Qasja e njëkohshme në SimApi.
• Kjo do të thotë që SimApis duhet të përgatitet për multi-threading, nëse është e mundur, duke e bërë të sigurt fillin e zbatimit SimApi dhe të dokumentojë këtë dhe çdo konsideratë për përdoruesit e SimApi.

Regjistrohu file

• Një SimApi duhet të regjistrojë veprimet, mesazhet e gabimit dhe paralajmërimet në regjistrin e tij file për të ndihmuar në zgjidhjen e problemeve. Përdorni nivele të ndryshme regjistri për të nënkuptuar rëndësinë e regjistrimit.
• Rekomandohet të regjistroheni "Nuk është zbatuar" për veçori që nuk janë zbatuar në një SimApi.

Trajtimi i gabimeve

• Kur një SimApi nuk mund të përmbushë një kërkesë nga burimi i të dhënave, ai mund ta trajtojë këtë problem në një nga dy mënyrat; duke kthyer vlerat që mungojnë (pa të dhëna) ose duke sinjalizuar një gabim SimApi:
• Kthimi i vlerave që i mungojnë telefonuesit dhe suksesi i sinjalizimit i lejon telefonuesit të vazhdojë normalisht (por sigurisht pa asnjë të dhënë). Kjo është një praktikë e rekomanduar për gabime të pjesshme, si p.sh. kur mund të merren të dhëna për disa, por jo të gjitha, tags në një kërkesë.
• Sinjalizimi i një gabimi SimApi lejon telefonuesin (për shembullampnë serverin SIMCA-online) për ta parë këtë menjëherë dhe për të vepruar. Kjo është një praktikë e rekomanduar për kërkesat që dështojnë plotësisht dhe nuk mund të kthejnë fare të dhëna.
• SIMCA-online trajton vlerat që mungojnë ose kodet e gabimit në mënyra të ndryshme, siç përshkruhet në Udhëzuesin Teknik SIMCA-online.

Kërkesat e performancës SimApi

• Funksionet në SimApi përdoren për të marrë të dhëna.
• Nëse qasja e të dhënave është e ngadaltë, SimApi nuk do të funksionojë mirë, gjë që ky ishampLe tregon: Nëse SIMCA-online kërkon të dhëna çdo sekondë, por duhen dy sekonda për t'u marrë, serveri SIMCA-online nuk do të jetë kurrë në gjendje të vazhdojë në kohë reale, por gradualisht do të bjerë gjithnjë e më shumë prapa.
• Në nënseksionet do të tregojmë se si SIMCA dhe SIMCA-online përdorin funksionet e aksesit të të dhënave SimApi dhe sa shpesh do të thirren funksionet SimApi. Kjo mund të ndihmojë në vendosjen e kërkesave të performancës për një implementim SimApi.

Përdorimi i funksioneve SimApi nga SIMCA

• Kur SIMCA e desktopit ose produkte të tjera jashtë linje përdorin një SimApi për të marrë të dhëna, këto kërkesa do të jenë për grupe dhe të dhëna përpunuese për një grup variablash në një interval të caktuar kohor.
• Meqenëse këto kërkesa iniciohen manualisht nga një përdorues, ato nuk ndodhin shumë shpesh dhe nuk shkaktojnë një ngarkesë të konsiderueshme në një burim të dhënash.
• Këto funksione SimApi përdoren për të marrë të dhënat:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

Përdorimi i funksioneve SimApi nga SIMCA-online

• SIMCA-online përdoret për monitorimin në kohë reale të një procesi, dhe për këtë arsye kërkon të dhëna përmes SimApi në intervale të rregullta. Intervali më i shkurtër i ekzekutimit që mund të përdoret është 1 sekondë. Disa ish të botës realeampIntervalet e ekzekutimit janë 10 s, 1 minutë ose 10 minuta.
• Një server mund të ketë shumë projekte që funksionojnë në të njëjtën kohë.
• Për të reduktuar numrin e thirrjeve API përmes SimApi, serveri optimizon kërkesat e të dhënave duke grupuar shumë kërkesa të vogla të njëkohshme në një kërkesë të vetme më të madhe për të gjitha variablat në të njëjtën kohë (mësoni më shumë në temën e ndihmës "Leximi i optimizuar nga burimet e të dhënave përmirëson performancën").
• Algoritmi i ekzekutimit të serverit funksionon si ky kur kërkon të dhëna duke përdorur funksionet SimApi të listuara më poshtë:
• Të gjitha fazat që ekzekutohen në të njëjtin interval grupohen në një thirrje të vetme SimApi për të zvogëluar numrin e thirrjeve. Serveri lexon të dhënat më të fundit për të gjitha variablat e përdorur nga të gjitha modelet që ndajnë intervalin, dmth, kjo thirrje do të rezultojë në një rresht të gjerë të dhënash i cili më pas përdoret nga të gjitha projektet.
  • simapi2_connectionReadCurrent Data
• Për çdo projekt grupor, serveri gjithashtu duhet të dijë se cilat grupe janë aktive. Kjo gjithashtu duhet të ndodhë sa herë që një projekt ekzekutohet:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes thirret më rrallë.
• Përveç kësaj, SIMCA-online kërkon gjithashtu të dhëna historike. Këto kërkesa ndodhin vetëm kur është e nevojshme, si p.sh. kapni fillimin e një grupi që filloi përpara fillimit të SIMCA-online, ose kur serveri është duke mbetur prapa dhe duhet të lexojë një bllok të dhënash:
  • simapi2_connectionReadHistoricalDataEx
• Opsionale, disa konfigurime të projektit përdorin veçori që përdorin të dhëna grupore ose të dhëna diskrete që rezulton në thirrje SimApi në:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Opsionale, disa konfigurime të projektit përdorin kthimin për të shtyrë të dhënat në burimin e të dhënave:
  • simapi2_connectionWriteHistoricalDataEx (dhe funksionet përkatëse për të dhënat e grupit, të dhënat diskrete)
• Është e rëndësishme që çdo thirrje në funksionet kryesore për marrjen e të dhënave, readCurrentData, getActiveBatches/getBatchTimes, të jetë e shpejtë dhe kjo nuk është llogaritëse e vështirë për vetë burimin e të dhënave, duke pasur parasysh se sa shpesh SIMCA-online mund t'i thërrasë këto funksione.

Testimi dhe vërtetimi i të dhënave SimApi

• Ky seksion ka të bëjë me testimin e një SimApi për të verifikuar që të dhënat e kthyera prej tij përputhen me të dhënat në vetë burimin e të dhënave. Ekzekutimi i testeve si ky është i rëndësishëm pas krijimit ose ndryshimit të zbatimit të SimApi, ose kur ndryshon API-ja e një burimi të dhënash.
• Në praktikë, vërtetimi i të dhënave bëhet duke përdorur SIMCA-online dhe funksionalitetin e tij Ekstrakt për të tërhequr të dhënat nga burimi i të dhënave përmes SimApi dhe më pas duke i krahasuar me të dhënat e papërpunuara në burimin e të dhënave. SIMCA e desktopit nuk mund të përdoret për të testuar aspektet në kohë reale të një SimApi.

Përgatitjet dhe kërkesat

• Disa artikuj janë opsionale, por mund të kryhen nëse qëllimi i testimit tuaj e përfshin atë:

1. Instaloni SIMCA-online siç përshkruhet në ReadMe and Installation Guide.pdf që vjen në zip të produktit.
2. Merrni një licencë për serverin SIMCA-online dhe instaloni atë. SimApi nuk do të funksionojë pa licencë. Artikulli i bazës së njohurive për SIMCA-online tregon se si të licencohet produkti. Për shembullample: SIMCA-online 18 (sartorius.com)
3. Instaloni dhe konfiguroni SimApi që dëshironi të testoni. Referojuni kapitujve 4 – 5 në këtë dokument dhe udhëzuesit të përdorimit të SimApi-t specifik.
   • a. Opsionale: sigurohuni që udhëzuesi i përdoruesit të jetë i përditësuar dhe i saktë.
4. Sigurohuni që keni një mjet për burimin tuaj të të dhënave, të cilin mund ta përdorni për të krahasuar të dhënat SimApi me të.
5. Në klientin e desktopit SIMCA-online, hyni në serverin tuaj SIMCA-online dhe përdorni File > Ekstrakt për të marrë të dhëna përmes SimApi.
6. Opsionale nëse qëllimi juaj i testimit e përfshin atë: pasi të keni përfunduar testimin, çinstaloni SimApi dhe verifikoni files janë hequr.

Çfarë të testoni

• Matrica e veçorive në kapitullin 3 rendit të gjitha veçoritë e mundshme, por një zbatim i caktuar SimApi mund të mbështesë vetëm një nëngrup. Ju duhet të testoni të gjitha veçoritë që zbatohen nga SimApi i dhënë.
• Testet e mëposhtme janë të zakonshme për shumicën e implementimeve të SimApi:
• Autentifikimi me emrat e përdoruesve dhe fjalëkalimet
• Testoni cilësimet e ndryshme në konfigurimin e SimApi
• Hierarkia e nyjeve: Nyjet dhe tags të ekspozuara nga SimApi janë të sakta.
  • Duhet të ketë një tag ekspozuar për të gjitha “ndryshoret” që duhet të jenë të disponueshme përmes SimApi. p.shamples: matjet e procesit, vlerat e llogaritura, konstantet.
• Rezistenca e lidhjes: nëse burimi i të dhënave nuk është i disponueshëm, kjo rezulton në paralajmërime ose gabime në regjistër file, por që lidhja me burimin e të dhënave të rivendoset automatikisht kur burimi i të dhënave është i disponueshëm.
• Instanca të shumëfishta: që dy instanca mund të konfigurohen dhe përdoren në mënyrë të pavarur dhe njëkohësisht, me regjistra të veçantë files.
• Të dhënat aktuale: nxirrni të dhënat aktuale për tags. Sigurohuni që të dhënat janë vlerat e fundit të njohura nga burimi i të dhënave, ose mungojnë për cilësi të dobët ose kur të dhënat janë shumë të vjetra.
  • Ekstraktoni të dhënat çdo 10 sekonda (apo më shumë) për një minutë.
• Të dhëna të vazhdueshme historike: nxjerrni të dhëna historike për tags.
  • Përdorni intervalin kohor që përputhet kur keni nxjerrë të dhënat aktuale. Verifikoni që të dhënat aktuale përputhen me të dhënat historike dhe të dhënat e papërpunuara në burimin e të dhënave.
  • Provoni intervale të ndryshme kohore dhe sampling intervale, verifikoni që të dhënat përputhen me burimin e të dhënave.
  • Provoni të nxirrni të dhëna çdo 1 s, që është s më e shkurtër e mundshmeampinterval ling.
  • Provoni lloje të ndryshme tags në burimin e të dhënave (ndryshoret e procesit, etj.), duke u siguruar që të dhënat përputhen.
  • Shënim: SIMCA-online mund të ndajë një kërkesë të vetme të madhe të të dhënave historike në disa pjesë më të vogla. Kjo do të jetë e dukshme në regjistrin e SimApi.
• Verifikoni që SimApi punon me të dhëna teksti, të dhëna numerike dhe të dhëna që mungojnë.
• Regjistri i SimApi file. Verifikoni që regjistri përmban shënime të arsyeshme.
• Nyja e grupit: kliko me të djathtën mbi një nyje dhe bëj Gjeni grupe.
  • Verifikoni emrat e grupeve, oraret e fillimit, oraret e përfundimit për grupet.
  • Provoni një grup aktiv që funksionon në burimin e të dhënave. Nuk duhet të ketë një kohë përfundimi përmes SimApi.
• Identifikuesi i grupit të nyjës së procesit tag. Nëse SimApi ka funksionalitet të nyjeve të grupit (shih pikën e mëparshme), ai duhet të ketë gjithashtu një identifikues të grupit tag në nyjen e të dhënave të procesit të përputhjes. Të dhënat për këtë tag duhet të jetë identifikuesi i grupit (emri i grupit). Këto të dhëna kërkohen për projektet e grupit për të identifikuar se cilës grup i përket një rresht të dhënash.

Në varësi të faktit nëse SimApi e mbështet atë, ju gjithashtu mund të dëshironi të provoni:

• Përdorimi i të dhënave të grupit File > Ekstrakt.
• Përdorimi i të dhënave diskrete File > Ekstrakt. Shënim: për të testuar të dhëna diskrete me File > Ekstraktoni nyjen, nyja e grupit dhe nyja diskrete e të dhënave duhet të jenë në të njëjtin SimApi (kur SIMCA-online ekzekuton projekte, ato mund të jenë nga SimApi të ndryshëm).
• Shkruaj mbrapsht – shtyrja e grupit të të dhënave te burimi i të dhënave. Për ta testuar këtë, duhet të konfiguroni një konfigurim projekti në SIMCA-online për të shkruar vektorët e të dhënave në burimin e të dhënave. Pastaj ekzekutoni projektin në SIMCA-online dhe kontrolloni të dhënat që janë shkruar përsëri në burimin e të dhënave.
• Të dhënat e vazhdueshme konfigurohen në faqen Evolution Write Back në konfigurimin e projektit.
• Të dhënat diskrete konfigurohen në të njëjtën faqe, por vetëm për një fazë të konfiguruar për marrjen e të dhënave diskrete.
• Të dhënat e grupit nga Batch Write back

MË SHUMË INFO

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Suedi
• Telefon: +46 90-18 48 00
• www.sartorius.com
• Informacioni dhe shifrat e përfshira në këto udhëzime korrespondojnë me datën e versionit të specifikuar më poshtë.
• Sartorius rezervon të drejtën të bëjë ndryshime në teknologjinë, veçoritë, specifikimet dhe dizajnin e pajisjeve pa paralajmërim. Format mashkullore ose femërore përdoren për të lehtësuar lexueshmërinë në këto udhëzime dhe gjithmonë tregojnë njëkohësisht të gjitha gjinitë.
  Njoftim për të drejtën e autorit:
• Këto udhëzime, duke përfshirë të gjithë komponentët, mbrohen nga e drejta e autorit.
• Çdo përdorim përtej kufijve të ligjit për të drejtën e autorit nuk lejohet pa miratimin tonë.
• Kjo vlen veçanërisht për ribotimin, përkthimin dhe redaktimin, pavarësisht nga lloji i medias së përdorur.

FAQ

• Pyetje: Cili është qëllimi i SimApis?
  • Përgjigje: Qëllimi kryesor i SimApis është të sigurojë të dhëna për produktet e Umetrics Suite për krijimin e projektit dhe ndërtimin e modeleve.
• Pyetje: Si mund t'i zgjidh problemet me një instalim SimApi?
  • Përgjigje: Mund t'i zgjidhni problemet duke testuar nga SIMCA-online, duke kontrolluar regjistrin e SimApi file, dhe sigurimin e konfigurimit të saktë të llogarisë së shërbimit.

Dokumentet / Burimet

SARTORIUS Sim Api Software [pdfUdhëzuesi i përdoruesit Sim Api Software, Api Software, Software

Referencat

• Manuali i Përdoruesit