SARTORIUS Sim Api Software

Specificazioni

• Nome di u produttu: SimApi Guide
• Data di liberazione: 5 settembre 2024
• Scopu: Fornite dati à i prudutti Umetrics Suite

Istruzzioni per l'usu di u produttu

Introduzione à SimApis

• SimApis sò usati per ricuperà e dati per a creazione di prughjetti è a creazione di mudelli in i prudutti Umetrics Suite.

Ottenimentu di SimApis

• Per uttene SimApis, riferite à a documentazione ufficiale o cuntattate l'assistenza clienti per assistenza.

Funzioni di SimApi

• SimApis furnisce dati in tempu reale per u monitoraghju, u cuntrollu è a creazione di mudelli in SIMCA è SIMCA-online.

Solu l'usu attuale di dati

• Hè ricumandemu d'utilizà solu e dati attuali è evità i dati storichi per un rendiment ottimali.

Preparazione per una Installazione SimApi

• Prima di l'installazione, assicuratevi chì u vostru sistema risponde à i requisiti minimi specificati in a guida d'utilizatore.

Installazione di un SimApi

• Segui l'istruzzioni passu à passu furnite in u manuale d'utilizatore per installà u SimApi in u vostru sistema.

Configurazione di SimApi per SIMCA

• Configurate i paràmetri SimApi in SIMCA secondu e linee guida furnite.

Configurazione di SimApi per SIMCA-online

• Configurate u SimApi per a ricuperazione di dati in tempu reale è operazioni di scrittura in SIMCA-online.

Pruvazione è Risoluzione di Problemi

• Dopu a stallazione, eseguite a prova per assicurà a funziunalità curretta. In casu di prublemi, riferite à a sezione di risoluzione di prublemi in a guida d'utilizatore.

Testing da SIMCA-online

• Pruvate l'integrazione SimApi da SIMCA-online per verificà a ricuperazione di dati.

Risoluzione di prublemi cù Log Files

• Aduprate u logu SimApi file per identificà è risolve ogni prublema di installazione o operativa.

Cunfigurazione di u contu di serviziu

• Assicurà a cunfigurazione curretta di u contu di serviziu SIMCA-online per un funziunamentu senza saldatura.

Dettagli tecnici

• Riferite à a sezione 7 di a guida d'utilizatore per infurmazioni tecniche approfondite nantu à SimApis.

Introduzione à SimApis

• Un SimApi hè un'interfaccia software trà u software Umetrics® Suite è una fonte di dati. U scopu primariu di un SimApi hè di furnisce dati à SIMCA®-online o SIMCA®.
• Sartorius Stedim Data Analytics AB sviluppa SimApis per diverse fonti di dati, come i storici di processi e basi di dati generali.
• Stu documentu mostra ciò chì hè un SimApi, è cumu si usa in i prudutti Umetrics Suite. Ampararete cumu pianificà è installà un SimApi, cumu risolve i prublemi è cumu pruvà a vostra installazione. U capitulu finali cuntene dettagli tecnichi di SimApis destinatu à i sviluppatori.

Scopu SimApi: furnisce dati à i prudutti Umetrics Suite

• U scopu primariu di un SimApi hè di furnisce dati à SIMCA-online o SIMCA da una fonte di dati. A fonte di dati ùn hè micca parte di SIMCA-online, ma pò esse un storicu di prucessu o un altru sistema chì mantene è gestisce i dati.
• Un SimApi espone una ghjerarchia di nodi, chì currisponde à i cartulare in a file sistema. Ogni node pò cuntene altri nodi, o tags. A tag currisponde à una variabile. Per questi tags, i dati ponu esse acquistati. A stampa mostra a tag, Temp, sceltu in u node
• BakersYeastControlGood in una fonte di dati in SIMCA-online. Mostra dinò l'ultimi valori pigliati da a fonte di dati.

Utilizzo di SimApi in Umetrics Suite

• U software di scrittura SIMCA pò utilizà un SimApi per ricuperà e dati per a creazione di u prugettu è a creazione di mudelli cum'è l'illustra l'immagine seguente.
• SIMCA-online usa SimApis per ottene dati in tempu reale per u monitoraghju è u cuntrollu, è ancu per scrive dati à a fonte di dati. A stampa seguente mostra induve u SimApi hè in un sistema chì hè custituitu da una fonte di dati, u servitore SIMCA-online è i clienti.

SimApis cumunimenti usatu

• I SimApis più usati sò:
• U PI AF SimApi per a cunnessione à Aveva (ex OSIsoft) PI Systems.
• L'OPC UA SimApi
• L'ODBC SimApi - per l'accessu generale à e basa di dati cum'è SQL Server o Oracle
• Tutti i SimApis dispunibuli sò listati inseme cù e so caratteristiche in u paràgrafu 3.

U DBMaker SimApi per i dati di simulazione

• DBMaker hè una applicazione furnita cù l'installazione di u servitore SIMCA-online. Simula una fonte di dati, cum'è un storicu di prucessu, utilizendu una tabella di dati precaricata induve l'osservazioni sò furnite una per una à SIMCA-online attraversu u DBMaker SimApi.
• DBMaker hè solu utilizatu per scopi di dimostrazione è ùn pò micca esse usatu in a produzzione cù dati in diretta da una fonte di dati. Vede l'aiutu integratu per amparà di più nantu à DBMaker.

Documentazione supplementu

• Stu documentu hè unu di un inseme di documenti cunnessi, ognunu cù un focusu è u publicu di destinazione differenti:

Fonte	Chì	Induve
SIMCA-online web pagina	Informazione introduttiva è scaricamentu	sartorius.com/umetrics-simca- in linea

SIMCA-online ReadMe è Installazione.pdf	Stallazione è quantu à principiatu cù SIMCA- dati demo online	In u zip di stallazione file
Guida di implementazione SIMCA-online	Delinea a funziunalità SIMCA-online, a mette in cuntestu cù l'altri software Umetrics Suite, descrive i requisiti è e migliori pratiche per una implementazione riescita, è l'istruzzioni di installazione step-by-step.	sartorius.com/umetrics-simca- in linea
Guida SimApi	Preparazione è eseguisce installazioni SimApi, cumprese a risoluzione di prublemi. Contene ancu dettagli tecnichi nantu à SimApis per i sviluppatori.	sartorius.com/umetrics-simapi
Guide d'utilisation de SimApi	Documentazione per ogni SimApi publicatu cù funzioni, struzzioni di installazione è specifiche di cunfigurazione.	sartorius.com/umetrics-simapi
Guida tecnica SIMCA-online	Riferimentu tecnicu per a pianificazione di l'installazione di u servitore SIMCA-online, a risoluzione di i prublemi, è a prufundità di u funziunamentu di SIMCA-online.	sartorius.com/umetrics-simca-in linea
SIMCA-aiutu in linea	Web-based aiutu nantu à cumu aduprà SIMCA-online è cumu si travaglia SIMCA-online.	In u software stessu, è nantu sartorius.com/umetrics-simca
SIMCA-online Web Guida di Installazione di Clienti	Descrive l'installazione di SIMCA-online Web Cliente.	sartorius.com/umetrics-simca-in linea
Base di cunniscenza Umetrics	Base di dati ricercabile cù articuli nantu à ogni versione di software liberata, articuli tecnichi è prublemi cunnisciuti in i prudutti Umetrics Suite.	sartorius.com/umetrics-kb
SIMCA aiutu / guida d'usu	Cumu aduprà SIMCA desktop per creà prughjetti è dati di mudeli.	In SIMCA è avanti sartorius.com/umetrics-simca
Supportu web pagina	Cumu uttene un supportu tecnicu.	sartorius.com/umetrics-support

