SARTORIUS Sim Api tarkvara

Tehnilised andmed

• Toote nimi: SimApi juhend
• Ilmumiskuupäev: 5. september 2024
• Eesmärk: pakkuda andmeid Umetrics Suite'i toodetele

Toote kasutusjuhised

SimApise tutvustus

• SimApisi kasutatakse andmete hankimiseks projekti loomiseks ja mudelite loomiseks Umetrics Suite'i toodetes.

SimApise hankimine

• SimApise hankimiseks vaadake ametlikku dokumentatsiooni või võtke abi saamiseks ühendust klienditoega.

SimApi funktsioonid

• SimApis pakub reaalajas andmeid SIMCA ja SIMCA-online jälgimiseks, juhtimiseks ja mudelite loomiseks.

Ainult praegune andmekasutus

• Optimaalse jõudluse tagamiseks on soovitatav kasutada ainult praeguseid andmeid ja vältida ajaloolisi andmeid.

Ettevalmistused SimApi installimiseks

• Enne paigaldamist veenduge, et teie süsteem vastab kasutusjuhendis toodud miinimumnõuetele.

SimApi installimine

• SimApi oma süsteemi installimiseks järgige kasutusjuhendis toodud samm-sammult juhiseid.

SimApi seadistamine SIMCA jaoks

• Seadistage SimApi seaded SIMCA-s vastavalt antud juhistele.

SimApi seadistamine SIMCA-online jaoks

• Seadistage SimApi reaalajas andmete otsimiseks ja tagasikirjutamiseks SIMCA-online'is.

Testimine ja tõrkeotsing

• Pärast paigaldamist tehke õige funktsionaalsuse tagamiseks testimine. Probleemide korral vaadake kasutusjuhendi tõrkeotsingu jaotist.

Testimine SIMCA-online'ist

• Andmete kättesaamise kontrollimiseks testige SimApi integratsiooni SIMCA-online'ist.

Tõrkeotsing Logiga Files

• Kasutage SimApi logi file paigaldus- või tööprobleemide tuvastamiseks ja lahendamiseks.

Teenusekonto konfiguratsioon

• Sujuva toimimise tagamiseks veenduge SIMCA-online-teenuse konto õiges konfiguratsioonis.

Tehnilised üksikasjad

• SimApise kohta üksikasjalikku tehnilist teavet leiate kasutusjuhendi jaotisest 7.

SimApise tutvustus

• SimApi on tarkvaraliides Umetrics® Suite'i tarkvara ja andmeallika vahel. SimApi esmane eesmärk on anda andmeid SIMCA®-online'ile või SIMCA®-le.
• Sartorius Stedim Data Analytics AB arendab SimApisi paljude erinevate andmeallikate jaoks, nagu protsessiajaloolased ja üldotstarbelised andmebaasid.
• See dokument näitab, mis on SimApi ja kuidas seda Umetrics Suite'i toodetes kasutatakse. Saate teada, kuidas SimApi planeerida ja installida, kuidas tõrkeotsingut teha ja installimist testida. Viimane peatükk sisaldab SimApise tehnilisi üksikasju, mis on suunatud arendajatele.

SimApi eesmärk: andmete esitamine Umetrics Suite'i toodetele

• SimApi peamine eesmärk on andmeallikast SIMCA-online'ile või SIMCA-le andmeid edastada. Andmeallikas ei ole SIMCA-online'i osa, kuid see võib olla protsessiajaloolane või muu süsteem, mis andmeid säilitab ja haldab.
• SimApi paljastab sõlmede hierarhia, mis vastab a kaustadele file süsteem. Iga sõlm võib sisaldada teisi sõlmi või tags. A tag vastab muutujale. Nende jaoks tags, andmeid saab hankida. Pildil on a tag, Temp, valitud sõlmes
• BakersYeastControlGood SIMCA-online'i andmeallikas. See näitab ka andmeallikast võetud uusimaid väärtusi.

SimApi kasutamine Umetrics Suite'is

• Töölauatarkvara SIMCA saab kasutada SimApi, et hankida andmeid projekti loomiseks ja mudeli koostamiseks, nagu on näidatud järgmisel pildil.
• SIMCA-online kasutab SimApist reaalajas andmete hankimiseks jälgimiseks ja juhtimiseks ning andmete tagasikirjutamiseks andmeallikasse. Järgmine pilt näitab, kus SimApi asub süsteemis, mis koosneb andmeallikast, SIMCA-võrguserverist ja klientidest.

Tavaliselt kasutatav SimApis

• Kõige laialdasemalt kasutatavad SimApid on:
• PI AF SimApi Aveva (endine OSIsoft) PI-süsteemidega ühendamiseks.
• OPC UA SimApi
• ODBC SimApi – üldiseks juurdepääsuks andmebaasidele, nagu SQL Server või Oracle
• Kõik saadaolevad SimApid on loetletud koos nende funktsioonidega lõikes 3.

DBMaker SimApi simulatsiooniandmete jaoks

• DBMaker on SIMCA-online-serveri installiga kaasas olev rakendus. See simuleerib andmeallikat, näiteks protsessi ajaloolast, kasutades eellaaditud andmetabelit, kus vaatlused edastatakse ükshaaval SIMCA-online'ile DBMaker SimApi kaudu.
• DBMakerit kasutatakse ainult tutvustamise eesmärgil ja seda ei saa kasutada andmeallika reaalajas andmetega tootmises. DBMakeri kohta lisateabe saamiseks vaadake sisseehitatud spikrit.

Lisadokumentatsioon

• See dokument on üks seotud dokumentide komplektist, millest igaühel on erinev fookus ja sihtrühm:

Allikas	Mida	Kus
SIMCA-võrgus web lehel	Sissejuhatav teave ja allalaaditavad failid	sartorius.com/umetrics-simca- võrgus

SIMCA-võrgus ReadMe ja Installation.pdf	Installimine ja SIMCA-online demoandmetega alustamine	Installimise zip file
SIMCA-veebi juurutamise juhend	Kirjeldab SIMCA-online-funktsiooni, asetab selle konteksti muu Umetrics Suite'i tarkvaraga, kirjeldab eduka juurutamise nõudeid ja parimaid tavasid ning samm-sammult installijuhiseid.	sartorius.com/umetrics-simca- võrgus
SimApi juhend	SimApi installide ettevalmistamine ja läbiviimine, sealhulgas tõrkeotsing. Sisaldab arendajatele ka SimApise tehnilisi üksikasju.	sartorius.com/umetrics-simapi
SimApi kasutusjuhendid	Iga avaldatud SimApi dokumentatsioon koos funktsioonide, installijuhiste ja konfiguratsioonispetsiifikatega.	sartorius.com/umetrics-simapi
SIMCA veebipõhine tehniline juhend	Tehniline teave SIMCA-online-serveri installi planeerimiseks, tõrkeotsinguks ja SIMCA-online'i tööpõhimõtteks.	sartorius.com/umetrics-simca-võrgus
SIMCA-võrguabi	Web-põhine abi SIMCA-online'i kasutamise ja SIMCA-online'i toimimise kohta.	Tarkvaras endas ja edasi sartorius.com/umetrics-simca
SIMCA-võrgus Web Kliendi installijuhend	Kirjeldab SIMCA-online installimist Web Klient.	sartorius.com/umetrics-simca-võrgus
Umeetria teadmistebaas	Otsitav andmebaas, mis sisaldab artikleid iga välja antud tarkvaraversiooni, tehniliste artiklite ja Umetrics Suite'i toodete teadaolevate probleemide kohta.	sartorius.com/umetrics-kb
SIMCA abi/kasutusjuhend	Kuidas kasutada töölaua SIMCA-d projektide loomiseks ja andmete modelleerimiseks.	SIMCA-s ja edasi sartorius.com/umetrics-simca
Toetus web lehel	Kuidas saada tehnilist tuge.	sartorius.com/umetrics-support

