1

Guia de Referência DMK – LSMW – Revisão 003 (21.01.2005)

Introdução

Este guia de referência tem como objetivo descrever os passos necessários para elaborar uma LSMW básica de batch input.

LSMW é uma sigla para Legacy System Migration Workbench. Apesar desta ser uma ferramenta de transferência de dados de sistemas legados, ela também pode ser utilizada para outras aplicações como alteração de dados em massa, sejam eles dados mestres como também configurações e dados transacionais. A ferramenta possui muitas outras aplicações e funcionalidades além das apresentadas neste guia que poderão ser exploradas e em muitos casos substituir programas ABAP.

Quando utilizadas conjuntamente às SAP Queries, a LSMW se torna uma importante ferramenta de conversão que pode substituir em muitos casos a elaboração de programas ABAP. Isso pode gerar uma economia de recursos dentro de um projeto.

Objetos da LSMW

As LSMW são organizadas através dos seguintes itens:

• Projeto • Sub-Projeto • Objeto

Esta é uma estrutura em forma de árvore que permite a organização de diversas LSMW dentro da transação. No caso de haver duas LSMW (Objetos) dentro de uma única estrutura de projeto, é possível compartilhar itens como as gravações entre elas.

Para executar a LSMW, utilize a transação LSMW.

Criando a LSMW

Para criar a LSMW, é necessário identificar um Projeto, um Sub-Projeto e um Objeto. Preencher estes campos e clicar em <Create Entry> . No momento em que a LSMW for criada, evite a utilização de nomes muito longos. O ideal é que a soma dos caracteres dos campos não seja superior a 30 caracteres. Caso isso não ocorra, pode ser causado o problema especificado no Passo 7.

Caso a LSMW esteja criada e só necessite ser executada, clicar no botão <Continue> .

2

Passo 1 – Atributos de Objeto

Após a LSMW ter sido criada, o primeiro passo é fazer a gravação da transação que será utilizada no processo. Para executar a gravação, dê um duplo clique no texto do passo 1 ou selecione o texto e clique no botão <Execute> .

Na tela seguinte, clique no botão <Recordings> para criar uma nova gravação de transação.

O próximo passo é criar uma nova gravação clicando no botão <Create Recording> . Na tela que surgir é necessário preencher os campos abaixo listados e pressionar Enter.

Na próxima tela, entre com o código da transação e pressione Enter.

Durante a gravação, assegure-se de que a transação não irá trazer nenhuma mensagem de erro e que nenhuma tela não esperada será mostrada (evite por exemplo chamar a tela de Ajuda <F1> ou abrir os match-codes da tela). O ideal na execução da gravação da tela é já ter todos os dados em mão para assegurar uma execução sem erros.

Quando a transação for finalizada (por exemplo, após um comando do tipo <Save> ), a tela de mapeamento dos campos será aberta. Esta tela apresentará todos os passos executados na seguinte estrutura:

• Gravação • Transação

• Código de Tela • Campos mapeados e Comandos Executados

3

Em alguns casos, pode ser que campos não desejados tenham sido mapeados, ou campos que deverão ser utilizados, mas por motivo de esquecimento, podem ter sido “esquecidos”. Para apagar campos indesejados, selecione o campo a ser excluído clicando uma vez nele e clicando em seguida no botão <Delete Screen Field> .

Para criar um novo campo, identifique a tela em que este campo deveria ter sido criado, clique na posição adequada e utilize o menu Edit – Add Screen Field (Extended).

Por exemplo, caso o campo ANLA-ANLN2 tenha sido erroneamente excluído, ele poderá ser recuperado através da criação manual. Clique no campo que deverá anteceder o campo criado (no caso, ANLA-ANLN1 da tela SAPLAIST 0100), utilize o menu apresentado e entre com os dados do campo:

Para definir os campos que serão variáveis, deve-se dar um duplo clique no texto do campo que aparecerá uma tela com os campos de entrada Nome do Campo, Descrição do Campo e Valor Padrão.

O item Nome do Campo é o nome que irá identificar este campo dentro da LSMW. Pode-se utilizar o mesmo nome que é utilizado no R3.

O item Descrição trata-se de um texto descritivo que permitirá identificar facilmente qual a informação que deverá ser entrada neste campo.

O item Valor Padrão trata do valor que a LSMW irá utilizar caso ele não seja preenchido com algum item.

Os campos poderão ser nomeados um a um, ou automaticamente através do botão de preenchimento automático do R3. Clicando no botão <Default All> , todos os nomes e

