Guía del usuario de SARTORIUS ODBC SimApi

API de simulación ODBC

Presupuesto

• Producto: ODBC SimApi
• Fabricante: Sartorius Stedim Data Analytics
• Conectividad: ODBC (Open Database Connectivity)
• Compatibilidad: Funciona con Umetrics Suite y datos externos
  fuentes

Instrucciones de uso del producto

Prerrequisitos

Antes de utilizar ODBC SimApi, asegúrese de lo siguiente:

• Tener una fuente de datos ODBC estructurada como una relacional
  base de datos
• La fuente de datos debe comportarse como un buen historiador de datos de procesos.
• Asegúrese de que no haya retrasos en la adquisición de datos en la fuente de datos
• Los datos de la fuente deben reflejar el estado actual de la
  proceso
• La fuente de datos debe responder rápidamente a las solicitudes de información en tiempo real.
  escucha

Instalación y configuración

1. Instale el software ODBC SimApi en su sistema.
2. Configure la fuente de datos ODBC para conectarse a la base de datos deseada.
   base de datos.
3. Consulte la guía del usuario para obtener instrucciones de configuración detalladas.
   sobre el uso del software.

Preguntas frecuentes (FAQ)

P: ¿Qué es una SimApi?

A: Una SimApi es la conexión entre Umetrics Suite y
Fuentes de datos externas, específicamente la conexión a fuentes de datos ODBC
como bases de datos relacionales.

P: ¿Cómo puedo utilizar la función de identificación de lote del proceso sintético?

A: Para utilizar la función de identificación de lote del proceso sintético, configure el
Identificador de lote tag para ser el identificador de lote del nodo de lote en el
Página de condiciones de ejecución en SIMCA-online.

P: ¿Se puede utilizar ODBC SimApi con lotes simultáneos?

A: La función de identificación de lote del proceso sintético no funciona con
Lotes simultáneos. Solo un lote debe estar activo en el lote.
nodo en cualquier momento dado.

Loading PDF…

−+Fit width100%View FullscreenDownload PDFPrint PDF

×

Loading PDF…

¡Error! Utilice la pestaña Inicio para aplicar Headline_1 (Titulares) al texto que desea que aparezca aquí.
Guía del usuario de ODBC SimApi
24 de octubre de 2024

Introducción
Contenido
1 Introducción……………………………………………………………………………………………………………….. 3
1.1 Características …………………………………………………………………………………………………………………………………………………………………………………….. 3 1.1.1 Identificación del lote del proceso sintético ……………………………………………………………………………………………………………………………………. 4 1.1.2 Identificación del lote del proceso sintético generado tags; uno por ID de unidad única …………………………………………….. 4 1.1.3 Nodo de lote con soporte de filtrado …………………………………………………………………………………………………………….. 4 1.1.4 Datos de lote Views…………………………………………………………………………………………………………………………………………………… 5 1.1.5 Datos discretos……………………………………………………………………………………………………………………………………………………………… 6 1.1.6 Acceso simultáneo a SimApi……………………………………………………………………………………………………………………. 7
2 Prerrequisitos ………………………………………………………………………………………………………… 7
2.1 Requisitos de la estructura de la base de datos …………………………………………………………………………………………………………………………… 7 2.2 Consideraciones sobre el rendimiento de la base de datos …………………………………………………………………………………………………………………. 7 2.3 Consideraciones sobre la red ……………………………………………………………………………………………………………………………………………. 8 2.4 Controladores ODBC ………………………………………………………………………………………………………………………………………………………………….. 8 2.5 Autenticación de la base de datos ………………………………………………………………………………………………………………………………………………….. 8 2.6 Visual C++ Redistributable …………………………………………………………………………………………………………………………………………….. 8
3 Instalación y configuración ……………………………………………………………………………………………….. 9
3.1 Configuración de una conexión de fuente de datos ODBC en Windows para su uso por SimApi ………………………………… 9 3.2 Selección entre dos formas de acceder a los datos del proceso ………………………………………………………………………………… 10 3.3 Configuración XML file y registro file ubicaciones………………………………………………………………………………………………………….. 11 3.4 Configuración de conexión global …………………………………………………………………………………………………………………………………………. 11 3.5 Modo directo para conexión continua/proceso views ……………………………………………………………………………………………………………. 11 3.6 Búsqueda View Modo para continuo/proceso viewes……………………………………………………………………………………………….. 12
3.6.1 AP views y HDB views ……………………………………………………………………………………………………………………………….. 13 3.7 Nodo de lote………………………………………………………………………………………………………………………………………………………………………….. 14 3.8 Datos de lote Viewes ……………………………………………………………………………………………………………………………………………………………. 15
3.8.1 Instancia de datos de lote sintético tags …………………………………………………………………………………………………………….. 16 3.8.2 Identificación del lote del proceso sintético tags filtrados por valores de columna…………………………………………………………………….. 16 3.9 Nodos discretos …………………………………………………………………………………………………………………………………………………………………… 16 3.9.1 Nodos discretos Tag Definición View…………………………………………………………………………………………………………………………. 17 3.9.2 Datos discretos vistos por SIMCA-online ……………………………………………………………………………………………………. 18 3.10 Algunas notas sobre la escritura diferida de SIMCA-online …………………………………………………………………………………………………… 18 3.11 Configuración XML File ……………………………………………………………………………………………………………………………… ……… 19
4 Soporte …………………………………………………………………………………………………………………………..22

