Guía del usuario del software SARTORIUS Sim Api

Software de API de simulación SARTORIUS

Presupuesto

• Nombre del producto: Guía SimApi
• Fecha de lanzamiento: 5 de septiembre de 2024
• Finalidad: Proporcionar datos a los productos de Umetrics Suite

Instrucciones de uso del producto

Introducción a SimApis

• SimApis se utilizan para recuperar datos para la creación de proyectos y la construcción de modelos en los productos de Umetrics Suite.

Obtención de SimApis

• Para obtener SimApis, consulte la documentación oficial o comuníquese con el servicio de atención al cliente para obtener ayuda.

Características de SimApi

• SimApis proporciona datos en tiempo real para monitoreo, control y construcción de modelos en SIMCA y SIMCA-online.

Solo uso de datos actual

• Se recomienda utilizar únicamente datos actuales y evitar datos históricos para un rendimiento óptimo.

Preparación para una instalación de SimApi

• Antes de la instalación, asegúrese de que su sistema cumpla con los requisitos mínimos especificados en la guía del usuario.

Instalación de SimApi

• Siga las instrucciones paso a paso proporcionadas en el manual del usuario para instalar SimApi en su sistema.

Configuración de SimApi para SIMCA

• Configure los ajustes de SimApi en SIMCA de acuerdo con las pautas proporcionadas.

Configuración de SimApi para SIMCA-online

• Configure SimApi para operaciones de recuperación y escritura de datos en tiempo real en SIMCA-online.

Pruebas y resolución de problemas

• Tras la instalación, realice pruebas para garantizar su correcto funcionamiento. Si surge algún problema, consulte la sección de solución de problemas de la guía del usuario.

Pruebas desde SIMCA-online

• Pruebe la integración de SimApi desde SIMCA-online para verificar la recuperación de datos.

Solución de problemas con el registro Files

• Utilice el registro de SimApi file para identificar y resolver cualquier problema de instalación u operación.

Configuración de la cuenta de servicio

• Asegúrese de la correcta configuración de la cuenta de servicio SIMCA-online para un funcionamiento sin problemas.

Detalles técnicos

• Consulte la sección 7 de la guía del usuario para obtener información técnica detallada sobre SimApis.

Introducción a SimApis

• Una SimApi es una interfaz de software entre el software Umetrics® Suite y una fuente de datos. Su propósito principal es proporcionar datos a SIMCA®-online o SIMCA®.
• Sartorius Stedim Data Analytics AB desarrolla SimApis para muchas fuentes de datos diferentes, como historiadores de procesos y bases de datos de uso general.
• Este documento explica qué es una SimApi y cómo se utiliza en los productos de Umetrics Suite. Aprenderá a planificar e instalar una SimApi, a solucionar problemas y a probar su instalación. El último capítulo contiene detalles técnicos de las SimApis, dirigido a desarrolladores.

Propósito de SimApi: proporcionar datos a los productos de Umetrics Suite

• El propósito principal de una SimApi es proporcionar datos a SIMCA-online o SIMCA desde una fuente de datos. Esta fuente no forma parte de SIMCA-online, pero puede ser un historial de procesos u otro sistema que conserva y gestiona los datos.
• Una SimApi expone una jerarquía de nodos, correspondientes a carpetas en una file sistema. Cada nodo puede contener otros nodos, o tags. A tag corresponde a una variable. Para estos tags, se pueden obtener datos. La imagen muestra una tag, Temp, seleccionado en el nodo
• BakersYeastControlGood en una fuente de datos de SIMCA-online. También muestra los últimos valores obtenidos de la fuente de datos.

Uso de SimApi en Umetrics Suite

• El software de escritorio SIMCA puede utilizar un SimApi para recuperar datos para la creación de proyectos y la construcción de modelos como lo ilustra la siguiente imagen.
• SIMCA-online utiliza SimApis para obtener datos en tiempo real para su supervisión y control, así como para reescribirlos en la fuente de datos. La siguiente imagen muestra dónde se encuentra SimApi en un sistema que consta de una fuente de datos, un servidor SIMCA-online y clientes.

SimApis de uso común

• Las SimApis más utilizadas son:
• PI AF SimApi para conectarse a sistemas PI de Aveva (anteriormente OSIsoft).
• La OPC UA SimApi
• ODBC SimApi: para acceso general a bases de datos como SQL Server u Oracle
• Todas las SimApis disponibles se enumeran junto con sus características en el párrafo 3.

DBMaker SimApi para datos de simulación

• DBMaker es una aplicación que se incluye con la instalación del servidor de SIMCA-online. Simula una fuente de datos, como un historial de procesos, mediante una tabla de datos precargada donde las observaciones se envían una a una a SIMCA-online a través de DBMaker SimAPI.
• DBMaker solo se utiliza con fines de demostración y no puede utilizarse en producción con datos en tiempo real de una fuente de datos. Consulte la ayuda integrada para obtener más información sobre DBMaker.

Documentación adicional

• Este documento forma parte de un conjunto de documentos relacionados, cada uno con un enfoque y un público objetivo diferentes:

Fuente	Qué	Dónde
SIMCA en línea web página	Información introductoria y descargas	sartorius.com/umetrics-simca- en línea

SIMCA-online ReadMe e Instalación.pdf	Instalación y cómo empezar a utilizar SIMCA: datos de demostración en línea	En el zip de instalación file
Guía de implementación de SIMCA-online	Describe la funcionalidad de SIMCA-online, la pone en contexto con otro software de Umetrics Suite, describe los requisitos y las mejores prácticas para una implementación exitosa y brinda instrucciones de instalación paso a paso.	sartorius.com/umetrics-simca- en línea
Guía de SimApi	Preparación y ejecución de instalaciones de SimApi, incluida la resolución de problemas. También contiene detalles técnicos sobre SimApis para desarrolladores.	sartorius.com/umetrics-simapi
Guías de usuario de SimApi	Documentación de cada SimApi publicado con características, instrucciones de instalación y detalles de configuración.	sartorius.com/umetrics-simapi
Guía técnica de SIMCA-online	Referencia técnica para la planificación de la instalación del servidor SIMCA-online, resolución de problemas y explicación detallada del funcionamiento de SIMCA-online.	sartorius.com/umetrics-simca-en línea
Ayuda en línea de SIMCA	Web-Ayuda basada en el uso sobre cómo utilizar SIMCA-online y cómo funciona SIMCA-online.	En el propio software y en sartorius.com/umetrics-simca
SIMCA en línea Web Guía de instalación del cliente	Describe la instalación del SIMCA-online Web Cliente.	sartorius.com/umetrics-simca-en línea
Base de conocimientos de Umetrics	Base de datos de búsqueda con artículos sobre cada versión de software lanzada, artículos técnicos y problemas conocidos en los productos de Umetrics Suite.	sartorius.com/umetrics-kb
Guía de usuario/ayuda de SIMCA	Cómo utilizar SIMCA de escritorio para crear proyectos y modelar datos.	En SIMCA y en sartorius.com/umetrics-simca
Apoyo web página	Cómo obtener soporte técnico.	sartorius.com/umetrics-support

