MANUAL DE USUARIO: SOFTWARE MIGRADOR DE SCRIPTS .SQL ORACLE PARA BASES DE DATOS SQLSERVER EN LA EMPRESA EXPINN

TECHNOLOGY

Brallam Santiago Morales García Jineth Tatiana Camacho Aya

Universidad Distrital Francisco José de Caldas Facultad Tecnológica

Tecnología en sistematización de datos Bogotá, Colombia

2017

TABLA DE COTENIDO

1. OBJETIVOS DEL SOFTWARE ............................................................................ 4

2. INGRESAR AL SOFTWARE ................................................................................ 5

3. VER/OCULTAR PANEL DE VISUALIZACIÓN ..................................................... 7

4. CARGAR ARCHIVO ............................................................................................ 8

5. PROCESAR ARCHIVO...................................................................................... 10

6. GENERACIÓN DE ARCHIVO ............................................................................ 11

7. PANEL DE CONFIGURACIÓN .......................................................................... 13

TABLA DE ILUSTRACIONES Ilustración 1. Ubicación de carpeta del software ...................................................... 5

Ilustración 2. Ejecutar programa .............................................................................. 5

Ilustración 3. Interfaz del software ........................................................................... 6

Ilustración 4. Ver panel de visualización .................................................................. 7

Ilustración 5. Cargar archivo .................................................................................... 8

Ilustración 6. Error al cargar archivo ........................................................................ 8

Ilustración 7. Carga correcta de archivo .................................................................. 9

Ilustración 8. Carga de contenido en el panel de visualización ................................ 9

Ilustración 9. Error al procesar archivo .................................................................. 10

Ilustración 10. Mensaje de procesamiento terminado ............................................ 10

Ilustración 11. Procesamiento en el panel de visualización ................................... 10

Ilustración 12. Error al generar archivo .................................................................. 11

Ilustración 13. Guardar archivo .............................................................................. 11

Ilustración 14. Generación correcta de archivo ...................................................... 11

Ilustración 15. Contenido del archivo generado en el panel de visualización ........ 12

Ilustración 16 Visualización del contenido del archivo generado ........................... 12

Ilustración 17. Panel de configuración ................................................................... 13

Ilustración 18. Ejemplo configuración de procesamiento ....................................... 14

4

1. OBJETIVOS DEL SOFTWARE

Suministrar una herramienta migrador de scripts .SQL Oracle a SQL Server en la empresa Expinn Technology. Módulo de lectura En primer lugar se encuentra un módulo que permite la carga, lectura y almacenamiento dinámico del contenido de los scripts de entrada .SQL que contiene instrucciones DDL desarrolladas en Oracle que son proporcionadas por la empresa y que posteriormente son procesadas en el módulo de procesamiento.

Módulo de procesamiento En segundo lugar se encuentra un módulo para el procesamiento del script de entrada, que analiza las líneas de código PL/SQL y genera el nuevo código para SQL Server, adicionalmente guarda el contenido dinámicamente para el módulo de escritura.

Módulo de escritura

Como tercer y último se encuentra el módulo de escritura, que es el encargado de generar el script .SQL para SQL Server y realizar la escritura del código procesado y generado en el módulo de procesamiento.

5

2. INGRESAR AL SOFTWARE

En el sistema operativos Windows, se debe ubicar la carpeta contenedora del software. Desde la barra de tareas vamos a dar en inicio Equipo Unidad extraíble. (Dicha unidad puede ser una unidad de CD, pendrive, etc. que contiene el proyecto) y vamos a la ubicación de la carpeta del proyecto

Ilustración 1. Ubicación de carpeta del software

Luego de haber ubicado el proyecto ingresamos a la carpeta “dist” y allí damos clic derecho y luego en abrir al archivo “Proyecto_G_MVC”.

Ilustración 2. Ejecutar programa

6

Luego de ejecutar el archivo mencionado visualizaremos la interfaz del software.

Ilustración 3. Interfaz del software

7

3. VER/OCULTAR PANEL DE VISUALIZACIÓN

Por default el programa al abrirlo contiene el panel de visualización oculto, para poder mostrarlo, seleccionamos en el icono de la flecha naranja ubicado en la parte superior derecha, se deberá ver de la siguiente forma.

Ilustración 4. Ver panel de visualización

Como se puede observar el icono ha cambiado y la flecha ahora está en el sentido contrario si la seleccionamos como resultado obtendremos la interfaz inicial. Para términos de la ejecución del programa, se dejara el panel de visualización abierto.

8

4. CARGAR ARCHIVO

A continuación seleccionamos el botón cargar archivo y allí se abrirá un cuadro de dialogo para abrir el archivo.