Introducción
1 Introducción
Este documento es la guía del usuario de ODBC SimApi de Sartorius Stedim Data Analytics.
Una SimApi es la conexión entre Umetrics Suite y fuentes de datos externas.
Esta SimApi se conecta a una fuente de datos ODBC (Open Database Connectivity), como una base de datos relacional. La fuente de datos debe estar estructurada como se describe en este documento.
Para utilizar una SimApi en SIMCA-online que se utiliza para la monitorización en tiempo real, es importante que la fuente de datos se comporte como un buen historiador de datos de proceso: no debe haber retrasos en la adquisición de datos en la fuente de datos: los datos actuales en la fuente de datos deben reflejar el estado actual del proceso para que funcione bien en SIMCA-online. La fuente de datos también debe responder rápidamente a las solicitudes de datos para que el servidor pueda seguir el ritmo de la ejecución de los proyectos en tiempo real.
Para obtener una lista detallada de los cambios en las diferentes versiones de este SimApi, consulte Version Info.txt file que viene con la instalación.
Este SimApi puede ser utilizado por SIMCA o SIMCA-online u otro software que pueda utilizar SimApis.
Para obtener más información sobre los SimApis disponibles, consulte sartorius.com/umetrics-simapi.
1.1 Características
· Admite dialectos SQL para Microsoft SQL Server, Oracle, Microsoft Access, IBM db2, Denodo, MySQL, PostgreSQL y SQL estándar.
· Autenticación de cadena de conexión ODBC con un nombre de usuario y contraseña proporcionados, autenticación de Windows o las credenciales especificadas en la conexión ODBC en fuentes de datos ODBC de Windows.
· Acceder a múltiples tablas o views para leer datos de procesos continuos (actuales e históricos). Dos modos: búsqueda view modo y modo directo (lectura directa desde una base de datos) view).
· Múltiples nodos de lotes que definen la duración de los lotes. Contiene una sola fila para cada lote con las horas de inicio y finalización.
· Lectura de datos de lotes (condiciones de lote) desde columnas adicionales en nodos de lotes o desde Datos de lotes Views que almacenan las condiciones del lote en una tabla estrecha con solo dos columnas (tag nombre y valor).
· Soporte de datos discretos: lectura de datos discretos en uno o más nodos, que pueden tener diferentes nombres de columna. · Escritura desde SIMCA-online: datos históricos de proceso y datos de lote. · Trabaja con datos numéricos o datos de texto (cualitativos). · Identificación sintética de lote de proceso en el nodo de lote, que se puede utilizar en la ejecución de la fase de SIMCA-online
Condiciones, si los datos del proceso no tienen un identificador de lote. tag. · Identificación del lote del proceso sintético tags en datos por lotes Views que se pueden filtrar por otras columnas. Se puede utilizar
en condiciones de fase cuando el ID de lote no está disponible en los datos del proceso. · Nodos de lote con soporte de filtrado. El soporte de filtrado es útil cuando tiene un nodo de lote con un maestro
lista de lotes para todo el sistema pero desea poder filtrarla para mostrar solo lotes en una parte del sistema (como lotes que se ejecutan en una sola unidad o un lote de un material o tipo específico). · Instancia de datos de lote sintéticos tags · Manejar múltiples mediciones de datos de lote por lote. Útil si desea poder crear modelos a nivel de lote que utilicen dos o más mediciones de cada variable de condición de lote por lote. · Múltiples instancias de ODBC SimApi para configurar y utilizar desde el mismo servidor SIMCA-online. Esto le permite conectarse a múltiples bases de datos en uno o más servidores de bases de datos. · Resistencia de conexión: SimApi se reconecta automáticamente a una fuente de datos después de que se haya desconectado (por ejemplo,amp· Acceso simultáneo seguro para subprocesos. SimApi funciona con la función de acceso simultáneo a SimApi introducida con el servidor SIMCA-online 18, que puede mejorar el rendimiento y la capacidad de respuesta. · Admite fechas almacenadas como horas locales o UTC en la base de datos.
Cada función (continua, por lotes o discreta) se puede configurar y utilizar de forma independiente, y todas las funciones son opcionales. No es necesario configurar funciones a menos que las necesite.

Introducción
1.1.1 Identificación del lote del proceso sintético
En un proyecto por lotes, los datos del proceso deben tener un ID de lote tag (columna) que se especifica en la página Condiciones de ejecución en la configuración del proyecto en SIMCA-online. Esta tag Se compara con el nodo de lote para saber si se debe ejecutar una fase.
Si los datos del proceso no tienen un ID de lote tagSe puede utilizar la función ODBC SimApi para generar el ID de lote de proceso sintético. Genera el ID de lote de datos de proceso utilizando datos del nodo de lote.
Para utilizar esta función, vaya a la página Condiciones de ejecución y configure el Identificador de lote tag para ser el ID de lote del nodo de lote. Siempre que el servidor lea el ID de lote para los datos del proceso, se devolverá el ID de lote sintético del nodo de lote, lo que garantiza que la unidad se ejecutará.
Tenga en cuenta que esta función no funciona con lotes simultáneos (paralelos). Por lo tanto, en cualquier momento determinado debe haber solo un lote activo en el nodo de lote.
1.1.2 Identificación del lote del proceso sintético generado tags; uno por cada ID de unidad única
Esta función se basa en el ID de lote de proceso sintético descrito anteriormente, pero utiliza una columna adicional en el nodo de lote que contiene el UnitID. El nodo de lote se segmenta en clases de lotes que comparten el mismo valor en la columna UnitID. Esto actúa como un para los lotes en el nodo de lote que tienen un valor determinado para UnitID.
Para cada valor único en la columna UnitID (buscando en todo el nodo de lote), SimApi crea un valor sintético. tag en el nodo de lote con el nombre BatchID_Unit_[Value].
Por ejemploample: si los valores 1 y 2 son los dos valores únicos en la columna UnitID, dará como resultado dos valores sintéticos tags; BatchID_Unit_1 y BatchID_Unit_2. Lectura de datos de proceso desde el ID de lote sintético tag BatchID_Unit_1 devolverá solo los identificadores de lote para los lotes cuya columna UnitID tenga el valor 1. Los lotes con 2 en la columna UnitID se ignorarán.
Para utilizar esto, configure el identificador de lote tag en la página Condiciones de ejecución para cada unidad, utilice el BatchID_Unit_[Value] sintético tags.
El nombre de la columna de identificación de la unidad se configura en el XML file.
Restricciones
· En cuanto al ID de lote sintético regular descrito anteriormente, por extensión, esto no funciona con lotes simultáneos (paralelos) que comparten el mismo valor de UnitID (los lotes simultáneos con diferentes UnitID funcionan bien).
· Todos los identificadores de unidad deben especificarse en el nodo de lote antes de iniciar SimApi (el sintético tags se crean al inicio). Consejo: puede rellenar previamente una tabla con un lote ficticio en el nodo de lote para cada ID de unidad que se requerirá.
· Los identificadores de lote deben ser únicos en el nodo de lote y solo puede haber una fila para cada identificador de lote. Por lo tanto, cada lote solo puede tener un valor de UnitID.
· El valor de UnitID no debe cambiar para un lote específico durante su vida útil.
Nota: una alternativa al uso de un identificador de lote de proceso sintético filtrado por UnitID como este es utilizar múltiples nodos de lote; uno para cada valor único de UnitID. En el caso de múltiples nodos de lote, el mismo identificador de lote puede estar presente en muchos nodos de lote (a diferencia de cuando se utiliza el filtro UnitID), por lo que en algunos casos, múltiples nodos de lote son la solución preferida.
1.1.3 Nodo de lote con soporte de filtrado
Se necesita un nodo por lotes en SIMCA-online para ejecutar proyectos por lotes.
El filtrado es útil cuando tiene un nodo de lote con una lista maestra de lotes para todo el sistema, pero desea filtrarlo para mostrar solo los lotes en una parte del sistema (como lotes que se ejecutan en una sola unidad o un producto de un determinado material o tipo).

Introducción

El filtrado es opcional y para usarlo debe especificar la columna que desea filtrar y especificar una lista de valores válidos para esa columna. Para cada valor configurado, SimApi crea un nodo independiente que contiene solo lotes con ese valor en la columna de filtro.

Aquí hay un example de un lote view, llamado BatchNode en la base de datos, con una columna Unidad que se puede utilizar para filtrar lotes.

Hora de inicio de BatchID

Detener el tiempo

Unidad (columna de filtro) Variable de condición del lote 1

Batch1 2017-01-01 01:00 2017-01-01 11:00 A

34

Batch2 2017-01-02 02:00 2017-01-02 12:00 B

4

Batch3 2017-01-03 03:00 2017-01-01 13:00 A

12

Batch4 2017-01-04 04:00 2017-01-04 14:00 A

4

Batch5 2017-01-05 05:00 2017-01-05 15:00 B

5

Configurado para la unidad A y B, esto daría dos nodos de lotes denominados BatchNode_A y BatchNode_B. Cada uno de esos nodos de lotes solo devolvería lotes que corresponden a su valor de filtro, por lo que para BatchNode_A se devolverían Batch1, Batch3 y Batch4 y para BatchNode_B se devolverían Batch2 y Batch5. La última columna es un example de una variable de condición de lote que estará disponible en este nodo de lote para leer datos de nivel de lote.

Los identificadores de lotes de procesos sintéticos son compatibles con los nodos de lotes configurados de esta manera.

1.1.4 Datos por lotes Views
Un lote de datos view es una base de datos view o tabla para almacenar valores para condiciones de lote. Debe tener tres columnas: identificador de lote, Tag Nombre y valor. Una fila en esa view almacena un valor para un específico tag y lote. Habrá muchas filas en este view para cada lote cuando hay muchas variables de condición del lote.
Aquí hay un exampLe de un lote de datos view en la base de datos con sus tres columnas:

ID de lote

Tag nombre

Valor

Lote 7

Producir

0.95

Lote 7

Calidad del producto

Excelente

Lote 8

Producir

0.90

Lote 8

Calidad del producto

Pobre

Este lote de datos view se expondrá a través de SimApi como dos tags Rendimiento y calidad del producto. Valores de lectura para aquellos tags para Batch8 daría como resultado los valores 0.90 y “Pobre” respectivamente.

Nota: Si hay varias filas para el mismo BatchID y Tag Combinación de nombres en la base de datos viewSimApi devolverá el valor de la última de esas filas.

No hay columnas de horas de inicio o de finalización de lote en los datos de lote views, por lo que no se pueden utilizar como nodos de lote.

Puede configurar muchos datos de lotes diferentes views.

Consejo: Como alternativa a los datos por lotes Views, los datos de condición de lote también se pueden almacenar en un nodo de lote. En ese caso, se necesita una columna para cada variable de condición de lote. Por lo tanto, solo habrá una fila para cada lote en los nodos de lote, pero se necesitan más columnas.

Introducción

Importante para la funcionalidad de extracción de SIMCA-online: Para extraer datos de un lote de datos view También debes incluir uno tag (como el identificador de lote) tag) desde un nodo de lote, para que SIMCA-online pueda conocer los lotes para los que extraer datos.