Tehniline tugi

• Sartoriuse võrgutoe meeskond vastab SimApise kohta tehnilistele küsimustele ja võib edastada ka SimApise täiustamise taotlused vastavatele inimestele. Lisateavet leiate aadressilt sartorius.com/umetrics-support.

SimApise hankimine

• Pakume saadaolevate SimApise dokumentatsiooni ja installiprogrammide linke aadressil sartorius.com/umetrics-simapi.
• Iga SimApi on dokumenteeritud selle kasutusjuhendis.
• SimApi juhend, mida te loete ei,w täiendab seda teavet SimApi täiendava teabega SimApi planeerimise, installimise ja tõrkeotsingu kohta.

SimApi funktsioonid

• Kõik andmeallikad ei ole sarnased. SimApi ei pea kõiki spetsifikatsiooni funktsioone rakendama. Nendel põhjustel pakuvad erinevad SimApid erinevat funktsiooni. Järgmises maatriksis on loetletud saadaolevad SimApis ja nende funktsioonid.
• Funktsioone selgitatakse allpool. Pange tähele, et tabelis on eraldi veerud, mis näitavad, millised funktsioonid on vastavalt SIMCA-online'is ja SIMCA-s saadaval.

Funktsioon	Eesmärk	SIMCA-võrgu kasutamine	SIMCA kasutamine
Praegused andmed	Lugege andmeallikast kõige värskema väärtusega üksikut vaatlust.	Reaalajas tavaline täitmine	–
Ajaloolised andmed	Lugege korraga palju vaatlusi andmeallika ajalooliste andmetega.	Järgige ja ennustage varasemaid andmeid, looge projekte kasutades File > Uus	Andmebaasi importimise viisard protsessiandmete importimiseks mudeli loomiseks.
Diskreetsed andmed	Lugege andmeallikast labori/IPC andmeid. Palju tähelepanekuid partii kohta.	Pakettprojektide jaoks, mille faasid või partiitingimused on konfigureeritud diskreetseks andmete toomiseks.	–
Partii andmed	Lugege partii tingimusi ja lõplikke kvaliteediatribuute (või	Partii tingimused või kohalik tsentreerimine.	Andmebaasi importimise viisard partiitingimuste lugemiseks

Funktsioon	Eesmärk	SIMCA-võrgu kasutamine	SIMCA kasutamine
	muud MES tüüpi andmed). Üks vaatlus partii kohta.		partii tasemel mudeli loomine.
Partii sõlm	Määrake konkreetse partii algus- ja lõpuaeg (aktiivse partii puhul tühi). Loetlege kõik teatud ajavahemikus eksisteerinud partiid.	Vajalik partiikonfiguratsioonide täitmiseks.	Andmebaasi importimise viisard imporditavate partiide valimiseks.
Kirjuta tagasi – pidevad andmed	Kirjutage andmeallikasse tagasi pidevad andmed, näiteks ennustused.	Kirjutage andmed tagasi partii arengutasemelt Control Advisori või pidevate konfiguratsioonide jaoks	–
Kirjutage tagasi – diskreetne	Kirjutage diskreetsed andmed (nt ennustused) tagasi andmeallikasse.	Kirjutage tagasi partii konfiguratsioonide jaoks partii arendamise tasemel faaside jaoks, mis on konfigureeritud diskreetseks andmete toomiseks	–
Kirjutage tagasi – partii andmed	Kirjutage andmeallikasse tagasi partiitaseme andmed, nagu ennustused või lõplikud kvaliteediatribuudid.	Kirjutage partii tasemel konfigureerimiseks tagasi	–
Sõlmede hierarhia	SimApi toetab sõlmede hierarhiat, sarnaselt a file süsteem. Iga sõlm võib sisaldada tags ja muud sõlmed. Hierarhia muudab lihtsamaks suure hulga sõlmede haldamise ja tags.	Toetatud kõigis kohtades, kus tags kasutatakse.
Massiiv tag laienemine	Massiiv tag salvestab mitu väärtust. SimApi laiendab massiivi tag paljudele üksikisikutele tags, üks iga massiivi elemendi kohta.	Toetatud kus tags kasutatakse pidevate andmete jaoks. Igaüks laienes tag tuleb kaardistada muutujaga SIMCA projektis.
Mitu andmeallikat	SimApi saab ühendada rohkem kui ühe andmeallikaga või toetab mitut enda eksemplari individuaalsete sätete ja logiga files iga juhtumi kohta.	Ühendage mitme erineva sama tüüpi andmeallikaga.	–
Ühenduse vastupidavus	Kui SimApi ühendus andmeallikaga katkeb, proovib see ühendust automaatselt taastada.	Andmeallikaga ühenduse taastamiseks ei pea SimApi taaskäivitama.	–
Majasiseselt välja töötatud	SimApi arendab, pakub ja toetab

Ainult praeguseid andmeid ilma ajalooliste andmeteta ei soovitata

• Mõned SimApis, eriti OPC DA, toetavad ainult praeguste andmete, mitte ajalooliste andmete lugemist.
• SimApi, mis toetab ainult praeguseid andmeid, ei saa kasutada töölaua SIMCA-s, kuna see ei saa lugeda ajaloolisi andmeid, millele mudelid ehitada.
• SIMCA-online'i jaoks soovitame tungivalt andmeallikat ja SimApi-d, mis ei paku reaalajas täitmiseks mitte ainult praeguseid andmeid, vaid ka ajaloolisi andmeid, et oleks võimalik varasemaid andmeid ennustada ja järele jõuda. SIMCA-online lülitub vastavalt vajadusele automaatselt reaalajas andmete ja ajalooliste andmete vahel ning seda ei saa välja lülitada.
• Andmeallikas, mis pakub ainult praeguseid andmeid, kuid mitte ajaloolisi andmeid, võib töötada pidevate projektide puhul SIMCA-online'is, kuid pakettprojektide jaoks on vaja ajaloolisi andmeid.

Ettevalmistused SimApi installimiseks

• See jaotis kirjeldab olulist teavet SimApi edukaks installimiseks.

64-bitine või 32-bitine SimApis

• Igal SimApil on 32-bitine ja 64-bitine versioon.
• SIMCA-online ja SIMCA on 64-bitised ja nõuavad 64-bitisi SimApise variante. Pärand 32-bitine SimApis on endiselt saadaval vanemate installide jaoks.

Palgi asukoht file ja seaded

• SimApi salvestab oma logi files peidetud programmiandmete kaustas1:
  %programdata%\Umetrics\SimApi, kus %programdata% kaardistab teie arvuti tegeliku kausta. Vaikimisi on see C:\ProgramData.
• Iga SimApi kasutab tavaliselt oma logi file, mis sarnaselt SIMCA võrguserveri logile file sisaldab olenevalt logitaseme sättest rohkem või vähem andmeid. See file on kasulik tõrkeotsinguks. Palk file on nimetatud
  .logi kuhu on SimApi, mida installite, ntample PIAFSimApi. Vaadake ka järgmist jaotist SIMCA võrgus oleva SimApi eksemplari nimede kohta.
