31082019 Mejoras Herramienta De Administración 3.x - Ejec. Script & Mig....

1|Página

Mejoras Herramienta de Administración 3.x Ejec. Script & Mig. De Datos

Agosto 2019

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

2|Página

Temario

Contenido

Temario ............................................................................................................................................... 2

Justificación ......................................................................................................................................... 3 Interfaz de la opción “Ejecutar Script” ................................................................................................ 5

Sección # 1. Tipo de Base de Datos (Maestra, Administrativo, Contabilidad, Nómina)................. 6 Sección # 2. Carga de Script (Predeterminados, Externos, Proc. Almacenados) ............................ 7

Ejecución de la opción “Migrar” – Suite 2K8 a Suite 2k12 ................................................................. 9 Descripción de la Mejora – Opción “Migrar Datos” ........................................................................ 9

Bondades incorporadas al Flujo del Proceso “Migrar Datos” .............................................. 11 Estructura del Log de Resultados .................................................................................................. 15

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

3|Página

Justificación

La dinámica que caracteriza la Administración de la Suite Profit Plus, la cual parte desde la instalación de las aplicaciones hasta la actualización/mantenimiento del sistema y sus

bases de datos; viene acompañada por las constantes mejoras que se incorporan a la suite.

De allí, la necesidad de homologar la “Herramienta de Administración” al crecimiento constante de los productos y brindar soluciones integrales a nuestros clientes; basadas estas en las bondades técnicas disponibles en C# & SQL Server. Por lo cual se incorporan desde el mes de Agosto las siguientes mejoras en la “Herramienta de Administración”: 

El rediseño de la Interfaz de la opción “Ejecutar Script”, incorpora secciones de

trabajo relacionadas con: o

El filtrado por Producto, para presentar solo las Bases de Datos y las Consultas asociadas a ellos - al igual que se considera el país usado en la conexión al momento de presentarlas.

o

La selección de manera explícita de los Tipos de Opciones Disponibles para cargar y ejecutar un Script (Consultas Predeterminadas, Archivos Externos, Store PRocedure).



La ejecución de la Opción “Migrar” usada para transferir datos de la suite 2k8 a

la Suite 2kDoce, incorpora en una sola acción la ejecución del proceso de “Migración de Datos” y por tanto: o o

Blinda la secuencia de pasos necesarios para la “Migración de los Datos”.

Garantiza el cumplimiento de los requisitos técnicos necesarios para realizar con éxito la transferencia de los datos a la Empresa Destino 2kDoce.

En resumen podemos mencionar que: el rediseño de la opción “Ejecutar Script” proporciona al usuario un ambiente de trabajo más intuitivo y amigable, ajustado a las operaciones que

desee realizar; mientras que las mejoras incorporadas en la opción “Migrar” desestiman los errores humanos al integrar todos los pasos técnicos del proceso de “Migración”

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

4|Página En el desarrollo del presente documento, se describen en detalle las mejoras señaladas en los párrafos anteriores.

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

5|Página

Interfaz de la opción “Ejecutar Script”

El uso de la opción “Ejecutar Script”, tiene como propósito el óptimo funcionamiento de la suite de productos Profit Plus y por ende de la configuración de los repositorios de Datos SQL asociados a su funcionamiento (Bases de Datos Maestras y Empresas del Cliente).

La ejecución de cualquier Script es una tarea delicada que amerita ser precisa y sencilla para el usuario; por tal razón, se incorporaron en la Interfaz de la opción “Ejecutar Script” un grupo de mejoras asociadas con la distribución de los datos presentados en ella

En base a esto, se ajustó el diseño de la pantalla, siendo más didáctica, porque orienta su funcionamiento hacia el proceso deseado, incorporando las siguientes secciones:  

Sección # 1. Tipo de Base de Datos (Maestra, Administrativo, Contabilidad, Nómina) Sección # 2. Carga de Script (Predeterminados, Externos, Proc. Almacenados)

A continuación se describen en detalle estas secciones, especificándose las bondades incluidas en cada una de ellas.

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

6|Página

Sección # 1. Tipo de Base de Datos (Maestra, Administrativo, Contabilidad, Nómina)

El filtrado de las Bases de Datos SQL existentes en el servidor, atendiendo a su naturaleza (Maestras ó de Datos: Administrativo, Contabilidad, Nómina), podrá realizarse mediante el filtro denominado “Tipos de Bases de Datos”.

Al seleccionar un ítem de la lista “Tipos de Base de Datos”, se filtran los repositorios de

datos disponibles en el manejador y la lista ubicada al extremo superior derecho de la pantalla mostrará sólo las bases de datos que correspondan con dicho filtro.

Tome en cuenta que:  

Se incorporó una etiqueta que indica el total de Bases de datos Disponibles en el

manejador y cuantas han sido seleccionadas.

Por defecto el “Tipo de Base de Datos” no posee selección alguna, por lo cual se

