Tutorial LSMW LEGACY SYSTEM MIGRATION WORKBENCH

1. Legacy System Migration Workbench.......................................................................2 2. Creacin del proyecto...........................................................................................................3 3. Grabacin de la transaccin.................................................................................................4 4. Parmetros Carga..........................................................................................................10 5. Lectura y Conversin Datos...........................................................................................23 de de

6. Transporte del LSMW a otros sistemas..............................................................................29

1. Legacy System Migration Workbench

Esta herramienta sirve para crear los programas de carga de datos maestros y algunos saldos iniciales para la mayora de los mdulos de SAP. En trminos generales, sta herramienta permite grabar la creacin del primer registro y con esto se crea el programa de carga de datos; luego hay que ligar los campos de SAP con las columnas que tenemos en nuestro archivo excel (grabado como .txt). Esto hay que hacerlo una sola vez, luego se puede ejecutar el programa las veces necesarias.

El acceso a la herramienta es mediante la transaccin LSMW, digtela en la lnea de comandos.

Esta primera pantalla es de informacin y puede marcar que el sistema no la vuelva a mostrar. Presione Enter o para continuar.

2. Creacin del proyecto Para crear el programa, debe definir primero un proyecto, sub-proyecto y objeto. El estndar que utilizaremos es:

Proyecto: el mdulo al que corresponda este programa Sub-proyecto: clasificacin tal como datos maestros, saldos iniciales, etc. Objeto: tipo de dato que est creando

Si an no ha creado alguno de estos objetos, escriba los cdigos y presione en el icono de Crear nuevas entradas y el sistema mostrar unas ventanas donde le podr ingresar la descripcin:

Digtelo y presione Enter para continuar.

3. Grabacin de la transaccin Ahora tenemos que grabar la transaccin correspondiente al dato maestro que se quiere grabar; para esto, siga la ruta en el men Goto B Recordings

El sistema lo lleva a la pantalla de resumen de las grabaciones. Si desea modificar o visualizar una grabacin ya existente, mrquela con el cursor y presione el icono Edit recording o Display recording .

Para crear una nueva, presione el icono de crear nuevas entradas Create recording.

Debe identificar la grabacin con un cdigo y descripcin. Presione Enter para continuar. Para facilidad al identificar las grabaciones, identifquela con el mismo cdigo de la transaccin.

El sistema pedir ahora el cdigo de la transaccin SAP que desea grabar. Recuerde verificar el cdigo de la transaccin antes de empezar la grabacin.

Digite el cdigo de la transaccin SAP y presione Enter para continuar. El sistema lo llevar a la pantalla correspondiente a la transaccin indicada. Ingrese los datos que se deben actualizar en la carga de datos. Los datos que se dejen en blanco no sern incluidos en la grabacin, sin embargo, usted podr agregarlos en el futuro (esto se explica ms adelante en el manual). Recuerde ingresar datos reales y vlidos, pues ste dato ya quedar grabado en el sistema.

Nota: Como este primer registro est siendo creado con un logon en ingls, los textos de este registro deben ser actualizados en su prximo logon en espaol.

Al terminar la creacin del registro maestro, el sistema mostrar una pantalla con todos los campos introducidos en la transaccin que acaba de grabar. Aparecen los nombres tcnicos de los campos, presione el icono Default all para que aparezca la descripcin de los campos en la parte derecha de la pantalla.

Si desea agregar un campo, ubique el cursor en la lnea donde quiere agregar el campo y presione el icono Add screen field.

El sistema mostrar los campos disponibles para agregar por default, seleccinelo haciendo dobleclick sobre el campo, o marcndolo y presionando Enter.

Si la lista anterior no contiene el campo que se desea agregar, usted puede aadirlo manualmente si conoce el nombre tcnico del campo. Para esto, siga la ruta Edit B Add screen field (extended).

El sistema mostrar una ventana en la que usted debe introducir el nombre tcnico del campo que desea agregar. Digtelo y presione Enter.

El nuevo campo se agreg debajo de la lnea donde se haba ubicado el cursor al insertarlo. Presione nuevamente el icono Default all para ver la descripcin del campo.

En ocasiones, algunos de los campos que incluimos en la grabacin no provienen del diccionario de datos sino que han sido definidos directamente para la pantalla y por esta razon al presionar default all no aparece la descripcin. Para este ejemplo esto ocurre con los campos G_PASSWORD1 Y G_PASSWORD2 y, donde la descripcin aparece vaa y debemos digitarla manualmente para que sean incluidos en el proceso.

Ingresamos manualmente el nombre y descripcion del campo.

Grabe los cambios con el icono Save. Con esto, qued grabada la transaccin y los campos que van a ser cargados. Si desea hacer alguna modificacin posterior, puede entrar por la misma ruta y seleccionar el icono de Change Recording. Para regresar al proyecto definido antes, presione el cono Back dos veces.