• See kaust sisaldab ka SimApi sätteid XML-vormingus file nimega .xml.
• Enamikul SimApidel on graafilised kasutajaliidesed, mis muudavad xml-i sätteid file, kuid mõne puhul sisestate muudatused otse XML-i file tekstiredaktoriga, näiteks Notepadiga. Vaadake iga SimApi kasutusjuhendit.

File nimesid, kui nimega eksemplare kasutatakse koos SIMCA-online'iga

• SIMCA-online'is saab iga SimApi eksemplar oma konfiguratsiooni file ja logi file et töötada iga SimApi mitme eksemplariga. Nende nimed files on sufikseeritud eksemplari nimega, nagu on antud SIMCA-online-serveri suvandite dialoogi vahekaardil SimApi.
• Järgmised eksample näitab nende nimetamist files, kus tuleb asendada SimApi nimega.
• Eksemplari lisamisel antud konfiguratsiooninimi: OmegaServer
• Seadistamine file nimi: OmegaServer.xml
• Logi sisse file nimi: OmegaServer.log
• Pange tähele, et üldine file .log file on ikka loodud. See logi file sisaldab kirjeid, mida tehnilistel põhjustel ei saa logisse suunata file juhtumitest..
• See kaust on Windowsis vaikimisi peidetud. Et seda sisse näha File Explorer konfigureerite selle näitama peidetud files. Pange tähele, et saate peidetud kausta navigeerida, sisestades aadressi File Exploreri aadressiriba.
• Pange tähele, et SIMCA ei toeta SimApi mitut eksemplari ja seetõttu kasutab nimesid ilma eksemplari nimeta, nagu eespool kirjeldatud.

Võrgu planeerimine

• Peaksite leidma SIMCA võrguserveri võrgu andmeallika lähedal. See tagab kiire ühenduse SIMCA-online'i ja selle andmeallika vahel.
• Võrguseadmed võivad häirida ühendust SIMCA-online'i ja andmeallika vahel.

Kasutajakontod ja andmeallika load

• Andmeallikad kontrollivad tavaliselt juurdepääsu nende andmetele. Tavaliselt tehakse seda kasutajanimede ja paroolidega, kuid kasutada võib ka IP-aadressi või DNS-põhiseid piiranguid (ntample PI Trusts in Aveva PI System).
• Kasutajanime ja parooli saab andmeallikale esitada erineval viisil:
• SimApi käitatakse selle kasutaja Windowsi kasutajana, kes töötab serveri arvutis töölaua SIMCA või SIMCA võrguteenuse kontoga. SimApi saab seda kontot kasutades andmeallikaga ühenduse luua. Nii töötavad OPC I ja PI SimApi ning ODBC, kui te selle konfigureerimisel mandaate ei anna.
• Üldise ODBC jaoks saate kasutada ODBC andmeallikate administraatori rakendust, mis asub Windowsis Start.
• Mõned andmebaasi pakkujad pakuvad oma andmebaaside jaoks oma draivereid ja tööriistu. Oracle'i andmebaasid, ntample, kasutage Oracle'i andmete juurdepääsu komponente (ODAC).
• Mõnel SimApis, nagu PI AF ja ODBC, on seadistusdialoogid, mis salvestavad SimApi XML-konfiguratsioonis krüptitud mandaadid. file.
• PI-l on ka PI-serveri arvuti PI süsteemihaldustööriistades saadaval erinevad turbevõimalused. Lisateavet leiate PI AF SimApi kasutusjuhendist. See juhend on kasulik isegi siis, kui kasutate vanemat OSIsoft PI SimApi.
• OPC DA ja HDA kasutavad andmeallika ja SimApi vahelise transpordina DCOM-i. DCOM on Windowsis konfigureeritud komponentteenuste tööriistaga (DCOMCNFG.EXE) ja kasutab Windowsi autentimist.
• Vanema OSIsoft PI SimApi (mitte uuema AF SimApi) puhul kasutatakse PI-serveriga ühenduse seadistamiseks OSIsoft AboutPI-SDK rakendust (PISDKUtility.exe).

Andmeallika ühenduvuse kontrollimine
Kui soovite SimApi arvutisse installida, võib olla kasulik kontrollida selle arvuti ja andmeallika ühenduvust mõne muu tööriistaga.

• Windowsi ODBC andmeallikaid kasutatakse üldise ODBC konfigureerimiseks ja testimiseks. Pange tähele, et 64-bitises Windowsis on sellel tööriistal kaks versiooni: üks 32-bitiste rakenduste ja teine ​​64-bitiste rakenduste jaoks. Andmebaasi ühenduvuse kontrollimiseks kasutage ODBC konfiguratsiooniviisardi lõpus nuppu Testi andmeallikas. Soovitame konfigureerida oma andmeallikad süsteemi DSN-idena.
• Andmebaasi pakkuja andmebaasipõhine ühendustööriist, näiteks Oracle Data Access Components.
• PI System Explorerit saab kasutada PI AF-serveriga ühenduvuse testimiseks. See on osa PI AF Client'ist, mis on PI AF SimApi eeltingimus.
• Unified Automationi OPC UA ekspert – UaExpert on platvormideülene testklient OPC UA serverite jaoks.
• PI-SDK rakendust (PISDKUtility.exe) saab kasutada ühenduvuse testimiseks ja selleks view kõik veateated, mis võisid olla sisse logitud, kui SIMCA-online proovib PI-serveriga ühendust luua. Seda kasutatakse ainult vanema OSIsoft SimApi jaoks, mitte PIAF-i jaoks.
• PI-süsteemi haldamise tööriistu kasutatakse PI-serverarvutis sellelt poolelt tõrkeotsinguks. Näiteksample, et otsida turvaprobleeme, mis takistavad juurdepääsu SIMCA-võrguserverist. Lisateavet PI-süsteemi tõrkeotsingu kohta leiate sellest YouTube'i videost.
• Exceli abil saab ODBC-ühendusest ja enamikust teistest süsteemidest andmeid hankida, kui on installitud sobiv pistikprogramm.
• Matrikon OPC Explorer for Ior HDA (need on eraldi tööriistad) saab kasutada OPC-ühenduvuse testimiseks ja Matrikon OPC Analyzerit saab kasutada OPC-ühenduvusprobleemide diagnoosimiseks. Laadige need tasuta tööriistad alla saidilt https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (DInd HDA jaoks) OPC Training Institute'ilt web sait “võimaldab kasutajatel hõlpsasti diagnoosida side- ja turvaprobleeme ning neid ühe nupuvajutusega koheselt parandada. Seda kõike saab teha ilma, et peaksite kunagi õppima DCOM-i konfigureerima"

SimApi installimine

SimApi arvutisse installimiseks tehke järgmist.

1. Lugege installitava SimApi kasutusjuhendit. See sisaldab selle SimApi spetsiifikat, mis täiendavad praegu loetavaid üldisi juhiseid.
2. Installige ja konfigureerige kõik SimApi kasutusjuhendis mainitud eeltingimused (ntampandmebaasi draiverid või SDK-d)
3. SimApi installimiseks käivitage häälestusprogramm. Installige 64-bitine (x64) või 32-bitine (x86) versioon, mis vastab tarkvarale, milles seda käivitate.
4. Seadistage SimApi SIMCA-online'is või SIMCA-s, nagu on kirjeldatud järgmistes jaotistes, ja vaadake saadaolevate sätete kirjeldusi SimApi kasutusjuhendist.
5. Käivitage SIMCA võrguserver. Pange tähele, et see võib võtta aega, sest kui SimApi lähtestatakse, loetleb see kõik tags andmeallikas.
6. Testige SimApi, hankides mõned andmed. SIMCA-online'i jaoks saate kasutada File > Ekstraheerige nagu kirjeldatud punktis 6.1.
7. Kui SimApi ei tööta ootuspäraselt, vaadake SimApi logi files tõrkeotsinguks ja SimApi kasutusjuhendisse.

