Programari SARTORIUS Sim Api

Especificacions

• Nom del producte: Guia SimApi
• Data de llançament: 5 de setembre de 2024
• Finalitat: Proporcionar dades als productes Umetrics Suite

Instruccions d'ús del producte

Introducció a SimApis

• Els SimApis s'utilitzen per recuperar dades per a la creació de projectes i la creació de models als productes Umetrics Suite.

Obtenció de SimApis

• Per obtenir SimApis, consulteu la documentació oficial o poseu-vos en contacte amb l'assistència al client per obtenir ajuda.

Característiques de SimApi

• SimApis ofereix dades en temps real per al seguiment, control i creació de models a SIMCA i SIMCA-online.

Només l'ús actual de dades

• Es recomana utilitzar només les dades actuals i evitar les dades històriques per obtenir un rendiment òptim.

Preparació per a una instal·lació de SimApi

• Abans de la instal·lació, assegureu-vos que el vostre sistema compleix els requisits mínims especificats a la guia de l'usuari.

Instal·lació d'un SimApi

• Seguiu les instruccions pas a pas que es proporcionen al manual d'usuari per instal·lar el SimApi al vostre sistema.

Configuració de SimApi per SIMCA

• Configureu la configuració de SimApi a SIMCA segons les directrius proporcionades.

Configuració de SimApi per a SIMCA-online

• Configureu el SimApi per a les operacions de recuperació i escriptura de dades en temps real a SIMCA-online.

Prova i resolució de problemes

• Després de la instal·lació, feu proves per assegurar-vos que funcioni correctament. En cas de problemes, consulteu la secció de resolució de problemes de la guia de l'usuari.

Prova des de SIMCA-online

• Proveu la integració de SimApi des de SIMCA-online per verificar la recuperació de dades.

Resolució de problemes amb Log Files

• Utilitzeu el registre de SimApi file per identificar i resoldre qualsevol problema d'instal·lació o funcionament.

Configuració del compte de servei

• Assegureu-vos de la configuració correcta del compte de servei SIMCA-online per a un funcionament perfecte.

Detalls tècnics

• Consulteu la secció 7 de la guia de l'usuari per obtenir informació tècnica detallada sobre SimApis.

Introducció a SimApis

• Un SimApi és una interfície de programari entre el programari Umetrics® Suite i una font de dades. L'objectiu principal d'un SimApi és proporcionar dades a SIMCA®-online o SIMCA®.
• Sartorius Stedim Data Analytics AB desenvolupa SimApis per a moltes fonts de dades diferents, com ara historiadors de processos i bases de dades de propòsit general.
• Aquest document mostra què és un SimApi i com s'utilitza als productes Umetrics Suite. Aprendràs com planificar i instal·lar un SimApi, com resoldre problemes i com provar la teva instal·lació. El capítol final conté detalls tècnics de SimApis dirigits als desenvolupadors.

Propòsit de SimApi: proporcionar dades als productes Umetrics Suite

• L'objectiu principal d'un SimApi és proporcionar dades a SIMCA-online o SIMCA des d'una font de dades. La font de dades no forma part de SIMCA-online, però pot ser un historiador de processos o un altre sistema que conserva i gestiona les dades.
• Un SimApi exposa una jerarquia de nodes, corresponent a carpetes a file sistema. Cada node pot contenir altres nodes, o tags. A tag correspon a una variable. Per aquests tags, es poden obtenir dades. La imatge mostra a tag, Temp, seleccionat al node
• BakersYeastControlGood en una font de dades a SIMCA-online. També mostra els darrers valors extrets de la font de dades.

Ús de SimApi a la Suite Umetrics

• El programari d'escriptori SIMCA pot utilitzar un SimApi per recuperar dades per a la creació de projectes i la construcció de models, tal com il·lustra la imatge següent.
• SIMCA-online utilitza SimApis per obtenir dades en temps real per al seguiment i control, així com per escriure dades a la font de dades. La imatge següent mostra on es troba el SimApi en un sistema que consta d'una font de dades, un servidor SIMCA en línia i clients.

SimApis d'ús habitual

• Els SimApis més utilitzats són:
• El PI AF SimApi per connectar-se a Aveva (anteriorment OSIsoft) PI Systems.
• L'OPC UA SimApi
• L'ODBC SimApi: per a l'accés general a bases de dades com ara SQL Server o Oracle
• Tots els SimApis disponibles s'enumeren juntament amb les seves característiques al paràgraf 3.

El DBMaker SimApi per a dades de simulació

• DBMaker és una aplicació proporcionada amb la instal·lació del servidor SIMCA-online. Simula una font de dades, com ara un historiador de processos, mitjançant l'ús d'una taula de dades precarregada on les observacions es proporcionen una per una a SIMCA-online mitjançant el DBMaker SimApi.
• DBMaker només s'utilitza amb finalitats de demostració i no es pot utilitzar en producció amb dades en directe d'una font de dades. Consulteu l'ajuda integrada per obtenir més informació sobre DBMaker.

Documentació addicional

• Aquest document forma part d'un conjunt de documents relacionats, cadascun amb un enfocament i un públic objectiu diferents:

Font	Què	On
SIMCA-online web pàgina	Informació introductòria i descàrregues	sartorius.com/umetrics-simca- en línia

SIMCA-online ReadMe and Installation.pdf	Instal·lació i com començar amb SIMCA- dades de demostració en línia	Al zip d'instal·lació file
Guia d'implementació SIMCA-online	Descriu la funcionalitat SIMCA-online, la posa en context amb altres programaris d'Umetrics Suite, descriu els requisits i les millors pràctiques per a un desplegament reeixit i les instruccions d'instal·lació pas a pas.	sartorius.com/umetrics-simca- en línia
Guia SimApi	Preparació i realització de les instal·lacions de SimApi, inclosa la resolució de problemes. També conté detalls tècnics sobre SimApis per a desenvolupadors.	sartorius.com/umetrics-simapi
Guies d'usuari de SimApi	Documentació per a cada SimApi publicat amb característiques, instruccions d'instal·lació i especificacions de configuració.	sartorius.com/umetrics-simapi
Guia tècnica SIMCA-online	Referència tècnica per a la planificació de la instal·lació del servidor SIMCA-online, la resolució de problemes i el funcionament en profunditat de SIMCA-online.	sartorius.com/umetrics-simca-en línia
SIMCA-ajuda en línia	Webajuda basada en com utilitzar SIMCA-online i com funciona SIMCA-online.	Al programari en si, i endavant sartorius.com/umetrics-simca
SIMCA-online Web Guia d'instal·lació del client	Descriu la instal·lació del SIMCA-online Web Client.	sartorius.com/umetrics-simca-en línia
Base de coneixements Umetrics	Base de dades en què es pot cercar amb articles sobre cada versió de programari publicada, articles tècnics i problemes coneguts dels productes de la suite Umetrics.	sartorius.com/umetrics-kb
Ajuda/guia d'usuari SIMCA	Com utilitzar SIMCA d'escriptori per crear projectes i modelar dades.	A SIMCA i endavant sartorius.com/umetrics-simca
Suport web pàgina	Com obtenir suport tècnic.	sartorius.com/umetrics-support