Supportu tecnicu

• A squadra di supportu in linea di Sartorius risponde à e dumande tecniche nantu à SimApis è pò ancu trasmette richieste per rinfurzà SimApis à e persone adatte. Sapete più à sartorius.com/umetrics-support.

Ottenimentu di SimApis

• Furnemu documentazione per SimApis dispunibili è ligami per i prugrammi di installazione à sartorius.com/umetrics-simapi.
• Ogni SimApi hè documentatu in a so Guida d'Usuariu.
• A Guida SimApi, chì site micca leghje, w cumplementa sta infurmazione cù SimApi cumplementari l'infurmazioni quandu si tratta di pianificazione, installazione è risoluzione di prublemi SimApi.

Funzioni di SimApi

• Micca tutte e fonti di dati sò simili. Un SimApi ùn hà micca bisognu di implementà tutte e funzioni in a specificazione. Per questi mutivi, diverse SimApis offre diverse funziunalità. A matrice seguente lista SimApis dispunibule è e so caratteristiche.
• I funziunalità sò spiegati sottu. Avvisu chì a tavula hà colonne separate per vede quale caratteristiche sò dispunibuli in SIMCA-online è SIMCA rispettivamente.

Feature	Scopu	SIMCA-utilizazione in linea	usu SIMCA
Dati attuali	Leghjite una sola osservazione cù u valore più recente da a fonte di dati.	Esecuzione normale in tempu reale	–
Dati storichi	Leghjite parechje osservazioni in una volta cù dati storichi da a fonte di dati.	Catch-up è predichendu di dati passati, creà prughjetti usendu File > Novu	Database Import Wizard per impurtà dati di prucessu per a creazione di mudelli.
Dati discreti	Leghjite i dati di u laboratoriu / IPC da a fonte di dati. Parechje osservazioni per batch.	Per prughjetti batch cù fasi o cundizioni batch cunfigurate per a ricuperazione di dati discreti.	–
Dati batch	Leghjite e cundizioni di batch è l'attributi di qualità finali (o	Cundizioni di batch o centru lucale.	Database Import Wizard per leghje e cundizioni batch per

Feature	Scopu	SIMCA-utilizazione in linea	usu SIMCA
	altri dati di tipu MES). Una osservazione per batch.		creazione di mudellu di livellu batch.
Batch node	Specificate l'ora di iniziu è l'ora di fine (viota per un batch attivu) per un batch specificu. Enumerate tutti i batchs chì esistevanu in un intervallu di tempu.	Necessario per l'esecuzione di cunfigurazioni batch.	Database Import Wizard per selezziunà i batch da impurtà.
Scrivite torna - dati cuntinuu	Scrivite dati cuntinui, cum'è predizioni, torna à a fonte di dati.	Scrivite i dati da u livellu di evoluzione di batch, per u Cunsigliu di Control o per cunfigurazioni cuntinue	–
Scrivite torna - discretu	Scrivite dati discreti, cum'è predizioni, torna à a fonte di dati.	Scrivite torna per cunfigurazioni batch à u livellu di evoluzione batch per fasi cunfigurate per a ricuperazione di dati discreti	–
Scrivite torna - dati batch	Scrivite e dati di livellu di batch, cum'è predizioni o attributi di qualità finali, à a fonte di dati.	Scrivite torna per a cunfigurazione di batch à u livellu di batch	–
Ierarchia di nodi	U SimApi sustene una gerarchia di nodi, simile à a file sistema. Ogni node pò cuntene tags è altri nodi. A ghjerarchia face hè più faciule per gestisce un gran numaru di nodi è tags.	Supportatu in tutti i lochi induve tags sò usati.
Array tag espansione	Un array tag memorizza i valori multipli. U SimApi allarga l'array tag à parechji individui tags, unu per ogni elementu in u array.	Supportatu induve tags sò usati per dati continui. Ogni espansione tag deve esse mappatu à una variabile in u prughjettu SIMCA.
Diverse fonti di dati	U SimApi pò cunnette à più di una sola fonte di dati o supporta parechje istanze di sè stessu cù paràmetri individuali è log files per ogni istanza.	Cunnette vi à parechje fonti di dati diffirenti di u listessu tipu.	–
Resilienza di cunnessione	Se u SimApi diventa disconnected from the data source, pruvarà à ristabilisce a cunnessione automaticamente.	U SimApi ùn deve esse riavviatu per ristabilisce e cunnessione à a fonte di dati.	–
Sviluppatu in-house	U SimApi hè sviluppatu, furnitu è ​​supportatu da

Solu i dati attuali, senza dati storichi, ùn hè micca cunsigliatu

• Certi SimApis, in particulare OPC DA, sustene solu a lettura di dati attuali, è micca di dati storichi.
• Un SimApi chì sustene solu e dati attuali ùn pò micca esse usatu in u SIMCA di u desktop, perchè ùn puderà micca leghje e dati storichi nantu à quale custruisce i mudelli.
• Per SIMCA-online, ricumandemu fermamente una fonte di dati è SimApi chì furnisce micca solu i dati attuali per l'esekzione in tempu reale, ma ancu i dati storichi per pudè predichendu è catch-up data passata. SIMCA-online cambia automaticamente trà e dati in tempu reale è i dati storichi cum'è necessariu è questu ùn pò micca esse disattivatu.
• Una fonte di dati chì furnisce solu dati attuali, ma micca dati storichi, pò travaglià per i prughjetti continui in SIMCA-online, ma per i prughjetti in batch, i dati storichi hè necessariu.

Preparazione per una installazione SimApi

• Questa sezione descrive infurmazione impurtante per una stallazione successu di un SimApi.

SimApis a 64 o 32 bit

• Ci sò versioni 32-bit è 64-bit di ogni SimApi.
• SIMCA-online è SIMCA sò 64-bit è necessitanu e varianti SimApis 64-bit. L'eredità SimApis 32-bit sò sempre dispunibili per installazioni più vechje.

Locu per u logu file è paràmetri

• Un SimApi guarda u so log files in u cartulare di dati di u prugramma nascostu 1:
  %programdata%\Umetrics\SimApi, induve %programdata% mappe à u cartulare attuale in u vostru urdinatore. Hè predeterminatu à C:\ProgramData.
• Ogni SimApi tipicamente usa u so propiu log file, chì simile à u logu di u servitore SIMCA-online file cuntene più o menu dati secondu un paràmetru di livellu di log. Questu file hè utile per risolve i prublemi. U logu file hè chjamatu
  .log induve hè u SimApi chì site installate, per esempiuample PIAFsimApi. Vede ancu a sezione dopu per i nomi di istanza SIMCA-online SimApi.
• Stu cartulare cuntene ancu i paràmetri SimApi in un XML file chjamatu .xml.
• A maiò parte di SimApis anu interfacce d'utilizatori gràfiche chì cambianu i paràmetri in u xml file, ma per alcuni entre i cambiamenti direttamente in XML file cù un editore di testu, cum'è Notepad. Vede a guida d'utilizatore per ogni SimApi.