SimApi seadistamine SIMCA-s kasutamiseks

SimApi kasutamine SIMCA-s toimib järgmiselt.

1.  Alustage andmebaasi importimist ühel järgmistest viisidest.
   • a. Uue projekti loomiseks SIMCA-s tehke järgmist. File > Uus tavaprojekt või uus partiiprojekt. Valige vahekaardil Avaleht andmebaasist.
   • b. Andmekogumi importimine SIMCA olemasolevas projektis: avatud SIMCA projekti vahekaardil Andmed olevast andmekogumist.
2. Klõpsake nuppu Lisa uus andmeallikas
3. Valige ühenduse tüübiks SimApi, klõpsake nuppu … ja leidke üles .dll installikaustas ja klõpsake nuppu Ava.
4. Klõpsake nuppu Konfigureeri ja vaadake individuaalset SimApi kasutusjuhendit, kuidas seadistusi teha.
5. Klõpsake nuppu Testi andmeallika ühendust, et kontrollida, kas saate andmebaasiga ühenduse luua. See võib võtta kaua aega, kui neid on palju tags andmeallikas.
6. Konfigureerimise lõpetamiseks klõpsake nuppu OK.
7. Imporditud andmetega töötamise kohta vaadake SIMCA abi.

SimApi seadistamine kasutamiseks SIMCA-online'is

• Tähtis. SimApi kasutamiseks on vaja SIMCA võrguserveri litsentsi. SIMCA-online'i demoinstallatsioon ei võimalda SimApist kasutada.
• SimApi süsteemi lisamiseks käivitate serveriarvutis SIMCA-online Server Options. Lisateavet leiate SICMA võrguabi teemast SimApi lisamine ja konfigureerimine serveris.
• Näpunäide. Kui teete SimApi jaoks muudatusi, saate selle SimApi taaskäivitada eraldi jaotisest Server Options, ilma kogu serverit taaskäivitamata.
• Selle SimApi mitme eksemplari konfigureerimiseks korrake ülaltoodud samme ja kasutage iga eksemplari jaoks kordumatuid nimesid. Lisateavet erinevate logide ja konfiguratsioonide kohta files 4.2.

SimApi testimine ja tõrkeotsing

• See peatükk käsitleb SimApi installi testimist ja tõrkeotsingut.

SimApi testimine SIMCA-online'ist

• Kui SIMCA-online-server on edukalt käivitatud, saate testida oma SimApi-d SIMCA-online'is (kui server ei käivitu, vaadake 6.2):
• Logige SIMCA-online-kliendis serverisse sisse ja navigeerige lehel Extract File sakk. Väljavõte aitab teil SimApi testida, hankides selle kaudu andmeid:
• SimApi sõlmed (“kaustad”) kuvatakse vasakpoolses kastis. Tags valitud sõlme jaoks kuvatakse paremas ülanurgas.
• Praeguseid andmeid saab lihtsalt klõpsates kiiresti testida view> sisse tags mis pakuvad pidevaid protsessiandmeid (vt ekraanipilti)
• Paremklõpsake sõlmel, et leida ajavahemikus partiid. Sõlm peab olema partii sõlm, mis teab partiide kohta.
• Valige tags jaotises Ekstrakt ja klõpsake nuppu Edasi ning lõpetage viisard, et hankida andmeid, kasutades erinevaid andmeotsingurežiime: praegused, ajaloolised, pakettandmed ja diskreetsed andmed.
• Võrrelge ekstraktitud andmeid sellega, mida näete oma andmeallikas, kasutades selle tööriistu. Vaadake lisateavet SimApi kõigi funktsioonide testimise ja valideerimise kohta versioonis 7.13.

SimApi probleemide tõrkeotsing SimApi logi abil file

• Kui server ei käivitu, SimApi ei tööta ootuspäraselt või ekstraktimine ebaõnnestub, peate tutvuma SimApi logiga file mis ütleb teile, milles probleem on. Täielike üksikasjade vaatamiseks lubage SimApi logis silumistaseme logimine. Vaata 4.2.
• Märkus: SIMCA võrguserveri logid pole siin nii kasulikud. Need näitavad, kuidas server SimApi laadis ja lähtestas, kuid SimApi konkreetsed üksikasjad on selle logis file.

Kasutage õiget SIMCA võrguteenuse kontot

• Andmeallikale juurdepääsu testimisel pidage meeles, et olete serveriarvutis sisse logitud kindla kasutajana (tavaliselt teie enda kasutajakonto Windowsi domeenis), kuid SIMCA võrguserveri teenusekonto on vaikimisi erinev konto, vaikimisi LocalSystem, millel on teie kasutajakontoga võrreldes erinevad juurdepääsuõigused.
• Sel põhjusel ei ole harvad juhud, kui testid töötavad teie kontona käivitamisel, kuid SIMCA-online ei suuda andmeallikaga ühendust luua.
• Selle probleemi lahendamiseks tuleb SIMCA-online-serveri teenuse kasutatavale kontole juurdepääs anda. Tavaliselt muudate LocalSystemi konkreetse domeeniteenuse kontoks ja annate sellele kontole õigused. Pange tähele, et see ei kehti, kui SimApi kasutab SimApi konfiguratsioonis määratud mandaate, kuna need mandaadid on ülimuslikud.

SimApise tehnilised üksikasjad

• See peatükk sisaldab tehnilisi üksikasju SimApi toimimise kohta. See on peamiselt suunatud arendajatele, kes soovivad mõista SimApist, et rakendada SimApi andmeallika jaoks.
• Arendajad peaksid lugema ka selle dokumendi varasemaid osi, et tutvuda SimApise ja funktsioonide kõrgetasemeliste kirjeldustega.

Millal kaaluda SimApi väljatöötamist ja millal mitte?

Enne SimApi väljatöötamist andmeallika jaoks tehke järgmist.

1. Uurige, kas SimApi on juba olemas, mida saate kasutada. Võib-olla saate lubada oma andmeallikas mõne funktsiooni, et kasutada mõnda olemasolevat SimApist, näiteks OPC UA.
2. Lugege see dokument ja selle viited hoolikalt läbi ning uurige, kas teie andmeallikas vastab nõuetele: ntampSee peab olema piisavalt kiire ja esitama mitte ainult praeguseid, vaid ka ajaloolisi andmeid.

• Nendel põhjustel ei soovita me arendada SimApi, mis loob ühenduse madala taseme riistvara või instrumentidega. Parem on need instrumendid ühendada protsessiajaloolasega, näiteks Aveva PI Systemiga, lasta tal instrumendist andmeid hankida ja ajaloos koostada. Seejärel saab PIAF SimApi kasutada andmete hankimiseks PI-st Umetricsi tootesse.

SimApi arendus ja SimApi spetsifikatsioon