Suport tècnic

• L'equip d'assistència en línia de Sartorius respon a les preguntes tècniques sobre SimApis i també pot enviar les sol·licituds de millora de SimApis a les persones adients. Més informació a sartorius.com/umetrics-support.

Obtenció de SimApis

• Oferim documentació per a SimApis disponible i enllaços als programes d'instal·lació a sartorius.com/umetrics-simapi.
• Cada SimApi està documentat a la seva Guia d'usuari.
• La Guia de SimApi, que estàs llegint no, w complementa aquesta informació amb informació complementària de SimApi quan es tracta de planificar, instal·lar i resoldre problemes de SimApi.

Característiques de SimApi

• No totes les fonts de dades són iguals. Un SimApi no necessita implementar totes les funcions de l'especificació. Per aquests motius, diferents SimApis ofereixen diferents funcionalitats. La matriu següent enumera els SimApis disponibles i les seves característiques.
• Les característiques s'expliquen a continuació. Tingueu en compte que la taula té columnes separades per mostrar quines funcions estan disponibles a SIMCA-online i SIMCA respectivament.

Característica	Propòsit	SIMCA-ús en línia	Ús de SIMCA
Dades actuals	Llegeix una única observació amb el valor més recent de la font de dades.	Execució normal en temps real	–
Dades històriques	Llegiu moltes observacions alhora amb dades històriques de la font de dades.	Posar-se al dia i predir dades passades, crear projectes utilitzant File > Nou	Assistent d'importació de bases de dades per importar dades de procés per a la creació de models.
Dades discretes	Llegir dades de laboratori/IPC de la font de dades. Moltes observacions per lot.	Per a projectes per lots amb fases o condicions de lot configurades per a la recuperació de dades discretes.	–
Dades del lot	Llegeix les condicions del lot i els atributs de qualitat finals (o	Condicions del lot o centrat local.	Assistent d'importació de bases de dades per llegir les condicions del lot

Característica	Propòsit	SIMCA-ús en línia	Ús de SIMCA
	altres dades del tipus MES). Una observació per lot.		creació de models a nivell de lot.
Node de lots	Especifiqueu l'hora d'inici i l'hora de finalització (buida per a un lot actiu) per a un lot específic. Enumereu tots els lots que van existir en un interval de temps.	Necessari per a l'execució de configuracions per lots.	Assistent d'importació de bases de dades per seleccionar lots per importar.
Escriu de nou: dades contínues	Escriu dades contínues, com ara prediccions, a la font de dades.	Escriu les dades del nivell d'evolució del lot, per a Control Advisor o per a configuracions contínues	–
Escriu de nou - discret	Escriu dades discretes, com ara prediccions, a la font de dades.	Escriu de nou per a configuracions de lots al nivell d'evolució de lots per a les fases configurades per a la recuperació de dades discretes	–
Tornar a escriure: dades del lot	Torneu a escriure dades a nivell de lot, com ara prediccions o atributs de qualitat finals, a la font de dades.	Torneu a escriure per a la configuració del lot a nivell de lot	–
Jerarquia de nodes	El SimApi admet una jerarquia de nodes, de manera similar a a file sistema. Cada node pot contenir tags i altres nodes. La jerarquia facilita la gestió d'un gran nombre de nodes i tags.	Suport en tots els llocs on tags s'utilitzen.
Matriu tag expansió	Una matriu tag emmagatzema diversos valors. El SimApi amplia la matriu tag a molts individus tags, un per a cada element de la matriu.	Donat suport tags s'utilitzen per a dades contínues. Cadascun es va expandir tag s'ha de mapar a una variable del projecte SIMCA.
Diverses fonts de dades	El SimApi es pot connectar a més d'una font de dades o admet diverses instàncies de si mateix amb configuració i registre individuals files per a cada instància.	Connecteu-vos a diverses fonts de dades diferents del mateix tipus.	–
Resiliència de connexió	Si el SimApi es desconnecta de la font de dades, intentarà restablir la connexió automàticament.	El SimApi no s'ha de reiniciar per restablir les connexions a la font de dades.	–
Desenvolupat internament	El SimApi està desenvolupat, proporcionat i recolzat per

No es recomana només dades actuals, sense dades històriques

• Alguns SimApis, especialment OPC DA, només admeten la lectura de dades actuals, i no de dades històriques.
• Un SimApi que només admeti dades actuals no es pot utilitzar al SIMCA d'escriptori, perquè no podrà llegir dades històriques sobre les quals construir els models.
• Per a SIMCA-online, recomanem fermament una font de dades i un SimApi que proporcionin no només dades actuals per a l'execució en temps real, sinó també dades històriques per poder predir i recuperar dades anteriors. SIMCA-online canvia automàticament entre dades en temps real i dades històriques segons sigui necessari i això no es pot desactivar.
• Una font de dades que només proporcioni dades actuals, però no dades històriques, pot funcionar per a projectes continus a SIMCA-online, però per a projectes per lots, es requereixen dades històriques.

Preparació per a una instal·lació de SimApi

• Aquesta secció descriu informació important per a una instal·lació correcta d'un SimApi.

SimApis de 64 o 32 bits

• Hi ha versions de 32 i 64 bits de cada SimApi.
• SIMCA-online i SIMCA són de 64 bits i requereixen les variants de SimApis de 64 bits. Els SimApis de 32 bits heretats encara estan disponibles per a instal·lacions anteriors.

Ubicació per al registre file i configuracions

• Un SimApi emmagatzema el seu registre files a la carpeta de dades del programa oculta 1:
  %programdata%\Umetrics\SimApi, on %programdata% s'assigna a la carpeta real de l'ordinador. El valor predeterminat és C:\ProgramData.
• Cada SimApi normalment utilitza el seu propi registre file, que de manera similar al registre del servidor SIMCA-online file contindrà més o menys dades en funció de la configuració del nivell de registre. Això file és útil per resoldre problemes. El registre file es diu
  .log on és el SimApi que esteu instal·lant, per exempleample PIAFsimApi. Vegeu també la següent secció per als noms d'instàncies de SimApi SIMCA en línia.
• Aquesta carpeta també conté la configuració de SimApi en un XML file nomenat .xml.
• La majoria de SimApis tenen interfícies gràfiques d'usuari que canvien la configuració del xml file, però per a alguns introduïu els canvis directament a l'XML file amb un editor de text, com ara el Bloc de notes. Consulteu la guia d'usuari de cada SimApi.

