SARTORIUS Sim Api Software

Specificații

• Nume produs: Ghid SimApi
• Data lansării: 5 septembrie 2024
• Scop: Furnizarea de date produselor Umetrics Suite

Instrucțiuni de utilizare a produsului

Introducere în SimApis

• SimApis sunt folosite pentru a prelua date pentru crearea de proiecte și construirea de modele în produsele Umetrics Suite.

Obținerea SimApis

• Pentru a obține SimApis, consultați documentația oficială sau contactați asistența pentru clienți pentru asistență.

Caracteristici SimApi

• SimApis oferă date în timp real pentru monitorizare, control și creare de model în SIMCA și SIMCA-online.

Numai utilizarea curentă a datelor

• Se recomandă să utilizați numai datele curente și să evitați datele istorice pentru o performanță optimă.

Pregătirea pentru o instalare SimApi

• Înainte de instalare, asigurați-vă că sistemul dumneavoastră îndeplinește cerințele minime specificate în ghidul utilizatorului.

Instalarea unui SimApi

• Urmați instrucțiunile pas cu pas furnizate în manualul de utilizare pentru a instala SimApi pe sistemul dumneavoastră.

Configurarea SimApi pentru SIMCA

• Configurați setările SimApi în SIMCA conform instrucțiunilor furnizate.

Configurarea SimApi pentru SIMCA-online

• Configurați SimApi pentru operațiuni de recuperare și scriere în timp real a datelor în SIMCA-online.

Testare și depanare

• După instalare, efectuați testarea pentru a asigura funcționalitatea corespunzătoare. În caz de probleme, consultați secțiunea de depanare din ghidul utilizatorului.

Testare de la SIMCA-online

• Testați integrarea SimApi din SIMCA-online pentru a verifica regăsirea datelor.

Depanare cu Log Files

• Utilizați jurnalul SimApi file pentru a identifica și rezolva orice probleme de instalare sau operaționale.

Configurare cont de serviciu

• Asigurați-vă configurarea corectă a contului de serviciu SIMCA-online pentru o funcționare fără întreruperi.

Detalii tehnice

• Consultați secțiunea 7 a ghidului utilizatorului pentru informații tehnice detaliate despre SimApis.

Introducere în SimApis

• Un SimApi este o interfață software între software-ul Umetrics® Suite și o sursă de date. Scopul principal al unui SimApi este de a furniza date către SIMCA®-online sau SIMCA®.
• Sartorius Stedim Data Analytics AB dezvoltă SimApis pentru multe surse de date diferite, cum ar fi istoricii proceselor și bazele de date de uz general.
• Acest document arată ce este un SimApi și cum este utilizat în produsele Umetrics Suite. Veți învăța cum să planificați și să instalați un SimApi, cum să depanați și cum să vă testați instalarea. Ultimul capitol conține detalii tehnice ale SimApis destinate dezvoltatorilor.

Scopul SimApi: furnizarea de date produselor Umetrics Suite

• Scopul principal al unui SimApi este de a furniza date către SIMCA-online sau SIMCA dintr-o sursă de date. Sursa de date nu face parte din SIMCA-online, dar poate fi un istoric de proces sau alt sistem care păstrează și gestionează datele.
• Un SimApi expune o ierarhie de noduri, corespunzătoare folderelor din a file sistem. Fiecare nod poate conține alte noduri, sau tags. O tag corespunde unei variabile. Pentru acestea tags, se pot obține date. Imaginea arată a tag, Temp, selectat în nod
• BakersYeastControlGood într-o sursă de date în SIMCA-online. De asemenea, arată cele mai recente valori preluate din sursa de date.

Utilizarea SimApi în Umetrics Suite

• Software-ul pentru desktop SIMCA poate folosi un SimApi pentru a prelua date pentru crearea de proiecte și construirea de modele, așa cum ilustrează imaginea următoare.
• SIMCA-online folosește SimApis pentru a obține date în timp real pentru monitorizare și control, precum și pentru a scrie înapoi datele în sursa de date. Următoarea imagine arată unde se află SimApi într-un sistem format dintr-o sursă de date, server SIMCA-online și clienți.

SimApis utilizat în mod obișnuit

• Cele mai utilizate SimApis sunt:
• PI AF SimApi pentru conectarea la Aveva (fostă OSIsoft) PI Systems.
• OPC UA SimApi
• ODBC SimApi – pentru acces general la baze de date precum SQL Server sau Oracle
• Toate SimApis disponibile sunt listate împreună cu caracteristicile lor în paragraful 3.

DBMaker SimApi pentru date de simulare

• DBMaker este o aplicație furnizată cu instalarea serverului SIMCA-online. Simulează o sursă de date, cum ar fi un istoric de proces, utilizând un tabel de date preîncărcat în care observațiile sunt furnizate una câte una către SIMCA-online prin intermediul DBMaker SimApi.
• DBMaker este utilizat doar în scopuri demonstrative și nu poate fi utilizat în producție cu date live dintr-o sursă de date. Consultați ajutorul încorporat pentru a afla mai multe despre DBMaker.

Documentație suplimentară

• Acest document face parte dintr-un set de documente conexe, fiecare având un focus și un public țintă diferit:

Sursă	Ce	Unde
SIMCA-online web pagină	Informații introductive și descărcări	sartorius.com/umetrics-simca- online

SIMCA-online ReadMe and Installation.pdf	Instalare și cum să începeți cu SIMCA-date demo online	În zip-ul de instalare file
Ghid de implementare SIMCA-online	Prezintă funcționalitatea SIMCA-online, o pune în context cu alte programe software Umetrics Suite, descrie cerințele și cele mai bune practici pentru o implementare cu succes și instrucțiuni de instalare pas cu pas.	sartorius.com/umetrics-simca- online
Ghid SimApi	Pregătirea și efectuarea instalărilor SimApi, inclusiv depanarea. Conține și detalii tehnice despre SimApis pentru dezvoltatori.	sartorius.com/umetrics-simapi
Ghidurile utilizatorului SimApi	Documentație pentru fiecare SimApi publicat cu caracteristici, instrucțiuni de instalare și specificații de configurare.	sartorius.com/umetrics-simapi
Ghid tehnic SIMCA-online	Referință tehnică pentru planificarea instalării serverului SIMCA-online, depanarea și modul în care funcționează SIMCA-online în profunzime.	sartorius.com/umetrics-simca-online
SIMCA-ajutor online	Web-asistență bazată pe modul de utilizare a SIMCA-online și cum funcționează SIMCA-online.	În software-ul în sine, și mai departe sartorius.com/umetrics-simca
SIMCA-online Web Ghid de instalare a clientului	Descrie instalarea SIMCA-online Web Client.	sartorius.com/umetrics-simca-online
Baza de cunoștințe Umetrics	Baza de date care poate fi căutată cu articole despre fiecare versiune de software lansată, articole tehnice și probleme cunoscute în produsele Umetrics Suite.	sartorius.com/umetrics-kb
Ajutor SIMCA/ghid de utilizare	Cum se utilizează SIMCA desktop pentru crearea de proiecte și modelarea datelor.	În SIMCA și mai departe sartorius.com/umetrics-simca
Sprijin web pagină	Cum să obțineți suport tehnic.	sartorius.com/umetrics-support

