Guía Para Subir Archivos Planos a Storm-User

Guía Para Subir Archivos Planos a
Storm-User
CONTRALORIA DE BOGOTA
SIVICOF
3.5.0
Sistema de Diligenciamiento, Validación Y Análisis
Proyecto: Manuales Técnicos
Documento: Guía para subir archivos planos a Storm-User
Revisó:
Fecha Revisión:
Aprobó:
Nasly Pereira
03-04-2014
Versión:
1.0
Fecha Aprobación:
MACRO PROYECTOS
STORM
Página 2
MACRO PROYECTOS
STORM
Contenido
INTRODUCCIÓN ........................................................................................................................................................4
1.
Carga de archivo plano .....................................................................................................................................5
1.1 Excepciones ........................................................................................................................................................5
1.2 Ejemplos .............................................................................................................................................................6
1.2.1 Ejemplo 1 .........................................................................................................................................................6
1.2.2 Ejemplo 2 .........................................................................................................................................................7
Historial de Revisiones .................................................................................................................................. 10
Página 3
MACRO PROYECTOS
STORM
INTRODUCCIÓN
El presente documento define el diligenciamiento y pasos a llevar a cabo para subir archivos planos a Storm
User para su posterior validación, generación y envío del archivo a enviar.
La funcionalidad de carga de formularios a partir de archivos planos por medio de la herramienta Storm User
permitirá a los usuarios cargar más de cincuenta mil (50.000) registros para ser procesados en la aplicación.
Página 4
MACRO PROYECTOS
1.
STORM
Carga de archivo plano
Al abrir una modalidad que se encuentra habilitada para un Sujeto de Control en la herramienta Storm User, se
puede visualizar un botón para carga de archivos planos ubicado en la barra de herramientas estándar como se
puede visualizar en la figura 1.
Figura 1: Barra de Herramientas Estándar - Botón Carga Archivo Plano
Seleccionar el botón de carga de archivo plano permitirá indicar la ruta y el nombre del archivo plano que
contiene los datos del formulario a alimentar.
El archivo plano debe llevar la siguiente estructura:
El nombre del archivo debe coincidir con el código del formulario a cargar.
1. La extensión del archivo debe ser .txt.
2. El archivo no debe llevar línea de encabezado (nombre del formulario ni títulos de
columnas, etc).
3. Cada campo (o celda de cada columna) que se alimentará debe separarse con una línea
vertical o pipeline (|) de los demás campos.
4. Cada salto de línea implica una nueva fila.
5. Una línea sin caracteres (ni espacios) implica un cambio de sección o bloque.
6. Un valor de celda nulo no debe llevar dato entre los separadores (||)
7. Se deben conservar las características de los campos del formulario para que estos se
carguen adecuadamente; esto depende de cada formulario.
8. Las celdas con tipo de dato parámetro (lista desplegable) deberán llevar el código del
parámetro.
9. Las celdas con tipo de dato fecha deben tener estructura AAAA/MM/DD (con 4 dígitos para
año, 2 para mes y 2 para año y con separador de barra oblicua).
10. Las celdas con tipo de dato booleano (checkbox) que van marcadas deben llevar el texto
VERDADERO; las que no van marcadas deben llevar el texto FALSO.
1.1 Excepciones
Si en el archivo plano se asigna a una celda un tipo de dato que no corresponde al que tiene configurado en el
Storm User, al cargar el archivo plano la herramienta deja esta celda en blanco; por ejemplo, cuando se
adiciona en un campo numérico datos alfabéticos, así como se muestra en la figura 2.
Página 5
MACRO PROYECTOS
STORM
Figura 2: Storm User – Tipo de Dato No Correspondiente
Otro caso sucede cuando asignamos en el archivo plano una fecha que no existe en las celdas de tipo de dato
fecha, el Storm User validará la celda señalando esta con un color rojo, como se muestra en la figura 3.
Figura 3: Storm User – Fecha Inválida
En los casos anteriormente mencionados, al realizar los procesos de asignación y validación, sí los campos
vacíos son obligatorios aparecerá la validación de “falta diligenciar celda obligatoria”, como también se
visualizará la respectiva validación cuando la fecha no es válida en una celda de tipo de dato fecha.
1.2 Ejemplos
1.2.1 Ejemplo 1
Se tiene un formulario con celdas de tipo de dato fecha, numérico, alfabético, carácter, verdadero o falso y
parámetro (lista desplegable), como se visualiza en la figura 4.
Figura 4: Storm User – Ejemplo
El archivo plano debe estar construido de la siguiente manera, como se visualiza en la figura 5.
Figura 5: Archivo plano – Ejemplo
Al seleccionar el botón de carga de archivo plano en la herramienta Storm User, permitirá indicar la ruta y el
nombre del archivo plano que contiene los datos del formulario;, al realizar el cargue del mismo, nos mostrará
la información contenida en él, como se visualiza en la figura 6.
Página 6
MACRO PROYECTOS
STORM
Figura 6: Storm User – Carga Datos
En el caso de las celdas con tipo de dato parámetro (lista desplegable), el archivo plano puede llevar solo el
código del parámetro o también el código y el nombre del mismo, así como se visualiza en el Excel que se
exporta de la herramienta (ver figuras 7 y 8).
Figura 7: Excel – Ejemplo Parámetro
Figura 8: Archivo plano – Ejemplo Parámetro
1.2.2 Ejemplo 2
En el caso que un formulario esté compuesto por dos secciones, el archivo plano deberá construirse de la
siguiente manera:
1|Abcd|5
6||3
7|xyz|5
2|xyz|2
Suponiendo que las líneas anteriores implican un archivo, este cargará datos para tres columnas, donde la
primera es numérica, la segunda alfanumérica o carácter y la tercera numérica.
La segunda fila de la primera sección no lleva datos para la segunda columna.
Página 7
MACRO PROYECTOS
STORM
A la primera sección se le están cargando 3 filas.
La cuarta fila implica un cambio de sección.
La quinta fila implica datos para una sola fila de la sección 2.
Página 8
MACRO PROYECTOS
STORM
Página 9
MACRO PROYECTOS
STORM
Historial de Revisiones
Fecha
03-04-2014
Versión
1.0
Descripción
Guía para subir archivos planos a Storm User
Autores
Nasly Pereira.
Página 10
MACRO PROYECTOS
STORM
MACRO PROYECTOS LTDA
Carrera 7 Bis A # 124-40
Bogotá D. C.
Colombia.
[email protected]
(+571) 4780022
www.macroproyectos.com
STORM -Sistema de Diligenciamiento, validación y análisis de información, está protegido por Derechos de
Autor – República de Colombia.
Derechos Reservados, CopyRight ©.
Prohibida su reproducción total o parcial.
Página 11