File noms quan les instàncies amb nom s'utilitzen amb SIMCA-online

• A SIMCA-online, cada instància de SimApi té la seva pròpia configuració file i registre file per treballar amb múltiples instàncies de cada SimApi. Els noms d'aquests files tenen el sufix del nom de la instància tal com es mostra a la pestanya SimApi al diàleg d'Opcions del servidor SIMCA-online.
• El següent example mostra el nom d'aquests files, on s'ha de substituir pel nom SimApi.
• Nom de configuració donat quan s'afegeix la instància: OmegaServer
• Configuració file nom: OmegaServer.xml
• Registre file nom: OmegaServer.log
• Tingueu en compte que el genèric file .log file encara es crea. Aquest registre file conté entrades que per motius tècnics no es poden dirigir al registre file de les instàncies..
• Aquesta carpeta està oculta a Windows per defecte. Per veure-ho a File L'explorador el configureu mostra ocult files. Tingueu en compte que podeu navegar a una carpeta oculta escrivint una adreça File Barra d'adreces de l'explorador.
• Tingueu en compte que SIMCA no admet múltiples instàncies del SimApi i, per tant, utilitza els noms sense nom de la instància tal com es descriu anteriorment.

Planificació de la xarxa

• Hauríeu de localitzar el servidor SIMCA-online a prop de la font de dades a la xarxa. Això garanteix una connexió ràpida entre SIMCA-online i la seva font de dades.
• Els equips de xarxa poden interferir amb la connexió entre SIMCA-online i la font de dades.

Comptes d'usuari i permisos de fonts de dades

• Les fonts de dades solen controlar l'accés a les seves dades. Això normalment es fa amb noms d'usuari i contrasenyes, però també es poden utilitzar restriccions basades en adreces IP o DNS (per exempleample PI confia en Aveva PI System).
• El nom d'usuari i la contrasenya es poden proporcionar a la font de dades de diferents maneres:
• Un SimApi s'executa com l'usuari de Windows de l'usuari que executa SIMCA d'escriptori o el compte de servei SIMCA en línia a l'ordinador servidor. El SimApi es pot connectar a la font de dades mitjançant aquest compte. Així és com funcionen l'OPC I i el PI SimApi, i ODBC si no proporcioneu credencials en configurar-lo.
• Per a l'ODBC genèric, podeu utilitzar l'aplicació Administrador de fonts de dades ODBC que es troba a Inici a Windows.
• Alguns proveïdors de bases de dades proporcionen els seus propis controladors i eines per a les seves bases de dades. bases de dades Oracle, per example, utilitzeu Oracle Data Access Components (ODAC).
• Alguns SimApi, com ara PI AF i ODBC, tenen diàlegs de configuració que emmagatzemen les credencials xifrades a la configuració XML de SimApi file.
• PI també té diverses opcions de seguretat disponibles a les eines de gestió del PI System a l'ordinador del servidor PI. Més informació a la Guia d'usuari de PI AF SimApi. Aquesta guia és útil fins i tot si feu servir l'OSIsoft PI SimApi més antic.
• OPC DA i HDA utilitzen DCOM com a transport entre una font de dades i SimApi. DCOM es configura amb l'eina de serveis de components (DCOMCNFG.EXE) a Windows i utilitza l'autenticació de Windows.
• Per a l'OSIsoft PI SimApi més antic (no l'AF SimApi més recent), s'utilitza l'aplicació OSIsoft AboutPI-SDK (PISDKUtility.exe) per configurar la connexió al servidor PI.

Verificació de la connectivitat de la font de dades
Quan voleu instal·lar un SimApi en un ordinador, pot ser útil verificar la connectivitat d'aquest ordinador a la font de dades amb una altra eina:

• Les fonts de dades ODBC a Windows s'utilitzen per configurar i provar ODBC genèric. Tingueu en compte que hi ha dues versions d'aquesta eina a Windows de 64 bits: una per a aplicacions de 32 bits i una altra per a 64 bits. Utilitzeu el botó Prova la font de dades al final de l'assistent de configuració d'ODBC per verificar la connectivitat a la base de dades. Us recomanem que configureu les fonts de dades com a DSN del sistema.
• Una eina de connexió específica de la base de dades del proveïdor de la base de dades, com ara els components d'accés a dades d'Oracle.
• El PI System Explorer es pot utilitzar per provar la connectivitat amb el servidor PI AF. Forma part del client PI AF, que és un requisit previ per al PI AF SimApi.
• OPC UA Expert d'Unified Automation: UaExpert és un client de prova multiplataforma per a servidors OPC UA.
• L'aplicació PI-SDK (PISDKUtility.exe) es pot utilitzar per provar la connectivitat i view qualsevol missatge d'error que s'hagi pogut registrar quan SIMCA-online intenta connectar-se al servidor PI. Això només s'utilitza per a l'OSIsoft SimApi més antic, no PIAF.
• Les eines de gestió del PI System s'utilitzen a l'ordinador del servidor PI per resoldre problemes des d'aquest costat. Per example, per buscar problemes de seguretat que impedeixen l'accés des del servidor SIMCA-online. Obteniu més informació sobre la resolució de problemes del sistema PI en aquest vídeo de YouTube.
• Excel es pot utilitzar per obtenir dades d'una connexió ODBC i de la majoria dels altres sistemes quan s'instal·la un connector adequat.
• Matrikon OPC Explorer per Ior HDA (aquestes són eines separades) es pot utilitzar per provar la connectivitat OPC, i Matrikon OPC Analyzer es pot utilitzar per diagnosticar problemes de connectivitat OPC. Descarrega aquestes eines gratuïtes de https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• Rescat OPC (per DInd HDA) de l'Institut de Formació OPC web El lloc "permet als usuaris diagnosticar fàcilment problemes de comunicació i seguretat, i reparar-los a l'instant amb només prémer un botó. Tot això es pot fer sense haver d'aprendre mai a configurar DCOM"

Instal·lació d'un SimApi

A continuació s'explica com instal·lar un SimApi en un ordinador:

1. Llegiu la Guia d'usuari del SimApi que esteu instal·lant. Conté detalls específics per a aquest SimApi que complementen les instruccions generals que esteu llegint ara.
2. Instal·leu i configureu qualsevol requisit previ esmentat a la Guia d'usuari de SimApi (per exemple,ampcontroladors de bases de dades de fitxers o SDK)
3. Executeu el programa de configuració per instal·lar el SimApi. Instal·leu la versió de 64 bits (x64) o de 32 bits (x86) que coincideixi amb el programari en què l'executaràs.
4. Configureu el SimApi a SIMCA-online o SIMCA tal com es descriu a les seccions següents i consulteu la guia d'usuari del SimApi per obtenir descripcions de la configuració disponible.
5. Inicieu el servidor SIMCA-online. Tingueu en compte que això pot trigar temps, perquè quan s'inicialitzi el SimApi, ho enumerarà tot tags a la font de dades.
6. Proveu el SimApi obtenint algunes dades. Per a SIMCA-online, podeu utilitzar File > Extreu tal com es descriu a 6.1.
7. Si el SimApi no funciona com s'esperava, consulteu el registre de SimApi files per a la resolució de problemes i a la guia d'usuari de SimApi.

