LEGACY SYSTEM MIGRATION WORKBENCH

Introducción
Las siglas LSMW significan Legacy System Migration Workbench.
LSMW es una herramienta para la transferencia de datos desde un sistema externo a
SAP.

Sus principales cualidades son:

 Para utilizar esta herramienta no es necesario saber programar en ABAP/4.
 Permite crear chequeos propios que garantizan la consistencia de los datos
importados.
 Permite seguir la importación de los datos paso a paso.

La carga de datos se hace a partir de un fichero que puede guardarse en local o en el

servidor de SAP. Los datos del fichero pueden estar separados por tabulador, coma,
punto y coma o cualquier otro carácter.

La ejecución de un LSMW puede ser manual o programada. Así pues, la carga puede
ser única o periódica. La ejecución programada supone la creación de un JOB de fondo
y, en este caso, es imprescindible que el fichero del que se leen los datos esté en el
servidor.

Antes de utilizar la herramienta LSMW es imprescindible:

1. Determinar si el volumen de datos es lo suficientemente grande como para
que sea necesario el uso de LSMW, ya que si no es así, es más conveniente
introducirlos de forma manual.
2. Identificar qué transacción u objeto estándar se va a usar para cargar los
datos en SAP.
3. Dada la transacción u objeto estándar, conocer los campos obligatorios que
marca la parametrización o el estándar.
4. Determinar cuál es la forma en que los campos origen —que se reciben por
fichero— se van a transferir a los campos destino —datos necesarios en la
transacción—.

Técnicas de migración
LSMW permite dos técnicas de importación de datos:
 Migración por objeto estándar:
La ventaja en este caso es que el flujo de pantallas puede variar según la
información que se esté cargando. Por ejemplo, cuando se pretenden cargar
materiales de distintos tipos o proveedores con distintos grupos de cuentas.
Los objetos estándar que LSMW permite son BAPIs, IDocs y Direct Inputs.
 Migración basada en una grabación de transacción:
La ventaja en este caso es que el número de datos necesarios suele ser reducido y
las transacciones que se pueden usar son muchas.
La desventaja mayor es que el flujo de pantallas tiene que ser fijo para todos los
registros del fichero de carga, no puede depender de los datos de entrada.
Transacción inicial
Para empezar a trabajar con LSMW, usa la transacción LSMW. A continuación
selecciona o crea un objeto LSMW para trabajar con él y pulsa ENTER.

Pantalla principal
Proyecto: Agrupación de objetos LSMW. Se puede utilizar para agrupar los distintos
orígenes de los ficheros de datos. Ejemplo: PDM, Prisma, WEB,… (máximo 10
caracteres).
Subproyecto: Subgrupo de objetos LSMW dentro del proyecto. Se puede utilizar para
agrupar por módulos SAP. Ejemplo: FI, MM, SD,… (máximo 10 caracteres).
Objeto: Nombre del objeto LSMW. Se debe utilizar uno que resulte significativo, que
describa lo que se va a transferir (máximo 10 caracteres).

BOTONES:
 All objects: para visualizar todos los objetos LSMW del sistema.
 My objects: para visualizar los objetos LSMW creados por mí.
 All object of Project: para visualizar todos los objetos del proyecto en forma de
árbol.
MENÚ:
 GOTO ADMNINISTRATION
Para administrar los valores fijos, la grabación, las transformaciones de un
LSMW. Se usará para borrar objetos que no nos valgan.
 GOTO  RECORDING
Para crear, visualizar o modificar las grabaciones.
 EXTRAS  EXPORT/IMPORT PROJECT
Para transportar de un sistema a otro los LSMWs creados. No se utilizan
órdenes de transporte.
Pantalla del LSMW
 User Menu: Definir el menú de usuario.
 Numbering On: Visualizar / Ocultar el nº de paso
 Double Clic display /Double Clic change: Decidir si se quiere entrar modificando
o visualizando al hacer doble-clic en cada paso.
 Object Overview: Lista de los datos del LSMW
 Action Log: Historial de la ejecución del LSMW por día, hora, usuario y paso.
PASO 0 — Creación de la grabación
Desde la pantalla inicial de la transacción LSMW ir por menú siguiendo la ruta GOTO

 RECORDGINGS.

En el listado de las grabaciones que aparece se permite:

 Crear una grabación nueva

 Modificar, visualizar, copiar, renombrar o borrar una grabación que ya existe.

Para crear una grabación nueva es necesario rellenar:

 El nombre de la grabación (sin espacios)
 Una descripción significativa
 Código de la transacción
