SARTORIUS Sim Api softver

Specifikacije

• Naziv proizvoda: SimApi Guide
• Datum izlaska: 5. septembar 2024
• Svrha: Pružanje podataka Umetrics Suite proizvodima

Upute za upotrebu proizvoda

Uvod u SimApis

• SimApis se koristi za dohvaćanje podataka za kreiranje projekta i izgradnju modela u Umetrics Suite proizvodima.

Dobijanje SimApisa

• Da biste dobili SimApis, pogledajte zvaničnu dokumentaciju ili kontaktirajte korisničku podršku za pomoć.

SimApi karakteristike

• SimApis pruža podatke u realnom vremenu za praćenje, kontrolu i izgradnju modela u SIMCA i SIMCA-online.

Samo trenutna upotreba podataka

• Preporučuje se korištenje samo trenutnih podataka i izbjegavanje povijesnih podataka za optimalne performanse.

Priprema za SimApi instalaciju

• Prije instalacije, uvjerite se da vaš sistem ispunjava minimalne zahtjeve navedene u korisničkom vodiču.

Instaliranje SimApi

• Slijedite upute korak po korak date u korisničkom priručniku kako biste instalirali SimApi na svoj sistem.

Postavljanje SimApi za SIMCA

• Konfigurišite SimApi postavke u SIMCA u skladu sa datim smernicama.

Postavljanje SimApi za SIMCA-online

• Postavite SimApi za preuzimanje podataka u realnom vremenu i operacije upisivanja u SIMCA-online.

Testiranje i rješavanje problema

• Nakon instalacije, izvršite testiranje kako biste osigurali ispravnu funkcionalnost. U slučaju problema, pogledajte odjeljak za rješavanje problema u korisničkom vodiču.

Testiranje sa SIMCA-online

• Testirajte SimApi integraciju sa SIMCA-online da biste potvrdili preuzimanje podataka.

Rješavanje problema s Logom Files

• Koristite SimApi dnevnik file za identifikaciju i rješavanje bilo kakvih instalacijskih ili operativnih problema.

Konfiguracija računa usluge

• Osigurajte ispravnu konfiguraciju naloga SIMCA-online usluge za nesmetan rad.

Technical Details

• Pogledajte odjeljak 7 korisničkog vodiča za detaljne tehničke informacije o SimApisu.

Uvod u SimApis

• SimApi je softversko sučelje između softvera Umetrics® Suite i izvora podataka. Primarna svrha SimApi-ja je pružanje podataka SIMCA®-online ili SIMCA®.
• Sartorius Stedim Data Analytics AB razvija SimApis za mnoge različite izvore podataka, kao što su historičari procesa i baze podataka opće namjene.
• Ovaj dokument pokazuje šta je SimApi i kako se koristi u Umetrics Suite proizvodima. Naučit ćete kako planirati i instalirati SimApi, kako riješiti probleme i kako testirati svoju instalaciju. Završno poglavlje sadrži tehničke detalje SimApisa namijenjene programerima.

SimApi svrha: pružanje podataka proizvodima Umetrics Suite

• Primarna svrha SimApi-ja je pružanje podataka SIMCA-online ili SIMCA iz izvora podataka. Izvor podataka nije dio SIMCA-online, ali može biti historičar procesa ili drugi sistem koji čuva i upravlja podacima.
• SimApi izlaže hijerarhiju čvorova, koja odgovara folderima u a file sistem. Svaki čvor može sadržavati druge čvorove, ili tags. A tag odgovara promenljivoj. Za ove tags, podaci se mogu dobiti. Slika prikazuje a tag, Temp, odabrano u čvoru
• BakersYeastControlGood u izvoru podataka u SIMCA-online. Također prikazuje najnovije vrijednosti preuzete iz izvora podataka.

Upotreba SimApi-a u Umetrics Suite-u

• Softver za desktop računare SIMCA može koristiti SimApi za preuzimanje podataka za kreiranje projekta i izgradnju modela kao što ilustruje sljedeća slika.
• SIMCA-online koristi SimApis za dobijanje podataka u realnom vremenu za praćenje i kontrolu, kao i vraćanje podataka u izvor podataka. Sljedeća slika pokazuje gdje se SimApi nalazi u sistemu koji se sastoji od izvora podataka, SIMCA-online servera i klijenata.

Često korišteni SimApis

• Najrasprostranjeniji SimApis su:
• PI AF SimApi za povezivanje sa Aveva (ranije OSIsoft) PI sistemima.
• OPC UA SimApi
• ODBC SimApi – za opšti pristup bazama podataka kao što su SQL Server ili Oracle
• Svi dostupni SimApis su navedeni zajedno sa njihovim karakteristikama u paragrafu 3.

DBMaker SimApi za simulacijske podatke

• DBMaker je aplikacija koja se isporučuje sa instalacijom SIMCA-online servera. On simulira izvor podataka, kao što je historičar procesa, koristeći unaprijed učitanu tablicu podataka u kojoj se zapažanja daju jedno po jedno SIMCA-online putem DBMaker SimApi.
• DBMaker se koristi samo u svrhu demonstracije i ne može se koristiti u proizvodnji sa živim podacima iz izvora podataka. Pogledajte ugrađenu pomoć da saznate više o DBMakeru.

Dodatna dokumentacija

• Ovaj dokument je jedan od skupa povezanih dokumenata, svaki sa drugačijim fokusom i ciljnom publikom:

Izvor	sta	Gdje
SIMCA-online web stranica	Uvodne informacije i preuzimanja	sartorius.com/umetrics-simca- online

SIMCA-online ReadMe i Installation.pdf	Instalacija i kako započeti sa SIMCA-online demo podacima	U instalacijskom zip-u file
SIMCA-online vodič za implementaciju	Ocrtava SIMCA-online funkcionalnost, stavlja je u kontekst s drugim softverom Umetrics Suite, opisuje zahtjeve i najbolje prakse za uspješnu implementaciju, te uputstva za instalaciju korak po korak.	sartorius.com/umetrics-simca- online
SimApi vodič	Priprema i izvođenje SimApi instalacija, uključujući rješavanje problema. Također sadrži tehničke detalje o SimApisu za programere.	sartorius.com/umetrics-simapi
SimApi korisnički vodiči	Dokumentacija za svaki objavljeni SimApi sa karakteristikama, uputstvima za instalaciju i specifičnostima konfiguracije.	sartorius.com/umetrics-simapi
SIMCA-online tehnički vodič	Tehnička referenca za planiranje instalacije SIMCA-online servera, rješavanje problema i detaljan način rada SIMCA-online.	sartorius.com/umetrics-simca-online
SIMCA-online pomoć	Web-pomoć zasnovana na tome kako koristiti SIMCA-online i kako SIMCA-online funkcionira.	U samom softveru i dalje sartorius.com/umetrics-simca
SIMCA-online Web Vodič za instalaciju klijenta	Opisuje instalaciju SIMCA-online Web Klijent.	sartorius.com/umetrics-simca-online
Baza znanja umetrije	Baza podataka koja se može pretraživati ​​sa člancima o svakoj objavljenoj verziji softvera, tehničkim člancima i poznatim problemima u Umetrics Suite proizvodima.	sartorius.com/umetrics-kb
SIMCA pomoć/korisnički vodič	Kako koristiti desktop SIMCA za kreiranje projekata i modeliranje podataka.	U SIMCA i dalje sartorius.com/umetrics-simca
Podrška web stranica	Kako dobiti tehničku podršku.	sartorius.com/umetrics-support