1.1.4.1 Instancia de datos de lote sintético tags Los datos por lotes siempre constan de una única observación por lote1.
Pero, ¿qué pasa si los valores de un lote de datos tag Podría cambiar (por ejemplo)amp¿Por qué no se ejecutan varias mediciones nuevamente y si se desean utilizar varias mediciones por lote en un modelo de nivel de lote de SIMCA-online?
Luego puede utilizar la función opcional de instancia de datos sintéticos por lotes. tagsEstos son tags que se agregan como adicionales tags En los datos del lote view, cada asignación a una instancia particular de los datos del lote para el tag.
Aquí hay un exampen:

ID de lote

Columna de tiempo

Tag nombre

Valor

Lote 7

2015-06-23 09:00 Yield

0.90

Lote 7

2015-06-23 17:00 Yield

0.99

Luego, SimApi expondrá estos datos por lotes. view con dos tags; Yield_1 y Yield_2. Cuando se leen los datos del lote Batch7, se obtendrán los valores 0.90 para Yield_1 y 0.99 para Yield_2.

Tenga en cuenta que hay una nueva TimeColumn agregada en este ejemplo.ample, con un timestamp Para cada fila. Esta columna es necesaria para la instancia de datos de lote sintéticos. tag característica, para que SimApi sepa cómo ordenar los valores para el tags En la instancia tags.

1.1.4.2 Identificación del lote del proceso sintético tags filtrado por valores de columna Esta característica es como el ID de lote del proceso sintético generado tags; uno por cada ID de unidad única con la diferencia de que esto se lee desde un lote de datos view y el ID del lote se puede filtrar en varias columnas.
Aquí hay un exampen:

ID de lote

Columna de tiempo

Tag Nombre Valor

Unidad

Línea

Lote 7

2015-06-23 09:00 Yield

0.90

A

1

Lote 8

2015-06-23 09:00 Yield

0.95

B

2

Si filtramos el BatchID en las columnas Unidad y Línea, eso nos daría un ID de lote sintético. tag para cada combinación única de los valores de las columnas Unidad y Línea.

Sintético tags Los lotes creados serían: BatchID_A_1, BatchID_B_2

Por lo tanto, leer BatchID_A_1 para el tiempo en la tabla daría el valor Batch7, y para el mismo tiempo BatchID_B_2 daría el valor Batch8.

Tenga en cuenta que una columna de tiempo con un timestamp Para esta función se requiere cada fila.

1.1.5 Datos discretos
Los datos discretos son datos que se miden con poca frecuencia y que no tienen valores lógicos entre mediciones. Por lo general,ampSe toma en cada lote a intervalos semirregulares (por ejemplo, una vez al día).ampLuego se envía a un laboratorio que realiza un análisis del sample y en un momento posterior stagRegresó con un informe sobre el sample para las variables requeridas. Luego, esto se ingresa en la base de datos en la tabla de datos discretos.
Obtenga más información sobre esto en la Guía de SimApi y la Guía técnica de SIMCA-online.

1 Para obtener más información sobre los diferentes modos de recuperación de datos, de los cuales los datos por lotes son uno, consulte SimApi Guide.pdf.

Prerrequisitos
1.1.5.1 Antigüedad sintética del lote tags Para nodos de datos discretos Para nodos de datos discretos hay cuatro sintéticos tags denominados $BatchAge(d), $BatchAge(h), $BatchAge(m), $BatchAge(s). Al leer sus valores, serán la antigüedad del lote como un número de punto flotante para cada sampen cuatro magnitudes diferentes: días, horas, minutos y segundos respectivamente. Estos tags se puede utilizar como madurez en el modelo SIMCA, reduciendo la necesidad de agregar y completar explícitamente dichos datos. tags a las tablas de datos discretos.
1.1.6 Acceso simultáneo a SimApi
El acceso simultáneo a SimApi es una característica opcional introducida con el servidor SIMCA-online 18 que puede mejorar el rendimiento y la capacidad de respuesta de un servidor y sus clientes.
ODBC SimApi es seguro para subprocesos y utiliza un grupo de conexiones al servidor. El tamaño del grupo se puede configurar mediante la opción DatabaseConnectionPoolSize en la configuración. file (valor predeterminado: 10). Esto controla cuántas solicitudes simultáneas a la base de datos se permiten. Las solicitudes simultáneas adicionales se ponen en cola y se ejecutan a medida que finalizan las solicitudes anteriores.
Es posible que distintos motores y servidores de bases de datos admitan una cantidad distinta de subprocesos simultáneos. Para obtener un rendimiento óptimo, es posible que sea necesario ajustar el tamaño del grupo de conexiones.
Obtenga más información sobre consideraciones y cómo habilitar esto en la ayuda en línea de SIMCA sobre acceso simultáneo a SimApi.
2 Requisitos previos
Para que SimApi funcione, hay requisitos que deben cumplirse, tanto para la PC que ejecuta SimApi como para la fuente de datos en sí, relacionados con la estructura y el rendimiento de la base de datos.
2.1 Requisitos de la estructura de la base de datos
Por supuesto, una base de datos puede contener casi cualquier dato con una estructura arbitraria. ODBC SimApi está diseñado para obtener datos de proceso para su uso en SIMCA-online y SIMCA.
Para que SimApi funcione, la base de datos debe tener una estructura o diseño particular como se describe a continuación.
A continuación se muestran los requisitos generales:
· Todas las tablas utilizadas tienen una clave principal única. · La mayoría de las tablas en la base de datos requieren columnas de fecha/hora para que SimApi pueda identificar la hora.amp
para cada fila de datos. Esta columna debe estar indexada en la base de datos para que el rendimiento no se vea afectado. · SimApi admite dos tipos de datos para las columnas de datos: valores reales numéricos (un flotante u otro
tipo de datos numérico) o cadenas de texto (por ejemploampel varchar en la base de datos). También se permiten valores faltantes (nulos) para las columnas de datos. · El término view y tabla se utilizan indistintamente en este documento para significar lo mismo. · Si crea una view en la fuente de datos y desea utilizarla en SimApi, tenga cuidado de no introducir problemas de rendimiento: view Debe ser de rápido acceso para SimApi. Esto significa que normalmente no se puede crear un archivo complejo. view que agrega datos de muchas otras tablas y ejecuta una lógica empresarial compleja para calcular los resultados. view no cumplirá con los requisitos de rendimiento de los usuarios de SimApi como SIMCA-online, utilizado para la monitorización en tiempo real de un proceso.
SimApi tiene muchas características y cada característica tiene varias configuraciones necesarias que deben realizarse, como se describe en el capítulo 3.
2.2 Consideraciones sobre el rendimiento de la base de datos
Para utilizar un SimApi en SIMCA-online que se utiliza para la monitorización en tiempo real, es importante que la fuente de datos se comporte como un buen historiador de datos de proceso.
· No debe haber retrasos en la adquisición de datos en la fuente de datos: los datos actuales en la fuente de datos deben reflejar el estado actual del proceso para que funcione bien en SIMCA-online.