File nomi quandu istanzi chjamati sò usati cù SIMCA-online

• In SIMCA-online, ogni istanza di SimApi riceve a so propria cunfigurazione file è logu file per travaglià cù parechje istanze di ogni SimApi. I nomi di questi files sò suffissi da u nome di l'istanza cum'è datu nantu à a tabulazione SimApi in u dialogu di Opzioni di u Server SIMCA-online.
• I seguenti example mostra u nome di questi files, induve deve esse rimpiazzatu cù u nome SimApi.
• Nome di cunfigurazione datu quandu l'istanza hè aghjuntu: OmegaServer
• Cunfigurazione file nome: OmegaServer.xml
• Log file nome: OmegaServer.log
• Nota chì u genericu file .log file hè sempre creatu. Stu logu file cuntene voci chì per ragioni tecniche ùn ponu esse diretti à u logu file di i casi..
• Stu cartulare hè oculatu in Windows per difettu. Per vede lu in File L'Explorer chì cunfigurate si mostra oculatu files. Nota chì pudete navigà à un cartulare oculatu scrivite un indirizzu File A barra di indirizzu di l'Explorer.
• Nota chì SIMCA ùn sustene micca parechje istanze di SimApi, è per quessa usa i nomi senza nome d'istanza cum'è descrittu sopra.

A pianificazione di a rete

• Duvete localizà u servore SIMCA-online vicinu à a fonte di dati in a reta. Questu assicura una cunnessione veloce trà SIMCA-online è a so fonte di dati.
• L'equipaggiu di rete pò interferiscenu cù a cunnessione trà SIMCA-online è a fonte di dati.

Cunti d'utilizatori è permessi di fonti di dati

• I fonti di dati tipicamente cuntrolanu l'accessu à e so dati. Questu hè generalmente fattu cù nomi d'utilizatore è password, ma ponu ancu esse aduprate restrizioni basate in l'indirizzu IP o DNS (per esempiuample PI si fida di Aveva PI System).
• U nome d'utilizatore è a password ponu esse furniti à a fonte di dati in diverse manere:
• Un SimApi hè gestitu cum'è l'utilizatore di Windows di l'utilizatore chì esegue SIMCA desktop o u contu di serviziu SIMCA-online nantu à l'urdinatore di u servitore. U SimApi pò cunnette à a fonte di dati utilizendu stu contu. Questu hè cumu l'OPC I, è u PI SimApi travaglianu, è ODBC si ùn furnisce micca credenziali quandu cunfigurà.
• Per l'ODBC genericu pudete aduprà l'applicazione ODBC Data Sources Administrator truvata in Start in Windows.
• Certi fornituri di basa di dati furnisce i so propiu driver è arnesi per e so basa di dati. basa di dati Oracle, per esempiuample, utilizate l'Oracle Data Access Components (ODAC).
• Certi SimApi, cum'è PI AF è ODBC, anu dialoghi di cunfigurazione chì guardanu e credenziali criptate in a cunfigurazione SimApi XML. file.
• PI hà ancu diverse opzioni di sicurezza dispunibili in i Strumenti di Gestione di u Sistema PI nantu à l'urdinatore di u servitore PI. Leghjite più in u PI AF SimApi User Guide. Questa guida hè utile ancu s'è vo aduprate u vechju OSIsoft PI SimApi.
• OPC DA è HDA utilizanu DCOM cum'è u trasportu trà una fonte di dati è SimApi. DCOM hè cunfiguratu cù l'uttellu di servizii di cumpunenti (DCOMCNFG.EXE) in Windows è usa l'autentificazione di Windows.
• Per l'OSIsoft PI SimApi più anticu (micca l'AF SimApi più recente), l'applicazione OSIsoft AboutPI-SDK (PISDKUtility.exe) hè aduprata per stabilisce a cunnessione à u servitore PI.

Verificà a cunnessione di a fonte di dati
Quandu vulete installà un SimApi in un computer, pò esse utile per verificà a cunnessione da quellu computer à a fonte di dati cù un altru strumentu:

• ODBC Data Sources in Windows hè utilizatu per cunfigurà è pruvà ODBC genericu. Nota chì ci sò duie versioni di questu strumentu in Windows 64-bit: una per l'applicazioni 32-bit è una per 64-bit. Aduprate u buttone Test Data Source à a fine di l'assistente di cunfigurazione ODBC per verificà a cunnessione à a basa di dati. Avemu cunsigliatu per cunfigurà e vostre fonti di dati cum'è DSN di Sistema.
• Un strumentu di cunnessione specificu per a basa di dati da u fornitore di a basa di dati, cum'è l'Oracle Data Access Components.
• PI System Explorer pò esse usatu per pruvà a cunnessione à u servitore PI AF. Hè parte di u Client PI AF chì hè un prerequisitu per u PI AF SimApi.
• OPC UA Expert da Unified Automation - UaExpert hè un client di test multipiattaforma per i servitori OPC UA.
• L'applicazione PI-SDK (PISDKUtility.exe) pò esse usata per pruvà a cunnessione è à view ogni messagiu d'errore chì puderia esse registratu quandu SIMCA-online prova di cunnette à u servitore PI. Questu hè solu utilizatu per l'anziani OSIsoft SimApi, micca PIAF.
• I Strumenti di Gestione di u Sistema PI sò aduprati nantu à l'urdinatore di u servitore PI per a risoluzione di prublemi da quellu latu. Per esample, per circà i prublemi di sicurità chì impediscenu l'accessu da u servore SIMCA-online. Sapete più nantu à a risoluzione di i prublemi di u sistema PI in stu video di YouTube.
• Excel pò esse usatu per ottene dati da una cunnessione ODBC è a maiò parte di l'altri sistemi quandu un plugin adattatu hè stallatu.
• Matrikon OPC Explorer per Ior HDA (questi sò strumenti separati) pò esse usatu per pruvà a cunnessione OPC, è Matrikon OPC Analyzer pò esse usatu per diagnosticà i prublemi di cunnessione OPC. Scaricate questi strumenti gratuiti da https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (per DInd HDA) da l'Istitutu di Formazione OPC web situ "permette à l'utilizatori di diagnosticà facilmente i prublemi di cumunicazione è di sicurità, è riparà istantaneamente cù a pressione di un buttone. Tuttu chistu pò esse fattu senza mai avè da amparà à cunfigurà DCOM "

Installazione di un SimApi

Eccu cumu installà un SimApi in un PC:

1. Leghjite a Guida d'Usuariu per u SimApi chì site installatu. Contene specifiche per quellu SimApi chì cumplementarii l'istruzzioni generale chì state leghje avà.
2. Installa è cunfigurà qualsiasi prerequisiti citati in a Guida d'Usuariu SimApi (per esampi driver di basa di dati o SDK)
3. Eseguite u prugramma di cunfigurazione per installà u SimApi. Installa a versione 64-bit (x64) o 32-bit (x86) chì currisponde à u software in quale l'eseguirà.
4. Configurate u SimApi in SIMCA-online o SIMCA cum'è deskrittu in e sezioni seguenti è riferite à a guida d'utilizatore di SimApi per descrizzione di i paràmetri dispunibili.
5. Avviate u servitore SIMCA-online. Nota chì questu pò piglià u tempu, perchè quandu u SimApi hè inizializatu, enumerarà tutti tags in a fonte di dati.
6. Pruvate u SimApi ottenendu qualchi dati. Per SIMCA-online, pudete aduprà File > Estratti cum'è discrittu in 6.1.
7. Se u SimApi ùn funziona cum'è previstu, riferite à u log SimApi files per a risoluzione di i prublemi, è à a guida d'utilizatore SimApi.