Ilustración 5. Cargar archivo

Aquí se debe seleccionar el archivo que contiene instrucciones de base de datos ORACLE (DDL), por defecto el programa filtra los archivos con extensión .sql (.SQL) se debe tener en cuenta que dicho archivo debió haber sido generado previamente por el mismo motor de base de datos. El archivo debe tener extensión .sql (.SQL), sino visualizaremos el siguiente error.

Ilustración 6. Error al cargar archivo

Luego de dar en aceptar en cuadro volverá para cargar un archivo volverá amostrarse, si damos en cancelar se serrará el cuadro, si se carga un archivo .sql se mostrara un error de que se cargó correctamente.

9

Ilustración 7. Carga correcta de archivo

Luego de ello además podremos ver el contenido del archivo, en el panel de visualización.

Ilustración 8. Carga de contenido en el panel de visualización

Como se puede ver se observa el contenido del archivo y en la cabecera del mismo se muestra que es el contenido del archivo que se cargó, también se puede navegar dentro del panel de visualización, para ver todo el código que se ha cargado.

10

5. PROCESAR ARCHIVO

Antes de poder procesar un archivo debe haberse cargado previamente sino mostrara el siguiente error.

Ilustración 9. Error al procesar archivo

Si hemos cargado previamente un archivo, el programa empezara a realizar el procesamiento y luego de que termine de hacer el procesamiento veremos el siguiente mensaje.

Ilustración 10. Mensaje de procesamiento terminado

Luego podemos consultar el panel de visualización y podremos ver que hay una sección llamada “procesamiento de archivo” y luego se visualiza el procesamiento de cada alinea de código.

Ilustración 11. Procesamiento en el panel de visualización

11

6. GENERACIÓN DE ARCHIVO

Antes de poder generar un archivo este debe haberse cargado y procesado previamente, en caso de no haberse cargado se mostrara el error de la ilustración 9, en caso de no haberse procesado se mostrara el siguiente error.

Ilustración 12. Error al generar archivo

Si hemos cargado y procesado un archivo, el programa abrirá un cuadro de diálogo para poderle da run nombre al archivo y seleccionar la ruta en la que queremos guardarlo; por defecto el programa añade la extensión .sql.

Ilustración 13. Guardar archivo

Luego de ello visualizaremos un mensaje de que el archivo se ha generado correctamente.

Ilustración 14. Generación correcta de archivo

12

También podemos ver que el contenido que se ha escrito en nuestro archivo creado, se puede ver en el panel de visualización una sección llamada “Contenido del archivo generado”.

Ilustración 15. Contenido del archivo generado en el panel de visualización

Por último, para confirmar la generación del archivo iremos a la ruta en la que se guardó y podremos visualizar el contenido del mismo.

Ilustración 16 Visualización del contenido del archivo generado

13

7. PANEL DE CONFIGURACIÓN

Por default el programa al abrirlo contiene el panel de configuración oculto, para poder mostrarlo, seleccionamos el botón que dice “ver panel de configuración”, independiente de que se encuentre el panel de visualización abierto este lo serrar ay mostrara el panel de configuración.

Ilustración 17. Panel de configuración

En el siguiente panel se muestran las configuraciones de visualización y las de procesamiento del archivo.

A continuación se explican las configuraciones de visualización:

En la selección de RadioButton “Guardar contenido procesado” se refiere a que independientemente del proceso que se ejecute (procesar y generar), nunca elimine el contenido anterior del panel de visualización. Esta opción aplica también para cargar archivo, sin embargo el CheckBox “Eliminar después de cada ciclo” debe estar desmarcada.

En el CheckBox de “Eliminar después de cada ciclo” indica que el contenido se borre del panel de visualización cada vez que se carga un archivo, esto con la finalidad de que en la migración de código se pueda visualizar el contenido cargado, el procesamiento y el generado.

14

En tanto a la configuración en la sección de procesamiento los CheckBox que se ven están orientados a las estructuras que migra el software (Tablas, vistas, funciones, Procedimientos, Triggers), por defecto siempre están marcados lo que indica que siempre se van a procesar todas las estructuras, si se deselecciona algún CheckBox, la estructura asociada a ese CheckBox no será procesada.

Ilustración 18. Ejemplo configuración de procesamiento

En la imagen se muestra una nueva configuración para el procesamiento de las estructuras contenidas en el archivo de carga. Independiente de las estructuras que se encuentren en el archivo de carga (tablas, vistas, funciones, procedimientos y triggers) el programa solo va realizar el procesamiento sobre las tablas, del mismo modo, en el panel de visualización solo se verá el procesamiento de las tablas y en el archivo generado solo se verá código generado para las tablas.