Prerrequisitos
· La fuente de datos también debe responder rápidamente a las solicitudes de datos para que el servidor pueda mantenerse al día con la ejecución de los proyectos en tiempo real.
Esto tiene varias implicaciones:
· Los almacenes de datos o bases de datos que realizan agregación de datos pueden no funcionar bien con SIMCA-online para la ejecución de proyectos en tiempo real, porque podrían introducir retrasos en la adquisición de datos.
· Base de datos viewLos sistemas que realizan consultas complicadas y que consumen mucho tiempo corren el riesgo de ser demasiado lentos para su uso en SIMCA-online.
2.3 Consideraciones sobre redes
Debe ubicar el servidor 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, como los cortafuegos, pueden interferir con la conexión entre SIMCA-online y la fuente de datos. Si este es el caso, es posible que deban modificarse las reglas del cortafuegos. Verifique la conectividad desde la PC que ejecuta SimApi a la fuente de datos utilizando, por ejemplo,ampHaga clic en el botón Probar conexión en las fuentes de datos ODBC.
2.4 Controladores ODBC
Para SimApi es necesario que los controladores ODBC de la fuente de datos estén instalados en el equipo en el que se encuentra instalado SimApi. Los controladores ODBC se obtienen del fabricante de la base de datos. Descargue e instale la última versión disponible. Los controladores para Microsoft SQL Server suelen estar instalados en la mayoría de los equipos con Windows. Necesita los controladores que coincidan con la plataforma de SimApi. Por lo general, esto significa que se deben utilizar controladores x64 de 64 bits con Windows de 64 bits y SIMCA y SIMCA-online. Para las versiones anteriores de SIMCA de 32 bits, se requieren los controladores ODBC de 32 bits.
2.5 Autenticación de la base de datos
Las bases de datos requieren autenticación para que SimApi pueda acceder a los datos, de modo que solo pueda acceder a los datos que necesita. Los administradores de bases de datos limitan el acceso a la base de datos a un usuario específico utilizado por SimApi. La autenticación de usuarios se puede realizar de una de las tres formas siguientes con SimApi ODBC:
1. Especificar el nombre de usuario y la contraseña en el cuadro de diálogo de configuración de SimApi. Las credenciales se almacenan en formato cifrado en la PC.
2. Especificar el nombre de usuario y la contraseña en la conexión ODBC creada en Fuentes de datos ODBC (ver a continuación). Esto almacena las credenciales en Windows.
3. No especificar las credenciales explícitamente, sino utilizar la autenticación de Windows y la cuenta de usuario que ejecuta SimApi. Para SIMCA de escritorio, esto significa el usuario que ejecuta SIMCA, y para SIMCA en línea, esto significa la cuenta de servicio de SIMCA en línea configurada en los servicios de Windows.
El capítulo 3 muestra cómo configurar SimApi.
2.6 Visual C++ Redistribuible
Para utilizar SimApi en una computadora, es necesario tener instalado el siguiente software:
· Microsoft Visual C++ Redistributable para Visual Studio 2015-2022. Ya está disponible en todos los equipos con versiones recientes de SIMCA o SIMCA-online. Para ejecutar SimApi en otros contextos, la versión más reciente se encuentra en https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vcredist?view=msvc-170#visual-studio-2015-2017-2019-and-2022

Instalación y configuración
3 Instalación y configuración
La Guía de SimApi, que se puede descargar desde sartorius.com/umetrics-simapi, contiene información general sobre cómo instalar, configurar, solucionar problemas y probar SimApis. Puede consultar este documento para obtener más información sobre diversos temas. Para instalar y configurar SimApi, realice estos pasos:
1. Instale los controladores ODBC para su motor de base de datos (consulte el capítulo 2). 2. Configure una conexión de base de datos ODBC en Orígenes de datos ODBC de Windows y pruébela para asegurarse de que
funciona (pasos detallados en la siguiente sección). 3. Instale SimApi en la PC usando su programa de instalación: (para obtener instrucciones detalladas, consulte el capítulo 5 en
Guía de SimApi): a. Comience por desinstalar cualquier versión anterior en Aplicaciones y características de Windows antes de instalar la nueva. b. Descomprima el archivo zip file, consulte el archivo Info.txt de la versión file y la guía del usuario (que estás leyendo ahora…). c. Ejecuta el archivo exe de instalación file para instalar SimApi.
4. Si el Visual C++ Redistributable en la PC no está actualizado, instale la versión más reciente (consulte 2.6). 5. Agregue SimApi a SIMCA o SIMCA-online, como se describe en el capítulo 5 de la Guía de SimApi.
a. Cuando haga clic en el botón para configurar SimApi, aparecerá este cuadro de diálogo para proporcionar las credenciales que se utilizarán (obtenga información sobre las opciones en el capítulo anterior):
b. Todos los demás ajustes para este SimApi se realizan manualmente en un XML. file Utilizando un editor de texto. Más adelante en este capítulo se describe cómo configurar cada función.
6. Pruebe SimApi. Consulte el capítulo 6 de la Guía de SimApi.
3.1 Configuración de una conexión de origen de datos ODBC en Windows para su uso por SimApi
Para que SimApi funcione, es necesario configurar una conexión de origen de datos ODBC. Para ello, debe crearla en el panel de control de Orígenes de datos ODBC de Windows. Hay dos versiones de esta herramienta en Windows de 64 bits: una para aplicaciones de 32 bits y otra para aplicaciones de 64 bits. Utilice la que coincida con la SimApi que está utilizando, normalmente de 64 bits, ya que todas las versiones recientes de SIMCA-online y SIMCA son de 64 bits y requieren las variantes de SimApis de 64 bits. Esta captura de pantalla muestra esta aplicación en Windows. Hay tres conexiones de base de datos diferentes en esta aplicación.ampEl cuadro de diálogo siguiente muestra la primera página del asistente de configuración para la conexión de SQL Server al servidor se01wssuite01:

Instalación y configuración
Instrucciones de uso: · Le recomendamos que configure sus fuentes de datos como DSN del sistema, como se muestra en la captura de pantalla. Esto garantiza que estén disponibles para todos los usuarios de la PC, incluidos los servicios como SIMCA-online. · Haga clic en Agregar para agregar una nueva conexión. Seleccione el controlador que instaló como se describe en el capítulo anterior, que coincida con su base de datos, y haga clic en el asistente y configure los ajustes para conectarse a su servidor de base de datos. · Al final del asistente, puede probar el botón Probar fuente de datos para verificar la conectividad con la base de datos. Por supuesto, esto no funcionará si proporciona el nombre de usuario y la contraseña en el propio ODBC (consulte el capítulo anterior).
3.2 Selección entre dos formas de acceder a los datos del proceso
Hay dos formas de acceder a los datos del proceso en esta SimApi: 1. Modo directo. En este modo, se especifica el view nombres que deben exponerse a través de SimApi. Cada uno view se convierte en un nodo en SimApi y todas las columnas en un view convertirse tagsSe recomienda el modo directo ya que es relativamente sencillo de utilizar.

Instalación y configuración

2. Búsqueda View Modo. Este modo es más complejo y requiere un view En la base de datos llamada Búsqueda View. Este view define el tags que debería exponerse a través de SimApi, pero los datos se toman de fuentes adicionales relacionadas views especificado para cada fila de datos en la búsqueda view.
Obtenga más información sobre cómo configurar estas y todas las demás funciones de SimApi a continuación. Vuelva al capítulo 1.1 para leer más sobre las funciones de SimApi que está configurando a continuación.

3.3 Configuración XML file y registro file Ubicaciones
Una SimApi almacena su registro files en la carpeta oculta Program Data2: %programdata%UmetricsSimApi, donde %programdata% corresponde a la carpeta real de su computadora. El valor predeterminado es C:ProgramData.
Esto contiene la configuración de SimApi en un XML file llamado ODBCSimApi_ .xml. Puedes editarlo file manualmente utilizando un editor de texto como el Bloc de notas para realizar cambios.
Cada SimApi normalmente utiliza su propio registro file, que de manera similar al registro del servidor SIMCA-online file contendrá datos según la configuración del nivel de registro. file Es útil para solucionar problemas.
El registro file se llama ODBCSimApi_ .registro.
es el nombre de la instancia de SimApi que agregó en Opciones de servidor de SIMCA-online o Predeterminado para SIMCA de escritorio. Por ejemploampes decir, si agregó el nombre de la instancia “MyDB”, el registro file El nombre será ODBCSimApi_MyDB.log. Obtenga más información sobre esto en 4.2 4.3 en la Guía de SimApi.

3.4 Configuración de conexión global
La primera sección de la configuración XML file Es la configuración de conexión que describe cómo conectarse a su base de datos.

Los ajustes necesarios son:

· DSN

El nombre de la fuente de datos. Debe coincidir con el nombre del DSN del sistema en Windows.

Fuentes de datos ODBC que configuró anteriormente.

· SQLDialect

configúrelo para que coincida con el servidor de base de datos que está utilizando.

También es posible que necesite configurar los ajustes LeftPunctuation y RightPunctuation si utiliza palabras clave SQL reservadas como nombres de identificadores o utiliza espacios en los nombres de identificadores de su views/tablas/columnas en la base de datos.

Las demás configuraciones de conexión son opcionales.

Estas y todas las demás configuraciones también tienen descripciones en la tabla al final del capítulo.

Importante: Algunas bases de datos distinguen entre mayúsculas y minúsculas cuando se trata de nombres de bases de datos, tablas, views, columns so make sure you use the correct casing used in your database in the XML file.

3.5 Modo directo para continuo/proceso views
Cada fila en un modo directo view Es una observación.
Las columnas en el view representar variables:
· Debe haber una sola columna con datos de fecha y hora. Esta columna debe ser la clave principal y no puede contener valores nulos. El nombre de esta columna debe coincidir con el valor de TimeField configurado en la configuración. fileLos valores de esta columna son el tiempo stamp para las observaciones.
· La columna de fecha/hora debe ser del tipo de datos datetime o datetime2. · Las columnas restantes se expondrán a través de SimApi como tags con los mismos nombres que la columna
nombres. Los valores de estas columnas son datos de proceso.

2 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.

Instalación y configuración
· La escritura diferida es compatible con todos tagsSin embargo, se deben configurar los permisos correctos en la fuente de datos ODBC. Para poder volver a escribir los valores faltantes, se deben admitir valores nulos para la columna.
La configuración en el XML file Es muy sencillo: views, y modo directo viewes: –> ”/>
Nota: SimApi enumera las columnas solo al inicio. Esto significa que si se agregan nuevas columnas a un view Es necesario reiniciar SimApi para que pueda exponerlos.

Figura 1. Tabla de modo directo exampel.
3.6 Búsqueda View Modo para continuo/proceso views
Este view se puede utilizar en lugar de, o además de, el modo directo views como se describe arriba. La búsqueda View es una forma indirecta de especificar qué columnas de datos en otras views que deben compilarse y exponerse a través de SimApi. El otro viewLos datos son fuentes HDB (datos históricos) o fuentes PDB (datos actuales) respectivamente. La fuente PDB es opcional. Los datos expuestos por la búsqueda View SimApi lo presenta como un nodo que siempre se llama ODBCProcess:

Cada fila en la búsqueda view define uno tag para ser expuesto a través de SimApi y qué otros views para tomar los datos de eso tag. La búsqueda view Por lo tanto, contendrá muchas filas. También especifica si una tag es escribible, es decir, si SIMCA-online debería poder escribir valores nuevamente en este tag.

Puede haber varias fuentes PDB y varias fuentes HDB en uso desde la Búsqueda View. De esta forma, ODBC SimApi puede agregar datos de múltiples views en un nodo con tags que se exponen a través de SimApi.

La búsqueda view debe contener las siguientes columnas (denominadas Campos en la configuración) file):

· Nombre

El nombre de un tag (Clave principal, varchar, no nulo).

· PDB_Fuente

El nombre de la view que contiene los datos actuales para el tag (varchar). Si esto

Si la columna contiene un valor vacío, el programa leerá todos los datos de HDB_Source.

· Campo PDB

El nombre de la columna de la tag en la fuente del PDB view (varchar). Si el

Se omite el valor PDB_Source, esta columna no se leerá.

· Fuente HDB

El nombre de la view que contiene los datos históricos de la tag (varchar).

· Campo HDB

El nombre de la columna de la tag en la fuente HDB view (varchar).