Apoyo técnico

• El equipo de soporte en línea de Sartorius responde preguntas técnicas sobre SimApis y también puede remitir solicitudes de mejora de SimApis a las personas adecuadas. Más información en sartorius.com/umetrics-support.

Obtención de SimApis

• Proporcionamos documentación para SimApis disponibles y enlaces a programas de instalación en sartorius.com/umetrics-simapi.
• Cada SimApi está documentado en su Guía del usuario.
• La Guía de SimApi, que está leyendo ahora, complementa esa información con información complementaria de SimApi cuando se trata de planificación, instalación y resolución de problemas de SimApi.

Características de SimApi

• No todas las fuentes de datos son iguales. No es necesario que una SimApi implemente todas las funciones de la especificación. Por estos motivos, las distintas SimApis ofrecen distintas funcionalidades. La siguiente matriz enumera las SimApis disponibles y sus características.
• Las funciones se explican a continuación. Observe que la tabla tiene columnas separadas para mostrar qué funciones están disponibles en SIMCA-online y SIMCA respectivamente.

Característica	Objetivo	Uso de SIMCA-online	Uso de SIMCA
Datos actuales	Leer una sola observación con el valor más reciente de la fuente de datos.	Ejecución normal en tiempo real	–
Datos históricos	Lea muchas observaciones a la vez con datos históricos de la fuente de datos.	Ponte al día y predice datos pasados, crea proyectos usando File > Nuevo	Asistente de importación de bases de datos para importar datos de proceso para la creación de modelos.
Datos discretos	Lea datos de laboratorio/IPC de la fuente de datos. Muchas observaciones por lote.	Para proyectos por lotes con fases o condiciones de lote configuradas para la recuperación de datos discretos.	–
Datos del lote	Leer las condiciones del lote y los atributos de calidad final (o	Condiciones de lote o centrado local.	Asistente de importación de bases de datos para leer las condiciones del lote

Característica	Objetivo	Uso de SIMCA-online	Uso de SIMCA
	otros datos de tipo MES). Una observación por lote.		Creación de modelos a nivel de lote.
Nodo de lote	Especifique la hora de inicio y la hora de finalización (vacía para un lote activo) para un lote específico. Enumerar todos los lotes que existieron en un rango de tiempo.	Necesario para la ejecución de configuraciones por lotes.	Asistente de importación de bases de datos para seleccionar lotes para importar.
Escribir de nuevo: datos continuos	Escribir datos continuos, como predicciones, en la fuente de datos.	Volver a escribir datos desde el nivel de evolución del lote, para Control Advisor o para configuraciones continuas	–
Escribir de nuevo – discreto	Escribir datos discretos, como predicciones, en la fuente de datos.	Escritura diferida para configuraciones de lotes en el nivel de evolución de lotes para fases configuradas para recuperación de datos discretos	–
Escribir de nuevo: datos del lote	Vuelva a escribir datos de nivel de lote, como predicciones o atributos de calidad final, en la fuente de datos.	Escribir de nuevo para la configuración del lote a nivel de lote	–
Jerarquía de nodos	SimApi admite una jerarquía de nodos, de manera similar a un file sistema. Cada nodo puede contener tags y otros nodos. La jerarquía facilita la gestión de una gran cantidad de nodos y tags.	Apoyado en todos los lugares donde tags se utilizan
Formación tag expansión	Una matriz tag almacena múltiples valores. SimApi expande la matriz tag a muchos individuos tags, uno para cada elemento de la matriz.	Apoyado donde tags Se utilizan para datos continuos. Cada uno expandido tag debe asignarse a una variable en el proyecto SIMCA.
Varias fuentes de datos	SimApi puede conectarse a más de una única fuente de datos o admite múltiples instancias de sí mismo con configuraciones y registros individuales. files para cada instancia.	Conectarse a varias fuentes de datos diferentes del mismo tipo.	–
Resiliencia de la conexión	Si SimApi se desconecta de la fuente de datos, intentará restablecer la conexión automáticamente.	No es necesario reiniciar SimApi para restablecer las conexiones con la fuente de datos.	–
Desarrollado internamente	SimApi es desarrollado, proporcionado y respaldado por

No se recomienda utilizar solo datos actuales, sin datos históricos.

• Algunas SimApis, especialmente OPC DA, solo admiten la lectura de datos actuales y no de datos históricos.
• Un SimApi que solo admita datos actuales no se puede utilizar en SIMCA de escritorio, porque no podrá leer datos históricos sobre los cuales construir los modelos.
• Para SIMCA-online, recomendamos encarecidamente una fuente de datos y SimApi que proporcionen no solo datos actuales para la ejecución en tiempo real, sino también datos históricos para poder predecir y actualizar los datos pasados. SIMCA-online cambia automáticamente entre datos en tiempo real y datos históricos según sea necesario y esta función no se puede desactivar.
• Una fuente de datos que sólo proporciona datos actuales, pero no datos históricos, puede funcionar para proyectos continuos en SIMCA-online, pero para proyectos por lotes, se requieren datos históricos.

Preparación para la instalación de SimApi

• Esta sección describe información importante para una instalación exitosa de SimApi.

SimApis de 64 bits o 32 bits

• Hay versiones de 32 bits y 64 bits de cada SimApi.
• SIMCA-online y SIMCA son de 64 bits y requieren las versiones de SimApis de 64 bits. Las versiones anteriores de SimApis de 32 bits siguen disponibles para instalaciones anteriores.

Ubicación del registro file y configuración

• Una SimApi almacena su registro files en la carpeta de datos de programa oculta1:
  %programdata%\Umetrics\SimApi, donde %programdata% corresponde a la carpeta de su ordenador. Su valor predeterminado es C:\ProgramData.
• Cada SimApi normalmente utiliza su propio registro file, que de manera similar al registro del servidor SIMCA-online file contendrá más o menos datos dependiendo de la configuración del nivel de registro. file es útil para la resolución de problemas. El registro file se llama
  .log donde es el SimApi que estás instalando, por ejemploampPIAFSimApi. Consulte también la siguiente sección para conocer los nombres de instancias de SimApi de SIMCA-online.
• Esta carpeta también contiene la configuración de SimApi en un XML file nombrado .xml.
• La mayoría de SimApis tienen interfaces gráficas de usuario que cambian la configuración en el xml file, pero para algunos se introducen los cambios directamente en el XML file con un editor de texto, como el Bloc de notas. Consulta la guía del usuario de cada SimApi.

File nombres cuando se utilizan instancias nombradas con SIMCA-online

