1.4.

MAESTRO FORMATOS DE IMPORTACIÓN

1.4.1. Tablas involucradas: mgarchivotipo, mgarchivoestructura,
mgtipoformatoxarchivo, mgarchivotipoformato
1.4.2. Restricciones: El acceso a esta función (opción) es para el usuario o posición que
tiene autorizada ésta opción, además va a poder ejecutar mantenimiento a este
maestro: Nuevo, Modificar, Descargar Formato, si explícitamente tiene asignado
estas autorizaciones. Además el usuario debe ser miembro del rol Administrador
del Sistema en la aplicación “SYS”.
1.4.3. Parámetros relacionados: <Ninguno>
1.4.4. Carga de Formulario
Al cargar el formulario, se presenta una vista de Listado de Formatos de
Importación, además de los botones para acciones disponibles, de acuerdo a las
autorizaciones otorgadas al usuario o posición (indicadas en la sección 1.12.2
Restricciones): Nuevo, Descargar Formato, Filtrar, Listar Todo. Además de
Modificar y Ver, acciones que están disponibles por cada registro del listado.
El listado debe mostrar un listado con la siguiente información (columnas): Código,
Descripción, Descripción Inglés, Nombre Tabla, Estado. El listado debe estar
ordenado por Código
Los registros que se muestran en el listado corresponden a los que cumplen los
criterios o filtros que se cargan por defecto; es decir: Estado.
1.4.5. Acciones
A) Listar según Filtros
Para realizar una búsqueda, se seleccionan los filtros correspondientes.
Los filtros de búsqueda son:
 Tipo de Formato [Combo box]: La lista de valores se carga de la tabla
mgarchivotipoformato. Entre los valores que se definen están: Texto
delimitado por tabulaciones, DBF, etc. Por defecto se muestra el valor
<Seleccione un tipo de formato>.
 Criterio de Búsqueda [Combo box]: La lista de valores es fija y son:
Código, Descripción, Descripción Inglés, Nombre Tabla. Por defecto se
debe mostrar el valor <Seleccione un criterio de búsqueda>.Cuando se
selecciona un criterio de búsqueda se debe digitar el valor de búsqueda
en una Caja de Texto
 Estado [Radio Button]: Se puede seleccionar “Activo” o “Inactivo” para el
registro correspondiente. Por defecto se muestra en “Activo”.
Luego se hace click en el botón “Aceptar” y el listado se actualiza de acuerdo
con las condiciones definidas en los filtros. El filtro por defecto es: Estado.

B) Agregar Nuevo registro

Al hacer click en el botón “Nuevo” se muestra la interfaz para el ingreso o alta
de un Tipo de Archivo de Importación. En esta interfaz se ingresa tanto la
definición del tipo de archivo (cabecera), así como la estructura del archivo
(Detalle).
Los datos que se deben ingresar son:
Sección Cabecera:
Definición del Tipo de Archivo:
  Código [Caja de texto] [Obligatorio] [alfabético hasta 4 caracteres]:
Corresponde al código del Archivo. Los caracteres alfabéticos se muestran
siempre en mayúscula. No se permiten espacios en blanco.
Validación: Al hacer Tab, Enter o perder el foco, se debe validar que la
secuencia de caracteres digitada sea única, es decir que no haya sido
previamente registrada. En el caso que el código ya exista debe mostrar el
mensaje “El código digitado ya existe. Debe ingresar un código diferente” y
debe borrar la caja de texto y ubicar nuevamente el foco en Código.
 Descripción [Caja de texto][Obligatorio][Alfanumérico y especiales hasta
50 caracteres]: Corresponde al nombre del tipo de archivo. Los caracteres
alfabéticos se muestran siempre en mayúscula. Se permiten espacios en
blanco. Sólo se pueden digitar una secuencia de caracteres hasta el límite
indicado.
 Descripción Ingles [Caja de texto][Opcional][Alfanumérico y especiales
hasta 50 caracteres]:Corresponde al nombre del tipo de archivo en inglés.
Los caracteres alfabéticos se muestran siempre en mayúscula. Se permiten
espacios en blanco. Sólo se pueden digitar una secuencia de caracteres hasta
el límite indicado.
 Tabla [Caja de texto][Obligatorio][Alfabético hasta 80 caracteres]: Es el