Configuració del SimApi per utilitzar-lo a SIMCA

A continuació s'explica com utilitzar el SimApi a SIMCA:

1.  Inicieu la importació de la base de dades d'una de les maneres següents:
   • a. Per crear un nou projecte a SIMCA: File > Nou projecte regular o nou projecte per lots. Seleccioneu Des de la base de dades a la pestanya Inici.
   • b. Per importar un conjunt de dades en un projecte existent a SIMCA: Des del conjunt de dades a la pestanya Dades d'un projecte SIMCA obert.
2. Feu clic a Afegeix una font de dades nova
3. Seleccioneu SimApi com a tipus de connexió, feu clic al botó... i localitzeu el .dll a la carpeta d'instal·lació i feu clic a Obre.
4. Feu clic a Configura i consulteu la Guia d'usuari de SimApi individual sobre com fer la configuració.
5. Feu clic a Prova la connexió de la font de dades per verificar que us podeu connectar a la base de dades. Això pot trigar molt de temps si n'hi ha molts tags a la font de dades.
6. Feu clic a D'acord per completar la configuració.
7. Consulteu l'ajuda de SIMCA per saber com treballar amb dades importades.

Configuració del SimApi per utilitzar-lo a SIMCA-online

• Important: per poder utilitzar un SimApi, cal una llicència de servidor SIMCA en línia. Una instal·lació de demostració de SIMCA-online no permet utilitzar SimApis.
• Per afegir un SimApi al sistema, executeu les Opcions del servidor SIMCA-online al PC del servidor. Conegueu els passos detallats al tema d'ajuda en línia de SICMA Afegir i configurar un SimApi al servidor.
• Consell: si feu canvis per a un SimApi, podeu reiniciar-lo per separat des d'Opcions del servidor sense reiniciar tot el servidor.
• Per configurar diverses instàncies d'aquest SimApi, repetiu els passos anteriors i utilitzeu noms únics per a cada instància. Llegiu més sobre els diferents registres i configuració files per als casos de 4.2.

Prova i resolució de problemes d'un SimApi

• Aquest capítol tracta sobre provar i resoldre problemes d'instal·lació de SimApi.

Provant un SimApi des de SIMCA-online

• Un cop el servidor SIMCA-online s'ha iniciat correctament, podeu provar el vostre SimApi a SIMCA-online (si el servidor no s'inicia, vegeu 6.2):
• Inicieu la sessió al servidor al client SIMCA-online i navegueu a Extracte al File pestanya. Extract us ajuda a provar el SimApi obtenint dades a través d'ell:
• Els nodes ("carpetes") del SimApi es mostren al quadre esquerre. Tags per al node seleccionat es mostren a la part superior dreta.
• Les dades actuals es poden provar ràpidament fent clic view> activat tags que proporcionen dades de procés continu (vegeu la captura de pantalla)
• Feu clic amb el botó dret sobre un node per trobar lots dins d'un interval de temps. El node ha de ser un node de lots que sàpiga sobre lots.
• Seleccioneu tags a Extreu i feu clic a Següent i finalitzeu l'assistent per obtenir dades mitjançant els diferents modes de recuperació de dades: dades actuals, històriques, per lots i discretes.
• Compareu les dades extretes amb les que veieu a la vostra font de dades mitjançant les seves eines. Obteniu més informació sobre com provar i validar totes les funcions d'un SimApi a la versió 7.13.

Resoldre problemes de SimApi mitjançant el registre de SimApi file

• Si el servidor no s'inicia, el SimApi no funciona com s'esperava o l'extracció falla, heu de consultar el registre de SimApi file que t'indica quin és el problema. Activeu el registre de nivell de depuració al registre de SimApi per obtenir tots els detalls. Vegeu 4.2.
• Nota: els registres del servidor SIMCA-online no són tan útils aquí. Mostraran com el servidor va carregar i inicialitzar el SimApi, però els detalls específics de SimApi es troben al seu registre file.

Utilitzeu el compte de servei en línia SIMCA adequat