4. Parmetros de Carga Ahora hay que definir en el sistema los parmetros de carga de datos. En la pantalla inicial del LSMW, presione Enter o Ejecutar para continuar.

Aparecen los pasos que hay que ejecutar para definir la carga de datos. A medida que se vayan ejecutando stos pasos, el sistema ir seleccionando el siguiente paso a ejecutar. En cada uno de ellos, presione el icono Ejecutar.

El primer paso es Maintain object attributes, en el que debemos indicar qu grabacin corresponde a este proyecto-subproyecto-objeto. Por default, el sistema presenta todos los pasos en opcin visualizacin, por lo cual debe pasarse a opcin de modificacin antes de hacer algn cambio.

En el caso del ejemplo que estamos creando, es necesario indicar que la carga de datos es peridica (1), que corresponde a una Grabacin para Batch Input y dar el nombre de la grabacin que ya creamos (2).

Haga los cambios y presione el icono Save para grabar los cambios (3).

Regrese a la lista de pasos y ejecute el siguiente: Maintain source structures, en el cual se debe crear el nombre de la estructura de los datos que se van a cargar.

Cambie a la opcin de modificacin y seleccione el icono Create structure para crear el nombre de la estructura de datos.

Ingrese el nombre y descripcin de la estructura y presione Enter para continuar.

Grabe los datos mediante el icono Save.

Regrese a la lista de pasos y ejecute Maintain source fields, en el cual se debe crear la lista de campos del archivo plano del que se van a cargar los datos.

Al entrar a la opcin, aparece el nombre de la estructura creada anteriormente. Pas a la opcin de visualizacin para poder agregar los campos. Presione el icono Create field para agregar un nuevo campo; el sistema crear el nuevo campo debajo de la lnea donde se encuentra el cursor.

Ingrese un cdigo, descripcin, longitud y tipo de campo (carcter, fecha, etc) y presione Enter para continuar. Ni el cdigo ni la descripcin tienen que ser las mismas que en el archivo plano. Lo que s es importante es que los campos estn en el mismo orden que las columnas en el archivo.

Tambien es posible definir los campos a travez de una tabla. Esto se hace presionando el botn

El sistema presentara una interface de tipo tabla similar a las vistas de actualizacin. En ella se piueden adicionar varios campos a la vez siendo especialmente util cuando se manipulan estructuras grandes con multiples campos.

Al terminar la creacin de todos los campos, presione el icono Save para grabar los cambios. He aqu un ejemplo de algunas de las columnas del archivo plano. En este caso, estamos trabajando los datos en un archivo excel.

Regrese a la lista de pasos y ejecute Maintain structure relations.

Pase a la opcin de modificacin y grabe la opcin, no es necesario hacer ningn cambio

Regrese a la lista de pasos y ejecute Maintain field mapping and conversin rules para establecer la relacin entre los campos de la pantalla indicados en la grabacin de la transaccin y los campos creados en la estructura.

Al entrar a este paso, aparecen todos los campos (nombre tcnico) que se ingresaron en la grabacin de la transaccin que hicimos al principio. Pase a la opcin de modificacin para poder ligar estos campos a la estructura de datos.

Ubique el cursor en el campo de la grabacin que quiere ligar y seleccione el icono Assign source field para indicar el correspondiente campo en la estructura del archivo plano.

El sistema mostrar en una ventana la lista de campos de la estructura de datos; seleccione el que quiera ligar al campo de la transaccin grabada. Por ejemplo, si estamos ligando el campo Username in user master record (nombre tcnico= BNAME), debemos seleccionar el campo Username. Presione Enter para continuar.

Esta operacin se repite para asignar las columnas correspondientes de la estructura de entrada para todos los campos de la transaccin. . Al terminar, presione el icono Save para grabar todos los cambios.

Despus de haber grabado, puede hacer cambios. En este ejemplo, vamos a asignar un valor constante al campo TITLE_MEDI de tal manera que ste campo no tiene que existir en el archivo plano y en la estructura de datos., para hacer esto seleccionamos el campo y presionamos el boton Constant En la ventana que aparece a continuacin escribimos el valor constante que seria la palabra Mr.

En el resumen, se puede verificar la asignacin del valor fijo: Grabe los cambios presionando el icono Save.

Regrese a la lista de pasos. El sistema propone el paso Maintain fixed values, translations, userdefine routines, el cual no vamos a utilizar en esta carga de datos.

De la lista de pasos, ejecute Specify files para indicarle al sistema la ubicacin del archivo plano donde se encuentran los datos que se van a cargar.

Pase a la opcin de modificacin y presione Create entry para especificar la procedencia de los datos. En nuestro ejemplo, seleccione la opcin de On the PC para indicar que el archivo se encuentra en el disco duro o la red.