Configurazione di u SimApi per l'usu in SIMCA

Eccu cumu utilizà u SimApi in SIMCA:

1.  Cumincià l'importazione di basa di dati in unu di i seguenti modi:
   • a. Per creà un novu prughjettu in SIMCA: File > Novu Prughjettu Regular o Novu Prughjettu Batch. Selezziunà Da a basa di dati nantu à a tabulazione Home.
   • b. Per impurtà un settore di dati in un prughjettu esistente in SIMCA: Da u dataset in a tabulazione Dati di un prughjettu SIMCA apertu.
2. Cliccate Aggiungi una nova fonte di dati
3. Selezziunate SimApi cum'è u tipu di cunnessione, cliccate nantu à u ...-buttone è localizza u .dll in u cartulare di stallazione, è cliccate Open.
4. Cliccate Configurate è riferite à a Guida d'Usuariu SimApi individuale cumu fà i paràmetri.
5. Cliccate nantu à a cunnessione di a fonte di dati Test per verificà chì pudete cunnette à a basa di dati. Questu pò piglià assai tempu s'ellu ci sò parechji tags in a fonte di dati.
6. Cliccate OK per compie a cunfigurazione.
7. Riferite à l'aiutu SIMCA per cumu travaglià cù dati impurtati.

Configurazione di u SimApi per l'usu in SIMCA-online

• Impurtante: Per pudè utilizà un SimApi, una licenza di u servitore SIMCA-online hè necessaria. Una stallazione demo di SIMCA-online ùn permette micca di utilizà SimApis.
• Per aghjunghje un SimApi à u sistema, eseguite SIMCA-online Server Options in u PC di u servitore. Amparate i passi di dettagli in u tema di l'aiutu SICMA-online Aggiungi è cunfigurà un SimApi nantu à u servitore.
• Tip: Se fate cambiamenti per un SimApi, pudete riavvia quellu SimApi separatamente da l'Opzioni di u Servitore senza riavvia tuttu u servitore.
• Per cunfigurà parechje istanze di questu SimApi, ripetite i passi sopra è utilizate nomi unichi per ogni istanza. Leghjite più nantu à e diverse log è cunfigurazione files per i casi in 4.2.

Testu è risolve i prublemi di un SimApi

• Stu capitulu hè di pruvà è risolve i prublemi di una stallazione SimApi.

Pruvate un SimApi da SIMCA-online

• Una volta chì u servitore SIMCA-online hè statu iniziatu bè, pudete pruvà u vostru SimApi in SIMCA-online (se u servitore ùn principia micca, vede 6.2):
• Accedi à u servitore in u cliente SIMCA-online, è navigate à Extract in u File tab. Extract vi aiuta à pruvà u SimApi ottenendu dati attraversu:
• I nodi ("cartulare") di u SimApi sò visualizati in a casella di manca. Tags per u node sceltu sò visualizati in cima à destra.
• I dati attuali ponu esse testati rapidamente semplicemente clicchendu view> nantu tags chì furnisce dati di prucessu cuntinuu (vede a screenshot)
• Cliccate cù u dirittu nantu à un node per Truvà batch in un intervallu di tempu. U node deve esse un node batch chì sapi di batch.
• Selezziunà tags in Extract è cliccate Next è finisce l'assistente per ottene dati utilizendu e diverse modi di ricuperazione di dati: dati attuali, storichi, batch è discreti.
• Comparare i dati estratti cù ciò chì vede in a vostra fonte di dati cù i so strumenti. Sapete più nantu à a prova è a validazione di tutte e funzioni di un SimApi in 7.13.

Risolve i prublemi SimApi cù u logu SimApi file

• Se u servitore ùn principia micca, u SimApi ùn funziona micca cum'è previstu o l'estrazione falla, avete bisognu di cunsultà u log SimApi. file chì vi dice quale hè u prublema. Abilita u logu à livellu di Debug in u logu SimApi per uttene tutti i dettagli. Vede 4.2.
• Nota: i logs di u servitore SIMCA-online ùn sò micca cusì utili quì. Mostraranu cumu u SimApi hè stata caricata è inizializzata da u servitore, ma i dettagli specifichi SimApi sò in u so log. file.

Aduprà u drittu contu serviziu SIMCA-online

• Quandu si pruvate l'accessu à a fonti di dati, ricordate chì site cunnessu cum'è un utilizatore specificu in l'urdinatore di u servitore (tipicamenti u vostru contu d'utilizatore in un duminiu Windows), ma chì u contu di serviziu di u servitore SIMCA-online hè un cuntu diversu, per difettu LocalSystem, chì hà diritti d'accessu diffirenti in paragunà à u vostru contu d'utilizatore.
• Per quessa, ùn hè micca raru chì i testi travaglianu quandu eseguite cum'è u vostru contu, ma chì SIMCA-online ùn riesce à cunnette à a fonte di dati.
• Per risolve stu prublema, l'accessu deve esse accordatu per u contu utilizatu da u serviziu di u servitore SIMCA-online. Di genere, cambiate LocalSystem à un contu di serviziu di duminiu specificu, è cuncede diritti à questu contu. Nota chì questu ùn hè micca applicatu se u SimApi usa credenziali chì sò stabiliti in a cunfigurazione SimApi perchè queste credenziali anu a priorità.

Dettagli tecnici su SimApis

• Stu capitulu dà dettagli tecnichi nantu à cumu funziona un SimApi. Hè principalmente destinatu à i sviluppatori chì volenu capisce SimApis per implementà un SimApi per una fonte di dati.
• I sviluppatori anu da leghje ancu e parti precedenti di stu documentu per una introduzione à SimApis è à e descrizzioni d'altu livellu di funzioni.

Quandu cunsiderà sviluppà un SimApi è quandu micca?

Prima di cunsiderà sviluppà un SimApi per una fonte di dati:

1. Investigate s'ellu ci hè digià un SimApi chì pudete aduprà. Forsi pudete attivà qualchì funzione in a vostra fonte di dati per utilizà unu di i SimApis esistenti, cum'è OPC UA.
2. Passà cù cura stu ducumentu è e so referenze è investigate se a vostra fonti di dati cumpleta i requisiti: per esample, ci vole à esse abbastanza veloce, furnisce micca solu dati attuali, ma ancu dati storichi.

• Per questi mutivi, ùn ricumandemu micca di sviluppà un SimApi chì cunnetta à hardware o strumenti di livellu bassu. Hè megliu cunnette quelli strumenti à un storicu di prucessu cum'è Aveva PI System, è lasciate ottene dati da u strumentu, è storici. Allora u PIAF SimApi pò esse usatu per ottene dati da PI à u pruduttu Umetrics.

Sviluppu SimApi è a specificazione SimApi