nombre de una tabla de la Base de Datos del Sistema. Los caracteres
alfabéticos se muestran siempre en mayúscula. No se permiten espacios en
blanco.
Validación:
Al hacer Tab, Enter o perder el foco, se debe validar que la secuencia de
caracteres digitada sea válida, es decir se corresponda con un nombre válido
de alguna tabla de la Base de Datos, en caso contrario se debe mostrar el
mensaje “El nombre ingresado no corresponde a un nombre de tabla válido.
Debe ingresar un nombre de tabla válido” y debe borrar la caja de texto y
ubicar nuevamente el foco en Tabla.
Así mismo se debe validar que el nombre de tabla ingresado no exista aún en
la Base de Datos, en caso exista se debe mostrar el mensaje: “La Tabla
ingresada ya está registrada. No es posible ingresar otra vez la misma Tabla”
 Estado [Switch]: Se enciende para cambiar a “Activo” o se apaga para
cambiar a “Inactivo” el registro correspondiente. Por defecto “Activo”.
Una vez ingresada toda la información necesaria, se ingresa la información del
detalle (estructura del archivo).
Sección Detalle 1
Estructura del Archivo (Detalle)
En la sección de detalle, se muestran botones para las siguientes acciones: Agregar
(línea de detalle), Eliminar (Línea de Detalle).
Para cada registro se debe ingresar los siguientes datos:
 Línea [Caja de texto][Obligatorio][Numérico]: Corresponde al orden de la
columna dentro del archivo. Es un valor único para cada tipo de archivo. Por
defecto se muestra un valor sugerido correspondiente al número siguiente al
máximo valor registrado para el archivo seleccionado.
 Nombre Campo [Caja de texto][Obligatorio][Alfanumérico hasta 20
caracteres]: Corresponde al nombre del campo. Los caracteres alfabéticos se
muestran siempre en mayúscula. Se permiten espacios en blanco.
 Tipo Dato [Combo box][Obligatorio]: La lista de valores se cargan de la tabla
mgtipodato para los registros que cumplan la condición
estipodatopostgresqlflag=1. Por defecto se muestra la expresión <Seleccione
un Tipo de Dato>.
 Descripción a mostrar del Tipo de Dato [Caja de
texto][Obligatorio][Alfanumérico hasta 30 caracteres]: Corresponde al
nombre del tipo de dato que se va a mostrar al usuario en el formato o plantilla
de importación. Los caracteres alfabéticos se muestran siempre en mayúscula.
Se permiten espacios en blanco.
 Descripción Campo [Caja de texto][Opcional][Text]: Corresponde a una
descripción detallada del campo así como las consideraciones que se deben
considerar para el llenado de los valores para ese campo por parte del usuario.
Los caracteres alfabéticos se muestran siempre en mayúscula. Se permiten
espacios en blanco.
 Longitud [Caja Number][Opcional]: Corresponde a la longitud para tipo de
datos caracter.
Validación: Sólo se puede editar cuando tipo de dato es caracter. Sólo se
permiten enteros positivos mayores que cero
 Longitud Decimales [Caja Number][Opcional]: Corresponde al número de
decimales cuando el tipo de dato es decimal.
Validación: Sólo se puede editar cuando tipo de dato es decimal. Sólo se
permiten enteros positivos mayores que cero
 Formato [Caja texto][Opcional] [Alfanumérico y especiales hasta 20
caracteres]: Corresponde a una expresión regular que define el formato del
valor a usar para el campo. Los caracteres alfabéticos se muestran siempre en
mayúscula. Se permiten espacios en blanco. Sólo se pueden digitar una
secuencia de caracteres hasta el límite indicado.
 Obligatorio [Check box] [Obligatorio]: Indica si el campo o columna definida