• En SIMCA-online, cada instancia de SimApi obtiene su propia configuración file y registro file para trabajar con múltiples instancias de cada SimApi. Los nombres de estas fileLos s tienen como sufijo el nombre de la instancia tal como aparece en la pestaña SimApi en el cuadro de diálogo Opciones del servidor SIMCA-online.
• El siguiente ejemploample muestra el nombre de estos files, donde debe reemplazarse con el nombre de SimApi.
• Nombre de configuración proporcionado cuando se agrega la instancia: OmegaServer
• Configuración file nombre: OmegaServer.xml
• Registro file nombre: Registro OmegaServer
• Tenga en cuenta que el genérico file .registro file Todavía se crea este registro. file contiene entradas que por razones técnicas no se pueden dirigir al registro file de las instancias..
• Esta carpeta está oculta en Windows de forma predeterminada. Para verla en File Explorer lo configuras para mostrar oculto files. Tenga en cuenta que puede navegar a una carpeta oculta escribiendo una dirección en File Barra de direcciones del explorador.
• Tenga en cuenta que SIMCA no admite varias instancias de SimApi y, por lo tanto, utiliza los nombres sin nombre de instancia como se describe anteriormente.

Planificación de redes

• Debes ubicar el servidor de SIMCA-online cerca de la fuente de datos en la red. Esto garantiza una conexión rápida entre SIMCA-online y su fuente de datos.
• Los equipos de red pueden interferir con la conexión entre SIMCA-online y la fuente de datos.

Cuentas de usuario y permisos de fuentes de datos

• Las fuentes de datos suelen controlar el acceso a sus datos. Esto suele hacerse con nombres de usuario y contraseñas, pero también se pueden utilizar restricciones basadas en direcciones IP o DNS (por ejemplo,ampLos PI Trusts en el sistema PI de Aveva).
• El nombre de usuario y la contraseña se pueden proporcionar a la fuente de datos de diferentes maneras:
• Una SimApi se ejecuta como el usuario de Windows del usuario que ejecuta SIMCA de escritorio o la cuenta de servicio SIMCA-online en el servidor. SimApi puede conectarse a la fuente de datos usando esta cuenta. Así funcionan OPC I y PI SimApi, así como ODBC si no se proporcionan credenciales al configurarlo.
• Para ODBC genérico, puede utilizar la aplicación Administrador de orígenes de datos ODBC que se encuentra en Inicio en Windows.
• Algunos proveedores de bases de datos proporcionan sus propios controladores y herramientas para sus bases de datos. Las bases de datos Oracle, por ejemplo.ampes decir, utilice Oracle Data Access Components (ODAC).
• Algunas SimApis, como PI AF y ODBC, tienen cuadros de diálogo de configuración que almacenan las credenciales cifradas en la configuración XML de SimApi. file.
• PI también cuenta con varias opciones de seguridad disponibles en las herramientas de administración de PI System en el servidor PI. Para más información, consulte la Guía del usuario de PI AF SimApi. Esta guía es útil incluso si utiliza la versión anterior de OSIsoft PI SimApi.
• OPC DA y HDA utilizan DCOM como transporte entre una fuente de datos y SimApi. DCOM se configura con la herramienta Servicios de componentes (DCOMCNFG.EXE) en Windows y utiliza la autenticación de Windows.
• Para el antiguo OSIsoft PI SimApi (no el más nuevo AF SimApi), se utiliza la aplicación OSIsoft AboutPI-SDK (PISDKUtility.exe) para configurar la conexión al servidor PI.

Verificación de la conectividad de la fuente de datos
Cuando desee instalar un SimApi en una computadora, puede ser útil verificar la conectividad de esa computadora a la fuente de datos con otra herramienta:

• Las fuentes de datos ODBC en Windows se utilizan para configurar y probar ODBC genérico. Tenga en cuenta que existen dos versiones de esta herramienta en Windows de 64 bits: una para aplicaciones de 32 bits y otra para 64 bits. Utilice el botón "Probar fuente de datos" al final del asistente de configuración de ODBC para verificar la conectividad con la base de datos. Le recomendamos configurar sus fuentes de datos como DSN del sistema.
• Una herramienta de conexión específica de la base de datos del proveedor de la base de datos, como Oracle Data Access Components.
• PI System Explorer permite probar la conectividad con el servidor de PI AF. Forma parte del cliente de PI AF, requisito previo para PI AF SimApi.
• OPC UA Expert de Unified Automation – UaExpert es un cliente de prueba multiplataforma para servidores OPC UA.
• La aplicación PI-SDK (PISDKUtility.exe) se puede utilizar para probar la conectividad y view Cualquier mensaje de error que se haya registrado al intentar SIMCA-online conectarse al servidor PI. Esto solo se utiliza para la versión anterior de OSIsoft SimApi, no para PIAF.
• Las herramientas de administración de PI System se utilizan en el servidor PI para la resolución de problemas desde ese lado. Por ejemplo:ampes, para buscar problemas de seguridad que impidan el acceso desde el servidor SIMCA-online. Obtenga más información sobre la resolución de problemas del sistema PI en este video de YouTube.
• Excel se puede utilizar para obtener datos de una conexión ODBC y de la mayoría de los otros sistemas cuando se instala un complemento adecuado.
• Matrikon OPC Explorer para Ior HDA (herramientas independientes) permite probar la conectividad OPC, y Matrikon OPC Analyzer permite diagnosticar problemas de conectividad OPC. Descargue estas herramientas gratuitas desde https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (para DInd HDA) del Instituto de Capacitación OPC web El sitio permite a los usuarios diagnosticar fácilmente problemas de comunicación y seguridad, y solucionarlos al instante con solo pulsar un botón. Todo esto se puede hacer sin necesidad de aprender a configurar DCOM.

Instalación de SimApi

A continuación se explica cómo instalar SimApi en una PC:

1. Lea la Guía del usuario de la SimApi que está instalando. Contiene información específica sobre esa SimApi que complementa las instrucciones generales que está leyendo.
2. Instale y configure todos los requisitos previos mencionados en la Guía del usuario de SimApi (por ejemplo,ampcontroladores de base de datos o SDK)
3. Ejecute el programa de instalación para instalar SimApi. Instale la versión de 64 bits (x64) o de 32 bits (x86) que coincida con el software en el que lo ejecutará.
4. Configure SimApi en SIMCA-online o SIMCA como se describe en las siguientes secciones y consulte la guía del usuario de SimApi para obtener descripciones de las configuraciones disponibles.
5. Inicie el servidor SIMCA-online. Tenga en cuenta que esto puede tardar un tiempo, ya que al inicializar SimApi, enumerará todos los... tags en la fuente de datos.
6. Pruebe SimAPI obteniendo algunos datos. Para SIMCA-online, puede usar File > Extraer como se describe en 6.1.
7. Si SimApi no funciona como se esperaba, consulte el registro de SimApi files para solucionar problemas y a la guía del usuario de SimApi.

