CONTENIDO

1 2 Historial.................................................................................................................................................................2 PYBRIDGE...........................................................................................................................................................3 2.1 Configuracin...............................................................................................................................................3 2.2 Funcionalidad...............................................................................................................................................3 2.2.1 Concepto Importar Histricos.......................................................................................................5 2.2.1.1 Entidades .........................................................................................................................................6 2.2.2 Concepto Importar Informes Fijos ...............................................................................................7 2.2.2.1 Configuracin PC PYMAN..........................................................................................................8 2.2.3 Concepto Transferencia tablas datos............................................................................................9

Documento: PYBridge.doc Creado:18/ 4/2002

Pgina: 1 de 12 Revisin: (2/8/02 16:36)

1 Historial
Modificaciones realizadas en el documento: 05/06/2002 (Emili Calvet) - Versin original 19/06/2002 (Emili Calvet) - Modificacin parmetros concepto Importar Histricos. Aade importar configuracin - Nuevo concepto Importar Informes Fijos

Documento: PYBridge.doc Creado:18/ 4/2002

Pgina: 2 de 12 Revisin: (2/8/02 16:36)

2 PYBRIDGE
La funcin de la aplicacin PyBridge es la de puente entre las aplicaciones PYMAN y Servidor Web. La aplicacin PyBridge requiere 1) Configuracin de objetos 2) Funcionalidades

2.1

Configuracin

Los conceptos configurables en la aplicacin PyBridge son los siguientes 1) Base datos . Configuracin , mediante ODBC, de la base de datos del servidor Web a la que debe acceder para obtener y/o modificar datos de configuracin de la instalacin 2) Puerto Tcp/ip atencin al servidor Web. El servidor notificar por socket cualquier cambio en la configuracin realizada desde el servidor

2.2

Funcionalidad

La aplicacin PyBridge dispone de las siguientes funcionalidades 1) Importar histricos y configuracin entidades de los PYMAN Nivel 1 2) Importar informes fijos de los PYMAN Nivel 1. 3) Transferencia tablas datos de los PYMAN Pybridge requiere que en el ServidorWeb se configuren una serie de Conceptos con sus respectivos parmetros. Para configurar los diferentes conceptos en el Servidor Web se realizar los siguientes pasos 1) Acceder al servidor Web 2) Realizar Login con un usuario que disponga del perfil para configurar mquinas, conceptos y parmetros Configuracin Concepto 3) Seleccionar la opcin Maquinas|Concepto configuracion maquina 4) Nuevo Concepto: Seleccionar botn Crear nuevo Un Concepto tiene los siguientes campos: Identificador: Valor numrico que identifica al concepto Descripcin: Texto que describe el concepto Es obligatorio: Inidica que el concepto es obligatorio para cada uno de los PYMAN Es repetitivo: Indica que el concepto puede tener varias instancias para un mismo PYMAN Configuracin Parmetros relativos o asociados a un Concepto 1) Seleccionar la opcin Maquinas|Concepto configuracion maquina 2) Seleccionar la opcin Definir Parametros del Concepto para el cual se pretende crear,modificar o eliminar un parmetro 3) Nuevo Parmetro: Seleccionar botn Crear Nuevo Un Parmetro tiene los siguientes campos: Identificador: Valor numrico que identifica al parmetro Nombre: Texto que describe el parmetro Tipo valor: Tipo de campo necesario para el parmetro. Tipos de valor disponible: Booleano,Numrico decimal , Numrico entero,Texto, Longitud: Nmero de dgitos en el caso de tipo numrico o nmero de caracteres en el caso de texto Decimales: Nmero de decimales en el caso de Numrico decimal, en otro caso 0 Valor por Defecto: Valor por defecto que debe tener el parmetro

Documento: PYBridge.doc Creado:18/ 4/2002

Pgina: 3 de 12 Revisin: (2/8/02 16:36)

Configuracin Parmetros asociados a un Concepto para un PYMAN en concreto 1) Seleccionar la opcin Maquinas|Maquinas 2) Seleccionar la opcin Ver Parametros del PYMAN para el cual se pretende configurar un parmetro . Aparece una vista con los diferentes Conceptos de que dispone el PYMAN seleccionado as como los diferentes parmetros asociados a cada concepto Los conceptos necesarios son: A) Importar Histricos B) Importar Informes Fijos C) Transferencia tablas datos

