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. info@macroproyectos.com (+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