Configuración de SimApi para su uso en SIMCA

A continuación se explica cómo utilizar SimApi en SIMCA:

1.  Inicie la importación de la base de datos de una de las siguientes maneras:
   • a. Para crear un nuevo proyecto en SIMCA: File > Nuevo proyecto regular o nuevo proyecto por lotes. Seleccione "Desde la base de datos" en la pestaña Inicio.
   • b. Para importar un conjunto de datos en un proyecto existente en SIMCA: Desde el conjunto de datos en la pestaña Datos de un proyecto SIMCA abierto.
2. Haga clic en Agregar nueva fuente de datos
3. Seleccione SimApi como tipo de conexión, haga clic en el botón … y localice el .dll en la carpeta de instalación y haga clic en Abrir.
4. Haga clic en Configurar y consulte la Guía del usuario individual de SimApi para saber cómo realizar la configuración.
5. Haga clic en Probar conexión de origen de datos para verificar que puede conectarse a la base de datos. Esto puede tardar bastante si hay muchos... tags en la fuente de datos.
6. Haga clic en Aceptar para completar la configuración.
7. Consulte la ayuda de SIMCA para saber cómo trabajar con datos importados.

Configuración de SimApi para su uso en SIMCA-online

• Importante: Para poder utilizar SimApi, se requiere una licencia de servidor de SIMCA-online. La instalación demo de SIMCA-online no permite utilizar SimApis.
• Para agregar una SimApi al sistema, ejecute las Opciones del servidor de SIMCA-online en la PC del servidor. Conozca los pasos detallados en el tema de ayuda de SICMA-online Agregar y configurar una SimApi en el servidor.
• Consejo: si realiza cambios en una SimApi, puede reiniciar esa SimApi por separado desde Opciones del servidor sin tener que reiniciar todo el servidor.
• Para configurar varias instancias de esta SimApi, repita los pasos anteriores y utilice nombres únicos para cada instancia. Obtenga más información sobre los diferentes registros y configuraciones files para las instancias en 4.2.

Prueba y resolución de problemas de una SimApi

• Este capítulo trata sobre cómo probar y solucionar problemas en una instalación de SimApi.

Probar una SimApi desde SIMCA-online

• Una vez que el servidor SIMCA-online se haya iniciado correctamente, puede probar su SimApi en SIMCA-online (si el servidor no se inicia, consulte 6.2):
• Inicie sesión en el servidor en el cliente SIMCA-online y navegue hasta Extraer en el File La pestaña Extract te ayuda a probar SimApi obteniendo datos a través de ella:
• Los nodos (“carpetas”) de SimApi se muestran en el cuadro de la izquierda. Tags para el nodo seleccionado se muestran en la parte superior derecha.
• Los datos actuales se pueden probar rápidamente con solo hacer clic view> en tags que proporcionan datos de proceso continuo (ver captura de pantalla)
• Haga clic derecho en un nodo para buscar lotes dentro de un rango de tiempo. El nodo debe ser un nodo de lotes que tenga conocimiento de lotes.
• Seleccionar tags en Extraer y haga clic en Siguiente y finalice el asistente para obtener datos utilizando los diferentes modos de recuperación de datos: datos actuales, históricos, por lotes y discretos.
• Compara los datos extraídos con lo que ves en tu fuente de datos usando sus herramientas. Obtén más información sobre cómo probar y validar todas las funciones de SimApi en 7.13.

Solucione problemas de SimApi utilizando el registro de SimApi file

• Si el servidor no se inicia, SimApi no funciona como se espera o la extracción falla, debe consultar el registro de SimApi file que le indica cuál es el problema. Habilite el registro a nivel de depuración en el registro de SimApi para obtener todos los detalles. Consulte 4.2.
• Nota: los registros del servidor SIMCA-online no son tan útiles en este caso. Mostrarán cómo el servidor cargó e inicializó SimApi, pero los detalles específicos de SimApi se encuentran en su registro. file.

Utilice la cuenta de servicio SIMCA-online correcta

• Al probar el acceso a la fuente de datos, recuerde que ha iniciado sesión como un usuario específico en el equipo servidor (normalmente, su propia cuenta de usuario en un dominio de Windows), pero que la cuenta de servicio del servidor SIMCA-online es una cuenta diferente, por defecto LocalSystem, que tiene diferentes derechos de acceso en comparación con su cuenta de usuario.
• Por este motivo, no es raro que las pruebas funcionen cuando se ejecutan con su cuenta, pero que SIMCA-online no pueda conectarse a la fuente de datos.
• Para solucionar este problema, se debe conceder acceso a la cuenta utilizada por el servicio de servidor SIMCA-online. Normalmente, se cambia LocalSystem a una cuenta de servicio de dominio específica y se conceden permisos a esta cuenta. Tenga en cuenta que esto no aplica si SimApi utiliza credenciales configuradas en la configuración de SimApi, ya que estas tienen prioridad.

Detalles técnicos de SimApis

• Este capítulo proporciona detalles técnicos sobre el funcionamiento de una SimAPI. Está dirigido principalmente a desarrolladores que desean comprender las SimAPI para implementarlas en una fuente de datos.
• Los desarrolladores también deben leer las partes anteriores de este documento para obtener una introducción a SimApis y las descripciones de alto nivel de las características.

¿Cuándo considerar desarrollar una SimApi y cuándo no?

Antes de considerar desarrollar una SimApi para una fuente de datos:

1. Investiga si ya existe una SimAPI que puedas usar. Quizás puedas habilitar alguna función en tu fuente de datos para usar una de las SimAPI existentes, como OPC UA.
2. Lea atentamente este documento y sus referencias e investigue si su fuente de datos cumple con los requisitos: por ejemplo:ampEs decir, debe ser lo suficientemente rápido y proporcionar no sólo datos actuales, sino también datos históricos.

• Por estas razones, no recomendamos desarrollar una SimApi que se conecte a hardware o instrumentos de bajo nivel. Es mejor conectar estos instrumentos a un historiador de procesos como Aveva PI System, y permitir que este obtenga datos del instrumento y los historice. Posteriormente, la SimApi de PIAF puede utilizarse para obtener datos de PI para el producto Umetrics.

Desarrollo de SimApi y la especificación de SimApi

• La especificación SimApi, SimApi-v2, contiene documentación para todas las funciones C en SimApi que una DLL de SimApi necesita implementar, así como también alguna orientación sobre cómo desarrollar un SimApi.
• La implementación de un SimApi usando C o C++ se realiza en la mayoría de los casos a un nivel innecesariamente bajo.
• La forma recomendada y más sencilla de implementar un SimApi es basarlo en el ExampCódigo fuente de leSimApi que proporcionamos. Es un exampLa implementación de SimApi gestiona la interfaz C y la traduce a .NET Framework, donde se realiza la implementación. También incluye código de framework para registro, configuración, interfaz gráfica de usuario (GUI) de configuración y otros recursos.
• Para desarrollar una SimApi, el equipo de desarrolladores necesita experiencia en desarrollo para Windows, .NET Framework, C o C++. También se requiere un buen conocimiento de la fuente de datos a la que se conectará la SimApi, ya que su propósito es traducir las solicitudes de datos de SIMCA-online o SIMCA a la API de la fuente de datos. La implementación de una SimApi nunca es un proyecto único, sino que suele requerir soporte continuo y mantenimiento ocasional.