Suport tehnic

• Echipa de asistență online Sartorius răspunde întrebărilor tehnice despre SimApis și poate transmite, de asemenea, solicitări de îmbunătățire a SimApis persoanelor corespunzătoare. Aflați mai multe la sartorius.com/umetrics-support.

Obținerea SimApis

• Oferim documentație pentru SimApis disponibile și link-uri către programele de instalare la sartorius.com/umetrics-simapi.
• Fiecare SimApi este documentat în Ghidul utilizatorului.
• Ghidul SimApi, pe care îl citiți nu, w completează aceste informații cu informații care completează SimApi atunci când vine vorba de planificarea, instalarea și depanarea SimApi.

Caracteristicile SimApi

• Nu toate sursele de date sunt la fel. Un SimApi nu trebuie să implementeze toate funcțiile din specificație. Din aceste motive, diferite SimApis oferă funcționalități diferite. Următoarea matrice listează SimApis disponibile și caracteristicile acestora.
• Caracteristicile sunt explicate mai jos. Observați că tabelul are coloane separate pentru a arăta ce caracteristici sunt disponibile în SIMCA-online și, respectiv, SIMCA.

Caracteristică	Scop	SIMCA-utilizare online	Utilizarea SIMCA
Data curenta	Citiți o singură observație cu cea mai recentă valoare din sursa de date.	Execuție normală în timp real	–
Date istorice	Citiți mai multe observații simultan cu date istorice din sursa de date.	Recuperați și preziceți datele din trecut, creați proiecte folosind File > Nou	Database Import Wizard pentru a importa date de proces pentru crearea modelului.
Date discrete	Citiți datele de laborator/IPC din sursa de date. Multe observații pe lot.	Pentru proiecte în loturi cu faze sau condiții de lot configurate pentru regăsirea datelor discrete.	–
Date de lot	Citiți condițiile lotului și atributele de calitate finale (sau	Condiții de lot sau centrare locală.	Expertul de importare a bazei de date pentru a citi condițiile lotului

Caracteristică	Scop	SIMCA-utilizare online	Utilizarea SIMCA
	alte date de tip MES). O observație pe lot.		crearea modelului la nivel de lot.
Nod lot	Specificați ora de începere și ora de încheiere (vide pentru un lot activ) pentru un anumit lot. Enumerați toate loturile care au existat într-un interval de timp.	Necesar pentru executarea configurațiilor lot.	Expertul de importare a bazei de date pentru a selecta loturile de importat.
Scrie înapoi – date continue	Scrieți date continue, cum ar fi predicții, înapoi la sursa de date.	Scrieți datele de la nivelul de evoluție a lotului, pentru Control Advisor sau pentru configurații continue	–
Scrie înapoi – discret	Scrieți date discrete, cum ar fi predicții, înapoi la sursa de date.	Scrieți înapoi pentru configurațiile de lot la nivel de evoluție a lotului pentru fazele configurate pentru regăsirea datelor discrete	–
Scrie înapoi – date de lot	Scrieți înapoi datele la nivel de lot, cum ar fi predicțiile sau atributele de calitate finale, în sursa de date.	Scrieți înapoi pentru configurarea lotului la nivel de lot	–
Ierarhia nodurilor	SimApi acceptă o ierarhie de noduri, similar cu a file sistem. Fiecare nod poate conține tags și alte noduri. Ierarhia face mai ușor de gestionat un număr mare de noduri și tags.	Sprijinit în toate locurile unde tags sunt folosite.
Matrice tag expansiune	O matrice tag stochează mai multe valori. SimApi extinde matricea tag la multe persoane tags, câte unul pentru fiecare element din matrice.	Sprijină unde tags sunt utilizate pentru date continue. Fiecare sa extins tag trebuie mapat la o variabilă din proiectul SIMCA.
Surse multiple de date	SimApi se poate conecta la mai mult de o singură sursă de date sau acceptă mai multe instanțe cu setări și jurnal individuale files pentru fiecare caz.	Conectați-vă la mai multe surse de date diferite de același tip.	–
Reziliența conexiunii	Dacă SimApi devine deconectat de la sursa de date, va încerca să restabilească automat conexiunea.	SimApi nu trebuie să fie repornit pentru a restabili conexiunile la sursa de date.	–
Dezvoltat intern	SimApi este dezvoltat, furnizat și susținut de

Nu sunt recomandate doar datele actuale, fără date istorice

• Unele SimApis, în special OPC DA, acceptă doar citirea datelor curente, și nu a datelor istorice.
• Un SimApi care acceptă doar date curente nu poate fi folosit în SIMCA desktop, deoarece nu va putea citi date istorice pe care să construiască modelele.
• Pentru SIMCA-online, vă recomandăm cu tărie o sursă de date și SimApi care furnizează nu numai date curente pentru execuție în timp real, ci și date istorice pentru a putea prezice și recupera datele anterioare. SIMCA-online comută automat între datele în timp real și datele istorice, după cum este necesar, iar acest lucru nu poate fi dezactivat.
• O sursă de date care furnizează doar date curente, dar nu date istorice, poate funcționa pentru proiecte continue în SIMCA-online, dar pentru proiectele pe lot, sunt necesare date istorice.

Pregătirea pentru o instalare SimApi

• Această secțiune descrie informații importante pentru o instalare cu succes a unui SimApi.

SimApis pe 64 de biți sau 32 de biți

• Există versiuni pe 32 și 64 de biți ale fiecărui SimApi.
• SIMCA-online și SIMCA sunt pe 64 de biți și necesită variantele SimApis pe 64 de biți. Moștenirea SimApis pe 32 de biți sunt încă disponibile pentru instalări mai vechi.

Locație pentru jurnal file și setările

• Un SimApi își stochează jurnalul files în folderul ascuns Program Data1:
  %programdata%\Umetrics\SimApi, unde %programdata% se mapează la folderul real de pe computer. Setarea implicită este C:\ProgramData.
• Fiecare SimApi utilizează de obicei propriul său jurnal file, care în mod similar cu jurnalul de server SIMCA-online file va conține mai multe sau mai puține date în funcție de setarea nivelului de jurnal. Acest file este util pentru depanare. Jurnalul file este numit
  .log unde este SimApi pe care îl instalați, de example PIAFSimApi. Consultați, de asemenea, următoarea secțiune pentru numele instanțelor SIMCA-online SimApi.
• Acest folder conține, de asemenea, setările SimApi într-un XML file numit .xml.
• Majoritatea SimApis au interfețe grafice de utilizator care modifică setările în xml file, dar pentru unii introduceți modificările direct în XML file cu un editor de text, cum ar fi Notepad. Consultați ghidul utilizatorului pentru fiecare SimApi.

File nume atunci când instanțele denumite sunt utilizate cu SIMCA-online