Documento: PYBridge.doc Creado:18/ 4/2002

Pgina: 4 de 12 Revisin: (2/8/02 16:36)

2.2.1

Concepto Importar Histricos

El concepto Importar Histricos debe tener las siguientes propiedades: id: valor 1 nombre: valor IMPORTAR HISTRICOS esobligatorio: valor si esrepetitivo: no. Se requiere un nico registro para cada PYMAN El concepto Importar Histricos debe tener los siguientes parmetros: 1. Periodo: Periodo, en minutos, importacin datos. Tiempo expresado en minutos Definicin parmetro: id: valor 1 nombre: valor PERIODO tipo: valor nmero entero longitud: valor 5 decimales: valor 0 valordefecto: valor 10 2. Activo: Realizar la accin si/no Definicin parmetro: id: valor 2 nombre: valor ACTIVO tipo: valor boolean longitud: valor 1 decimales: valor 0 valordefecto: valor 0 3. Puerto: Puerto TCP/IP por el que debe realizarse la conexin con PYMAN Nivel 1 Definicin parmetro: id: valor 3 nombre: valor PUERTO tipo: valor nmerico entero longitud: valor 5 decimales: valor 0 valordefecto: valor 8200 4. Timeout Recepcin: Timeout de recepcin de los datos de las tablas. Tiempo expresado en segundos Definicin parmetro: id: valor 4 nombre: valor TIMEOUT RECEPCIN tipo: valor nmero entero longitud: valor 10 decimales: valor 0 valordefecto: valor 30 5. Configuracion Periodo: Periodo, en minutos, importacin datos configuracin entidades necesarias para los histricos. Cada vez que se importen los datos de configuracin se borra el contenido d la tabla e correspondiente en el servidor y se insertan los valores recibidos Definicin parmetro: id: valor 5 nombre: valor CONFIGURACION PERIODO tipo: valor nmero entero longitud: valor 5 decimales: valor 0 valordefecto: valor 480

Documento: PYBridge.doc Creado:18/ 4/2002

Pgina: 5 de 12 Revisin: (2/8/02 16:36)

6.

Configuracion Activo: Realizar la accin si/no. Activar la importacin de la configuracin de entidades Definicin parmetro: id: valor 6 nombre: valor CONFIGURACION ACTIVO tipo: valor boolean longitud: valor 1 decimales: valor 0 valordefecto: valor 1 NOTA: En el campo valordefecto se ha definido un valor de ejemplo, cuando se defina cada parmetro deber configurarse el valor por defecto que se crea necesario

2.2.1.1

Tablas Histricos

Pybridge importa de PYMAN a Servidor Web (Base datos Oracle) las tablas de los siguientes histricos a) Analgicos - Origen datos: Pyman.mdb\Analogico0 , destino datos: oreports.analogico0 b) Averas - Origen datos: Pyman.mdb\Averia0 , destino datos: oreports.averia0 c) Incidencias - Origen datos: Pyman.mdb\Incidencia0 , destino datos: oreports.incidencia0 d) Paradas - Origen datos: Pyman.mdb\Parada0 , destino datos: oreports.parada0

2.2.1.2

Tablas Entidades

Pybridge importa de PYMAN a Servidor Web (Base datos Oracle) las tablas de las siguientes entidades a) Analgicos - Origen datos: Pyman.mdb\VAna0 , destino datos: oreports.ana0 b) Autmatas - Origen datos: Pyman.mdb\VAut0 , destino datos: oreports.aut0 c) Accin - Origen datos: Pyman.mdb\Vcumpl0_0 , destino datos: oreports.cumpl0_0 d) Elemeto implicado - Origen datos: Pyman.mdb\Vcumpl1_0 , destino datos: oreports.cumpl1_0 e) Area - Origen datos: Pyman.mdb\Vcumpl2_0 , destino datos: oreports.cumpl2_0 f) Campo afectacin - Origen datos: Pyman.mdb\Vcumpl3_0 , destino datos: oreports.cumpl3_0 g) Afectacin elemento - Origen datos: Pyman.mdb\Vcumpl30_0 , destino datos: oreports.cumpl30_0 h) Preventivo - Origen datos: Pyman.mdb\Vcumpl4_0 , destino datos: oreports.cumpl4_0 i) Sucesos - Origen datos: Pyman.mdb\VSuc0 , destino datos: oreports.suc0 j) Instalacion - Origen datos: Pyman.mdb\VInstalacion0 , destino datos: oreports.instalacion0 k) Zonas - Origen datos: Pyman.mdb\VZona0 , destino datos: oreports.zona0 l) Ambito - Origen datos: Pyman.mdb\VAmbito0 , destino datos: oreports.Ambito0 m) PYMAN- Origen datos: Pyman.mdb\PYMAN0 , destino datos: oreports.Pyman0