• SimApi spetsifikatsioon, SimApi-v2, sisaldab dokumentatsiooni kõigi SimApi C-funktsioonide kohta, mida SimApi DLL peab rakendama, ja mõningaid juhiseid SimApi arendamiseks.
• SimApi juurutamine C või C++ abil on enamikul juhtudel tarbetult madalal tasemel.
• Soovitatav ja lihtsam viis SimApi juurutamiseks on selle aluseks võtta ExampleSimApi lähtekood, mida pakume. See on endineample SimApi juurutus, mis haldab C-liidest ja tõlgib selle.NET Frameworki, kus tegelik juurutamine toimub. Sellel on ka logimise, sätete, konfiguratsiooni GUI ja muu raamistiku kood.
• SimApi arendamiseks vajab arendajate meeskond Windowsi, .NET Frameworki, C või C++ arendamise kogemust. Nõutavad on ka head teadmised andmeallikast, millega SimApi peaks ühendust võtma, sest SimApi eesmärk on tõlkida andmepäringud SIMCA-online'ist või SIMCA-st andmeallika API-sse. SimApi juurutamine ei ole kunagi ühekordne projekt, vaid vajab tavaliselt pidevat tuge ja aeg-ajalt hooldust.

Andmete lugemine või kirjutamine

• SimApi põhiülesanne on andmeallikast andmete esitamine. Seda nimetatakse andmete lugemiseks.
• Enamik SimApi rakendusi toetab ka andmete kirjutamist. See tähendab andmete tagasi kirjutamist SimApi kaudu andmeallikasse. Andmete kirjutamine on SIMCA-online'i valikuline funktsioon.

Tags ja Sõlmed

• A tag on andmeallika veeru või muutuja identifikaator. A tagnime kasutatakse identifitseerimiseks tag. Sõlmesisesed nimed peavad olema kordumatud. SIMCA-online 18 on esimene versioon, mis toetab sõlme, mis sisaldab alamsõlme ja tag sama nimega. Näiteksample: sõlmel Parent võib olla alamsõlm nimega Batch ja a tag nimega Batch.
• Sõlm on konteiner tags. Sõlm võib sisaldada ka teisi sõlmi, sarnaselt sellele, kuidas a file süsteemis on kaustad kaustades.
• Nagu a file süsteem, sõlm ja tag nimesid saab kombineerida täielikuks teeks, mis identifitseerib unikaalselt a tag. The tag valides kasutatakse SIMCA-online'is või SIMCA-s teid tags kasutada. A tag tee algab SimApi eksemplari nimega, millele järgneb sõlme struktuur ja lõpeb tähega tag nimi, iga üksus eraldatud kooloniga (:). Näiteksample “:ODBCSQLServer:Sõlm:SensorTag1”.

SimApi loetleb tags ja sõlmed käivitamisel

• SimApi rakendus sirvib serverist sõlmede ja tags SimApi initsialiseerimisel andmeallikas ja jälgib neid nii, et loendamiseks kasutatavad erinevad SimApi funktsioonid tags ja sõlme saab rakendada.
• SimApi initsialiseerimine ei toimu lihtsalt serveri käivitamisel, vaid kasutaja saab selle uuesti käivitada ka SIMCA-online'is, kasutades funktsiooni Refresh SimApi.

Tõstutundlikkus tag- ja sõlmede nimed

• Tag nimed ja sõlmede nimed on tõstutundlikud.
• Seega a tag kutsus "tag1" ei ole sama mis "Tag1”, kuna „T” on erinev. Soovitame mitte kasutada tags või sõlmede nimed, mis erinevad ainult juhul.

Pideva protsessi sõlm 

• Kui sõlm sisaldab tags pidevate protsessiandmete korral võib seda nimetada protsessisõlmeks. Järgmised kaks ekraanipilti näitavad protsessi sõlme tabelit koos andmetega, millele järgneb pilt, mis näitab, kuidas sõlm valimisel välja näeb tags SIMCA-online'is.

Pideva protsessi sõlmed peavad olema sõltumatud partiidest, käivitustest ega ajast

• SimApis hästi toimimiseks peab sõlm olema partiidest, käitamistest või ajast sõltumatu. Konkreetse partii või ajavahemiku andmeid sisaldava sõlme olemasolu ei töötaks SIMCA-online'is hästi, kuna projekti konfiguratsioon saaks siis lugeda ainult selle partii andmeid ja seda ei kasutata teiste partiide jaoks.
• Selle asemel tuleks mõõtmisprotsessi käigus sõlm kaardistada ühe või mitme füüsilise üksusega.

Partii ID tag vajalik pideva protsessi sõlmedes partiiprojekti täitmiseks

• Igal pideval protsessil peab olema a tag (muutuja), mis sisaldab iga vaatluse partii identifikaatorit. Seda partii identifikaatorit kasutab SIMCA või SIMCA-online, et teada saada, millisesse partii iga vaatlus kuulub.
• $BatchID tag 7.4.3 ekraanipiltidel on selline eksample.
  Kuigi see pole nõutav, on soovitatav omada a tag protsessi sõlmes, mis näitab protsessi hetkefaasi või sammu. See tag saab seejärel kasutada faasitäitmise tingimustes SIMCA-online'is või SIMCA-s andmete importimisel. Väärtused selleks tag võib olla näiteksample "faas1", "puhastamine", "faas2".

Partii konteksti sõlm

• Partiisõlm on sõlm, mis jälgib partiide üle; nende partii identifikaatorid, algusajad ja lõpuajad. See on SIMCA-online'i pakettprojekti täitmise nõue. Andmeallikal võib olla rohkem kui üks pakettsõlm, mis paljastab partiid erineval viisil. Kasutaja valib partiisõlme, mis tema rakendusele kehtib. See eksample paljastab partiid, mis hõlmavad kahte erinevat üksust:
• /Tehas1 – partiid, mille kasutusiga on kokku võetud nii üksuse 1 kui ka üksuse 2 kohta.
• /Tehas1/Ühis1 – partiid, mille eluiga on ainult üksuses 1
• /Tehas1/Ühis2 – partiid, mille eluiga on ainult üksuses 2
• Kui teie andmeallikas pole partiisõlme, saate kasutada SIMCA-online'i partiikonteksti generaatorit. Vaadake sisseehitatud abi.
• Valikulised partiiandmed
• Pakettsõlm võib sisaldada ka partiiandmeid; andmed, mille kohta on kogu partii kohta ainult üks vaatlus. Pange tähele, et tags partiiandmetega ei pea asuma sõlmes, millel on kõik partiisõlme funktsioonid. Piisab, kui SimApi toetab pakettandmete lugemist tags. Lisateavet partiiandmete kohta leiate versioonist 7.6.
• Siin on endineamppartiisõlme le:
• Märkus. Ülaltoodud ekraanipilt on võetud DBMakerist, mis on komplektis SIMCA-online'iga. Kui soovite seda ise DBMakeris näha, klõpsake nuppu View Andmenupp Bakers Yeasti andmebaasis, et kuvada kaks akent, millest üks on partii sõlm ja teine ​​protsessiandmed.

Andmetüübid: arvandmed, tekstiandmed ja puuduvad andmed