• În SIMCA-online, fiecare instanță SimApi are propria configurație file și log file pentru a lucra cu mai multe instanțe ale fiecărui SimApi. Numele acestora files sunt sufixate de numele instanței, așa cum este dat în fila SimApi din dialogul de opțiuni server SIMCA-online.
• Următorul example arată denumirea acestora files, unde trebuie înlocuit cu numele SimApi.
• Numele configurației dat când este adăugată instanța: OmegaServer
• Configurare file nume: OmegaServer.xml
• Jurnal file nume: OmegaServer.log
• Rețineți că genericul file .log file este încă creat. Acest jurnal file conține intrări care din motive tehnice nu pot fi direcționate către jurnal file a instantelor..
• Acest folder este ascuns în Windows în mod implicit. Să-l vezi în File Explorer pe care îl configurați arată ascuns files. Rețineți că puteți naviga la un dosar ascuns introducând o adresă File Bara de adrese a exploratorului.
• Rețineți că SIMCA nu acceptă mai multe instanțe ale SimApi și, prin urmare, utilizează numele fără nume de instanță așa cum este descris mai sus.

Planificarea rețelei

• Ar trebui să localizați serverul SIMCA-online aproape de sursa de date din rețea. Acest lucru asigură o conexiune rapidă între SIMCA-online și sursa sa de date.
• Echipamentele de rețea pot interfera cu conexiunea dintre SIMCA-online și sursa de date.

Conturi de utilizator și permisiuni pentru sursa de date

• Sursele de date controlează de obicei accesul la datele lor. Acest lucru se face de obicei cu nume de utilizator și parole, dar pot fi utilizate și restricții bazate pe adrese IP sau DNS (de ex.ample PI are încredere în Aveva PI System).
• Numele de utilizator și parola pot fi furnizate sursei de date în diferite moduri:
• Un SimApi este rulat ca utilizator Windows al utilizatorului care rulează SIMCA desktop sau contul de serviciu SIMCA-online pe computerul server. SimApi se poate conecta la sursa de date folosind acest cont. Așa funcționează OPC I și PI SimApi și ODBC dacă nu furnizați acreditări atunci când îl configurați.
• Pentru ODBC generic puteți utiliza aplicația ODBC Data Sources Administrator care se găsește pe Start în Windows.
• Unii furnizori de baze de date oferă propriile drivere și instrumente pentru bazele de date. Baze de date Oracle, de example, utilizați Oracle Data Access Components (ODAC).
• Unele SimApi, cum ar fi PI AF și ODBC, au dialoguri de configurare care stochează acreditările criptate în configurația SimApi XML file.
• PI are, de asemenea, diverse opțiuni de securitate disponibile în PI System Management Tools de pe computerul serverului PI. Citiți mai multe în Ghidul utilizatorului PI AF SimApi. Acest ghid este util chiar dacă utilizați OSIsoft PI SimApi mai vechi.
• OPC DA și HDA folosesc DCOM ca transport între o sursă de date și SimApi. DCOM este configurat cu instrumentul Component Services (DCOMCNFG.EXE) în Windows și utilizează autentificarea Windows.
• Pentru OSIsoft PI SimApi mai vechi (nu mai nou AF SimApi), aplicația OSIsoft AboutPI-SDK (PISDKUtility.exe) este utilizată pentru a configura conexiunea la serverul PI.

Verificarea conectivității sursei de date
Când doriți să instalați un SimApi pe un computer, poate fi util să verificați conectivitatea de la acel computer la sursa de date cu un alt instrument:

• Sursele de date ODBC în Windows sunt folosite pentru a configura și testa ODBC generic. Rețineți că există două versiuni ale acestui instrument pe Windows pe 64 de biți: una pentru aplicații pe 32 de biți și una pentru aplicații pe 64 de biți. Utilizați butonul Testare sursă de date de la sfârșitul expertului de configurare ODBC pentru a verifica conectivitatea la baza de date. Vă recomandăm să configurați sursele de date ca DSN-uri de sistem.
• Un instrument de conectare specific bazei de date de la furnizorul bazei de date, cum ar fi Oracle Data Access Components.
• PI System Explorer poate fi utilizat pentru a testa conectivitatea la serverul PI AF. Face parte din clientul PI AF, care este o condiție prealabilă pentru PI AF SimApi.
• OPC UA Expert de la Unified Automation – UaExpert este un client de testare multiplatformă pentru serverele OPC UA.
• Aplicația PI-SDK (PISDKUtility.exe) poate fi utilizată pentru a testa conectivitatea și pentru a view orice mesaj de eroare care ar fi putut fi înregistrat când SIMCA-online încearcă să se conecteze la serverul PI. Acesta este folosit doar pentru OSIsoft SimApi mai vechi, nu PIAF.
• Instrumentele de gestionare a sistemului PI sunt utilizate pe computerul serverului PI pentru depanarea din acea parte. De example, pentru a căuta probleme de securitate care împiedică accesul de pe serverul SIMCA-online. Aflați mai multe despre depanarea sistemului PI în acest videoclip YouTube.
• Excel poate fi folosit pentru a obține date de la o conexiune ODBC și de la majoritatea altor sisteme atunci când este instalat un plugin adecvat.
• Matrikon OPC Explorer pentru Ior HDA (acestea sunt instrumente separate) poate fi folosit pentru a testa conectivitatea OPC, iar Matrikon OPC Analyzer poate fi folosit pentru a diagnostica problemele de conectivitate OPC. Descărcați aceste instrumente gratuite de pe https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (pentru DInd HDA) de la Institutul de Formare OPC web site-ul „permite utilizatorilor să diagnosticheze cu ușurință problemele de comunicare și securitate și să le repare instantaneu prin apăsarea unui buton. Toate acestea pot fi făcute fără a fi nevoie să învățați să configurați DCOM“

Instalarea unui SimApi

Iată cum se instalează un SimApi pe un PC:

1. Citiți Ghidul utilizatorului pentru SimApi pe care îl instalați. Conține specificații pentru acel SimApi care completează instrucțiunile generale pe care le citiți acum.
2. Instalați și configurați toate cerințele prealabile menționate în Ghidul utilizatorului SimApi (de exampdrivere de bază de date sau SDK-uri)
3. Rulați programul de instalare pentru a instala SimApi. Instalați versiunea pe 64 de biți (x64) sau pe 32 de biți (x86) care se potrivește cu software-ul în care îl veți rula.
4. Configurați SimApi în SIMCA-online sau SIMCA așa cum este descris în secțiunile următoare și consultați ghidul de utilizare al SimApi pentru descrieri ale setărilor disponibile.
5. Porniți serverul SIMCA-online. Rețineți că acest lucru poate dura timp, deoarece atunci când SimApi este inițializat, va enumera toate tags în sursa de date.
6. Testați SimApi obținând câteva date. Pentru SIMCA-online, puteți utiliza File > Extrageți așa cum este descris în 6.1.
7. Dacă SimApi nu funcționează conform așteptărilor, consultați jurnalul SimApi files pentru depanare și la ghidul utilizatorului SimApi.