Documento: PYBridge.doc Creado:18/ 4/2002

Pgina: 6 de 12 Revisin: (2/8/02 16:36)

2.2.2

Concepto Importar Informes Fijos

El concepto Importar Informes Fijos debe tener las siguientes propiedades: id: valor 2 nombre: valor INFORMES FIJOS esobligatorio: valor si esrepetitivo: no. Se requiere un nico registro para cada PYMAN El concepto Importar Informes Fijos debe tener los siguientes parmetros: 1. Periodo: Periodo, en minutos, importacin datos. Tiempo expresado en minutos Definicin parmetro: id: valor 1 nombre: valor PERIODO tipo: valor nmero entero longitud: valor 5 decimales: valor 0 valordefecto: valor 30 2. Activo: Realizar la accin si/no Definicin parmetro: id: valor 2 nombre: valor ACTIVO tipo: valor boolean longitud: valor 1 decimales: valor 0 valordefecto: valor 0 3. Source: Origen.Identificador nombre del Recurso que permite el acceso a los ficheros Definicin parmetro: id: valor 3 nombre: valor SOURCE tipo: valor Texto longitud: valor 256 decimales: valor 0 valordefecto: valor PYMAN NOTA: Se presupone que cada equipo PYMAN tiene el recurso compartido PYMAN. 4. Files: Comodin . Conjunto de ficheros correspondientes a los informes fijos. Es necesario especificar la ruta donde se encuentran los ficheros a partir del recurso configurado en el campo SOURCE Definicin parmetro: id: valor 4 nombre: valor FILES tipo: valor Texto longitud: valor 256 decimales: valor 0 valordefecto: valor TMP\*.pdf

Documento: PYBridge.doc Creado:18/ 4/2002

Pgina: 7 de 12 Revisin: (2/8/02 16:36)

5.

Destination: Destino. Identificador nombre del Recurso donde deben moverse los ficheros obtenidos en origen Definicin parmetro: id: valor 5 nombre: valor DESTINATION tipo: valor Texto longitud: valor 256 decimales: valor 0 valordefecto: valor \\PYSERVER\Informes_fijos_a_procesar NOTA: Se presupone que en el Servidor el directorio ,ruta, donde deben almacenarse los ficheros es un recurso compartido. PYSERVER es el nombre del equipo servidor. En caso de que no tuviera este nombre modificar la ruta sustituyendo PYSERVER por el nombre del equipo servidor. Con esta funcionalidad el programa Pybridge se puede ejecutarse en otro equipo que no sea el Servidor. 6. User: Usuario que permite acceder al recurso definido en el campo Source y en el campo Destination Definicin parmetro: id: valor 6 nombre: valor USER tipo: valor Texto longitud: valor 50 decimales: valor 0 valordefecto: valor Pybridge NOTA: Se plantean dos situaciones a)Servidor gestiona un dominio y los equipos PYMAN pertenecen al dominio. En este caso en el campo User tendr como valor el identificador ,nombre, de un usuario del dominio ,previamente definido, que tenga acceso al recurso de los equipos PYMAN (Origen) y al recurso del servidor (Destino) b) El Servidor y los equipos PYMAN son equipos totalmente independientes.En este caso, en el campo User tendr como valor el identificador ,nombre, de un usuario , que previamente se habr definido en cada uno de los equipos PYMAN y tambin en el servidor, que tenga acceso al recurso de los equipos PYMAN (Origen) y al recurso del servidor (Destino) 7. PassWord: Password del usuario que permite acceder al recurso definido en el campo Source y en el campo Destination Definicin parmetro: id: valor 7 nombre: valor PASSWORD tipo: valor Texto longitud: valor 50 decimales: valor 0 valordefecto: valor Pybridge NOTA: En el campo valordefecto se ha definido un valor de ejemplo, cuando se defina cada parmetro deber configurarse el valor por defecto que se crea necesario