Tehnička podrška

• Sartoriusov online tim za podršku odgovara na tehnička pitanja o SimApisu i može proslediti zahteve za poboljšanje SimApisa odgovarajućim ljudima. Saznajte više na sartorius.com/umetrics-support.

Dobijanje SimApisa

• Pružamo dokumentaciju za dostupni SimApis i linkove do instalacionih programa na sartorius.com/umetrics-simapi.
• Svaki SimApi je dokumentovan u korisničkom priručniku.
• SimApi vodič, koji ne čitate, dopunjuje te informacije SimApi dopunskim informacijama kada je u pitanju planiranje, instalacija i rješavanje problema SimApi-ja.

SimApi karakteristike

• Nisu svi izvori podataka isti. SimApi ne mora implementirati sve funkcije u specifikaciji. Iz ovih razloga, različiti SimApis nude različite funkcionalnosti. Sljedeća matrica navodi dostupne SimApis i njihove karakteristike.
• Karakteristike su objašnjene u nastavku. Obratite pažnju da tabela ima zasebne kolone koje pokazuju koje su funkcije dostupne u SIMCA-online i SIMCA.

Feature	Svrha	SIMCA-online upotreba	Upotreba SIMCA
Trenutni podaci	Pročitajte jedno zapažanje s najnovijom vrijednošću iz izvora podataka.	Normalno izvršenje u realnom vremenu	–
Istorijski podaci	Čitajte mnoga zapažanja odjednom s historijskim podacima iz izvora podataka.	Nadoknaditi i predvidjeti podatke iz prošlosti, kreirati projekte koristeći File > Novo	Čarobnjak za uvoz baze podataka za uvoz podataka procesa za kreiranje modela.
Diskretni podaci	Pročitajte laboratorijske/IPC podatke iz izvora podataka. Mnogo zapažanja po seriji.	Za paketne projekte sa fazama ili paketnim uvjetima konfiguriranim za diskretno dohvaćanje podataka.	–
Batch podaci	Pročitajte uslove serije i konačne atribute kvaliteta (ili	Uvjeti serije ili lokalno centriranje.	Čarobnjak za uvoz baze podataka za čitanje uslova serije

Feature	Svrha	SIMCA-online upotreba	Upotreba SIMCA
	drugi podaci tipa MES). Jedno zapažanje po seriji.		kreiranje modela na nivou serije.
Batch čvor	Odredite vrijeme početka i vrijeme završetka (prazno za aktivnu seriju) za određenu seriju. Nabrojite sve serije koje su postojale u vremenskom rasponu.	Potreban za izvršavanje paketnih konfiguracija.	Čarobnjak za uvoz baze podataka za odabir serija za uvoz.
Vraćanje – kontinuirani podaci	Pišite kontinuirane podatke, kao što su predviđanja, nazad u izvor podataka.	Zapišite podatke sa nivoa evolucije serije, za Control Advisor ili za kontinuirane konfiguracije	–
Pišite nazad – diskretno	Zapišite diskretne podatke, kao što su predviđanja, nazad u izvor podataka.	Pišite nazad za konfiguracije serije na nivou evolucije serije za faze konfigurirane za diskretno dohvaćanje podataka	–
Vraćanje – skupni podaci	Zapišite podatke na razini serije, kao što su predviđanja ili konačni atributi kvalitete, u izvor podataka.	Napišite nazad za konfiguraciju serije na nivou serije	–
Hijerarhija čvorova	SimApi podržava hijerarhiju čvorova, slično kao a file sistem. Svaki čvor može sadržavati tags i drugi čvorovi. Hijerarhija olakšava upravljanje velikim brojem čvorova i tags.	Podržano na svim mjestima gdje tags se koriste.
Niz tag ekspanzija	Niz tag pohranjuje više vrijednosti. SimApi proširuje niz tag mnogim pojedincima tags, po jedan za svaki element u nizu.	Podržano gdje tags se koriste za kontinuirane podatke. Svaki proširen tag mora biti mapiran na varijablu u SIMCA projektu.
Više izvora podataka	SimApi se može povezati na više od jednog izvora podataka ili podržava višestruke instance sebe s pojedinačnim postavkama i dnevnikom files za svaku instancu.	Povežite se na nekoliko različitih izvora podataka iste vrste.	–
Otpornost veze	Ako se SimApi isključi s izvora podataka, pokušat će automatski ponovo uspostaviti vezu.	SimApi se ne mora ponovo pokrenuti da bi se ponovo uspostavile veze sa izvorom podataka.	–
Razvijeno u kući	SimApi je razvijen, obezbeđen i podržan od strane

Ne preporučuje se samo trenutni podaci, bez istorijskih podataka

• Neki SimApis, posebno OPC DA, podržava samo čitanje trenutnih podataka, a ne i istorijskih podataka.
• SimApi koji podržava samo trenutne podatke ne može se koristiti u SIMCA za desktop računare, jer neće moći čitati istorijske podatke na kojima će se graditi modeli.
• Za SIMCA-online, toplo preporučujemo izvor podataka i SimApi koji pružaju ne samo trenutne podatke za izvršenje u realnom vremenu, već i historijske podatke kako bi mogli predvidjeti i sustići podatke iz prošlosti. SIMCA-online automatski prebacuje između podataka u stvarnom vremenu i historijskih podataka po potrebi i ovo se ne može isključiti.
• Izvor podataka koji pruža samo trenutne podatke, ali ne i istorijske podatke, može raditi za kontinuirane projekte u SIMCA-online, ali za paketne projekte su potrebni historijski podaci.

Priprema za SimApi instalaciju

• Ovaj odjeljak opisuje važne informacije za uspješnu instalaciju SimApi-ja.

64-bitni ili 32-bitni SimApis

• Postoje 32-bitne i 64-bitne verzije svakog SimApi-ja.
• SIMCA-online i SIMCA su 64-bitne i zahtijevaju 64-bitne SimApis varijante. Naslijeđeni 32-bitni SimApis je još uvijek dostupan za starije instalacije.

Lokacija za log file i postavke

• SimApi pohranjuje svoj dnevnik files u skrivenom folderu Program Data1:
  %programdata%\Umetrics\SimApi, gdje se %programdata% mapira u stvarni folder na vašem računaru. Podrazumevano je C:\ProgramData.
• Svaki SimApi obično koristi svoj vlastiti dnevnik file, što je slično SIMCA-online serverskom logu file će sadržavati više ili manje podataka ovisno o postavci razine dnevnika. Ovo file je korisno za rješavanje problema. Dnevnik file je imenovan
  .log gdje je SimApi koji instalirate, nprample PIAFSimApi. Također pogledajte sljedeći odjeljak za imena SIMCA-online SimApi instanci.
• Ovaj folder također sadrži SimApi postavke u XML-u file imenovani .xml.
• Većina SimApisa ima grafičko korisničko sučelje koje mijenja postavke u xml-u file, ali za neke promjene unosite direktno u XML file sa uređivačem teksta, kao što je Notepad. Pogledajte korisnički vodič za svaki SimApi.