Configurarea SimApi pentru utilizare în SIMCA

Iată cum să utilizați SimApi în SIMCA:

1.  Porniți importul bazei de date într-unul dintre următoarele moduri:
   • a. Pentru a crea un nou proiect în SIMCA: File > Proiect obișnuit nou sau Proiect nou lot. Selectați Din baza de date din fila Acasă.
   • b. Pentru a importa un set de date într-un proiect existent în SIMCA: Din setul de date din fila Date a unui proiect SIMCA deschis.
2. Faceți clic pe Adăugați o nouă sursă de date
3. Selectați SimApi ca tip de conexiune, faceți clic pe butonul ... și localizați .dll în folderul de instalare și faceți clic pe Deschidere.
4. Faceți clic pe Configurare și consultați Ghidul utilizatorului SimApi individual pentru a efectua setările.
5. Faceți clic pe Testare conexiunea la sursa de date pentru a verifica dacă vă puteți conecta la baza de date. Acest lucru poate dura mult timp dacă sunt multe tags în sursa de date.
6. Faceți clic pe OK pentru a finaliza configurația.
7. Consultați ajutorul SIMCA pentru a afla cum să lucrați cu datele importate.

Configurarea SimApi pentru utilizarea în SIMCA-online

• Important: Pentru a putea utiliza un SimApi, este necesară o licență de server SIMCA-online. O instalare demo a SIMCA-online nu permite utilizarea SimApis.
• Pentru a adăuga un SimApi la sistem, rulați SIMCA-online Server Options pe computerul serverului. Aflați pașii detaliați din subiectul de ajutor SICMA-online Adăugați și configurați un SimApi pe server.
• Sfat: Dacă faceți modificări pentru un SimApi, puteți reporni acel SimApi separat de Opțiuni server fără a reporni întregul server.
• Pentru a configura mai multe instanțe ale acestui SimApi, repetați pașii de mai sus și utilizați nume unice pentru fiecare instanță. Citiți mai multe despre jurnalele și configurațiile diferite files pentru cazurile din 4.2.

Testarea și depanarea unui SimApi

• Acest capitol este despre testarea și depanarea unei instalări SimApi.

Testarea unui SimApi de la SIMCA-online

• Odată ce serverul SIMCA-online a fost pornit cu succes, vă puteți testa SimApi-ul în SIMCA-online (dacă serverul nu pornește, consultați 6.2):
• Conectați-vă la server în clientul SIMCA-online și navigați la Extract pe File fila. Extract vă ajută să testați SimApi obținând date prin intermediul acestuia:
• Nodurile („folderele”) ale SimApi sunt afișate în caseta din stânga. Tags pentru nodul selectat sunt afișate în dreapta sus.
• Datele curente pot fi testate rapid printr-un simplu clic view> pe tags care furnizează date de proces continue (vezi captura de ecran)
• Faceți clic dreapta pe un nod pentru a găsi loturi într-un interval de timp. Nodul trebuie să fie un nod de loturi care știe despre loturi.
• Selecta tags în Extragere și faceți clic pe Următorul și finalizați expertul pentru a obține date folosind diferitele moduri de recuperare a datelor: date curente, istorice, loturi și date discrete.
• Comparați datele extrase cu ceea ce vedeți în sursa de date folosind instrumentele acesteia. Aflați mai multe despre testarea și validarea tuturor caracteristicilor unui SimApi în 7.13.

Depanați problemele SimApi utilizând jurnalul SimApi file

• Dacă serverul nu pornește, SimApi nu funcționează conform așteptărilor sau extragerea eșuează, trebuie să consultați jurnalul SimApi file care vă spune care este problema. Activați înregistrarea la nivel de depanare în jurnalul SimApi pentru a obține detalii complete. Vezi 4.2.
• Notă: jurnalele serverului SIMCA-online nu sunt atât de utile aici. Ei vor arăta cum a fost încărcat și inițializat SimApi de către server, dar detaliile specifice SimApi sunt în jurnalul său file.

Utilizați contul corect de serviciu SIMCA-online

• Când testați accesul la sursa de date, amintiți-vă că sunteți conectat ca utilizator specific pe computerul server (de obicei propriul cont de utilizator într-un domeniu Windows), dar că contul de serviciu de server SIMCA-online este un cont diferit, implicit LocalSystem, care are drepturi de acces diferite în comparație cu contul dvs. de utilizator.
• Din acest motiv, nu este neobișnuit ca testele să funcționeze atunci când sunt executate ca cont, dar SIMCA-online nu reușește să se conecteze la sursa de date.
• Pentru a rezolva această problemă, accesul trebuie să fie acordat pentru contul utilizat de serviciul de server SIMCA-online. De obicei, schimbați LocalSystem cu un anumit cont de serviciu de domeniu și acordați drepturi pentru acest cont. Rețineți că acest lucru nu se aplică dacă SimApi utilizează acreditări care sunt setate în configurația SimApi, deoarece aceste acreditări au prioritate.

Detalii tehnice pe SimApis

• Acest capitol oferă detalii tehnice despre cum funcționează un SimApi. Este destinat în principal dezvoltatorilor care doresc să înțeleagă SimApis pentru a implementa un SimApi pentru o sursă de date.
• Dezvoltatorii ar trebui să citească, de asemenea, părțile anterioare ale acestui document pentru o introducere în SimApis și la descrierile de nivel înalt ale caracteristicilor.

Când să luați în considerare dezvoltarea unui SimApi și când nu?

Înainte de a lua în considerare dezvoltarea unui SimApi pentru o sursă de date:

1. Investigați dacă există deja un SimApi pe care îl puteți utiliza. Poate că puteți activa o funcție din sursa dvs. de date pentru a utiliza unul dintre SimApis existente, cum ar fi OPC UA.
2. Parcurgeți cu atenție acest document și referințele sale și investigați dacă sursa dvs. de date îndeplinește cerințele: de example, trebuie să fie suficient de rapid, să furnizeze nu doar date actuale, ci și date istorice.

• Din aceste motive, nu recomandăm dezvoltarea unui SimApi care se conectează la hardware sau instrumente de nivel scăzut. Este mai bine să conectați acele instrumente la un istoric de proces, cum ar fi Aveva PI System, și să-l lăsați să obțină date de la instrument și să le istoricizeze. Apoi PIAF SimApi poate fi folosit pentru a obține date de la PI la produsul Umetrics.

Dezvoltarea SimApi și specificația SimApi