es obligatorio o su valor es requerido.
 Columna [Caja de texto][Obligatoriol][Alfanumérico hasta 80 caracteres]: Es
el nombre de una de las columnas de la tabla ingresada en “Tabla”. Los
caracteres alfabéticos se muestran siempre en mayúscula. No se permiten
espacios en blanco.
Validación:
Al hacer Tab, Enter o perder el foco, se debe validar que la secuencia de
caracteres digitada se válida, es decir se corresponda con un nombre válido de
alguna columna de la tabla ingresada, en caso contrario se debe mostrar el
mensaje “El nombre de columna ingresada no corresponde a un nombre de
columna válido para la tabla [NombreTabla]. Debe ingresar un nombre de
columna válido” y debe borrar la caja de texto y ubicar nuevamente el foco en
Tabla.
Así mismo se debe validar que el nombre de columna ingresado no exista aún
en la Base de Datos, para la tabla correspondiente, en caso exista se debe
mostrar el mensaje: “La columna ingresada ya está registrada para la Tabla
definida. No es posible ingresar otra vez la misma columna”
 Incluir Suma Total [Check box][Obligatorio]: Indica si la columna va a incluir
al final un totalizador o un valor sumarizado de todos los valores de la columna.
Validación:
 Sólo puede marcarse cuando el tipo de dato que se defina sea de algún tipo
numérico.
 Estado [Radio Button]: Se puede seleccionar “Activo” o “Inactivo” para el
registro correspondiente. Por defecto se muestra en “Activo”.

Al momento de hacer click en el botón Agregar, se inserta en la lista el registro.

Este proceso se repite por cada columna del archivo. Si durante el proceso de
definición de la estructura se modifica dato de Tabla, entonces se muestra el
mensaje “La modificación realizada eliminará todos los registros de detalle. ¿Está
seguro que desea continuar?”, si la respuesta es Sí, entonces se elimina todo el
detalle, sino se descarta el cambio realizado en el campo Tabla.
Cuando se termine de ingresar todos los datos de las columnas entonces se
procede a guardar el registro y su detalle haciendo click en el botón Aceptar.

Sección Detalle 2
Tipos (Extensiones) Disponibles
En la sección de detalle, se muestran botones para las siguientes acciones: Agregar
(línea de detalle), Eliminar (Línea de Detalle).
Para cada registro se debe ingresar los siguientes datos:
 Tipo Formato [Combo box][Obligatorio]: La lista de valores se carga de la tabla
mgarchivotipoformato. Entre los valores que se definen están: Texto
delimitado por tabulaciones, DBF, etc. Por defecto se muestra el valor
<Seleccione un tipo de formatol>.
 Descripción [Caja de texto][Opcional][alfanumérico hasta 10 caracteres]:
Corresponde a una descripción adicional. Los caracteres alfabéticos se
muestran siempre en mayúscula. Se permiten espacios en blanco.
 Considerar como extensión por defecto [Check box] [Obligatorio]: Indica si la
extensión es la que se establece por defecto.
Validación:
Sólo debe haber una extensión por defecto para un archivo.
 Estado [Radio Button]: Se puede seleccionar “Activo” o “Inactivo” para el
registro correspondiente. Por defecto se muestra en “Activo”.
Al momento de hacer click en el botón Agregar, se inserta en la lista el registro.
Este proceso se repite por cada extensión que se requiera asignar al archivo.
Cuando se termine de ingresar todos los datos, tanto de la definición, estructura y
extensiones disponibles para un archivo entonces se procede a guardar el registro
y sus detalles correspondientes haciendo click en el botón Aceptar. Además de la
información ingresada, también se guardan los siguientes datos de auditoría:
 Alta Aplicación: Aplicación desde donde se hizo el ingreso del registro.
 Alta Usuario: Usuario que hizo el ingreso del registro
 Alta Fecha: Fecha y hora que se hizo el registro.
 Última Fecha de modificación: Fecha de la última modificación del