File imena kada se imenovane instance koriste sa SIMCA-online

• U SIMCA-online, svaka SimApi instanca dobija svoju konfiguraciju file i log file za rad sa višestrukim instancama svakog SimApi-ja. Imena ovih files su sufiksirani imenom instance kao što je dato na kartici SimApi u dijalogu SIMCA-online Server Options.
• Sljedeći prample prikazuje njihovo imenovanje files, gdje treba zamijeniti SimApi imenom.
• Ime konfiguracije dato kada se instanca doda: OmegaServer
• Konfiguracija file ime: OmegaServer.xml
• Dnevnik file ime: OmegaServer.log
• Imajte na umu da generički file .log file je i dalje kreirana. Ovaj dnevnik file sadrži unose koji se iz tehničkih razloga ne mogu usmjeriti na dnevnik file od slučajeva..
• Ova fascikla je podrazumevano skrivena u Windows-u. Da to vidim unutra File Eksplorer konfigurišete da se prikazuje skriveno files. Imajte na umu da do skrivenog foldera možete doći upisivanjem adrese File Adresna traka Explorera.
• Imajte na umu da SIMCA ne podržava višestruke instance SimApi-a i stoga koristi imena bez imena instance kao što je gore opisano.

Mrežno planiranje

• Trebali biste locirati SIMCA-online server blizu izvora podataka u mreži. Ovo osigurava brzu vezu između SIMCA-online i njegovog izvora podataka.
• Mrežna oprema može ometati vezu između SIMCA-online i izvora podataka.

Korisnički računi i dozvole izvora podataka

• Izvori podataka obično kontroliraju pristup svojim podacima. Ovo se obično radi sa korisničkim imenima i lozinkama, ali se takođe mogu koristiti ograničenja zasnovana na IP adresi ili DNS-u (npr.ample PI Trusts u Aveva PI System).
• Korisničko ime i lozinka mogu se dati izvoru podataka na različite načine:
• SimApi se pokreće kao Windows korisnik korisnika koji koristi desktop SIMCA ili SIMCA-online servisni nalog na serverskom računaru. SimApi se može povezati s izvorom podataka pomoću ovog naloga. Ovako rade OPC I i PI SimApi i ODBC ako ne date vjerodajnice prilikom konfigurisanja.
• Za generički ODBC možete koristiti aplikaciju ODBC Data Sources Administrator koja se nalazi na Start u Windowsu.
• Neki provajderi baza podataka obezbeđuju sopstvene drajvere i alate za svoje baze podataka. Oracle baze podataka, nprampda koristite Oracle Data Access Components (ODAC).
• Neki SimApis, kao što su PI AF i ODBC, imaju dijaloge za konfiguraciju koji pohranjuju šifrirane vjerodajnice u SimApi XML konfiguraciji file.
• PI također ima različite sigurnosne opcije dostupne u PI alatima za upravljanje sistemom na računaru PI servera. Pročitajte više u PI AF SimApi korisničkom vodiču. Ovaj vodič je od pomoći čak i ako koristite stariji OSIsoft PI SimApi.
• OPC DA i HDA koriste DCOM kao transport između izvora podataka i SimApi-ja. DCOM je konfigurisan pomoću alata Component Services (DCOMCNFG.EXE) u Windows-u i koristi Windows autentifikaciju.
• Za stariji OSIsoft PI SimApi (ne noviji AF SimApi), aplikacija OSIsoft AboutPI-SDK (PISDKUtility.exe) se koristi za postavljanje veze sa PI serverom.

Provjera povezanosti izvora podataka
Kada želite da instalirate SimApi na računar, može biti korisno da proverite povezanost tog računara sa izvorom podataka pomoću drugog alata:

• ODBC izvori podataka u Windows-u se koriste za konfiguriranje i testiranje generičkog ODBC-a. Imajte na umu da postoje dvije verzije ovog alata na 64-bitnom Windowsu: jedna za 32-bitne aplikacije i jedna za 64-bitne. Koristite dugme Test Data Source na kraju čarobnjaka za ODBC konfiguraciju da biste potvrdili povezanost sa bazom podataka. Preporučujemo da konfigurirate svoje izvore podataka kao sistemske DSN-ove.
• Alat za povezivanje specifičan za bazu podataka od dobavljača baze podataka, kao što je Oracle Data Access Components.
• PI System Explorer se može koristiti za testiranje povezanosti sa PI AF serverom. To je dio PI AF Client-a koji je preduvjet za PI AF SimApi.
• OPC UA Expert iz Unified Automation – UaExpert je višeplatformski test klijent za OPC UA servere.
• PI-SDK aplikacija (PISDKUtility.exe) se može koristiti za testiranje povezivanja i za view sve poruke o grešci koje su mogle biti zabilježene kada SIMCA-online pokuša da se poveže na PI server. Ovo se koristi samo za stariji OSIsoft SimApi, a ne PIAF.
• Alati za upravljanje PI sistemom se koriste na računaru PI servera za rešavanje problema sa te strane. Za nprampda potražite bezbednosne probleme koji sprečavaju pristup sa SIMCA-online servera. Saznajte više o rješavanju problema sa PI sistemom u ovom YouTube videu.
• Excel se može koristiti za dobijanje podataka iz ODBC veze i većine drugih sistema kada je instaliran odgovarajući dodatak.
• Matrikon OPC Explorer za Ior HDA (ovo su odvojeni alati) se može koristiti za testiranje OPC povezivanja, a Matrikon OPC Analyzer se može koristiti za dijagnosticiranje problema s OPC vezom. Preuzmite ove besplatne alate sa https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (za DInd HDA) iz Instituta za obuku OPC web stranica „omogućava korisnicima da lako dijagnosticiraju komunikacijske i sigurnosne probleme i odmah ih poprave pritiskom na dugme. Sve ovo se može uraditi bez potrebe da naučite da konfigurišete DCOM“

Instaliranje SimApi

Evo kako instalirati SimApi na PC:

1. Pročitajte Korisničko uputstvo za SimApi koji instalirate. Sadrži pojedinosti za taj SimApi koje dopunjuju opća uputstva koja sada čitate.
2. Instalirajte i konfigurirajte sve preduslove navedene u SimApi korisničkom vodiču (nprampdrajvere baze podataka ili SDK-ove)
3. Pokrenite program za instalaciju da biste instalirali SimApi. Instalirajte 64-bitnu (x64) ili 32-bitnu (x86) verziju koja odgovara softveru u kojem ćete ga pokrenuti.
4. Konfigurišite SimApi u SIMCA-online ili SIMCA kako je opisano u sledećim odeljcima i pogledajte uputstvo za upotrebu SimApi za opise dostupnih postavki.
5. Pokrenite SIMCA-online server. Imajte na umu da ovo može potrajati, jer kada se SimApi inicijalizira, on će sve nabrojati tags u izvoru podataka.
6. Testirajte SimApi tako što ćete dobiti neke podatke. Za SIMCA-online možete koristiti File > Ekstrakt kao što je opisano u 6.1.
7. Ako SimApi ne radi kako je očekivano, pogledajte SimApi dnevnik files za rješavanje problema i SimApi korisnički vodič.

