Download IMPORTADOR DE DATOS

Document related concepts
no text concepts found
Transcript
IMPORTADOR DE DATOS
V.2.0 EUROWIN
IMPORTADOR DE DATOS| V.1.0 EUROWIN
1
Índice
Importador de AHORA: .............................................................................................................................. 3
Objetivo ....................................................................................................................................................... 3
Pasos Previos ............................................................................................................................................. 3
Características............................................................................................................................................ 3
Inicio del Importador .............................................................................................................................. 5
Tabla: Ahora_Procesos_Importacion ................................................................................................. 9
Tabla: Ahora_Procesos_Importacion_Instalar ................................................................................ 9
Tabla: Ahora_Procesos_Importacion_Ejecutar ............................................................................... 9
IMPORTADOR DE DATOS| V.1.0 EUROWIN
2
Importador de AHORA:
Objetivo
Tener una herramienta que, preparando procesos de bases de datos de importaciones
que se vuelven repetitivas, pueda ejecutarse desde un solo lugar sin tener que hacerlo
desde el analizador y nos dé la información suficiente para poder captar posibles fallos.
Pasos Previos
Debemos tener una BBDD intermedia, que en estos momentos está generando el
Distribuidor OLINET, quien nos proporciona siempre una BBDD EW2XXX.bak
Debemos preguntar al solicitante de la importación la versión de AHORA 4.x a la que
quiere importar (nunca debe ser una versión no liberada). También hay que solicitar la
versión de SQLServer que tiene montada el cliente para no dar una versión superior y
que no puedan restaurar.
Debemos restaurar en el servidor de SQL correspondiente una Ahora_vacia, con la
versión indicada y la BBDD de Eurowin.
Una vez restauradas las BBDD, hay que seguir los siguientes pasos con los srcripts que
están en la carpeta \\datos\ahora3\Modulos\ImportadorBBDD\EUROWIN OLINET\V 4.0
y \\datos\ahora3\Modulos\ImportadorBBDD respectivamente
1. En la BBDD de Eurowin pasar el script que instalará una serie de vistas y funciones
necesarias para realizar la importación:
 “PImportacion_39375_EUROWIN_AHORA_ORIGEN_00_VISFUN”,
2. En la BBDD de destino, hay que pasar los siguientes scripts:
 “PImportacion_39375_EUROWIN_AHORA_DESTINO.sql”
Si el paso del script sobre la base de datos origen fallara, hay que ver dónde está el error
y modificar dicho script, para ajustarlo a dicha base de datos, ya que puede haber
cambios de una base de datos a otra.
Características
Procedimientos de importación:
Una vez cargados los procesos de instalación, procederemos a ejecutar los procesos de
importación. Es necesario que haya una función de comprobaciones previas a la
importación que devuelva en el formato especificado, explicado más adelante, los errores
que prevemos que pueden ocurrir y devuelva en un rango de 0 a 5 el rango de gravedad.
En esta escala, 5 es un error crítico de importación que, de darse, impediría que se
pudiera realizar.
Todos los procesos de importación deben devolver el resultado de su ejecución en el
formato explicado más adelante, para dar información al usuario que está ejecutando la
IMPORTADOR DE DATOS| V.1.0 EUROWIN
3
aplicación, sobre los posibles problemas que ocurran y sobre cuál es el punto en el que
ocurren.
Debemos tener en cuenta que éste es simplemente un programa ejecutor de
procedimientos que deben trabajarse para cada tipo de importación. Existen unos
procesos predefinidos en el estándar del Ahora a partir de la versión 4.0.X que son los
que se van a ejecutar:
En la parte de instalación, se ejecutan en este orden:


PImportacion_EUROWIN_AHORA_INST_01_CTab: Crea tablas personalizadas
para datos del Eurowin que no se corresponden con ahora, para que luego cada
implantador pueda decidir con el cliente dónde ponerlo en Ahora.
PImportacion_EUROWIN_AHORA_INST_00_CONF: Crea campos configurables
para introducir campos que nos faltan en algunas tablas, como campos
configurables no intervienen en ningún proceso, si se necesita algún proceso
cada implantador deberá tratarlos según el cliente.
En la parte de ejecución, se ejecutan en este orden:








funComprobacionesIntegridad: función que comprueba datos en Origen y
devuelve una tabla con los errores encontrados. Si la gravedad es 5 no se podrán
continuar a no ser que se arreglen los datos, pues fallaría la importación. Esta
función devuelve en uno de sus campos la SQL de comprobación, con lo que
podemos copiarla y pegarla en el analizador de SQLServer y ver qué datos son
erróneos.
PImportacion_EUROWIN_AHORA_00_PREPROCESOS: Ejecuta una serie de
procesos necesarios para la importación. Principalmente borra datos que vienen
en la vacía como cuentas, subcuentas,…
PImportacion_EUROWIN_AHORA_01_MAESTROS @@BDOrigen: Pasa los
maestros de la aplicación desde la BBDD origen a la BBDD destino
PImportacion_EUROWIN_AHORA_02_CONTACTOS @@BDOrigen: Pasa los
contactos de clientes y proveedores de la BBDD origen a la destino
PImportacion_EUROWIN_AHORA_03_DOCSCLI @@BDOrigen: Pasa ofertas,
pedidos, albaranes, contratos y facturas de cliente de la BBDD origen a la destino.
PImportacion_EUROWIN_AHORA_04_DOCSPROV@@BDOrigen:
Pasa
pedidos, albaranes y facturas de proveedores de la BBDD origen a la destino.
PImportacion_EUROWIN_AHORA_05_CONTAB @@BDOrigen: Pasa carteras
de clientes y proveedores, apuntes y libro de IVA de la BBDD origen a la destino.
PImportacion_EUROWIN_AHORA_06_INVENTARIO @@BDOrigen: Genera
tantos inventarios como almacenes tengamos con stock y los regulariza.
Todos estos procesos devuelven una tabla con lo que están ejecutando, de forma que si
falla alguna, podemos copiar el campo SQLEjecutada de la tabla y pegar en el analizador
para ver qué error ocurre.
A continuación, explicamos el funcionamiento del importador de datos:
IMPORTADOR DE DATOS| V.1.0 EUROWIN
4
Inicio del Importador