registro. En un nuevo registro es igual a Alta Fecha.
 Ultimo Usuario de modificación: Usuario que hizo la última modificación
del registro. En un nuevo registro es igual a Alta Usuario.
Los datos de auditoría deben grabarse tanto en la tabla de cabecera como de
detalles.
C) Modificar un Registro.
Para modificar un registro se debe ubicar el registro que se requiere actualizar
y hacer click en el botón “Modificar”. Esta acción muestra la misma interfaz
que para el Ingreso de un Nuevo Registro, pero con los datos cargados de tipo
de archivo. En esta interfaz se modifican tanto la definición del archivo de
importación, así como la estructura del archivo (Detalle 1) como las
extensiones asignadas (Detalle 2)
Los datos que se pueden modificar son:

Sección Cabecera:
Definición del Tipo de Archivo:
 Código [Caja de texto] [Obligatorio] [alfabético hasta 4 caracteres]: Es
Editable. Por defecto se muestra el valor actual del registro. Considerar las
mismas restricciones y validaciones indicadas en la inserción de un nuevo
registro.
 Descripción [Caja de texto][Obligatorio][Alfanumérico y especiales hasta
50 caracteres]: Es Editable. Por defecto se muestra el valor actual del
registro. Considerar las mismas restricciones y validaciones indicadas en la
inserción de un nuevo registro.
 Descripción Ingles [Caja de texto][Opcional][Alfanumérico hasta 40
caracteres]: Es Editable. Por defecto se muestra el valor actual del registro.
Considerar las mismas restricciones y validaciones indicadas en la inserción
de un nuevo registro.
 Tabla: No es editable. Por defecto se muestra el valor actual del registro.
 Estado [Radio Button]: Es editable. Por defecto se muestra el valor actual del
registro.

Si es necesario también se puede modificar los datos del detalle.

Sección Detalle 1
Estructura del Archivo (Detalle)
En la sección de aplicaciones, se muestran botones para las siguientes acciones:
Agregar (línea de detalle), Eliminar (Línea de Detalle).En este caso sí se puede
eliminar registro guardado en la base de datos.
Para cada registro se pueden modificar los siguientes datos:
 Línea [Caja de texto][Obligatorio][Numérico]: Es Editable. Por defecto se
muestra el valor actual del registro. Considerar las mismas restricciones y
validaciones indicadas en la inserción de un nuevo registro.
 Nombre Campo [Caja de texto][Obligatorio][Alfanumérico hasta 20
caracteres]: Es Editable. Por defecto se muestra el valor actual del registro.
Considerar las mismas restricciones y validaciones indicadas en la inserción
de un nuevo registro.
 Tipo Dato [Combo box][Obligatorio]: Es Editable. Por defecto se muestra el
valor actual del registro. Considerar las mismas restricciones y validaciones
indicadas en la inserción de un nuevo registro.
 Descripción a mostrar del Tipo de Dato [Caja de
texto][Obligatorio][Alfanumérico hasta 30 caracteres]: Es Editable. Por
 defecto se muestra el valor actual del registro. Considerar las mismas
restricciones y validaciones indicadas en la inserción de un nuevo registro.
 Descripción Campo [Caja de texto][Opcional][Alfanumérico y especiales
hasta 80 caracteres]: Es Editable. Por defecto se muestra el valor actual del
registro. Considerar las mismas restricciones y validaciones indicadas en la
inserción de un nuevo registro.
 Longitud [Caja Number][Opcional]: Es Editable. Por defecto se muestra el
valor actual del registro. Considerar las mismas restricciones y validaciones
indicadas en la inserción de un nuevo registro.
 Longitud Decimales [Caja Number][Opcional]: Es Editable. Por defecto se