2.2.2.1

Configuracin PC PYMAN

PyBridge necesita acceder al recurso PYMAN (PYMAN\tmp) ,donde se encuentran los archivos de informes fijos, de cada PC PYMAN. Para acceder al recurso es necesario definir un usuario , con contrasea, especfico para esta funcionalidad. Ejemplo: Usuario: Pybridge Contrasea: Pybridge

Documento: PYBridge.doc Creado:18/ 4/2002

Pgina: 8 de 12 Revisin: (2/8/02 16:36)

2.2.3

Concepto Transferencia tablas datos

El concepto Transferencia tablas datos debe tener las siguientes propiedades: id: valor 3 nombre: valor TRANSFERENCIA TABLAS DATOS esobligatorio: valor SI esrepetitivo: SI. Pueden existir varios registros para cada PYMAN. NOTA: En el caso de que sea necesario transferir los datos de varias tablas, entre PYMAN y el Servidor, es necesario definir una instancia (registro) para cada tabla . El identificador de la primera instancia debe ser 1 y los siguientes nmeros consecutivos IMPORTANTE: Las tablas que deben transferirse desde PYMAN al Servidor Web deben estar definidas o vinculadas en PYMAN.MDB. El concepto Transferencia tablas datos debe tener los siguientes parmetros: 1. Periodo: Periodo, en minutos, importacin datos. Tiempo expresado en minutos Definicin parmetro: id: valor 1 nombre: valor PERIODO tipo: valor nmero entero longitud: valor 5 decimales: valor 0 valordefecto: valor 25 2. Activo: Realizar la accin si/no Definicin parmetro: id: valor 2 nombre: valor ACTIVO tipo: valor boolean longitud: valor 1 decimales: valor 0 valordefecto: valor 0 3. Puerto: Puerto TCP/IP por el que debe realizarse la conexin con PYMAN Nivel 1 Definicin parmetro: id: valor 3 nombre: valor PUERTO tipo: valor nmerico entero longitud: valor 5 decimales: valor 0 valordefecto: valor 8200 4. Timeout Recepcin: Timeout de recepcin de los datos de las tablas. Tiempo expresado en segundos Definicin parmetro: id: valor 4 nombre: valor TIMEOUT RECEPCIN tipo: valor nmero entero longitud: valor 10 decimales: valor 0 valordefecto: valor 30 5. Cmd_Sql : Sentencia Sql que debe ejecutarse en PYMAN Nivel 1 para obtener los datos requeridos. Este parmetro puede utilizar campos variables. Ej: Borrado de registros Delete from tabla where fecha<%iantgff% %vi2fv% Definicin parmetro: id: valor 5 nombre: valor CMD_SQL tipo: valor Texto longitud: valor 256 decimales: valor 0 valordefecto: valor NO USADO Documento: PYBridge.doc Creado:18/ 4/2002 Pgina: 9 de 12 Revisin: (2/8/02 16:36)

