Integrar parches
Las aplicaciones que utilizan la tecnología SAFE X3 integran una función que permite integrar correcciones o evoluciones funcionales que se entregan en forma de ficheros de archivos llamados "parches". De esta forma, se puede integrar un desarrollo de terceros, se pueden cargar datos suplementarios en una tabla o se pueden aportar correcciones.
Un parche puede contener uno o varios elementos como pantallas, definiciones de tablas, códigos de actividades, tipos de datos, objetos, menús locales, capítulos de mensajes, procesos, solicitudes de ejecución de procesos, datos...
La integración de un parche modifica el diccionario y la base de datos de los dossieres a los que se aplica. Existe una sola excepción a este principio: los procesos proporcionados mediante parche únicamente se instalan en el dossier supervisor (excepto en casos particulares que se explicitan más adelante).
Caso particular: Integración de una tabla
La integración de una tabla se realiza en dos etapas:
1. Actualización de la descripción de la tabla en SAFE X3.
2. Validación de esa tabla (ejecución de la herramienta valfil): durante esta segunda etapa, si existen estadísticas de la bdd (base de datos) en la tabla, estas pueden ser suprimidas.
Esto depende de los tipos de modificaciones de la tabla.
Ejemplos:
- Adición de un campo al final de la descripción de la tabla: las estadísticas de la bdd se conservan.
- Inserción de un campo entre otros dos: se pierden las estadísticas de la bdd en toda la tabla.
La tabla se suprime y luego se crea de nuevo.
Ficheros
Un fichero de parche se caracteriza por un nombre que, en principio, integra una secuencia de números para permitir controlar, cuando hay varios ficheros, que los parches están bien integrados en orden.
El caso de los parches de corrección entregados como estándar se gestiona de la forma siguiente:
- los ficheros están definidos con el nombre P_nnnn_vvv.dat, siendo nnnn un número cronológico y vvv la versión superior sobre la que se puede aplicar el parche (hasta el momento, vvv puede ser igual a 110, 120, 130, 140 o 150). Un fichero de este tipo contiene un conjunto de objetos o elementos constitutivos de una corrección o de una evolución funcional (por ejemplo, la entrega de un nuevo punto de entrada).
- varios ficheros de parches (generalmente, como mínimo una decena, aunque pueden ser muchos más) se organizan en forma de una lista que está disponible para los socios de ADONIX.
- la implementación de una o varias listas se realiza mediante esta función, que integra los ficheros en el orden secuencial de los números cronológicos y se realizan un cierto número de controles de coherencia (número de versión a la que se aplica el parche, secuencialidad desde la última actualización de los parches).
Se aconseja a los socios de Sage que deseen entregar funcionalidades en forma de parches que adopten la misma política de denominación de los ficheros utilizando una primera letra diferente (por ejemplo, X, Y, o Z). De hecho, se realiza un control de secuencialidad desde el momento en que el nombre del fichero integra los caracteres _ (underscore) en la 2ª y 7ª posición del nombre del fichero: los caracteres que ocupan de la 3ª a la 6ª posición son entonces un número secuencial (con la misma raíz) sobre el que se realizará un control de secuencialidad y los caracteres a partir de la 8ª posición (extensión excluida) son controlados en comparación con el número de versión superior.
Requisitos previos
Consulta la documentación de Puesta en marcha
Gestión de Pantalla
Pantalla de captura
En la ventana que se abre se introducen las informaciones relativas a la integración de parche deseada y, a continuación, se valida la pantalla.
Seguidamente, se realiza la integración; esta puede durar bastante tiempo si hay numerosos ficheros de parche, aunque una barra de progreso permite seguir el proceso de integración.
Al finalizar la integración de los parches, se obtiene un fichero de traza que se ubica físicamente en el directorio de traza del dossier desde el que se ha lanzado la integración. Se aconseja visualizar atentamente este fichero para localizar posibles errores.
Fichero
| campo AW |
| Tipo de destino (campo TYPEXP) |
| Parche (campo VOLFIL) |
Bloque Número 2
| Integración de parche (campo INTEG) |
|
Si este campo no está marcado, se simulara la integración. En este caso, la integración se señala pero las transferencias o actualizaciones no se realizan. |
| Sustituir comentario (campo REM) |
| Validación diferida (campo AVALDIF) |
|
Esta opción desactiva la validación directa de las ventanas y pantallas para optimizar la duración de validación de estos objetos. Cuando se marca esta casilla, las ventanas y pantallas se validan en cuanto se utilizan. |
| Sincronización de vínculos (campo ALNKSYNC) |
| Sincronización ventanas (campo AFLGSYNCH) |
Tabla Dossieres
| Dossier (campo DOSSIER) |
| Versión (campo VERSION) |
| Fecha (campo MAJ) |
| Idiomas (campo LANGUES) |
Tarea batch
Esta función puede lanzarse en Batch. La tarea estándar PATCH esta prevista con este fín.
La integración de las listas de parches puede realizarse en batch en un máximo de 50 dossieres.
Esta opción resulta muy interesante, ya que la integración de los parches puede realizarse la noche después de la copia de seguridad cuando aún no se ha retomado la explotación. Ciertamente, la integración de parches puede ser una operación larga. La consulta del fichero de traza podrá entonces realizarse directamente desde el gestor de peticiones de la tarea batch.
Advertencia: un parche estándar ya integrado o que no esté en secuencia no podrá integrarse en batch: lo que no es más que un mensaje de aviso que se puede forzar cuando el parche está integrado directamente se convierte en motivo de parada automática en caso de ejecución en batch.
Parche de documentación
La instalación de un parche de documentación sigue el mismo procedimiento que se ha explicado anteriormente y se aplica a los dossieres seleccionados.
Los ficheros se definen con el nombre Dy_nnnnn_vvv_ppp.dat, siendo "y" la abreviación del producto, "nnnnn" el número cronológico, "vvv" la versión superior a la que se puede aplicar el parche, y "ppp" el código de legislación.
Hay un único fichero por legislación que contiene el conjunto de las documentaciones creadas o modificadas desde el parche anterior.
Los parches de documentación se entregan al mismo tiempo que los parches de aplicaciones. Pueden integrarse antes o después del parche de la aplicación. El sistema verifica la cronología de los números.
La integración de un parche de documentación actualiza el diccionario de documentaciones pero no afecta a los documentos depositados en el servidor de documentación. Para que estos últimos se actualicen, es necesario ejecutar una generación de la documentación.
Generación de la documentación
Si se utiliza el modo de acceso al formato comprimido (CHM), antes de ejecutar la actualización de los documentos automatizados, hay que ejecutar una descompresión del fichero de documentación (véase servidor de documentación).
Si se utiliza el modo de acceso al formato disperso (HTML), se puede ejecutar directamente la actualización.
Actualización automática de las documentaciones
En la función de documentación, hay que hacer clic en el botón Generación e introducir los siguientes datos según el código de idioma deseado:
Nota: el directorio procede del parámetro de usuario DIRDOC.
A continuación, hay que volver a ejecutar otras 3 operaciones de generación con los mismos parámetros excepto el tipo de datos, donde se indicará sucesivamente AML, luego ATB y después ATY.
Generación de los documentos en el servidor de documentación
Para realizar la actualización de las documentaciones en el servidor de documentación, hay que ejecutar la siguiente operación de generación según el código de idioma deseado:
Si se utiliza el acceso a la documentación en modo comprimido, hay que volver a comprimir los ficheros (véase servidor de documentación).
Si se utiliza el acceso en modo disperso, la actualización se da por terminada.
Mensajes de error
Mensajes de error en la ejecución de la función
Además de los mensajes genéricos, los mensajes siguientes de error pueden aparecer durante la captura :
No hay ningún parche en el directorio
Se ha indicado un directorio vacío.
Mensajes de error en la traza
El resto de mensajes de error se muestran en el fichero de traza. Entre estos mensajes se encuentran los siguientes:
El dossier debe estar como mínimo en la versión nnn
El parche no puede aplicarse porque no se ha respetado la versión mínima requerida para los dossieres.
xxxxx: módulo no implantado en el dossier
El parche no se ha aplicado al dossier porque el módulo funcional no se utiliza.
fin de fichero anómalo
Estructura de fichero incorrecta
El fichero de parche probablemente está corrompido, por lo que el proceso de integración no ha podido releer hasta el final los datos correspondientes o se ha encontrado con una estructura no válida.
Gestión de fichero XXX: "mensaje de error"
Se ha producido un error de tipo transaccional durante la actualización del diccionario.
Error en línea NNN: "mensaje de error"
Se ha producido un error en la ejecución de un proceso que acompaña al parche.
Parche más reciente ya integrado
Faltan parches, el último integrado es ###
Parche normalmente incluido en la versión NNN
Estos tres mensajes hacen referencia a la verificación de secuencialidad de aplicación de los parches. Normalmente, si el parche estándar número N es el último en haber sido aplicado, se espera que no se aplique un parche más antiguo (mensaje número 1) ni un parche con un número estrictamente superior a N+1 (mensaje número 2). Además, la instalación de una versión intermedia incluye algunos parches estándares que, en consecuencia, no es necesario integrar (mensaje número 3). En todo caso, en el modo interactivo estos mensajes no son de bloqueo, por lo que, a pesar de todo, es posible seguir adelante respondiendo Sí a la pregunta ¿Quiere continuar a pesar de los errores?.