SERVIDOR en el que se tienen que encontrar las bases de datos origen
(EUROWIN) en este caso y Destino (Ahora).
BBDD Origen: aquí se encuentran los datos que queremos importar.
BBDD Destino: BBDD de Ahora vacía.
Usuario: usuario administrador del servidor de SQL.
Contraseña: Contraseña del usuario administrador.
En los datos de conexión, hay que seleccionar el tipo de importación que queremos
realizar. En este caso tenemos definida una importación de EUROWIN.
IMPORTADOR DE DATOS| V.1.0 EUROWIN
5
El importador tiene dos pasos:
1. Copiar procesos: que se iniciará con el botón “Comenzar”
2. Ejecución de storeds: que se iniciará con el botón “Importar”. No se habilitará si no
se han copiado correctamente los procesos.
Al pulsar el botón “Comenzar” se cargarán las vistas/storeds/funciones en las BBDD
configuradas, y se irán checkeando en verde si se han volcado correctamente.
Cada importación se puede definir como se quiera, siempre que tengan unas storeds de
instalación y otras de importación.
Si los procedimientos que se ejecutan en el botón “Comenzar” (tabla
Ahora_procesos_importación_instalar) fallan, no será posible continuar, pues no se
habrán instalado correctamente los procesos necesarios para la importación.
IMPORTADOR DE DATOS| V.1.0 EUROWIN
6
El primer punto que debe pasar es una función de comprobaciones de integridad. Esta
función debe devolver una tabla con la siguiente estructura:






TablaO VARCHAR(255) : Tabla origen de la comparación de integridad.
TablaD VARCHAR (255): Tabla destino de la comparación de integridad.
Grave int: Nivel de gravedad de la integridad. Si es 5 dará errores de importación.
Solucion Varchar(255): lo que hará la importación en caso de no arreglarla.
Num int: Número dentro de la función para saber la comparación que se está
haciendo.
SqlComprobación varchar(max): SQL que se ha utilizado para la comprobación.
[leer más]
Si alguno de los avisos que devuelve tienen gravedad 5 no se seguirá con el proceso de
importación, ya que fallará seguro, en el resto de casos, se indica qué conlleva el que no
se tenga dicha integridad.
IMPORTADOR DE DATOS| V.1.0 EUROWIN
7
La rejilla de abajo va indicando las acciones que se están realizando en la importación. Si
el estado está checkeado es que no ha habido ningún problema. Si no es así, aparecerá
una X en rojo en la parte izquierda, y el estado de la instrucción que ha fallado (en la
parte derecha) no estará checkeado.
Si falla algún proceso de la importación, esta parará y se dará como fallida.
La estructura que deben devolver todas las storeds que se ejecuten será:





Id int: identificador dentro del proceso.
Nombre Varchar(255): sobre que tabla estamos actuando.
Acción varchar(50): inserción, borrado, actualización.
SQLEjecutada varchar(max): Sentencia SQL que se ha pasado.
Estado bit : 1 ejecución con éxito, 0 ha habido errores.
IMPORTADOR DE DATOS| V.1.0 EUROWIN
8
El importador, para su correcto funcionamiento necesita tres tablas que describimos a
continuación:
Tabla: Ahora_Procesos_Importacion
IdImportacion: int
Descripcion:Varchar(255)
Tendrá tantos registros como importaciones programemos.
Ejemplo:
IdImportacion
1
Descrip
EUROWIN MALAGA
Tabla: Ahora_Procesos_Importacion_Instalar
IdImportacion
Idlinea
Descrip
EjecucionEnOrigen
Script
EsStored
Orden
int: identificador de la importación
int: identificador de la línea
varchar (250): Descripción del proceso, se ve desde el
importador
T_Booleano: Se ejecuta en la bbdd origen
varchar(max): Nombre del script a ejecutar para instalar
los procesos
T_Booleano: 1 si es Stored Procedure, 0 si es función de
BBDD
int: orden de ejecución, en el que salen en el importador
Tabla: Ahora_Procesos_Importacion_Ejecutar
IdImportacion
IdProceso
Descrip
StoredBBDD
EjecucionEnOrigen
EsStored
ParamBBDDOrigen
Comprobaciones
Orden
int: identificador de la importación
int: identificador del proceso
varchar(250): Descripción , sale en el importador
varchar(1000): Nombre del proceso o función
T_Booleano: Si se ejecuta en origen
T_Booleano : Si es stored Procedure 1 o función 0
T_Booleano: Si necesita que se pase el nombre del la
BBDD Origen
T_Booleano: si es una función de comprobación de datos
int: Orden de ejecución y el en el que sale en importación
IMPORTADOR DE DATOS| V.1.0 EUROWIN
9
[OBSERVACIÓN]
En este manual se muestra la primera versión del importador. En siguientes versiones
aparece el campo que marcado con * y además se podrá realizar una importación
automática o por pasos de forma que, si falla un paso y lo arreglamos, podamos seguir a
partir de un punto y no empezar desde 0 la importación.
IMPORTADOR DE DATOS| V.1.0 EUROWIN
10
IMPORTADOR DE DATOS| V.1.0 EUROWIN
11