• Quan esteu provant l'accés a la font de dades, recordeu que heu iniciat sessió com a usuari específic a l'ordinador del servidor (normalment el vostre propi compte d'usuari en un domini de Windows), però que el compte de servei del servidor SIMCA-online és un compte diferent, per defecte LocalSystem, que té drets d'accés diferents en comparació amb el vostre compte d'usuari.
• Per aquest motiu, no és estrany que les proves funcionin quan s'executen com a compte, però que SIMCA-online no es pugui connectar a la font de dades.
• Per solucionar aquest problema, s'ha de concedir l'accés al compte utilitzat pel servei del servidor SIMCA-online. Normalment, canvieu LocalSystem a un compte de servei de domini específic i concedeu drets sobre aquest compte. Tingueu en compte que això no s'aplica si el SimApi utilitza credencials establertes a la configuració de SimApi perquè aquestes credencials tenen prioritat.

Detalls tècnics a SimApis

• Aquest capítol ofereix detalls tècnics sobre com funciona un SimApi. Està dirigit principalment als desenvolupadors que volen entendre SimApis per implementar un SimApi per a una font de dades.
• Els desenvolupadors també haurien de llegir les parts anteriors d'aquest document per obtenir una introducció a SimApis i a les descripcions d'alt nivell de les funcions.

Quan pensar en desenvolupar un SimApi i quan no?

Abans de plantejar-vos desenvolupar un SimApi per a una font de dades:

1. Investigueu si ja hi ha un SimApi que podeu utilitzar. Potser podeu habilitar alguna característica de la vostra font de dades per utilitzar un dels SimApis existents, com ara OPC UA.
2. Reviseu amb cura aquest document i les seves referències i investigueu si la vostra font de dades compleix els requisits: per exempleampcal que sigui prou ràpid, no només proporcionar dades actuals, sinó també dades històriques.

• Per aquests motius, no recomanem desenvolupar un SimApi que es connecti a maquinari o instruments de baix nivell. És millor connectar aquests instruments a un historiador de processos com Aveva PI System, i deixar-lo obtenir dades de l'instrument i historiitzar-los. A continuació, el PIAF SimApi es pot utilitzar per obtenir dades de PI al producte Umetrics.

Desenvolupament de SimApi i l'especificació SimApi

• L'especificació SimApi, SimApi-v2, conté documentació per a totes les funcions C del SimApi que ha d'implementar una DLL de SimApi, així com algunes instruccions sobre com desenvolupar un SimApi.
• La implementació d'un SimApi amb C o C++ és en la majoria dels casos a un nivell innecessàriament baix.
• La manera recomanada i més fàcil d'implementar un SimApi és basar-lo en l'Exampcodi font leSimApi que oferim. És un exampImplementació SimApi que gestiona la interfície C i la tradueix a.NET Framework on es fa la implementació real. També té codi de marc per al registre, la configuració, la GUI de configuració i un altre codi de marc.
• Per desenvolupar un SimApi, l'equip de desenvolupadors necessita experiència en desenvolupament de Windows, .NET Framework, C o C++. També es requereix un bon coneixement de la font de dades a la qual s'ha de connectar el SimApi, perquè l'objectiu d'un SimApi és traduir les sol·licituds de dades de SIMCA-online o SIMCA a l'API de la font de dades. Una implementació de SimApi mai és un projecte puntual, però normalment necessita suport continu i manteniment ocasional.

Llegir o escriure dades

• Un SimApi té la tasca principal de proporcionar dades d'una font de dades. Això s'anomena lectura de dades.
• La majoria de les implementacions de SimApi també admeten l'escriptura de dades. Això significa tornar a escriure dades a través del SimApi a la font de dades. L'escriptura de dades és una característica opcional de SIMCA-online.

Tags i Nodes

• A tag és un identificador d'una columna o "variable" en una font de dades. A tagEl nom de s'utilitza per identificar el tag. Els noms dins del node han de ser únics. SIMCA-online 18 és la primera versió que admet un node que conté un subnode i tag amb el mateix nom. Per example: el node Parent pot tenir un subnode anomenat Batch i a tag anomenat Batch.
• Un node és un contenidor de tags. Un node també pot contenir altres nodes, de la mateixa manera que a file El sistema té carpetes en carpetes.
• Com en a file sistema, el node i tag els noms es poden combinar amb un camí complet que identifiqui de manera única a tag. El tag Els camins s'utilitzen a SIMCA-online o SIMCA en seleccionar tags per utilitzar. A tag El camí comença amb un nom d'instància SimApi seguit de l'estructura del node i acaba amb el tag nom, cada element separat amb dos punts (:). Per example “:ODBCSQLServer:Node:SensorTag1”.

El SimApi enumera tags i nodes a l'inici

• Una implementació de SimApi explora el servidor per nodes i tags a la font de dades quan s'inicialitza el SimApi i en fa un seguiment de manera que les diferents funcions de SimApi que s'utilitzen per enumerar tags i el node es pot implementar.
• La inicialització de SimApi no es produeix només a l'inici del servidor, sinó que també pot ser reactivada per un usuari a SIMCA-online amb la funcionalitat Refresh SimApi.

Sensibilitat entre majúscules i minúscules tag- i noms de nodes

• Tag els noms i els noms dels nodes distingeixen entre majúscules i minúscules.
• Així, a tag anomenat "tag1" no és el mateix que "Tag1" a causa del cas diferent de la "T". Recomanem no utilitzar tags o noms de nodes que només difereixen en cas.

Node de procés continu 

• Quan un node conté tags amb dades de procés continu, es pot denominar node de procés. Les dues captures de pantalla següents mostren una representació tabular d'un node de procés amb dades seguida d'una imatge que mostra com es veu el node en seleccionar tags a SIMCA-online.

Els nodes de procés continu han de ser independents dels lots, execucions o temps

• Per funcionar bé en un SimApi, un node ha de ser independent dels lots, execucions o temps. Tenir un node que contingui dades per a un lot o interval de temps específic no funcionaria bé a SIMCA-online perquè la configuració del projecte només podria llegir dades d'aquest lot i no s'utilitzaria per a altres lots.
• En lloc d'això, un node s'hauria de mapar a una o més unitats físiques en el procés on es realitzen les mesures.

ID del lot tag requerit als nodes de procés continu per a l'execució de projectes per lots

• Cada procés continu ha de tenir un tag (variable) mantenint l'identificador de lot per a cada observació. Aquest identificador de lot és utilitzat per SIMCA o SIMCA-online per saber a quin lot pertany cada observació.
• El $BatchID tag a les captures de pantalla de 7.4.3 hi ha un exempleample.
  Tot i que no és obligatori, es recomana tenir un tag al node de procés que mostra la fase o pas actual del procés. Això tag llavors es pot utilitzar en condicions d'execució de fase a SIMCA-online o a SIMCA quan s'importen dades. Valors per a això tag pot ser per examp"fase1", "neteja", "fase2".

Node de context del lot

• Un node de lots és un node que fa un seguiment dels lots; els seus identificadors de lot, les hores d'inici i les hores de finalització. És un requisit per a l'execució de projectes per lots a SIMCA-online. Una font de dades pot tenir més d'un node de lots que exposa lots de diferents maneres. L'usuari selecciona el node de lot que s'aplica a la seva aplicació. Aquest exampel fitxer exposa lots que abasten dues unitats diferents:
• /Fàbrica1: lots amb temps de vida agregats tant a la Unitat1 com a la Unitat2.
• /Fàbrica1/Unitat1: lots amb vida útil només a la Unitat1
• /Fàbrica1/Unitat2: lots amb vida útil només a la Unitat2
• Si no teniu cap node per lots a la vostra font de dades, podeu utilitzar el generador de context per lots a SIMCA-online. Consulteu l'ajuda integrada.
• Dades de lot opcionals
• Un node de lot també pot contenir dades de lot; dades per a les quals només hi ha una observació per a tot el lot. Tingueu en compte que tags amb dades de lot no cal que estiguin en un node que tingui la funcionalitat completa d'un node de lot. N'hi ha prou que SimApi admeti la lectura de dades de lots per a tags. Més informació sobre les dades per lots a 7.6.
• Aquí teniu un exampfitxer d'un node per lots:
• Nota: La captura de pantalla anterior està presa de DBMaker, inclosa amb SIMCA-online. Per veure-ho vosaltres mateixos a DBMaker, feu clic a View Botó de dades a la base de dades de Bakers Yeast per mostrar dues finestres, una de les quals és el node del lot i l'altra les dades del procés.

Tipus de dades: dades numèriques, dades de text i dades que falten

• Per a cadascun tag, un SimApi pot suportar tres tipus de dades: numèriques, de text,t i que falten:
• Les dades numèriques solen ser valors reals dels paràmetres del procés, per exempleampel 6.5123. El SimApi només pot gestionar valors de coma flotant de precisió única de 32 bits. Format de coma flotant de precisió única -Viquipèdia. Tots els altres tipus de dades numèriques d'una font de dades s'han de convertir a flotant. Com a tal, poden tractar tant amb valors grans com petits, però només amb uns 6 o 7 dígits significatius. Més informació a la Guia tècnica.
• Això pot provocar una pèrdua de precisió per a nombres enters grans o per a nombres reals que són grans i tenen decimals. Per a més informació, consulteu la Guia tècnica.
• Les dades de text/cadena s'utilitzen per a identificadors de lots, condicions d'execució de fase o per a variables qualitatives. Els valors del text tag les dades distingeixen entre majúscules i minúscules. Això vol dir que el valor "executant" no és el mateix que
  “CORRANT”. Les variables de data i hora no són compatibles directament amb SimApi, però es poden retornar com a cadena amb el format AA-MM-DD HH:MM (per exempleample “2020-09-07 13:45”).
• Els valors que falten vol dir que no hi ha cap valor a retornar, és a dir, no hi ha dades.
• El tipus que es retorna depèn de la implementació de SimApi. Un SimApi coneix les dades de la font de dades i hauria de retornar el tipus de dades que s'ajusti millor.

Tres modes de recuperació de dades: Contínua, Batc,h i Discreta

• L'especificació SimApi defineix tres modes de recuperació de dades, és a dir,. tres maneres diferents de les quals SimApi pot proporcionar dades tags en una font de dades (o en l'altra direcció: escriure dades a tags en una font de dades).
• Recuperació de dades contínua: es refereix a les dades llegides de forma contínua i seqüencial, observació per observació a mesura que evoluciona el lot o procés. Les dades es llegeixen per a l'hora actual, o per a un interval específic, a un interval regular entre observacions. Per example, totes les dades entre les 09:00:00 i les 10:00:00 sampconduït cada 60 segons, donant lloc a 61 observacions quan els punts finals són inclosos.
• Recuperació de dades per lots: es refereix a una única observació amb dades d'un lot sencer (no associada a un punt de maduresa o de temps específic). Els atributs del lot i les dades de centratge local es llegeixen com a dades del lot a SIMCA-online. Les condicions del lot normalment també es llegeixen com a dades del lot (tret que estiguin configurades per a la recuperació de dades discretes).
• Recuperació de dades discretes: les dades discretes poden consistir en diverses observacions per a molts venciments. Però a diferència de les dades contínues, les dades discretes no es llegeixen seqüencialment, sinó totes les dades alhora per a una fase específica d'un lot. Les dades no s'han d'espaiar amb intervals regulars de la variable de maduresa. Totes les dades es tornen a llegir cada vegada que es demanen les dades, a l'interval configurat.
• Per a qualsevol donat tag Les dades es poden sol·licitar en qualsevol dels tres modes, però normalment un SimApi només admetrà un d'aquests modes per a un individu tag. Així mateix, es deixa barrejar tags dins d'un node, però normalment tots tags dins d'un node específic admeten el mateix mode de recuperació de dades.
• Per a dades contínues (però no per a dades per lots o discretes2), es poden sol·licitar dades actuals o dades històriques, que és el tema de la secció següent.
• No tots els SimApis admeten tots els modes. Vegeu la matriu de funcions anterior i el SimApi web pàgina per a més detalls.