Podešavanje SimApi za upotrebu u SIMCA

Evo kako koristiti SimApi u SIMCA:

1.  Pokrenite uvoz baze podataka na jedan od sljedećih načina:
   • a. Za kreiranje novog projekta u SIMCA: File > Novi redovni projekat ili novi skupni projekat. Odaberite Iz baze podataka na kartici Početna.
   • b. Da biste uvezli skup podataka u postojeći projekat u SIMCA: Iz skupa podataka na kartici Podaci otvorenog SIMCA projekta.
2. Kliknite Dodaj novi izvor podataka
3. Odaberite SimApi kao tip veze, kliknite na ...-dugme i locirajte .dll u instalacionoj fascikli i kliknite na Otvori.
4. Kliknite na Konfiguriši i pogledajte individualni SimApi korisnički priručnik kako napraviti postavke.
5. Kliknite na Testiraj vezu izvora podataka da potvrdite da se možete povezati s bazom podataka. Ovo može potrajati dugo ako ih ima mnogo tags u izvoru podataka.
6. Kliknite OK da dovršite konfiguraciju.
7. Pogledajte SIMCA pomoć za rad sa uvezenim podacima.

Podešavanje SimApi za upotrebu u SIMCA-online

• Važno: Da biste mogli koristiti SimApi, potrebna je SIMCA-online serverska licenca. Demo instalacija SIMCA-online ne dozvoljava korištenje SimApisa.
• Da biste dodali SimApi sistemu, pokrenite SIMCA-online Server Options na serverskom računaru. Naučite detaljne korake u temi SICMA-online pomoći Dodajte i konfigurirajte SimApi na poslužitelju.
• Savjet: Ako unesete promjene za SimApi, možete ponovo pokrenuti taj SimApi odvojeno od Server Options bez ponovnog pokretanja cijelog servera.
• Da biste konfigurirali više instanci ovog SimApi-ja, ponovite gore navedene korake i koristite jedinstvena imena za svaku instancu. Pročitajte više o različitim zapisnicima i konfiguraciji files za slučajeve u 4.2.

Testiranje i rješavanje problema sa SimApi

• Ovo poglavlje govori o testiranju i rješavanju problema sa SimApi instalacijom.

Testiranje SimApi-a sa SIMCA-online

• Kada se SIMCA-online server uspešno pokrene, možete testirati svoj SimApi u SIMCA-online (ako se server ne pokrene, pogledajte 6.2):
• Prijavite se na server u SIMCA-online klijentu i idite na Ekstrakt na File tab. Ekstrakt vam pomaže da testirate SimApi dobijanjem podataka preko njega:
• Čvorovi (“folderi”) SimApi-a su prikazani u lijevom okviru. Tags za izabrani čvor su prikazani u gornjem desnom uglu.
• Trenutni podaci se mogu brzo testirati jednostavnim klikom view> uključeno tags koji pružaju podatke o kontinuiranom procesu (pogledajte snimak ekrana)
• Kliknite desnim tasterom miša na čvor da biste pronašli serije unutar vremenskog raspona. Čvor mora biti batch čvor koji zna za serije.
• Odaberite tags u Izdvoji i kliknite na Sljedeće i završite čarobnjak da biste dobili podatke koristeći različite načine preuzimanja podataka: trenutni, historijski, skupni i diskretni podaci.
• Uporedite izdvojene podatke sa onim što vidite u svom izvoru podataka koristeći njegove alate. Saznajte više o testiranju i validaciji svih karakteristika SimApi-a u verziji 7.13.

Rešite probleme sa SimApi koristeći SimApi dnevnik file

• Ako se server ne pokrene, SimApi ne radi kako se očekivalo ili ekstrakt ne uspije, trebate pogledati SimApi dnevnik file što vam govori u čemu je problem. Omogućite evidentiranje na nivou otklanjanja grešaka u SimApi dnevniku da dobijete sve detalje. Vidi 4.2.
• Napomena: zapisnici SIMCA-online servera ovdje nisu toliko korisni. Oni će pokazati kako je SimApi učitan i inicijaliziran od strane servera, ali specifični detalji za SimApi nalaze se u njegovom dnevniku file.

Koristite odgovarajući SIMCA-online nalog za uslugu

• Kada testirate pristup izvoru podataka, imajte na umu da ste prijavljeni kao određeni korisnik na serverskom računaru (obično vaš vlastiti korisnički nalog u Windows domeni), ali da je nalog usluge SIMCA-online servera drugi nalog, podrazumevano LocalSystem, koji ima različita prava pristupa u odnosu na vaš korisnički nalog.
• Iz tog razloga, nije neuobičajeno da testovi rade kada se pokreću kao vaš nalog, ali da SIMCA-online ne uspe da se poveže sa izvorom podataka.
• Da biste riješili ovaj problem, pristup mora biti odobren za račun koji koristi SIMCA-online serverska usluga. Tipično, promijenite LocalSystem u određeni račun usluge domene i dodijelite prava ovom računu. Imajte na umu da se ovo ne primjenjuje ako SimApi koristi vjerodajnice koje su postavljene u SimApi konfiguraciji jer ti vjerodajnici imaju prednost.

Tehnički detalji na SimApisu

• Ovo poglavlje daje tehničke detalje o tome kako SimApi radi. Uglavnom je usmjeren na programere koji žele razumjeti SimApis da implementiraju SimApi za izvor podataka.
• Programeri bi također trebali pročitati ranije dijelove ovog dokumenta za uvod u SimApis i opise funkcija na visokom nivou.

Kada razmisliti o razvoju SimApi, a kada ne?

Prije nego što razmislite o razvoju SimApi za izvor podataka:

1. Istražite postoji li već SimApi koji možete koristiti. Možda možete omogućiti neku funkciju u svom izvoru podataka za korištenje jednog od postojećih SimApis-a, kao što je OPC UA.
2. Pažljivo prođite kroz ovaj dokument i njegove reference i istražite da li vaš izvor podataka ispunjava zahtjeve: nprampDakle, mora biti dovoljno brz, da pruža ne samo trenutne podatke, već i istorijske podatke.

• Iz ovih razloga, ne preporučujemo razvoj SimApi-a koji se povezuje na hardver ili instrumente niskog nivoa. Bolje je povezati te instrumente sa istoričarem procesa kao što je Aveva PI System, i pustiti ga da dobije podatke iz instrumenta i da ih historizuje. Zatim se PIAF SimApi može koristiti za dobijanje podataka od PI do Umetrics proizvoda.

SimApi razvoj i SimApi specifikacija

• SimApi specifikacija, SimApi-v2, sadrži dokumentaciju za sve C-funkcije u SimApi-ju koje SimApi DLL treba da implementira, kao i neke smjernice za razvoj SimApi-ja.
• Implementacija SimApi-ja koristeći C ili C++ je u većini slučajeva na nepotrebno niskom nivou.
• Preporučeni i lakši način implementacije SimApi-ja je da se bazira na ExampleSimApi izvorni kod koji pružamo. To je bivšiample SimApi implementacija koja rukuje C-interfejsom i prevodi ga u .NET Framework gdje se pravi implementacija. Takođe ima kod okvira za logovanje, podešavanja, konfiguracioni GUI i drugi kod okvira.
• Da bi razvio SimApi, timu programera je potrebno iskustvo u Windows razvoju, .NET Framework, C ili C++. Takođe je potrebno dobro poznavanje izvora podataka na koji bi se SimApi trebao povezati, jer je svrha SimApi-a da prevede zahtjeve za podacima sa SIMCA-online ili SIMCA u API izvora podataka. Implementacija SimApi nikada nije jednokratan projekat, već je obično potrebna stalna podrška i povremeno održavanje.