El sistema mostrar una ventana donde se debe especificar la ubicacin del archivo (ruta completa), el delimitador, el orden de los campos y el tipo de archivo.

Nota: Las especificaciones que se den aqu, deben corresponder con las caractersticas del archivo plano. Como especificamos que el delimitador era Comma, debemos grabar el archivo excel en formato CSV(delimitado por Comas) (*.csv) para que pueda ser grabado. Tambien debemos tener en cuenta que se indico que la primera linea contiene los nombres de las columnas.

Al terminar, grabe los cambios presionando el icono Save.

Regrese a la lista de pasos y ejecute la opcin Assign file.

Cambie a la opcin de modificacin y grabe las entradas con el icono Save, no es necesario hacer cambios pues el sistema propone el archivo especificado en el paso anterior.

Con esto, quedan listas las especificaciones para la carga de datos.

5. Lectura y Conversin de Datos

Ya teniendo todos los parmetros para la carga de datos, procedemos a leer los datos del archivo plano. Para esto, ejecute el paso Read data de la lista de pasos.

El sistema presenta una pantalla en la que se debe indicar qu datos se van a leer, esto es, si no desea leer el archivo completo, se puede delimitar qu lneas del archivo se van a leer. El archivo plano de ejemplo archivo plano tiene una lnea de ttulo de columnas/campos, se debe leer de la lnea 2 en adelante, ya que los ttulos no se van a cargar. En este ejemplo, vamos a cargar slo los datos de las lneas 6 y 7. Despus de indicar las lneas a leer, presione el icono Ejecutar para efectuar la lectura de los datos.

Se mostrar un resumen de los datos encontrados y ledos; en este ejemplo, el archivo contiene 10 lneas, pero slo se leyeron 2, tal como se indic en la pantalla anterior.

Regrese a la lista de pasos para ejecutar Display read data, a fin de verificar los datos ledos por el sistema. Este paso no es obligatorio, pero se recomienda que durante las primeras pruebas, se verifiquen los datos ledos.

Al solicitar la visualizacin de los datos ledos, se puede restringir la cantidad de datos a desplegar. Si deja en blanco el lmite inferior y superior, el sistema desplegar todos los datos ledos en el paso anterior. Presione Enter para continuar. El sistema muestra la lista de datos ledos.

Regrese a la lista de pasos para ejecutar Convert data, con lo cual se convertirn los datos del formato en que se leyeron, al formato de la transaccin SAP. Esto se hace mediante las reglas establecidas en el paso Maintain field mapping and conversion rules explicado anteriormente.

Presione Ejecutar para continuar. En este paso tambin se puede delimitar los registros que se van a convertir; si deja en blanco los lmites inferior y superior del rango, el sistema convertir todos los datos ledos en el paso anterior.

Presione Ejecutar para realizar el proceso de conversin de datos. Nota: El proceso de conversin aplica sobre los datos ledos en la ltima lectura, independientemente de cundo se haya realizado sta. El sistema mostrar un resumen de los datos encontrados y convertidos; en este ejemplo, se haban ledo 2 registros y se convirtieron los mismos dos registros.

Regrese a la lista de pasos para ejecutar Display converted data, a fin de verificar los datos convertidos por el sistema. Este paso no es obligatorio, pero se recomienda que durante las primeras pruebas, se verifiquen los datos convertidos para confirmar que las definiciones se hayan hecho correctamente.

Presione Ejecutar para continuar. En este paso tambin se pueden delimitar los datos que se desea visualizar; si deja en blanco el rango, el sistema mostrar todos los datos convertidos en la paso anterior. Se despliegan los datos en el formato ya convertido.

Regrese a la lista de pasos y ejecute Create batch input session para generar el juego de datos que se va a cargar en el sistema mediante una sesin en batch. Presione Ejecutar para continuar.

El sistema presenta por default los parmetros de generacin de los juegos de datos. El Name of the BI session, es el nombre del juego de datos que se va a generar. Presione Ejecutar para continuar.

El sistema presenta un mensaje indicando que se ha creado el juego de datos.

Regrese a la lista de pasos, slo queda pendiente por ejecutar el procesamiento del juego de datos, Presione ejecutar

El sistema muestra el resumen de los juegos de datos pendientes de procesar. Marque el juego de datos a procesar y presione el icono Process.

Para este ejemplo, vamos a ejecutar como proceso en modo mostrar errores unicamente.

Si presionamos sesion overwiew podemos ver el resultado de la ejecucin.

Seleccionamos la sesin y presionamos doble click.

Si verificamos ahora con la transaccin SU01 veremos que los dos usuarios se han creado con la informacin indicada en la plantilla.

A continuacion se adjuta la plantilla utilizada para este ejemplo:

PLANTILLA USUARIOS.CSV