Apostila LSMW
Apostila LSMW
Apostila LSMW
ndice:
1
INTRODUO..................................................................................................................................................... 5
1.1
CONVERSO......................................................................................................5
1.2
VANTAGENS E DESVANTAGENS................................................................................6
LSMW.................................................................................................................................................................. 7
2.1
2.2
PRINCIPAIS FUNES..........................................................................................7
2.3
FUNES ADICIONAIS..........................................................................................7
2.4
AUTORIZAO...................................................................................................7
TRANSAO...................................................................................................................................................... 9
3.1
TIPOS DE LSMW............................................................................................................................................... 12
4.1
BATCH INPUT...................................................................................................12
4.1.1
4.2
DIRECT INPUT..................................................................................................15
4.2.1
4.3
IDOC.............................................................................................................18
4.4.1
5
BAPI.............................................................................................................16
4.3.1
4.4
MAINTAIN
OBJECT ATTRIBUTES..............................................................................19
5.2
MAINTAIN
SOURCE STRUCTURES............................................................................20
5.3
MAINTAIN
SOURCE FIELDS...................................................................................21
5.4
MAINTAIN
STRUCTURE RELATIONS...........................................................................23
5.5
MAINTAIN
5.6
MAINTAIN
5.7
SPECIFY
FILES..................................................................................................27
5.8
ASSIGN
FILES..................................................................................................29
5.9
READ
DATA.....................................................................................................29
5.10 DISPLAY
READ DATA...........................................................................................30
5.11 CONVERT
DATA.................................................................................................31
5.12 DISPLAY
CONVERTED DATA................................................................................32
5.13 CREATE
SESSION.................................................................................34
5.14.1
Processamento Vsivel............................................................................................. 35
5.14.2
Exibir S Erros.......................................................................................................... 35
5.14.3
Background............................................................................................................... 35
5.14.4
OUTRAS ETAPAS............................................................................................................................................. 38
SUGESTES E DICAS...................................................................................................................................... 40
EXERCCIOS..................................................................................................................................................... 41
8.1
- BATCH INPUT.................................................................................................41
8.2
- DIRECT INPUT...............................................................................................42
8.3
BAPI........................................................................................................43
8.4
IDOC.......................................................................................................43
1 I NTRODUO
LSMW (Legacy System Migration Workbench ambiente de trabalho para migrao de sistemas legados)
uma ferramenta desenvolvida para o ambiente R/3 que suporta a transferncia de dados de um sistema noSAP (sistema legado) para um sistema SAP. Essa transferncia pode ser realizada somente uma vez ou
periodicamente.
A ferramenta suporta converso de dados de um sistema legado de uma maneira conveniente. Os dados
podem ser importados para um sistema SAP via batch input, direct input, BAPIs ou IDocs, que so tcnicas
de importao padro. Alm disso, o LSMW prov uma funo de gravao (recording) que permite gerar um
objeto de migrao de dados em uma transao de entrada ou em uma transao de atualizao.
1 .1
C ONVERSO
A figura abaixo mostra as etapas de migrao de dados de um sistema legado para um sistema SAP.
Legacy data
on PC
Read data
Read data
Structure
relations
Field mapping
Legacy data
on application
server
Convert data
Converted
data
Direct Input
processing
IDoc inbound
processing
R/3 Standard
Batch Input
processing
Conversion
rules
21
Primeiramente realizada a extrao de dados dos sistemas legados. Essa etapa gera um ou mais arquivos
que sero utilizados como entrada no LSMW. Os dados lidos dos sistemas legados so introduzidos no
LSMW que, por sua vez, realiza a converso para os sistemas SAP.
Essa converso baseada em estruturas, mapeamento de campos e regras de converso. Por exemplo, o
nmero identificador de um fornecedor no sistema legado pode ser definido como o seu CGC. Para o R/3
esse nmero no apropriado para ser uma chave primria para fornecedores. Logo, a converso de dados
deveria transformar um nmero de CGC para um nmero identificador no R/3. Esse apenas um exemplo
da incompatibilidade que existe entre os diversos sistemas legados e o R/3 da SAP.
Uma vez que os dados foram convertidos, gerado um arquivo de converso que ser utilizado para a etapa
de carregamento dos dados (loading). Essa terceira etapa pode ser realizada utilizando-se algumas tcnicas
padro, sendo que as mais comuns so o batch input e o direct input. A tcnica de batch input faz o
carregamento de dados no R/3 atravs das telas de uma transao SAP. Para isso feito um recording
ensinando o sistema quais campos devem ser preenchidos e quais telas ele deve chamar automaticamente.
Isso feito apenas uma vez com dados de testes. No momento da carga real as pastas de batch input so
processadas em background para poupar recursos e interao do usurio. O processamento das pastas de
batch input fazem a insero dos dados que se encontram no arquivo convertido nos respectivos campos
das telas de uma determinada transao. Quando cada transao termina, os dados so efetivamente
inseridos nas tabelas do sistema R/3.
Ao contrrio dessa tcnica, existe o direct input que realiza a insero diretamente em tabelas especficas do
R/3.
1 .2
V AN T AG E N S
E D E S VAN T AG E N S
Necessidade de treinamento e preparao dos usurios, alm de conhecimento bsico de Abap para
criao de programas mais elaborados.
2
2 .1
LSMW
O
Q U E A F E R R AM E N T A
LS MW ?
O Legacy System Migration Workbench (LSMW) uma ferramenta utilizada para o suporte a migrao de
dados dos Sistemas No-SAP tambm conhecidos como Sistema Legado (Legacy System) - para o SAP
R/3. um componente do Sistema R/3 e, portanto, independente da plataforma, podendo ser utilizada em
qualquer verso do R/3.
2 .2
P R I N C I PAI S F U N E S
O LSMW compreende as seguintes funes principais:
Definio das estruturas do Sistema Legado e seus Campos;
Definio das dependncias de objeto e atribuio das regras de converso;
Os relacionamentos da estrutura e campos com o Sistema de Legado e o Sistema R/3 so definidos no
mapeamento dos dados. Do mesmo modo que realizado na transao SHDB;
Customizao da Migrao (As regras de converso so definidas para serem flexveis. Na Customizao
da Migrao, elas podem ser adaptadas para uma situao especfica);
Converso de dados (A partir das dependncias dos objetos, o LSMW gera programas de converso que
traduzem os dados do sistema de legado);
Importao de dados;
Os dados podem ser importados para o Sistema SAP atravs desta ferramenta via processos de Batch
Input, Direct Input, BAPIs ou IDocs.
2 .3
FUNES ADICIONAIS
As seguintes funes adicionais esto disponveis:
Interface com planilha (Os dados do Sistema de Legado no formato de planilha podem ser processados).
Host interface (Os dados do Sistema de Legado em um formato estruturado - com identificadores de
registro e seqncia correta) podem ser processados.
Funes de check automticas (Esta funo gera e realiza a checagem de valores contra tabelas de check
e valores fixos especificados no Dicionrio de Dados.
2 .4
A UTORIZA O
Autorizao
Perfil
Funo
Display
B_LSMW_SHO
W
Execute
B_LSMW_EXE
C
Change
B_LSMW_CHG
Administrate
B_LSMW_ALL
3 T RANS AO
Para acessar a ferramenta LSMW do SAP, utilize a transao LSMW:
3 .1
PROJETO, SUBPROJETO
OBJETO
Atravs da transao LSMW, podemos criar novos Projetos, Subprojetos e Objetos atravs do Menu Edit
Create new entry.
Projeto: Identificador com no mximo de 10 caracteres pode ser criado para denominar o Projeto de
Converso de Dados.
Criando um projeto
Subprojeto: Identificador com no mximo de 10 caracteres pode ser criado para compor a estrutura do
projeto.
Criando um subprojeto
Objeto: Identificador com no mximo de 10 caracteres pode ser criado para nomear o Objeto de Negcio a
LSMW.
4 T IPOS
4.1
DE
LSMW
BATCH INPUT
O processo "Batch Input Recording" o processo mais utilizado nas converses de dados, pois atravs dele
podemos mapear qualquer transao SAP.
Ao mapearmos uma transao devemos definir o "Recording", que o mapeamento de uma determinada
transao que o usurio deseja atualizar.
Para visualizarmos todos os Recordings, devemos clicar no cone Recordings: Overview.
Recordings
4 .1 . 1 C O M O
C R I A R , A LTE R A R E D E L E T AR
(Create Recording).
Em seguida, informar o nome e a descrio que ser dado ao mapeamento, conforme a figura abaixo. Depois de
nomear o mapeamento e clicar em Continue, ser aberta a janela para indicar o cdigo da transao que ser
chamada durante a execuo deste objeto:
Criando um recording
Insira o cdigo da transao que queira mapear:
Mapeando a transao
O mapeamento deve ser executado, simulando a alterao que se deseja. importante informar valor em todos os
campos que se deseja mapear para que eles sejam relacionados no objeto.
A figura abaixo um exemplo de um mapeamento realizado com a transao F-02. Aps a gravao ter sido
realizadas, deve-se clicar no cone
campo SAP e para que eles sejam visualizados na etapa 5 Maintain Field Mapping and Conversion Rules. Aps
as validaes das informaes, clique em Save e Back at retornar tela de inicial.
Ao selecionar esta funo, o seguinte pop-up abrir, e dever ser escolhida a opo Screen Field e colocar a
combinao tabela-campo, como indicado:
campo inserido.
4.2
DIRECT INPUT
Direct Input o processo standard, que utiliza programas de processamento Batch criado pelo SAP. Esses
programas foram pr-definidos com o objetivo de facilitar a converso de dados mestres e transacionais,
possuindo todos os campos mapeados de uma determinada transao SAP e suas validaes.
Os programas standards possuem muitas telas e requerem conhecimento funcional para identificar quais campos
sero carregados.
4 .2 . 1 C O M O
C R I A R , A LTE R A R E D E L E T AR
Para criar, devemos selecionar Standard Batch/ Direct Input e escolher o Object e methold desejado. O Program
name e Program type so preenchidos automaticamente aps a seleo do Object e o Methold.
Para alterar, devemos selecionar outro Object e Methold. E para apagarmos devemos escolher outro processo.
BAPI
BAPI - Business Application Programming Interface uma interface programtica remota para acessar aos SAP
Business Objects que cobrem a maioria dos processos de negcio. O objetivo principal de BAPI conseguir a
integrao entre o sistema R/3 e as aplicaes, os sistemas externos, etc.
4 .3 . 1 C O M O
C R I A R , A LTE R A R E D E L E T AR
Para criar, devemos selecionar Business Object Method (BAPI) e escolher o Business Object e Methold desejado.
O Message type e Basic type so preenchidos automaticamente aps a seleo do Business Object e o Methold.
Para alterar, devemos selecionar outro Object e Method. E para apagarmos devemos escolher outro processo.
4.4
IDOC
IDocs (originais intermedirios) foi desenvolvido trocando mensagens entre sistemas diferentes (SAP SAP;
R/3 R/2; SAP non-SAP system). Estas aplicaes do SAP tambm podem ser usadas transferindo
dados. Para fazer isso, entretanto, so necessrios alguns ajustes e preparaes.
4 .4 . 1 C O M O
C R I A R , A LTE R A R E D E L E T AR
Para criar, devemos selecionar IDoc (Intermediate Document) e escolher o Message type e Basic type desejado.
Para alterar, devemos selecionar outro Message type e Basic type. E para apagarmos devemos escolher outro
processo.
5 C OMO
Esta ferramenta est dividida em vrias etapas; abaixo aprenderemos como utiliz-las.
5.1 M A I N T A I N
OBJECT ATTRIBUTES
Nesta etapa devemos definir um dos processos do captulo passado para executar a converso, e proceder
como j foi explicado.
-
Direct Input
Batch Input
BAPI
IDOC
5.2 M A I N T A I N
SOURCE STRUCTURES
Nesta etapa devemos definir quais estruturas utilizaremos para associar com a estrutura da ferramenta. Para
definir a estrutura do arquivo, precisamos indicar o nome, a descrio e a relao hierrquica das estruturas.
Clicar em Display - Change e em seguida clicar no cone Create a Structure. Indicar a relao abaixo e
Confirmar.
Criando estrutura
Para criar mais de uma estrutura necessrio escolher a relao entre elas.
Same Level: esta opo para criar uma estrutura do mesmo nvel.
SOURCE FIELDS
Nesta etapa devemos definir os campos que utilizaremos para armazenar os dados vindos do arquivo.
Existem duas maneiras de se inserir os campos de origem:
1. Posicionar o cursor sobre a estrutura que receber o campo (em amarelo) e clicar em
(Table
Selecione a primeira opo Upload (Text Separated with Tabs), e o seguinte aviso aparecer:
para importar
Ou seja, o arquivo a ser importado deve ser um TXT com os campos na seguinte ordem e separados por
tab: Nome do campo (campo SAP com 5 caracteres), Descrio, Tipo e Comprimento. Exemplo: Crie os
campos em Excel, e depois salve como Text (tab delimited) (*.txt):
\
Salvar como Text (tab delimited) (*.txt)
Selecione um arquivo e clique em Open:
Ao importar, estar pronta a sua estrutura de campos:
STRUCTURE RELATIONS
Nesta etapa devemos definir a relao entre as estruturas do arquivo com as estruturas da ferramenta.
5.5 M A I N T A I N
Nesta etapa devemos definir a relao entre os campos da estrutura do arquivo com os campos da estrutura
da ferramenta.
Devemos selecionar
(Display Variant) para visualizar as rotinas. atravs delas que criamos variavis, tabelas
internas e lgicas internas. Selecione todas e clique em OK.
Nesta etapa devemos definir as tabelas DE_PARA para utilizarmos na Convert data.
5.7 S P E C I F Y
FILES
Nesta etapa devemos definir qual arquivo utilizaremos para capturar os dados.
Ao clicar em
(Change)
Devemos escolher o separador dos dados corretos para que a ferramenta consiga ler os dados do arquivo
corretamente.
Tabulator: tabulador
Semicolon: ponto-e-vrgula
Comma: vrgula
Space: espao
5.8 A S S I G N
FILES
Nesta etapa devemos definir qual arquivo utilizaremos para cada estrutura do arquivo.
Caso tenhamos mais de um arquivo, devemos relacionar os arquivos s estruturas atravs do boto
.
5.9 R E A D
DATA
Nesta etapa devemos ler os dados do arquivo que sero armazenados nas estruturas do arquivo.
READ DATA
Nesta etapa podemos ver os dados lidos em cada campo correspondente e identificar os erros. A seguinte
tela aparecer ao clique duplo no Passo 10 Display Read Data:
Dados importados
Ao clicar duplamente em uma linha, so mostradas em detalhe as informaes daquele registro:
DATA
Nesta etapa devemos converter os dados lidos que sero armazenados na estrutura da ferramenta e
identificar os erros.
Converter dados
Ao clicar no boto
CONVERTED DATA
Nesta etapa podemos ver os dados convertidos em cada campo correspondente e identificar os erros. A
seguinte tela aparecer ao clique duplo no Passo 12 Display Converted Data:
Dados convertidos
Ao clicar duplamente em uma linha, so mostradas em detalhe as informaes daquele registro:
Nesta etapa devemos criar as pastas de Batch Input, caso o processo seja via Batch Input Recording.
5.14 R U N B A T C H I N P U T
SESSION
Nesta etapa devemos executar as pastas de Batch Input, caso o processo seja via Batch Input.
. O
Tipos de processamentos
5 .1 4 .1 P R O C E S S A M E N T O V S I V E L
No Processamento Visvel, possvel checar passo-a-passo a execuo da carga, pois a tela da transao se
torna visvel. recomendvel executar a primeira linha em Processamento Visvel e depois usar os outros mtodos
mais rpidos. Caso queira rodar a carga toda em modo visvel, mantenha o ENTER pressionado para agilizar.
5 .1 4 .2 E X I B I R S E R R O S
Nesta opo, possvel rodar a carga em background, ou seja, sem a visualizao da transao na tela do
computador, mas quando houver um erro, a tela abrir sua frente, permitindo analisar qual o erro gerado, e
permitindo a alterao do valor errneo por um valor vlido.
5 .1 4 .3 B A C K G R O U N D
Nesta opo, possvel rodar a carga em background. Esse o modo mais rpido de execuo de um Batch
Input.
5 .1 4 .4 A N L I S E
DE
LOG
DE
ERROS
, e a seguinte
6 O UTRAS
ETAPAS
As etapas abaixo utilizada no processo Direct Input para executar o programa standard.
Ser aberto a tela para selecionar a sesso de execuo do Direct Input, para execuo
imediata deve-se escolher a primeira opo Program .....
Os detalhes de execuo devem ser preenchidos conforme indicado a seguir. Esta a ltima
tela antes do processamento das alteraes.
Indicar que o
processamento
ser
realizado
em
modo
exclusivo E.
Neste exemplo no ocorreu erro durante o processamento, quando isto ocorre aparece o cdigo
E no registro inconsistente.
A tela a seguir mostra um exemplo onde ocorreu erro durante o processamento.
7 S UGESTES
D ICAS
No renomear o Recording, caso tenha criado a etapa Maintain field mapping and conversion rules
Nos campos de moeda, verificar qual o perfil do usurio, para evitar erro durante a execuo da pasta de
Batch Input
Nos campos de data, verificar o formato. O mais comum usar dia, ms e ano (DDMMAAAA)
Quando for executar pela primeira vez a pasta de batch input, executar em Processamento visvel.
Para carga de Textos longos, utilize o Direct Input de Textos Longos. No Passo 5, deve-se alterar o
cdigo do END_OF_RECORD para on_change_transfer_record para que se possa carregar mais de
uma linha de texto longo:
Para carregar os dados dos impostos ICMS, PIS, COFINS etc para mdulos MM e SD, necessrio
desflegar um item no seguinte caminho:
SPRO => Contabilidade financeira => Configurao contabilidade financeira => IVA =>
Configuraes globais => Brasil => Clculo de imposto baseado em condies => Ativar gerao
de condies
exerccios
Criar as ferramentas abaixo e utilizar os arquivos que sero disponibilizados pelo instrutor.
7.1 - B A T C H I N P U T
Criar um programa LSMW que permita realizar a carga em Batch Input da transao XK15 do SAP
utilizando o File Layout abaixo:
File Layout:
HEADER
Campo
Tipo/Tam
Valor Fixo
Descrio
Ident
Char(1)
Identificador
Header
Char(100)
Header
ITEM
Campo
Tipo/Tam
Valor Fixo
Descrio
Ident
Char(1)
Identificador
KAPPL
Char(2)
Application
KSCHL
Char(4)
Condition type
KOTABNR
Char(3)
Table
VKORG
Char(4)
Sales Organization
VTWEG
Char(2)
Distribution Channel
SPART
Char(2)
Division
KUNNR
Char(10)
Customer Number
KBETR
Curr(14)
Rate
FOOTER
Campo
Tipo/Tam
Valor Fixo
Descrio
Ident
Char(1)
Identificador
Footer
Char(100)
Footer
Criar um programa LSMW que permita realizar a carga em Batch Input da transao F-02 do SAP
utilizando o File Layout abaixo:
File Layout:
HEADER
Campo
Tipo/Tam
Valor Fixo
Descrio
Ident
Char(1)
Identificador
Header
Char(100)
Header
ITEM
Campo
Tipo/Tam
Valor Fixo
Descrio
Ident
Char(1)
Identificador
BLDAT
Char(2)
Data do Lanamento
BLART
Char(4)
Tipo do Documento
BUKRS
Char(10)
Empresa
BUDAT
Char(2)
Data do Documento
MONAT
Curr(3)
Perodo
WAERS
Char(16)
Moeda
XBLNR
Char(30)
Referncia
BKTXT
Char(2)
Texto
NEWBS
Char(10)
Chave de Lanamento
NEWKO
Char(13)
WRBTR_01
Char(40)
Montante
SGTXT_01
Char(2)
Atribuio
NEWBS_01
Char(10)
Chave de Lanamento
NEWKO_01
Char(13)
WRBTR_02
Char(40)
Montante
SGTXT_02
Char(40)
Atribuio
SGTXT_03
Char(40)
Atribuio
FOOTER
Campo
Tipo/Tam
Valor Fixo
Descrio
Ident
Char(1)
Identificador
Footer
Char(100)
Footer
7.2 - D I R E C T I N P U T
Criar um programa LSMW que permita realizar a carga em Direct Input da transao MM01 do SAP
utilizando o File Layout e as propriedades abaixo:
File Layout:
HEADER
Campo
Tipo/Tam
Valor Fixo
Descrio
Ident
Char(1)
Identificador
Header
Char(100)
Header
ITEM
Campo
Tipo/Tam
Valor Fixo
Descrio
Ident
Char(1)
Identificador
MBRSH
Char(1)
Industry Sector
MTART
Char(4)
Material type
MAKTX
Char(40)
Material description
MEINS
Char(3)
MATKL
Char(9)
Material group
SPART
Char(2)
Division
FOOTER
Campo
Tipo/Tam
Valor Fixo
Descrio
Ident
Char(1)
Identificador
Footer
Char(100)
7.3 BA PI
-
7.4 IDOC
-
Footer
REFERNCIAS
&
SITES
http://www.abapfas.com.br