Lectura o escritura de datos

• Una SimApi tiene como función principal proporcionar datos desde una fuente de datos. Esto se conoce como lectura de datos.
• La mayoría de las implementaciones de SimApi también admiten la escritura de datos. Esto significa que se pueden reescribir los datos a través de SimApi en la fuente de datos. La escritura de datos es una función opcional en SIMCA-online.

Tags y nodos

• A tag es un identificador de una columna o “variable” en una fuente de datos. tagEl nombre se utiliza para identificar el tagLos nombres dentro del nodo deben ser únicos. SIMCA-online 18 es la primera versión que admite un nodo que contiene un subnodo y tag con el mismo nombre. Por ejemploample: el nodo Padre podría tener un nodo secundario llamado Lote y un tag llamado Lote.
• Un nodo es un contenedor de tagsUn nodo también puede contener otros nodos, de manera similar a cómo un file El sistema tiene carpetas dentro de carpetas.
• Como en una file sistema, el nodo y tag Los nombres se pueden combinar para formar una ruta completa que identifique de forma única un tag. El tag Las rutas se utilizan en SIMCA-online o SIMCA al seleccionar tags Para usar. tag La ruta comienza con un nombre de instancia de SimApi seguido de la estructura del nodo y finaliza con tag nombre, cada elemento separado por dos puntos (:). Por ejemploampel “:ODBCSQLServer:Nodo:SensorTag1”.

SimApi enumera tags y nodos al inicio

• Una implementación de SimApi explora el servidor en busca de nodos y tags en la fuente de datos cuando se inicializa SimApi y realiza un seguimiento de ellos para que las diversas funciones de SimApi que se utilizan para enumerar tags y se puede implementar el nodo.
• La inicialización de SimApi no solo ocurre al iniciar el servidor, sino que también puede ser reactivada por un usuario en SIMCA-online con la funcionalidad Actualizar SimApi.

Sensibilidad a mayúsculas y minúsculas tag- y nombres de nodos

• Tag Los nombres y los nombres de los nodos distinguen entre mayúsculas y minúsculas.
• Por lo tanto, una tag llamado "tag1” no es lo mismo que “Tag1” debido a que la “T” tiene un caso diferente. Recomendamos no utilizar tags o nombres de nodos que difieren solo en mayúsculas y minúsculas.

Nodo de proceso continuo 

• Cuando un nodo contiene tags Con datos de proceso continuos, se puede denominar nodo de proceso. Las siguientes dos capturas de pantalla muestran una representación tabular de un nodo de proceso con datos seguida de una imagen que muestra cómo se ve el nodo al seleccionarlo. tags en SIMCA-online.

Los nodos de proceso continuo deben ser independientes de lotes, ejecuciones o tiempo.

• Para funcionar correctamente en una SimApi, un nodo debe ser independiente de lotes, ejecuciones o tiempo. Tener un nodo que contenga datos de un lote o rango de tiempo específico no funcionaría bien en SIMCA-online, ya que la configuración del proyecto solo podría leer los datos de ese lote y no usarlos para otros.
• En lugar de ello, un nodo debería asignarse a una o más unidades físicas en el proceso donde se realizan las mediciones.

ID del lote tag requerido en nodos de proceso continuo para la ejecución de proyectos por lotes

• Cada proceso continuo debe tener una tag (Variable) que contiene el identificador de lote de cada observación. Este identificador de lote es utilizado por SIMCA o SIMCA-online para identificar a qué lote pertenece cada observación.
• El $BatchID tag En las capturas de pantalla de 7.4.3 se muestra un ejemplo.ampel.
  Si bien no es obligatorio, se recomienda tener un tag en el nodo de proceso que muestra la fase o paso actual del proceso. Este tag Luego se pueden utilizar en condiciones de ejecución de fase en SIMCA-online o en SIMCA al importar datos. Valores para esto tag puede ser por ejemploampla “fase1”, “limpieza”, “fase2”.

Nodo de contexto de lote

• Un nodo de lote es un nodo que realiza un seguimiento de los lotes; sus identificadores de lote, horas de inicio y horas de finalización. Es un requisito para la ejecución de proyectos por lotes en SIMCA-online. Una fuente de datos puede tener más de un nodo de lote que expone los lotes de diferentes maneras. El usuario selecciona el nodo de lote que se aplica a su aplicación. Este nodo de lote se puede utilizar para la ejecución de proyectos por lotes.ample expone lotes que abarcan dos unidades diferentes:
• /Factory1 – lotes con duraciones de vida agregadas en la Unidad1 y la Unidad2.
• /Factory1/Unit1 – lotes con vida útil solo en la Unidad1
• /Factory1/Unit2 – lotes con vida útil solo en la Unidad2
• Si no tiene un nodo de lote en su fuente de datos, puede utilizar el generador de contexto de lote en SIMCA-online. Consulte la ayuda integrada.
• Datos de lote opcionales
• Un nodo de lote también puede contener datos de lote; datos para los cuales solo hay una observación para todo el lote. Tenga en cuenta que tags Los datos por lotes no necesitan estar en un nodo que tenga la funcionalidad completa de un nodo por lotes. Es suficiente que SimApi admita la lectura de datos por lotes para el tagsObtenga más información sobre los datos por lotes en 7.6.
• Aquí hay un example de un nodo de lote:
• Nota: La captura de pantalla anterior se tomó de DBMaker, incluido en SIMCA-online. Para verla usted mismo en DBMaker, haga clic en el botón View Botón de datos en la base de datos de levadura de panadería para mostrar dos ventanas, una de las cuales es el nodo de lote y la otra los datos del proceso.

Tipos de datos: datos numéricos, datos de texto y datos faltantes

• Para cada uno tagUna SimApi puede admitir tres tipos de datos: numéricos, de texto y faltantes:
• Los datos numéricos suelen ser valores reales de los parámetros del proceso, por ejemplo:ample 6.5123. SimApi solo admite valores de punto flotante de precisión simple de 32 bits. Formato de punto flotante de precisión simple - Wikipedia. Todos los demás tipos de datos numéricos en una fuente de datos deben convertirse a valores flotantes. Por lo tanto, admiten valores grandes y pequeños, pero con solo 6 o 7 dígitos significativos. Más información en la Guía Técnica.
• Esto puede provocar pérdida de precisión con enteros grandes o con números reales que son grandes y tienen decimales. Para más información, consulte la Guía Técnica.
• Los datos de texto/cadena se utilizan para los identificadores de lote, las condiciones de ejecución de la fase o las variables cualitativas. Los valores de texto tag Los datos distinguen entre mayúsculas y minúsculas. Esto significa que el valor "en ejecución" no es el mismo que
  “EN EJECUCIÓN”. Las variables de fecha y hora no son compatibles directamente con SimApi, pero se pueden devolver como una cadena con el formato AA-MM-DD HH:MM (por ejemplo,ample “2020-09-07 13:45”).