Al pulsar ENTER se inicia la grabación y al pulsar en grabar, finaliza. Entonces
aparece una pantalla en la que deberemos especificar:
- Nombres de los campos.
- Descripción de los campos.
- Valores por defecto, si son necesarios.
 Valores por Nombres de
Descripción
defecto los campos

Al finalizar, antes de salir, es necesario salvar la grabación hecha.

PASO 1 — Definición de los atributos

En este paso se define el tipo de objeto —en nuestro caso ‘BATCH INPUT RECORDING’— y
el modo en el que se van a importar los datos.
Pasos a seguir:
a. Elegir si la forma de ejecución:
b. Elegir el tipo de objeto LSMW que se quiere crear. Para el caso de grabaciones
marcar la opción ‘BATCH INPUT RECORDING’.
c. Asignarle la grabación creada pulsando en la ayuda. También pueden verse todas

las grabaciones del proyecto pulsando en .

d. Grabar y volver
PASO 2 — Creación de las estructuras
En este paso se define el nombre de la estructura que recibirá los datos del
fichero:

a. Pulsar para crear una nueva estructura.

b. Elegir un nombre y una descripción para la estructura que recibirá los datos del
fichero.
c. Grabar y volver

PASO 3 — Definición de campos

En este paso se definen los campos que debe contener la estructura definida en el
paso anterior.
Es importante definir los campos en el orden en el que van a ser pasados desde el
fichero y con exactamente la misma longitud que los datos del fichero.
Por cada nuevo campo a definir:

Pulsar
1. para crear una nueva estructura
Rellenar el nombre del campo, la descripción, la longitud y el tipo de datos
2.
(casi siempre será ‘C’).
Observaciones:
• Conviene usar los mismos nombres que se usaron en la definición de la
grabación para después facilitar el mapeo.
• LSMW permite que la lista de campos se importen con sus formatos desde
una tabla de diccionario, desde un fichero de texto separado por
tabulaciones o desde otro objeto LSMW (SOURCE FIELDS  COPY FIELDS).
• LSMW permite la creación de los campos de la estructura en modo tabla,

pulsando .
PASO 4 — Relación entre estructuras
En este paso se define la relación entre la estructura origen y la estructura
destino.
La estructura origen es la que se ha definido en los dos pasos anteriores.
En la pantalla aparece la estructura destino, que lleva el mismo nombre que se le dio
a la grabación de BI creada.
Para definir la relación hay que situarse encima de la estructura destino y pulsar
.
En nuestro caso, como sólo hay una estructura origen y una estructura destino, ya
aparece asignada y sólo hay que grabar y volver .

Para asegurarse de que no hay errores en la asignación, pulsar . En caso de

error se puede utilizar para borrar la asignación hecha.

PASO 5 — Reglas de conversión
En este paso se define la relación entre los campos de la estructura origen y la
estructura destino. Al acceder se muestran todos los campos de la estructura
destino —la de la grabación—.
Posicionando el cursor en cada uno de los campos tenemos la siguiente información
disponible:
• Documentación estándar del campo
• Valores posibles

• Documentación para el campo 

Para asignar a un campo de la estructura destino, un campo de la estructura origen:
a. Situarse encima del campo de la estructura destino dentro del árbol de la
pantalla.
b. Pulsar
c. Elegir en el popup que se muestra el campo de la estructura origen que
queremos asignarle haciendo doble-clic en él.
Para borrar una asignación hecha:
a. Situarse encima del campo de la estructura destino dentro del árbol de la
pantalla.

b. Pulsar
Después de crear las asignaciones a todos los campos necesarios, pueden definirse

reglas de conversión y chequeos adicionales . Las reglas de conversión

básicas que nos ofrece SAP son las siguientes:
• INITIAL: si no se quiere considerar el dato que se obtiene del fichero.
• CONSTANT: si se le quiere dar siempre un valor constante.
• PREFIX: si se quiere concatenar el valor del fichero con un prefijo.
• SUFIX: si se quiere concatenar el valor del fichero con un sufijo.
• CONCATENATION: cuando a un mismo campo destino se le asignan dos
campos orígenes, se pueden concatenar esos dos campos para asignárselo
después al campo destino.
• TRANSFER LEFT-ALIGNED: si se quieren borrar los espacios que puedan
venir a la derecha del dato de fichero.
• MOVE WITH LEADING ZEROS: si se quieren eliminar o añadir los ceros
necesarios para que SAP interprete correctamente el dato de fichero.
• ONLY IF SOURCE FIELD NOT INITIAL: sólo se ejecuta la asignación si el
campo de fichero no viene vacío.
PASO 6 — Valores por defecto y coding
En este paso se definen reglas que podrán ser utilizadas para cualquier objeto
LSMW que pertenezca al mismo proyecto. Para crear reglas basta situarse encima
del tipo de regla que se desee y pulsar . Las posibilidades que ofrece SAP son
las siguientes:
• Valor fijo: sirve para definir constantes que se usarán en el objeto LSMW.
Los datos necesarios son el nombre de la constante, una descripción, su
longitud y el valor que toma.
• Traducciones: sirven para transformar los valores de entrada en otros
valores de forma automática.
• Rutinas de usuario