• A specificazione SimApi, SimApi-v2, cuntene a documentazione per tutte e funzioni C in u SimApi chì una DLL SimApi deve implementà è ancu una guida per cumu sviluppà un SimApi.
• L'implementazione di un SimApi cù C o C++ hè in a maiò parte di i casi à un livellu inutilmente bassu.
• U modu cunsigliatu, è più faciule, per implementà un SimApi hè di basallu nantu à l'Exampcodice fonte leSimApi chì furnimu. Hè un exampl'implementazione SimApi chì gestisce l'interfaccia C è a traduce in.NET Framework induve l'implementazione vera hè fatta. Havi ancu un codice framework per logging, paràmetri, cunfigurazione GUI, è altru codice framework.
• Per sviluppà un SimApi, a squadra di sviluppatori hà bisognu di sperienza in u sviluppu di Windows, .NET Framework, C, o C++. Una bona cunniscenza di a fonte di dati chì u SimApi deve cunnette hè ancu necessariu, perchè u scopu di un SimApi hè di traduce e richieste di dati da SIMCA-online o SIMCA à l'API di a fonte di dati. Una implementazione di SimApi ùn hè mai un prughjettu unicu, ma di solitu necessita un supportu continuu è un mantenimentu occasionale.

Leghje o scrive dati

• Un SimApi hà u compitu principale di furnisce dati da una fonte di dati. Questu hè chjamatu dati di lettura.
• A maiò parte di l'implementazioni SimApi supportanu ancu a scrittura di dati. Questu significa scrive torna dati attraversu u SimApi à a fonte di dati. A scrittura di dati hè una funzione facultativa in SIMCA-online.

Tags è Nodi

• A tag hè un identificatore di una colonna o "variabile" in una fonte di dati. A tagU nome hè usatu per identificà tag. I nomi in u nodu devenu esse unichi. SIMCA-online 18 hè a prima versione per sustene un node chì cuntene un subnode è tag cù u listessu nome. Per esample: u node Parent puderia avè un subnode chjamatu Batch è a tag chjamatu Batch.
• Un node hè un containeru di tags. Un node pò ancu cuntene altri nodi, simili à cumu a file sistema hà cartulare in cartulare.
• Cum'è in a file sistema, u node è tag i nomi ponu esse cumminati à un percorsu cumpletu chì identifica in modu unicu a tag. U tag chjassi sò usati in SIMCA-online o SIMCA quandu selezziunate tags à aduprà. A tag U percorsu principia cù un nome d'istanza SimApi seguitu da a struttura di nodu, è finisce cù u tag nome, ogni articulu separatu cù un puntu (:). Per esample ":ODBCSQLServer:Node:SensorTag1 ".

U SimApi enumera tags è nodi à l'iniziu

• Una implementazione SimApi cerca u servitore per i nodi è tags in a fonte di dati quandu u SimApi hè inizializatu è mantene a traccia di elli in modu chì e diverse funzioni SimApi chì sò aduprate per enumerazione tags è node pò esse implementatu.
• L'inizializazione di SimApi ùn succede micca solu à l'iniziu di u servitore, ma pò ancu esse riattivata da un utilizatore in SIMCA-online cù a funziunalità Refresh SimApi.

Sensibilità di casu tag- è nomi di nodi

• Tag i nomi è i nomi di i nodi sò sensible à u casu.
• Cusì, a tag chjamatu "tag1" ùn hè micca listessu chì "Tag1" per via di u casu sfarente di a "T". Si ricumandemu contru à l'usu tags o nomi di nodi chì sò diffirenti solu in casu.

Node di prucessu cuntinuu 

• Quandu un node cuntene tags cù dati di prucessu cuntinuu, pò esse chjamatu un node di prucessu. I seguenti dui screenshots mostranu una rapprisintazioni tabulare di un nodu di prucessu cù e dati seguitu da una stampa chì mostra cumu si vede u node quandu selezziunate tags in SIMCA-online.

I nodi di prucessu cuntinuu devenu esse indipendenti di batch, runs, o time

• Per travaglià bè in un SimApi, un node deve esse indipindente da batch, runs, o time. Avè un node chì cuntene dati per un batch specificu o intervallu di tempu ùn funziona micca bè in SIMCA-online perchè a cunfigurazione di u prugettu puderia leghje solu dati per quellu batch è micca esse usatu per altri batch.
• Invece, un node deve esse mappatu à una o più unità fisiche in u prucessu induve e misure sò realizate.

ID di batch tag necessariu in i nodi di prucessu cuntinuu per l'esekzione di prughjettu batch

• Ogni prucessu cuntinuu deve avè a tag (variabile) tenendu l'identificatore di batch per ogni osservazione. Stu identificatore di batch hè utilizatu da SIMCA o SIMCA-online per sapè à quale batch appartene ogni osservazione.
• U $BatchID tag in i screenshots in 7.4.3 hè un tali example.
  Mentre ùn hè micca necessariu, hè cunsigliatu per avè un tag in u node di prucessu chì mostra a fase attuale o u passu di u prucessu. Questu tag pò tandu ièssiri usatu in cundizioni di esecuzione di fasi in SIMCA-online o in SIMCA quandu importa dati. Valori per questu tag pò esse per example "fase1", "pulizia", ​​"fase2".

Node di cuntestu batch

• Un node batch hè un node chì mantene a traccia di batch; i so identificatori di batch, i tempi di iniziu è i tempi di fine. Hè un requisitu per l'esekzione di prughjettu batch in SIMCA-online. Una fonte di dati pò avè più di un nodu di batch chì espone i batch in diverse manere. L'utilizatore sceglie u node batch chì s'applica à a so applicazione. Questu example espone i batchs chì coprenu duie unità diverse:
• /Factory1 - batches cù una vita aggregata nantu à l'Unità1 è l'Unità2.
• /Factory1/Unit1 - batchs cù a vita in Unit1 solu
• /Factory1/Unit2 - batchs cù a vita in Unit2 solu
• Se ùn avete micca un node batch in a vostra fonte di dati, pudete aduprà u Batch Context Generator in SIMCA-online. Vede l'aiutu integratu.
• Dati di batch optional
• Un node batch pò ancu cuntene dati batch; dati per quale ci hè una sola osservazione per tuttu u batch. Nota chì tags cù dati batch ùn deve esse in un node chì hà tutte e funziunalità di un node batch. Hè abbastanza chì u SimApi supporta a lettura di dati batch per u tags. Sapete più nantu à i dati batch in 7.6.
• Eccu un example di un nodu batch:
• Nota: A screenshot sopra hè presa da DBMaker, bundled cù SIMCA-online. Per vede questu stessu in DBMaker, cliccate nantu à View U buttone di dati nantu à a basa di dati Bakers Yeast per vede duie finestre, una di quale hè u nodu batch, è l'altru i dati di u prucessu.

Tipi di dati: dati numerichi, dati di testu, è dati mancanti

• Per ognunu tag, un SimApi pò sustene trè tippi di dati: numerica, tex, t è missing:
• I dati numerichi sò tipicamente valori reali di parametri di prucessu, per esample 6.5123. U SimApi pò trattà solu i valori à virgule flottante di precisione unica di 32 bit. Formatu à virgule flottante à precisione unica - Wikipedia. Tutti l'altri tipi di dati numerichi in una fonte di dati deve esse cunvertiti in float. Comu tali, ponu trattà cù i valori grandi è chjuchi, ma cù solu circa 6 o 7 cifre significati. Sapete più in a Guida Tecnica.
• Questu pò purtà à a perdita di precisione per numeri interi grossi o per numeri veri chì sò tramindui grandi è anu decimali. Per più infurmazione, vede a Guida Tecnica.
• I dati di testu / stringa sò aduprati per l'ID di batch, e cundizioni di esecuzione di fasi o per variàbili qualitativi. I valori per u testu tag i dati sò case sensitive. Questu significa chì u valore "running" ùn hè micca u stessu
  "CORRE". I variàbili di datetime ùn sò micca supportati direttamente da SimApi, ma ponu esse restituiti cum'è una stringa furmatu cum'è AA-MM-DD HH:MM (per esempiuample “2020-09-07 13:45”).