• Specificația SimApi, SimApi-v2, conține documentație pentru toate funcțiile C din SimApi pe care un DLL SimApi trebuie să le implementeze, precum și câteva îndrumări pentru dezvoltarea unui SimApi.
• Implementarea unui SimApi folosind C sau C++ este în majoritatea cazurilor la un nivel inutil de scăzut.
• Modul recomandat și mai ușor de a implementa un SimApi este să îl bazați pe ExampCodul sursă leSimApi pe care îl oferim. Este un fostampImplementarea SimApi care se ocupă de interfața C și o traduce în.NET Framework unde se realizează implementarea propriu-zisă. De asemenea, are cod cadru pentru înregistrare, setări, GUI de configurare și alt cod cadru.
• Pentru a dezvolta un SimApi, echipa de dezvoltatori are nevoie de experiență în dezvoltarea Windows, .NET Framework, C sau C++. De asemenea, este necesară o bună cunoaștere a sursei de date la care SimApi ar trebui să se conecteze, deoarece scopul unui SimApi este de a traduce cererile de date de la SIMCA-online sau SIMCA în API-ul sursei de date. O implementare SimApi nu este niciodată un proiect unic, dar de obicei necesită asistență continuă și întreținere ocazională.

Citirea sau scrierea datelor

• Un SimApi are sarcina principală de a furniza date dintr-o sursă de date. Acest lucru se numește citirea datelor.
• Majoritatea implementărilor SimApi acceptă și scrierea datelor. Aceasta înseamnă rescrierea datelor prin SimApi la sursa de date. Scrierea datelor este o caracteristică opțională în SIMCA-online.

Tags și Noduri

• A tag este un identificator al unei coloane sau al unei „variabile” dintr-o sursă de date. O tagnumele lui este folosit pentru a identifica tag. Numele din nod trebuie să fie unice. SIMCA-online 18 este prima versiune care acceptă un nod care conține un subnod și tag cu acelasi nume. De example: nodul Parent poate avea un subnod numit Batch și a tag numit Batch.
• Un nod este un container de tags. Un nod poate conține și alte noduri, în mod similar cu a file sistemul are foldere în foldere.
• Ca într-un file sistem, nodul și tag numele pot fi combinate într-o cale completă care identifică în mod unic a tag. The tag căile sunt utilizate în SIMCA-online sau SIMCA la selectare tags a folosi. O tag calea începe cu un nume de instanță SimApi urmat de structura-nod și se termină cu tag nume, fiecare articol separat cu două puncte (:). De exampfișierul „:ODBCSQLServer:Node:SensorTag1”.

SimApi enumerează tags și noduri la pornire

• O implementare SimApi răsfoiește serverul pentru noduri și tags în sursa de date atunci când SimApi este inițializat și ține evidența acestora, astfel încât diferitele funcții SimApi care sunt utilizate pentru enumerarea tags iar nodul poate fi implementat.
• Inițializarea SimApi nu are loc doar la pornirea serverului, ci poate fi, de asemenea, re-declanșată de un utilizator în SIMCA-online cu funcționalitatea Refresh SimApi.

Sensibilitatea majusculelor de tag- și numele nodurilor

• Tag numele și numele nodurilor sunt sensibile la majuscule.
• Astfel, a tag numită „tag1” nu este același cu „Tag1” din cauza cazului diferit al lui „T”. Vă recomandăm să nu utilizați tags sau nume de noduri care diferă numai prin caz.

Nod proces continuu 

• Când un nod conține tags cu date de proces continue, poate fi denumit nod de proces. Următoarele două capturi de ecran arată o reprezentare tabelară a unui nod de proces cu date, urmată de o imagine care arată cum arată nodul la selectare tags în SIMCA-online.

Nodurile de proces continuu trebuie să fie independente de loturi, rulări sau timp

• Pentru a funcționa bine într-un SimApi, un nod trebuie să fie independent de loturi, rulări sau timp. A avea un nod care conține date pentru un anumit lot sau interval de timp nu ar funcționa bine în SIMCA-online, deoarece configurația proiectului ar putea citi doar datele pentru acel lot și nu ar putea fi utilizată pentru alte loturi.
• În schimb, un nod ar trebui să fie mapat la una sau mai multe unități fizice în procesul în care sunt efectuate măsurători.

ID lot tag necesare în nodurile de proces continuu pentru execuția proiectelor în serie

• Fiecare proces continuu trebuie să aibă o tag (variabilă) deținând identificatorul de lot pentru fiecare observație. Acest identificator de lot este utilizat de SIMCA sau SIMCA-online pentru a ști cărui lot îi aparține fiecare observație.
• $BatchID tag în capturile de ecran din 7.4.3 este un astfel de example.
  Deși nu este necesar, se recomandă să aveți un tag în nodul de proces care arată faza sau pasul curent al procesului. Acest tag poate fi apoi utilizat în condiții de execuție a fazei în SIMCA-online sau în SIMCA la importul de date. Valori pentru asta tag poate fi de example „faza 1”, „curățarea”, „faza 2”.

Nod context lot

• Un nod batch este un nod care ține evidența loturilor; identificatorii lor de lot, orele de începere și orele de încheiere. Este o cerință pentru execuția unui proiect batch în SIMCA-online. O sursă de date poate avea mai mult de un nod de loturi care expune loturile în moduri diferite. Utilizatorul selectează nodul de lot care se aplică aplicației sale. Acest exampfișierul expune loturi care se întind pe două unități diferite:
• /Factory1 – loturi cu durate de viață agregate atât pe Unitatea1, cât și pe Unitatea2.
• /Factory1/Unit1 – loturi cu durate de viață numai în Unit1
• /Factory1/Unit2 – loturi cu durate de viață numai în Unit2
• Dacă nu aveți un nod de lot în sursa de date, puteți utiliza Generatorul de context de lot în SIMCA-online. Consultați ajutorul încorporat.
• Date opționale ale lotului
• Un nod de lot poate conține, de asemenea, date de lot; date pentru care există o singură observație pentru întregul lot. Rețineți că tags cu datele de lot nu trebuie să fie într-un nod care are funcționalitatea completă a unui nod de lot. Este suficient ca SimApi să accepte citirea datelor lotului pentru tags. Aflați mai multe despre datele lotului în 7.6.
• Iată un exampfișierul unui nod batch:
• Notă: Captura de ecran de mai sus este preluată de la DBMaker, împreună cu SIMCA-online. Pentru a vedea acest lucru personal în DBMaker, faceți clic pe View Buton de date din baza de date Bakers Yeast pentru a afișa două ferestre, dintre care una este nodul lotului, iar cealaltă datele procesului.

Tipuri de date: date numerice, date text și date lipsă

• Pentru fiecare tag, un SimApi poate suporta trei tipuri de date: numerice, text,t și lipsă:
• Datele numerice sunt de obicei valori reale ale parametrilor de proces, de example 6.5123. SimApi poate gestiona doar valori cu virgulă mobilă cu precizie unică de 32 de biți. Format în virgulă mobilă cu precizie unică - Wikipedia. Toate celelalte tipuri de date numerice dintr-o sursă de date ar trebui convertite în float. Ca atare, ele pot face față atât cu valori mari, cât și cu valori mici, dar cu doar aproximativ 6 sau 7 cifre semnificative. Aflați mai multe în Ghidul Tehnic.
• Acest lucru poate duce la pierderea preciziei pentru numere întregi mari sau pentru numere reale care sunt atât mari și au zecimale. Pentru mai multe informații, consultați Ghidul tehnic.
• Datele text/șir sunt utilizate pentru ID-uri de lot, condiții de execuție a fazelor sau pentru variabile calitative. Valorile pentru text tag datele sunt sensibile la majuscule. Aceasta înseamnă că valoarea „running” nu este aceeași cu
  "FUNCŢIONARE". Variabilele datetime nu sunt acceptate direct de SimApi, dar pot fi returnate ca șir formatat ca AA-LL-ZZ HH:MM (de exempluample “2020-09-07 13:45”).
