i
Formato del Archivo de Entrada
El archivo de entrada contendrá toda la información necesaria para aplicar las modificaciones en el sistema que permitirán incorporar la actualización que se pretende realizar.
El archivo de entrada será un archivo comprimido con formato ZIP que contendrá una serie de carpetas y/o archivos, los cuales tendrán un nombre de la forma
<###>.<TYPE> donde:
<###> es un número de 000 a 999 y sirve para establecer el orden en que cada archivo es procesado por la herramienta.
<TYPE> sirve para tipificar el contenido del es uno de los siguientes valores:
Nombre |
Tipo |
Descripción |
---|---|---|
files |
carpeta |
Estructura de directorios correspondiente con la de la aplicación. Dentro de esta carpeta van archivos a copiar y sobrescribir durante el update. |
imports |
carpeta |
Contiene archivos que han sido exportados desde el ambiente original, mediante la función de Export Selectivo (1). Esto archivos serán importados en el ambiente destino, en modalidad batch y en orden alfabético. |
database.sql |
archivo |
Sentencias SQL a ejecutar sobre la base de datos de la aplicación (2). |
database_sinlge.sql |
archivo |
Sentencia SQL a ejecutar sobre la base de datos de la aplicación. |
script.cmd |
archivo |
Archivos de Comandos de sistema operativo a ejecutar. El punto inicial de ejecución será la carpeta batch del ambiente (4). |
script.sh |
archivo |
Archivos de Comandos de sistema operativo a ejecutar. El punto inicial de ejecución será la carpeta batch del ambiente (5). |
env.properties |
archivo |
Entradas que se agregarán y/o se sobrescribirán en el archivo de propiedades del sistema. |
client_env.properties |
archivo |
Entradas que se agregarán y/o se sobrescribirán en el archivo de propiedades del cliente. |
changelog.txt |
archivo |
Se utiliza para mantener un archivo donde se escriben los cambios que se aplican al ambiente en orden cronológico. |
readme.txt |
archivo |
No tiene efecto de actualización, usado solamente para documentar dentro del archivo de update. |
(1) Los imports deben ser selectivos ya que el usuario no tiene posibilidad de interactuar con el proceso de actualización y por lo tanto los elementos a importar deben estar previamente seleccionados.
(2) Tener en cuenta que cualquier línea terminada en ‘;’ (seguidas de salto de línea) se considerará como una nueva sentencia.
(3) Cuando una sentencia SQL utiliza valores alfanuméricos que contienen el carácter ';' (seguidas de salto de línea) se debe separar de otras sentencias incluyéndola en un archivo database_sinlge.sql.
Esto puede ocurrir por ejemplo al insertar o actualizar el código de una regla Java, donde cada linea de código termina con ';'
Para que el updater no interprete cada linea como una sentencia SQL independiente, se maneja este tipo de scripts, donde todo el contenido se interpreta como una única sentencia.
(4) Los scripts con extensión cmd solamente se ejecutarán en entornos Windows.
(5) Los scripts con extensión sh solamente se ejecutarán en entornos basados en Unix.
El procesamiento de este archivo de entrada es sencillo:
•Se procesan uno a uno las carpetas o archivos contenidos, respetando el ordenamiento establecido por <###> y se realiza una acción específica dependiendo del tipo de contenido, determinado por <TYPE>.