Dades contínues actuals i històriques mitjançant un SimApi

• Les dades contínues es refereixen a les dades del procés que canvien amb el temps.

Dades actuals

• Llegir les dades actuals significa demanar a la font de dades els valors més recents de tags en el moment de preguntar. Tingueu en compte que aquí no s'utilitza l'hora de la font de dades externa.
• Les dades llegides com a dades actuals són les que SIMCA-online mostrarà com a dades en directe. Per aquest motiu, és important que no hi hagi retards innecessaris en la font de dades. Les dades actuals han de ser tan recents com sigui possible per funcionar bé a SIMCA-online.
• La font de dades pot utilitzar el seu coneixement de les dades i quant de temps són vàlids els valors i decideix retornar les dades que falten quan les dades en brut d'un punt de temps siguin massa antigues. Per example: les dades es demanen a les 15:00:00, però el punt de dades més recent a la font de dades és a les 03:00:00. En aquest cas, les dades tenen 12 hores d'antiguitat, de manera que el SimApi pot decidir retornar el valor que falta (sense dades).

Dades històriques

• Llegir dades històriques significa demanar a la font de dades valors d'un o més tags per a un interval de temps específic amb un interval específic entre observacions. Tingueu en compte que aquí és l'hora local de la font de dades que s'utilitza per trobar les dades. Per tant, és important la sincronització horària entre la font de dades i els servidors.
• Les dades històriques consisteixen en una matriu de dades. Correspon a la implementació de SimApi sol·licitar les dades de la font de dades, i sampdeixa-ho a l'interval especificat i construeix la matriu de dades per retornar:
• De vegades, la pròpia font de dades té funcions d'agregació per retornar dades processades, o sampling, que es poden utilitzar per retornar les dades correctes.
• Per a altres fonts de dades, el SimApi ha de sol·licitar totes les dades de l'interval de temps i després samples observacions adequades per construir la matriu.
• Les dades s'han de retornar durant un interval de temps, encara que potser no hi hagi dades en brut a l'interval de temps, però només abans de l'hora d'inici. Per example: les dades existeixen a la font de dades en els punts de temps 10 i 20. El SimApi sol·licita dades per als temps 15 i 17. En aquest cas, els valors per al punt de temps 10 els hauria de retornar el SimApi però el temps més tardampEd com els temps 15 i 17, ja que aquests eren els punts de dades més recents en aquells moments. Els valors per tags en el moment 10 s'anomenen valors límits per a l'interval sol·licitat. Per a una explicació més profunda dels valors de límits, vegeu per exampllegiu la documentació de returnBounds a la part 11 de la UA: Accés històric – 6.4.3 Estructura ReadRawModifiedDetails
  (opcfoundation.org)
• La interpolació no s'ha d'utilitzar mai per calcular valors per a punts de temps futurs, perquè les dades no coincidiran amb les que es llegeixen en temps real com a dades actuals. Per l'examplle de la vinyeta anterior: si les dades de 15 i 17 s'haguessin d'interpolar utilitzant els valors dels elements 10 i 20, utilitzarien efectivament valors del futur, cosa que no està permès.
• La font de dades pot utilitzar el seu coneixement de les dades i quant de temps són vàlids els valors i decideix retornar les dades que falten quan les dades en brut d'un punt de temps siguin massa antigues. Per example: les dades es demanen a les 15:00:00, però el punt de dades més recent a la font de dades és a les 03:00:00. En aquest cas, les dades tenen 12 hores d'antiguitat, de manera que el SimApi pot decidir retornar el valor que falta (sense dades).

Nota: SIMCA-online normalment no sol·licita més de cent observacions en una convocatòria durant l'execució normal del projecte. Quan s'extreu a SIMCA-online, o quan s'executa SIMCA d'escriptori, es poden fer peticions de dades més grans. Aquests poden trigar molt de temps, cosa que és d'esperar.