• Valorile lipsă înseamnă că nu există nicio valoare de returnat, adică nu există date.
• Ce tip este returnat depinde de implementarea SimApi. Un SimApi știe despre datele din sursa de date și ar trebui să returneze tipul de date care se potrivește cel mai bine.

Trei moduri de preluare a datelor: Continuu, Batc,h și Discret

• Specificația SimApi definește trei moduri de recuperare a datelor, adică. trei moduri diferite din care SimApi poate furniza date tags într-o sursă de date (sau în cealaltă direcție: scrieți datele în tags într-o sursă de date).
• Preluare continuă a datelor – aceasta se referă la datele citite continuu și secvenţial, la observarea per observație pe măsură ce lotul sau procesul evoluează. Datele sunt citite pentru ora curentă sau pentru un interval specific, la un interval regulat între observații. De example, toate datele între 09:00:00 și 10:00:00 sampcondus la fiecare 60 de secunde, rezultând 61 de observații când punctele finale sunt inclusive.
• Preluarea datelor pe lot – aceasta se referă la o singură observație cu date pentru un întreg lot (nu este asociat cu o anumită maturitate sau punct de timp). Atributele lotului și datele de centrare locale sunt citite ca date de lot în SIMCA-online. Condițiile de lot sunt în mod normal citite și ca date de lot (cu excepția cazului în care sunt configurate pentru regăsirea datelor discrete).
• Preluarea datelor discrete – datele discrete pot consta din mai multe observații pentru mai multe maturități. Dar, spre deosebire de datele continue, datele discrete nu sunt citite secvenţial, ci mai degrabă toate datele simultan pentru o anumită fază a unui lot. Datele nu trebuie să fie distanțate cu intervale regulate ale variabilei de maturitate. Toate datele sunt recitit de fiecare dată când datele sunt solicitate, la intervalul configurat.
• Pentru orice dat tag datele pot fi solicitate în oricare dintre cele trei moduri, dar de obicei un SimApi va accepta doar unul dintre aceste moduri pentru o persoană tag. La fel, se lasă să se amestece tags într-un nod, dar de obicei toate tags într-un anumit nod acceptă același mod de recuperare a datelor.
• Pentru date continue (dar nu pentru date pe lot sau discrete2), se pot face cereri pentru date curente sau date istorice, care este subiectul secțiunii următoare.
• Nu toate SimApis acceptă toate modurile. Vedeți matricea de caracteristici de mai sus și SimApi web pagina pentru detalii.

Date curente și istorice continue printr-un SimApi

• Datele continue se referă la datele de proces care se modifică în timp.

Data curenta

• Citirea datelor curente înseamnă a cere sursei de date cele mai recente valori ale tags în momentul întrebării. Observați că ora sursei de date externe nu este utilizată aici.
• Datele citite ca date curente sunt ceea ce SIMCA-online va afișa ca date live. Din acest motiv, este important să nu existe întârzieri inutile în sursa de date. Datele actuale ar trebui să fie cât mai recente posibil pentru a funcționa bine în SIMCA-online.
• Sursa de date poate folosi cunoștințele sale despre date și cât timp sunt valabile valorile și poate decide să returneze datele lipsă atunci când datele brute pentru un punct de timp sunt prea vechi. De example: datele sunt solicitate la 15:00:00, dar cel mai recent punct de date din sursa de date este de la 03:00:00. În acest caz, datele sunt vechi de 12 ore, astfel încât SimApi poate decide să returneze valoarea lipsă (fără date).

Date istorice

• Citirea datelor istorice înseamnă a cere sursei de date valori de una sau mai multe tags pentru un interval de timp specific cu un interval specific între observații. Observați că aici este ora locală a sursei de date care este folosită pentru a găsi datele. Prin urmare, sincronizarea timpului între sursa de date și servere este importantă.
• Datele istorice constau dintr-o matrice de date. Depinde de implementarea SimApi să solicite datele de la sursa de date și samplăsați-l la intervalul specificat și construiți matricea de date pentru a returna:
• Uneori, sursa de date în sine are funcții de agregare pentru a returna date prelucrate sau sampling, care pot fi folosite pentru a returna datele corecte.
• Pentru alte surse de date, SimApi trebuie să solicite toate datele din intervalul de timp și apoi sample observațiile potrivite pentru a construi matricea.
• Datele trebuie returnate pentru un interval de timp, chiar dacă este posibil să nu existe date brute în intervalul de timp, ci doar înainte de ora de începere. De example: datele există în sursa de date la punctele de timp 10 și 20. SimApi solicită date pentru timpul 15 și 17. În acest caz, valorile pentru punctul de timp 10 ar trebui să fie returnate de SimApi dar cel mai multamp15 și 17, deoarece acestea erau cele mai recente puncte de date la acele momente. Valorile pentru tags la momentul 10 sunt denumite valori limite pentru intervalul solicitat. Pentru o explicație mai profundă a valorilor limitelor, vezi de exampconsultați documentația pentru returnBounds la UA Partea 11: Acces istoric – 6.4.3 Structura ReadRawModifiedDetails
  (opcfoundation.org)
• Interpolarea nu ar trebui să fie utilizată niciodată pentru a calcula valori pentru momentele viitoare, deoarece datele nu se vor potrivi cu ceea ce este citit în timp real ca date curente. Pentru example din punctul precedent: dacă datele pentru 15 și 17 ar fi interpolate folosind valorile pentru itemii 10 și 20, ar folosi efectiv valori din viitor, ceea ce nu este permis.
• Sursa de date poate folosi cunoștințele sale despre date și cât timp sunt valabile valorile și poate decide să returneze datele lipsă atunci când datele brute pentru un punct de timp sunt prea vechi. De example: datele sunt solicitate pentru 15:00:00, dar cel mai recent punct de date din sursa de date este de la 03:00:00. În acest caz, datele sunt vechi de 12 ore, astfel încât SimApi poate decide să returneze valoarea lipsă (fără date).

Nota: SIMCA-online de obicei nu solicită mai mult de o sută de observații într-un apel în timpul execuției normale a proiectului. Când faceți extrage în SIMCA-online sau când rulați SIMCA desktop, pot fi făcute solicitări mai mari de date. Acestea pot dura mult timp, ceea ce este de așteptat.

Datele actuale și datele istorice trebuie să se potrivească

• Uneori pot exista diferențe atunci când datele sunt citite ca date curente în timp real sau date istorice. Acest lucru cauzează probleme în SIMCA-online, deoarece serverul comută automat între datele curente și cele istorice, după cum este necesar.