• Igaühe jaoks tag, SimApi toetab kolme tüüpi andmeid: numbrilised, tex, t ja puuduvad:
• Arvandmed on tavaliselt protsessiparameetrite tegelikud väärtused, ntample 6.5123. SimApi saab käsitleda ainult 32-bitiseid ühe täpsusega ujukomaväärtusi. Ühe täpsusega ujukomavorming – Wikipedia. Kõik muud andmeallika numbrilised andmetüübid tuleks teisendada ujuvandmeteks. Sellisena saavad nad hakkama nii suurte kui ka väikeste väärtustega, kuid ainult umbes 6 või 7 olulise numbriga. Lisateavet leiate tehnilisest juhendist.
• See võib põhjustada täpsuse kaotust suurte täisarvude või reaalarvude puhul, mis on nii suured kui ka kümnendkohaga. Lisateabe saamiseks vaadake tehnilist juhendit.
• Teksti/stringi andmeid kasutatakse partii ID-de, faaside täitmise tingimuste või kvalitatiivsete muutujate jaoks. Teksti väärtused tag andmed on tõstutundlikud. See tähendab, et väärtus “jooks” ei ole sama, mis
  "JOOKSEMINE". SimApi ei toeta otseselt kuupäeva ja kellaaja muutujaid, kuid neid saab tagastada stringina vormingus AA-KK-PP HH:MM (ntample “2020-09-07 13:45”).
• Puuduvad väärtused tähendavad, et tagastatavat väärtust pole, st andmeid pole.
• Tagastamise tüüp sõltub SimApi juurutusest. SimApi teab andmeallikas olevaid andmeid ja peaks tagastama kõige sobivama andmetüübi.

Kolm andmeotsingurežiimi: pidev, Batc, h ja diskreetne

• SimApi spetsifikatsioon määratleb kolm andmete otsimise režiimi, st. SimApi saab andmeid edastada kolmel erineval viisil tags andmeallikas (või teises suunas: kirjutage andmed tags andmeallikas).
• Pidev andmete otsimine – see viitab andmetele, mida loetakse pidevalt ja järjestikku, vaatluse kohta partii või protsessi arenedes. Andmeid loetakse praeguse aja või kindla vahemiku kohta korrapäraste vaatluste vaheliste intervallidega. Näiteksample, kõik andmed vahemikus 09:00:00 kuni 10:00:00 sampiga 60 sekundi järel, mille tulemuseks on 61 vaatlust, kui lõpp-punktid on kaasa arvatud.
• Partiiandmete otsimine – see viitab ühele vaatlusele kogu partii andmetega (ei ole seotud konkreetse tähtaja või ajapunktiga). Komplekti atribuute ja kohalikke tsentreerimisandmeid loetakse SIMCA-online'is partiiandmetena. Partii tingimusi loetakse tavaliselt ka pakettandmetena (välja arvatud juhul, kui need on konfigureeritud andmete diskreetseks toomiseks).
• Diskreetne andmete otsimine – diskreetsed andmed võivad koosneda mitmest vaatlusest paljude tähtaegade kohta. Kuid erinevalt pidevatest andmetest ei loeta diskreetseid andmeid järjestikku, vaid pigem kõiki andmeid korraga partii konkreetse faasi kohta. Andmeid ei pea paigutama tähtaegade muutuja korrapäraste intervallidega. Kõik andmed loetakse uuesti iga kord, kui andmeid küsitakse, konfigureeritud intervalliga.
• Igasuguse etteantud jaoks tag andmeid saab taotleda mis tahes kolmest režiimist, kuid tavaliselt toetab SimApi üksikisiku jaoks ainult ühte neist režiimidest. tag. Samuti on lubatud segada tags sõlme sees, kuid tavaliselt kõik tags konkreetses sõlmes toetavad sama andmete otsimise režiimi.
• Pidevate andmete (kuid mitte pakett- või diskreetsete andmete2) jaoks saab taotleda jooksvaid andmeid või ajaloolisi andmeid, mis on järgmise jaotise teema.
• Kõik SimApis ei toeta kõiki režiime. Vaadake ülaltoodud funktsioonimaatriksit ja SimApi web lehel üksikasju.

Jooksvad ja ajaloolised pidevad andmed SimApi kaudu

• Pidevad andmed viitavad protsessiandmetele, mis aja jooksul muutuvad.

Praegused andmed

• Praeguste andmete lugemine tähendab andmeallikalt uusimate väärtuste küsimist tags küsimise ajal. Pange tähele, et siin ei kasutata välise andmeallika aega.
• Praeguste andmetena loetud andmeid näitab SIMCA-online reaalajas andmetena. Sel põhjusel on oluline, et andmeallikas ei tekiks tarbetuid viivitusi. Praegused andmed peaksid olema võimalikult värsked, et SIMCA-online'is hästi toimiksid.
• Andmeallikas võib kasutada oma teadmisi andmete ja väärtuste kehtivusaja kohta ning otsustada tagastada puuduvad andmed, kui ajapunkti algandmed on liiga vanad. Näiteksample: andmeid küsitakse kell 15:00:00, kuid kõige värskem andmepunkt andmeallikas on alates 03:00:00. Sel juhul on andmed 12 tundi vanad, nii et SimApi võib otsustada tagastada puuduva väärtuse (andmeid pole).

Ajaloolised andmed

• Ajalooliste andmete lugemine tähendab andmeallikalt ühe või mitme väärtuse küsimist tags kindla ajavahemiku jaoks kindla intervalliga vaatluste vahel. Pange tähele, et siin kasutatakse andmete leidmiseks andmeallika kohalikku aega. Seetõttu on oluline aja sünkroonimine andmeallika ja serverite vahel.
• Ajaloolised andmed koosnevad andmete maatriksist. SimApi juurutus peab andmeallikast andmeid küsima ja sampLaske see määratud intervalliga ja koostage tagastatavate andmete maatriks:
• Mõnikord on andmeallikal endal töödeldud andmete tagastamiseks koondamisfunktsioonid ehk sampling funktsioonid, mida saab kasutada õigete andmete tagastamiseks.
• Muude andmeallikate puhul peab SimApi taotlema kõiki andmeid ajavahemikus ja seejärel sample õiged tähelepanekud maatriksi koostamiseks.
• Andmed tuleb tagastada ajavahemiku kohta, kuigi ajavahemikus ei pruugi algandmeid olla, vaid vahetult enne algusaega. Näiteksample: andmed on andmeallikas olemas ajapunktides 10 ja 20. SimApi küsib andmeid aja 15 ja 17 kohta. Sel juhul peaks SimApi tagastama ajapunkti 10 väärtused, kuid timestamped ajaga 15 ja 17, kuna need olid tol ajal kõige värskemad andmepunktid. Väärtused jaoks tags ajahetkel 10 viidatakse taotletava vahemiku piirväärtustele. Piirväärtuste põhjalikuma selgituse saamiseks vt ntampUA osa 11: Ajalooline juurdepääs – 6.4.3 ReadRawModifiedDetails struktuur.
  (opcfoundation.org)
• Interpolatsiooni ei tohiks kunagi kasutada tulevaste ajapunktide väärtuste arvutamiseks, kuna andmed ei ühti reaalajas loetavate andmetega. Endise jaoksampEelmisest punktist: kui 15. ja 17. andmeid interpoleerida, kasutades üksuse 10 ja 20 väärtusi, kasutaksid nad tõhusalt väärtusi tulevikust, mis pole lubatud.
• Andmeallikas võib kasutada oma teadmisi andmete ja väärtuste kehtivusaja kohta ning otsustada tagastada puuduvad andmed, kui ajapunkti algandmed on vanad. Näiteksample: andmeid küsitakse 15:00:00 kohta, kuid andmeallikas on kõige värskem andmepunkt alates 03:00:00. Sel juhul on andmed 12 tundi vanad, nii et SimApi võib otsustada tagastada puuduva väärtuse (andmeid pole).

Märkus. SIMCA-online ei nõua tavaliselt projekti tavapärase täitmise ajal rohkem kui sada vaatlust ühes kõnes. Kui teete väljavõtet SIMCA-online'is või töölaua SIMCA-d, saate teha suuremaid andmepäringuid. Need võivad võtta kaua aega, mida on oodata.