PASO 7 — Ficheros entrada / salida

En este paso se definen los ficheros que se van a utilizar en los pasos siguientes:
• La ruta del fichero que contiene los datos.
• La ruta del fichero en el que se cargan los datos después de leídos desde el
fichero original.
• La ruta del fichero en el que se cargan los datos después de ser
convertidos.
Los dos últimos los propone SAP y no es conveniente modificarlos.
Para darle al LSMW la ruta del fichero desde el que leerá los datos, hay que
situarse en ‘Legacy data’ y pulsar . Los datos que hay que rellenar son los
siguientes:
Ruta para el
fichero

Nombre

Marcar si el
fichero contiene
datos para una
tabla o para
más de una.

Especificar el
separador que
delimita los
campos del
fichero

¿El fichero contiene cabecera con los

nombres de los campos?
¿El orden de los campos del fichero coincide
con el de la estructura origen definida?

No modificar
 El fichero de entrada puede estar guardado en local (
) o en el servidor de R/3 (
).
Lo más común es que el fichero contenga un indicador de fin de fichero y los datos
sean de tipo ASCII.
Si la ejecución del objeto LSMW se produce de forma periódica (Job de fondo), es
imprescindible que el fichero esté en el servidor (TC: AL11).
Una vez indicado la ruta del fichero que contiene los datos, su nombre, separador y
demás propiedades, grabar y volver .

PASO 8 — Asignación de ficheros

En este paso se asignan los ficheros definidos en el paso anterior a las estructuras
que recibirán los datos de entrada.

Para ello basta situarse encima de la estructura y pulsar . Si se

definieron varios ficheros, SAP los mostrará en un popup y habrá que seleccionar el
que corresponda. Si sólo se definió un fichero, SAP propone automáticamente la
asignación.
Al finalizar, grabar y volver .

PASO 9 — Carga, visualización y conversion de datos

En este paso comienza la ejecución del LSMW.
1. Lectura de datos: Al ejecutar, el sistema lee los datos del fichero
especificado y los carga en el fichero de lectura según la estructura origen
definida.
Si no se desea leer todo el contenido del fichero se puede especificar cuántos
registros se desea cargar.
SAP ofrece dos check-boxes marcados por defecto. El primero indica que los
datos de tipo importe se transformarán automáticamente en formato para
cálculo. El segundo que las fechas se convertirán en formato interno
AAAAMMDD.
2. Visualización de los datos leídos: En este paso se puede visualizar los datos
leídos en el paso 1. Es conveniente no saltarse este paso y visualizar algunos de
los registros cargados para comprobar que no ha habido errores.

3. Conversión de datos: Al ejecutar, los datos que fueron leídos en el paso 1 se

procesan según las reglas de conversión definidas en el LSMW.

4. Visualización de los datos convertidos: En este paso se visualizan los datos

convertidos en el paso 4. Es conveniente no saltarse este paso y visualizar
algunos de los registros convertidos para comprobar que no ha habido errores.

5. Creación de la sesión de BI: Al ejecutar, SAP genera un juego de datos con

el nombre especificado al comienzo del proceso. Este BI puede ser visualizado y
ejecutado desde la transacción SM35.
6. Ejecución de la carga por BI: Si no se desea acceder a la SM35 para
ejecutar el juego de datos creado en el paso 5, LSMW permite ejecutar el
juego de datos directamente en este paso.
EJEMPLOS:
PROYECTO: ZLSMW
SUBPROYECTO: ZLSMW

1. OBJETO — ZLSMW_MM02
Grabación: MM02
Estructura destino : MM02
Estructura origen : ZMM02 Modificación descripción material
Campos de la estructura origen:
MATNR C(018) Material
MAKTX C(040) Descripción
FECHA DDMY(010) Fecha

2. OBJETO — ZLSMW_XK02
Grabación: XK02
Estructura destino : XK02
Estructura origen : ZXK02 Modificación descripción material
Campos de la estructura origen:
LIFNR C(010) Número de cuenta del proveedor o
acreedor
BUKRS C(004) Sociedad
EKORG C(004) Org. Compras
LAND1 C(003) Clave de país
NAME1 C(035) Nombre 1
ORT01 C(035) Población
ZTERM C(004) Clave de condiciones de pago