Les dades actuals i les històriques han de coincidir

• De vegades hi pot haver diferències quan les dades es llegeixen com a dades actuals en temps real o dades històriques. Això causa problemes a SIMCA-online perquè el servidor canvia automàticament entre dades actuals i històriques segons sigui necessari.

Adquisició de dades de baixa latència

• Quan SIMCA-online utilitza una font de dades en temps real, és important que les dades de la font de dades siguin actuals. No hi hauria d'haver retards innecessaris en l'adquisició de dades a la font de dades. Les dades del procés continu per a totes les variables han d'estar disponibles al mateix temps per a cada observació. Les dades que arribin tard per a algunes variables no seran recollides per SIMCA-online.

Les dades es poden llegir en qualsevol moment 

• Quan SIMCA-online demana un valor de a tag per al temps t rebrà el valor de la font de dades a partir del temps t, o l'última observació a la font de dades abans del temps t, o un valor interpolat per al temps t. Per tant, el servidor sempre rebrà un valor cada vegada que ho sol·liciti, encara que potser no existeixi una observació per a aquest punt de temps exacte a la font de dades.
• Timestamps al SimApi sempre són UTC. Els clients SIMCA-online i SIMCA presenten l'hora com a hora local.

Enfilar 

• El SimApi és, per defecte, cridat per un sol fil per l'usuari del SimApi. Això és cert per a totes les versions de SIMCA i SIMCA-online fins a la versió 17.
• SIMCA-online 18 admet una marca de funció per activar l'accés multiprocés mitjançant SimApi. Més informació al tema d'ajuda Accés concurrent a SimApi.
• Això vol dir que SimApis s'ha de preparar per a l'enviament múltiple, si és possible, fent segur el fil d'implementació de SimApi i documentar això i qualsevol consideració per als usuaris del SimApi.

Registre file

• Un SimApi hauria de registrar accions, missatges d'error i avisos al seu registre file per ajudar a solucionar problemes. Utilitzeu els diferents nivells de registre per indicar la importància del registre.
• Es recomana registrar "No implementat" per a les funcions que no s'han implementat en un SimApi.

Gestió d'errors

• Quan un SimApi no pot satisfer una sol·licitud de la font de dades, pot gestionar aquest problema de dues maneres; retornant els valors que falten (sense dades) o indicant un error SimApi:
• Tornar els valors que falten a la persona que truca i la senyalització correcta permet que la persona que truca continuï amb normalitat (però, per descomptat, sense cap dada). Aquesta és una pràctica recomanada per a errors parcials, com ara quan es podrien obtenir dades per a alguns, però no tots, tags en una petició.
• La senyalització d'un error de SimApi permet a la persona que truca (per exemple,ampel servidor SIMCA-online) per veure-ho immediatament i actuar. Aquesta és una pràctica recomanada per a les sol·licituds que fallen completament i que no poden retornar cap dada.
• SIMCA-online gestiona els valors que falten o els codis d'error de manera diferent, tal com es descriu a la Guia tècnica de SIMCA-online.

Requisits de rendiment de SimApi

• Les funcions del SimApi s'utilitzen per obtenir dades.
• Si l'accés a les dades és lent, el SimApi no funcionarà bé, per exempleampel mostra: Si SIMCA-online demana dades cada segon, però triga dos segons a obtenir-se, el servidor SIMCA-online mai no podrà mantenir-se al dia en temps real, sinó que progressivament es quedarà cada cop més enrere.
• A les subseccions mostrarem com SIMCA i SIMCA-online utilitzen les funcions de SimApi d'accés a dades i amb quina freqüència es cridaran les funcions de SimApi. Això pot ajudar a establir els requisits de rendiment per a una implementació de SimApi.

Ús de SIMCA de les funcions de SimApi

• Quan SIMCA d'escriptori o altres productes fora de línia utilitzen un SimApi per obtenir dades, aquestes sol·licituds seran per lots i dades de processament per a un conjunt de variables en un interval de temps determinat.
• Com que aquestes sol·licituds les inicia manualment un usuari, no es produeixen amb molta freqüència i no causen una càrrega important a una font de dades.
• Aquestes funcions de SimApi s'utilitzen per obtenir les dades:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

Ús de SIMCA-online de les funcions de SimApi

• SIMCA-online s'utilitza per al seguiment en temps real d'un procés i, per tant, sol·licita dades a través del SimApi a intervals regulars. L'interval d'execució més curt que es pot utilitzar és d'1 segon. Alguns exampEls fitxers dels intervals d'execució són de 10 s, 1 minut o 10 minuts.
• Un servidor pot tenir molts projectes en execució al mateix temps.
• Per reduir el nombre de trucades a l'API a través del SimApi, el servidor optimitza les sol·licituds de dades agrupant moltes sol·licituds més petites simultàniament en una única sol·licitud més gran per a totes les variables alhora (obteniu més informació al tema d'ajuda "La lectura optimitzada de les fonts de dades millora el rendiment").
• L'algorisme d'execució del servidor funciona així quan sol·licita dades mitjançant les funcions SimApi que s'enumeren a continuació:
• Totes les fases que s'executen al mateix interval s'agrupen en una única trucada SimApi per reduir el nombre de trucades. El servidor llegeix les últimes dades de totes les variables utilitzades per tots els models que comparteixen l'interval, és a dir, aquesta crida donarà lloc a una àmplia fila de dades que després s'utilitza per tots els projectes.
  • simapi2_connectionReadCurrentData
• Per a cada projecte de lots, el servidor també necessita saber quins lots estan actius. Això també ha de passar cada vegada que s'executa un projecte:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes es crida amb menys freqüència.
• A més, SIMCA-online també requereix dades històriques. Aquestes sol·licituds només es produeixen quan cal, com ara posar-se al dia de l'inici d'un lot que va començar abans que SIMCA-online s'iniciés, o quan el servidor s'està quedant enrere i necessita llegir un bloc de dades:
  • simapi2_connectionReadHistoricalDataEx
• Opcionalment, algunes configuracions del projecte utilitzen característiques que utilitzen dades per lots o dades discretes que donen lloc a crides de SimApi a:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Opcionalment, algunes configuracions del projecte fan servir la reescriptura per enviar les dades a la font de dades:
  • simapi2_connectionWriteHistoricalDataEx (i les funcions corresponents per a dades per lots, dades discretes)
• És important que cada trucada a les funcions bàsiques per obtenir dades, readCurrentData, getActiveBatches/getBatchTimes, sigui ràpida i això no sigui complicat computacionalment per a la pròpia font de dades, donada la freqüència amb què SIMCA-online pot cridar aquestes funcions.

Prova i validació de dades de SimApi