Čitanje ili pisanje podataka

• SimApi ima glavni zadatak pružanja podataka iz izvora podataka. Ovo se naziva čitanjem podataka.
• Većina SimApi implementacija takođe podržava pisanje podataka. To znači vraćanje podataka kroz SimApi u izvor podataka. Pisanje podataka je opciona funkcija u SIMCA-online.

Tags i čvorovi

• A tag je identifikator stupca ili “varijable” u izvoru podataka. A tag's name se koristi za identifikaciju tag. Imena unutar čvora moraju biti jedinstvena. SIMCA-online 18 je prva verzija koja podržava čvor koji sadrži podčvor i tag sa istim imenom. Za nprample: Roditelj čvora može imati podčvor koji se zove Batch i a tag pod nazivom Batch.
• Čvor je kontejner za tags. Čvor također može sadržavati druge čvorove, slično kao a file sistem ima foldere u folderima.
• Kao u a file sistem, čvor i tag imena se mogu kombinovati u punu putanju koja jedinstveno identifikuje a tag. The tag putanje se koriste u SIMCA-online ili SIMCA pri odabiru tags koristiti. A tag putanja počinje imenom SimApi instance nakon čega slijedi struktura čvora, a završava se sa tag naziv, svaka stavka odvojena dvotočkom (:). Za nprample “:ODBCSQLServer:Čvor:SenzorTag1”.

SimApi nabraja tags i čvorovi pri pokretanju

• SimApi implementacija pretražuje server za čvorove i tags u izvoru podataka kada se SimApi inicijalizira i prati ih tako da različite SimApi funkcije koje se koriste za nabrajanje tags i čvor se može implementirati.
• SimApi inicijalizacija se ne dešava samo pri pokretanju servera, već je takođe može ponovo pokrenuti korisnik u SIMCA-online sa funkcijom Refresh SimApi.

Osetljivost velikih i malih slova tag- i imena čvorova

• Tag imena i imena čvorova razlikuju velika i mala slova.
• Dakle, a tag pod nazivom "tag1” nije isto što i “Tag1” zbog različitog slučaja slova “T”. Preporučujemo da ne koristite tags ili imena čvorova koja se razlikuju samo velikim i malim slovima.

Čvor kontinuiranog procesa 

• Kada čvor sadrži tags sa kontinuiranim procesnim podacima, može se nazvati procesnim čvorom. Sljedeća dva snimka zaslona prikazuju tabelarni prikaz procesnog čvora s podacima praćenim slikom koja pokazuje kako čvor izgleda pri odabiru tags u SIMCA-online.

Čvorovi kontinuiranog procesa moraju biti nezavisni od serija, izvođenja ili vremena

• Da bi dobro funkcionisao u SimApi-ju, čvor mora biti nezavisan od serija, pokretanja ili vremena. Posjedovanje čvora koji sadrži podatke za određenu seriju ili vremenski raspon ne bi funkcionisalo dobro u SIMCA-online jer bi konfiguracija projekta tada mogla čitati samo podatke za tu seriju i ne bi se koristila za druge serije.
• Umjesto toga, čvor bi trebao biti mapiran na jednu ili više fizičkih jedinica u procesu gdje se mjerenja vrše.

Batch ID tag potrebno u kontinualnim procesnim čvorovima za izvršenje paketnog projekta

• Svaki kontinuirani proces mora imati a tag (varijabilna) koja drži identifikator serije za svako opažanje. Ovaj identifikator serije koristi SIMCA ili SIMCA-online da zna kojoj seriji pripada svako zapažanje.
• $BatchID tag na snimcima ekrana u 7.4.3 je takav example.
  Iako nije potrebno, preporučuje se da imate a tag u čvoru procesa koji prikazuje trenutnu fazu ili korak procesa. Ovo tag zatim se može koristiti u uslovima izvršavanja faze u SIMCA-online ili u SIMCA prilikom uvoza podataka. Vrijednosti za ovo tag može biti nprample “faza1”, “čišćenje”, “faza2”.

Paketni kontekstni čvor

• Batch čvor je čvor koji prati serije; njihove identifikatore serije, vremena početka i vremena završetka. To je uslov za izvođenje paketnog projekta u SIMCA-online. Izvor podataka može imati više od jednog batch čvora koji izlaže serije na različite načine. Korisnik bira paketni čvor koji se primjenjuje na njegovu ili njezinu aplikaciju. Ovaj example izlaže serije koje obuhvataju dvije različite jedinice:
• /Fabrika1 – serije sa agregiranim životnim vijekom i za Unit1 i Unit2.
• /Fabrika1/Jedinica1 – serije sa životnim vijekom samo u Jedinici1
• /Fabrika1/Jedinica2 – serije sa životnim vijekom samo u Jedinici2
• Ako nemate batch čvor u svom izvoru podataka, možete koristiti Batch Context Generator u SIMCA-online. Pogledajte ugrađenu pomoć.
• Opcioni serijski podaci
• Čvor serije također može sadržavati batch podatke; podatke za koje postoji samo jedno zapažanje za cijelu seriju. Imajte na umu da tags sa batch podacima ne moraju biti u čvoru koji ima punu funkcionalnost batch čvora. Dovoljno je da SimApi podržava čitanje batch podataka za tags. Saznajte više o paketnim podacima u 7.6.
• Evo bivšegample od batch čvora:
• Napomena: Gornji snimak ekrana je preuzet sa DBMaker-a, u paketu sa SIMCA-online. Da biste to sami vidjeli u DBMakeru, kliknite na View Dugme podataka u bazi podataka Bakers Yeast za prikaz dva prozora, od kojih je jedan čvor serije, a drugi podaci procesa.

Tipovi podataka: numerički podaci, tekstualni podaci i podaci koji nedostaju

• Za svaku tag, SimApi može podržati tri vrste podataka: numeričke, tekstualne, t i nedostajuće:
• Numerički podaci su tipično stvarne vrijednosti parametara procesa, nprample 6.5123. SimApi može rukovati samo 32-bitnim vrijednostima s pomičnim zarezom s jednom preciznošću. Format s pomičnim zarezom jedne preciznosti - Wikipedia. Sve ostale numeričke tipove podataka u izvoru podataka treba pretvoriti u float. Kao takvi, mogu se baviti i velikim i malim vrijednostima, ali sa samo oko 6 ili 7 značajnih cifara. Saznajte više u Tehničkom vodiču.
• To može dovesti do gubitka preciznosti za velike cijele brojeve ili za realne brojeve koji su i veliki i imaju decimale. Za više informacija pogledajte Tehnički vodič.
• Tekst/string podaci se koriste za ID-ove serije, uslove izvršenja faze ili za kvalitativne varijable. Vrijednosti za tekst tag podaci su osjetljivi na velika i mala slova. To znači da vrijednost “running” nije isto što i
  “RUNNING”. SimApi ne podržava varijable datuma i vremena direktno, ali se mogu vratiti kao string formatiran kao GG-MM-DD HH:MM (npr.ample “2020-09-07 13:45”).