6. TablaDestino: Nombre de la tabla destino Definicin parmetro: id: valor 6 nombre: valor TABLA_DESTINO tipo: valor Texto longitud: valor 256 decimales: valor 0 valordefecto: valor NO USADO 7. Cmd_SqlOk: Sentencia Sql que debe ejecutarse en PYMAN una vez se ha recibido y actualizado la informacin en la tabla destino del Servidor Web. Este parmetro puede utilizar campos variables. Ej: Actualizacin campos de registros Update tabla set fechaExportar=%ifhahoraf% where fechaExportar<=fechaActualizar and nreg>=%ireginif% and nreg<=%iregfinf% Definicin parmetro: id: valor 7 nombre: valor CMD_SQLOK tipo: valor Texto longitud: valor 256 decimales: valor 0 valordefecto: valor NO USADO 8. Field_idReg: Nombre del campo de la tabla ,origen y destino, que se utiliza para diferenciar dos registros. Ejemplo nReg nmero de registro Definicin parmetro: id: valor 8 nombre: valor FIELD_IDREG tipo: valor Texto longitud: valor 50 decimales: valor 0 valordefecto: valor NO USADO 9. Field_idSource: Nombre del campo de la tabla ,origen y destino, que se utiliza para diferenciar el origen de los datos. Ejemplo idPYMAN identificador PYMAN Definicin parmetro: id: valor 9 nombre: valor FIELD_IDSOURCE tipo: valor Texto longitud: valor 50 decimales: valor 0 valordefecto: valor NO USADO 10. Update: Permitir operacin UPDATE en tabla destino : si/no Definicin parmetro: id: valor 10 nombre: valor UPDATE tipo: valor boolean longitud: valor 1 decimales: valor 0 valordefecto: valor 1 11. Delete: Realizar operacin DELETE ,de todos los registros o los regsitros de un mismo origen, en la tabla destino antes de aadir nuevos registros:si/no Definicin parmetro: id: valor 11 nombre: valor DELETE tipo: valor boolean longitud: valor 1 decimales: valor 0 valordefecto: valor 0

Documento: PYBridge.doc Creado:18/ 4/2002

Pgina: 10 de 12 Revisin: (2/8/02 16:36)

12. Return_Register: Como resultado de la ejecucin del parmetro Cmd_Sql se obtienen registros:si/no. Ejemplo : utilizado para permitir definir comandos Delete en el parmetro Cmd_Sql Definicin parmetro: id: valor 12 nombre: valor RETURN_REGISTER tipo: valor boolean longitud: valor 1 decimales: valor 0 valordefecto: valor 1 NOTA: En el campo valordefecto se ha definido un valor de ejemplo, cuando se defina cada parmetro deber configurarse el valor por defecto que se crea necesario Campos Variables: Para definir un campo variable debe utilizarse la siguiente sintaxis: %icampo%f, donde %i indica el inicio del campo variable y %f el fin Los campos variables que se pueden utilizar son : FHAHORA : FAHORA : HAHORA : REGINI: REGFIN: ANTGFH ANTGF: Fecha y hora actual Fecha actual Hora actual Identificador primer registro Identificador ltimo registro Antigedad con fecha y hora Antigedad con fecha

Los campos variables relativos a antigedad en fecha deben ir acompaados del siguiente campo %vivalorvf% donde valor es un nmero que indica los das de antigedad respecto a la fecha actual y %vi indica el inicio del valor y vf% el fin

Documento: PYBridge.doc Creado:18/ 4/2002

Pgina: 11 de 12 Revisin: (2/8/02 16:36)

Ejemplo configuracin : Tabla Parte Diario Concepto : Transferencia Tablas datos Valor Parametros: TRANSFERENCIA TABLA PARTE DIARIO
PERIODO: ACTIVO: PUERTO: TIMEOUT RECEPCION: CMD_SQL: ORDER BY NREG TABLA_DESTINO: CMD_SQLOK: FIELD_IDREG: FIELD_IDSOURCE: UPDATE: DELETE: RETURN_REGISTER: 25 SI 8200 30 SELECT * FROM PARTEDIARIO WHERE FECHAEXPORTAR<=FECHAACTUALIZAR OREPORTS.PARTEDIARIO
UPDATE PARTEDIARIO SET FECHAEXPORTAR=%IFHAHORAF% WHERE NREG>=%IREGINIF% AND %IREGFINF%

NREG IDPYMAN SI NO SI

Valor Parametros: BORRADO REGISTROS TABLA PARTE DIARIO

PERIODO: ACTIVO: PUERTO: TIMEOUT RECEPCION: CMD_SQL: TABLA_DESTINO: CMD_SQLOK: FIELD_IDREG: FIELD_IDSOURCE: UPDATE: DELETE: RETURN_REGISTER: 3600 SI 8200 30 DELETE FROM PARTEDIARIO WHERE FECHA<=%IANTGFF% %VI7VF%

NO NO NO

Documento: PYBridge.doc Creado:18/ 4/2002

Pgina: 12 de 12 Revisin: (2/8/02 16:36)