4

descrições de todos os campos mapeados serão preenchidos automaticamente. Será necessário entretanto, remover manualmente os valores padrão que devam ser excluídos.

Uma forma de manter um determinado valor fixo é não preencher o nome e descrição do campo (ele não será uma variável da LSMW) e mantê-lo com o Valor Padrão preenchido.

Uma dica é utilizar o comando <CTRL+Y> e selecionar todos os campos do mapeamento, colando-os no Excel. Isso será útil no Passo 3.

Clique no botão <Save> e, a seguir, no botão <Back> . Na tela seguinte, clique novamente no botão <Back> .

Na tela LSM Workbench: Display Object Attributes, clique no botão <Display <-> Change> , e a seguir selecione a opção Batch Input Recording e coloque o nome da

gravação executada.

Para finalizar este passo, clique no botão <Save> e, a seguir, no botão <Back>

5

Passo 2 – Estrutura de Origem

O próximo passo é criar a estrutura dos dados de origem. Para criar a estrutura, dê um duplo clique no texto do passo 2 ou selecione o texto e clique no botão <Execute> .

Na tela que segue, clique no botão <Display <-> Change> , e, a seguir, clique no botão <Create a Structure> .

Na tela que surgir, preencha os campos com o nome da estrutura e com sua descrição. Uma vez que este guia não contempla a utilização de múltiplas gravações e múltiplas estruturas, a informação preenchida é irrelevante.

Para finalizar este passo, clique no botão <Save> e, a seguir, no botão <Back> .

Passo 3 – Campos de Origem

Uma vez criada a estrutura dos dados de origem, é necessário especificar quais campos serão lidos do arquivo de origem dos dados. Para fazer isso, é necessário dar um duplo clique no texto do passo 3 ou selecionar o texto e clicar no botão <Execute> .

A estrutura criada anteriormente estará listada neste ponto. Para começar a criar os campos, clique no botão <Display <-> Change> .

Existem duas formas de criar os campos. Uma delas é selecionar a estrutura clicando uma vez no seu nome, clicar no botão <Create a Field> e ir preenchendo a tela campo a campo. Caso a LSMW utilize muitos dados de entrada, esta forma não é a mais adequada.

Entre com o nome do campo, a descrição deste, o tamanho do campo (no caso do número principal do imobilizado, 12 posições), e o tipo de dado. É aconselhável utilizar sempre o tipo char (C) pois não haverá o risco do R3 interpretar erroneamente o formato do dado (por exemplo a diferença no sistema decimal – ponto ou virgula – ou de data – dd.mm ou mm.dd).

6

No caso de ser necessário criar uma grande quantidade de campos, é aconselhável utilizar o segundo método. Clicando no botão <Table Maintenance> , surgirá uma planilha que poderá ser utilizada no método copiar-colar. A estrutura da planilha é de 4 colunas sendo a primeira o nome do campo, a segunda o tipo de dado, a terceira o tamanho do campo e a quarta a descrição do campo.

Na planilha Excel que foi criada no passo 1, selecione a coluna que onde foram colados os dados de campos. Utilize o menu Dados/Text to Columns (Dados/Texto para Colunas).

Divida o texto em três colunas separando os campos, nome dos campos e descrição. A seguir, insira duas colunas entre o nome dos campos e a descrição. Na primeira coluna adicionada, coloque os tipos dos campos (no caso “C”), e na segunda coloque o tamanho dos campos.

Para identificar o tamanho dos campos, pode-se utilizar a transação SE11 com o campo definido na coluna “A” (que está no formato tabela-coluna).

Selecione a área definida dos campos (no exemplo, B1 a E11), copie e cole no R3.

7

Clique no botão <Save> e, a seguir, no botão <Back> . Repita o passo, clicando no botão <Save> e, a seguir, no botão <Back> para finalizar o passo

Passo 4 – Relacionamento de Estruturas

Para criar um relacionamento entre estruturas, entre no passo 4 dando um duplo clique no texto do passo 4 ou selecionando o texto e clicando no botão <Execute> .

Clique no botão <Display <-> Change> , e a seguir clicando no botão <Save> e no botão <Back> para finalizar o passo.

8

Passo 5 – Manutenção de Campos e de Regras de Conversão

As regras de conversão de campos deverão ser definidas no passo 5, dando um duplo clique no texto do passo ou selecionando o texto e clicando no botão <Execute> .

Caso os campos tenham sido criados de maneira correta, e utilizando nomes e descrições iguais, basta clicar no botão <Display <-> Change> , e a seguir utilizar o menu Extras/AutoField Mapping.