• Los valores faltantes significan que no hay ningún valor que devolver, es decir, no hay datos.
• El tipo que se devuelve depende de la implementación de SimApi. Una SimApi conoce los datos de la fuente de datos y debería devolver el tipo de datos que mejor se ajuste.

Tres modos de recuperación de datos: continuo, por lotes y discreto

• La especificación SimApi define tres modos de recuperación de datos, es decir, tres formas diferentes en las que SimApi puede proporcionar datos desde tags en una fuente de datos (o en la otra dirección: escribir datos en tags en una fuente de datos).
• Recuperación continua de datos: se refiere a la lectura continua y secuencial de datos, observación por observación, a medida que evoluciona el lote o proceso. Los datos se leen para el momento actual o para un rango específico, a intervalos regulares entre observaciones. Por ejemplo:ample, todos los datos entre las 09:00:00 y las 10:00:00 sampse condujo cada 60 segundos, lo que dio como resultado 61 observaciones cuando se incluyen los puntos finales.
• Recuperación de datos por lotes: se refiere a una sola observación con datos de un lote completo (no asociado a una madurez o momento específico). Los atributos del lote y los datos de centrado local se leen como datos de lote en SIMCA-online. Las condiciones del lote también se leen normalmente como datos de lote (a menos que estén configuradas para la recuperación de datos discretos).
• Recuperación de datos discretos: los datos discretos pueden constar de varias observaciones para diversos vencimientos. Sin embargo, a diferencia de los datos continuos, los datos discretos no se leen secuencialmente, sino que se leen todos a la vez para una fase específica de un lote. No es necesario que los datos estén espaciados con intervalos regulares según la variable de vencimiento. Todos los datos se releen cada vez que se solicitan, en el intervalo configurado.
• Para cualquier caso dado tag Los datos se pueden solicitar en cualquiera de los tres modos, pero normalmente una SimApi solo admitirá uno de estos modos para un individuo. tag. Asimismo, se permite mezclar tags dentro de un nodo, pero normalmente todos tags Dentro de un nodo específico se admite el mismo modo de recuperación de datos.
• Para datos continuos (pero no para datos por lotes o discretos2), se pueden realizar solicitudes de datos actuales o datos históricos, que es el tema de la siguiente sección.
• No todas las SimApis admiten todos los modos. Consulta la matriz de funciones anterior y la SimApi web página para más detalles.

Datos continuos actuales e históricos a través de un SimApi

• Los datos continuos se refieren a datos de proceso que cambian con el tiempo.

Datos actuales

• Leer datos actuales significa pedirle a la fuente de datos los últimos valores de tags en el momento de la consulta. Tenga en cuenta que aquí no se utiliza la hora de la fuente de datos externa.
• Los datos leídos como datos actuales son los que SIMCA-online mostrará como datos en vivo. Por este motivo, es importante que no haya demoras innecesarias en la fuente de datos. Los datos actuales deben ser lo más recientes posible para que funcionen bien en SIMCA-online.
• La fuente de datos puede utilizar su conocimiento de los datos y de cuánto tiempo son válidos los valores y decidir devolver los datos faltantes cuando los datos sin procesar para un punto de tiempo son demasiado antiguos. Por ejemplo:ample: se solicitan datos a las 15:00:00, pero el punto de datos más reciente en la fuente de datos es de las 03:00:00. En este caso, los datos tienen 12 horas de antigüedad, por lo que SimApi puede decidir devolver el valor faltante (sin datos).

Datos históricos

• Leer datos históricos significa solicitar a la fuente de datos valores de uno o más tags Para un rango de tiempo específico con un intervalo específico entre observaciones. Tenga en cuenta que aquí se utiliza la hora local de la fuente de datos para encontrar los datos. Por lo tanto, la sincronización horaria entre la fuente de datos y los servidores es importante.
• Los datos históricos consisten en una matriz de datos. Depende de la implementación de SimApi solicitar los datos de la fuente de datos yampDéjalo en el intervalo especificado y construye la matriz de datos a devolver:
• A veces, la propia fuente de datos tiene funciones de agregación para devolver datos procesados, oampfunciones ling, que pueden usarse para devolver los datos correctos.
• Para otras fuentes de datos, SimApi debe solicitar todos los datos en el rango de tiempo y luego...ampRealiza las observaciones correctas para construir la matriz.
• Se deben devolver datos para un rango de tiempo, aunque no haya datos sin procesar en ese rango, sino justo antes de la hora de inicio. Por ejemplo:ample: los datos existen en la fuente de datos en los puntos de tiempo 10 y 20. SimApi solicita datos para los tiempos 15 y 17. En este caso, SimApi debe devolver los valores para el punto de tiempo 10, pero timestampSe han utilizado como tiempo 15 y 17, ya que estos fueron los puntos de datos más recientes en esos momentos. Los valores para tags En el momento 10 se hace referencia a los valores límite para el rango solicitado. Para obtener una explicación más detallada de los valores límite, consulte, por ejemplo,ampConsulte la documentación de returnBounds en UA Parte 11: Acceso histórico – 6.4.3 Estructura ReadRawModifiedDetails
  (opcfoundation.org)
• La interpolación nunca debe utilizarse para calcular valores para puntos temporales futuros, ya que los datos no coincidirán con lo que se lee en tiempo real como datos actuales. Por ejemplo,ampLeamos el punto anterior: si los datos de los puntos 15 y 17 se interpolaran utilizando los valores de los puntos 10 y 20, en realidad se utilizarían valores del futuro, lo cual no está permitido.
• La fuente de datos puede utilizar su conocimiento de los datos y de cuánto tiempo son válidos los valores y decidir devolver los datos faltantes cuando los datos sin procesar para un punto de tiempo son demasiado antiguos. Por ejemplo:ample: Se solicitan datos para las 15:00:00, pero el punto de datos más reciente en la fuente de datos es de las 03:00:00. En este caso, los datos tienen 12 horas de antigüedad, por lo que SimApi podría decidir devolver el valor faltante (sin datos).

Nota: SIMCA-online no suele solicitar más de cien observaciones en una sola llamada durante la ejecución normal del proyecto. Al realizar extracciones en SIMCA-online o al ejecutar SIMCA de escritorio, pueden realizarse solicitudes de datos más grandes. Esto puede tardar bastante tiempo, lo cual es previsible.

