Procedimiento De Control De Documentos
Total Page:16
File Type:pdf, Size:1020Kb
ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 1 de 38
MANUAL TÉCNICO INTERFAZ SILAB - PI
RELACIÓN DE VERSIONES
VERSIÓN DESCRIPCIÓN FECHA 1 (Versión inicial) No se recibió.
Se actualiza la aplicación para poner en fucnionamiento la alta disponibildad del 2 servidor PI después de la Migración. 26 Marzo de 2009
DEPENDENCIA RESPONSABLE REVISÓ APROBÓ ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 2 de 38
ELABORÓ: Víctor H. González Jhon James Rubio Olaya José Bismer Carvajal Alzate Líder Técnico Proyecto GRB Líder Técnico GRB – Proyecto Fábrica de Software del UT DOWNSTREAM Downstream ECOPETROL ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 3 de 38
TABLA DE CONTENIDO
Contenido
1. Introducción
La interfaz Silab - PI fue creada con el fin de llevar a la BDTR (Base de Datos en Tiempo Real) PI los datos de las muestras más representativas realizadas en el laboratorio (Base de Datos Silab), estas muestras son definidas por cada uno de los Ingenieros de Proceso de cada Planta y con la ayuda del administrador funcional del sistema Silab se determinan los datos correspondientes de Muestra, Componente y Unidad.
2. Objetivo
El presente documento pretende ilustrar las especificaciones técnicas generales que se ejecutaron como base para adecuación de las políticas de seguridad establecidas para la aplicación PI, referente a los temas de contingencia del servidor y trasferencia de archivos.
3. Alcance
Este documento contiene una descripción técnica que permite asegurar la correcta configuración de los diferentes componentes requeridos para la ejecución de la Interfaz, así como, una descripción técnica del comportamiento de la Interfaz. El presente documento no está completo ya que no fue proporcionado el manual técnico inicial, por lo cual, este documento solo hace referencia a cada uno de los diferentes componentes del aplicativo, pero si se hace énfasis en explicar detalladamente los nuevos componentes adicionados al mismo.
4. Descripción del Proceso Actual ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 4 de 38
Actualmente la interfaz Silab – PI al ejecutarse realiza un conjunto de consultas a la base de datos Silab, y posteriormente escribe directamente en el servidor PI los valores correspondientes a cada tagPI, encontrados en Silab.
5. Descripción de la Solución
5.1. Alta Disponibilidad
El objetivo de la fase II de la migración del servidor PI, es la puesta en funcionamiento un esquema de alta disponibilidad, lo que indica que se van a tener dos servidores PI trabajando al ismo tiempo, y en el momento que uno de ellos deje de funcionar, el servicio se mantiene disponible con el segundo. Este esquema supone que todas las interfaces que actualmente están enviando datos a PI, tengan que hacerlo a los dos servidores simultáneamente.
Para lograr este objetivo, se plantea cambiar el funcionamiento actual de la interfaz en la sección de escribir en PI, en donde será reemplazado el proceso de escritura directa en el servidor PI por la generación de archivos planos con la información correspondiente, que serán copiados posteriormente a la ruta de archivos de la interfaz BatchFl.
Los cambios realizados a la interfaz son los siguientes: Generación de archivos planos. Estos archivos planos deben tener la estructura correspondiente para que la interfaz pueda procesarlos, cada valor de un tag debe ser una línea en el archivo y debe seguir la siguiente estructura. Nombre Tag, fecha, valor
Donde: Nombre Tag, es el nombre completo del tag PI. Fecha: es una fecha válida con el formato dd-mmm-yyyy HH:mm:ss Valor: es un valor correspondiente al tipo de datos del tag PI. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 5 de 38
El separador debe ser una coma, o el que se haya defindo en la línea de comando de arranque de la interfaz. Copiar el archivo generado al directorio de proceso de la Interfaz BatchFl. Por directriz de la auditoría de controles SOX, se requiere la utilización de transferencia de archivos de forma segura, por lo que no se debe utilizar ni carpetas compartidas ni transferencias por conexiones FTP.
5.2. Instalaciones previas
Antes de realizar la ejecución de la Interfaz se requiere la ejecución de los siguientes pasos:
1.1.1. Servidor SSH (Secure Shell)
Para dar cumplimiento con el requerimiento de transferencia segura de archivos, se optó por realizar conexiones SFTP (Secure FTP), para ello se hace necesario la instalación y configuración de un servidor SSH en la misma máquina en la cual va a correr la interfaz PI- batchfl.
El software que actualmente se está utilizado en Soporte para prestar este servicio es el FREESSH, por lo cual se recomienda utilizar este mismo software para mantener un estándar en la instalación, configuración y administración de dicho servicio.
1.1.1.1. Instalación de FREESSH
Este servidor se instalará para atender la conectividad de los clientes.
Los pasos de instalación son los siguientes y configuración son los siguientes:
Instalación:
1. Ejecutar el instalador freeSSHd.exe ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 6 de 38
2. En la ruta de Instalación se colocará la ruta D:\FreeSSHd
3. En la ventana siguiente seleccionar instalación completa y clic en Siguiente (Next) ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 7 de 38
4. Indicar el nombre del folder en el menú de inicio que será creado para acceso a la aplicación. Se puede dejar el valor por defecto freeSSHd, clic en Siguiente (Next) ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 8 de 38
5. Indicar si se requiere crear un icono en el escritorio de Windows, clic en Siguiente (Next). ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 9 de 38
6. Después del proceso de instalación aparecerá una ventana indicando que existen otros productos que pueden ser instalados como complementos de la aplicación, dar clic en Cerrar (Close).
7. Al final del proceso de instalación en el cuadro de dialogo “Setup”, donde aparece el mensaje “Private Key Should be crate Should I do it now?”, se le debe dar clic en “Si”.
8. Posteriormente aparece un cuadro de diálogo consultan si se desea que la aplicación sea configurada como un servicio de Windows, se recomienda dar SI para que el servicio siempre esté disponible, aún después de reiniciar el equipo. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 10 de 38
Configuración:
1. Cuando el servicio está arriba, en la barra inferior derecha de la pantalla, en la sección de herramientas activas, aparece el icono de la aplicación.
haga clic con el botón secundario sobre este icono y elija la opción Settings.
2. En la pestaña Server status.
Se debe activar el servicio SSH (no el TELNET). ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 11 de 38
3. En la pestaña SSH configurar el número de usuarios a 10. Se usará el puerto 22 (si este está bloqueado, utilizar el 23 o el que indique el adminstrador de servidores) y en el Listener Address se especifica la dirección IP de red tomada por el equipo. Estos datos deben ser actualizados en el archivo .ini de la Interfaz. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 12 de 38
4. En la pestaña “User”, se agregará un usuario. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 13 de 38
Crear el usuario batchfl, con Login: pibatchfl, Authorization: Pasword stored as SHA1 hash. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 14 de 38
En los privilegios de usuarios se escogen SFTP y Tunneling, (no seleccionar Shell). ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 15 de 38
Estos datos deben ser actualizados en el archivo .ini de la Interfaz ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 16 de 38
5. En la pestaña “Authomatic Updates” deshabilitar “Check for new Version…”. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 17 de 38
6. En la pestaña SFTP, escoger la ruta donde se deben copiar los archivos, como lo muestra las imágenes siguientes. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 18 de 38 ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 19 de 38
1.1.2. Cliente SFTP (Secure FTP)
Para dar cumplimiento con el requerimiento de transferencia segura de archivos, se optó por realizar conexiones SFTP, para ello se hace necesario la instalación y configuración de un cliente SFTP en la misma máquina en la cual va a correr la interfaz Silab - PI.
El software que actualmente ya se está utilizado en Soporte para prestar este servicio es el WinSCP, por lo cual, se recomienda utilizar este mismo software para mantener un estándar en la instalación, configuración y administración de dicho servicio.
Winscp es un cliente SFTP and FTP libre para Windows. Su principal función es la transferencia de archivos seguro entre un computador local y un computador remoto. WinSCP usa Secure Shell (SSH) y suporta, en adición a Secure FTP, también legado de protocolo SCP.
1.1.2.1. Instalación de WinScp
Esta aplicación se instalará para realizar la conectividad desde los clientes hacia el servidor SSH.
Para realizar la instalación de esta aplicación, realice los siguientes pasos:
1. Ejecutar el archivo winscp418setup.exe o el de la versión que se tenga del mismo software. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 20 de 38
Haga clien Next
2. En la pantalla de aceptar la licencia de clic en Next. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 21 de 38
3. Especifique la ruta de instalación de la aplicación, se recomienda instalar en la carpeta WinSCP3 directamente en el disco duro “C:\ WinSCP3”, esto con el fin de evitar inconvenientes al armar la ruta de ejecución cuando esta tiene espacios en blanco. (Esta ruta debe ser es pecificada en en la clave pathCltSftp de la sección BATCHFL) ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 22 de 38
4. En la pantalla siguiente seleccione instalación completa, y clic en Next. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 23 de 38
5. En la ventana de folder menú de inicio deje el nombre por defecto, clic en Next.
6. Deje la información por defecto y haga clic en Next ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 24 de 38
7. En la pantalla de settings, se especifica el tipo de interfaz deseada, esto no es importante para el funcionamiento de la interfaz, déjela por defecto en Norton Commander interface y clic en Next. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 25 de 38
8. Confirme para iniciar la instalación dando clic en Next. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 26 de 38
9. Se visualiza el avance de la instalación. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 27 de 38
10. Se obtiene ka confirmación de instalación exitosa, de clic en Finish. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 28 de 38
11. Para probar la conexión con el servidor SSH, lance la aplicación cliente y realice una conexión al servidor con su correspondiente usuario y contraseña, como se observa en el siguiente ejemplo: ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 29 de 38
5.3. Configuración archivo .ini
El archivo silabpi.ini es un archivo de configuración de datos iniciales requeridos por la aplicación, es de vital importancia la correcta configuración del mismo para lograr el objetivo requerido.
5.3.1. Sección [IDENTIFICACION]
Permite identificar la Interfaz. nombre=
5.3.2. Sección [DISPARO]
Permite identificar cada ejecución de la Interfaz. Intervalo= bloqueado= bloqueado_anterior= espera= fecha_bloqueo= ultimo_disparo=
5.3.3. Sección [CONEXION] ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 30 de 38
Permite especificar los datos necesarios de conexión a los servidores. IpSILAB= IpPI= Servidor= Usuario= Password=
5.3.4. Sección [BATCHFL]
Se adiciona esta sección con sus respectivas claves para la transferencia de archivos. enable=SI type=sftp types=ftp;sftp port=22 serverFtp=146.1.200.237 userFtp=batchfl pwdFtp=pibatchfl pathSftp= pathFtp=/datos1/PI/interfaces/batchfl/data pathNoFtp=\\ris83\Contrato Mtto SON\Contrato 5203380\07-Migración PI\Planos\ pathCltSftp="C:\Archivos de programa\WinSCP\WinSCP.com"
Donde:
enable: SI=Indica que la interfaz va a utilizar transferencia de archivos y no escritura directa a PI; NO=indica que va a realizar escritura directa a PI. type: Indica el tipo de transferencia de archivos que la interfaz va a utilizar, actualmente hay tres tipo, ftp, sftp y en cualquier otro caso, utiliza transferencia a través del directorio compartido. types: es solo informativo para la clave type port: Especifica el puerto que va a utilizar en la transferencia de tipo SFTP, definido en la configuración del servidor SSH. serverFtp: ip o nombre del servidor SSH (donde está también la Interfaz PI-Batchfl), esta IP corresponde a la IP configurada en el servidor SSH. userFtp: Usuario configurado en el servidor SSH. pwdFtp: Password del userFtp especificado en el servidor SSH. pathSftp: ruta en la cual se deben dejar los archivos en el servidor SSH, si se dejó esta misma ruta como la ruta de ingreso, dejar vacío. pathFtp: ruta en la cual se deben dejar los archivos en el servidor ftp, si se dejó esta misma ruta como la ruta de ingreso, dejar vacío. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 31 de 38
pathNoFtp: ruta utilizada cuando la transferencia se hace a través de directorio compartido o en la misma máquina a otra carpeta, es decir, la Interfaz PI-Batchfl está en la misma máquina de la interfaz Silab-PI. pathCltSftp: ruta de instalación de la aplicación cliente SFTP WinScp, esta ruta debe estar entre comillas dobles si en la ruta hay espacios en blanco.
5.3.5. Sección [CONSULTA]
Permite especificar los datos complementarios para la consulta a la BD Silab.
GrabarNulos= Filtro= Condition= Status= DiasARevisar= ActualizarPI= Intervalo=
5.3.6. Sección [ESTADO]
Permite especificar los datos correspondientes al estado de la Interfaz.
n= Sistema_1= Sistema_2= Sistema_3= 5.3.7. Sección [ESTADOANTERIOR]
Permite especificar los datos correspondientes al estado anterior de la Interfaz.
Sistema_1= Sistema_2= Sistema_3=
5.3.8. Sección [SUBSISTEMAS]
Permite especificar los datos correspondientes a los subsitemas que interactúan con la Interfaz.
Sistema_1= Sistema_2= ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 32 de 38
Sistema_3=
5.3.9. Sección [MENSAJE_ERROR]
Permite consultar los mensajes previos generados a los sitemas de la Interfaz.
Sistema_1= Sistema_2= Sistema_3=
5.3.10. Sección [MAIL]
Permite especificar el envío de notificaciones vía e-mail.
activado= destinatarios=
5.3.11. Sección [avantel]
Permite especificar el envío de notificaciones vía avantel.
activado= codigo=
5.3.12. Sección [RADIO]
activado= destinatario= mail_operadora=
5.3.13. Sección [WINPOPUP]
Permite especificar el envío de notificaciones vía win Pop-up.
activado= ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 33 de 38
destino=
5.3.14. Sección [ADMINISTRADOR]
Permite especificar los datos del administrador de la interfaz para el envío de notificaciones.
mail= avantel= winpopup=
5.3.15. Sección [POSITION]
Permite especificar las coordenadas en las que estará ubicado el formulario de la interfaz en la pantalla.
Top= Left=
5.4. Módulos de la aplicación
A continuación se describen los módulos que son utilizados dentro de la Interfaz Silab-PI.
5.4.1. Módulo Mod_Encriptar (Encriptar.bas)
Función Encriptar; Utilizada para encriptar o des encriptar un Password. 5.4.2. Módulo Mod_Ini (Ini.bas)
Función WriteSectionIni; Utilizada para escribir una nueva sección en el .ini. Función WriteProfileIni; Utilizada para escribir un string en el .ini. Función GetProfileIni; Utilizado para leer un string de un .ini. 5.4.3. Módulo Mod_Log (Log.bas)
Función EscribirLog; Utilizado para escribir una línea en el archivo log. 5.4.4. Módulo Mod_PiApi (piapi32.bas) ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 34 de 38
Módulo con las funciones API para interactuar con PI. 5.4.5. Módulo Mod_Ping (Ping.bas)
Función ValidarIP; Utilizada para verificar que los servidores estén en línea. Función GetStatusCode; Obtiene es estado del servidor Función HiByte; Función LoByte; Función Ping; Utilizada para validar ping al servidor. Función AddressStringToLong; Convierte una dirección IP string a Long. Función SocketsCleanup; Función SocketsInitialize;
5.4.6. Módulo Mod_SilabPi
Procedimiento MainMonitoreo; Procedimiento principal de la Interfaz. Es el encargado de ralizar las consultas a la BD Silab, y de acuerdo a unas validaciones adicionales, llama a los procedimientos correspondientes para la interacción con PI.
Procedimiento RegistraError; Utilizado para escribir en archivos, los errores en la ejecución de la Interfaz. 5.4.7. Módulo modFtp
Private Declare Sub sleep Lib "kernel32" Alias "Sleep" (ByVal dwMilliseconds As Long); declaración necesaria para poder utilizar la función sleep, esta función se utiliza para hacer una pausa en milisegundos en la ejecución de la Interfaz. Función ConectarFtp; Utilizado para realizar la conexión al servidor vía FTP. Procedimiento Desconectar; Utilizado para realizar la desconexión al servidor FTP. Procedimiento SubirArchivo; Utilizado para subir un archivo al servidor vía FTP. Función sendFileFtp; realiza todo el proceso FTP. Procedimiento Class_Terminate; Cierra las sesiones y las conexiones. Función getScriptSftp; actualiza o crea el archivo script.txt con los comando sftp a ejecutar. Procedimiento putFile; valida el tipo de conexión a realizar, si es ftp inicia la ejecución de los procesos correspondientes a lograr dicha conexión y trasferencia de archivo. Si no es FTP, valida si es SFTP, para el cual ejecuta el procedimiento getScriptSftp (genera el archivo plano script.txt con el script a ejecutar vía SFTP), realiza la ejución de la Shell que utiliza el cliente WinSCP para ejecutar el archivo script generado script.txt, si la conexión es correcta renombra el archivo adicionando .move al nombre del archivo. Si tampoco es SFTP, realiza copia del archivo vía ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 35 de 38
carpeta compartida, o en su propio sistema de archivos (cuando la interfaz Silab-PI está corriendo en la misma máquina donde está instalada la Interfaz PI-BatchFl)
5.4.8. Módulo modMonitor (Monitor.bas)
Procedimiento Mntor_Load; Función Mntor_VerifyFile; Procedimiento Mntor_UnLoad; Función Mntor_Message; Función Mntor_Error; 5.4.9. Módulo modNotify (Notify.bas)
Procedimiento EnviarMensajeAvantel; Envío de mensajes por avantel. Función EnviarMensajeAvantelAux; Función TransformarParametro; Función EnviarMailOutlook; Envío de notificciones vía e-mail. Función SendToWinPopUp; Envío de notificciones vía Win Pop-up. 5.4.10. Módulo modPIcomplements (PIcomplement.bas)
Procedimiento PI_Init; Realiza llamado a la función de conexión al servidor PI. Procedimiento PI_SetIni; Función PI_SetLog; Función PI_ValidarIP; Llama al procedimiento validar IP para el servidor PI. Función PI_Connect; Realiza la conexión al servidor PI por defecto. Función connectPI; Realiza la conexión a un servidor PI específico. Función disconnectPI; Realiza la desconexión de todos los servidor PI. Función registerApp; Registra la aplicación para poder realizar conexiones a cualquier servidor PI. Función PI_WriteRouter; Valida el tipo de escritura en PI, batchfl o directa. Función PI_Write; Realiza escritura directa al servidor PI, utilizando el PIAPI. Función PI_LastError; Función PI_Error; Control de errores y notificaciones. Función PI_PrimerEventoViola; Consulta el PI el primer evento que viola una guía o ventana, por medio de una expresión PI recibida. Función PI_TraerCorrida; Trae el valor de un tag PI para una determinada fecha, útil para controlar los tags de Corridas. Función PI_TiempoFuera; Calcula el tiempo que una expresión PI se cumple, durante un periodo de tiempo. Función PI_TiempoContinuo; Calcula si durante un periodo de tiempo une expresión PI se cumple. ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 36 de 38
Procedimiento escribirPlano; Escribe una línea en un archivo plano, se utiliza para generar archivos planos para la interfaz batchfl. Función fechaBatchFlPI; Recibe un Date y retorna su correspondiente Strin en el formato "dd-mmm-yyyy HH:mm:ss". Función numeroToStr; Adiciona un cero al comienzo del número si este es menor que 10, útil para armar fechas. Función mesToStr; Recibe el mes como un número y retorna un string de las tres primeras letras correspondientes, es posible definir si se retornan en Ingles o español, para ello envíe en. 5.4.11. Módulo modSilabcomplements (SILABcomplement.bas)
Procedimiento SILAB_Init; Obtiene del archivo .ini los datos correspondientes a servidor Silab. Procedimiento SILAB_Destroy; Cierra la conexión al servidor Silab. Procedimiento SILAB_SetIni; Procedimiento SILAB_SetLog; Función SILAB_ValidarIP; Valida la dirección IP del servidor Silab. Función SILAB_GetData; Abre la conexión a la BD Silab. Función SILAB_ExecuteBD; Ejecuta una sentencia SQL a la BD Silab. Función SILAB_LastError; Función SILAB_Error; Control de errores y notificaciones del Silab.
5.5. Formas de la aplicación
A continuación se describen las formas que son utilizadas dentro de la Interfaz Silab-PI.
5.5.1. Form_SilabPi (SilabPi.frm)
Procedimiento Btn_Detener_Click; Detiene la ejecución automática de la Interfaz. Procedimiento Btn_Iniciar_Click; Inicia la ejecución automática de la Interfaz. Procedimiento Btn_Salir_Click; Cierra la forma. Procedimiento chkStatus_Click; Valida la detención de la ejecucion. Procedimiento Form_Load; Inicio de la ejecución automática de la Interfaz, se encarga de leer parámetros iniciales del .ini, el llenado de las etiquetas de la forma y el llamado a las diferentes funciones y procedimientos iniciales. Procedimiento Form_QueryUnload; Descarga todos los objetos de la forma. Procedimiento Form_Resize; Procedimiento imgMode_Click; ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 37 de 38
Procedimiento imgViewLog_Click; Procedimiento Tmr_EtiquetaViva_Timer; Procedimiento Tmr_Monitor_Timer; Inicia la ejecución, escribe en los logs, actualia el .ini, anicia conexiones con los servidores, valida IP de los servidores, realiza el llamado el procedimiento MainMonitoreo (lógica de la aplicación). Al terminar el proceso de MainMonitoreo, escribe el valor del tag IO-Rates de la Interfaz, llama al procedimiento putFile del módulo ftp para realizar la transferencia de archivo generado. Procedimiento Txt_PathIni_LostFocus; ECOPETROL S.A. FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM Fecha : 26 de Marzo 2009 MANUAL TÉCNICO INTERFAZ SILAB - PI Página 38 de 38
Para mayor información sobre este documento dirigirse a quien lo elaboró, en nombre de la dependencia responsable:
José Bismer Carvajal Alzate Profesional Senior Tel.: 4 9368 Grupo de Desarrollo Proyecto Fábrica de Software del Downstream
DEPENDENCIA RESPONSABLE Dirección de Tecnología de la Información
REVISÖ VICTOR H GONZALEZ Líder Técnico Proyecto GRB UT - Mantenimiento SIV
APROBÓ JHON JAMES RUBIO Líder Técnico Proyecto GRB - ECOPETROL