presentan todas las bases de datos asociadas con los Productos Profit Plus que posea registrada SQL Server.

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

7|Página

Sección # 2. Carga de Script (Predeterminados, Externos, Proc. Almacenados)

La “Carga de Script” dependiendo de su origen, es una nueva bondad que permite seleccionar de manera explícita: o Consultas Predeterminadas. o Rutas de Archivos Externos. o Procedimientos Almacenados. Cabe destacar, que las “Consultas Predeterminadas” serán visualizadas en función del Tipo de Bases de Datos seleccionadas, filtrándose automáticamente para presentar al usuario sólo los script que estén relacionados a estas; es decir, si se especifica una base de datos de Contabilidad al usuario sólo se le presentaran los scripts asociados con dicho producto. En la siguiente figura, se presentan las representaciones graficas que ilustran las opciones posibles de ejecutar para la Carga de Script.

Carga de Script

Consultas Predeterminadas

CRutas de Archivos Externos

Procedimientos Almacenados

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

8|Página

Una vez que el usuario ha seleccionado el Script a ejecutar, visualizará el código contenido en el mismo tal como en versiones anteriores.

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

9|Página

Ejecución de la opción “Migrar” – Suite 2K8 a Suite 2k12 Descripción de la Mejora – Opción “Migrar Datos”

La mejora incorporada desde el mes de Agosto del presenta año en la “Herramienta de Administración 3.x” concerniente a la ejecución de la opción “Migrar Datos” mantiene vigente la conceptualización de negocios del “Proceso de Migración de Datos” desplegado

durante el pasado mes de Julio, el cual consta de seis (06) pasos que culminan con el inicio

de operaciones; sin embargo, debemos resaltar que dichas mejoras simplifican su ejecución a tres (03) pasos tal como se visualiza en el siguiente gráfico.

Conceptualización de Negocios del Proceso de Migración Tratamiento de Datos x Migración Cerrar Procesos Empresa Origen 2K8

Crear Empresa Destino 2K12

Validar Consistencia Empresa Origen 2k8

Borrar Datos Empresa Destino 2K12

Migrar Datos

Culminar Configuración Empresa Destino 2kDoce

Pasos de la Migración de Datos Suite 2k8 – Suite 2kDoce Enfoque Herramienta de Administración

Crear Empresa Destino 2K12 Tratamiento de Datos x Herramienta Validar Consistencia Empresa Origen 2k8 Verificar Errores Empresa Origen 2K8 Borrar Datos Empresa Destino 2K12 Migrar Datos Configuración Empresa 2kDoce

Inicio de Operaciones Empresa 2k12

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

Inicio Operaciones Empresa 2kDoce

10 | P á g i n a Al enfocar la “Migración de Datos” desde la perspectiva de las mejoras incorporadas en la “Herramienta de Administración 3.x”, es preciso mencionar que la interacción realizada por

el usuario para la “Migración de Datos” de la suite 2k8 a la Suite 2kDoce se consolida en un solo evento luego de crear la Empresa Destino (ejecutar la opción “Migrar”), con dicha integración se busca:   

Obtener una ejecución más intuitiva, sencilla y por sobre todo consolidar las tareas

claves en un solo paso.

Lograr un menor número de conexiones a las diferentes bases de datos.

Incorporar la visión secuencial del proceso de ”Migración de Datos”, garantizando el

estricto cumplimiento de cada una de las tareas que conlleva dicho proceso y por ende elimina las posibilidades de error de parte del usuario.

La mejora asociada con la “Migracion de Datos” fue concebida para toda la suite de productos Profit Plus,

pero a quedado disponible sólo para el producto Profit Plus

Administrativo a partir de la version de Agosto 2019 y en próximas liberaciones para el resto de la suite.

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

11 | P á g i n a Bondades incorporadas al Flujo del Proceso “Migrar Datos”

Las mejoras realizadas a la opción “Migrar Datos” implican que con la conexión inicial a la Master creada al instalar la suite 2kDoce, se ejecuten en secuencia las siguientes tareas: 

La ejecución de la “Validación de la Empresa 2k8”.



La “Verificación de Errores en la Empresa Origen” como requisito indispensable



 

La “Generación de un Log de Resultados”. para continuar.

El “Borrado de Datos” de la Empresa Destino.

La “Migración de los Datos”, indicando el avance del proceso y en caso de

detenerse se muestra la última tabla y el último registro procesado.

El flujo del proceso de “Migración de Datos”, representado en forma gráfica se presenta a continuación.

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

12 | P á g i n a

Flujo del Proceso de Migración de Datos Herramienta de Administración 3.x

Confirmación de Ejecución de la Migración

Borrar Datos

Validación de Datos vs Evaluación de Errores - Log de Resultados

Migrar Datos

En función de dicho flujo, se describen seguidamente las bondades técnicos y funcionales