Na tela seguinte, selecione a opção No Confirmation e clique no botão <Continue> .

Clique no botão <Continue> , e a seguir clicando no botão <Save> e no botão <Back> para finalizar o passo.

Passo 6 – Manutenção de Valores Fixos, Traduções e Rotinas Definidas pelo Usuário

Uma vez que já foi descrita uma forma de criar valores fixos, não é necessário utilizar este passo. Ele poderá ser ignorado.

9

Passo 7 – Especificação dos Arquivos

Para especificar o arquivo de entrada de dado é necessário executar o passo 7, dando um duplo clique no texto do passo ou selecionando o texto e clicando no botão <Execute> .

No Excel, gerar o arquivo de entrada de dados. Os campos deverão estar dispostos da mesma ordem que foi especificado no Passo 3.

Em cada coluna, coloque o cabeçalho dos campos com a descrição do campo e a partir da segunda linha, comece a colocar os dados de entrada.

Salvar o arquivo no formato Texto separado por Tabulações (*.txt) em um diretório de fácil identificação.

Clicar no botão <Display <-> Change> para entrar no modo de edição e a seguir, dar um duplo clique no item Legacy Data – On the PC (Frontend).

Na tela a seguir, especificar o arquivo criado. Não se esquecer de marcar os campos Tabulator e Field Names at Start of File uma vez que o arquivo gerado é separado por tabulações e possui o nome dos campos na primeira linha.

10

Clique no botão <Continue> e a seguir no botão <Save> e no botão <Back> para finalizar o passo.

Caso a mensagem de erro “File Name 'Converted Data': Max. 45 Characters. Remaining data saved.” surja no momento em que haja a tentativa de salvar esta tela, é necessário editar os campos “Imported Data” e “Converted Data” utilizando nomes menores do que os especificados. Para isso dê um duplo clique nestes campos e edite o conteúdo.

Passo 8 – Associação de Arquivos

Uma vez que só foi associado um único arquivo a uma única estrutura de origem, basta entrar neste passo, clicar no botão <Display <-> Change> , e a seguir clicando no botão <Save>

e no botão <Back> para finalizar o passo.

11

Passo 9 – Leitura de Dados

Para efetuar a leitura dos dados do arquivo especificado, entre no passo 9.

A seguir clique no botão <Execute> , depois no botão <Back> duas vezes para finalizar o passo.

Passo 10 – Exibição de Dados Lidos

Os dados lidos podem ser exibidos para conferência através do passo 10.

Na tela que surgir, clique no botão <Continue> e depois na linha de um registro para conferência.

Confira se os dados estão de acordo com o esperado e clique no botão <Back> duas vezes para encerrar o passo.

12

Passo 11 – Conversão de Dados

Para efetuar a conversão dos dados lidos, entre no passo 11, através do item abaixo apresentado.

A seguir clique no botão <Execute> , depois no botão <Back> duas vezes para finalizar o passo.

Passo 12 – Exibição de Dados Convertidos

Para verificar se a conversão foi executada de maneira adequada, entre no passo 12.

De maneira semelhante ao passo 10, clique no botão continue na tela que surgir e depois na linha de um registro para conferência.

Confira se os dados estão de acordo com o esperado e clique no botão <Back> duas vezes para encerrar o passo.

13

Passo 13 – Criação da Pasta de Batch Input

A pasta de batch input deverá ser criada através do passo 13.

Na tela que surgir, pode-se alterar o nome da pasta de batch que deverá ser criada se desejado.

Clique no botão <Execute> e a seguir no botão <Continue> para encerrar o passo.

Passo 14 – Execução da Pasta de Batch Input

O último passo que trata da execução da Pasta de Batch Input é o mesmo que executar a transação SM35. Entre no passo 14 para executar a pasta.

Na tela que surgir (transação SM35), selecione a pasta a ser executada, e a seguir clique no botão <Process Session> .

14

Na tela que surgir haverão 3 opções de execução e mais uma série de funções adicionais. De maneira geral, desmarque o campo Dynpro standard size e selecione o modo de processamento.

Geralmente é interessante efetuar o processamento de um item em Foreground para verificar se a LSMW está funcionando como esperado. No caso do Display errors only, a execução irá permitir que o usuário interaja com o R3 quando houver um erro. No modo Background, todos os erros serão mantidos na pasta de batch como pendências a serem executadas.

As pastas executadas em Background se transformam em jobs e podem ser acompanhados pela transação SM37.