• Aquesta secció tracta de provar un SimApi per verificar que les dades que en retornen coincideixen amb les dades de la pròpia font de dades. L'execució de proves com aquesta és important després de crear o canviar la implementació de SimApi, o quan canvia l'API d'una font de dades.
• A la pràctica, la validació de dades es fa mitjançant SIMCA-online i la seva funcionalitat d'extracte per extreure dades de la font de dades mitjançant el SimApi i després comparar-les amb les dades en brut de la font de dades. El SIMCA d'escriptori no es pot utilitzar per provar els aspectes en temps real d'un SimApi.

Preparacions i requisits

• Alguns elements són opcionals, però es poden realitzar si l'abast de les proves inclou:

1. Instal·leu SIMCA-online tal com es descriu a ReadMe and Installation Guide.pdf que ve al zip del producte.
2. Obteniu una llicència per al servidor SIMCA-online i instal·leu-lo. El SimApi no funcionarà sense una llicència. L'article de la base de coneixement per a SIMCA-online mostra com llicència del producte. Per example: SIMCA-online 18 (sartorius.com)
3. Instal·leu i configureu el SimApi que voleu provar. Consulteu els capítols 4 – 5 d'aquest document i la guia d'usuari del SimApi específic.
   • a. Opcional: assegureu-vos que la guia d'usuari estigui actualitzada i correcta.
4. Assegureu-vos que teniu una eina per a la vostra font de dades amb la qual podeu comparar les dades de SimApi.
5. Al client d'escriptori SIMCA-online, inicieu sessió al vostre servidor SIMCA-online i utilitzeu-lo File > Extracte per obtenir dades a través del SimApi.
6. Opcional si el vostre àmbit de prova l'inclou: després d'acabar la prova, desinstal·leu el SimApi i verifiqueu-ne files s'eliminen.

Què provar

• La matriu de característiques del capítol 3 enumera totes les característiques possibles, però una implementació determinada de SimApi pot suportar només un subconjunt. Hauríeu de provar totes les funcions implementades pel SimApi donat.
• Les proves següents són comunes a la majoria de les implementacions de SimApi:
• Autenticació amb noms d'usuari i contrasenyes
• Proveu els diferents paràmetres a la configuració del SimApi
• Jerarquia de nodes: Els nodes i tags exposats pel SimApi són correctes.
  • Hi ha d'haver un tag exposat per a totes les "variables" que haurien d'estar disponibles a través del SimApi. Examples: mesures de procés, valors calculats, constants.
• Resiliència de la connexió: si la font de dades no està disponible, això provoca avisos o errors al registre file, però que la connexió a la font de dades es restableix automàticament quan la font de dades estigui disponible.
• Instàncies múltiples: que dues instàncies es poden configurar i utilitzar de manera independent i simultània, amb registres separats files.
• Dades actuals: extreu les dades actuals per a tags. Assegureu-vos que les dades siguin els últims valors coneguts de la font de dades o que faltin per mala qualitat o quan les dades siguin massa antigues.
  • Extreu les dades cada 10 segons (aproximadament) durant un minut.
• Dades històriques contínues: extreu dades històriques per a tags.
  • Utilitzeu l'interval de temps que coincideixi quan heu extret les dades actuals. Verifiqueu que les dades actuals coincideixen amb les dades històriques i les dades en brut de la font de dades.
  • Proveu diferents intervals de temps i sampling intervals, verifiqueu que les dades coincideixen amb la font de dades.
  • Intenteu extreure dades cada 1 s, que és el s més curt possibleampinterval de ling.
  • Proveu diversos tipus de tags a la font de dades (variables de procés, etc.), assegurant-se que les dades coincideixen.
  • Nota: SIMCA-online pot dividir una sol·licitud de dades històriques grans en diversos fragments més petits. Això serà visible al registre de SimApi.
• Comproveu que SimApi funcioni amb dades de text, dades numèriques i dades que falten.
• Registre de SimApi file. Verifiqueu que el registre conté entrades raonables.
• Node de lots: feu clic amb el botó dret a un node i feu Cerca lots.
  • Verifiqueu els noms dels lots, les hores d'inici i les hores de finalització dels lots.
  • Proveu un lot actiu que s'està executant a la font de dades. No hauria de tenir una hora de finalització a través del SimApi.
• Identificador de lot del node de procés tag. Si el SimApi té una funcionalitat de node de lot (vegeu la vinyeta anterior), també ha de tenir un identificador de lot tag al node de dades del procés de concordança. Dades per això tag hauria de ser l'identificador del lot (nom del lot). Aquestes dades són necessàries perquè els projectes per lots identifiquin a quin lot pertany una fila de dades.

Depenent de si el SimApi ho admet, és possible que també vulgueu provar:

• Dades per lots utilitzant File > Extracte.
• Utilitzant dades discretes File > Extracte. Nota: per provar dades discretes amb File > Extraieu el node, el node del lot i el node de dades discretes han d'estar al mateix SimApi (quan SIMCA-online executa projectes, poden ser de diferents SimApis).
• Escriu de nou: envia el lot de dades a la font de dades. Per provar-ho, heu de configurar una configuració de projecte a SIMCA-online per escriure de nou vectors de dades a la font de dades. A continuació, executeu el projecte a SIMCA-online i comproveu les dades que es tornen a escriure a la font de dades.
• Les dades contínues es configuren a la pàgina Evolution Write Back a la configuració del projecte.
• Les dades discretes es configuren a la mateixa pàgina, però només per a una fase configurada per a la recuperació de dades discretes.
• Dades del lot del Batch Write back

MÉS INFORMACIÓ

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Suècia
• Telèfon: +46 90-18 48 00
• www.sartorius.com
• La informació i les xifres contingudes en aquestes instruccions corresponen a la data de versió especificada a continuació.
• Sartorius es reserva el dret de fer canvis a la tecnologia, característiques, especificacions i disseny de l'equip sense previ avís. Les formes masculines o femenines s'utilitzen per facilitar la llegibilitat en aquestes instruccions i sempre denoten simultàniament tots els gèneres.
  Avís de drets d'autor:
• Aquestes instruccions, inclosos tots els components, estan protegides per drets d'autor.
• No es permet cap ús més enllà dels límits de la llei de drets d'autor sense la nostra aprovació.
• Això s'aplica especialment a la reimpressió, la traducció i l'edició, independentment del tipus de suport utilitzat.

Preguntes freqüents

• P: Quin és l'objectiu de SimApis?
  • R: L'objectiu principal de SimApis és proporcionar dades als productes Umetrics Suite per a la creació de projectes i la creació de models.
• P: Com puc solucionar problemes amb una instal·lació de SimApi?
  • R: Podeu resoldre els problemes provant des de SIMCA-online, comprovant el registre de SimApi file, i garantir la configuració correcta del compte de servei.

Documents/Recursos

Programari SARTORIUS Sim Api [pdfGuia de l'usuari Programari Sim Api, Programari Api, Programari

Referències

• Manual d'usuari