Los datos actuales y los datos históricos deben coincidir

• En ocasiones pueden existir diferencias cuando los datos se leen como datos actuales en tiempo real o datos históricos. Esto causa problemas en SIMCA-online porque el servidor cambia automáticamente entre datos actuales e históricos según sea necesario.

Adquisición de datos de baja latencia

• Cuando SIMCA-online utiliza una fuente de datos en tiempo real, es importante que los datos de la fuente de datos estén actualizados. No deben producirse retrasos innecesarios en la adquisición de datos en la fuente de datos. Los datos del proceso continuo para todas las variables deben estar disponibles al mismo tiempo para cada observación. SIMCA-online no recogerá los datos que lleguen tarde para algunas variables.

Los datos se pueden leer en cualquier momento. 

• Cuando SIMCA-online solicita un valor de un tag Para el tiempo t, recibirá el valor de la fuente de datos correspondiente al tiempo t, o la última observación en la fuente de datos anterior al tiempo t, o un valor interpolado para el tiempo t. Por lo tanto, el servidor siempre obtendrá un valor cada vez que lo solicite, incluso si no existe una observación para ese momento exacto en la fuente de datos.
• OportunoampLos horarios en SimApi son siempre UTC. Los clientes de SIMCA-online y SIMCA presentan la hora como hora local.

Enhebrado 

• De forma predeterminada, el usuario llama a SimApi mediante un único hilo. Esto aplica a todas las versiones de SIMCA y SIMCA-online hasta la versión 17.
• SIMCA-online 18 admite una función para activar el acceso multihilo mediante SimApi. Más información en el tema de ayuda "Acceso simultáneo a SimApi".
• Esto significa que SimApis debe prepararse para subprocesos múltiples, si es posible, haciendo que la implementación de SimApi sea segura para subprocesos y documentando esto y cualquier consideración para los usuarios de SimApi.

Registro file

• Una SimApi debe registrar acciones, mensajes de error y advertencias en su registro. file Para facilitar la resolución de problemas. Utilice los diferentes niveles de registro para indicar la importancia del registro.
• Se recomienda registrar “No implementado” para las funciones que no se han implementado en una SimApi.

Manejo de errores