• Nedostajuće vrijednosti znači da nema vrijednosti za vraćanje, tj. nema podataka.
• Koji tip će biti vraćen zavisi od SimApi implementacije. SimApi zna o podacima u izvoru podataka i trebao bi vratiti tip podataka koji najbolje odgovara.

Tri načina preuzimanja podataka: Kontinuirano, Batc,h i Diskretno

• SimApi specifikacija definira tri načina preuzimanja podataka, tj. tri različita načina na koje SimApi može pružiti podatke tags u izvor podataka (ili u drugom smjeru: upišite podatke u tags u izvoru podataka).
• Kontinuirano pronalaženje podataka – ovo se odnosi na podatke koji se čitaju neprekidno i uzastopno, posmatranje po posmatranju kako se serija ili proces razvijaju. Podaci se čitaju za trenutno vrijeme, ili za određeni raspon, u redovnom intervalu između promatranja. Za nprample, svi podaci između 09:00:00 i 10:00:00 sampvodi svakih 60 sekundi, što rezultira 61 opažanjem kada su uključene krajnje tačke.
• Dohvaćanje paketnih podataka – ovo se odnosi na jedno zapažanje sa podacima za cijelu seriju (nije povezano s određenom zrelošću ili vremenskom tačkom). Atributi serije i lokalni podaci za centriranje čitaju se kao batch podaci u SIMCA-online. Uslovi serije se obično čitaju i kao paketni podaci (osim ako nisu konfigurisani za diskretno preuzimanje podataka).
• Povlačenje diskretnih podataka – diskretni podaci se mogu sastojati od nekoliko opservacija za mnoge dospijeće. Ali za razliku od kontinuiranih podataka, diskretni podaci se ne čitaju sekvencijalno, već svi podaci odjednom za određenu fazu serije. Podaci ne moraju biti razmaknuti u pravilnim intervalima varijable dospijeća. Svi podaci se ponovo čitaju svaki put kada se podaci traže, u konfigurisanom intervalu.
• Za bilo koju datu tag podaci se mogu tražiti u bilo kojem od tri načina, ali obično SimApi podržava samo jedan od ovih načina za pojedinca tag. Isto tako, dozvoljeno je mešanje tags unutar čvora, ali obično sve tags unutar određenog čvora podržavaju isti način preuzimanja podataka.
• Za kontinuirane podatke (ali ne za paketne ili diskretne podatke2), mogu se postaviti zahtjevi za trenutne podatke ili historijske podatke, što je tema sljedećeg odjeljka.
• Ne podržavaju svi SimApis sve modove. Pogledajte gornju matricu karakteristika i SimApi web stranica za detalje.

Trenutni i istorijski kontinuirani podaci putem SimApi-a

• Kontinuirani podaci se odnose na podatke procesa koji se mijenjaju tokom vremena.

Trenutni podaci

• Čitanje trenutnih podataka znači tražiti od izvora podataka najnovije vrijednosti tags u trenutku postavljanja pitanja. Imajte na umu da se vrijeme vanjskog izvora podataka ovdje ne koristi.
• Podaci pročitani kao trenutni podaci su ono što će SIMCA-online prikazati kao podaci uživo. Iz tog razloga, važno je da nema nepotrebnih kašnjenja u izvoru podataka. Trenutni podaci bi trebali biti što je moguće noviji kako bi dobro funkcionirali u SIMCA-online.
• Izvor podataka može koristiti svoje znanje o podacima i koliko dugo su vrijednosti valjane i odlučiti vratiti podatke koji nedostaju kada su neobrađeni podaci za vremensku tačku prestari. Za nprample: podaci se traže u 15:00:00, ali najnovija tačka podataka u izvoru podataka je od 03:00:00. U ovom slučaju podaci su stari 12 sati tako da SimApi može odlučiti vratiti vrijednost koja nedostaje (bez podataka).

Istorijski podaci

• Čitanje historijskih podataka znači tražiti od izvora podataka vrijednosti jedne ili više tags za određeni vremenski raspon sa određenim intervalom između posmatranja. Primijetite da se ovdje za pronalaženje podataka koristi lokalno vrijeme izvora podataka. Stoga je vremenska sinhronizacija između izvora podataka i servera važna.
• Istorijski podaci se sastoje od matrice podataka. Na SimApi implementaciji je da zatraži podatke iz izvora podataka, i sampostavite u navedenom intervalu i konstruirajte matricu podataka za povratak:
• Ponekad sam izvor podataka ima funkcije agregacije za vraćanje obrađenih podataka, ili sampling funkcije, koje se mogu koristiti za vraćanje pravih podataka.
• Za druge izvore podataka, SimApi mora zatražiti sve podatke u vremenskom rasponu, a zatim sampostavite prava zapažanja za konstruisanje matrice.
• Podaci se moraju vratiti za vremenski raspon, iako možda nema neobrađenih podataka u vremenskom rasponu, već samo neposredno prije vremena početka. Za nprample: podaci postoje u izvoru podataka u vremenskim tačkama 10 i 20. SimApi zahteva podatke za vreme 15 i 17. U ovom slučaju, vrednosti za vremensku tačku 10 treba da vrati SimApi ali vremeampobjavljeno kao vrijeme 15 i 17 jer su to bili najnoviji podaci u to vrijeme. Vrijednosti za tags u trenutku 10 se nazivaju graničnim vrijednostima za traženi raspon. Za dublje objašnjenje vrijednosti granica, pogledajte nprampostavite dokumentaciju za returnBounds na UA Dio 11: Historical Access – 6.4.3 ReadRawModifiedDetails struktura
  (opcfoundation.org)
• Interpolacija se nikada ne bi trebala koristiti za izračunavanje vrijednosti za buduće vremenske tačke, jer podaci neće odgovarati onome što se čita u realnom vremenu kao trenutni podaci. Za bivšegample iz prethodnog metka: ako bi se podaci za 15 i 17 interpolirali koristeći vrijednosti za stavke 10 i 20, oni bi efektivno koristili vrijednosti iz budućnosti, što nije dozvoljeno.
• Izvor podataka može koristiti svoje znanje o podacima i koliko dugo su vrijednosti valjane i odlučiti vratiti podatke koji nedostaju kada su neobrađeni podaci za vremensku tačku prestari. Za nprample: podaci se traže za 15:00:00, ali najnovija tačka podataka u izvoru podataka je od 03:00:00. U ovom slučaju, podaci su stari 12 sati tako da SimApi može odlučiti vratiti vrijednost koja nedostaje (bez podataka).

Napomena: SIMCA-online obično ne zahteva više od sto posmatranja u jednom pozivu tokom normalnog izvođenja projekta. Kada radite ekstrakciju u SIMCA-online, ili kada koristite SIMCA za desktop računare, mogu se napraviti veći zahtjevi za podacima. Ovo može potrajati dugo, što je i za očekivati.

Trenutni podaci i historijski podaci moraju se podudarati

