OVERVIEW
Manual de LSMW
1
ÍNDICE
1. Introdução.....................................................................3 2. Arquitetura....................................................................4 3. Funcionalidades............................................................5 4. LSMW via Batch input.................................................21 5. LSMW via Bapi / IDOC................................................56 6. LSMW via Direct input.................................................63 7. Dicas............................................................................68 8.
Perguntas mais freqüentes..........................................72
2
1 - INTRODUÇÃO
A ferramenta LSMW (Legacy System Migration Workbench) é disponibilizada pela SAP sem custo adicional e com o objetivo de transferir dados de sistemas legados (Não SAP – Legacy System) para o R/3. Existem outros recursos que também podem ser utilizados para migração/atualização de dados como, SHDB(Batch Input Record), DX Workbench (Data Transfer Workbench), CATT (Computer Aided Testing Tool) entre outros, mas algumas diferenças importantes devem ser consideradas: •
SHDB X LSMW => O LSMW não depende de programação ABAP e disponibiliza outros recursos (translation, defined routines etc.). Também é possível via LSMW escolher o tipo de processamento Ex.: Direct Input, BAPI, IDOC;
•
DX Workbench x LSMW=> O DX Workbench seria uma extensão do LSMW, tanto que depende de funcionalidades do LSMW para conversão de dados.
•
CATT x LSMW => O tempo de execução do CATT para migrar/atualizar dados é muito lento e o LSMW oferece mais recursos para cargas de dados mais complexas.
Importante: Antes de utilizar o LSMW verificar os itens abaixo : -
Assegure-se que a customização foi finalizada; Identifique a(s) transação(s) que será utilizada na importação dos dados e simule com dados de teste para mapear os campos obrigatórios e valores fixos; Associar os dados de origem (sistema legado) com os dados de destino (R/3); Eliminar caracteres especiais, ficar atento com a formatação de datas, e em alguns casos (BAPI) os materiais precisam ser exportados com “zeros” à esquerda; Utilizar o bom senso quando executar muitos registros, o ideal seria dividir os registros em “N” arquivos para serem processados separadamente; Garantir o nível de qualidade dos dados a serem migrados ao R/3, porque dependendo do tipo de atualização os dados não poderão mais ser alterados.
ARQUITETURA
Obs. A ferramenta LSMW não é utilizada para extração / migração de dados e do R/3 para sistemas legados.
3
Accelerating Data Migration: LSM Workbench One or several files
How LSM Workbench works
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
SAP AG July 1999
R/3 Standard
Batch Input processing
Conversion rules
21
4
3 - FUNCIONALIDADES
a.
Executar transação:
•
b.
Informar: o Transação: LSMW o ENTER
Funcionalidades: Parte I
• • • • •
Welcome: o Mensagem explicando o objetivo da transação, ou seja, deve ser utilizada para migração de dados de sistemas (Não SAP) para o R/3. All objects: o Lista de todos os LSMWs criados por Projeto, Subprojeto, Objeto, Usuário, Descrição. My objects: o Lista somente os LSMWs criados pelo seu usuário. All objects of the project: o Lista de todos os objetos criados para o Projeto, Subprojeto e Objeto selecionado na tela. Continue: o Iniciar as etapas para preparação do LSMW.
5
3 - FUNCIONALIDADES
•
Create entry: o Criar um nome de Projeto, Subprojeto e Objeto para o seu LSMW, seguindo estrutura “modelo” abaixo :
o o o o o o o o o
Projeto: IDES S.A. Subprojeto: MM Objeto: Material Objeto: Fornecedor Objeto: Pedido de compra Etc. Subprojeto: SD Objeto: Clientes Objeto: Pedido de Vendas
•
Documentation: o Documentar o LSMW com informações adicionais.
•
Administration: o Lista de todos os Projetos (LSMW) e suas respectivas ligações com Subprojetos, Objetos, Fixed Values, Translations, User Defined Routines.
•
Recordings: o Direciona para o(s) recording(s) do Projeto(LSMW) correspondente. Somente os Projetos executados via Batch Input terão conteúdo nesta opção, isto porque somente estes projetos utilizam recording.
6
3 - FUNCIONALIDADES
Existem duas formas de exportar o LSMW entre ambientes, via request ou via (export/import): •
Create change request (via request): o Recurso utilizado para transportar o conteúdo do LSMW entre ambientes. Normalmente é criado o LSMW em ambientes com massa de testes (QAS), e depois transportado para PRD.
•
Export project (via export/import): o Recurso utilizado para exportar o conteúdo do LSMW para outro ambiente via arquivo. Utilizar este recurso no ambiente “origem”.
o Informar o projeto que deseja exportar. o ENTER
o Posicionar o cursor sobre a linha “Subprojects”. o Clicar no botão do LSMW. o
para selecionar todo o conteúdo
3 - FUNCIONALIDADES o No menu “Export conversion rules” clicar em Export.
7
o Informar o local e nome do arquivo onde deseja salvar o conteúdo do LSMW. o Clicar no botão “transfer”.
o Enter. •
Import project: o Recurso utilizado para Importar o conteúdo do LSMW via arquivo. Utilizar este recurso no ambiente “destino”.
o Clicar na opção “Import project”.
3 - FUNCIONALIDADES
o Informar o local do arquivo que foi SALVO no processo de “export”.
8
o Clicar na opção “Transfer”.
o Enter.
o Posicionar o cursor sobre a linha “Subprojects”. o Clicar no botão do LSMW.
para selecionar todo o conteúdo
o No menu “Edit” clicar em Import.
9
3 - FUNCIONALIDADES
o Importação efetuada !
•
IDoc inbound processing: o Esta opção é responsável pela configuração do IDOC, isto se faz necessário quando o LSMW é processado via BAPI ou IDOC o No menu Settings clicar na opção “IDoc inbound processing”.
.
Obs.: Se estiver configurada “conforme recomendações SAP” as opções Maintain ports = LSMW, Maintain partner types = US e Maintain partner numbers = LSMW, somente preencher com estas informações na mesma seqüência os campos File port, Partn.type e Partn.number. Depois clicar na opção Activate IDoc inbound processing..., caso contrário seguir os passos abaixo para configurar.
3 - FUNCIONALIDADES
•
Configurar “Maintain ports”: o Clicar no botão “Maintain ports”.
10
o Posicionar o cursor na pasta “File”. o Clicar no botão criar.
o o o o o o
Clicar no botão criar. Porta = LSMW. Description = Legacy System Migration Workbench. 3 - FUNCIONALIDADES Version = 3 Idoc record types SAP release 4.x. Physical directory = informar um diretório. Outbound file : Informar um nome de arquivo ex. filelsmw.
11
o Inbound file : Informar um nome de arquivo ex. filelsmw. o
Salvar.
o
Voltar.
o
Voltar.
Resultado :
12
3 - FUNCIONALIDADES
•
Configurar “Maintain partner types”:
o Clicar no botão “Maintain ports”.
o Utilizar opção “US”, conforme recomendações SAP. Obs. Esta configuração é standard e em muitos casos já está configurada, caso contrário, deve ser criada com as características da linha circulada.
13
3 - FUNCIONALIDADES •
Configurar “Maintain partner numbers”:
o Clicar no botão “Maintain portner numbers”.
o Clicar no botão “Criar”.
14
3 - FUNCIONALIDADES
o o o o o o
Partn. number = LSMW; Partn.type = US; Typ = US; Agent = Código do Usuário; ENTER; Salvar.
15
3 - FUNCIONALIDADES o Resultado :
o
Voltar.
o Clicar no botão “Activate IDoc inbound processing.
16
3 - FUNCIONALIDADES
o Clicar no botão “Yes”; o Resultado.
o
Voltar.
o Clicar no botão executar. Obs. O procedimento a seguir será necessário para criar automaticamente o “Partner Agreemnet”.
o Marcar a opção “1 Maintain object attributes”. o Clicar no botão “Executar”.
17
3 - FUNCIONALIDADES
o Clicar no botão “Display Change” para ativar alteração. o Salvar. o Resultado :
o Configuração do IDOC finalizada !
18
3 - FUNCIONALIDADES c.
Funcionalidades : parte 2
•
Personal menu: o Recurso utilizado para habilitar/desabilitar etapas referente a seqüência de execução do LSMW. Ex. A seguir somente “Display conversion program” não estará ativo para ser executado pela tela principal. Obs.: Com base no tipo de execução (Bapi, Direct Input, Batch Input ou Idoc), automaticamente as etapas necessárias são marcadas. Isto não significa que necessariamente essas etapas precisam ser executas.
19
3 - FUNCIONALIDADES •
Numbers on/off : o Mostra a seqüência de execução do LSMW por “números”. Ex. Ativado:
Desativado :
•
Doubleclick=Edit/Display : o Acessar as etapas de execução em modo editado ou exibição. Ou seja, se estiver habilitado “Display”, sempre que executar a etapa será necessário clicar no botão para ativar o modo de edição. Se estiver habilitado “Edit” a etapa será executada em modo edição automaticamente.
•
Object overview : o Mostra o conteúdo de todas as etapas do LSMW, podendo ser visualizado através de lista ou tabela.
•
Action log : o Mostra o histórico de data e horário que cada etapa foi executada.
20
4 - LSMW via BATCH INPUT
a. Executar transação :
•
Informar: o Transação : LSMW o ENTER
b. Criar
.
o Informar nome do projeto; o Informar descrição; o ENTER.
o Informar nome de Subprojeto; o Informar descrição; o ENTER.
21
4 - LSMW via BATCH INPUT
o Informar nome de Objeto; o Informar descrição; o ENTER. o Executar
: Objetivo : Definir e mapear o tipo de processamento: Batch input, Direct Input, Bapi ou IDOC. o Executar
o Clicar em “recordings overview”.
o Clicar em “criar”.
22
4 - LSMW via BATCH INPUT
o Informar um nome de recording; o Informar descrição; o ENTER. Obs.: Antes de executar a transação, precisa conhecer exatamente quais etapas e campos serão executados. Neste exemplo estaremos atualizando a descrição do material.
o Informar código de transação que deseja executar para simular o batch input. Neste momento será mapeado/gravado todos os campos que contém conteúdo na tela. o ENTER (neste momento começa executar a transação) :
o Informar material; o ENTER.
23
4 - LSMW via BATCH INPUT
o Selecionar visão; o ENTER.
o Alterar descrição do material. o
Salvar (Não finalizar a gravação com ENTER) (Neste momento finaliza a gravação do batch input. Todos os campos que existiam valor na tela simulada serão carregados a seguir.)
24
4 - LSMW via BATCH INPUT
• • • •
•
• • •
Default : o Atualizar automaticamente campo a campo (Azul escuro) com nome e descrição standard (Marrom). Default all : o Atualizar automaticamente todos os campos (Azul escuro) com nome e descrição standard (Marrom). Reset : o Limpar o conteúdo preenchido pelos botões (Default e Default all). Screen field : o Incluir campos, ou seja, se por algum motivo não foi mapeado o campo no batch input. Screen field : o Excluir campos. Este botão é bastante usado, porque após a gravação do batch input o sistema além de listar os campos mapeados na tela, também lista os campos que existiam valor e estas “sujeiras” podem ser eliminadas. Documentation: o Documentar informações importantes desta etapa. Repet recording : o Repetir a gravação do batch input, caso tenha ocorrido algum problema da primeira vez. Maintain attributes : o Alterar a descrição do recording.
25
4 - LSMW via BATCH INPUT
Importante : Neste momento todos os campos que existiam valor na tela simulada pelo batch input serão listados. Existe duas maneiras para executar esta etapa : 1- Manter os campos que não foram mapeados pelo batch input e obrigatoriamente “clicar duas vezes nestes campos (conforme a seguir) e limpar os valores defaut”, caso contrário os campos serão atualizados indevidamente com estes valores. Ex. :
4 - LSMW via BATCH INPUT
26
2- Utilizar o botão “Screen field ” para eliminar os campos (somente os campos que estão ligados a cor azul clara) que não foram mapeados e não serão necessários para a execução do batch input. Obs.: Todos os campos que foram mapeados e são fundamentais para a execução do batch input, deverão ser atualizados da seguinte forma :
o Clicar duas vezes sobre o campo “cor azul escuro”.
o Informar o nome do campo (sem espaços e caracteres especiais). Este nome pode ser o próprio nome utilizado como cabeçalho dos registros (arq. TXT). o Informar descrição do campo. o Manter em “branco” o default value. Obs. Este procedimento deverá se repetir da mesma forma para todos os campos mapeados em tela e que estão ligados a cor azul claro. o o o
Savar.
4 - Voltar. LSMW via BATCH INPUT Voltar.
27
o Informar o nome do Recording criado ou utilizar o botão F4 que atualizará automaticamente com o nome criado. Ex. Material. o ENTER o
Salvar.
o
Voltar.
: Objetivo : Criar estrutura para os campos (sistema legado) a serem exportados. o Executar
4 - LSMW via BATCH INPUT
o Clicar no botão “Criar”.
28
o Informar um nome para “Source structure”, não pode ser o mesmo nome informado no “Recording”. Ex. “MM02”. o Informar uma descrição. Ex. “Atualização da descrição do material”. o ENTER.
o
Salvar
o
Voltar.
: Objetivo : Incluir os campos a serem importados na estrutura criada pela etapa anterior. o Executar o A seguir, segue explicação de recurso dos botões :
o
Ativar/desativar modo de alteração.
o
Criar campos.
o
Alterar os campos.
o
Excluir os campos.
29
4 - LSMW via BATCH INPUT o
Importar os campos/layout via arquivo, tabela ou objeto.
Upload (Tab delimited text) : • Recurso utilizado para importar layout via arquivo.
Obs.: O arquivo deverá seguir o formato : • Número de campos (seqüencial); • Nome do campo; • Descrição do campo; • Tipo do campo Ex. “C” caracter, etc. • Tamanho do campo; Ex. Layout do arquivo a importar :
30
4 - LSMW via BATCH INPUT
• •
Clicar no botão “Transfer”; Resultado:
Copy from other object : • Recurso utilizado para copiar o layout dos campos de outro objeto/LSMW.
• • • • •
Informar Projeto; Informar Subprojeto; Informar Objeto; Informar “Source structure”; ENTER.
31
4 - LSMW via BATCH INPUT
Copy from data Repository : • Recurso utilizado para copier layout via estrutura tabela standard (SE16).
•
Informar tabela SAP para copiar os campos.
From data file (field names in 1st line) • Recurso utilizado para importar layout via arquivo.
• •
Informar o número de campos que serão importados o Ex. 2 campos (Material e descrição) Informar a quantidade total de caracteres que cada registro terá. o Ex. Material : 480007468 (9 caracteres), Descrição : Chapa de aço teste (18 caracteres) = 9 + 18 = 27. Ex. Layout do arquivo a importar :
o
Abrir a opção de inclusão de campos por planilha. Ex.
32
4 - LSMW via BATCH INPUT o
Recurso utilizado em conjunto com o botão o campo e mover/trocar de seqüência.
para selecionar
o
Recurso utilizado para identificar quais são os campos chaves de um objeto para outro. Ou seja, desde que o campo de um objeto esteja com o mesmo de outro objeto o sistema identifica com a cor “marrom” estes campos chaves. Exemplo de outro LSMW (Pedido) que depende de 2 objetos :
Explicação dos botões finalizada !
33
4 - LSMW via BATCH INPUT
o Posicionar o cursor sobre a linha “amarela”. o Clicar no botão “Change field” (incluir os campos manualmente). Obs.: Os campos de valor fixo no R/3 não precisam constar na estrutura do arquivo texto e nem nesta etapa. Eles terão o seu valor atribuído na etapa 6 “Maintain Fixed Values, Translations, User-Defined Routines”.
o
Salvar
o
Voltar.
: Objetivo : Relacionar a estrutura “Source structure – ex. MM02” criada na etapa 2, com o “Recording – ex. Material” criado na etapa 1: o Executar
o Posicionar o cursor sobre a linha “marrom” e clicar no botão “Relationship”. o o
4 - LSMW via BATCH INPUT Salvar. Voltar. :
34
Objetivo : Associar os campos origem aos campos destino e definir as regras de como o conteúdo será convertido: o Executar o A seguir, segue explicação de recurso dos botões :
•
• •
•
Source field : o Recurso utilizado para associar/mover os campos criados na “source field – campo origem” com os campos do “batch input - campos destino” Source field : o Recurso utilizado para remover as associações/regras feitas no passo anterior. Rule: o Recurso utilizado para criar regra(ABAP) para importar conteúdo do campo, Ex.: MOVE, CONSTANT, FIXED VALUE, etc. Obs. Estas regras já estão pré-definidas, não precisa conhecer a linguagem ABAP para utiliza-las.
Auto-fieldmapping: o Recurso utilizado para relacionar automaticamente os campos mapeados pelo batch input etapa1 com os campos do source field etapa 3 através da regra pré-definida.
35
4 - LSMW via BATCH INPUT
•
•
• • • •
Match fields with identical names: o Esta opção só atualiza os campos que estiverem com o mesmo conteúdo entre target field (mapeados pelo Bach input – etapa1) com o source field (campos referente ao sistema legado – Etapa 3). Match fields with similar names names Minimum matching probability in percent = 50%: o Esta opção só atualiza os campos que estiverem com pelo menos 50% aproximado ao conteúdo entre target field (mapeados pelo Bach input – etapa1) com o source field (campos referente ao sistema legado – Etapa 3). Only apply rule “Transfer (MOVE)”: o Esta opção atualiza automaticamente a regra MOVE. Also apply reusable rules: o Esta opção habilita outras regras de importação para serem utilizadas. With confirmation: o Esta opção aguarda a sua confirmação para fazer a relação entre os campos target field e source field. Without confirmation: o Esta opção atualiza automaticamente a relação entre os campos target field e source field, desde que atenda as regras de “Match fields with identical names” ou “Match fields with similar names names”. o Explicação dos botões finalizada.
36
4 - LSMW via BATCH INPUT
o Posicionar o cursor sobre o campo (Azul escuro). o Clicar no botão “Source field”. (Esta opção deve ser utilizada somente para a regra MOVE).
o Será listado todos os campos “origem” que foram criados no Source field (Etapa 3). o Clicar 2 vezes sobre o campo correspondente. Neste momento a regra “MOVE” será utilizada automaticamente.
37
4 - LSMW via BATCH INPUT
o Seguir este procedimento para todos os campos que utilizarem a regra MOVE. Para os campos que precisam de outras regras, utilizar o procedimento a seguir :
o Posicionar o cursor sobre o campo que deseja adicionar a regra . o Clicar no botão “Rule”
4 - LSMW via BATCH INPUT
38
o Marcar (por exemplo) a regra “Constant”. o ENTER.
o Por ser constante o sistema abre a opção Match code, neste caso o campo KZSEL se referencia a marcar a visão no mestre de materiais, portanto será preenchido com o valor “X”. o .
o
Salvar.
o
Voltar.
: Objetivo : Definir valores fixos, traduções e rotinas de ABAP, esta etapa é muito importante porque é possível exportar estas regras para outros Projetos/LSMW. o Executar o A seguir, segue explicação de recurso dos botões :
•
: - LSMW viapara BATCH INPUT o 4 Criar nova entrada Fixed Values, Translations ou User Definedroutines, para isso posicionar o cursor sobre a opção desejada.
39
•
: o Alterar umas das opções Fixed Values, Translations ou User Defined-routines, para isso posicionar o cursor sobre a opção desejada.
•
: o Exibir uma das opções Fixed Values, Translations ou User Definedroutines, para isso posicionar o cursor sobre a opção desejada.
•
: o Excluir uma das opções Fixed Values, Translations ou User Definedroutines, para isso posicionar o cursor sobre a opção desejada.
•
: o Copiar uma das opções Fixed Values, Translations ou User Definedroutines, para outro LSMW. Para isso posicionar o cursor sobre a opção desejada. Ex.:
o Informar Projeto/LSMW destino. o ENTER. Obs.: Neste momento as regras foram copiadas para outro projeto/LSMW. Este procedimento é igual para as opções Translations e Userdefined routines.
40
4 - LSMW via BATCH INPUT •
: o Renomear o nome do projeto/LSMW.
•
: o Listar todos os projetos/LSMW que utilizam estas regras. o Explicação dos botões finalizada.
•
Fixed values : o Manter valores fixos nos campos. Não será necessário informar este campo na etapa 3 “Maintain source field”. o Posicionar o cursor sobre a opção “Fixed values”. o Clicar na opção criar
o Informar nome; o Informar descrição; o ENTER.
41
4 - LSMW via BATCH INPUT
o Posicionar o cursor sobre a linha (Visão_Material) linha verde. o Clicar no botão
o Informar tamanho do campo; o Informar valor do campo; o ENTER. Obs.: Será necessário voltar para a etapa 5 “Maintain field mapping and conversion rules” e colocar no campo correspondente a regra (campo da estrutura = “FV_” + nome do fixed value), Ex. : Material-KZSEL_01 = FV_VISÃO_MATERIAL.
42
4 - LSMW via BATCH INPUT
•
User-defined routines : o Recurso utilizado para desenvolver códigos ABAP. o Posicionar o cursor sobre a opção “User-defined routines”. o Clicar na opção criar
o Informar nome; o Informar descrição; o ENTER. Obs.: Neste exemplo foi criado um código ABAP para mover “zeros” a esquerda no código do material.
o Informar a quantidade de parâmetros de entrada; o Informar a quantidade de parâmetros de saída; Obs.: Neste exemplo foi utilizado um único parâmetro de entrada e saída.
43
4 - LSMW via BATCH INPUT
o Posicionar o cursor sobre a linha (Material) linha verde. o Clicar no botão
4 - LSMW via BATCH INPUT
o Informar o código ABAP no local indicado (circulado). o
Salvar
o
Voltar. 44
o
Voltar.
Obs.: Para executar esta “Call Function” será necessário utilizar um comando ABAP na etapa 5 “Maintain field mapping and conversion rules” no campo correspondente, como informado a seguir :
: Objetivo : Selecionar e definir algumas regras para o arquivo que será migrado. o Executar
o Posicionar o cursor sobre “Legacy data” cor laranja. o Clicar na opção
45
4 - LSMW via BATCH INPUT
• • • •
File: o Localizar o arquivo a ser migrado (o arquivo obrigatoriamente precisa ser “.TXT”). Description: o Colocar uma “descrição qualquer”, geralmente é informado o mesmo nome do arquivo. Data for one source structure (table): o Este recurso é utilizado para 100% dos casos, porque atende também LSMWs com mais de uma estrutura. 4 - LSMW via BATCH INPUT Separator: o É responsável por definir o tipo de delimitador do arquivo. É comum utilizar “Tabulator”.
46
•
•
• •
Field names at the beginning of the file: o Se estiver marcado, quando executar a etapa 9 “Read data” não considera a primeira linha do arquivo, ou seja com esta opção pode manter a descrição de cada coluna do arquivo. Se não estiver marcado obrigatoriamente o arquivo não poderá ter as descrições das colunas. Order of fields as in source structure definition : o Recurso utilizado para manter a mesma ordem das colunas do arquivo com os campos da etapa 3 “Maintain source fields”. Portanto, o ideal é sempre manter esta opção marcada. Record end indicator (text file) : o Considera, com base no arquivo, o término dos registros. Fixed record length : o É possível definir como fixo a posição final do arquivo (Não é muito utilizado).
: Objetivo : Relacionar o arquivo com a estrutura da etapa 2. o Executar
o Posicionar o cursor sobre a estrutura; o Clicar no botão “Assignment”.
o
4 - LSMW via BATCH INPUT Salvar. Voltar.
o :
47
Objetivo : Ler o arquivo “.TXT” e grava o conteúdo dos registros na estrutura que foi criada na etapa 3 “Maintain source fields”. o Executar
•
•
Transaction number: o É possível ler somente parte do arquivo, isto é muito comum quando o arquivo é grande e precisa fazer um teste somente com um registro. Se estiver em branco automaticamente será lido todos os registros. Date values -> YYYYMMDD o Será considerado o conteúdo do campo data nesta máscara AAAAMMDD. Ex. 20070208. o Executar
Obs.: Quando a coluna “Not written” for diferente de 0 “zero” é que algum dos registros não foi lido, portanto ocorreu um erro. o o
4 - LSMW via BATCH INPUT Voltar. Voltar.
: Objetivo : Mostra os registros lidos na estrutura definida na etapa 3 “Maintain source fields”. 48
o Executar
o Informar se necessário o range de registros que deseja verificar. Se manter em branco todos os registros lidos serão mostrados. o ENTER.
o Clicar sobre a linha amarela para mostrar em forma de tabela o conteúdo do arquivo que foi lido.
o
Voltar.
o
Voltar.
49
4 - LSMW via BATCH INPUT : Objetivo : Converter os registros lidos para a estrutura SAP definida na etapa 1 “Mapeamento do batch input”. o Executar
o Informar se necessário o range de registros que deseja converter, se manter em branco todos os registros lidos serão convertidos. o Executar
o
Voltar.
o
Voltar.
: Objetivo : Mostra os registros convertidos na estrutura definida na etapa 1 “Maintain object attributes”. o Executar
50
4 - LSMW via BATCH INPUT
o Informar se necessário o range de registros que deseja verificar, se manter em branco todos os registros convertidos serão mostrados. o ENTER.
o Clicar sobre a linha verde para mostrar em forma de tabela o conteúdo do arquivo que foi convertido.
o
Voltar.
o
Voltar.
: Objetivo : Criar pasta com o conteúdo dos registros lidos/convertidos nas etapas 9 e 11 respectivamente. o Executar
51
4 - LSMW via BATCH INPUT
•
Keep batch input session(s)? o Se estiver marcado, após a execução do batch input na etapa 14 “Run batch input session” será mantida a pasta no histórico. o Executar
o ENTER.
: Objetivo : Executar a transação SM35 para atualizar via batch input os registros do arquivos “.TXT”. o Executar
o Marcar a pasta a ser executada. o Clicar no botão “Process”.
52
4 - LSMW via BATCH INPUT
•
• •
Process/foreground : o Se estiver marcado, o processamento será visível. DICA : - Se precisa pular o registro utilizar o comando “/N”; - Se precisa encerrar a execução utilizar o comando “/NEND”; Display erros only : o Se estiver marcado, o processamento somente para se houver algum erro. Background : o Se estiver marcado, o processamento não é visível e armazena os erros em logs após o término da execução. Obs.: A pasta pode ser executada pela própria transação LSMW ou pela transação SM35, ficando a escolha do usuário.
o o o
4
: Número de transações/registros a serem processados. : Número de transações/registros processados com êxito. : Número de transações/registros que ocorreu erro. -Obs.: LSMW via BATCH Para identificar os errosINPUT que ocorreram, verificar procedimento a seguir :
53
o Marcar a pasta; o Clicar no botão “Log”;
o Marcar a linha que foi processada; o Clicar no botão “Display”;
o Message : Neste exemplo “0” zero transações com erro;
54
4 - LSMW via BATCH INPUT A seguir um exemplo que ocorreu erro :
o Message : Neste exemplo o erro que ocorreu é porque não existe um código de material ativo, portanto não foi processado corretamente; DICA : Exportar este log para o excel clicando no botão depois no menu System / List / Save / Local file. Quando importar no excel fazer um filtro pela coluna “T” e filtrar tudo que seja = “E” error.
o o o
Voltar.
5 - LSMW via BAPI / IDOC Voltar. Voltar.
55
a. Executar transação :
•
Informar: o Transação : LSMW o ENTER
b. Criar
.
o Informar nome do projeto; o Informar descrição; o ENTER.
o Informar nome de Subprojeto; o Informar descrição; o ENTER.
56
5 - LSMW via BAPI / IDOC
o Informar nome de Objeto; o Informar descrição; o ENTER.
•
Configurar IDOC : o Seguir as instruções de configuração de IDOC contidas na opção “3 – Funcionalidades”.
: Objetivo : Definir e mapear o tipo de processamento: Batch input, Direct Input, Bapi ou IDOC. o Executar Ex.: BAPI
Ex.: IDOC
•
•
Business Object Method (BAPI) / Message Type: o Listar as Bapis disponíveis para serem executadas via LSMW. Neste exemplo estamos utilizando a Bapi “BUS1001006 – Material standard” / IDOC “MATMAS_BAPI”. Method / Basic Type: o Listar as opções de atualização da Bapi. Neste exemplo estamos utilizando “SAVEDATA – Cria e modifica dados mestre do material” / IDOC “MATMAS_BAPI01”
57
5 - LSMW via BAPI / IDOC
Obs.: A Bapi identifica se deve modificar ou criar o material, utilizando o seguinte critério : verifica o código do material importado com a tabela standard MARA, se existir, automaticamente executa o modo “MM02 modificar”, caso contrário o modo “MM01 – criar”. Existem BAPIs que só identificam o material se estiver preenchido com “zeros” a esquerda, nestes casos se o material não estiver desta maneira ocorre a mensagem de erro solicitando conteúdo no campo “tipo de material”, isto significa que a Bapi entrou no modo “MM01 – criar” por não ter encontrado o material na tabela MARA. o ENTER.
•
o
Salvar.
o
Voltar.
Seguir as explicações das etapas 2 e 3 contidas nas páginas 28 à 34 opção “4 – LSMW via Batch input”.
Objetivo : Relacionar a estrutura “Source structure – ex. MM02” criada na etapa 2, com o “Recording – ex. Material” criado na etapa 1: o Executar
o Posicionar o cursor sobre a linha “marrom” e clicar no botão “Relationship”. o
Salvar.
o Voltar. Obs.: As estruturas de Bapis que terminam com “X” ex. E1BP_MARAX dependendo do campo precisam ser preenchidas com “X”.
58
5 - LSMW via BAPI / IDOC
•
Seguir as explicações entre as etapas 5 e 12 contidas nas páginas 35 à 51 - na opção “4 – LSMW via Batch input”.
: Objetivo : Criar IDOC. Para cada registro do arquivo será criado um IDOC. o Executar
o Executar
Objetivo : Executar IDOC. o Executar
59
5 - LSMW via BAPI / IDOC
o Informar o número(s) do(s) IDOC(s) gerado(s). Obs.: É possível identificar estes números de IDOCs de duas formas: 1- Através da transação BD87; 2 – Executando a etapa 15 “Create IDOC overview” Ex.:
o Executar
60
5 - LSMW via BAPI / IDOC
Resultado :
•
Quando ocorrer erro, como identificar o problema : o Posicionar o cursor sobre a linha azul; o Clicar no botão
o Clicar na pasta “Regs.status” o Abrir o status que estiver com erro. Obs.: Clicando duas vezes sobre a mensagem mostrará o conteúdo explicativo do erro. o
Voltar.
o
Voltar.
o
Voltar.
Objetivo : Mostra os números dos IDOCs gerados e o conteúdo dos registros nas estruturas dos IDOCs.
61
5 - LSMW via BAPI / IDOC
o Clicar na pasta “Registros de dados”; o Clicar sobre a estrutura desejada; Obs.: Neste momento no canto direito aparecerá o conteúdo dos registros dentro da estrutura SAP. o
Voltar.
o
Voltar.
: Objetivo : Reprocessar o IDOC para alguns dos status pré-definidos, abaixo.
62
6 - LSMW via DIRECT INPUT
Executar transação :
•
Informar: o Transação : LSMW o ENTER
b. Criar
.
o Informar nome do projeto; o Informar descrição; o ENTER.
o Informar nome de Subprojeto; o Informar descrição; o ENTER.
63
6 - LSMW via DIRECT INPUT
o Informar nome de Objeto; o Informar descrição; o ENTER.
: Objetivo : Definir e mapear o tipo de processamento: Batch input, Direct Input, Bapi ou IDOC. o Executar
•
•
Object: o Listar os Direct Inputs disponíveis para serem executados via LSMW. Neste exemplo estamos utilizando o direct input “0020 – Mestre de materiais”. Method: o Listar as opções de atualização da Bapi. Neste exemplo estamos utilizando “0000” o ENTER. o
Salvar.
o
Voltar.
64
6 - LSMW via DIRECT INPUT
•
Seguir as explicações entre as etapas 2 até 4 contidas nas páginas 28 à 34 da opção “4 – LSMW via Batch input”. :
•
Informar no campo “TCODE” a regra “Constante” com o valor = “Código de transação”. Seguir regras para os outros campos, conforme explicação da etapa 5 contida na opção “4 – LSMW via Batch input”.
•
Seguir as explicações entre as etapas 2 até 4 contidas nas páginas 39 à 51 - opção “4 – LSMW via Batch input”.
: Objetivo : Executar a atualização dos dados via direct input. o Executar
o Marcar opção “Program RMDATIND”. 6 -A LSMW via DIRECT INPUT Obs.: opção “Transaction BMV0” é o processamento via JOB. o ENTER.
65
o Executar
o ENTER
66
6 - LSMW via DIRECT INPUT
o ENTER
o ENTER
o ENTER
o
Voltar.
o
Voltar.
67
7 - DICAS
•
Criar LSMW com cópia de outro LSMW:
o Clicar no botão “All Project Objects”.
o Posicionar o cursor sobre a linha do Projeto. o Clicar no botão
o Clicar no botão o Informar o nome do novo Projeto/LSMW.
68
7 - DICAS
•
Copiar Batch input recordings entre Projetos / LSMW:
: o Executar
o Clicar em “recordings overview”.
69
7 - DICAS
o Posicionar o cursor sobre o “Recording” Ex. “Atualiza” o Clicar no botão
.
o Informar o Projeto/LSMW aonde deseja copiar o novo “recording” . o Informar o nome do recording que será criado. o ENTER.
70
7 - DICAS
•
Apagar Projetos / LSMW não utilizados :
o Clicar no botão “All Project Objects”.
o Posicionar o cursor sobre a linha do Projeto. o Clicar no botão
71
7 – Perguntas mais freqüente •
Qual ferramenta de migração de dados é mais rápida LSMW ou CATT ? o O LSMW (Legacy System Migration Workbench), e existe 4 tipos de processamento no LSMW : Direct Input, Batch Input, Bapi e IDOC. Desses quatro tipos de processamento o batch input é o mais lento.
•
É possível utilizar LSMW via batch input para fazer carga de dados com informações dinâmica ? Ex. Carga de pedido de compra, preciso cadastrar pedidos de compras que a quantidade de codigos de materiais variam. o Não, só é possível fazer estes tipos de atualizações por LSMW via Bapi/ IDOC.
•
É possível utilizar a ferramenta LSMW em português ? o Sim, para isso seguir as instruções da nota 761911.
•
Quais são as principais funções do LSMW ? o Importar dados de sistemas legados, converter dados de sistemas legados para formato R/3 e importar dados usando interfaces standards R/3 (IDOC, Batcj input, Direc input).
•
As informações importadas serão consistidas ? o Sim, porque os dados são executados por transações standards seguindo o mesmo critério de verificação.
•
É necessário conhecimento de programação ABAP para utilizar o LSMW ? o Não.
•
O LSMW faz parte do sistema R/3 standard ? o Não, mas pode ser instalado sem custo pelo site : http://service.sap.com/lsmw
•
Quais autorizações no perfil preciso ter para acessar o LSMW ? o Perfil de exibição : B_LSMW_SHOW o Perfil de execução : B_LSMW_EXEC o Perfil de alteração : B_LSMW_CHG o Perfil de administrador : B_LSMW_ALL
•
Qual é a diferença entre Direct Input, Batch Input, Bapi e Idoc ? o Direct input : É o método mais rápido de atualização de dados porque acessa direto a tabela, mas é muito limitado para verificação dos logs de erros. o Batch Input : É um dos métodos mais utilizados porque pode mapear qualquer transação standard e identifica o ponto exato do erro, porém é a forma mais lenta de atualização de dados. o Bapi / Idoc : Praticamente tem as mesma funções, ou seja a execução é feita via IDOC e o tempo de execução para atualizar os dados estaria em 2º lugar, porém com muito mais recursos de verificação de erros do que Direct input.
**********Desenvolvido por : Flavio Marcilio A. Silva (Consultor SAP) email:
[email protected]
72