• I valori mancanti significanu chì ùn ci hè micca valore per rinvià, vale à dì, senza dati.
• Chì tippu hè tornatu dipende da l'implementazione SimApi. Un SimApi cunnosci i dati in a fonte di dati è deve rinvià u tipu di dati chì si adatta megliu.

Trè modi di ricuperazione di dati: Continuu, Batc, h è Discrete

• A specificazione SimApi definisce trè modi di ricuperazione di dati, ie,. trè modi diffirenti chì u SimApi pò furnisce dati da tags in una fonte di dati (o in l'altra direzzione: scrive dati à tags in una fonte di dati).
• Recuperazione di dati continuu - questu si riferisce à e dati letti continuamente, è sequentially, l'osservazione per osservazione mentre u batch o prucessu evoluzione. I dati sò letti per l'ora attuale, o per un intervallu specificu, à un intervallu regulare trà l'osservazioni. Per esample, tutti i dati trà 09:00:00 è 10:00:00 sampguidatu ogni 60 seconde, risultatu in 61 osservazioni quandu i punti finali sò inclusi.
• Recuperazione di dati di batch - questu si riferisce à una sola osservazione cù dati per un batch sanu (micca assuciatu cù una maturità specifica o un puntu di tempu). L'attributi di batch è i dati di centru lucali sò letti cum'è dati batch in SIMCA-online. E cundizioni di batch sò nurmalmente leghjite ancu cum'è dati batch (salvo chì sò cunfigurati per a ricuperazione di dati discreti).
• Recuperazione di dati discreti - dati discreti ponu esse cumposti da parechje osservazioni per parechje maturità. Ma à u cuntrariu di i dati continui, i dati discreti ùn sò micca letti in sequenza, ma piuttostu tutti i dati in una volta per una fase specifica di un batch. I dati ùn anu micca bisognu di spazii cù intervalli regulari di a variabile di maturità. Tutti i dati sò riletti ogni volta chì i dati sò dumandati, à l'intervallu cunfiguratu.
• Per ogni datu tag I dati ponu esse dumandati in qualsiasi di i trè modi, ma tipicamenti un SimApi sustene solu unu di sti modi per un individuu. tag. In listessu modu, hè permessu di mischjà tags in un node, ma tipicamente tutti tags in un nodu specificu sustene u listessu modu di ricuperazione di dati.
• Per i dati cuntinui (ma micca per i dati batch-o discreti2), e dumande ponu esse fatte per dati attuali o dati storichi chì hè u tema di a sezione dopu.
• Ùn sò micca tutti i SimApis supportanu tutti i modi. Vede a matrice di funziunalità sopra è u SimApi web pagina per i dettagli.

Dati cuntinui attuali è storichi attraversu un SimApi

• A dati cuntinuu si riferisce à i dati di prucessu chì cambianu cù u tempu.

Dati attuali

• Reading data currente significa dumandà à a fonte di dati per l'ultimi valori di tags à u mumentu di dumandà. Avete chì u tempu di a fonte di dati esterni ùn hè micca usatu quì.
• I dati leghje cum'è data attuale hè ciò chì SIMCA-online mostrarà cum'è dati in diretta. Per quessa, hè impurtante chì ùn ci hè micca ritardu innecessariu in a fonte di dati. Dati attuali deve esse u più recenti pussibule per travaglià bè in SIMCA-online.
• A fonte di dati pò utilizà a so cunniscenza di e dati è quantu i valori sò validi è decide di rinvià i dati mancanti quandu i dati crudi per un puntu di tempu hè troppu vechju. Per esample: data hè dumandata à 15:00:00 ma u puntu di dati più recente in a fonte di dati hè da 03:00:00. In questu casu, i dati sò 12 ore, cusì u SimApi pò decide di vultà u valore mancante (senza dati).

Dati storichi

• A lettura di dati storichi significa dumandà à a fonte di dati per i valori di unu o più tags per un intervallu di tempu specificu cù un intervallu specificu trà l'osservazioni. Avete chì quì hè l'ora locale di a fonte di dati chì hè utilizata per truvà e dati. Dunque, a sincronizazione di u tempu trà a fonte di dati è i servitori hè impurtante.
• I dati storichi sò custituiti da una matrice di dati. Hè à l'implementazione SimApi di dumandà i dati da a fonte di dati, è samplasciate à l'intervallu specificatu è custruisce a matrice di dati per rinvià:
• Calchì volta a surghjente di dati stessu hà funzioni aggregazione di vultà dati trasfurmati, o sampling funzioni, chì pò ièssiri usatu a riturnà i dati dritta.
• Per altre fonti di dati, u SimApi deve dumandà tutte e dati in u intervalu di tempu è dopu sample l'osservazioni ghjustu per custruisce a matrice.
• I dati devenu esse restituiti per un intervallu di tempu, ancu s'ellu ùn pò esse micca dati crudi in u intervalu di tempu, ma solu ghjustu prima di l'ora di iniziu. Per esample: data esiste in a fonte di dati à i punti di u tempu 10 è 20. U SimApi dumanda dati per u tempu 15 è 17. In questu casu, i valori per u puntu di tempu 10 deve esse restituiti da u SimApi, ma u tempu più altu.amped cum'è u tempu 15 è 17 postu chì questi eranu i punti di dati più recenti in quelli tempi. I valori per tags à u mumentu 10 sò riferiti cum'è valori di limiti per u intervallu dumandatu. Per una spiegazione più profonda di i valori di i limiti, vede per exampLeghjite a documentazione per returnBounds in UA Part 11: Accessu Storicu - 6.4.3 Struttura ReadRawModifiedDetails
  (opcfoundation.org)
• L'interpolazione ùn deve mai esse aduprata per calculà i valori per i punti futuri di u tempu, perchè e dati ùn currispondenu micca ciò chì hè lettu in tempu reale cum'è data attuale. Per l'example da u bullet precedente: se i dati per 15 è 17 anu da esse interpolati cù i valori per l'elementu 10 è 20, anu utilizatu in modu efficace i valori da u futuru, chì ùn hè micca permessu.
• A fonti di dati pò utilizà a so cunniscenza di e dati è quantu i valori sò validi è decide di rinvià i dati mancanti quandu i dati crudi per un puntu di tempu sò vechji. Per esample: data hè dumandata per 15:00:00 ma u puntu di dati più recente in a fonte di dati hè da 03:00:00. In questu casu, i dati sò 12 ore, cusì u SimApi pò decide di vultà u valore mancante (senza dati).

Nota: SIMCA-online tipicamente ùn richiede più di centu osservazioni in una chjama durante l'esekzione normale di u prugettu. Quandu facia estratti in SIMCA-online, o quandu eseguisce SIMCA desktop, ponu esse fatte richieste più grande di dati. Quessi pò piglià assai tempu, chì deve esse aspittatu.

I dati attuali è i dati storichi anu da cuncordà

• Calchì volta ci ponu esse differenze quandu i dati sò leghje cum'è dati attuali in tempu reale o dati storichi. Questu causa prublemi in SIMCA-online perchè u servitore cambia automaticamente trà e dati attuali è storici cum'è necessariu.

Acquisizione di dati à bassa latenza

• Quandu una fonte di dati hè utilizatu da SIMCA-online in tempu reale, hè impurtante chì i dati in a fonte di dati hè attuale. Ùn deve esse micca ritardi innecessarii in l'acquistu di dati in a fonte di dati. I dati di prucessu cuntinuu per tutte e variàbili devenu esse dispunibili à u stessu tempu per ogni osservazione. I dati chì venenu tardi per alcune variabili ùn saranu micca raccolti da SIMCA-online.

I dati ponu esse letti per ogni mumentu 

• Quandu SIMCA-online dumanda un valore di a tag per u tempu t riceverà u valore da a fonte di dati da u tempu t, o l'ultima osservazione in a fonte di dati prima di u tempu t, o un valore interpolatu per u tempu t. Cusì, u servitore riceverà sempre un valore à ogni volta chì dumanda, ancu s'è una osservazione per questu puntu di tempu esatta puderia micca esse in a fonte di dati.
• Timestamps in u SimApi sò sempre UTC. I clienti SIMCA-online è SIMCA presentanu l'ora cum'è l'ora locale.

Threading 

• U SimApi hè, per difettu, chjamatu da un solu filu da l'utilizatori di SimApi. Questu hè veru per tutte e versioni SIMCA è SIMCA-online finu à a versione 17.
• SIMCA-online 18 supporta una bandiera di funzione per attivà l'accessu multi-thread attraversu SimApi. Leghjite più in u tema di l'aiutu Accessu SimApi Concurrent.
• Questu significa chì SimApis deve esse preparatu per u multi-threading, se pussibule, rendendu u filu di implementazione SimApi sicuru, è documentà questu è qualsiasi cunsiderazione per l'utilizatori di SimApi.

Log file

• Un SimApi deve logu azzione, messagi d'errore è avvirtimenti à u so log file per aiutà à risolve i prublemi. Aduprate i sfarenti livelli di log per significà l'impurtanza di u logu.
• Hè cunsigliatu di logà "Non implementatu" per e funzioni chì ùn sò micca implementate in un SimApi.

Trattamentu di errore

• Quandu un SimApi ùn pò micca cumpiendu una dumanda da a fonte di dati pò trattà stu prublema in una di duie manere; restituendu i valori mancanti (senza dati) o signalendu un errore SimApi:
• Riturnà i valori mancanti à u chjamante è u successu di signalazione permette à u chjamante di cuntinuà cum'è normale (ma di sicuru senza dati). Questa hè una pratica cunsigliata per errori parziali, cum'è quandu i dati puderanu esse ottenuti per alcuni, ma micca tutti, tags in una dumanda.
• A signalazione di un errore SimApi permette à u chjamante (per esampu servore SIMCA-online) per vede questu immediatamente è per agisce. Questa hè una pratica cunsigliata per e dumande chì falla cumplettamente è ùn pò micca rinvià alcuna dati in tuttu.
• SIMCA-online tratta i valori mancanti o i codici d'errore in modu diversu, cum'è descrittu in a Guida Tecnica SIMCA-online.

Requisiti di prestazione SimApi

• E funzioni in u SimApi sò usati per ottene dati.
• Se l'accessu di dati hè lentu, u SimApi ùn viaghja micca bè chì questu example mostra: Se SIMCA-online dumanda dati ogni siconda, ma ci vole dui seconde à ottene, u servore SIMCA-online ùn sarà mai capaci di mantene in tempu reale, ma progressivamente cascanu più è più daretu.
• In i sub-sezzioni vi mustraremu cumu SIMCA è SIMCA-online utilizanu l'accessu à e dati e funzioni SimApi è quante frequenze seranu chjamate e funzioni SimApi. Questu pò aiutà à stabilisce esigenze di rendiment per una implementazione SimApi.

L'usu di SIMCA di e funzioni SimApi

• Quandu u SIMCA di u desktop o altri prudutti offline utilizanu un SimApi per ottene dati, queste dumande seranu per batch è dati di prucessu per un settore di variàbili in un certu intervallu di tempu.
• Siccomu sti dumande sò iniziati manualmente da un utilizatore, ùn succede micca assai freti è ùn causanu micca una carica significativa à una fonte di dati.
• Queste funzioni SimApi sò aduprate per ottene e dati:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

L'usu di SIMCA-online di e funzioni SimApi

• SIMCA-online hè utilizatu per u monitoraghju in tempu reale di un prucessu, è per quessa dumanda dati attraversu SimApi à intervalli regulari. L'intervallu di esecuzione più cortu chì pò esse usatu hè di 1 secondu. Certi ex di u mondu realeampL'intervalli di esecuzione sò di 10 s, 1 minutu o 10 minuti.
• Un servitore pò avè parechji prughjetti in esecuzione à u stessu tempu.
• Per riduce u nùmeru di chjamate API attraversu SimApi, u servitore ottimizza e dumande di dati raggruppendu parechje richieste più chjuche in una sola dumanda più grande per tutte e variabili à u stessu tempu (amparate più in u tema di l'aiutu "A lettura ottimizzata da e fonti di dati migliora u rendiment").
• L'algoritmu di esecuzione di u servitore funziona cusì quandu dumanda dati utilizendu e funzioni SimApi listate quì sottu:
• Tutte e fasi chì eseguite à u stessu intervallu sò raggruppati in una sola chjamata SimApi per riduce u numeru di chjamate. U servitore leghje l'ultime dati per tutte e variàbili utilizati da tutti i mudelli chì sparte l'intervallu, vale à dì, sta chjamata hà da risultatu in una larga fila di dati chì dopu hè utilizatu da tutti i prughjetti.
  • simapi2_connectionReadCurrentData
• Per ogni prughjettu di batch u servitore hà ancu bisognu di sapè quale batch sò attivi. Questu hè ancu bisognu ogni volta chì un prughjettu eseguisce:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes hè chjamatu menu freti.
• Inoltre, SIMCA-online richiede ancu dati storichi. Queste dumande accade solu quandu hè necessariu, cum'è catch up l'iniziu di un batch chì hà iniziatu prima chì SIMCA-online hè stata iniziata, o quandu u servitore hè cascatu è hà bisognu di leghje un bloccu di dati:
  • simapi2_connectionReadHistoricalDataEx
• Opzionalmente, alcune cunfigurazione di u prughjettu utilizanu funzioni chì utilizanu dati batch o dati discreti chì risultanu in chjama SimApi à:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Opzionalmente, una certa cunfigurazione di u prughjettu usa a scrittura per rinvià e dati à a fonte di dati:
  • simapi2_connectionWriteHistoricalDataEx (è e funzioni currispondenti per i dati batch, dati discreti)
• Hè impurtante chì ogni chjama à e funzioni core per ottene dati, readCurrentData, getActiveBatches/getBatchTimes, hè veloce è chì ùn hè micca computationally dura per a fonte di dati stessu, datu quantu spessu SIMCA-online pò chjamà quelli funzioni.

Testing è validazione di dati SimApi

• Questa sezione hè di pruvà un SimApi per verificà chì i dati tornati da ellu currispondenu à i dati in a fonte di dati stessu. Esecuzione di teste cum'è questu hè impurtante dopu à creà o cambià l'implementazione SimApi, o quandu l'API di una fonte di dati cambia.
• In pratica, a validazione di dati hè fatta cù SIMCA-online è a so funziunalità Extract per tirà e dati da a fonte di dati attraversu u SimApi è poi paragunendu cù e dati crudi in a fonte di dati. Desktop SIMCA ùn pò esse usatu per pruvà l'aspettu in tempu reale di un SimApi.

Preparazioni è esigenze

• Certi elementi sò opzionali, ma ponu esse realizati se u scopu di a vostra prova include:

1. Installa SIMCA-online cum'è discrittu in ReadMe and Installation Guide.pdf chì vene in u zip di u produttu.
2. Ottene una licenza per u servore SIMCA-online è stallà lu. U SimApi ùn funziona micca senza licenza. L'articulu di basa di cunniscenza per SIMCA-online mostra cumu licenziari u pruduttu. Per esample: SIMCA-online 18 (sartorius.com)
3. Installa è cunfigurà u SimApi chì vulete pruvà. Riferite à i capituli 4 – 5 in stu documentu è a guida d'usu di u SimApi specificu.
   • a. Facoltativu: assicuratevi chì a guida di l'utilizatori hè aghjurnata è curretta.
4. Assicuratevi di avè un strumentu per a vostra fonte di dati chì pudete aduprà per paragunà i dati SimApi.
5. In u cliente di desktop SIMCA-online, accede à u vostru servitore SIMCA-online è aduprà File > Estrattu per ottene dati attraversu u SimApi.
6. Opzionale se u vostru scopu di teste include: dopu avè finitu a prova, disinstalla u SimApi è verificate u so files sò cacciati.

Cosa à pruvà

• A matrice di funziunalità in u capitulu 3 elenca tutte e funziunalità pussibuli, ma una implementazione SimApi data pò sustene solu un subset. Duvete pruvà tutte e funziunalità chì sò implementate da u SimApi datu.
• I testi seguenti sò cumuni à a maiò parte di l'implementazioni SimApi:
• Autentificazione cù nomi d'utilizatore è password
• Pruvate e diverse paràmetri in a cunfigurazione di u SimApi
• Gerarchia di nodi: i nodi è tags esposti da u SimApi sò curretti.
  • Ci deve esse a tag esposta per tutte e "variabili" chì deve esse dispunibule attraversu u SimApi. Esamples: misure di prucessu, valori calculati, custanti.
• Resilienza di cunnessione: se a fonte di dati ùn hè micca dispunibule, questu risultatu in avvirtimenti o errori in u log file, ma chì a cunnessione à a fonte di dati hè ristabilita automaticamente quandu a fonte di dati hè dispunibule.
• Casi multipli: chì duie istanze ponu esse cunfigurate è usate indipindentamente è simultaneamente, cù logs separati files.
• Dati attuali: estrae i dati attuali per tags. Assicuratevi chì i dati sò l'ultimi valori cunnisciuti da a fonte di dati, o mancanti per mala qualità o quandu i dati sò troppu vechji.
  • Extract data ogni 10 seconde (o più) per un minutu.
• Dati storicu cuntinuu: estratti dati storichi per tags.
  • Aduprate u intervalu di tempu chì currisponde à quandu avete estratto i dati attuali. Verificate chì i dati attuali currispondenu à i dati storichi, è i dati crudi in a fonte di dati.
  • Pruvate diverse intervalli di tempu è sampling intervalli, verificate i dati currisponde à a fonte di dati.
  • Pruvate di estrazione di dati ogni 1 s, chì hè u s più cortu pussibuleampling interval.
  • Pruvate diversi tipi tags in a fonte di dati (variabili di prucessu, etc.), assicurendu chì i dati currispondenu.
  • Nota: SIMCA-online pò divide una sola grande dumanda di dati storichi in parechji pezzi più chjuchi. Questu serà visibile in u logu SimApi.
• Verificate chì u SimApi travaglia cù dati di testu, dati numerichi è dati mancanti.
• log SimApi file. Verificate chì u logu cuntene entrate ragionevuli.
• Batch node: cliccate right-click un node è fate Find batches.
  • Verificate i nomi di batch, l'ora di iniziu, l'ora di fine per i batch.
  • Pruvate un batch attivu chì hè in esecuzione in a fonte di dati. Ùn deve micca avè un tempu di fine attraversu u SimApi.
• Identificatore di batch di u nodu di prucessu tag. Se u SimApi hà una funziunalità di nodu di batch (vede u bullet precedente), deve ancu avè un identificatore di batch. tag in u nodu di dati di u prucessu currispundente. Dati per questu tag deve esse l'identificatore di batch (nome di u batch). Questa dati hè necessariu per i prughjetti di batch per identificà à quale batch appartene una fila di dati.

Sicondu se u SimApi supporta, pudete ancu vulete pruvà:

• Batch data usendu File > Estrattu.
• Dati discreti utilizendu File > Estrattu. Nota: per pruvà dati discreti cù File > Estrae u node, u nodu batch è u node di dati discretu deve esse in u stessu SimApi (quandu SIMCA-online eseguisce prughjetti, ponu esse da SimApis diffirenti).
• Scrivite torna - spinghje u batch di dati à a fonte di dati. Per pruvà questu, duvete cunfigurà una cunfigurazione di u prughjettu in SIMCA-online per scrive vettori di dati à a fonte di dati. Allora eseguisce u prughjettu in SIMCA-online è verificate i dati chì sò scritti in a fonte di dati.
• I dati cuntinui sò cunfigurati nantu à a pagina Evolution Write Back in a cunfigurazione di u prugettu.
• I dati discreti sò cunfigurati in a stessa pagina, ma solu per una fase cunfigurata per a ricuperazione di dati discreti.
• Batch data da u Batch Write back

MORE INFO

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Sweden
• Telefono: +46 90-18 48 00
• www.sartorius.com
• L'infurmazioni è i figuri cuntenuti in queste istruzioni currispondenu à a data di versione specificata quì sottu.
• Sartorius si riserva u dirittu di fà cambiamenti à a tecnulugia, caratteristiche, specificazioni è design di l'equipaggiu senza preavvisu. Forme masculine o femine sò aduprate per facilità a leghjibilità in queste struzzioni è sempre denote simultaneamente tutti i generi.
  Avvisu di copyright:
• Queste istruzioni, cumpresi tutti i cumpunenti, sò prutetti da copyright.
• Ogni usu oltre i limiti di a lege di copyright ùn hè micca permessu senza a nostra appruvazioni.
• Questu hè applicà in particulare à a ristampa, a traduzzione è a editazione, indipendentemente da u tipu di supportu utilizatu.

FAQ

• Q: Chì ghjè u scopu di SimApis?
  • A: U scopu principale di SimApis hè di furnisce dati à i prudutti Umetrics Suite per a creazione di prughjetti è a creazione di mudelli.
• Q: Cumu possu risolve i prublemi cù una installazione SimApi?
  • A: Pudete risolve i prublemi per pruvà da SIMCA-online, cuntrollà u log SimApi file, è assicurendu a cunfigurazione curretta di u contu di serviziu.

Documenti / Risorse

SARTORIUS Sim Api Software [pdfGuida di l'utente Software Sim Api, Software Api, Software

Referenze

• Manuale d'usu