concernientes a la mejora realizada en la opción “Migrar Datos” – la cual llamaremos en este apartado “El Migrador”.

1. Al ejecutar el “Migrador”, comienza la “Validación de la Empresa Origen 2k8”,

porque ahora es capaz de ejecutar esta tarea y las consecuentes desde una única conexión; ahorrándole al usuario la incomodidad de tener que realizar una conexión

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

13 | P á g i n a para la “Validación” y otra para “Borrar los datos de la Empresa Destino 2kDoce” y así como para “Migar los Datos”.

2. En caso de fallar la “Validación”, el proceso se detiene; debido a que el flujo está integrado en una sola opción, entonces el “Migrador” solo ejecuta el paso siguiente una vez que el anterior haya culminado con éxito. De este modo, obliga al

usuario a corregir los problemas de data reflejados en la “Validación” antes de continuar al próximo paso.

3. El “Migrador” realiza el Borrado de Datos”. Una vez finalizada la “Validación” con éxito, en ese momento se procede a “Borrar los Datos en la Empresa Destino 2k12”;

si un usuario olvidaba este paso cuando se ejecutaba bajo el esquema anterior (de forma manual e independiente cada opción) con frecuencia terminaba en errores de infracción de primary_key debido a los datos remanentes en el destino.

4. Se ejecuta la “Migración de Datos” por bloques. El “Migrador” ya no ejecuta un Procedimiento Almacenado (Stored Procedure SP) de la Base de Datos Maestra sino que lee un Archivo de Recursos (Resource File) que esta compilado con la

“Herramienta de Administración” y por ende permite evaluar el progreso de cada uno de los bloques en forma independiente y muestra los errores en forma detallada en caso de presentarse.

5. El Avance del sub-proceso en curso se muestra en cada paso. La información

correspondiente al Avance General del proceso e Individual de cada Paso, se

visualiza en el cuadro de texto disponible en la parte central de la pantalla que se activa al inicial la “Migración”.

6. Dispone del registro automático de los “Resultados de la Migración en un

Log”. Considere que todo el proceso se escribe en el “Log de Resultados”, donde se registran los pasos ejecutados y los detalles en caso que ocurra un error.

Recuerde que al concluir estos pasos, sus datos se encontrarán transferidos a la

Suite 2kDoce y debe usted completar la configuración de los nuevos parámetros u Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

14 | P á g i n a

opciones disponibles en la versión, para poder iniciar las operaciones en la Empresa Destino 2kDoce.

Por último, es preciso mencionar que las opciones “Validar” y “Borrar Datos” se mantienen

activas; es decir, pueden ser utilizadas si el usuario así lo desea. Destacamos que el resultado de la validación también genera un “Log de Resultados”, siendo esto una mejora puntual incorporada en la versión actual de la “Herramienta de Administración 3.x”.

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

15 | P á g i n a

Estructura del Log de Resultados

El “Log de Resultados” contiene el detalle de las incidencias generadas durante los pasos de “Validar” y “Migrar Datos”, en cualquiera de los productos de la suite Profit Plus. En cuanto a la generación del “Log de Resultados”, es necesario mencionar lo siguiente: 

La ruta en la cual se almacena el archivo contentivo del “Log de Resultados”

corresponde con los estándares de instalación de la suite Profit Plus, siendo esta: Ruta: {Ruta de instalación de la Herramienta de Administración}\log. *Si la carpeta log no existe, será creada automáticamente.



El nombre de dicho archivo se genera al combinar las características de la base de

datos migrada con los datos de la fecha de ejecución del proceso. Siendo estos: 

Nombre de la Base de Datos Destino.



4 dígitos para el Año.

       

Carácter Piso.

2 dígitos para el mes. 2 dígitos para el día. Carácter Piso.

2 dígitos para la hora.

2 dígitos para el minuto.

2 dígitos para el segundo. Extensión txt.

*Ejemplo: DERMA_2K12_20190814_090000.txt 

El contenido del archivo “Log de Resultados”, varía según el sub-proceso ejecutado

y los resultados obtenidos; por ello se visualizan a continuación algunos ejemplos que ilustran eventos exitosos o fallidos.

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos

16 | P á g i n a

Ejemplos del Contenido del Log de Resultados Validación de Datos Exitosa

Error al Migrar Datos

Exito en Proceso Migrar Datos



En cuanto a los errores generados al ejecutar los sub-procesos de la “Migración de Datos” que son registrados en el “Log de Resultados”, debemos destacar que los mensajes de error y el bloque de código SQL que falla en cada caso - no se muestran en pantalla - sólo

en el log. De este modo, no se abruma al usuario con información excesiva durante el proceso; sin embargo, al momento de depurar el error cualquier personal calificado podrá analizar las causas exactas y su consecuente solución.

Gerencia de Tecnología. Mejoras Herramienta de Administración 3.x - Interfaz x Ejec. Script & Mig. De Datos