Achiziție de date cu latență scăzută

• Când o sursă de date este utilizată de SIMCA-online în timp real, este important ca datele din sursa de date să fie actuale. Nu ar trebui să existe întârzieri inutile în achiziția datelor din sursa de date. Datele de proces continuu pentru toate variabilele trebuie să fie disponibile în același timp pentru fiecare observație. Datele care vin cu întârziere pentru unele variabile nu vor fi preluate de SIMCA-online.

Datele pot fi citite oricând 

• Când SIMCA-online solicită o valoare de a tag pentru timpul t va primi valoarea de la sursa de date din timpul t, sau cea mai recentă observație din sursa de date înainte de momentul t, sau o valoare interpolată pentru timpul t. Astfel, serverul va primi întotdeauna o valoare de fiecare dată când o cere, chiar dacă o observație pentru acest punct de timp exact ar putea să nu existe în sursa de date.
• TimestampS-urile din SimApi sunt întotdeauna UTC. Clienții SIMCA-online și SIMCA prezintă ora ca oră locală.

Filetat 

• SimApi este, implicit, apelat printr-un singur fir de către utilizatorul SimApi. Acest lucru este valabil pentru toate versiunile SIMCA și SIMCA-online până la versiunea 17.
• SIMCA-online 18 acceptă un semnalizator de caracteristică pentru a activa accesul cu mai multe fire prin SimApi. Citiți mai multe în subiectul de ajutor Acces simultan SimApi.
• Aceasta înseamnă că SimApis ar trebui să se pregătească pentru multi-threading, dacă este posibil, făcând firul de implementare SimApi sigur și să documenteze acest lucru și orice considerente pentru utilizatorii SimApi.

Jurnal file

• Un SimApi ar trebui să înregistreze acțiunile, mesajele de eroare și avertismentele în jurnalul său file pentru a ajuta la depanarea. Utilizați diferitele niveluri de jurnal pentru a indica importanța înregistrării.
• Se recomandă să înregistrați „Neimplementat” pentru caracteristicile care nu au fost implementate într-un SimApi.

Gestionarea erorilor

• Când un SimApi nu poate îndeplini o solicitare de la sursa de date, poate rezolva această problemă în unul din două moduri; prin returnarea valorilor lipsă (fără date) sau prin semnalarea unei erori SimApi:
• Returnarea valorilor lipsă către apelant și semnalarea succesului permite apelantului să continue ca în mod normal (dar, desigur, fără date). Aceasta este o practică recomandată pentru erorile parțiale, cum ar fi când ar putea fi obținute date pentru unele, dar nu pentru toate, tags într-o cerere.
• Semnalarea unei erori SimApi permite apelantului (de example serverul SIMCA-online) pentru a vedea acest lucru imediat și pentru a acționa. Aceasta este o practică recomandată pentru solicitările care eșuează complet și nu pot returna deloc date.
• SIMCA-online tratează în mod diferit valorile lipsă sau codurile de eroare, așa cum este descris în Ghidul tehnic SIMCA-online.

Cerințe de performanță SimApi

• Funcțiile din SimApi sunt folosite pentru a obține date.
• Dacă accesul la date este lent, SimApi nu va funcționa bine, de exempluampfișierul arată: Dacă SIMCA-online solicită date în fiecare secundă, dar este nevoie de două secunde pentru a obține, serverul SIMCA-online nu va putea niciodată să țină pasul în timp real, ci va rămâne progresiv din ce în ce mai în urmă.
• În subsecțiunile vom arăta cum SIMCA și SIMCA-online utilizează funcțiile SimApi de acces la date și cât de des vor fi apelate funcțiile SimApi. Acest lucru poate ajuta la stabilirea cerințelor de performanță pentru o implementare SimApi.

Utilizarea de către SIMCA a funcțiilor SimApi

• Când desktop SIMCA sau alte produse offline folosesc un SimApi pentru a obține date, aceste solicitări vor fi pentru loturi și procesează date pentru un set de variabile într-un anumit interval de timp.
• Deoarece aceste solicitări sunt inițiate manual de către un utilizator, ele nu se întâmplă foarte frecvent și nu provoacă o încărcare semnificativă a sursei de date.
• Aceste funcții SimApi sunt folosite pentru a obține datele:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

Utilizarea de către SIMCA-online a funcțiilor SimApi

• SIMCA-online este utilizat pentru monitorizarea în timp real a unui proces și, prin urmare, solicită date prin SimApi la intervale regulate. Cel mai scurt interval de execuție care poate fi utilizat este de 1 secundă. Câteva ex din lumea realăampfișierele de intervale de execuție sunt 10 s, 1 minut sau 10 minute.
• Un server poate avea mai multe proiecte care rulează în același timp.
• Pentru a reduce numărul de apeluri API prin SimApi, serverul optimizează solicitările de date prin gruparea mai multor cereri concurente mai mici într-o singură cerere mai mare pentru toate variabilele în același timp (aflați mai multe în subiectul de ajutor „Citirea optimizată din sursele de date îmbunătățește performanța”).
• Algoritmul de execuție al serverului funcționează astfel când solicită date folosind funcțiile SimApi enumerate mai jos:
• Toate fazele care se execută la același interval sunt grupate într-un singur apel SimApi pentru a reduce numărul de apeluri. Serverul citește cele mai recente date pentru toate variabilele utilizate de toate modelele care împărtășesc intervalul, adică acest apel va avea ca rezultat un rând larg de date care apoi este utilizat de toate proiectele.
  • simapi2_connectionReadCurrentData
• Pentru fiecare proiect de lot, serverul trebuie să știe și ce loturi sunt active. Acest lucru trebuie să se întâmple de fiecare dată când se execută un proiect:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes este apelat mai rar.
• În plus, SIMCA-online necesită și date istorice. Aceste solicitări apar numai atunci când este necesar, cum ar fi să atingă începutul unui lot care a început înainte de începerea SIMCA-online sau când serverul rămâne în urmă și trebuie să citească un bloc de date:
  • simapi2_connectionReadHistoricalDataEx
• Opțional, unele configurații de proiect folosesc caracteristici care folosesc date de lot sau date discrete, ceea ce duce la apeluri SimApi la:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Opțional, unele configurații de proiect utilizează rescrierea pentru a împinge datele înapoi la sursa de date:
  • simapi2_connectionWriteHistoricalDataEx (și funcțiile corespunzătoare pentru date lot, date discrete)
• Este important ca fiecare apel la funcțiile de bază pentru obținerea datelor, readCurrentData, getActiveBatches/getBatchTimes, să fie rapid și nu este dificil din punct de vedere computațional pentru sursa de date în sine, având în vedere cât de des SIMCA-online poate apela acele funcții.

Testarea și validarea datelor SimApi