• Ponekad mogu postojati razlike kada se podaci čitaju kao tekući podaci u stvarnom vremenu ili istorijski podaci. Ovo uzrokuje probleme u SIMCA-online jer server automatski prelazi između trenutnih i historijskih podataka prema potrebi.

Prikupljanje podataka sa malim kašnjenjem

• Kada SIMCA-online koristi izvor podataka u realnom vremenu, važno je da podaci u izvoru podataka budu aktuelni. Ne bi trebalo biti nepotrebnih kašnjenja u prikupljanju podataka u izvoru podataka. Podaci kontinuiranog procesa za sve varijable moraju biti dostupni u isto vrijeme za svako promatranje. SIMCA-online neće pokupiti podatke koji kasne za neke varijable.

Podaci se mogu čitati za bilo koje vrijeme 

• Kada SIMCA-online zatraži vrijednost od a tag za vrijeme t će primiti vrijednost iz izvora podataka iz vremena t, ili posljednje opažanje u izvoru podataka prije vremena t, ili interpoliranu vrijednost za vrijeme t. Dakle, server će uvijek dobiti vrijednost svaki put kada zatraži, iako zapažanje za ovu tačnu vremensku tačku možda ne postoji u izvoru podataka.
• Timestamps u SimApi su uvijek UTC. SIMCA-online klijenti i SIMCA prikazuju vrijeme kao lokalno vrijeme.

Threading 

• SimApi je, po defaultu, pozvan od strane jedne niti od strane korisnika SimApi-ja. Ovo važi za sve verzije SIMCA i SIMCA-online do verzije 17.
• SIMCA-online 18 podržava značajku za uključivanje višenitnog pristupa putem SimApi-ja. Pročitajte više u temi pomoći Istovremeni SimApi pristup.
• To znači da SimApis treba da se pripremi za višenitnu obradu, ako je moguće, tako što će učiniti nit implementacije SimApi bezbednom, i dokumentovati ovo i sva razmatranja za korisnike SimApi-ja.

Dnevnik file

• SimApi treba da evidentira akcije, poruke o greškama i upozorenja u svoj dnevnik file za pomoć u rješavanju problema. Koristite različite nivoe evidencije da označite važnost evidentiranja.
• Preporučuje se evidentiranje „Nije implementirano“ za funkcije koje nisu implementirane u SimApi.

Obrada grešaka

• Kada SimApi ne može ispuniti zahtjev iz izvora podataka, može riješiti ovaj problem na jedan od dva načina; vraćanjem vrijednosti koje nedostaju (bez podataka) ili signaliziranjem greške SimApi:
• Vraćanje nedostajućih vrijednosti pozivaocu i signaliziranje uspjeha omogućava pozivaocu da nastavi normalno (ali naravno bez ikakvih podataka). Ovo je preporučena praksa za djelomične greške kao što je kada se podaci mogu dobiti za neke, ali ne sve, tags u zahtjevu.
• Signalizacija greške SimApi dozvoljava pozivaocu (nprampprepustite SIMCA-online serveru) da to odmah vidite i da djelujete. Ovo je preporučena praksa za zahtjeve koji u potpunosti ne uspijevaju i ne mogu vratiti nikakve podatke.
• SIMCA-online drugačije obrađuje nedostajuće vrijednosti ili kodove grešaka, kao što je opisano u SIMCA-online tehničkom vodiču.

SimApi zahtjevi za performanse

• Funkcije u SimApi se koriste za dobijanje podataka.
• Ako je pristup podacima spor, SimApi neće raditi dobro što je ovaj example pokazuje: Ako SIMCA-online traži podatke svake sekunde, ali su potrebne dvije sekunde da se dobije, SIMCA-online server nikada neće moći održati korak u realnom vremenu, već progresivno sve više zaostaje.
• U pododjeljcima ćemo pokazati kako SIMCA i SIMCA-online koriste SimApi funkcije pristupa podacima i koliko će se često SimApi funkcije pozivati. Ovo može pomoći u postavljanju zahtjeva za performansama za SimApi implementaciju.

SIMCA upotreba SimApi funkcija

• Kada desktop SIMCA ili drugi offline proizvodi koriste SimApi za dobivanje podataka, ovi zahtjevi će biti za serije i procesne podatke za skup varijabli u određenom vremenskom rasponu.
• Pošto ove zahtjeve pokreće korisnik ručno, oni se ne dešavaju često i ne uzrokuju značajno opterećenje izvora podataka.
• Ove SimApi funkcije se koriste za dobivanje podataka:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

SIMCA-online korištenje SimApi funkcija

• SIMCA-online se koristi za praćenje procesa u realnom vremenu, te stoga traži podatke preko SimApi-a u redovnim intervalima. Najkraći interval izvršavanja koji se može koristiti je 1 sekunda. Neki bivši iz stvarnog svijetaampintervali izvršavanja su 10 s, 1 minut ili 10 minuta.
• Server može imati mnogo projekata koji rade u isto vrijeme.
• Kako bi smanjio broj API poziva putem SimApi-a, server optimizira zahtjeve za podacima grupisanjem mnogih istovremenih manjih zahtjeva u jedan veći zahtjev za sve varijable u isto vrijeme (saznajte više u temi pomoći 'Optimizirano čitanje iz izvora podataka poboljšava performanse').
• Algoritam izvršavanja servera radi ovako kada traži podatke koristeći SimApi funkcije navedene u nastavku:
• Sve faze koje se izvršavaju u istom intervalu grupisane su u jedan SimApi poziv kako bi se smanjio broj poziva. Server čita najnovije podatke za sve varijable koje koriste svi modeli koji dijele interval, tj. ovaj poziv će rezultirati širokim redom podataka koji zatim koriste svi projekti.
  • simapi2_connectionReadCurrentData
• Za svaki paketni projekat server također mora znati koje su grupe aktivne. Ovo se također mora dogoditi svaki put kada se projekat izvrši:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes se poziva rjeđe.
• Osim toga, SIMCA-online također zahtijeva istorijske podatke. Ovi zahtjevi se dešavaju samo kada je to potrebno, kao što je nadoknaditi početak serije koja je započela prije pokretanja SIMCA-online, ili kada server zaostaje i treba da pročita blok podataka:
  • simapi2_connectionReadHistoricalDataEx
• Opciono, neke konfiguracije projekta koriste funkcije koje koriste skupne podatke ili diskretne podatke što rezultira SimApi pozivima na:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Opciono, neke konfiguracije projekta koriste povratni upis za vraćanje podataka u izvor podataka:
  • simapi2_connectionWriteHistoricalDataEx (i odgovarajuće funkcije za batch podatke, diskretne podatke)
• Važno je da je svaki poziv osnovnim funkcijama za dobijanje podataka, readCurrentData, getActiveBatches/getBatchTimes, brz i da nije računski težak za sam izvor podataka, s obzirom na to koliko često SIMCA-online može pozvati te funkcije.

Testiranje i validacija SimApi podataka

• Ovaj odjeljak govori o testiranju SimApi-a kako bi se provjerilo da li podaci vraćeni iz njega odgovaraju podacima u samom izvoru podataka. Pokretanje ovakvih testova je važno nakon kreiranja ili promjene SimApi implementacije, ili kada se promijeni API izvora podataka.
• U praksi, provjera valjanosti podataka se vrši korištenjem SIMCA-online i njegove funkcije izdvajanja za izvlačenje podataka iz izvora podataka kroz SimApi i zatim upoređivanje sa sirovim podacima u izvoru podataka. Desktop SIMCA se ne može koristiti za testiranje aspekata SimApi-ja u realnom vremenu.