muestra el valor actual del registro. Considerar las mismas restricciones y
validaciones indicadas en la inserción de un nuevo registro.
 Formato [Caja texto][Opcional] [Alfanumérico y especiales hasta 20
caracteres]: Es Editable. Por defecto se muestra el valor actual del registro.
Considerar las mismas restricciones y validaciones indicadas en la inserción
de un nuevo registro.
 Obligatorio [Check box] [Obligatorio]: Es Editable. Por defecto se muestra el
valor actual del registro. Considerar las mismas restricciones y validaciones
indicadas en la inserción de un nuevo registro.
 Columna [Caja de texto][Obligatoriol][Alfanumérico hasta 80 caracteres]:
Es Editable. Por defecto se muestra el valor actual del registro. Considerar las
mismas restricciones y validaciones indicadas en la inserción de un nuevo
registro.
 Incluir Suma Total [Check box][Obligatorio]: Es Editable. Por defecto se
muestra el valor actual del registro. Considerar las mismas restricciones y
validaciones indicadas en la inserción de un nuevo registro.
 Estado [Radio Button]: Es Editable. Por defecto se muestra el valor actual del
registro.

Si es necesario también se puede modificar los datos del detalle 2.

Sección Detalle 2
Tipos (Extensiones) Disponibles.
En la sección de aplicaciones, se muestran botones para las siguientes acciones:
Agregar (línea de detalle), Eliminar (Línea de Detalle).En este caso sí se puede
eliminar registro guardado en la base de datos.
Para cada registro se pueden modificar los siguientes datos:
 Tipo de Formato [Combo box] [Obligatorio]: Es Editable. Por defecto se
muestra el valor actual del registro. Considerar las mismas restricciones y
validaciones indicadas en la inserción de un nuevo registro.
 Descripción [Caja de texto][Obligatorio][Alfanumérico hasta 10 caracteres]:
Es Editable. Por defecto se muestra el valor actual del registro. Considerar las
mismas restricciones y validaciones indicadas en la inserción de un nuevo
registro.
 Considerar como extensión por defecto [Check box] [Obligatorio]: Es
Editable. Por defecto se muestra el valor actual del registro. Considerar las
mismas restricciones y validaciones indicadas en la inserción de un nuevo
registro.
  Estado [Radio Button]: Es Editable. Por defecto se muestra el valor actual del
registro. Considerar las mismas restricciones y validaciones indicadas en la
inserción de un nuevo registro.

Cuando se termine de ingresar todos los datos, tanto de la definición, estructura y

extensiones disponibles para un archivo entonces se procede a guardar el registro
y sus detalles correspondientes haciendo click en el botón Aceptar. La
modificación debe actualizar además de la información ingresada, los siguientes
datos de auditoría:
 Última Fecha de modificación: Fecha de la última modificación del
registro.
 Ultimo Usuario de modificación: Usuario que hizo la última modificación
del registro.
Estos datos de auditoría deben actualizarse tanto en la cabecera como en los
detalles, considerando en cuál parte se hicieron actualizaciones, es decir
actualizar esta información identificando donde se hicieron efectivamente los
cambios, si en uno de ellos o en ambos.

D) Ver un Registro
Para ver o consultar el detalle de un registro se debe ubicar el registro y hacer
click en el botón de acción correspondiente, esta acción muestra la misma
interfaz para Modificar un registro, con los datos de la Serie de Correlativos
seleccionado. Esta interfaz es de sólo visualización, es decir ningún campo es
editable. Además, se debe visualizar los datos de auditoría:
 Alta Aplicación:
 Alta Usuario
 Alta Fecha
 Última Fecha de modificación
 Ultimo Usuario de modificación

E) Descargar Formato
En esta opción se puede exportar o descargar el formato o plantilla de
importación de acuerdo con lo definido.