Praegused andmed ja ajaloolised andmed peavad ühtima

• Mõnikord võib andmete lugemisel reaalajas jooksvate andmete või ajalooliste andmetena esineda erinevusi. See põhjustab SIMCA-online'is probleeme, kuna server lülitub vastavalt vajadusele automaatselt praeguste ja ajalooliste andmete vahel.

Madala latentsusega andmete kogumine

• Kui SIMCA-online kasutab andmeallikat reaalajas, on oluline, et andmeallika andmed oleksid ajakohased. Andmeallikas andmete hankimisel ei tohiks olla tarbetuid viivitusi. Kõigi muutujate pidevad protsessiandmed peavad olema kättesaadavad iga vaatluse jaoks samal ajal. SIMCA-online ei võta andmeid, mis mõne muutuja puhul saabuvad hilja.

Andmeid saab lugeda igal ajal 

• Kui SIMCA-online küsib väärtust a tag Aja t jaoks saab ta andmeallikast väärtuse ajahetkel t või viimase vaatlusandmeallikas enne aega t või interpoleeritud väärtuse aja t kohta. Seega saab server alati väärtuse iga kord, kui ta seda küsib, isegi kui selle täpse ajapunkti vaatlust andmeallikas ei pruugi olla.
• AegsaimampSimApis on alati UTC. SIMCA võrgukliendid ja SIMCA esitavad kellaaega kohaliku aja järgi.

Keermestamine 

• SimApi kasutaja kutsub SimApi vaikimisi ühe lõime kaudu. See kehtib kõigi SIMCA versioonide ja SIMCA-online kohta kuni versioonini 17.
• SIMCA-online 18 toetab funktsiooni lippu, et lülitada SimApi kaudu sisse mitme lõimega juurdepääs. Lisateavet leiate abiteemast Samaaegne SimApi juurdepääs.
• See tähendab, et SimApis peaks võimaluse korral valmistuma mitme lõime jaoks, muutes SimApi juurutamise lõime turvaliseks, ning dokumenteerima selle ja kõik SimApi kasutajate kaalutlused.

Logi sisse file

• SimApi peaks oma logisse logima toimingud, veateated ja hoiatused file aidata tõrkeotsingul. Logimise tähtsuse tähistamiseks kasutage erinevaid logitasemeid.
• Soovitatav on logida sisse „Pole rakendatud” funktsioonide puhul, mida pole SimApis rakendatud.

Vigade käsitlemine

• Kui SimApi ei saa andmeallika päringut täita, saab ta seda probleemi lahendada kahel viisil; tagastades puuduvad väärtused (andmed puuduvad) või andes märku SimApi veast:
• Puuduvate väärtuste tagastamine helistajale ja õnnestumisest märku andmine võimaldab helistajal normaalselt jätkata (kuid loomulikult ilma andmeteta). See on soovitatav tava osaliste vigade korral, näiteks kui andmeid on võimalik hankida mõne, kuid mitte kõigi, tags taotluses.
• SimApi veast teatamine võimaldab helistajal (ntampSIMCA võrguserver), et seda kohe näha ja tegutseda. See on soovituslik tava taotluste puhul, mis ebaõnnestuvad täielikult ja ei saa üldse andmeid tagastada.
• SIMCA-online käsitleb puuduvaid väärtusi või veakoode erinevalt, nagu on kirjeldatud SIMCA-online'i tehnilises juhendis.

SimApi jõudlusnõuded

• SimApi funktsioone kasutatakse andmete hankimiseks.
• Kui andmetele juurdepääs on aeglane, ei tööta SimApi hästi, mida see eksample näitab: Kui SIMCA-online küsib andmeid iga sekund, kuid selle hankimiseks kulub kaks sekundit, ei suuda SIMCA-online server kunagi reaalajas sammu pidada, vaid jääb järjest rohkem maha.
• Alamjaotistes näitame, kuidas SIMCA ja SIMCA-online kasutavad andmetele juurdepääsu SimApi funktsioone ja kui sageli SimApi funktsioone kutsutakse. See võib aidata SimApi juurutuse jõudlusnõuete määramisel.

SIMCA SimApi funktsioonide kasutamine

• Kui lauaarvuti SIMCA või muud võrguühenduseta tooted kasutavad andmete hankimiseks SimApi-d, on need päringud partiide ja muutujate kogumi andmete töötlemiseks teatud ajavahemikus.
• Kuna kasutaja algatab need päringud käsitsi, ei esine neid väga sageli ega põhjusta andmeallikale märkimisväärset koormust.
• Neid SimApi funktsioone kasutatakse andmete hankimiseks:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

SIMCA-online kasutab SimApi funktsioone

• SIMCA-online'i kasutatakse protsessi reaalajas jälgimiseks ja seetõttu küsib see SimApi kaudu regulaarselt andmeid. Lühim kasutatav täitmisintervall on 1 sekund. Mõni pärismaailma endineamptäitmisintervallid on 10 s, 1 minut või 10 minutit.
• Serveris võib korraga töötada mitu projekti.
• SimApi kaudu tehtavate API-kõnede arvu vähendamiseks optimeerib server andmepäringuid, rühmitades paljud samaaegsed väiksemad päringud üheks suuremaks päringuks kõigi muutujate jaoks korraga (lisateavet leiate abiteemast „Andmeallikate optimeeritud lugemine parandab jõudlust”).
• Serveri täitmisalgoritm töötab järgmiselt, kui see küsib andmeid, kasutades allpool loetletud SimApi funktsioone:
• Kõik sama intervalliga käivitatavad faasid on kõnede arvu vähendamiseks rühmitatud üheks SimApi kõneks. Server loeb uusimaid andmeid kõigi muutujate kohta, mida kasutavad kõik mudelid, mis jagavad intervalli, st selle kõne tulemuseks on lai andmerida, mida seejärel kasutavad kõik projektid.
  • simapi2_connectionReadCurrentData
• Iga pakettprojekti puhul peab server teadma, millised partiid on aktiivsed. See peab juhtuma ka iga kord, kui projekt käivitub:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes kutsutakse harvemini.
• Lisaks nõuab SIMCA-online ka ajaloolisi andmeid. Need päringud toimuvad ainult vajaduse korral, näiteks jõuavad järele enne SIMCA-online'i käivitamist alanud partii algust või kui server jääb maha ja peab lugema andmeplokki:
  • simapi2_connectionReadHistoricalDataEx
• Valikuliselt kasutab mõni projekti konfiguratsioon funktsioone, mis kasutavad pakettandmeid või diskreetseid andmeid, mille tulemuseks on SimApi kõned:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Valikuliselt kasutab mõni projekti konfiguratsioon andmete tagasisaatmiseks andmeallikasse tagasikirjutamist.
  • simapi2_connectionWriteHistoricalDataEx (ja vastavad funktsioonid pakettandmete, diskreetsete andmete jaoks)
• On oluline, et iga kõne andmete hankimise põhifunktsioonidele, readCurrentData, getActiveBatches/getBatchTimes, oleks kiire ja see ei oleks andmeallika enda jaoks arvutuslikult keeruline, arvestades, kui sageli võib SIMCA-online neid funktsioone kutsuda.

SimApi andmete testimine ja kinnitamine