• Cuando un SimApi no puede cumplir con una solicitud de la fuente de datos, puede manejar este problema de una de dos maneras: devolviendo valores faltantes (sin datos) o señalando un error de SimApi:
• Devolver los valores faltantes al emisor y señalar el éxito permite que este continúe con normalidad (pero, por supuesto, sin datos). Esta práctica se recomienda para errores parciales, como cuando se pudieron obtener datos para algunos, pero no para todos. tags en una solicitud.
• Señalar un error de SimApi permite que quien llama (por ejemplo,amp(el servidor SIMCA-online) para ver esto inmediatamente y tomar medidas. Esta es una práctica recomendada para solicitudes que fallan completamente y no pueden devolver ningún dato.
• SIMCA-online maneja los valores faltantes o los códigos de error de forma diferente, como se describe en la Guía técnica de SIMCA-online.

Requisitos de rendimiento de SimApi

• Las funciones de SimApi se utilizan para obtener datos.
• Si el acceso a los datos es lento, SimApi no funcionará bien, lo cual es un error.ample muestra: Si SIMCA-online solicita datos cada segundo, pero tarda dos segundos en obtenerlos, el servidor de SIMCA-online nunca podrá mantener el ritmo en tiempo real, sino que se quedará progresivamente más y más atrás.
• En las subsecciones, mostraremos cómo SIMCA y SIMCA-online utilizan las funciones de acceso a datos de SimApi y con qué frecuencia se invocarán las funciones de SimApi. Esto puede ayudar a establecer los requisitos de rendimiento para una implementación de SimApi.

Uso de las funciones de SimApi por parte de SIMCA

• Cuando SIMCA de escritorio u otros productos fuera de línea utilizan una SimApi para obtener datos, estas solicitudes serán para lotes y datos de proceso para un conjunto de variables en un rango de tiempo determinado.
• Dado que estas solicitudes las inicia manualmente un usuario, no ocurren con mucha frecuencia y no provocan una carga significativa en una fuente de datos.
• Estas funciones de SimApi se utilizan para obtener los datos:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

Uso de las funciones de SimApi por parte de SIMCA-online

• SIMCA-online se utiliza para la monitorización en tiempo real de un proceso y, por lo tanto, solicita datos a través de SimApi a intervalos regulares. El intervalo de ejecución más corto que se puede utilizar es de 1 segundo. Algunos ejemplos del mundo realampLos intervalos de ejecución son 10 s, 1 minuto o 10 minutos.
• Un servidor puede tener muchos proyectos ejecutándose al mismo tiempo.
• Para reducir la cantidad de llamadas API a través de SimApi, el servidor optimiza las solicitudes de datos agrupando muchas solicitudes más pequeñas simultáneas en una única solicitud más grande para todas las variables al mismo tiempo (obtenga más información en el tema de ayuda "La lectura optimizada de fuentes de datos mejora el rendimiento").
• El algoritmo de ejecución del servidor funciona así cuando solicita datos utilizando las funciones SimApi enumeradas a continuación:
• Todas las fases que se ejecutan en el mismo intervalo se agrupan en una sola llamada a SimApi para reducir el número de llamadas. El servidor lee los datos más recientes de todas las variables utilizadas por todos los modelos que comparten el intervalo; es decir, esta llamada genera una fila de datos amplia que luego utilizan todos los proyectos.
  • simapi2_connectionReadCurrentData
• Para cada proyecto por lotes, el servidor también necesita saber qué lotes están activos. Esto también debe ocurrir cada vez que se ejecuta un proyecto:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes se llama con menos frecuencia.
• Además, SIMCA-online también requiere datos históricos. Estas solicitudes se realizan solo cuando son necesarias, por ejemplo, para recuperar el inicio de un lote iniciado antes del inicio de SIMCA-online, o cuando el servidor se retrasa y necesita leer un bloque de datos.
  • simapi2_connectionReadHistoricalDataEx
• De manera opcional, algunas configuraciones de proyecto utilizan funciones que utilizan datos por lotes o datos discretos, lo que genera llamadas a SimApi para:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• De manera opcional, algunas configuraciones del proyecto utilizan la escritura diferida para devolver los datos a la fuente de datos:
  • simapi2_connectionWriteHistoricalDataEx (y funciones correspondientes para datos por lotes y datos discretos)
• Es importante que cada llamada a las funciones principales para obtener datos, readCurrentData, getActiveBatches/getBatchTimes, sea rápida y que no sea computacionalmente difícil para la fuente de datos en sí, dada la frecuencia con la que SIMCA-online puede llamar a esas funciones.

Prueba y validación de datos de SimApi

• Esta sección trata sobre la prueba de una SimApi para verificar que los datos que devuelve coincidan con los datos de la fuente de datos. Realizar pruebas como esta es importante después de crear o cambiar la implementación de SimApi, o cuando cambia la API de una fuente de datos.
• En la práctica, la validación de datos se realiza mediante SIMCA-online y su función de extracción para extraer datos de la fuente de datos a través de SimApi y luego compararlos con los datos sin procesar de la fuente de datos. La versión de escritorio de SIMCA no se puede utilizar para probar los aspectos en tiempo real de una SimApi.

Preparaciones y requisitos

• Algunos elementos son opcionales pero se pueden realizar si el alcance de su prueba lo incluye:

1. Instale SIMCA-online como se describe en el archivo ReadMe y Installation Guide.pdf que viene en el zip del producto.
2. Obtenga una licencia para el servidor SIMCA-online e instálela. SimAPI no funcionará sin una licencia. El artículo de la base de conocimientos sobre SIMCA-online muestra cómo obtener la licencia del producto. Por ejemplo:ampArchivo: SIMCA-online 18 (sartorius.com)
3. Instale y configure la SimApi que desea probar. Consulte los capítulos 4 y 5 de este documento y la guía del usuario de la SimApi específica.
   • a. Opcional: asegúrese de que la guía del usuario esté actualizada y sea correcta.
4. Asegúrese de tener una herramienta para su fuente de datos que pueda usar para comparar los datos de SimApi.
5. En el cliente de escritorio SIMCA-online, inicie sesión en su servidor SIMCA-online y utilice File > Extraer para obtener datos a través de SimApi.
6. Opcional si su alcance de prueba lo incluye: después de finalizar la prueba, desinstale SimApi y verifique su files se eliminan.

Qué probar

• La matriz de características del capítulo 3 enumera todas las características posibles, pero es posible que una determinada implementación de SimApi admita solo un subconjunto. Debe probar todas las características que implementa la SimApi en cuestión.
• Las siguientes pruebas son comunes a la mayoría de las implementaciones de SimApi:
• Autenticación con nombres de usuario y contraseñas
• Pruebe las distintas configuraciones en la configuración de SimApi
• Jerarquía de nodos: Los nodos y tags expuestos por SimApi son correctos.
  • Debe haber una tag Expuesto para todas las “variables” que deberían estar disponibles a través de SimApi. Examples: mediciones de proceso, valores calculados, constantes.
• Resiliencia de la conexión: si la fuente de datos no está disponible, esto genera advertencias o errores en el registro. file, pero que la conexión con la fuente de datos se restablezca automáticamente cuando la fuente de datos esté disponible.
• Instancias múltiples: que se puedan configurar y utilizar dos instancias de forma independiente y simultánea, con registros separados files.
• Datos actuales: extraiga datos actuales para tagsAsegúrese de que los datos sean los últimos valores conocidos de la fuente de datos o que falten debido a la mala calidad o cuando los datos sean demasiado antiguos.
  • Extraer datos cada 10 segundos (aproximadamente) durante un minuto.
• Datos históricos continuos: extraiga datos históricos para tags.
  • Utilice el intervalo de tiempo que coincida con la fecha de extracción de los datos actuales. Verifique que los datos actuales coincidan con los datos históricos y los datos sin procesar de la fuente de datos.
  • Pruebe diferentes rangos de tiempo y sampIntervalos de ling, verificar que los datos coincidan con la fuente de datos.
  • Intente extraer datos cada 1 s, que es el tiempo más corto posible.ampintervalo de ling.
  • Pruebe varios tipos de tags en la fuente de datos (variables de proceso, etc.), asegurándose de que los datos coincidan.
  • Nota: SIMCA-online puede dividir una sola solicitud extensa de datos históricos en varios fragmentos más pequeños. Esto será visible en el registro de SimApi.
• Verifique que SimApi funcione con datos de texto, datos numéricos y datos faltantes.
• Registro de SimApi file. Verifique que el registro contenga entradas razonables.
• Nodo de lote: haga clic derecho en un nodo y seleccione Buscar lotes.
  • Verificar los nombres de los lotes, las horas de inicio y las horas de finalización de los lotes.
  • Pruebe un lote activo que se esté ejecutando en la fuente de datos. No debería tener una hora de finalización a través de SimAPI.
• Identificador de lote del nodo de proceso tagSi SimApi tiene funcionalidad de nodo de lote (ver punto anterior), también debe tener un identificador de lote. tag en el nodo de datos del proceso de coincidencia. Datos para este tag debe ser el identificador del lote (nombre del lote). Estos datos son necesarios para que los proyectos por lotes identifiquen a qué lote pertenece una fila de datos.

Dependiendo de si SimApi lo admite, es posible que también desees probar:

• Uso de datos por lotes File > Extraer.
• Uso de datos discretos File > Extraer. Nota: para probar datos discretos con File > Extraer el nodo, el nodo por lotes y el nodo de datos discretos deben estar en el mismo SimApi (cuando SIMCA-online ejecuta proyectos, pueden ser de diferentes SimApis).
• Reescritura: enviar lotes de datos a la fuente de datos. Para probar esto, debe configurar un proyecto en SIMCA-online para reescribir los vectores de datos en la fuente de datos. A continuación, ejecute el proyecto en SIMCA-online y compruebe los datos reescritos en la fuente de datos.
• Los datos continuos se configuran en la página Evolution Write Back en la configuración del proyecto.
• Los datos discretos se configuran en la misma página, pero solo para una fase configurada para la recuperación de datos discretos.
• Datos por lotes de la escritura por lotes

MÁS INFORMACIÓN

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Suecia
• Teléfono: + 46 90-18 48 00
• www.sartorius.com
• La información y las cifras contenidas en estas instrucciones corresponden a la fecha de la versión especificada a continuación.
• Sartorius se reserva el derecho de realizar cambios en la tecnología, características, especificaciones y diseño del equipo sin previo aviso. Se utilizan formas masculinas o femeninas para facilitar la legibilidad en estas instrucciones y siempre denotan simultáneamente todos los géneros.
  Aviso de derechos de autor:
• Estas instrucciones, incluidos todos los componentes, están protegidas por derechos de autor.
• No se permite ningún uso más allá de los límites de la ley de derechos de autor sin nuestra aprobación.
• Esto se aplica en particular a la reimpresión, traducción y edición, independientemente del tipo de soporte utilizado.

Preguntas frecuentes

• P: ¿Cuál es el propósito de SimApis?
  • R: El objetivo principal de SimApis es proporcionar datos a los productos de Umetrics Suite para la creación de proyectos y la construcción de modelos.
• P: ¿Cómo puedo solucionar problemas con una instalación de SimApi?
  • R: Puede solucionar problemas probando desde SIMCA-online, verificando el registro de SimApi filey garantizar la configuración correcta de la cuenta de servicio.