• Această secțiune este despre testarea unui SimApi pentru a verifica dacă datele returnate de la acesta se potrivesc cu datele din sursa de date în sine. Rularea unor astfel de teste este importantă după crearea sau modificarea implementării SimApi sau când se modifică API-ul unei surse de date.
• În practică, validarea datelor se face folosind SIMCA-online și funcționalitatea sa de extragere pentru a extrage date din sursa de date prin SimApi și apoi compararea cu datele brute din sursa de date. Desktop SIMCA nu poate fi folosit pentru a testa aspectele în timp real ale unui SimApi.

Pregătiri și cerințe

• Unele elemente sunt opționale, dar pot fi efectuate dacă domeniul de aplicare al testării dvs. le include:

1. Instalați SIMCA-online așa cum este descris în ReadMe and Installation Guide.pdf care vine în zip-ul produsului.
2. Obțineți o licență pentru serverul SIMCA-online și instalați-l. SimApi nu va funcționa fără licență. Articolul din baza de cunoștințe pentru SIMCA-online arată cum să licențiezi produsul. De example: SIMCA-online 18 (sartorius.com)
3. Instalați și configurați SimApi pe care doriți să-l testați. Consultați capitolele 4 – 5 din acest document și ghidul utilizatorului specific SimApi.
   • a. Opțional: asigurați-vă că ghidul utilizatorului este actualizat și corect.
4. Asigurați-vă că aveți un instrument pentru sursa dvs. de date cu care puteți să comparați datele SimApi.
5. În clientul desktop SIMCA-online, conectați-vă la serverul dvs. SIMCA-online și utilizați File > Extras pentru a obține date prin SimApi.
6. Opțional dacă domeniul dvs. de testare îl include: după terminarea testării, dezinstalați SimApi și verificați-i filesunt eliminate.

Ce să testezi

• Matricea de caracteristici din capitolul 3 listează toate caracteristicile posibile, dar o anumită implementare SimApi poate suporta doar un subset. Ar trebui să testați toate caracteristicile care sunt implementate de SimApi-ul dat.
• Următoarele teste sunt comune pentru majoritatea implementărilor SimApi:
• Autentificare cu nume de utilizator și parole
• Testați diferitele setări din configurația SimApi
• Ierarhia nodurilor: Nodurile și tags expuse de SimApi sunt corecte.
  • Trebuie să existe o tag expuse pentru toate „variabilele” care ar trebui să fie disponibile prin SimApi. Exampfișiere: măsurători de proces, valori calculate, constante.
• Reziliența conexiunii: dacă sursa de date nu este disponibilă, acest lucru duce la avertismente sau erori în jurnal file, dar că conexiunea la sursa de date este restabilită automat atunci când sursa de date este disponibilă.
• Instanțe multiple: că două instanțe pot fi configurate și utilizate independent și simultan, cu jurnalele separate files.
• Date curente: extrageți datele curente pentru tags. Asigurați-vă că datele sunt ultimele valori cunoscute din sursa de date sau lipsesc din cauza calității proaste sau când datele sunt prea vechi.
  • Extrageți datele la fiecare 10 secunde (sau cam asa ceva) timp de un minut.
• Date istorice continue: extrageți date istorice pentru tags.
  • Utilizați intervalul de timp care se potrivește când ați extras datele curente. Verificați dacă datele curente se potrivesc cu datele istorice și cu datele brute din sursa de date.
  • Încercați diferite intervale de timp și sampling intervale, verificați că datele se potrivesc cu sursa de date.
  • Încercați să extrageți datele la fiecare 1 s, care este cel mai scurt s posibilampinterval ling.
  • Încercați diferite tipuri de tags în sursa de date (variabile de proces etc.), asigurându-vă că datele se potrivesc.
  • Notă: SIMCA-online poate împărți o singură cerere mare de date istorice în mai multe bucăți mai mici. Acest lucru va fi vizibil în jurnalul SimApi.
• Verificați dacă SimApi funcționează cu date text, date numerice și date lipsă.
• Jurnal SimApi file. Verificați dacă jurnalul conține intrări rezonabile.
• Nod lot: faceți clic dreapta pe un nod și faceți Găsiți loturi.
  • Verificați numele loturilor, orele de început și orele de încheiere pentru loturi.
  • Încercați un lot activ care rulează în sursa de date. Nu ar trebui să aibă un timp de încheiere prin SimApi.
• Identificatorul de lot al nodului de proces tag. Dacă SimApi are funcționalitate de nod de lot (vezi marcatorul precedent), trebuie să aibă și un identificator de lot tag în nodul de date proces de potrivire. Date pentru asta tag ar trebui să fie identificatorul lotului (numele lotului). Aceste date sunt necesare pentru proiectele în loturi pentru a identifica ce lot îi aparține un rând de date.

În funcție de dacă SimApi îl acceptă, poate doriți să testați și:

• Loturi de date folosind File > Extras.
• Folosind date discrete File > Extras. Notă: pentru a testa date discrete cu File > Extrageți nodul, nodul batch și nodul de date discrete trebuie să fie în același SimApi (când SIMCA-online execută proiecte, acestea pot fi din diferite SimApis).
• Scrie înapoi – împingerea lotului de date la sursa de date. Pentru a testa acest lucru, trebuie să configurați o configurație de proiect în SIMCA-online pentru a scrie înapoi vectorii de date în sursa de date. Apoi executați proiectul în SIMCA-online și verificați datele care sunt scrise înapoi în sursa de date.
• Datele continue sunt configurate pe pagina Evolution Write Back din configurația proiectului.
• Datele discrete sunt configurate pe aceeași pagină, dar numai pentru o fază configurată pentru regăsirea datelor discrete.
• Date de lot din Batch Write back

MAI MULTE INFORMATII

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Suedia
• Telefon: + 46 90-18 48 00
• www.sartorius.com
• Informațiile și cifrele conținute în aceste instrucțiuni corespund datei versiunii specificate mai jos.
• Sartorius își rezervă dreptul de a aduce modificări tehnologiei, caracteristicilor, specificațiilor și designului echipamentului fără notificare prealabilă. Formele masculine sau feminine sunt folosite pentru a facilita lizibilitatea în aceste instrucțiuni și denotă întotdeauna simultan toate genurile.
  Notificare privind drepturile de autor:
• Aceste instrucțiuni, inclusiv toate componentele, sunt protejate prin drepturi de autor.
• Orice utilizare dincolo de limitele legii dreptului de autor nu este permisă fără aprobarea noastră.
• Acest lucru se aplică în special retipăririi, traducerii și editării, indiferent de tipul de suport utilizat.

FAQ

• Î: Care este scopul SimApis?
  • R: Scopul principal al SimApis este de a furniza date produselor Umetrics Suite pentru crearea de proiecte și construirea de modele.
• Î: Cum pot depana problemele cu o instalare SimApi?
  • R: Puteți remedia problemele testând din SIMCA-online, verificând jurnalul SimApi fileși asigurarea configurației corecte a contului de serviciu.

Documente/Resurse

SARTORIUS Sim Api Software [pdfGhid de utilizare Sim Api Software, Api Software, Software

Referințe

• Manual de utilizare