• See jaotis käsitleb SimApi testimist, et kontrollida, kas sellelt tagastatud andmed vastavad andmeallika enda andmetele. Selliste testide käitamine on oluline pärast SimApi juurutuse loomist või muutmist või kui andmeallika API muutub.
• Praktikas toimub andmete valideerimine SIMCA-online'i ja selle ekstraktimise funktsiooni abil, et tõmmata andmed andmeallikast SimApi kaudu ja seejärel võrrelda neid andmeallika algandmetega. Töölaua SIMCA-d ei saa kasutada SimApi reaalajas aspektide testimiseks.

Ettevalmistused ja nõuded

• Mõned üksused on valikulised, kuid neid saab teha, kui teie testimise ulatus hõlmab seda.

1. Installige SIMCA-online, nagu on kirjeldatud jaotises ReadMe ja Installation Guide.pdf, mis on toote ZIP-pakendis.
2. Hankige SIMCA-online-serveri jaoks litsents ja installige see. SimApi ei tööta ilma litsentsita. SIMCA-online'i teadmistebaasi artikkel näitab, kuidas toodet litsentsida. Näiteksample: SIMCA-online 18 (sartorius.com)
3. Installige ja konfigureerige SimApi, mida soovite testida. Vaadake selle dokumendi peatükke 4–5 ja konkreetse SimApi kasutusjuhendit.
   • a. Valikuline: veenduge, et kasutusjuhend oleks ajakohane ja õige.
4. Veenduge, et teil oleks andmeallika jaoks tööriist, millega saate SimApi andmeid võrrelda.
5. SIMCA-online töölauakliendis logige sisse oma SIMCA-online-serverisse ja kasutage File > Väljavõte andmete hankimiseks SimApi kaudu.
6. Valikuline, kui teie testimisulatus seda hõlmab: pärast testimise lõpetamist desinstallige SimApi ja kontrollige seda files eemaldatakse.

Mida testida

• Peatüki 3 funktsioonimaatriks loetleb kõik võimalikud funktsioonid, kuid antud SimApi rakendus võib toetada ainult alamhulka. Peaksite testima kõiki funktsioone, mida antud SimApi rakendab.
• Järgmised testid on enamiku SimApi rakenduste jaoks ühised.
• Autentimine kasutajanimede ja paroolidega
• Testige SimApi konfiguratsioonis erinevaid seadeid
• Sõlmede hierarhia: sõlmed ja tags SimApi paljastatud on õiged.
  • Peab olema a tag avaldatakse kõigile "muutujatele", mis peaksid olema SimApi kaudu saadaval. Ntamples: protsessi mõõtmised, arvutatud väärtused, konstandid.
• Ühenduse vastupidavus: kui andmeallikas pole saadaval, kuvatakse logis hoiatused või vead file, kuid ühendus andmeallikaga taastatakse automaatselt, kui andmeallikas on saadaval.
• Mitu eksemplari: et kahte eksemplari saab konfigureerida ja kasutada iseseisvalt ja samaaegselt, eraldi logidega files.
• Praegused andmed: ekstraktige praegused andmed tags. Veenduge, et andmed oleksid andmeallika viimased teadaolevad väärtused või puuduksid halva kvaliteedi või liiga vanade andmete tõttu.
  • Ekstraktige andmed iga 10 sekundi järel (või nii) minuti jooksul.
• Ajaloolised pidevandmed: eraldage ajaloolised andmed tags.
  • Kasutage ajavahemikku, mis ühtib praeguste andmete ekstraheerimisega. Veenduge, et praegused andmed ühtivad ajalooliste andmete ja andmeallika algandmetega.
  • Proovige erinevaid ajavahemikke ja samplingi intervallidega, kontrollige andmete vastavust andmeallikale.
  • Proovige andmeid ekstraheerida iga 1 sekundi järel, mis on lühim võimalik sampling intervall.
  • Proovige erinevat tüüpi tags andmeallikas (protsessimuutujad jne), tagades andmete vastavuse.
  • Märkus. SIMCA-online võib jagada ühe suure ajaloolise andmepäringu mitmeks väiksemaks osaks. See on nähtav SimApi logis.
• Veenduge, et SimApi töötab tekstiandmete, arvandmete ja puuduvate andmetega.
• SimApi logi file. Veenduge, et logi sisaldab mõistlikke sissekandeid.
• Partii sõlm: paremklõpsake sõlme ja tehke Otsi partiid.
  • Kontrollige partiide nimesid, algusaegu ja lõppaegu.
  • Proovige aktiivset paketti, mis töötab andmeallikas. Sellel ei tohiks SimApi kaudu olla lõpuaega.
• Protsessi sõlme partii identifikaator tag. Kui SimApil on partiisõlme funktsionaalsus (vt eelmist punkti), peab sellel olema ka partii identifikaator tag sobitusprotsessi andmete sõlmes. Andmed selleks tag peaks olema partii identifikaator (partii nimi). Neid andmeid on vaja pakettprojektide jaoks, et tuvastada, millisesse partii andmerida kuulub.

Olenevalt sellest, kas SimApi seda toetab, võite testida ka:

• Pakettandmete kasutamine File > Väljavõte.
• Diskreetsete andmete kasutamine File > Väljavõte. Märkus: diskreetsete andmete testimiseks File > Ekstraktige sõlm, pakettsõlm ja diskreetne andmesõlm peavad asuma samas SimApis (kui SIMCA-online projekte täidab, võivad need olla erinevatest SimApidest).
• Kirjuta tagasi – andmepaketi surumine andmeallikasse. Selle testimiseks peate SIMCA-online'is konfigureerima projekti konfiguratsiooni, et andmevektorid andmeallikasse tagasi kirjutada. Seejärel käivitage projekt SIMCA-online'is ja kontrollige andmeid, mis on andmeallikas tagasi kirjutatud.
• Pidevad andmed konfigureeritakse projekti konfiguratsiooni lehel Evolution Write Back.
• Diskreetsed andmed on konfigureeritud samal lehel, kuid ainult faasi jaoks, mis on konfigureeritud diskreetseks andmete toomiseks.
• Partii andmed partii tagasikirjutamisest

LISATEAVE

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Rootsi
• Telefon: + 46 90-18 48 00
• www.sartorius.com
• Selles juhendis sisalduv teave ja arvud vastavad allpool märgitud versioonikuupäevale.
• Sartorius jätab endale õiguse teha seadmete tehnoloogias, omadustes, spetsifikatsioonides ja disainis muudatusi ette teatamata. Mees- või naissoost vorme kasutatakse nendes juhistes loetavuse hõlbustamiseks ja need tähistavad alati samaaegselt kõiki sugusid.
  Autoriõiguste teatis:
• Need juhised, sealhulgas kõik komponendid, on autoriõigusega kaitstud.
• Igasugune kasutamine väljaspool autoriõiguse seaduse piire ei ole lubatud ilma meie nõusolekuta.
• See kehtib eelkõige kordustrükkimise, tõlkimise ja toimetamise kohta, olenemata kasutatud kandja tüübist.

KKK

• K: Mis on SimApise eesmärk?
  • V: SimApise põhieesmärk on anda andmeid Umetrics Suite'i toodetele projekti loomiseks ja mudelite loomiseks.
• K: Kuidas saan SimApi installiga seotud probleeme lahendada?
  • V: Saate tõrkeotsingut teha, testides SIMCA-online'is, kontrollides SimApi logi fileja teenusekonto õige konfiguratsiooni tagamine.

Dokumendid / Ressursid

SARTORIUS Sim Api tarkvara [pdfKasutusjuhend Sim Api tarkvara, Api tarkvara, tarkvara

Viited

• Kasutusjuhend