Instalación y configuración

· Escribible

Si SIMCA-online debería poder escribir datos en este tag o no (bit).

Tenga en cuenta que para cada columna, la descripción anterior también indica qué filas deben ser la clave principal y el tipo de datos para cada columna.

Los nombres de las columnas son arbitrarios ya que los nombres se especifican en la configuración. file.

Figura 2. Example de una búsqueda view en forma de tabla de base de datos. En la captura de pantalla verá que se utilizan una fuente PDB y una fuente HDB. La columna Nombre determina la tag nombres que SimApi utilizará y, en este caso, las columnas _Field utilizan los mismos nombres de columna. Solo uno tag Es escribible.

3.6.1 AP views y HDB views
Cuando se utiliza una búsqueda View También necesitas al menos un HDB view. El views para los datos históricos (HDB) y el opcional views para los datos actuales PDB ambos tienen la misma estructura de datos (columnas).
Cada fila en el PDB o HDB views representa una observación con valores para cada uno tag en ese PDB/HDB view como se especifica en la búsqueda view.
Las diferencias entre PDB y HDB son:

· Un PDB view contiene solo una fila de datos para el tags especificado en la búsqueda view. También debería tener una hora.amp Columna para cuando fue actualizada por última vez.
· Una HDB view contiene varias filas de datos para el tags especificado en la tabla de búsqueda. Cada fila tiene una fecha y hora.amp que contiene el tiempo históricoamp para una observación particular.

El PDB y el HDB views debe tener las siguientes columnas,

· Fecha y hora

Para un PDB: La hora en que se actualizó la tabla por última vez (clave principal, fecha y hora o

datetime2, no nulo).

Para una HDB: El tiempo histórico para la tag valores (clave principal, fecha y hora o

datetime2, no nulo).

· [Nombre de la columna] Debe haber una columna para cada tag que se especificó en la tabla de búsqueda.

Contiene los datos para el tag en cada fila.

Tenga en cuenta que para cada columna, la descripción anterior también indica qué filas deben ser la clave principal y el tipo de datos para cada columna.
Los nombres de las columnas son arbitrarios en la base de datos ya que los nombres se especifican en la configuración. file.
Las siguientes columnas no son obligatorias, pero es útil agregarlas si se modelan lotes con múltiples fases y hay varias unidades en el proceso:

· Identificación del lote de unidad

Una columna por unidad que contiene el ID del lote dentro de una unidad determinada (varchar).

Este tag se puede utilizar en el identificador de lote tag campo para esa unidad en la página Condiciones de ejecución de

la configuración de este proyecto en SIMCA-online.

Instalación y configuración

· Identificación de fase

Una columna por unidad que contiene la información de fase de la unidad (int, float o varchar).

Este tag se puede utilizar en una expresión lógica en el campo Condición de ejecución de fase en la configuración de este

Proyecto en SIMCA-online.

El número máximo permitido de tags (columnas) es 255.

Figura 4. PDB exampel.
Figura 3. HDB exampel.
3.7 Nodo de lote
Un nodo de lote contiene metainformación sobre los lotes, como la hora de inicio, la hora de finalización y, opcionalmente, las condiciones del lote. SIMCA-online requiere un nodo de lote para analizar los datos del lote, pero se puede omitir para un proyecto continuo (no por lotes). El nombre de un nodo de lote que se ve desde SIMCA-online o SIMCA es el nombre original del nodo. view o tabla en la base de datos, en este ejemploampel “BatchData”:
Cada fila de un nodo de lote representa un lote.

Instalación y configuración

Un lote view Debe tener las siguientes columnas:

· ID de lote

El nombre del lote (clave principal, varchar, no nulo).

· Inicio por lotes

La hora de inicio del lote cuando ingresa por primera vez a todo el proceso (no cuando

comienza en una unidad (parte de) en el proceso) (datetime o datetime2, no nulo).

· Detención por lotes

El momento en que se completa todo el lote en el sistema (no en una unidad), nulo si

no completado (fecha y hora o fecha y hora2).

Tenga en cuenta que la columna BatchID debe ser la clave principal.

Además, puede haber columnas opcionales como las siguientes, para cada variable de condición de lote:

· [Nombre de la condición del lote]

Una columna para cada condición de lote. El nombre de la columna será

utilizado como tag nombre. (float para valores numéricos o varchar para texto como el id de configuración).

· Identificación de unidad

El nombre de la unidad a la que está asociado el lote.

(varchar).

Los nombres de los nodos y columnas del lote son arbitrarios en la base de datos, ya que los nombres se especifican en la configuración. file.

Figura 5. Nodo de lote example con dos condiciones de lote (bc1 y bc2) y una columna UnitID.

3.8 Datos por lotes Views
Datos de cada lote view Debe tener estas tres columnas (las columnas adicionales serán ignoradas):

· ID de lote · Tag nombre · Valor
texto o float3).