15

Outras funcionalidades

Export / Import e Transportes

As LSMW criadas podem ser transferidas de mandantes e de sistemas através de comandos de Export / Import e mesmo através de Transportes.

A vantagem de utilizar as funções de Export e Import é a possibilidade de armazenar as LSMW criadas em um computador, disquete, etc. Outra grande vantagem de se utilizar este método é poder transferir as LSMW com relativa independência, bastando ter o acesso à transação para executar esta funcionalidade.

Para exportar uma LSMW, utilize o menu Extras / Export Project na tela principal da transação.

Na tela que surgir, entre com o projeto que contém os objetos a serem exportados. Após escolher o projeto, clique no botão <Continue> .

Nesta tela, você escolher cada item que deverá ser exportado. Podem ser exportadas desde as gravações até cada uma das LSMW que forem criadas dentro deste projeto.

O ícone indica os itens que foram selecionados para serem exportados. Para marcar ou desmarcar os itens, basta clicar na sua descrição. Uma vez que todos os itens a serem exportados estejam selecionados, basta utilizar o menu Export Rules / Export para exportar os itens. Selecione o diretório onde a LSMW deverá ser gravada e clique em <Open> .

Uma vez que a LSMW esteja exportada, ela poderá ser importada em outro mandante ou sistema conforme a necessidade.

16

Para importar a LSMW, utilize o menu Extras / Import Projects. Na tela que surgir, aponte para o arquivo da LSMW salva e clique em <Open> .

Na tela que surgir, clique no botão <Continue> . A listagem de objetos que irá aparecer a seguir indica quais os objetos que estão contidos no arquivo importado. Marque ou desmarque os objetos a serem importados. O ícone indica quais itens já existem no mandante utilizado.

O próximo passo é utilizar o menu Edit / Import e a LSMW será importada para este sistema.

Para finalizar a importação, clique no botão <Continue> e em seguida em <Back> .

A partir disso a LSMW poderá ser utilizada neste sistema.

17

Cópia de Gravações de Transações

Em alguns casos, pode ser útil “copiar” a gravação de uma transação com outro nome ou mesmo para outro projeto. Uma forma de fazer isso é utilizar o menu Goto / Recordings.

Uma vez que esteja nesta tela, pode-se selecionar a gravação clicando em seu nome e utilizar o botão <Copy Recording> . Na tela que surgir, pode-se selecionar para qual projeto e qual nome a gravação deverá ser copiada.

Nesta mesma tela de administração das gravações, pode-se executar outras funções como editar, excluir, etc.

Administração de LSMW

As LSMW criadas podem ser administradas da mesma forma que as gravações através do menu Goto / Administration.

18

Erros Comuns

E.: O SAP acusa um erro ao efetuar a leitura de um determinado arquivo TXT.

S.: O arquivo TXT pode estar no formato errado (verifique se a ordem das colunas do arquivo TXT estão iguais a ordem dos campos da Estrutura de Origem). Outra possibilidade é que o arquivo TXT esteja aberto por outro programa, como por exemplo o Notepad ou mesmo o Excel.

E.: Os textos da LSMW estão em Alemão ou Inglês.

S.: A LSMW só está disponível nestas linguagens. Dependendo da configuração e dos pacotes aplicados ao R3, é possível que a LSMW se apresente em Alemão para todas as línguas, exceto para o Inglês. Existe uma nota que faz com que os textos apareçam em Inglês quando o sistema é logado com outras línguas (como o português).

E.: No Passo 7, ao tentar salvar a tela com o arquivo especificado, surge a mensagem de erro “File Name 'Converted Data': Max. 45 Characters. Remaining data saved.”.

S.: Ao criar a LSMW, foram utilizados nomes para o Projeto, Sub-Projeto e Objeto cuja soma de caracteres é superior a 30 caracteres. Neste caso, pode-se alterar os campos Imported Data e Converted Data conforme especificado no Passo 7. Lembre-se que o total de caracteres tem de ser inferior a 45.

Anexos

+ Referências DMK - LSMW.xls: Arquivo Excel contendo a máscara da LSMW criada como exemplo.

+ Referências DMK - LSMW.txt: Arquivo de Carga criado a partir da planilha Excel.

LSMW_REFERENCE.txt: LSMW exemplo exportada.

Colaboração

Alexandre Pizarro

Renato Fernandes

Contato

Sugestões, dúvidas, correções e observações:

Daniel Mizusaki Katayama daniel.katayama@accenture.com