Pripreme i zahtjevi

• Neke stavke su opcione, ali se mogu izvesti ako ih obuhvat vašeg testiranja uključuje:

1. Instalirajte SIMCA-online kao što je opisano u ReadMe and Installation Guide.pdf koji dolazi u zip-u proizvoda.
2. Nabavite licencu za SIMCA-online server i instalirajte ga. SimApi neće raditi bez licence. Članak baze znanja za SIMCA-online pokazuje kako licencirati proizvod. Za nprample: SIMCA-online 18 (sartorius.com)
3. Instalirajte i konfigurirajte SimApi koji želite testirati. Pogledajte poglavlja 4 – 5 u ovom dokumentu i korisnički vodič za određeni SimApi.
   • a. Opciono: provjerite je li korisnički vodič ažuran i ispravan.
4. Uvjerite se da imate alat za svoj izvor podataka koji možete koristiti za upoređivanje SimApi podataka.
5. U SIMCA-online desktop klijentu, prijavite se na svoj SIMCA-online server i koristite File > Ekstrakt za dobijanje podataka putem SimApi-ja.
6. Opciono ako ga vaš opseg testiranja uključuje: nakon završetka testiranja, deinstalirajte SimApi i provjerite je files se uklanjaju.

Šta testirati

• Matrica karakteristika u poglavlju 3 navodi sve moguće karakteristike, ali data SimApi implementacija može podržavati samo podskup. Trebali biste testirati sve funkcije koje implementira dati SimApi.
• Sljedeći testovi su uobičajeni za većinu SimApi implementacija:
• Autentifikacija sa korisničkim imenima i lozinkama
• Testirajte različite postavke u konfiguraciji SimApi-ja
• Hijerarhija čvorova: Čvorovi i tags koje je izložio SimApi su tačni.
  • Mora postojati a tag izloženo za sve "varijable" koje bi trebale biti dostupne preko SimApi-ja. Pramples: mjerenja procesa, izračunate vrijednosti, konstante.
• Otpornost veze: ako izvor podataka nije dostupan, to rezultira upozorenjima ili greškama u dnevniku file, ali da se veza s izvorom podataka automatski ponovo uspostavlja kada izvor podataka bude dostupan.
• Više instanci: da se dvije instance mogu konfigurirati i koristiti nezavisno i istovremeno, s odvojenim zapisnicima files.
• Trenutni podaci: izdvajanje trenutnih podataka za tags. Provjerite jesu li podaci posljednje poznate vrijednosti iz izvora podataka, ili nedostaju zbog lošeg kvaliteta ili kada su podaci prestari.
  • Ekstrahirajte podatke svakih 10 sekundi (ili tako nešto) na minut.
• Povijesni kontinuirani podaci: izdvajanje historijskih podataka za tags.
  • Koristite vremenski raspon koji odgovara kada ste izdvojili trenutne podatke. Provjerite da li trenutni podaci odgovaraju historijskim podacima i sirovim podacima u izvoru podataka.
  • Pokušajte s različitim vremenskim rasponima i sampu intervalima, provjerite da li podaci odgovaraju izvoru podataka.
  • Pokušajte izvući podatke svakih 1 s, što je najkraći mogući sampling interval.
  • Probajte razne vrste tags u izvoru podataka (procesne varijable, itd.), pazeći da se podaci podudaraju.
  • Napomena: SIMCA-online može podijeliti jedan veliki zahtjev za historijskim podacima na nekoliko manjih dijelova. Ovo će biti vidljivo u SimApi logu.
• Proverite da li SimApi radi sa tekstualnim podacima, numeričkim podacima i podacima koji nedostaju.
• SimApi log file. Provjerite da dnevnik sadrži razumne unose.
• Paketni čvor: desnim tasterom miša kliknite na čvor i uradite Pronađi serije.
  • Provjerite nazive serija, vrijeme početka, vrijeme završetka za serije.
  • Isprobajte aktivnu grupu koja se izvodi u izvoru podataka. Ne bi trebalo da ima vreme završetka kroz SimApi.
• Identifikator serije procesnog čvora tag. Ako SimApi ima funkciju batch čvora (pogledajte prethodnu tačku), mora imati i identifikator serije tag u čvoru podataka procesa podudaranja. Podaci za ovo tag treba biti identifikator serije (naziv serije). Ovi podaci su potrebni za paketne projekte da bi se identificiralo kojoj seriji pripada red podataka.

Ovisno o tome podržava li ga SimApi, možda ćete htjeti testirati:

• Batch podaci koristeći File > Ekstrakt.
• Korištenje diskretnih podataka File > Ekstrakt. Napomena: za testiranje diskretnih podataka sa File > Izdvojite čvor, batch čvor i čvor sa diskretnim podacima moraju biti u istom SimApi (kada SIMCA-online izvršava projekte, oni mogu biti iz različitih SimApis).
• Write back – guranje serije podataka u izvor podataka. Da biste ovo testirali, morate konfigurirati projektnu konfiguraciju u SIMCA-online za upisivanje vektora podataka u izvor podataka. Zatim izvršite projekat u SIMCA-online i provjerite podatke koji su upisani natrag u izvor podataka.
• Kontinuirani podaci se konfiguriraju na stranici Evolution Write Back u konfiguraciji projekta.
• Diskretni podaci su konfigurisani na istoj stranici, ali samo za fazu konfigurisanu za dohvaćanje diskretnih podataka.
• Batch podaci iz Batch Write back

VIŠE INFORMACIJA

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Švedska
• Telefon: + 46 90-18 48 00
• www.sartorius.com
• Informacije i brojke sadržane u ovim uputstvima odgovaraju dolje navedenom datumu verzije.
• Sartorius zadržava pravo izmjene tehnologije, karakteristika, specifikacija i dizajna opreme bez prethodne najave. Oblici muškog ili ženskog roda se koriste da bi se olakšala čitljivost u ovim uputstvima i uvijek istovremeno označavaju sve rodove.
  Obavijest o autorskim pravima:
• Ova uputstva, uključujući sve komponente, zaštićena su autorskim pravima.
• Bilo kakva upotreba izvan granica zakona o autorskim pravima nije dozvoljena bez našeg odobrenja.
• Ovo se posebno odnosi na ponovno štampanje, prevođenje i uređivanje bez obzira na vrstu medija koji se koristi.

FAQ

• P: Koja je svrha SimApisa?
  • O: Glavna svrha SimApis-a je pružanje podataka Umetrics Suite proizvodima za kreiranje projekata i izgradnju modela.
• P: Kako mogu riješiti probleme sa SimApi instalacijom?
  • O: Problem možete riješiti testiranjem sa SIMCA-online, provjerom SimApi dnevnika file, i osiguravanje ispravne konfiguracije naloga usluge.

Dokumenti / Resursi

SARTORIUS Sim Api softver [pdf] Korisnički priručnik Sim Api softver, Api softver, softver

Reference

• Uputstvo za upotrebu