nombre del lote (varchar, no nulo) nombre de la variable de condición del lote (varchar, no nulo) valor de la variable de condición del lote (float para valores numéricos o varchar para

La combinación de BatchID y Tag el nombre debe ser la clave principal (a menos que desee utilizar la función de instancia de datos de lotes múltiples).

Datos de cada lote view se expone como un nodo por SimApi. El nombre del nodo es el view nombre en la base de datos. El view El nombre y los nombres de las columnas se configuran en la configuración XML file utilizando los atributos de un único BatchDataView elemento como este:

3 Al utilizar una columna de texto varchar, puede almacenar texto (datos para variables cualitativas en un proyecto SIMCA). Sin embargo, también puede almacenar números numéricos en formato de texto y SimApi los convertirá en números. De esta manera, puede tener algunos tags que son numéricos y algunos que contienen texto.

Instalación y configuración

<BatchDataView ViewNombre=”Base de datosViewO TableName” BatchIDColumn=”ID de lote” TagNombreColumna=”Tag nombre” ValueColumn="Valor" />
Tenga en cuenta que los valores utilizados aquí coinciden con la tabla de la Figura 5. Agregue datos de varios lotes views agregando más BatchDataView elementos.

3.8.1 Instancia de datos de lote sintético tags
Para configurar la instancia de datos por lotes opcional tags, agrega los atributos NumSyntheticBatchTags y TimeColumn a BatchDataView elemento:
<BatchDataView ViewNombre=”Base de datosViewO TableName” BatchIDColumn=”ID de lote” TagNombreColumna=”Tag nombre” ValueColumn=”Valor” TimeColumn=”TimeColumn” NumSyntheticBatchTags=”3″ />
TimeColumn es el nombre de la columna de tiempo en su base de datos viewEsta columna debe proporcionarse para la instancia de datos por lotes tags.
Valor permitido para NumSyntheticBatchTags son valores numéricos entre 1 y 10. Esto controla cuántas instancias sintéticas tags se crean de verdad tag. Por ejemploample, para el tag “tag" nuevo tags “tag_1”, “tag_2”, … “tag_N” se creará hasta que N= NumSyntheticBatchTags.

3.8.2 Identificación del lote del proceso sintético tags filtrado por valores de columna
Para configurar el filtro de identificación de lote opcional tags que se puede utilizar para el modo de recuperación de datos continuos, agregue los atributos FilterColumns y TimeColumn a BatchDataView elemento:
<BatchDataView ViewNombre=”Base de datosViewO TableName” BatchIDColumn=”ID de lote” TagNombreColumna=”Tag nombre” ValueColumn=”Valor” FilterColumns=”Columna1|Columna2″ TimeColumn=”ColumnaTiempo”/>
FilterColumns debe ser uno o más nombres de columnas en su base de datos view. Si se utilizan varios nombres de columnas, sepárelos con el carácter de barra vertical (|).
TimeColumn debe ser el nombre de la columna de tiempo en su base de datos viewEsta columna debe proporcionarse para la instancia de datos por lotes tags.

3.9 Nodos discretos
Los nodos discretos opcionales contienen mediciones de datos discretos. Cada fila de un nodo discreto representa una medición para un lote y tag en un momento dado.

Un nodo discreto debe tener las siguientes columnas:

· ID de lote · TagNombre · Hora · Valor

El nombre del lote (varchar, no null). El nombre del tag (varchar, no nulo). El momento en que se sampSe tomó el valor (datetime o datetime2, no nulo). El valor de la medición (float). Los datos discretos no pueden ser datos de cadena.

Tenga en cuenta que la combinación de BatchID+TagNombre+Hora debe ser la clave principal.

Cada nodo discreto configurado se expone como un nodo por SimApi. El nombre del nodo es el view nombre en la base de datos, a menos que se anule. El nombre del nodo, view nombre, búsqueda view, y los nombres de las columnas se configuran en la configuración XML file utilizando los atributos de un elemento DiscreteNode de esta manera:

<DiscreteNode NodeName=”ODBCDiscrete” ViewNombre=”Discreto” TagBuscarView=”DiscretoTags” BatchIDField=”ID de lote” TimeField=”Hora” TagNombreCampo=”TagNombre” ValueField="Valor"/>

El ejemplo anteriorample expone un nodo llamado ODBCDiscrete por SimApi, enumera el tags utilizando el discretoTags mesa/viewLos datos se leen de la tabla discreta/view utilizando las columnas configuradas.

Instalación y configuración
Los nombres del nodo discreto y sus columnas son arbitrarios en la base de datos ya que los nombres se especifican en la configuración. file.
Figura 6. Nodo discreto example con dos tags sampSe llevó a cabo tres veces (a intervalos de aproximadamente 24 horas) por lote.
3.9.1 Discreto Tag Definición View
Este opcional view SimApi lo utiliza para enumerar los datos discretos. tags que debería estar disponible a través de SimApi. Esto sucede al iniciar SimApi. Es posible que desee utilizar esto view para optimizar el rendimiento al cargar SimApi o si desea controlar qué tags se exponen desde SimApi. Por ejemplo, si desea exponer tags que aún no tiene ninguna medición cuando se inicia SimApi.
Figura 7. Discreción simple tag buscar view que utiliza la tabla discreta.

Instalación y configuración
3.9.2 Datos discretos vistos por SIMCA-online
A continuación se muestra cómo se muestran los datos discretos en la Figura 6. Nodo discreto example con dos tags sampSe realizó tres veces (a intervalos de aproximadamente 24 horas) por lote. Figura 6 Figura 2 ¡Error! No se encontró la fuente de referencia. Se buscará en SIMCAonline cuando se combine con los lotes de la Figura 5.
Figura 8. Datos discretos vistos por SIMCA-online. Nótese que la antigüedad del lote generado tags representar la edad del lote para cada observación/esampel.
3.10 Algunas notas sobre la función de escritura en línea de SIMCA
La escritura en modo back en SIMCA-online se puede utilizar para escribir datos desde SIMCA-online en la fuente de datos ODBC. Se admite la escritura de datos de procesos continuos (desde configuraciones continuas, el nivel de evolución de lotes o desde Control Advisor) y datos de lotes (desde el nivel de lotes). No se recomienda escribir en modo back en los mismos nodos que se están utilizando para leer datos, ya que esto intentaría agregar filas duplicadas con las mismas claves primarias en la base de datos. viewDebido a las claves principales que recomendamos en las columnas de fecha/hora e ID de lote (ver arriba), cree una o más columnas de Modo directo views para datos continuos/de evolución, o nodos de lote para datos de lote que se utilizarán para la escritura diferida. El motivo de este problema es que ODBC SimApi utiliza instrucciones SQL INSERT para agregar una nueva fila de datos para cada observación o para cada lote a nivel de lote.
· Para los datos continuos, la hora de la observación se escribe junto con los valores de SIMCAonline.
· Para los datos de lotes, el ID del lote se vuelve a escribir junto con los valores de SIMCA-online. · Si se vuelven a escribir los valores faltantes, se escribirán como nulos, por lo que la base de datos debe admitir valores nulos.
Para que esto funcione, ya que se vuelve a escribir el momento de una observación o el ID de lote de un lote, esto violaría la restricción de clave principal en las bases de datos si ya estuvieran presentes los mismos valores (como lo estarían si los datos se leyeran de los mismos nodos). Aparte de estas diferencias de clave principal, se aplica el mismo esquema de base de datos a los nodos para la reescritura (consulte más arriba para obtener más información):

Instalación y configuración

· Debe existir una columna de fecha y hora para los nodos continuos y una columna de identificación de lote para los nodos de lote. · Agregue una columna de datos para cada uno tag que debería estar disponible para escritura diferida. Utilice el tipo de datos flotante para
datos numéricos y varchar para datos de texto (como cuando se vuelve a escribir el ID de configuración de una configuración). Por ejemploampes decir, si planea volver a escribir 20 vectores de datos diferentes desde SIMCA-online, debe agregar 20 columnas de datos a la base de datos view· Las columnas deben permitir valores nulos para poder escribir los valores faltantes

3.11 Configuración XML File
Esta tabla enumera todas las configuraciones en la configuración XML fileUtilice esta información y las descripciones anteriores para configurar SimApi.

Configuración específica de la conexión

Explicación

DSN

Nombre de la fuente de datos tal como se configuró en el panel de control del Administrador ODBC de Windows.

Dialecto SQL

El dialecto SQL que se utilizará. Uno de estos valores: standard, postgresql, db2, mssql, mysql, oracle, access, denodo. Si se deja en blanco, se utilizará el estándar, pero el valor predeterminado para un nuevo XML esfile es mssql.

Cartas credenciales

Almacene el nombre de usuario y la contraseña de ODBC en formato cifrado. Utilice el botón Configurar para especificar el nombre de usuario y la contraseña.

Tiempo de espera de consulta

El tiempo que transcurre antes de que una consulta o conexión a la base de datos se agote y falle.

Esquema de base de datos

El esquema de la base de datos (si corresponde). Un esquema de base de datos es una forma de agrupar de forma lógica objetos como tablas, viewPiense en un esquema como un contenedor de objetos. Puede asignar permisos de inicio de sesión de usuario a un solo esquema para que el usuario solo pueda acceder a los objetos a los que está autorizado a acceder. Los esquemas se pueden crear y modificar en una base de datos, y se puede otorgar acceso a los usuarios a un esquema. Cualquier usuario puede poseer un esquema y la propiedad del esquema es transferible.

Puntuación izquierda

Delimitador izquierdo específico del dialecto SQL que se utiliza para separar identificadores de otros comandos SQL. El valor predeterminado es vacío, lo que significa que no se utiliza puntuación izquierda. Debe especificar un valor que no esté vacío si los identificadores de la base de datos utilizan espacios o palabras clave reservadas de SQL. Para SQL Server o Access, utilice “[“, pero para Oracle y otras bases de datos que utilizan el estándar SQL, debe establecer esta configuración en “"” (esta es la secuencia de escape XML para las comillas dobles “).

Puntuación correcta

Delimitador derecho específico del dialecto SQL que se utiliza para separar identificadores de comandos SQL. Para SQL Server o Access, se utiliza “]”, pero para Oracle y otras bases de datos que utilizan el estándar SQL, se debe establecer esta configuración en “"”, como en el caso de LeftPunctuation mencionado anteriormente.

Terminador de declaración de selección

Específico del dialecto SQL. Carácter que se utiliza para finalizar las sentencias de selección. Para algunos dialectos y versiones, es necesario configurarlo como una cadena vacía “”. El valor predeterminado es “;”.

Tamaño del grupo de conexiones de la base de datos

La cantidad máxima de conexiones simultáneas a la base de datos que se permiten. El valor predeterminado es 10. Esta configuración puede mejorar el rendimiento al permitir que más de un subproceso acceda simultáneamente a la base de datos. Obtenga más información en el capítulo 1.

Instalación y configuración

Configuraciones específicas de la base de datos

Usar hora local

Especifica si las fechas se almacenan en la base de datos como hora local o UTC. El valor predeterminado es “1”, lo que significa que se utiliza la hora local.

Configuraciones específicas del modo directo

Tablas

El nombre de la views que contiene datos continuos/de proceso. Múltiples viewLos s se pueden especificar separando sus nombres con un carácter de barra vertical (|). Por ejemploample:Tabla1|Tabla2|Tabla3|View1. El nombre del TimeField debe ser idéntico en todos views.

Buscar view configuraciones específicas

Tabla de consulta

El nombre de la búsqueda view o mesa.

TagNombreCampo

El nombre de la columna donde se encuentra el tag Se dan nombres.

Campo de tabla PDBT

El nombre de una columna en la búsqueda viewPara cada fila, esta columna contiene el nombre de un PDB. view. El nombre de un view con datos PDB. Puede dejarse en blanco; en ese caso, se utilizará la fila más reciente de HDB para los datos actuales.

APTagCampo

El nombre de la columna en la tabla PDB donde se encuentran los datos para el tag se puede encontrar (no se utiliza si se omite PDBTableField).

Campo de tabla HDB

El nombre de una columna en la búsqueda viewPara cada fila, esta columna contiene el nombre de una HDB. view.

Junta de Desarrollo de la Alta DirecciónTagCampo

El nombre de una columna en la búsqueda viewPara cada fila, esta columna contiene el nombre de un tag En la HDB view.

Campo escribible

El nombre de la columna que indica si el tag Es escribible o no.

Modo directo y HDB/PDB view configuraciones específicas

Campo de tiempo

El nombre de la columna de fecha/hora en Continuo/Proceso View y el PDB o HDBviews (o tablas).

Configuración específica del nodo de lote

Tabla de lotes

El nombre de la view o tabla que contiene los datos del lote. Lotes múltiples view se pueden especificar separando sus nombres con un carácter de barra vertical (|). Por ejemploample: BT1|BT2|BT3. Las siguientes columnas deben ser idénticas en todas views.

Campo ID de lote

El nombre de la columna del ID del lote en el nodo del lote.

Campo de tiempo de inicio

El nombre de la columna de la hora de inicio del lote.

Campo de tiempo de parada

El nombre de la columna de la hora de detención del lote.

Campo de unidad de ID de lote

El nombre de la columna del ID de unidad en el nodo de lote. Este campo se puede utilizar para generar un proceso de ID de lote sintético tags filtrado por id de unidad.

Nodo de lote con soporte de filtrado Uno elemento con los siguientes atributos que controlan

ajustes

la configuración para el nodo de lote filtrado sintético.

Instalación y configuración

ViewNombre Columna BatchID Columna StartTime Columna StopTime Columna FilterColumn
Valores de filtro
Datos del lote view Configuración Configuración específica del nodo discreto
Nombre del nodo ViewNombre TagBuscarView
Campo ID de lote Campo de tiempo TagNombreCampoValorCampoRegistro file Registro de configuraciones específicasFileTamaño LogLevel

El nombre de la view o tabla que contiene los datos del lote.
El nombre de la columna del ID del lote.
El nombre de la columna de la hora de inicio del lote.
El nombre de la columna de la hora de detención del lote.
El nombre de la columna que contiene los valores de filtro en el nodo de lote. Esta configuración se puede dejar vacía si no necesita la función de filtrado.
Los valores que se deben utilizar para filtrar lotes. Los valores de filtro múltiples se separan con el carácter de barra vertical (|). Déjelo vacío si no necesita filtrar. Por ejemploample: FilterValue1| FilterValue2| FilterValue3. Este es un ejemploampEjemplo de cómo podría verse en la configuración. file: ViewNombre=”NodoLote” ColumnaIDLote=”IDLote” ColumnaHoraInicio=”HoraInicio” ColumnaHoraDeFin=”HoraDeFin” ColumnaFiltro=”Unidad ValoresFiltro=”ValorFiltro1|ValorFiltro2″ /> Múltiple Se admiten los elementos. Tenga en cuenta que puede tener diferentes nombres de columnas entre los nodos de lote.
Almacenado en uno o másView> elementos. Ver 3.8 Datos de lotes Views.
Un elemento para cada nodo discreto con los siguientes atributos. Véase 3.9 Discreto .
El nombre del nodo tal como lo expondrá SimApi. Si se deja en blanco, el valor del nodo ViewSe utilizará el nombre.
El nombre de la view/tabla que contiene los datos discretos. Si se deja en blanco, el nodo se desactiva.
El nombre de la view/tabla que define lo discreto tags para usar. Si se deja en blanco, ViewEl nombre se analizará al inicio para enumerar todos tags allá.
El nombre de la columna de la identidad del lote que se midió.
El nombre de la columna de la hora de la medición.
El nombre de la columna de la tag Esto fue medido.
El nombre de la columna del valor de la medición.
El tamaño máximo permitido del registro file Antes de la file está truncado.
Cuanto mayor sea el valor, más información se imprimirá en el registro. fileEl valor máximo es 4 y el valor mínimo es 0. (0=Crítico, 1=Error, 2=Advertencia, 3=Información, 4=Depuración).

Apoyo
4 Soporte
Esta SimApi fue desarrollada por Sartorius Data Analytics. Para obtener ayuda, visite sartorius.com/umetrics-support.

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 figuras contenidas en estas instrucciones corresponden a la fecha de la versión indicada a continuación. Sartorius se reserva el derecho de realizar cambios en la tecnología, las características, las especificaciones y el diseño del equipo sin previo aviso. Para facilitar la lectura de estas instrucciones se utilizan formas masculinas o femeninas que 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 que vaya más allá de los límites de la ley de derechos de autor sin nuestra autorización. Esto se aplica en particular a la reimpresión, traducción y edición, independientemente del tipo de medio utilizado.

Apoyo