Você está na página 1de 136

IBM WebSphere Transformation Extender

Guia de Integrao do Pack para SAP R/3


V erso 8.3

Nota Antes de utilizar estas informaes, leia as informaes gerais em Avisos na pgina 119.

Novembro de 2009 Esta edio deste documento se aplica ao IBM WebSphere Transformation Extender Verso 8.3 e a todos os releases e modificaes subsequentes, at que seja indicado o contrrio em novas edies. Para enviar comentrios sobre esse documento, envie um e-mail para dtxdocs@us.ibm.com. Aguardamos seus comentrios. A IBM pode utilizar ou distribuir as informaes fornecidas da forma que julgar apropriada, sem incorrer em qualquer obrigao para com o Cliente. Copyright International Business Machines Corporation 2006, 2009.

ndice
Captulo 1. Apresentao . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Viso Geral do WebSphere Transformation Extender Pack Integrando Informaes. . . . . . . . . . . . Viso Geral das Interfaces SAP R/3. . . . . . . . Intermediate Documents (IDocs) . . . . . . . . DXOB/Data Migration Interface (DMI) . . . . . Business Application Programming Interface (BAPI) . Batch Data Communication (BDC) . . . . . . . para SAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 2 2 3 3 4

Captulo 2. Configurando seu Ambiente SAP R/3 . . . . . . . . . . . . . . . . . . 5


Requisitos do Sistema e Instalao . . . . . . . . . . Instalando Arquivos de Correo e Transporte para o BDC . Servidor WebSphere Transformation Extender para SAP R/3 . SAP Gateway . . . . . . . . . . . . . . . . . Configurando o Sistema SAP R/3 . . . . . . . . . . 1. Criando um Sistema Lgico (BD54) . . . . . . . . 2. Criando um Destino de RFC para Dados de Sada (SM59) 3. Criando um Modelo de Distribuio (BD64). . . . . 4. Gerando um Perfil do Parceiro (BD82) . . . . . . 5. Criando Perfis do Parceiro Manualmente (WE20) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 . 5 . 7 . 7 . 8 . 8 . 9 . 12 . 13 . 13

Captulo 3. O Importer Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . 17


Viso Geral do Importer Wizard Executando o Importer Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 . 17

Captulo 4. Os Adaptadores R/3 . . . . . . . . . . . . . . . . . . . . . . . . . 19


Viso Geral dos Adaptadores R/3 . . . . . . . . . . . . . . . . . . . . Suporte ao Unicode. . . . . . . . . . . . . . . . . . . . . . . . Usando Comandos do Adaptador R/3 . . . . . . . . . . . . . . . . . . Substituies de Comandos de Execuo . . . . . . . . . . . . . . . . Configuraes de Cartes. . . . . . . . . . . . . . . . . . . . . . Comportamento da Recuperao de Dados R/3 para Bursts . . . . . . . . . . Comportamento de OnFailure com Adaptadores R/3 . . . . . . . . . . . . Sintaxe e Uso de Comandos do Adaptador . . . . . . . . . . . . . . . . Funes RUN, GET e PUT . . . . . . . . . . . . . . . . . . . . . A partir do Map Designer . . . . . . . . . . . . . . . . . . . . . A partir do Integration Flow Manager . . . . . . . . . . . . . . . . . Comandos de Conexo . . . . . . . . . . . . . . . . . . . . . . . Comandos de Conexo Necessrios para Origens JALE e ALE . . . . . . . . . Comandos de Conexo Necessrios para Destinos de ALE, Destinos de BDC e Chamada Comandos de Conexo Opcionais para Origens e Destinos JALE e ALE . . . . . . Comandos de Conexo de Sesso de Entrada de Lote para Destinos BDC . . . . . Comandos de Conexo Opcionais para todas as Origens e Destinos . . . . . . . Lista de Comandos do Adaptador . . . . . . . . . . . . . . . . . . . . ID do Programa (-A) . . . . . . . . . . . . . . . . . . . . . . . Auditoria (-AR3) . . . . . . . . . . . . . . . . . . . . . . . . Cliente (-ASCLNT) . . . . . . . . . . . . . . . . . . . . . . . . ID do Usurio do SAP (-ASUSER) . . . . . . . . . . . . . . . . . . . Backup (-B) . . . . . . . . . . . . . . . . . . . . . . . . . . Balanceamento de Carga (-BAL) . . . . . . . . . . . . . . . . . . . Nmero do Cliente (-C) . . . . . . . . . . . . . . . . . . . . . . Codificao do Conjunto de Caracteres (-enc) . . . . . . . . . . . . . . . Destino (-D) . . . . . . . . . . . . . . . . . . . . . . . . . . Host Gateway (-G) . . . . . . . . . . . . . . . . . . . . . . . . Gerao de Campo IDoc (-GEN) . . . . . . . . . . . . . . . . . . .
Copyright IBM Corp. 2006, 2009

. . . . . . . . . . . . . de . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . uma BAPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

19 20 21 21 21 21 21 21 22 23 23 23 24 24 24 25 25 25 27 27 28 28 28 29 30 31 31 33 33

iii

Grupo (-GROUP) . . . . . . . . . . . . . ID do Host (-H) . . . . . . . . . . . . . . Data de Suspenso (-HOLDDATE). . . . . . . . Manter Sesso (-KEEP) . . . . . . . . . . . Idioma de Logon (-L) . . . . . . . . . . . . Escuta (-LSN). . . . . . . . . . . . . . . Encadeamentos do Ouvinte (-N) . . . . . . . . Senha (-P) . . . . . . . . . . . . . . . . Tamanho do Pacote (-PKT) . . . . . . . . . . Release (-REL) . . . . . . . . . . . . . . Reprocessar Arquivos de Backup . . . . . . . . ID do Sistema (-S) . . . . . . . . . . . . . Tempo Limite (-timeout) . . . . . . . . . . . Rastreio (-T) . . . . . . . . . . . . . . . Transaction ID (-TID) . . . . . . . . . . . . Cdigo de Transao (-TRANS). . . . . . . . . Tipo de IDoc (-TY) . . . . . . . . . . . . . ID do Usurio (-U) . . . . . . . . . . . . . Servio de Gateway (-X) . . . . . . . . . . . Resumos de Sintaxe para Adaptadores R/3 . . . . . . Resumo de Sintaxe de Comandos do Adaptador JALE . Resumos de Sintaxe de Comandos do Adaptador ALE . Resumos de Sintaxe de Comandos do Adaptador BDC . Resumos de Sintaxe de Comandos do Adaptador BAPI. Aliases do Adaptador R/3 . . . . . . . . . . . Usando Comandos do Sistema R/3 . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .

34 35 35 35 36 36 36 37 37 37 38 38 38 38 39 40 40 40 41 41 41 42 42 42 42 43

Captulo 5. Intermediate Documents (IDocs). . . . . . . . . . . . . . . . . . . . 45


Viso Geral de IDocs . . . . . . . . . . Formato Estrutural do IDoc . . . . . . . Gerando o Relatrio do Analisador de IDoc . . Usando o Importer Wizard para IDocs . . . . Entendendo a rvore do Tipo IDoc . . . . Implementando uma Interface ALE . . . . . Seleo e Download de Metadados IDoc (WE63) Criando o Arquivo de Metadados Unicode . . Mapeamento . . . . . . . . . . . . . Usando o Importer Wizard para ALE . . . . Criando um Mapa de Sada . . . . . . . Processos de Entrada e de Sada . . . . . . Entrada de ALE para o SAP . . . . . . . Sada de ALE do SAP . . . . . . . . . Registros de Controle para Mapeamento de IDoc . Exemplo de Registro de Controle 3.x . . . . Exemplo de Registro de Controle 4.x . . . . Enviando IDocs EDI Usando ALE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 45 46 47 47 48 48 49 49 49 49 51 51 53 54 54 56 58

Captulo 6. Objetos de Transferncia de Dados (DXOB) . . . . . . . . . . . . . . . 59


Viso Geral dos Objetos de Transferncia de Dados . . . . . . Gerando Metadados DXOB . . . . . . . . . . . . . . Ambiente de Trabalho de Transferncia de Dados (SXDA) . . . Mapeamento . . . . . . . . . . . . . . . . . . . Usando o SAP:DXOB Importer . . . . . . . . . . . . Criando um Mapa para Dados Formatados DXOB . . . . . Transferindo os Dados Mapeados . . . . . . . . . . . . Transferindo os Dados Mapeados para a Camada de Aplicativo . Criando a Sesso de Entrada de Lote . . . . . . . . . . Processando a Sesso de Entrada de Lote (SM35) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 59 60 60 60 61 62 62 62 63

Captulo 7. Batch Data Communication (BDC) . . . . . . . . . . . . . . . . . . . 65 iv


IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Viso Geral do BDC . . . . . . . . . . . . Gravando uma Sesso BDC (SHDB) . . . . . . . Criando o Relatrio de Estrutura BDC (ZBDC) . . . Mapeamento . . . . . . . . . . . . . . . Entendendo a rvore do Tipo BDC . . . . . . Criando um Mapa para Dados Formatados da Sesso Carregando os Dados da Sesso BDC. . . . . . . Carregando os Dados (ZBDS) . . . . . . . . Processando uma Sesso de Lote (SM35) . . . .

. . . . . . . . . . BDC . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

. . . . . . . . .

65 66 67 68 68 69 70 71 73

Captulo 8. Business Application Programming Interface (BAPI) . . . . . . . . . . . 75


Viso Geral da Interface (BAPI). . . . . . Mapeamento . . . . . . . . . . . . Entendendo a rvore do Tipo BAPI . . . Chamando uma BAPI a partir de um Mapa Unicode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 76 77 78 79

Captulo 9. Resoluo de Problemas . . . . . . . . . . . . . . . . . . . . . . . 81


Ferramentas de Resoluo de Problemas. . . . . Log MapAudit . . . . . . . . . . . . . Log de Dados . . . . . . . . . . . . Auditoria de Execuo. . . . . . . . . . Configuraes do Mapa . . . . . . . . . Configuraes de Dados . . . . . . . . . Arquivos de Auditoria do Adaptador R/3 . . . . Arquivos de Rastreio do Adaptador R/3 . . . . Rastreio do Adaptador R/3 - Opo Detalhado . Cdigos de Retorno e Mensagens de Erro do R/3 . Visualizando Dados de Origem e de Destino do R/3 Configuraes de Backup . . . . . . . . . Dados Temporrios Restantes no Diretrio TIDDATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 81 82 82 82 83 83 83 84 84 85 86 86

Captulo 10. WebSphere SAP QISS Adapter . . . . . . . . . . . . . . . . . . . . 87


WebSphere Adapters . . . . . . . . . . . . . . . . . . . . . . Antes de Comear . . . . . . . . . . . . . . . . . . . . . . Viso Geral do WebSphere Adapter para SAP Software . . . . . . . . . . Preparando o Ambiente para os WebSphere Adapters . . . . . . . . . . . Propriedades de Conexo do SAP para o Assistente de Conexo do Adaptador. . . Configurando o Adaptador para Processamento da Query interface for SAP Software Selecionando Objetos de Negcios e Servios . . . . . . . . . . . . . Configurando os Objetos Selecionados . . . . . . . . . . . . . . . Configurando Propriedades de Implementao e Gerando o Servio . . . . . Desenvolvendo Mapas Usando o WebSphere Adapters . . . . . . . . . . Conectando-se a um Enterprise Information System . . . . . . . . . . Depurando Mapas que Contm WebSphere Adapters . . . . . . . . . . Informaes de Referncia . . . . . . . . . . . . . . . . . . . . Incluindo Dependncias de Software Externas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 . 87 . 88 . 93 . 94 . 99 . 99 . 102 . 103 . 104 . 105 . 106 . 106 . 106

Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Informaes sobre a Interface de Programao . Marcas Registradas e Marcas de Servio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 . 121

ndice Remissivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

ndice

vi

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Captulo 1. Apresentao
Uma introduo para o WebSphere Transformation Extender Pack para SAP R/3 inclui: v Viso Geral do WebSphere Transformation Extender Pack para SAP v Integrando Informaes v Viso Geral das Interfaces SAP R/3

Viso Geral do WebSphere Transformation Extender Pack para SAP


O WebSphere Transformation Extender Pack para SAP uma tecnologia exclusiva de transformao de dados para servir de interface entre aplicativos de software SAP R/3 e aplicativos de terceiros e sistemas legados. A conectividade com o ambiente SAP R/3 fornecida para dados de entrada e de sada, alm de ser suportada na maioria das plataformas SAP. As comunicaes so semelhantes comunicao do SAP R/3, exceto se os componentes usados no WebSphere Transformation Extender e no WebSphere Transformation Extender Pack para SAP aparecerem como se fossem outro sistema SAP R/3. O WebSphere Transformation Extender Pack para SAP usa Remote Function Calls (RFCs) (transacionais) sncronas e assncronas do SAP. Essa abordagem garante uma comunicao efetiva e segura entre sistemas externos e o SAP R/3. No necessrio um conhecimento detalhado das RFCs para criar interfaces para o SAP R/3 que sejam confiveis, eficientes e fceis de manter. Algum conhecimento da Base de Comunicao Remota til, mas no necessrio. Alm disso, o Pack pode ser usado com vrias interfaces baseadas em arquivo, como os subsistemas SAP DXOB/DMI e EDI. O Pack contm uma soluo Batch Data Communications (BDC) customizada que possibilita o uso do BDC a partir de um arquivo ou de uma interface baseada em RFC. O WebSphere Transformation Extender Pack para SAP usado para: v Carregamento de dados inicial v Interfaces contnuas em tempo real ou prximas do tempo real Nota: O WebSphere Transformation Extender Pack para SAP aplicvel s seguintes verses: SAP R/3 4.6, 4.7, mySAP 2004 (ECC 5.0) e mySAP 2005 (ECC 6.0). Nota: Neste documento, install_dir refere-se ao local em que o WebSphere Transformation Extender est instalado.

Integrando Informaes
O sucesso com o SAP R/3 depende de uma capacidade de integrar e compartilhar informaes com outros sistemas. Em uma configurao corporativa tpica, um nico sistema SAP R/3 precisa integrar-se a uma ampla variedade de aplicativos. Isso inclui sistemas legados, aplicativos fornecidos por terceiros e outros sistemas SAP do corporativo.

Copyright IBM Corp. 2006, 2009

Produo Aplicativos Distribudos


Remessa e recebimento Controle de produo Gerenciamento de inventrio Compra local

Vendas
Entrada do pedido Remessa e faturamento Gerenciamento de inventrio Compra local

Matrizes R/3
Dados de referncia Relatrio financeiro Compra central Sistemas de informaes

Outros Aplicativos Bancos de Dados Legados Comrcio Eletrnico Aplicativos de Terceiros

A sincronizao de dados do SAP R/3 entre os aplicativos crtica, exigindo a transferncia de transaes e de dados principais. Eventos ocorridos em um local, como o recebimento de um pedido do cliente, podem emitir aes em outros locais, como a gerao de uma ordem de produo ou a atualizao do inventrio. Para chegar a um ambiente SAP R/3 distribudo totalmente integrado, a infraestrutura de hardware e software deve ser adequada para suportar o fluxo dessas informaes vitais de forma plena entre os sistemas.

Viso Geral das Interfaces SAP R/3


O WebSphere Transformation Extender Pack para SAP, juntamente com o WebSphere Transformation Extender, suporta as seguintes interfaces e tecnologias que incluem a gerao automtica de rvores do tipo especficas de metadados: v Intermediate Documents ALE (Application Link Enabling) ALE Message Handler (AMS) Electronic Data Interchange (EDI) v DXOB/Data Migration Interface (DMI) v Business Application Programming Interface (BAPI) v Batch Data Communication (BDC) v Para os comandos especficos do adaptador, consulte a Lista de Comandos do Adaptador.

Intermediate Documents (IDocs)


A interface IDocs consiste na definio de uma estrutura de dados e na lgica de processamento dessa estrutura de dados. Essa interface usada para trocar dados de negcios entre dois sistemas diferentes. O suporte ao SAP R/3 da interface IDoc inclui as tecnologias Electronic Data Interchange (EDI) e Application Link Enabling (ALE).

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

ALE (Application Link Enabling)


A ALE vincula vrios sistemas SAP R/3 em ambientes distribudos e sistemas no-SAP ao SAP R/3 sem transferncias de arquivo para arquivo. A arquitetura SAP R/3 suporta a transferncia de dados entre os aplicativos usando o sistema de mensagens em vez de arquivos. O SAP R/3 permite a criao de um conjunto distribudo totalmente integrado de aplicativos fracamente acoplados. O Pack suporta a integrao de sistemas SAP R/3 distribudos na ALE e o fluxo de informaes entre vrios sistemas SAP R/3 para realizar objetivos de negcios especficos. O Pack tambm inclui a integrao entre aplicativos no-SAP R/3, como aplicativos de terceiros ou sistemas legados, fornecendo a tecnologia de converso necessria para realizar esse nvel de integrao entre sistemas distintos. O adaptador ALE (JALE) do SAP R/3 do WebSphere Transformation Extender inclui suporte a dados do conjunto de caracteres Unicode para entrada e sada do SAP.

ALE Message Handler (AMS)


A interface AMS fornece conectividade entre o SAP R/3 e um ou mais aplicativos distintos enviando e recebendo IDocs de uma ou mais instncias do SAP R/3. A AMS no fornece nenhuma funo de converso e envia IDocs sem alter-los. Transactional RFC deve ser o mtodo de comunicao usado entre o sistema SAP R/3 e a ALE Message Handler.

Electronic Data Interchange (EDI)


A EDI fornece s empresas a capacidade de comunicar transaes de negcios e documentos eletronicamente a seus parceiros, fornecedores e clientes.

DXOB/Data Migration Interface (DMI)


DXOBs so objetos de negcios SAP R/3 que podem ser transferidos automaticamente para o sistema SAP R/3. Exemplos de objetos de negcios so unidades organizacionais ou dados principais. O suporte ao WebSphere Transformation Extender Pack para SAP da interface DXOB inclui estruturas de objetos de transferncia de dados nos formatos beta e liberados. Durante a transferncia de dados, os dados so transferidos de um sistema externo para o sistema SAP R/3. Os aplicativos SAP suportam a transferncia de dados de diversos objetos de negcios SAP. O programa de transferncia de dados especifica a definio do formato de dados necessria para importar os dados para o sistema SAP R/3. O Pack fornece o servidor de transformao de dados para converter o formato de dados do sistema externo no formato do objeto DX.

Business Application Programming Interface (BAPI)


O adaptador BAPI (JBAPI) do WebSphere Transformation Extender ativa o suporte completo ao Unicode quando instalado com a verso mais recente do WebSphere Transformation Extender. O adaptador JBAPI fornece acesso unificado aos sistemas Unicode e no-Unicode. A BAPI fornece uma interface orientada a negcios para acessar processos e dados de negcios SAP R/3 de sistemas externos. As BAPIs fazem parte da estrutura de negcios do SAP, uma arquitetura aberta baseada em componente que permite a integrao de componentes de software do SAP e de outros provedores. O WebSphere Transformation Extender Pack para SAP suporta a capacidade de chamar uma BAPI sncrona na regra de mapeamento de um carto de sada. Os
Captulo 1. Apresentao

dados retornados da BAPI podem ser mapeados para outros objetos de dados de sada ou podem ser usados para lgica condicional. Os adaptadores SAP R/3 suportam a BAPI assim como qualquer mdulo de funo ativado remoto (RFC).

Batch Data Communication (BDC)


As sesses BDC carregam o SAP com dados legados ou automatizam as tarefas de entrada de dados repetitivas. Elas simulam a entrada on-line de transaes e dados e incluem todas as validaes construdas na transao. As sesses BDC tambm so conhecidas como Sesses de Entrada de Lote. O WebSphere Transformation Extender Pack para SAP fornece um recurso de gravao de BDC para gravar uma transao de amostra. O Importer Wizard formata a gravao em uma rvore do tipo que pode ser usada para mapear os dados diretamente para um formato de tabela BDC, que processado pelo servidor de transformao.

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Captulo 2. Configurando seu Ambiente SAP R/3


Os requisitos do sistema para instalao e execuo do SAP R/3 nas plataformas Windows e UNIX, incluindo arquivos de correo e de transporte, so detalhados nas sees a seguir. A instalao e o uso do SAP Stand-Alone Gateway e a ativao de destinos de RFC so discutidos. H tambm uma descrio de como configurar o ambiente SAP R/3 para enviar e receber dados com xito. v Requisitos do Sistema e Instalao v Servidor WebSphere Transformation Extender para SAP R/3 v SAP Gateway v Configurando o Sistema SAP R/3

Requisitos do Sistema e Instalao


Consulte o arquivo readme_sap.txt para obter detalhes sobre os requisitos mnimos do sistema e as instrues para instalar ou remover o produto SAP R/3 baseado no Windows. Nota: Alm dos requisitos mnimos do sistema, o TCP/IP deve ser instalado suportando o acesso do Design Studio para o sistema SAP R/3. O WebSphere Transformation Extender instalado em uma plataforma Microsoft Windows e contm os componentes do produto necessrios para estabelecer um ambiente de tempo de construo para o desenvolvimento de mapas. Alm do Design Studio, h vrios componentes do produto WebSphere Transformation Extender Pack para SAP instalados que facilitam o desenvolvimento de interfaces SAP R/3: v Exemplos de cada uma das interfaces SAP R/3 suportadas pelo WebSphere Transformation Extender Pack para SAP v Importadores de rvores do tipo; para obter informaes, consulte a documentao especfica da plataforma v Arquivos de Correo e Transporte para o BDC

Instalando Arquivos de Correo e Transporte para o BDC


Por Que e Quando Desempenhar Esta Tarefa
Durante o processo de instalao do WebSphere Transformation Extender Pack para SAP, os arquivos de Correo e Transporte so copiados para seu sistema. Esses arquivos so usados na criao de interfaces BDC e devem ser instalados como objetos no sistema SAP R/3. Nota: Geralmente, a equipe de instalao do Aplicativo SAP executa este procedimento. Para instalar os arquivos de Correo e Transporte para o BDC: 1. Verifique se os seguintes objetos no existem como objetos gravados pelo cliente no sistema R/3 de destino: v Elemento de Data - ZTSIDE320 v Mdulo Funcional - Z_TSI_M4BDC_SUBMIT
Copyright IBM Corp. 2006, 2009

v v v v v

Estrutura - ZTSIC320 Grupo de Funo - ZTS9 Programas - ZM4BDCSS e ZM4BDCTT Classe de Desenvolvimento - ZTS8 Cdigos de Transao - ZBDC e ZBDS

Se algum desses objetos existir, ele dever ser renomeado ou redesignado no(s) sistema(s) de destino. 2. Confirme se os arquivos de Correo e Transporte k900094.sp3 e r900094.sp3 esto localizados no diretrio install_dir\bdc. 3. Instale k900094.sp3 e r900094.sp3 como objetos no sistema R/3 de destino. Uma maneira de fazer isso usar o programa R3TRANS do Nvel de Sistema Operacional em que o SAP est instalado. a. Efetue logon no sistema operacional do servidor SAP como administrador do sistema SAP. b. Copie os arquivos de Correo & Transporte para os diretrios a seguir, localizados usualmente em c:\usr\sap\trans do servidor SAP: Copie o arquivo de Correo & Transporte k900094.sp3 para o diretrio \cofiles\. c. No prompt do DOS do servidor SAP, v para c:\usr\sap\trans\bin e execute o seguinte comando: R3TRANS c:\usr\sap\trans\data\R900094.sp3 d. Visualize o arquivo de log gerado. No final do arquivo, h um resumo dos objetos importados: 4 ETW000 Summary: 4 ETW000 4 ETW000 1 COMML imported 4 ETW000 1 COMMT imported. 4 ETW000 1 DOCUT imported. 4 ETW000 2 DYNPS imported. 4 ETW000 10 REPOS imported. 4 ETW000 7 REPOT imported. 4 ETW000 2 CUAT imported. 4 ETW000 1 ADIC data element imported. 4 ETW000 1 ADIC data element text imported. 4 ETW000 1 ADIC table imported. 4 ETW000 1 ADIC field imported. 4 ETW000 1 ADIC table text imported. 4 ETW000 Totally 33 Objects imported. e. Se o Banco de Dados do SAP for Unicode: Acesse o Editor ABAP inserindo a transao /nSE38 no campo de comando do SAP. 4. Insira ZM4BDCSS para o nome do Programa. 5. Ative a caixa de opo Atributos para modificar o programa ABAP. 6. Clique no boto Alterar. A janela ABAP: Modificao dos Atributos do Programa ZM4BDCSS aparece. 7. Ative a caixa de opo Verificaes do Unicode ativas. 8. Clique no boto Salvar. 9. Clique no boto Ativar. 10. Repita estas etapas para alterar os atributos do programa ZM4BDCTT para Verificaes do Unicode ativas.

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

a. Efetue logon no cliente SAP. Insira a transao SE80 no campo de comando. Insira ZTSI para o Pacote. A janela a seguir aberta. Nota: Se todos os objetos da captura de tela NO ficarem visveis ou se voc receber um erro ao chamar essas duas transaes, ser necessrio investigar iniciando pelo arquivo R3Trans.log. Quando voc tiver corrigido o erro, refaa a importao. b. No campo de comando do SAP, chame as transaes /nZBDC e /nZBDS.

Servidor WebSphere Transformation Extender para SAP R/3


O servidor no qual o WebSphere Transformation Extender e o WebSphere Transformation Extender Pack para SAP so instalados ser referido como Servidor WebSphere Transformation Extender para SAP R/3. O WebSphere Transformation Extender Pack para SAP pode ser instalado no: v Microsoft Windows 2000, 2003 e XP v HP-UX PA-RISC 11i v IBM AIX 5.2 e 5.3 v Sun Solaris 9 e 10 v Linux RedHat 3.0 v Linux Suse 9.1 v Mainframe IBM z/OS USS Nota: O TCP/IP deve ser instalado para suportar o acesso do Servidor WebSphere Transformation Extender para R/3 ao sistema SAP R/3. Nota: A biblioteca do cliente SAP RFC 6.40 ou mais recente usada em todas as plataformas. Se o SAP Front End tiver sido instalado no sistema Windows, essa biblioteca j dever estar instalada em Windows\system32. Verifique para assegurar-se de que tenha a verso correta. Se o SAP Front End no estiver instalado, consulte seu Administrador do SAP para obter essa biblioteca do SAP. Consulte a Nota 19466 no Web site do Service Marketplace para obter detalhes sobre como obter downloads. v Se voc estiver instalando o SAP Pack no Windows, copie a biblioteca para qualquer diretrio em PATH. v Se estiver instalando o SAP Pack no UNIX, transfira a biblioteca por ftp para qualquer diretrio especificado pela varivel de ambiente LD_LIBRARY_PATH (Sun Solaris), LIB_PATH (aix) ou SHLIB_PATH (hp).

SAP Gateway
O SAP Gateway um produto de software SAP disponvel para plataformas Windows e UNIX para fornecer conectividade de rede. Os adaptadores R/3 suportam o mtodo de Registro para a ativao de destinos de RFC. Para obter a ativao de destinos de RFC necessria, o SAP Gateway, usado como um produto independente, deve ser instalado. O SAP Stand-Alone Gateway fornece um mtodo seguro para a comunicao entre os sistemas SAP e externos. Esse o mtodo de

Captulo 2. Configurando seu Ambiente SAP R/3

comunicao recomendado pelo SAP. O SAP requer o uso de um gateway independente para todas as interfaces ALE certificadas. Nota: Para obter informaes sobre como instalar o SAP Gateway, consulte a documentao do SAP.

Configurando o Sistema SAP R/3


Seu sistema SAP R/3 deve ser configurado adequadamente para enviar e receber dados. Essa configurao requer: 1. Criando um Sistema Lgico (BD54) 2. Criando um Destino de RFC para Dados de Sada (SM59) 3. Criando um Modelo de Distribuio (BD64) 4. Gerando um Perfil do Parceiro (BD82)

1. Criando um Sistema Lgico (BD54)


Por Que e Quando Desempenhar Esta Tarefa
Todo cliente SAP R/3 usado para ALE/RFC deve ter um sistema lgico (LS) de base associado ao cliente SAP. Nota: Essa associao criada geralmente no momento da instalao pela equipe de instalao dos Aplicativos SAP. Todo LS de base torna-se o emissor de mensagens de sada e um receptor de mensagens de entrada. Alm do LS de base, necessrio criar sistemas lgicos adicionais nesse sistema SAP R/3 para cada sistema SAP R/3 e externo usados para interfaces ALE. Em uma interface ALE/RFC de entrada, este segundo LS representa o emissor em relao ao LS de base. Em uma interface ALE/RFC de sada, este segundo LS um receptor. possvel criar um sistema lgico para cada sistema externo que se comunicar com o SAP R/3. O design de seus mapas e sistemas determinam o que um sistema externo. Geralmente voc cria um sistema externo para corresponder a cada sistema no-SAP distinto. A transao BD54 cria um sistema lgico para representar o sistema servidor para a distribuio de dados de e para o sistema SAP R/3. Para criar um sistema lgico 1. Insira /nBD54 no campo de comando e clique em Enter. 2. Clique em Enter na janela de informaes, que alerta que voc est no processo de manuteno de uma tabela independente do cliente e que quaisquer mudanas feitas tero efeito em todos os outros clientes no sistema. A janela Alterar Visualizao Sistemas Lgicos: Viso Geral aberta, listando os sistemas lgicos definidos atualmente. 3. Clique em Novas entradas para criar o sistema lgico (LS). A janela Novas Entradas: Viso Geral de Entradas Includas aberta.

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

4. Insira um nome para o LS e uma descrio significativa. (Neste exemplo, o nome do LS ser CUSTOMERLS. O nome do LS de base E47CLNT800.) Nota: A conveno de nomenclatura seguida para o LS deve ser informativa porque ela ser usada para nomear o destino de RFC e os perfis dos parceiros. 5. Selecione CTRL + F4. A caixa de dilogo Alterar == Exibir aberta para confirmar a mudana. 6. Clique em Sim para salvar. A caixa de dilogo Prompt para Pedido do Ambiente de Trabalho aberta. 7. Para completar a criao do LS, voc deve obter um nmero de pedido. Crie um nmero de pedido para cada novo LS includo. No campo Pedido, selecione um valor na lista suspensa e clique em Enter. 8. Retorne para a janela Exibir Visualizao Sistemas Lgicos: Viso Geral. 9. Escolha Salvar no menu Visualizao de Tabela e clique em Enter. O LS criado.

2. Criando um Destino de RFC para Dados de Sada (SM59)


Por Que e Quando Desempenhar Esta Tarefa
O destino RFC usado durante a Camada de Comunicao do processamento ALE. Quando a Determinao do Receptor identifica uma comunicao tRFC, o destino de RFC define a comunicao fsica para o destino remoto. Os destinos de RFC so usados apenas para sada de comunicaes do SAP R/3. Para criar um destino de RFC para dados de sada voc estar: v Configurando um destino de RFC. v Configurando opes de gateway para que reflitam os valores usados ao instalar o gateway independente. v Opcionalmente, definindo opes de tRFC para configurar as especificaes de novas tentativas de conexo no caso de tempos limite de comunicao ou erros de conexo. Isso feito especificando-se o nmero de novas tentativas, alm do intervalo entre duas tentativas consecutivas. Alternativamente, voc pode suprimir a tarefa de plano de fundo para novas tentativas de conexo. O SAP R/3 possui um recurso de processamento de erro coletivo que pode ser ativado, que executa manipulao de erros por meio de uma tarefa planejada que executada no plano de fundo.

Configurando um Destino de RFC


Por Que e Quando Desempenhar Esta Tarefa
O destino de RFC pode ser criado para definir a comunicao fsica para o destino remoto. As etapas a seguir referem-se ao design do aplicativo SAP R/3 Enterprise. Para configurar um destino de RFC: 1. Insira a transao /nsm59 no campo de comando e clique em Enter. A janela Exibir e Manter Destinos de RFC aberta. 2. Clique com o boto direito do mouse em Conexes TCP/IP e clique em Criar. A janela Destino de RFC aberta. 3. Insira as informaes conforme definido na tabela a seguir e clique em Enter. A janela Destino de RFC propagada com suas informaes.
Captulo 2. Configurando seu Ambiente SAP R/3

Tabela 1. Detalhes da janela Destino de RFC Campo Destino de RFC Tipo de Conexo Descrio Enter Insira o nome do Destino de RFC. Use o mesmo nome que o Sistema Lgico. Insira T (TCP/IP) para o Tipo de Conexo. Insira uma descrio significativa no campo Descrio.

4. Clique na guia Opes Especiais. O recurso Rastreio est localizado sob a guia Opes Especiais. Voc pode ativar o Rastreio para propsitos de teste; entretanto, no ative o Rastreio em um ambiente de produo. 5. Clique na guia Configuraes Tcnicas. Insira as informaes conforme definido na tabela a seguir e clique em Enter.
Tabela 2. Guia Configuraes Tcnicas Campo Tipo de Ativao ID do Programa Enter Ative Programa do Servidor Registrado. Insira o ID do Programa. Esse o ID do programa especificado ao usar o comando de adaptador ID do Programa (-A) para qualquer origem R/3 (sada).

6. Clique na guia Logon/Segurana. Ative ou desative a Opo de Segurana. Clique no boto Salvar.

Opes de Gateway
Por Que e Quando Desempenhar Esta Tarefa
As opes de gateway so configuradas para corresponder exatamente aos valores usados ao instalar o SAP Stand-Alone Gateway. Para configurar as opes de gateway: 1. Insira a transao /nsm59 no campo de comando e clique em Enter. A janela Exibir e Manter Destinos de RFC aberta. 2. Expanda Conexes TCP/IP e clique duas vezes na conexo TCP/IP aplicvel. A janela Destino de RFC aberta. 3. Clique na guia Configuraes Tcnicas. Insira as informaes conforme definido na tabela e, em seguida, clique em Enter. Nota: Os valores para Host Gateway e Servio de Gateway podem ser nomes simblicos. Entretanto, a especificao do endereo IP e do nmero do servio pode melhorar o desempenho e reduzir erros.
Tabela 3. Opes de Gateway Campo Host Gateway Enter Insira o nome ou o endereo IP de seu host gateway. (Neste exemplo, 192.168.1.229.) O valor inserido em Host Gateway o valor especificado ao usar o comando de adaptador Host Gateway (-G) para qualquer origem SAP R/3. Esse valor deve corresponder exatamente.

10

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Tabela 3. Opes de Gateway (continuao) Campo Servio de gateway Enter Insira o nome de seu servio de gateway. O servio de gateway o nome do servio criado durante a instalao do software SAP Stand-Alone Gateway. O padro sapgw00. Alternativamente, voc pode usar o endereo de porta em vez do nome do servio de gateway (neste exemplo, o valor 3300.) O valor inserido em Servio de Gateway (-A) o valor especificado ao usar o comando de adaptador Servio de Gateway para qualquer origem SAP R/3. Esse valor deve corresponder exatamente.

Opes de tRFC
Por Que e Quando Desempenhar Esta Tarefa
Dependendo de sua configurao, pode ser til especificar novas tentativas automticas para dados de sada. As Opes de tRFC (opes de nova tentativa) determinam o comportamento do SAP R/3 durante erros de comunicao ou falhas. Se voc estiver encontrando tempos limites de comunicao ou erros de conexo frequentes (visveis no Monitoramento de tRFC do SM58), implemente essas opes de nova tentativa. Nota: A configurao de Opes de tRFC uma etapa nica. possvel manter as Opes de tRFC clicando no boto tRFC na janela Destino de RFC. Configure as Opes de tRFC para especificar novas tentativas automticas para dados de sada. Alm disso, o SAP R/3 possui um recurso de processamento de erro coletivo que pode ser ativado, que executa manipulao de erros por meio de uma tarefa planejada que executada no plano de fundo. Para configurar as Opes de tRFC: 1. Insira a transao /nsm59 no campo de comando e clique em Enter. A janela Exibir e Manter Destinos de RFC aberta. 2. Expanda Conexes TCP/IP e clique duas vezes na conexo TCP/IP aplicvel. (Para este exemplo, clique duas vezes em DATASTGTX1.) A janela Destino de RFC aparece. 3. No menu Destino, escolha Opes de tRFC. A caixa de dilogo RFC Transacional: Configurao do Sistema para Erro de Conexo aberta. 4. No campo Suprimir Tarefa de Plano de Fundo se conn.error, insira o valor X e, em seguida, clique em Continuar. A janela Destino de RFC reaparece. 5. No menu Destino, escolha Salvar.

Processamento de Erro Coletivo


Por Que e Quando Desempenhar Esta Tarefa
O SAP R/3 trata dos erros de RFC iniciando um processo de segundo plano que reinicia a RFC at que ela seja processada com xito. Se a conexo com o sistema de recebimento for interrompida, esse processo poder ser executado indefinidamente. Esse esquema pode resultar em um grande nmero de processos de segundo plano em execuo no sistema de envio, o que degradar o desempenho geral. Para minimizar esses efeitos em um ambiente de execuo, use
Captulo 2. Configurando seu Ambiente SAP R/3

11

o processamento de erro coletivo. Com o processamento de erro coletivo, a RFC falha no ser ressubmetida imediatamente. Em vez disso, uma tarefa de plano de fundo planejada periodicamente coletar RFCs com falha e as reiniciar como um pacote. Esta tcnica aplicvel para conexes SAP R/3 e TCP/IP. Configurando o Processamento de Erro Coletivo para RSARFCEX: Planeje o programa RSARFCEX para processar periodicamente as transmisses com falha. Configurando o Processamento de Erro Coletivo Usando SM58: 1. Depois que as configuraes acima estiverem em vigor, voc poder selecionar a transao SM58 manualmente. 2. Selecione os critrios apropriados e clique em Executar. 3. Selecione um mdulo de funo falho e selecione Executar LUW a partir do menu Editar.

3. Criando um Modelo de Distribuio (BD64)


Por Que e Quando Desempenhar Esta Tarefa
Um Modelo de Distribuio contm as especificaes que identificam quais mensagens (Tipos de Mensagens) fluem para qual sistema lgico. Um Modelo de Distribuio designa o tipo de dados a ser trocado. Voc estar modelando a troca de tipos de dados a partir de ambas as visualizaes, Emissor e Sistema Externo, de seu sistema SAP R/3 e WebSphere Transformation Extender.

Criando Tipos de Mensagens para o Modelo de Distribuio


Por Que e Quando Desempenhar Esta Tarefa
Tipos de mensagens so usados em um Modelo de Distribuio para representar o tipo de dado que est sendo trocado entre o sistema SAP R/3 e o WebSphere Transformation Extender Pack para SAP. Para criar tipos de mensagens: 1. Insira /nbd64 no campo de comando e clique em Enter. A janela Exibir Modelo de Distribuio aparece. 2. Expanda SUBSYSTEMS para visualizar a lista. (Geralmente, o Modelo de Distribuio SUBSYSTEMS padro usado.) 3. Selecione seu sistema SAP R/3. (Por exemplo, E47CLNT800.) 4. Clique no boto Incluir tipo de mensagem. A caixa de dilogo Incluir Tipo de Mensagem aberta. 5. Insira os dados do tipo de mensagem da comunicao do sistema SAP R3 com um sistema externo. v Emissor: Insira o sistema lgico SAP R3 atual. (Neste exemplo, E47CLNT800.) v Receptor: Insira o nome do sistema lgico que foi criado. (Neste exemplo, CUSTOMERLS.) v Tipo de mensagem: Insira o tipo de mensagem. (Este exemplo usa DEBMAS.)

12

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Nota: Um modelo de comunicao do sistema SAP R3 com um sistema externo (CUSTOMERLS) estabelecido. 6. Clique em Enter. 7. Retorne para a janela Alterar Modelo de Distribuio e continue com o processo de incluso de outro tipo de mensagem para concluir o modelo de distribuio. 8. Selecione SUBSYSTEMS e, em seguida, clique em Incluir tipo de mensagem. A caixa de dilogo Incluir tipo de mensagem aberta. 9. Insira os dados do tipo de mensagem da comunicao do sistema externo com o sistema SAP R3: v Emissor: Insira o sistema lgico do sistema externo (neste exemplo, CUSTOMERLS). v Receptor: Insira o nome do sistema lgico SAP R3 atual (neste exemplo, E47CLNT800). v Tipo de mensagem: Insira o tipo de mensagem (este exemplo usa DEBMAS). Nota: Um modelo de comunicao de um sistema externo com o sistema R3 estabelecido. 10. Clique em Enter para retornar janela Alterar Modelo de Distribuio. 11. No menu Modelo, escolha Salvar e clique em Enter.

4. Gerando um Perfil do Parceiro (BD82)


Por Que e Quando Desempenhar Esta Tarefa
A definio de porta pode ser gerada com base no destino de RFC e no perfil do parceiro. O perfil do parceiro gerado com base no Modelo de Distribuio e na definio da porta. Para gerar um perfil do parceiro: 1. Insira /nbd82 no campo de comando e clique em Enter. A janela Gerando Perfil do Parceiro aberta. 2. No campo Visualizao Modelo, selecione uma visualizao de modelo de distribuio na lista suspensa. (Neste exemplo, SUBSYSTEMS.) 3. No campo Sistema Parceiro, selecione um Sistema Lgico na lista suspensa. (Neste exemplo, CUSTOMERLS.) 4. Selecione Coletar IDocs e transferir. (Esse o padro, que pode ser alterado usando o cdigo de transao WE20.) 5. Selecione Acionar pelo processamento de segundo plano para que no haja substituio por sinalizadores expressos. (Esse o parmetro padro, que pode ser alterado usando o cdigo de transao WE20.) 6. Clique em Executar. A janela Gerando Perfil do Parceiro aberta listando as mensagens e confirmando a gerao de uma porta e de um perfil do parceiro.

5. Criando Perfis do Parceiro Manualmente (WE20)


Por Que e Quando Desempenhar Esta Tarefa
O Modelo de Distribuio s aplicvel a interfaces ALE. Ao usar o Modelo de Distribuio, a transao BD82 atualizar/criar automaticamente as definies de
Captulo 2. Configurando seu Ambiente SAP R/3

13

perfil do parceiro e criar definies de porta RFC conforme necessrio. No entanto, essas definies devero ser criadas ou modificadas manualmente em situaes como: v Quando no conseguir usar o Modelo de Distribuio, voc dever criar manualmente as definies de perfil do parceiro (WE20) e de porta (WE21). Consulte a Biblioteca SAP On-line para obter informaes adicionais. v Ao usar o mtodo de criao de IDoc baseado no arquivo EDI, voc precisar criar manualmente os perfis do parceiro. v Ao modificar os parmetros de Perfil do Parceiro antes da produo ou para criar perfis de parceiro manualmente. H situaes em que os perfis do parceiro devem ser criados ou modificados manualmente.

Para Criar Perfis do Parceiro Manualmente


1. Insira a transao /nWE20 no campo de comando e clique em Enter. A janela Perfis do Parceiro aberta. 2. Selecione no menu Parceiros, Criar ou Exibir Mudana, para criar um novo perfil ou para modificar um perfil existente. 3. Insira Parmetros de sada ou Parmetros de entrada, conforme apropriado.

Resultados
Na janela Parmetros de Sada, voc poder incluir ou alterar as informaes, conforme necessrio. Os vrios relatrios podem ser ser executados a partir dos cdigos de transao. v RSEOUT00: Faz dispatch dos IDocs coletados em uma tarefa em lote. v RSEOIND: Verifica a concluso bem-sucedida da transmisso de uma tRFC para a camada de comunicao. Se concluda com xito, o status do IDoc ser alterado. Relatrio de planejamento RSEOUT00 Conforme recomendado pelo SAP, o programa RSEOUT00 deve ser planejado para enviar IDocs usando RFCs transacionais. Isso envia pacotes de IDoc em uma transmisso, usando um logon e pode fornecer melhor desempenho do que enviar IDocs individualmente. Evite enviar IDocs individuais porque cada transmisso envolve sobrecarga significativa, como o carregamento de programas, o estabelecimento de conexo e a realizao de logon. Ao usar RSEOUT00, observe o tamanho dos pacotes de IDoc, que podem ser definidos nos parmetros de sada do contrato de parceiro correspondente. Para otimizao, o tamanho dos objetos de dados envolvidos e o nmero de processos disponveis nas extremidades de transmisso e de recebimento devem ser considerados. O SAP R/3 recomenda, geralmente, a compactao de 2 a 20 IDocs por pacote para IDocs com vrios segmentos (como ALEUD e GLDCMT) e de 20 a 2.000 IDocs por pacote para IDocs com um nmero pequeno de segmentos. O uso de RSEOUT00 requer um ou mais processos de trabalho de dilogo para ativar as transmisses paralelas de pacotes de IDoc. Para o SAP R/3 verses 3.1i e superior, o suporte de gerenciamento de recurso tRFC est disponvel. O SAP R/3 avisa que, para evitar tempos limite, o nmero de processos de trabalho de dilogo

14

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

do lado do emissor deve ser menor ou igual ao nmero de processos disponveis no receptor. Consulte OSS note 74141 na Documentao do SAP R/3 para obter detalhes. Ao enviar pacotes de IDoc em paralelo usando este mtodo, os pacotes no podero ser recebidos na ordem serial. Se a serializao da transmisso de pacotes de IDoc for necessria, use um processo peridico nos pacotes recebidos. Para isso, configure seus perfis de parceiro para processamento de segundo plano e selecione um intervalo de processamento grande o suficiente para garantir que todos os pacotes interdependentes possam ser recebidos. Com base em seus registros de data e hora, os pacotes so ento reordenados antes do processamento. Relatrio de planejamento RBDMOIND Quando os IDocs de sada so passados para a camada de comunicao com xito, eles so designados com o status dados passados para a porta OK. Isso no significa que foi uma transmisso de tRFC bem-sucedida. O relatrio RBDMOIND de SE38 deve ser iniciado regularmente para verificar se a comunicao foi concluda com xito. Se concluda com xito, o status do IDoc ser alterado. O relatrio RBDMOIND indica se os IDocs de sada foram transmitidos para a camada de comunicao com xito e se devem ser planejados para execuo regularmente.

Para Planejar o Relatrio RBDMOIND


1. Defina variantes para a tarefa. 2. Planeje a tarefa com o relatrio e uma variante em uma etapa.

Parmetros de Entrada
Na janela Perfis do Parceiro: Parmetros de Entrada, possvel incluir ou alterar as informaes do perfil do parceiro, conforme necessrio. Para alterar parmetros de entrada do Perfil do Parceiro, escolha o Tipo de mensagem apropriado e o Cdigo de processo correspondente, vinculado ao Mdulo de Funo. Execute o relatrio RBDAPP01 para processar o IDoc de plano de fundo.

Relatrio de Planejamento RBDAPP01


O processamento do IDoc de plano de fundo feito pelo relatrio RBDAPP01. Evite transmisses nicas de IDoc porque h uma sobrecarga significativa envolvida (como carregamento de programa, conexo e logon). O tempo de processamento de entrada afetado na extremidade de recebimento quando os pacotes de IDoc so separados inicialmente em IDocs separados e os IDocs de entrada individuais so armazenados no banco de dados. O controle de transmisso de aplicativo definido no contrato do parceiro correspondente determina se o IDoc deve ser processado imediatamente ou planejado para processamento pelo programa RBDAPP01. O SAP recomenda o uso do RBDAPP01 para melhorar o desempenho se o processamento imediato no for necessrio. As informaes fornecidas so mnimas e podem no tratar de todos os requisitos de comunicao, como informaes sobre manuteno do cdigo de empresa

Captulo 2. Configurando seu Ambiente SAP R/3

15

global, ativao do ponteiro de mudana, manuteno de intervalos de nmeros, etc. Consulte a Biblioteca SAP On-line para obter informaes adicionais. Alm disso, os valores de parmetros padro no perfil da instncia no so suficientes para interfaces ALE com alto volume. Consulte a equipe de instalao dos Aplicativos SAP e as notas OSS para obter as mudanas recomendadas para esses valores.

16

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Captulo 3. O Importer Wizard


Use o Importer Wizard para importar arquivos BAPI, BDC, IDoc e DXOB para gerar automaticamente uma rvore do tipo .mtt. Para obter informaes adicionais sobre o Importer Wizard, revise: v Viso Geral do Importer Wizard v Executando o Importer Wizard

Viso Geral do Importer Wizard


O Importer Wizard usa a entrada de metadados especfica da estrutura do SAP R/3 para gerar rvores do tipo contendo as definies de tipo correspondentes. O Importer Wizard usa vrios mapas para converter metadados em um arquivo de script de rvore do tipo (extenso de arquivo .mts). O Criador da rvore de Tipo processa ento esse script da rvore de tipo e gera uma rvore de tipo contendo todos os tipos suportados definidos nos metadados importados. Por exemplo, a ilustrao a seguir mostra vrios arquivos de definio de IDoc RSEIDOC3 sendo importados para o Importer Wizard, que gera, automaticamente, a rvore do tipo correspondente.

Definies de IDoc RSEIDOC3 Sistema SAP R/3 Importer Wizard rvore do Tipo (.mtt)

Mapas do Importador

Criador da rvore de Tipo

As rvores de tipo geradas pelo Importer Wizard podem ser usadas imediatamente para desenvolvimento do mapa. Dependendo do contedo do arquivo de metadados especfico da interface, pode ser necessrio modificar a rvore de tipo gerada usando-se o Type Designer. Consulte cada seo especfica da interface para obter informaes sobre as rvores de tipo geradas.

Executando o Importer Wizard


Por Que e Quando Desempenhar Esta Tarefa
Quando a entrada de metadados do SAP contiver uma das estruturas suportadas descrevendo os dados para os quais voc deseja criar uma interface, voc estar pronto para executar o Importer Wizard. Para executar o Importer Wizard: 1. Inicie o Type Designer. 2. Selecione Importar rvore do tipo e clique em OK.
Copyright IBM Corp. 2006, 2009

17

O Importer Wizard aberto. 3. Selecione a interface SAP (IDOC, DXOB, BDC, BAPI) para a qual deseja gerar uma rvore do tipo e clique em Avanar. 4. A prxima caixa de dilogo aberta, solicitando informaes sobre o sistema SAP que originou o arquivo de metadados que est sendo importado. Insira as informaes apropriadas e clique em Avanar. A caixa de dilogo de idioma aberta. 5. Especifique o idioma nacional e o conjunto de caracteres de dados que descreve os dados para execuo do mapa e, em seguida, clique em Avanar. 6. As prximas caixas de dilogo que aparecero dependem da interface para a qual voc est gerando uma rvore do tipo. O Wizard apresenta as caixas de dilogo aplicveis para que voc especifique informaes especficas da interface. Por exemplo, ao gerar uma rvore do tipo para a BAPI, a caixa de dilogo Configuraes de Conexo do SAP aparece para que voc possa especificar parmetros de conexo do adaptador. Consulte cada captulo especfico da interface para obter essas informaes. 7. Depois de inserir informaes especficas da interface apresentadas pelo Wizard, uma caixa de dilogo aberta solicitando o caminho e o nome de arquivo completos dos metadados para os quais voc est gerando uma rvore do tipo. Especifique o objeto de metadados para o qual voc deseja gerar uma rvore do tipo e fornea quaisquer informaes adicionais que o Importer Wizard precisar para a interface especfica. Por exemplo, ao gerar rvores do tipo a partir de um IDoc, necessrio designar se o arquivo IDoc representar dados para uma interface ALE ou EDI. Consulte cada seo especfica da interface para obter informaes adicionais. 8. Insira o nome do arquivo da rvore de tipo (com uma extenso de arquivo .mtt) a ser gerada e quaisquer informaes adicionais que o Wizard precisar para a interface especfica e clique em Avanar. Consulte o captulo especfico da interface para obter informaes adicionais. Nota: til usar uma conveno de nomenclatura. Por exemplo, para uma interface BDC, use BDC-xxxx.mtt, em que xxxx o cdigo de transao do SAP. 9. A prxima caixa de dilogo do Importer Wizard ser aberta mostrando o status da rvore do tipo que est sendo criada. possvel rolar pela rvore do tipo. A caixa de dilogo do Importer Wizard tambm mostra o nmero de erros e avisos ocorridos durante a gerao da rvore do tipo.

18

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Captulo 4. Os Adaptadores R/3


Os componentes especficos do SAP para o ambiente de tempo de execuo do SAP R/3 so os adaptadores R/3 para plataformas baseadas no Windows e no UNIX. Esta seo apresenta os adaptadores R/3 e fornece instrues para uso do adaptador, configuraes do adaptador e comandos do adaptador, incluindo: v Viso Geral dos Adaptadores R/3 v Usando os Comandos do Adaptador R/3 v v v v Comandos de Conexo Resumos de Sintaxes para Adaptadores R/3 Aliases do Adaptador R/3 Usando Comandos do Sistema R/3

Viso Geral dos Adaptadores R/3


Ambas as funcionalidades, de cliente e de servidor, so suportadas em um adaptador R/3. Um adaptador R/3 contm as Remote Function Calls (RFCs) necessrias para passar dados de entrada e de sada de e para o SAP R/3. O adaptador inclui integrao transparente das RFCs para que no seja necessrio possuir conhecimento detalhado sobre elas. Os adaptadores tambm gerenciam informaes transacionais, como transaction IDs (TIDs) da mensagem, conforme necessrio. Esse recurso garante integrao perfeita com o SAP R/3, alm de fornecer um mecanismo de auditoria eficiente. Quando um mapa possui um carto de entrada que define um adaptador R/3 como a origem, a funo de servidor do adaptador chamada para executar as RFCs necessrias para garantir uma coleta bem-sucedida dos dados de entrada a partir do sistema SAP R/3. Por exemplo, um sistema SAP R/3 possui dados que foram definidos como entrada para um mapa especfico executado em um Servidor de Comandos. O mapa contm um carto de entrada que possui o adaptador R/3 definido como a origem do adaptador. O adaptador R/3 (servidor) recebe as RFCs necessrias para recuperar os dados do SAP R/3. O adaptador passa, ento, os dados por meio de buffers de memria do SAP R/3 diretamente para o mapa em execuo para transformao no formato de destino. Para um carto de sada, depois que um mapa do WebSphere Transformation Extender transforma os dados de origem, a funo de cliente do adaptador R/3 chamada, executando as RFCs necessrias para garantir uma entrega bem-sucedida dos dados de entrada para o destino em um sistema SAP R/3. Os adaptadores R/3 usados para servir como interface para o aplicativo SAP R/3 so: v JALE (para Unicode) v ALE v JBAPI (para Unicode e no-Unicode) v BAPI v BDC

Copyright IBM Corp. 2006, 2009

19

Suporte ao Unicode
O adaptador JBAPI baseia-se em JCo, a API Java do SAP, que permite comunicao com sistemas SAP. O adaptador JBAPI totalmente compatvel com verses anteriores do adaptador BAPI nativo, no entanto, o adaptador JBAPI fornece suporte completo de Unicode. O adaptador JBAPI suporta o Unicode diretamente e fornece acesso unificado aos sistemas Unicode e no-Unicode. O adaptador JALE inclui suporte a dados do conjunto de caracteres Unicode para entrada e sada do SAP. Para ativar mapas de suporte ao Unicode que usam o adaptador JALE, necessrio usar as rvores do tipo IDoc geradas pelo importador do IDoc com a opo de conjunto de caracteres de dados definida como Unicode. Enviando dados Unicode, Entrada para o SAP do adaptador JALE Ao contrrio do adaptador ALE nativo, o adaptador JALE pode comunicar dados Unicode para um sistema SAP R/3. O formato de dados Unicode suportado pelo adaptador JALE UTF-16BE, big endian Unicode. Para fins de mapeamento, altamente recomendvel usar as rvores do tipo geradas pelo importador da rvore do tipo IDoc. O uso de rvores do tipo IDoc Unicode garante que os dados passados para o adaptador JALE tenham a sintaxe correta, que seja reconhecida pelo adaptador JALE. Para enviar dados Unicode para o adaptador JALE, use a rvore do tipo ALE do conjunto de caracteres Unicode. O sistema SAP R/3 deve ser compatvel com Unicode para poder processar os dados Unicode enviados a ele a partir do adaptador JALE. Enviando dados Unicode, Sada do SAP para o adaptador JALE Ao contrrio do adaptador ALE nativo, o adaptador JALE pode receber e processar dados Unicode a partir de um sistema SAP R/3. O formato de dados Unicode suportado pelo adaptador UTF-16BE, big endian Unicode. Antes de enviar dados Unicode de um sistema SAP R/3 para um sistema externo, o destino de RFC do SAP designado ao sistema externo deve ser configurado corretamente. Para ativar as opes de Unicode: 1. Insira a transao SAP /nsm59. 2. Clique na guia Opes Especiais. 3. Selecione a opo Unicode em Largura do Caractere na seo Sistema de Destino. 4. Salve as mudanas. Depois de salvar, possvel enviar dados Unicode para o Destino de RFC selecionado. A rvore do tipo IDoc que ser usada para analisar a origem de dados JALE tambm deve suportar dados Unicode. altamente recomendvel o uso do importador da rvore do tipo IDoc para gerar a rvore do tipo IDoc. O uso de rvores do tipo IDoc Unicode garante que os dados passados para o adaptador JALE tenham a sintaxe correta, que seja reconhecida pelo adaptador JALE. Para enviar dados Unicode para o adaptador JALE, use a rvore do tipo ALE do conjunto de caracteres Unicode.

20

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Usando Comandos do Adaptador R/3


Os comandos do adaptador R/3 so usados para customizar a operao do adaptador e podem ser especificados para a origem de dados de um carto de mapa de entrada, para o destino de dados de um carto de mapa de sada, ou para ambos. Para obter informaes adicionais, consulte Adaptadores de Recursos no Centro de Informaes.

Substituies de Comandos de Execuo


Os comandos de execuo podem ser usados, por meio de linhas de comandos, para substituir as configuraes de uma origem SAP R/3 existente. Tambm possvel substituir arquivos existentes, aplicativos, origem da mensagem ou destino da mensagem.

Configuraes de Cartes
Para obter detalhes sobre as configuraes de cartes, consulte as informaes do Map Designer no Centro de Informaes. Os seguintes valores podem ser usados para o carto de entrada de origem e o carto de sada de destino para ativar adaptadores SAP: v ALE ou JALE v BAPI ou JBAPI v BDC

Comportamento da Recuperao de Dados R/3 para Bursts


Todos os objetos SAP R/3 (IDoc, BAPI, BDC e DXOB) so recuperados do adaptador antes do primeiro burst. O servidor os consome, ento, na taxa especificada pela configurao FetchUnit.

Comportamento de OnFailure com Adaptadores R/3


Quando a configurao do carto de entrada Transao > OnFailure igual a Confirmar e o mapa no concludo com xito, os dados IDoc so perdidos.

Sintaxe e Uso de Comandos do Adaptador


O exemplo a seguir uma configurao de Destino do comando em um carto de sada de um adaptador ALE.
-c 800 -u ALE-USER -p IDES -h M699 -s 00 -ar3

Os comandos do adaptador so usados na conexo com o sistema SAP R/3 para o qual os dados transformados esto sendo destinados.
Tabela 4. Sintaxe e Uso de Comandos do Adaptador Comando/Valor do Adaptador -c 800 -u ALE-USER -p IDES Interpretao Identifica o nmero do cliente. Necessrio para efetuar logon no sistema SAP R/3. Identifica o nome do usurio. Necessrio para efetuar logon no sistema SAP R/3. Identifica a senha. Necessrio para efetuar logon no sistema SAP R/3.

Captulo 4. Os Adaptadores R/3

21

Tabela 4. Sintaxe e Uso de Comandos do Adaptador (continuao) Comando/Valor do Adaptador -h M699 Interpretao Identifica o nome do host ou a cadeia de rota do SAP do servidor SAP R/3 ao qual se conectar. Identifica o nmero do sistema. Especifica a criao de um arquivo de log do adaptador contendo informaes sobre as transaes ocorridas para esse destino durante a execuo do mapa. (No exemplo, -ar3 significa Auditoria R/3.)

-s 00 -ar3

Consulte a Lista de Comandos do Adaptador para obter informaes sobre a sintaxe e o uso de cada comando do adaptador.

Funes RUN, GET e PUT


possvel usar os comandos do adaptador R/3 ao usar as funes RUN, GET e PUT ao definir regras de mapas no Map Designer. Consulte as informaes de Funes e Expresses no Centro de Informaes para obter informaes sobre as funes RUN, GET e PUT.

Exemplo de RUN
O exemplo a seguir mostra regras de mapas usando uma funo RUN() para ALE usando comandos do adaptador R/3 para substituir comandos de execuo.
RUN ("somemap.mmc" , "-OMALE1 `-c remo -u " + userid:profile + " -p " + password:profile + " -h SAPh03 -s 03'")

Neste exemplo, um mapa chamado somemap.mmc est sendo executado substituindo o carto de sada #1.

Exemplo de GET
Uma funo GET() usa o adaptador R/3 para recuperar dados. Os exemplos a seguir mostram as regras de mapas usando uma funo GET() para ALE e BAPI usando comandos do adaptador R/3 para especificar a chave de destino para o arquivo Saprfc.ini.
GET("ALE", "-D MY_R3 -AR3") GET("BAPI", "-D MY_R3 -c 800 -u IDES_USER -p initpass", CPACKAGE (BAPI, "NATIVE")) EITHER(GET("BAPI", "-D MY_R3-c 800 -u IDES_USER -p initpass", CPACKAGE (BAPI, "NATIVE")), IF (0 < LASTERRORNUM(), FAIL(LASTERRORMSG()))

Nota: O adaptador BAPI (na verso 6.7.x ou posterior) s pode ser usado na funo GET. Ele no pode ser usado em um carto de entrada de mapa, carto de sada de mapa ou funo PUT.

Exemplo de PUT
Uma funo PUT() envia dados para o adaptador R/3.

22

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

O exemplo a seguir mostra a funo PUT() sendo usada para enviar dados para o adaptador R/3 assim como ativando um rastreio do adaptador.
PUT("ALE", "-c 800 -u IDES_USER -p initpass -h 127.0.0.1 -s 00 -t", CPACKAGE (CREMAS IDoc Input, "NATIVE"))

A partir do Map Designer


A partir do Map Designer, possvel usar o adaptador R/3 para uma origem ou um destino. Por exemplo, no carto de sada, possvel selecionar R/3 ALE ou JALE como o valor para as configuraes de destino. Esse carto de sada de exemplo chamado Legacy_Data para um mapa chamado Sada de ALE DEBMAS.mms. A configurao Comando de Destino composta por vrios comandos do adaptador R/3, incluindo os comandos de adaptador necessrios -c, -u, -p, -h e -s, que especificam o cliente, o ID de usurio, a senha, informaes de conexo, o identificador do host e o identificador do sistema necessrios. O comando de adaptador -ar3 especifica a criao de um arquivo de log do adaptador contendo informaes sobre as transaes ocorridas para esse destino durante a execuo do mapa.

A partir do Integration Flow Manager


A partir do Integration Flow Manager, ao acessar as configuraes de execuo (Launcher ou Command Server) de um mapa, possvel selecionar um dos adaptadores SAP R/3 como uma origem ou um destino. Por exemplo, para substituir configuraes do adaptador de um carto de sada ou especificar o adaptador SAP R/3 para um destino, acesse as configuraes de execuo de um mapa. Selecione R/3 ALE ou JALE na lista suspensa Destino e especifique os comandos do adaptador no campo Comando de Destino. Esse exemplo das configuraes do Launcher para um componente do mapa chamado OrdersByDepartment mostra que, para Contabilidade #1 de Sada, o adaptador R/3 especificado como o destino. A configurao Comando de Destino composta por vrios comandos do adaptador R/3, incluindo os comandos de adaptador necessrios para a conexo: -c, -u, -p, -h, -s que identificam o cliente, o ID de usurio e a senha, respectivamente, e -d que especifica a chave de destino para saprfc.ini que designa as informaes de conexo adicionais). O comando de adaptador rastreio (-t) especifica para ativar o rastreio do adaptador, que cria um arquivo de rastreio que contm informaes detalhando a atividade do adaptador e -ar3, que especifica para criar o log de auditoria.

Comandos de Conexo
Ao usar um adaptador R/3, ele depende da interface SAP R/3 e da ao que voc deseja especificar. Muitos dos comandos do adaptador SAP R/3 so necessrios em determinadas situaes e com interfaces SAP R/3 especficas. Os seguintes tpicos fornecem as explicaes das situaes em que o uso de determinados comandos do adaptador SAP R/3 aplicvel: v Comandos de Conexo Necessrios para Origens JALE e ALE v Comandos de Conexo Necessrios para Destinos ALE, Destinos BDC e Chamada de uma BAPI v Comandos de Conexo Opcionais para Origens e Destinos JALE e ALE v Comandos de Conexo de Sesso de Entrada de Lote para Destinos BDC v Comandos de Conexo Opcionais para todas as Origens e Destinos
Captulo 4. Os Adaptadores R/3

23

Comandos de Conexo Necessrios para Origens JALE e ALE


Os comandos de adaptador a seguir so necessrios para uma origem ALE ao conectar-se a um sistema SAP R/3 e o arquivo Saprfc.ini no usado. Cada comando do adaptador usado para fornecer as informaes de conexo necessrias para o sistema SAP.
Para JALE: -U usr_id -p pwd -h host_name -s sys_num -c clnt_num -A pgm_id -G gtwy_name -X gtwy_conn Para ALE: -A pgm_id -G gtwy_name -X gtwy_conn

O comando de adaptador Destino necessrio ao usar o arquivo Saprfc.ini, que contm as informaes de conexo padro. O valor especificado com esse comando do adaptador faz distino entre maisculas e minsculas.
-D dest_key

Comandos de Conexo Necessrios para Destinos de ALE, Destinos de BDC e Chamada de uma BAPI
Os comandos de adaptador a seguir so necessrios ao chamar uma BAPI, e para destinos de ALE ou de BDC para conexo a um sistema SAP.
-C clnt_num -U usr_id -P pwd

Depois de especificar -C, -U e -P, use um dos trs agrupamentos de comandos de adaptador a seguir, necessrios para completar as informaes de conexo: v Use esses comandos do adaptador para especificar o ID do host do SAP e o nmero do sistema SAP:
-H host_name -S sys_num

v O comando de adaptador Destino (-D) necessrio ao usar o arquivo Saprfc.ini, que contm as informaes de conexo padro. O valor especificado com esse comando do adaptador faz distino entre maisculas e minsculas.
-D dest_key

v Esse grupo de comandos do adaptador necessrio ao usar o princpio de balanceamento de carga do SAP R/3:
-BAL -H host_name -G grp -S sys_name

v O comando de adaptador Idioma (-L) um comando de adaptador opcional que pode ser usado sempre que necessrio para os requisitos de conexo especficos. Dependendo do sistema SAP, esse comando de adaptador pode ser necessrio para a conexo.
-L lang_cd

Comandos de Conexo Opcionais para Origens e Destinos JALE e ALE


Depois de especificar os comandos de adaptador de conexo necessrios para origens e destinos de ALE, os comandos a seguir so comandos de adaptador opcionais que podem ser usados para interfaces ALE. v Opcional para origens e destinos de ALE:
-AR3[+][U] [%tid%|full_path] -B[I][X] [%tid%|full_path] -TID trans_ID

v Opcional apenas para origens de ALE:


-LSN [dur] -TY [OTHER$|doc_type*]

v Opcional apenas para destinos de ALE:


-GEN[0|!] [flds] -PKT [IDoc_qty]

24

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

v Opcional apenas para origens de JALE:


-LSN [dur] -TY [OTHER$|doc_type*] -N[cnt]-enc[ch_set_command]

v Opcional apenas para destinos de JALE:


-GEN[0|!] [flds] -PKT [IDoc_qty]

Comandos de Conexo de Sesso de Entrada de Lote para Destinos BDC


Depois de especificar os comandos de adaptador de conexo necessrios -C, -U e -P e um dos trs agrupamentos de comandos de adaptador necessrios 1) -H, -S, ou 2) -D, ou 3) -BAL, -H, -G, -S, use esses comandos de adaptador para destinos de BDC para passar valores especificados diretamente para uma Sesso de Entrada de Lote. Os valores devem ser especificados em maisculas. v Estes comandos do adaptador so necessrios para uma Sesso de Entrada de Lote:
-TRANS TRANS_CD -GROUP NAME -ASUSER USR_ID

v Estes comandos do adaptador so opcionais para uma Sesso de Entrada de Lote:


-ASCLNT CLNT_NUM -KEEP X -HOLDDATE YYYYMMDD

Comandos de Conexo Opcionais para todas as Origens e Destinos


O comando de adaptador Rastreio um comando de adaptador opcional que pode ser usado para todas as interfaces para gravar a atividade do adaptador de qualquer origem ou destino especificado.
-T[V|E][+] [full_path]

Nota: Opcionalmente, o adaptador R/3 passar quaisquer outros comandos de adaptador e parmetros de conexo suportados pelo SAP para o sistema SAP R/3, conforme definido no RFC DK.

Lista de Comandos do Adaptador


A tabela a seguir lista cada comando do adaptador R/3, a sintaxe do comando e as interfaces para as quais ele pode ser usado para uma origem (dados de sada), um destino (dados de entrada), ou ambos.
Tabela 5. Lista de comandos do adaptador Nome Sintaxe de Comando ALE origem origem/ destino destino destino origem/ destino destino destino origem/ destino BDC BAPI

ID do Programa -A pgm_id Auditoria Cliente ID do Usurio do SAP Backup Balanceamento de Carga -AR3[+][U] [%tid% |full_path ] -ASCLNT CLNT_NUM -ASUSER USR_ID -B[I][X] [%tid% |full_path ] -BAL

Captulo 4. Os Adaptadores R/3

25

Tabela 5. Lista de comandos do adaptador (continuao) Nome Nmero do Cliente Codificao do conjunto de caracteres Destino GatewayHost Gerao do Campo IDoc Grupo ID do Host Data de Suspenso Manter Sesso Idioma do Logon Escuta Encadeamentos do Ouvinte Senha Tamanho do Pacote Reprocessar Arquivos de Backup Release ID do Sistema Timeout Rastreamento Sintaxe de Comando -C clnt_num -enc ALE destino Origem JALE BDC destino BAPI origem/ destino

-D dest_key -G gtwy_name -GEN[0|!] [ flds ] -GROUP NAME -H host_name -HOLDDATE YYYYMMDD -KEEP X -L lang_cd -LSN {0| dur [: int ]} -N -P pwd -PKT IDoc_qty -R

origem/ destino origem destino

destino

origem/ destino

destino destino destino destino destino destino origem Origem JALE destino destino Origem JALE destino origem/ destino destino origem/ destino origem/ destino

-REL 3|4 -S sys_num -timeout secs -T[V|E|N][+] [ full_path ]

origem/ destino destino

origem/ destino destino

origem/ destino origem/ destino origem

origem/ destino origem/ destino

destino

origem/ destino

ID da Transao -TID trans_ID Cdigo de Transao Tipo de IDoc ID de Usurio Servio de Gateway -TRANS TRANS_CD -TY OTHER$|doc_type* -U usr_id V

destino origem destino origem destino origem/ destino

26

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

ID do Programa (-A)
Use o comando do adaptador ID do Programa (-A) para especificar o ID do programa a ser usado para a ativao de RFC ao usar o mtodo de Registro. O ID do programa um identificador exclusivo usado pelo SAP Gateway para identificar o listener (o programa). O SAP recomenda um formato de machine.program para o identificador do programa. Esse identificador deve corresponder ao ID do Programa de Registro definido no SM59. O SAP R/3 usa esse identificador para distinguir vrios programas registrados no mesmo SAP Gateway. Por exemplo, os IDs de programa xyz.CREMAS e xyz.MATMAS poderiam ser ambos registrados no mesmo SAP Gateway (-G 186.114.3.126) e nmero de gateway (-X 3300). -A pgm_id Opo Descrio pgm_id Identificador exclusivo do programa. Formato recomendado pelo SAP machine.program. No possui relacionamento com o sistema lgico, embora uma prtica comum seja nomear a chave semelhante ao sistema lgico.

Auditoria (-AR3)
Use o comando do adaptador Auditoria (-AR3) para criar um arquivo que registre a atividade do adaptador para cada carto de entrada e sada especificado. O padro produzir um arquivo chamado m4r3adapter.log no diretrio em que o mapa est localizado. Opcionalmente, voc pode anexar as informaes de auditoria a um arquivo existente, especificar o uso do transaction_id para o nome do arquivo, especificar seu prprio nome de arquivo, incorporar o transaction_id a seu prprio nome de arquivo ou especificar um caminho completo para o arquivo.
-AR3[+][U] [%tid%|full_path]

Opo Descrio + U Anexa informaes de auditoria a um arquivo existente. Para o Command Server: Especifique para produzir um arquivo chamado transaction_id.log, em que transaction_id o Transaction Identifier (TID) designado pelo SAP R/3 que sempre estar no diretrio do mapa, se u estiver no carto de entrada ou de sada do mapa. Para o Launcher: Especifique para produzir um arquivo chamado transaction_id.log em que transaction_id o Transaction Identifier (TID) designado pelo SAP R/3. Se u estiver no carto de entrada ou de sada, transaction_id.log estar no diretrio do mapa. Se um Transaction Identifier (TID) no puder ser designado, transaction_id ser m4r3serial_number. Quando essa opo for usada e o comando de adaptador Backup (-B) tambm for especificado, os nomes do arquivo de backup e do arquivo de auditoria sempre correspondero. %tid% Ao especificar o nome do arquivo de auditoria, possvel incorporar essa literal como parte do nome do arquivo e ela ser substituda pelo TID_number.

Captulo 4. Os Adaptadores R/3

27

full_path Especifique o nome do arquivo de auditoria, que pode incluir o caminho do diretrio.

Cliente (-ASCLNT)
Use o comando de adaptador Cliente (-ASCLNT) para substituir o nmero do cliente de logon para submeter a tarefa execuo em outro cliente. Esse comando de adaptador opcional usado para destinos de BDC apenas para passar o valor diretamente para uma Sesso de Entrada de Lote.
-ASCLNT CLNT_NUM

Opo Descrio CLNT_NUM Nmero do cliente. O valor deve ser especificado no formato numrico.

ID do Usurio do SAP (-ASUSER)


O comando de adaptador ID do Usurio do SAP (-ASUSER) necessrio para especificar o ID do Usurio do SAP sob o qual processar a submisso. Esse comando de adaptador usado para destinos de BDC apenas para passar o valor diretamente para uma Sesso de Entrada de Lote.
-ASUSER USR_ID

Opo Descrio USR_ID ID do usurio do SAP. O valor deve ser especificado em maisculas.

Backup (-B)
Use o comando de adaptador Backup (-B) para criar um arquivo de backup de IDocs processados. O padro produzir um arquivo chamado transaction_id.tid, em que transaction_id o Transaction Identifier (TID) designado pelo SAP R/3 no diretrio do mapa. Se um Transaction Identifier (TID) no puder ser designado, transaction_id ser m4r3serial_number. Opcionalmente, possvel especificar que o arquivo sirva de entrada para um mapa, excluir o arquivo na execuo bem-sucedida do mapa, especificar seu prprio nome de arquivo, incorporar o transaction_id em seu nome de arquivo ou especificar um caminho completo para o arquivo. Nota: Quando ocorre uma falha, criado um arquivo de backup transaction_id.tid com as informaes de conexo e o IDOC (quando ocorre o uso normal de -B, apenas o IDOC criado). Nota: Quando o comando de adaptador Auditoria e sua opo U (-AR3U) forem usados em conjunto com seu comando de adaptador, os nomes do arquivo de auditoria e do arquivo de backup sempre correspondero.
Source -B[I][X] [%tid%|full_path] Target -B[X] [%tid%|full_path]

Opo Descrio

28

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Cria um arquivo de backup no diretrio temporrio em vez de usar buffers de memria. Essa opo s aplicvel quando o adaptador ALE usado como Origem. Exclui o arquivo de backup do diretrio temporrio na concluso bem-sucedida da execuo do mapa. Ao especificar o nome do arquivo de backup, possvel incorporar essa literal como parte do nome do arquivo e ela ser substituda pelo TID_number.

X %tid%

full_path Especifique o nome do arquivo de backup, que pode incluir o caminho do diretrio. A seguir esto exemplos que usam o comando de adaptador Backup (-B): Comando Resultado -B %tid% dstx_directory\TID_number.tid, em que dstx_directory o diretrio de instalao do WebSphere Transformation Extender e TID_number representa o nmero do TID gerado. -B d:\bak\%tid% d:\bak\TID_number.tid, em que TID_number representa o nmero do TID gerado. -B Archive%tid% dstx_directory\ArchiveTID_number.tid, em que dstx_directory o diretrio de instalao do WebSphere Transformation Extender e TID_number representa o nmero do TID gerado.

Balanceamento de Carga (-BAL)


Especifique o comando de adaptador Balanceamento de Carga (-BAL) para efetuar logon usando o princpio de balanceamento de carga do SAP R/3. O princpio de balanceamento de carga permite o login em um servidor que rotear processos dinamicamente com base na disponibilidade dos servidores de aplicativos. O uso do balanceamento de carga resulta normalmente na melhora do desempenho e trata do potencial de falha no caso de conexo com um servidor de aplicativos especfico. possvel localizar informaes adicionais sobre balanceamento de carga no SAP RFC SDK. Nota: O uso do princpio de balanceamento de carga do SAP R/3 requer a existncia de um grupo de logon no sistema SAP. Consulte sua equipe do Basis para obter assistncia e informaes sobre esse grupo de logon.
-BAL -H HOST -S R3NAME -G GRP

Opo Descrio -H HOST Especifique o nome do host do servidor. -S R3NAME Especifique o nome R/3 do sistema. -G GRP Especifique o grupo de logon.
Captulo 4. Os Adaptadores R/3

29

Grupo , geralmente, o valor-padro de PUBLIC. Nota: Ao usar -BAL, os valores passados usando -H, -S e -G so sempre os valores para -BAL. Portanto, nunca use os comandos do adaptador de conexo para ID do Host, Nmero do Sistema ou Host Gateway, que tambm usam -H, -S e -G para seus valores. Alm disso, necessrio incluir uma entrada no arquivo Servios, localizada em c:\winnt\system32\drivers\etc\services, usando a seguinte sintaxe:
sapmsR3NAME 36SYSNR/tcp

Por exemplo:
sapmsTSI 3600/tcp

A seguir est um exemplo da cadeia de caracteres de comando do adaptador R/3 para balanceamento de carga:
-c 800 -u JSharp -p S836GJ -bal -h MSG40 -s TSI -g PUBLIC

Se for necessrio se conectar a um gateway, possvel especificar GWHOST=gwhost diretamente nos comandos do adaptador. O arquivo Saprfc.ini tambm suporta o uso de balanceamento de carga. A seguir est o exemplo distribudo pelo SAP como uma entrada de amostra no arquivo Saprfc.ini.
/*===================================================================*/ /* Tipo B: Sistema R/3 - recurso de balanceamento de carga */ /*===================================================================*/ DEST=BIN TYPE=B R3NAME=TSI MSHOST=MSG40 GROUP=PUBLIC RFC_TRACE=0 ABAP_DEBUG=0 USE_SAPGUI=0

A seguir est um exemplo da cadeia de caracteres de comando do adaptador R/3 para se acomodar usando o arquivo Saprfc.ini com o balanceamento de carga:
-d BIN -c 800 -u JSharp -p S836GJ

Nmero do Cliente (-C)


Especifique o nmero do cliente no sistema SAP R/3 ao qual se conectar usando o comando de adaptador Nmero do Cliente (-C). Esse comando do adaptador necessrio para a conexo SAP ao chamar um BAPI e para todos os destinos. Geralmente, esse nmero de cliente especificado na janela de login do SAP R/3 sempre que voc efetua login no sistema R/3. -C clnt_num Opo Descrio clnt_num Nmero do cliente do sistema R/3.

30

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Codificao do Conjunto de Caracteres (-enc)


Para receber mensagens IDoc de um sistema SAP R/3 Unicode, especifique a codificao do conjunto de caracteres para origens de dados SAP ALE usando essa opo de comando. Por padro, os dados IDoc recebidos de um sistema SAP Unicode sero codificados no formato big-endian UTF-16BE. Use essa opo de comando tambm para decodificar dados IDoc em outro formato.
-enc ch_set_command

Opo Descrio ch_set_command Os valores possveis para a opo de comando do conjunto de caracteres esto listados no Registro de Conjunto de Caracteres IANA (disponvel em iana.org). Nem todos os conjuntos de caracteres listados so suportados. Os conjuntos de caracteres vlidos so aqueles suportados pelo J2SE Java Runtime Environment (JRE). Este Pack usa o JRE verso 1.4.x. O valor deve ser especificado no formato numrico.

Destino (-D)
O comando de adaptador Destino (-D) necessrio para especificar a chave de destino ao usar o arquivo Saprfc.ini para conexo com um sistema SAP R/3. O suporte SAP do arquivo Saprfc.ini, que substitui a tecnologia SIDEINFO anterior, permite que parmetros especficos da RFC estejam contidos no arquivo .ini.
-D dest_key

Nota: A chave de destino no possui relacionamento com o sistema lgico, embora uma prtica comum seja nomear a chave semelhante ao sistema lgico. O arquivo Saprfc.ini de exemplo fornecido pelo SAP contm a documentao explicando o formato de arquivo. Por padro, as bibliotecas de RFC procuram o arquivo Saprfc.ini no diretrio especificado pela varivel de ambiente do sistema RFC_INI. Portanto, certifique-se de configurar a varivel de ambiente RFC_INI para especificar o caminho e o nome do arquivo em que o arquivo Saprfc.ini est localizado. Por exemplo, se o arquivo estiver localizado no diretrio c:\IBM (RFC_INI=c:\IBM\saprfc.ini), voc executar as etapas a seguir para configurar a varivel de ambiente do sistema. Para configurar a varivel de ambiente do sistema: 1. No menu Iniciar, selecione Configuraes Painel de Controle Sistema. 2. Selecione a guia Ambiente. 3. Selecione qualquer varivel na seo Varivel do Sistema. (Inclua sua nova varivel do sistema aqui, no na seo Varivel de Usurio.) 4. Inclua RFC_INI no campo Varivel, na parte inferior da janela e inclua o local do arquivo saprfc.ini no campo Valor. 5. Clique em Configurar Aplicar OK. Nota: As entradas do Saprfc.ini tm precedncia sobre qualquer coisa inserida em qualquer cadeia de caracteres de comando do adaptador. ASHOST o equivalente do comando do adaptador de conexo ID do Host (-H). SYSNR o equivalente do comando do adaptador de conexo Nmero

Captulo 4. Os Adaptadores R/3

31

do Sistema (-S). O valor do DEST= (comando de adaptador -D) faz distino entre maisculas e minsculas. 6. Reinicialize o sistema. Exemplo de entrada da cadeia de caracteres de comando do adaptador R/3 -D A seguir est um exemplo da cadeia de caracteres de comando do adaptador R/3 -D de entrada para usar o arquivo Saprfc.ini. -d IBM -c 800 -u userid -p pswd A seguir est um exemplo da entrada no arquivo Saprfc.ini:
/*===================================================================*/ /* Tipo A: Sistema R/3 - servidor de aplicativos especfico */ /*===================================================================*/ DEST=IBM TYPE=A ASHOST=sp2 SYSNR=00 RFC_TRACE=0 ABAP_DEBUG=0 USE_SAPGUI=0

Nota: As entradas fazem distino entre maisculas e minsculas. A cadeia deve corresponder entrada no arquivo Saprfc.ini. As entradas do Saprfc.ini tm precedncia sobre qualquer coisa inserida em qualquer cadeia de caracteres de comando do adaptador. ASHOST o equivalente do comando do adaptador de conexo ID do Host (-H). SYSNR o equivalente do comando do adaptador de conexo Nmero do Sistema (-S). Exemplo de sada da cadeia de caracteres de comando do adaptador R/3 -D A seguir est um exemplo da cadeia de caracteres de comando do adaptador R/3 -D de sada para usar o arquivo Saprfc.ini.
-d IBM -t

A seguir est um exemplo da entrada no arquivo Saprfc.ini:


/*===================================================================*/ /* Digite R: Registrar um programa do servidor RFC em um SAP Gateway /* ou conectar-se a um programa do servidor RFC j registrado */ /*===================================================================*/ DEST=IBM TYPE=R PROGID=4handler GWHOST=192.168.1.127 GWSERV=3300 RFC_TRACE=1 */

Nota: As entradas fazem distino entre maisculas e minsculas. A cadeia deve corresponder entrada no arquivo Saprfc.ini. As entradas do Saprfc.ini tm precedncia sobre qualquer coisa inserida em qualquer cadeia de caracteres de comando do adaptador. PROGID o equivalente do nome do programa registrado. GWJPST o equivalente de (-G) e GWSERV o equivalente de (-X) dos comandos do adaptador.

32

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Host Gateway (-G)


Especifique o nome do host ou a cadeia de rota SAP do host gateway usando o comando do adaptador Host Gateway (-G). Quando o arquivo Saprfc.ini no est sendo usado, esse comando de adaptador necessrio para fins de conexo para origens de ALE (sada do SAP R/3).
-G gtwy_name

Opo Descrio gtwy_name Nome do host gateway ou a cadeia de rota SAP do host gateway.

Gerao de Campo IDoc (-GEN)


Especifique a gerao automtica do campo usando o comando do adaptador Gerao do Campo IDoc (-GEN). Use esse comando de adaptador para controlar o modo de gerao dos campos IDoc. O adaptador gera automaticamente determinados campos de uma chamada de cliente ALE. Esses campos no sero mapeados porque o adaptador os substitui (exceto se indicado na tabela de opes). Separe os campos na lista com uma vrgula e omita a lista de campos para alterar o comportamento de todos eles.
-GEN [0|!] [field1[,field2...] Opo 0 ! [fld1[,fld2...] MANDT DOCNUM DIRECT RCVPOR RCVPRT RCVPRN SNDPOR SNDPRT SNDPRN CREDAT CRETIM SEGNUM Opo Descrio Especifique campos IDoc a serem gerados, se em branco. Especifique para suprimir a gerao de IDoc. Especifique os seguintes campos IDoc conforme desejar: conforme especificado por -C designado sequencialmente para cada IDoc, a partir de 1, justificado direita com 0s. `2 `SAP + id do sistema remoto `LS copiado de RCVPOR (possivelmente tambm gerado) se no mapeado pelo usurio `CUSTOMERLS se no mapeado pelo usurio `LS copiado de SNDPOR (possivelmente tambm gerado) se no mapeado pelo usurio data do sistema tempo do sistema designado sequencialmente para cada segmento em cada IDoc, a partir de 1, justificado direita com 0s. copiado do SEGNUM designado ao primeiro IDoc no HLEVEL precedente.

PSGNUM

Captulo 4. Os Adaptadores R/3

33

Opo

Opo HLEVEL

Descrio copiado do HLEVEL designado mais recentemente se no mapeado pelo usurio

Todos os campos, exceto RCVPOR e RCVPRN sero gravados no arquivo de backup se um arquivo de backup for usado. RCVPOR e RCVPRN so determinados aps o estabelecimento de uma conexo RFC. Os registros de controle so atualizados nesse momento. A gerao de PSGNUM requer que HLEVEL seja especificado. PSGNUM gerado aplicando-se a lgica de quebra de controle ao campo HLEVEL. O HLEVEL s precisa ser inserido para o primeiro segmento de cada nvel, os segmentos subsequentes nesse nvel podem ficar em branco (para fins de gerao de PSGNUM, assume-se que o mesmo). O SEGNUM do primeiro segmento em um HLEVEL usado como o PSGNUM para segmentos no prximo HLEVEL superior. O PSGNUM do HLEVEL 01 000000. A seguir esto exemplos do uso do comando do adaptador de gerao de campo IDoc. Exemplo Descrio -GEN Gerao automtica de todos os campos IDoc listados no tpico Gerao de Campo IDoc (-GEN). Esse o padro. O usurio no precisa especificar esse comando de adaptador. O adaptador ir gerar automaticamente todos os campos IDoc, independentemente do valor dos campos na entrada. -GEN0 fld1, fld2 O adaptador ir gerar campos IDoc para o field1 de entrada, se estiver em branco e o field2 de entrada, se estiver em branco. -GEN! fld1, fld5 O adaptador suprimir a gerao automtica desses campos IDoc listados ao lado de -GEN!

Grupo (-GROUP)
O comando de adaptador Grupo (-GROUP) necessrio para especificar um nome de grupo para associar Sesso de Entrada de Lote. Esse comando de adaptador usado para destinos de BDC apenas para passar o valor diretamente para uma Sesso de Entrada de Lote.
-GROUP NAME

Opo Descrio NAME Nome do grupo. O valor deve ser especificado em maisculas.

34

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

ID do Host (-H)
Especifique o nome do host ou a cadeia de rota do SAP do servidor SAP R/3 ao qual se conectar usando o comando de adaptador ID do Host (-H). Esse comando do adaptador pode ser necessrio para a conexo. Use o parmetro SAPLogon ou SAPGUI.
-H host_name

Opo Descrio host_name Nome do host do servidor R/3 ou cadeia de rota do SAP do servidor R/3. O roteador SAP serve como um proxy em uma conexo de rede segura entre sistemas SAP R/3 e sistemas RFC externos. uma extenso til para um sistema de firewall existente porque permite conexes por meio do firewall. Quando um roteador SAP est sendo usado, uma cadeia de rota vlida usada como o valor de nome do host. Exemplo:
-H /H/saprouter1/S/3300/H/saprouter2/S/3300/H/SAPappServer/S/SAPservice

Para obter informaes adicionais sobre o roteador SAP, consulte Biblioteca SAP On-line BC- Componentes do Basis BC-Roteador SAP.

Data de Suspenso (-HOLDDATE)


Use o comando de adaptador Data de Suspenso (-HOLDDATE) para evitar o processamento da Sesso BDC at depois que a data especificada tiver passado. Esse comando de adaptador opcional usado para destinos de BDC apenas para passar o valor diretamente para uma Sesso de Entrada de Lote.
-HOLDDATE YYYYMMDD

Opo Descrio YYYYMMDD O valor deve ser especificado no formato mostrado. YYYY ano de 4 dgitos MM DD ms de 2 dgitos; os valores vlidos so 01 - 12 dia de 2 dgitos; os valores vlidos so 01 - 31

Manter Sesso (-KEEP)


Use o comando de adaptador Manter Sesso (-KEEP) para manter esta sesso aps o processamento. A sesso salva aps o processamento at que o administrador a exclua manualmente. Esse comando de adaptador opcional usado para destinos de BDC apenas para passar o valor diretamente para uma Sesso de Entrada de Lote.
-KEEP X

Opo Descrio i O X um valor literal que deve ser especificado.

Captulo 4. Os Adaptadores R/3

35

Idioma de Logon (-L)


Especifique o cdigo do idioma de logon usando o comando de adaptador Idioma de Logon (-L).
-L lang_cd

Opo Descrio lang_cd Idioma de logon.

Escuta (-LSN)
O comando de adaptador Escuta (-LSN) pode ser usado para origens de ALE. Use esse comando do adaptador para especificar quanto tempo (em segundos) uma mensagem deve ser aguardada. Se durao for omitida, a escuta ser feita indefinidamente. Alm disso, durao pode ser especificada opcionalmente como count:interval. Apenas para o Launcher, quando o comando Escuta no for especificado, o adaptador ALE assumir que os valores da opo Escuta esto configurados como 15:5. Para implementar o mtodo de registro com um Command Server, a opo 0 necessria.
-LSN {0|dur[:int]} Tabela 6. comando do adaptador Escuta (-LSN) Opo dur Descrio Especifica por quanto tempo, em segundos, a escuta dos dados deve ser feita. Se o comando LSN for omitido, os valores sero considerados por padro como 15:5. Para escutar por um perodo indefinido, especifique 0 como a durao. Valor necessrio para o mtodo de registro com um Command Server. Para ajuste fino do listener, como o listener no responde aos pedidos de controle de servio durante a escuta, especifique um intervalo para a durao em segundos. Os dois pontos so usados para separar a durao do intervalo. Exemplo: -LSN 0 -LSN 30:10

Encadeamentos do Ouvinte (-N)


O comando de adaptador Encadeamentos do Ouvinte (-N) pode ser usado para origens de ALE apenas ao usar o Launcher. Use esse comando de adaptador para especificar que o ouvinte seja registrado vrias vezes no gateway e para escutar IDocs recebidos. Para processar IDocs grandes enviados do adaptador JALE do SAP, use esse comando. Esse comando do adaptador poder aumentar o desempenho no gateway alocando-se mais processos de trabalho (encadeamentos do trabalhador) para atender pedidos. A contagem recomendada para encadeamentos do ouvinte um nmero igual ao total de processos de trabalho do SAP Application Server.
-Ncnt

36

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Opo Descrio cnt Contagens de encadeamentos do ouvinte.

Senha (-P)
Especifique a senha designada ao nome de usurio para autorizao do sistema SAP R/3 usando o comando de adaptador Senha (-P). Esse comando do adaptador necessrio para a conexo SAP de origens BAPI e todos os destinos.
-P pwd|@full_path

Opo Descrio pwd Senha associada ao nome de usurio.

@full_path Acessa um arquivo de segurana, usado para armazenar senhas, com o nome especificado no diretrio especificado. (Por padro, o diretrio onde o mapa est localizado.) Nota: Se a expirao de senha for usada no sistema SAP R/3, os mapas do WebSphere Transformation Extender precisaro ser atualizados ou substitudos conforme apropriado para acomodar a senha vlida.

Tamanho do Pacote (-PKT)


Use o Tamanho do Pacote (-PKT) apenas para sada (entrada no SAP R/3). Especifique o nmero de IDocs a ser includo em um pacote. feita uma chamada separada para cada pacote. Essa opo til para ajustar o desempenho da interface ALE e ajuda a reduzir erros de comunicao. Isso tambm elimina a necessidade de pr-adaptadores que usam a funo RUN() dividirem uma transmisso do IDoc em partes menores.
-PKT IDoc_qty

Opo Descrio IDoc_qty Nmero de IDocs a serem includos em um pacote. Nota: Atualmente, o comando de adaptador -PKT suporta at trs caracteres de IDoc_qty. (0 - 999)

Release (-REL)
O adaptador R/3 determina dinamicamente a verso do release do sistema SAP qual ele est se conectando. O comando de adaptador Release (-REL) opcional usado para substituir manualmente as configuraes do release do sistema SAP ao qual a origem ou o destino de ALE, BAPI ou BDC se conecta. -REL 3|4 Opo Descrio 3 4 Especifica releases 3.x do SAP R/3 Especifica releases 4.x do SAP R/3

Captulo 4. Os Adaptadores R/3

37

Reprocessar Arquivos de Backup


Use Reprocessar arquivos de backup (R) para processar arquivos de backup deixados da sesso anterior do Launcher. Essa opo de comando vlida para origens de dados e pode ser usada apenas em combinao com a opo de comando (BIX). Quando essa opo de comando for especificada, na inicializao do Launcher, o ouvinte JALE procurar todos os arquivos de backup criados na sesso anterior do Launcher que no foram processados. Para cada arquivo de backup, o ouvinte ALE aciona uma execuo de mapa para processar os dados IDoc do arquivo de backup.
-R

ID do Sistema (-S)
Especifique o nmero do sistema do SAP R/3 ao qual se conectar usando o comando de adaptador ID do Sistema (-S). Esse comando do adaptador pode ser necessrio para a conexo. Use o valor conforme indicado para o nmero do sistema em SAPLogon ou SAPGUI (por exemplo, 00).
-S sys_num

Opo Descrio sys_num Nmero do sistema SAP R/3 especificado em SAPLogon ou SAPGUI.

Tempo Limite (-timeout)


Especifique o tempo em dcimos de segundo para que o adaptador aguarde uma resposta do servidor SAP. Se no houver nenhuma resposta do servidor SAP no tempo especificado, ser retornado um erro de tempo limite. Se no houver nenhum valor definido, o valor-padro ser de 30 segundos (-timeout 30).
-timeout secs

Opo Descrio secs Nmero em dcimos de segundo que o adaptador aguardar uma resposta do servidor SAP.

Rastreio (-T)
Use o comando de adaptador Rastreio (-T) para ativar o arquivo de rastreio do adaptador R/3. Por padro, m4r3adapter.mtr est localizado no mesmo diretrio que o mapa, em que adapter o tipo de adaptador, como ALE e BAPI. Opcionalmente, voc pode especificar para registrar informaes de detalhes sobre toda a atividade do adaptador ou apenas erros. Alm disso, voc pode anexar as informaes de rastreio a um arquivo existente ou especificar um nome ou o caminho completo para o arquivo.
-T[V|E|N][+] [full_path]

O sufixo N desativa a criao dos arquivos de rastreio RFC. Se N no estiver configurado (como -T), ambos os arquivos de rastreio, do adaptador e de RFC sero criados.

38

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Se estiver configurado (como -TN), apenas o arquivo de rastreio do adaptador ser criado, enquanto o arquivo de rastreio RFC no. Opo Descrio V E Designa como detalhado. Informaes de rastreio detalhadas so registradas. Produz um arquivo de rastreio que contm apenas os erros que ocorreram durante a execuo do mapa. Se no houver erros, o arquivo de rastreio no ser criado. Quando o comando -TE usado com o SAP e o mapa falha, o arquivo de rastreio resultante possui uma extenso .mtr, a menos que um nome de arquivo especfico seja designado. Desativa a criao dos arquivos de rastreio RFC. Anexa informaes de rastreio a um arquivo existente.

N +

full_path Cria um arquivo de rastreio com o nome e diretrio especificados. (Por padro, o diretrio onde o mapa est localizado e o nome do arquivo m4r3adapter.mtr.)

Transaction ID (-TID)
Use o comando do adaptador Transaction ID (-TID) para origens ou destinos de ALE. Ao usar para um destino, especifique o Transaction ID (TID) com o qual uma transmisso falha anteriormente est sendo ressubmetida. Ao ressubmeter uma transao, esse comando de adaptador necessrio para que o SAP R/3 possa se recuperar corretamente da tentativa falha anterior e evitar processamento duplicado de IDoc no sistema R/3. -TID trans_ID Opo Descrio trans_ID Transaction ID da transmisso falha anteriormente sendo ressubmetida. Transaction ID um Identificador Exclusivo Globalmente (GUID) calculado pelo sistema SAP R/3. um valor exclusivo que no contm valores a serem mascarados. A seguir est um exemplo de um transaction ID:
COA8012A004A38AC3BC60585

Use esse comando de adaptador para que uma origem ative os Nomes de Origem Correspondentes para os Nomes de Destino usando o nmero do TID do SAP R/3 como o valor curinga de origem. Isso til ao usar o Launcher para execuo do mapa. Se uma origem tiver um curinga, qualquer destino que contiver um asterisco ser designado com o valor curinga de origem. Por exemplo, voc poderia usar -TID * na origem, e um destino de arquivo de \myData\IDoc.* para indicar os arquivos de destino. Nota: Para obter informaes adicionais, consulte as informaes do Launcher no Centro de Informaes.

Captulo 4. Os Adaptadores R/3

39

Cdigo de Transao (-TRANS)


O comando de adaptador Cdigo de Transao (-TRANS) necessrio para especificar o Cdigo de Transao do SAP R/3 a ser processado. Esse comando de adaptador usado para destinos de BDC apenas para passar o valor diretamente para uma Sesso de Entrada de Lote. -TRANS TRANS_CD Opo Descrio TRANS_CD Cdigo de transao do SAP R/3. O valor deve ser especificado em maisculas.

Tipo de IDoc (-TY)


O comando de adaptador Tipo de IDoc (-TY) pode ser usado para origens de ALE e para designar os tipos de documentos que podem ser recebidos. Nota: Ao usar esse comando de adaptador para designar tipos de documentos, existe a chance de haver configurao incorreta se o SAP R/3 enviar um tipo de IDoc para o qual no haja nenhum mapa. Se no existir nenhum manipulador para o IDoc, o adaptador R/3 levantar uma exceo RFC fazendo com que a transao incorreta fique retida na fila tRFC (SM58). Ao usar o Integration Flow Designer, um componente de mapa de um sistema WebSphere Transformation Extender executado usando o Launcher poder usar o tipo de documento especial OTHER$ para capturar os IDocs que no corresponderem aos tipos designados por outro componente de mapa contido no mesmo arquivo de definio do sistema (.msl). Neste cenrio, se forem recebidos IDocs com outro tipo que no o especificado em um componente de mapa, em vez de causar uma exceo RFC, um segundo componente de mapa com -TY OTHER$ definido ser acionado automaticamente e tratar dos IDocs no correspondidos conforme especificado.
-TY OTHER$|doc_type*

Opo Descrio OTHER$ Ao usar o Launcher, use essa opo em um componente de mapa para tratar de todos os tipos no correspondidos por qualquer outro acionador. Quando IDocs no correspondentes so detectados, eles se tornam acionadores para o tipo OTHER$ em vez de causar uma exceo RFC. doc_type* Voc especifica o tipo de documento que pode ser recebido. Se o SAP R/3 enviar um IDoc que no corresponde ao que est especificado, o adaptador levantar uma exceo RFC. Os tipos de documentos fazem distino entre maisculas e minsculas. Exemplo
-TY DEBMAS*

ID do Usurio (-U)
Especifique o nome de usurio do SAP R/3 para efetuar login no sistema SAP R/3 usando o comando de adaptador ID do Usurio (-U). Esse comando de adaptador

40

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

necessrio para conexo do sistema SAP R/3 ao chamar uma BAPI e para os destinos de ALE e BDC. Geralmente, esse um usurio CPIC, mas deve ser ativado para permisses ALE/EDI. Consulte sua equipe do Basis ou a documentao de Autorizaes de Usurio do SAP para obter informaes adicionais.
-U usr_id|@full_path

Opo Descrio usr_id Nome do usurio do SAP R/3. @full_path Acessa um arquivo de segurana, usado para armazenar IDs de usurio, com o nome especificado no diretrio especificado. (Por padro, o diretrio onde o mapa est localizado.)

Servio de Gateway (-X)


Especifique o nome do servio ou o nmero da porta do processo de gateway no host gateway usando o comando do adaptador Servio de Gateway (-X). Quando o arquivo Saprfc.ini no est sendo usado, esse um comando de adaptador necessrio para a conexo do SAP de origens ALE (sada de R/3).
-X gateway_conn

Opo Descrio gtwy_conn Nome do servio de processo ou nmero da porta do gateway.

Resumos de Sintaxe para Adaptadores R/3


Os resumos de sintaxe fornecem uma lista detalhada de comandos do adaptador necessrios e opcionais usados com os adaptadores R/3. Os resumos de sintaxe usam a notao de sintaxe de comando. Os resumos de sintaxe dos adaptadores R/3 so organizados pela ALE, BDC e BAPI.

Resumo de Sintaxe de Comandos do Adaptador JALE


A sintaxe dos comandos do adaptador JALE usados com as origens de dados :
-A pgm_id -G gtwy_name -X gtwy_conn -C clnt_num -U usr_id -P pwd {-H host_name -S sys_num| dest_key [-AR3[+][U] [%tid%|full_path] -B[I][X] [%tid%|full_path] [-TID trans_ID]] [-LSN {0|dur[:int]} [-TY OTHER$|doc_type*]] [-REL 3|4] [-T[V|E][+] [full_path]] [-N num_of_threads][-enc encoding[-r]]

A sintaxe dos comandos do adaptador JALE usados com os destinos de dados :


-C clnt_num -U usr_id -P pwd {-H host_name -S sys_num| -D dest_key| -BAL -H HOST -S R3NAME} -G GRP [-AR3[+][U] [%tid%|full_path] -B[I][X] [%tid%|full_path] trans_ID]

Captulo 4. Os Adaptadores R/3

41

[-GEN[0|!] [fld1[,fld2...]] [-PKT IDoc_qty]] [-L lang_cd] [-REL 3|4] [-T[V|E][+] [full_path]]

Resumos de Sintaxe de Comandos do Adaptador ALE


A sintaxe dos comandos do adaptador ALE usados com as origens de dados :
-A pgm_id -G gtwy_name -X gtwy_conn -D dest_key [-AR3[+][U] [%tid%|full_path] -B[I][X] [%tid%|full_path][-TID trans_ID]] [-LSN {0|dur[:int]} [-TY OTHER$|doc_type*]] [-REL 3|4] [-T[V|E][+] [full_path]]

A sintaxe dos comandos do adaptador ALE usados com os destinos de dados :


-C clnt_num -U usr_id -P pwd {-H host_name -S sys_num| -D dest_key| -BAL -H HOST -S R3NAME} -G GRP [-AR3[+][U] [%tid%|full_path] -B[I][X] [%tid%|full_path] trans_ID] [-GEN[0|!] [fld1[,fld2...]] [-PKT IDoc_qty]] [-L lang_cd] [-REL 3|4] [-T[V|E][+] [full_path]]

Resumos de Sintaxe de Comandos do Adaptador BDC


BDC usados com as origens de dados :
-T[V|E][+] [full_path]

A sintaxe dos comandos do adaptador BDC usados com os destinos de dados :


-C clnt_num -U usr_id -P pwd {-H host_name -S sys_num| -D dest_key| -BAL -H HOST -S R3NAME -G GRP} -TRANS TRANS_CD -GROUP NAME -ASUSER USR_ID [-ASCLNT CLNT_NUM -KEEP X -HOLDDATE YYYYMMDD] [-L lang_cd] [-T[V|E][+] [full_path]]

Resumos de Sintaxe de Comandos do Adaptador BAPI


A sintaxe dos comandos do adaptador BAPI usados com as origens de dados e destinos :
-C clnt_num -U usr_id -P pwd {-H host_name -S sys_num| -D dest_key| -BAL -H HOST -S R3NAME -G GRP} [-CDATA] [-L lang_cd] [-T[V|E][+] [full_path]]

Aliases do Adaptador R/3


possvel especificar os comandos do adaptador usando uma cadeia de caracteres de comando de execuo na linha de comandos ou criar um arquivo de comando que contenha comandos do adaptador que determinem as configuraes de execuo desejadas. Use os comandos de execuo -IM e -OM com o alias de adaptador apropriado que seja especfico para o adaptador do utilitrio, como a seguir:
Adaptador ALE R/3 JALE Alias ALE JALE Como entrada -IMALEcard_num -IMJALEcard_num Como sada -OMALEcard_num -OMJALEcard_num

42

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Adaptador BAPI R/3 JBAPI BDC R/3

Alias BAPI JBAPI BDC

Como entrada N/A N/A N/A

Como sada N/A N/A -OMBDCcard_num

Ao usar um alias do adaptador em conjunto com o comando de execuo, os comandos do adaptador podem ser emitidos na linha de comandos ou em um arquivo de comando. possvel usar os comandos do adaptador para especificar funes do adaptador, como a especificao de um determinado identificador de mensagem, permitindo que os dados de sada sejam divididos em vrias mensagens, ou recuperar uma mensagem lgica de uma fila de origem com um identificador de correlao. Por exemplo, para substituir os comandos do adaptador definidos no carto de sada 1, a cadeia de caracteres de comando do adaptador R/3 poderia ser:
dstx testclnt -AE -WD -R0 -B -OMALE1 '-c 800 -u userid -p password -h sp2 -s 00 -t -ar3'

Por exemplo, uma origem de dados existente que for um arquivo poder ser substituda e especificada para ser o adaptador R/3 usando o comando de execuo Substituio da Origem de Entrada (-IM) e o alias ALE. Alternativamente, possvel substituir um destino existente por um destino diferente usando o comando de execuo Substituio da Origem de Sada (-OM) pelo alias correto do adaptador R/3. Para obter informaes sobre todas as opes que podem ser usadas nesses comandos, consulte Comandos de Execuo no Centro de Informaes.

Usando Comandos do Sistema R/3


O adaptador R/3 passa quaisquer outros comandos e parmetros de conexo suportados pelo SAP para o sistema SAP R/3, conforme definido no RFC DK. Eles so definidos em RfcOpenEx. Consulte a Documentao do SAP para obter detalhes. Um exemplo de uso de um comando de sistema SAP R/3 como um comando de adaptador R/3 opcional especificar SAPLOGON_ID=SAP_logon_key para ler parmetros de conexo de Saplogon.ini, se SAPLogon estiver instalado. Depois de especificar os comandos do adaptador R/3 de conexo necessrios (por exemplo, -C, -U, -P), possvel usar SAPLOGON_ID= para especificar o SAP_logon_key, que o nome definido em SAPLogon (aquele que aparece no menu). Certifique-se de colocar o argumento inteiro entre aspas simples ou duplas para que o adaptador o interprete corretamente para sua plataforma (especialmente se o nome contiver espaos). Usando esse recurso, os comandos necessrios para abrir uma conexo com um sistema SAP, como DEST, GWHOST, GWSERV, ASHOST, SYSNR, MSHOST, R3NAME, GROUP e SNC, no so necessrios porque a biblioteca RFC obtm essas informaes dos arquivos de dados SAPLOGON. Esse recurso fornece um benefcio de manuteno potencial para usurios do SAPLogon e recomendado porque as informaes de conexo existem apenas em um local (saplogon.ini), no em dois (saplogon.ini e Saprfc.ini).

Captulo 4. Os Adaptadores R/3

43

44

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Captulo 5. Intermediate Documents (IDocs)


IDocs so contineres ou formatos de dados padro do SAP que fornecem a base para as interfaces ALE e EDI para o SAP R/3. Os tpicos a seguir discutem o uso de IDocs com o SAP R/3 e fornecem as informaes especficas necessrias para as interfaces ALE e EDI: v Viso Geral de IDocs v Gerando o Relatrio do Analisador de IDoc v v v v v v Usando o Importer Wizard para IDocs Implementando uma Interface ALE Mapeando Processos de Entrada e Sada Registros de Controle para Mapeamento de IDoc Enviando IDocs da EDI Usando ALE

Viso Geral de IDocs


Vrias centenas de IDocs so fornecidos com cada sistema SAP R/3 verso 3.0 e superior. As interfaces ALE e EDI usam IDocs funcionalmente equivalentes, no entanto, so diferentes na maneira em que os IDocs so comunicados de ou para o SAP R/3. v Os IDocs da ALE so comunicados por meio de buffers de memria, sem arquivos intermedirios, diretamente de ou para uma porta RFC usando remote function calls (RFCs) transacionais. v Os IDocs da EDI so passados usando-se um arquivo intermedirio. Essas interfaces (ALE e EDI) que usam a estrutura IDoc representam a abordagem estratgica do SAP para servir como interface do SAP R/3 para aplicativos legados e de terceiros, em que o acoplamento baixo apropriado. Portanto, a abordagem de IDoc do SAP R/3 deve ser considerada a primeira opo para o desenvolvimento de interfaces em que links assncronos, prximos do tempo real, ou de lote so necessrios. Este Pack suporta IDocs fornecidos pelo SAP assim como IDocs definidos pelo usurio. Um ou mais IDocs so mantidos em um continer chamado pacote. Um pacote o maior continer de dados de uma rvore do tipo IDoc. O atributo restart includo automaticamente para rejeitar IDocs invlidos contidos em um pacote. Nota: Ao usar o Importer Wizard para criar uma rvore do tipo na estrutura de seus IDocs, voc tem a opo de selecionar se deseja incluir restries. Voc seleciona com um sinalizador que permite que seu mapa saiba no tempo de execuo que deve criar listas de restries.

Formato Estrutural do IDoc


O formato do IDoc consiste em segmentos estruturados hierarquicamente com vrios nveis de aninhamento. Os IDocs existem para dados principais, como clientes e materiais; para dados transacionais, como pedidos de vendas; e para dados de controle, como cdigos de empresa. Em termos de ALE, so chamados de tipos de IDoc, que so descritos usando o seguinte:
Copyright IBM Corp. 2006, 2009

45

v Um Registro de Controle - O formato do registro de controle idntico para todos os tipos de IDoc. v Um ou mais Registros de Dados - Um registro de dados consiste em uma parte de administrao fixa e em uma parte de dados (segmento). O nmero e o formato dos segmentos podem ser diferentes para cada tipo de IDoc. v Registros de Status - Os registros de status descrevem os estgios de processamento por meio dos quais um IDoc pode passar.

Um Registro de Controle

Registro de Controle

ID do IDoc ID do emissor ID do receptor Tipo de IDoc Estrutura EDI

Vrios Registros de Dados

Registro de Dados

ID do IDoc Sequncia / Hierarquia Segmento

Definio de formato para dados do cabealho dados do item

Vrios Registros de Status

Registro de Status

Informaes de Status de ID do IDoc

Os tipos de IDoc so designados a tipos de mensagens independentes do release, que so por si s, designados a tipos de objetos no Business Object Repository (BOR). Os aprimoramentos do cliente esto, geralmente, sujeitos a convenes de nomenclatura. Os segmentos de dados do IDoc possuem, no mximo, 1.000 bytes, contendo, em geral, apenas campos CHAR. Os segmentos de dados de um tipo IDoc so descritos por tipos de segmentos independentes do release e possuem definies de segmentos especficas do release que so armazenadas como estruturas internas no Dicionrio. Isso significa que os IDocs podem ser enviados com um contedo de dados diferente para destinatrios diferentes porque o release do destinatrio definido no sistema de envio.

Gerando o Relatrio do Analisador de IDoc


O SAP:IDoc Importer um recurso para gerar automaticamente rvores do tipo que descrevam o formato de IDocs usados no sistema SAP R/3. O Importer Wizard usa a definio de um IDoc contido em um relatrio do analisador de IDoc (RSEIDOC3) para gerar automaticamente rvores do tipo a partir de IDocs para uso no mapeamento de dados externos para dados do SAP R/3. Consulte Executando o Importer Wizard para obter informaes adicionais. Depois de ter identificado o tipo IDoc que ser usado, use a transao WE63 ou o programa RSEIDOC3 para gerar o relatrio do analisador de IDoc. Os relatrios RSEIDOC3 podem ser produzidos a partir de um sistema SAP R/3 para IDocs fornecidos pelo SAP, IDocs modificados fornecidos pelo SAP ou IDocs customizados. O Importer Wizard trabalha com qualquer um desses IDocs. Ele tambm trabalha com IDocs produzidos de qualquer verso de um sistema SAP R/3. A definio de IDoc informada para o Importer Wizard deve estar no formato produzido pela execuo do relatrio RSEIDOC3 a partir do sistema R/3. Ao

46

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

executar o programa RSEIDOC3, talvez voc queira salvar o relatrio em um arquivo com a extenso .ido porque esse o padro para IDocs ao usar o Importer Wizard. Nota: O arquivo de definio produzido pelo relatrio RSEIDOC3 pode conter definies para um ou mais IDocs. Se o arquivo de definio contiver mais de um IDoc, todas as definies de IDoc vlidas sero criadas em uma nica rvore do tipo. Nota: Tambm necessrio ativar as caixas de opo Registro de controle (no RSEIDOC3) e Registro de dados. Depois de ter produzido o(s) relatrio(s) RSEIDOC3 apropriado(s) do SAP R/3, faa download dele(s) em seu PC no qual o Importer Wizard est instalado usando a opo Fazer Download de Arquivo. Certifique-se de selecionar No convertido. Nota: Os IDocs fornecidos pelo SAP podem ser alterados de uma verso do SAP R/3 para outra. Ao atualizar de uma verso para outra ou quando tiver reduzido ou modificado um IDoc fornecido pelo SAP, use o Importer Wizard para gerar novamente as rvores de tipo.

Usando o Importer Wizard para IDocs


Por Que e Quando Desempenhar Esta Tarefa
Depois de ter produzido um relatrio RSEIDOC3 do SAP R/3 descrevendo o formato do IDoc ou dos IDocs e de ter movido esse arquivo para o PC local, voc est pronto para executar o Importer Wizard. Consulte Executando o Importer Wizard. Um arquivo de relatrio IDoc produzido no SAP R/3 usado para testar como o Importer Wizard criar uma rvore do tipo para uma estrutura do IDoc. Para executar o SAP:IDoc Importer: 1. No Type Designer, selecione Importar no menu rvore. 2. Depois que o Importer Wizard for iniciado, selecione SAP:IDOC como a estrutura para a qual voc deseja gerar uma rvore do tipo. Clique em Avanar. 3. Clique em Avanar at que o campo Nome do Arquivo aparea na janela. No campo Nome do Arquivo, insira o arquivo que deseja importar, especifique o relatrio RSEIDOC3 para o qual deseja gerar uma rvore do tipo e selecione ALE ou EDI para especificar a interface para a qual deseja gerar a rvore do tipo.

Entendendo a rvore do Tipo IDoc


O relatrio RSEIDOC3 composto por um continer de pacote que pode conter um ou mais IDocs, portanto, a rvore do tipo gerada representa o contedo. Cada IDoc contm um registro de controle, vrios registros de dados e alguns registros de status. Cada IDoc consiste na sequncia e na estrutura de segmentos de um determinado tipo de IDoc e sua sequncia e estrutura so determinados por elas. A estrutura do IDoc ALE ou EDI e as rvores do tipo so geradas para cada formato apropriadamente. v O formato ALE foi projetado especificamente para ser usado com a arquitetura Application Linking and Enabling do SAP. Cada rvore do tipo gerada
Captulo 5. Intermediate Documents (IDocs)

47

compatvel com as comunicaes ALE/RFC. Ela requer que cada segmento de dados de um IDoc tenha o mesmo comprimento sem terminadores e que o segmento de controle tenha um comprimento fixo. Cada segmento preenchido at um comprimento fixo. v O formato EDI modelado livremente depois dos padres Electronic Data Interchange. Cada rvore do tipo gerada compatvel com as comunicaes baseadas em EDI/FILE. Cada segmento tem um comprimento varivel e terminado com um caractere de linha. Os atributos de uma rvore do tipo correlacionam-se diretamente com o relatrio de metadados IDoc. Os campos do IDoc correspondem a itens em um tipo. Por exemplo, o nome do campo gera o nome do item e o texto gera a descrio do item. Os dados IDoc so baseados em caracteres e apenas a descrio do texto ou do item depende do idioma. As rvores de tipo geradas para a ALE ou a EDI contm tipos definidos de forma idntica denominados Pacote, IDoc, Group_number, Campo e Registro de Controle. No entanto, h diferenas em como os segmentos so definidos para os dois formatos diferentes. Uma rvore do tipo gerada para a ALE no contm um tipo de Registro de Status.

Implementando uma Interface ALE


Por Que e Quando Desempenhar Esta Tarefa
A tecnologia SAP Application Link Enabling (ALE) permite a comunicao de dados entre dois ou mais sistemas SAP R/3 e/ou sistemas SAP R/3 e externos (por exemplo, legados). O sistema SAP R/3 deve ser configurado para enviar e receber IDocs. Para implementar uma Interface ALE: 1. Insira o cdigo de transao /nWE63 no aplicativo SAP para selecionar IDoc(s) e fazer download dos metadados. 2. Use o Importer Wizard para gerar a rvore do tipo. 3. Use o Map Designer para criar o mapa. 4. Configure o sistema SAP R/3 para processamento de entrada ou de sada. Consulte Configurando o Sistema SAP R/3 e Configurando um Destino RFC.

Seleo e Download de Metadados IDoc (WE63)


Por Que e Quando Desempenhar Esta Tarefa
O tipo de IDoc indica o formato SAP que deve ser usado para interpretar os dados de uma transao de negcios. Para selecionar um IDoc Bsico: 1. Insira /nwe63 no campo de comando e clique em Enter. A janela Documentao aberta. 2. Ative Tipo bsico e selecione o tipo de IDoc na lista suspensa. (Neste exemplo, escolha DEBMAS03.) 3. Clique em Analisador para executar. A janela Documentao do Tipo Bsico aberta. 4. No menu Sistema, escolha Lista Salvar Arquivo Local.

48

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

A caixa de dilogo Salvar Lista no Arquivo aberta. 5. Selecione no convertido como o formato e clique em Enter. A caixa de dilogo Salvar como aberta. 6. Especifique o caminho completo no qual salvar o arquivo e, em seguida, clique em Salvar para transmitir a lista e salvar o arquivo.

Criando o Arquivo de Metadados Unicode


Por Que e Quando Desempenhar Esta Tarefa
O importador de IDoc pode gerar metadados Unicode (rvores do tipo com Nomes do Tipo Unicode). O SAP no suporta atualmente caracteres Unicode em nomes de metadados, mas suporta caracteres Unicode para descries de metadados. Para gerar rvores do tipo que possam conter Nomes do Tipo Unicode, gere o arquivo de metadados IDoc e salve-o como um arquivo Unicode: Nota: O SAP no suporta atualmente caracteres Unicode em nomes de metadados, mas suporta caracteres Unicode para descries de metadados. Para gerar rvores do tipo que possam conter Nomes do Tipo Unicode, gere o arquivo de metadados IDoc e salve-o como um arquivo Unicode: 1. Efetue logon no sistema SAP R3 usando o logon do SAP Front end/SAP. 2. V para a transao /nwe63 e digite o nome do Tipo Bsico (ou aprimoramento/extenso), selecione Registro de Controle, Registro de Dados e Registro de Status. Configure o Release do segmento. Em seguida, clique em Analisador (F9) 3. Selecione Sistema > Lista > Salvar > Arquivo Local 4. Selecione No convertido. 5. Selecione Codificao como UTF8 (4110) e clique em Gerar.

Mapeamento
Por Que e Quando Desempenhar Esta Tarefa
Depois de ter configurado o destino de RFC e criado e transferido o arquivo de metadados, use o Map Designer para criar o mapa.

Usando o Importer Wizard para ALE


Por Que e Quando Desempenhar Esta Tarefa
No Type Designer, selecione Importar no menu rvore para iniciar o Importer Wizard. O Importer Wizard fornece orientao durante o processo de gerao de rvores do tipo. Insira as informaes apropriadas, que incluem: v Especificando o Formato ALE v Gerando a rvore do Tipo a partir do Arquivo de Metadados Transferido

Criando um Mapa de Sada


Por Que e Quando Desempenhar Esta Tarefa
Usando o Map Designer, crie um mapa para transformar os dados de origem do SAP R/3 no sistema externo de destino.

Captulo 5. Intermediate Documents (IDocs)

49

Criando um Carto de Entrada e Configurando o Processamento de Sada


Por Que e Quando Desempenhar Esta Tarefa
Crie um carto de entrada que especifique R/3 ALE ou JALE para a configurao Origem. Quando o adaptador R/3 especificado como a origem do carto de entrada, ele executa os RFCs necessrios para garantir a comunicao bem-sucedida dos dados de sada do IDoc do servidor do sistema R/3. Os dados so recuperados e passados por meio de buffers de memria para o mapa de execuo para transformao no formato de destino desejado. Nota: A configurao do sistema R/3 j dever ter sido concluda. Para obter um IDoc (DEBMAS) do sistema SAP e pass-lo para o mapa: 1. Insira /nbd12 no campo de comando e clique em Enter. A janela Enviar Clientes aberta. 2. Insira informaes do Cliente no campo apropriado e, em seguida, clique em Executar. 3. Uma janela Informaes aberta indicando que os dados principais enviados foram lidos do banco de dados e formatados em um formato IDoc. Esse IDoc chama-se um IDoc principal. O IDoc principal armazenado em um buffer de memria at que o IDoc de comunicao seja gerado. Clique em Enter. 4. Uma mensagem de Informao aberta indicando que a camada de servio ALE gerou um IDoc separado do IDoc principal para cada destinatrio que est interessado nos dados. Esses IDocs especficos do destinatrio chamam-se IDocs de comunicao e so armazenados no banco de dados. Os destinatrios so determinados a partir do Modelo de Distribuio. Clique em Enter. Para obter as informaes sobre o status e os dados do IDoc: 1. Insira /nwe02 no campo de comando e clique no smbolo Enter. A janela Listas de IDoc aberta. 2. Execute clicando no smbolo Enter. 3. A janela SAP aberta exibindo informaes de status sobre os dados passados para a porta. Selecione um IDoc clicando duas vezes nele. 4. Nessa janela, possvel visualizar os Dados Principais do Cliente enviados pelo sistema SAP. Para ler os Registros de Status, clique na mensagem de status individual. Resultados Se o perfil do parceiro estiver configurado para Dispatch imediato, um mapa ser executado imediatamente para cada IDoc transmitido. Por exemplo, se cinco IDocs forem gerados, cinco mapas sero executados. No entanto, se o perfil do parceiro estiver configurado para Coletar IDocs, ser necessrio fazer dispatch dos IDocs. Faa isso usando a transao BD88 ou planejando a tarefa RSEOUT00. Os mapas sero executados aps a concluso dessa tarefa. O nmero de instncias do mapa

50

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

depende do nmero de IDocs coletados em um pacote, conforme definido no perfil do parceiro. Se o nmero definido de IDocs por pacote for 20 e cinco IDocs forem gerados, um mapa ser executado. Durante a execuo de um mapa, so exibidas informaes de status: nome do mapa, status, tempo decorrido, entrada, sada e nmero de objetos.

Criando um Carto de Sada e Configurando o Processamento de Entrada


Por Que e Quando Desempenhar Esta Tarefa
Crie um mapa usando o Map Designer para transformar dados de um sistema externo no formato IDoc fornecendo dados de entrada para o SAP R/3. v No carto de sada do mapa, selecione R/3 JALE para a configurao Destino e especifique as configuraes do adaptador incluindo a insero de comandos do adaptador na configurao Comando de Destino. v Construa e execute o mapa executvel. Durante a execuo do mapa, so exibidas informaes de status: nome do mapa, status, tempo decorrido, entrada, sada e nmero de objetos. Para obter as informaes sobre o status do IDoc enviado para o SAP: 1. Insira /nwe02 no campo de comando e clique em Enter. A janela Lista de IDocs aberta. 2. Execute clicando em Enter. 3. Selecione o IDoc desejado clicando duas vezes nele. Quando IDocs de entrada so postados com xito por meio da camada de comunicao, eles so designados com o status IDoc includo. Quando IDocs de entrada so postados com xito por meio da camada de aplicativo, eles so designados com o status Documento do aplicativo postado. Se o IDoc no tiver passado pela camada de aplicativo, ser exibida uma mensagem de erro.

Processos de Entrada e de Sada


Esta seo fornece um resumo de possveis cenrios ALE de entrada e de sada que descrevem uma viso geral tcnica de alto nvel dos processos de comunicao entre o SAP R/3 em um sistema externo no-SAP R/3 usando o WebSphere Transformation Extender Pack para SAP.

Entrada de ALE para o SAP


Por Que e Quando Desempenhar Esta Tarefa
O adaptador R/3 pode recuperar entrada de vrios sistemas no-R/3 diferentes, conforme definido pelos mapas em execuo no Launcher ou no Command Server.

Captulo 5. Intermediate Documents (IDocs)

51

Sistemas No-R/3

Arquivos

Banco de Dados

MOM

Web

Aplicativos ERP

Servidor de Eventos ou de Comando

Dados

Biblioteca SAP RFC


RFC Adaptador R/3 (cliente) tRFC Inbound_IDoc_Process OU IDoc_Asynchronous_Process

Mensagem ALE

Gateway Interface ALE Camada de Aplicativo Comunicao IDoc

Aplicativo SAP

Sistema R/3

ALE

Comunicao

Para recuperar entrada de um sistema no-SAP R/3 para um sistema SAP R/3: 1. Conforme o servidor de transformao continua a executar o(s) mapa(s) seguindo a definio, a sada produzida e passada para o adaptador R/3. 2. O adaptador R/3 conecta-se ao sistema R/3 usando as informaes de conexo e o ID de usurio fornecidos. O SAP R/3 confirma as autorizaes do usurio. 3. Se ocorrer uma falha na conexo, o adaptador retornar um cdigo de falha para o servidor de transformao. 4. O adaptador R/3 faz as chamadas de RFC para carregar os dados de sada na Tabela Interna usada pelas bibliotecas RFC. 5. Se a gerao automtica de campo ou a converso automtica de EDI em ALE estiver ativada, o adaptador produzir essas converses conforme os dados forem carregados na Tabela Interna. 6. Se a configurao OnFailure estiver configurada como Retrocesso, o adaptador R/3 aguardar confirmao final do servidor de transformao de que todos os recursos de sada esto prontos para ser confirmados. O uso dessa opo requer que o adaptador use memria igual a duas vezes o tamanho de dados do IDoc. 7. Os dados so passados (confirmados) para o sistema SAP R/3 por pacote. Um pacote de cada vez designado com um nmero TID exclusivo e processado pelo SAP R/3. Se ocorrer uma falha na comunicao neste momento, apenas os pacotes no confirmados ficaro no arquivo de retrocesso.

52

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

8. Se ocorrer uma falha na comunicao neste ponto, o adaptador R/3 retornar um cdigo de falha para o servidor de transformao.

Sada de ALE do SAP


Por Que e Quando Desempenhar Esta Tarefa
O adaptador R/3 pode recuperar sada de vrios sistemas SAP R/3 diferentes, conforme definido pelos mapas em execuo no Launcher ou no Command Server.

Sistema R/3
IDoc Principal Aplicativo SAP

ALE
Determinao do Receptor

Comunicao
Comunicao IDoc Interface ALE

Gateway

Adaptador R/3 (servidor)

Biblioteca SAP RFC


RFC tRFC Inbound_IDoc_Process OU IDoc_Asynchronous_Process

Dados

Servidor de Eventos ou de Comando

sada

Arquivos

Banco de Dados

MOM

Web

Aplicativos ERP

Sistemas No-R/3

Para recuperar sada de um sistema SAP R/3 para um sistema no-SAP R/3 1. Um dos mdulos aplicativos do SAP gera um pedido para dados IDoc. Esse pedido pode ser on demand usando ALE, ou baseado em eventos, como aqueles definidos com a Determinao de Sada. Isso gera os Dados do IDoc. 2. Esse pedido direcionado ao perfil do parceiro. A configurao do perfil do parceiro determina a designao de porta. 3. A porta definida determina se essa uma comunicao baseada em arquivo ou uma comunicao baseada na memria ALE. Para comunicaes baseadas em memria, a porta designa o Destino de RFC. 4. O Destino de RFC determina que o mtodo de comunicao Registro (ou Incio) e tambm os parmetros fsicos do sistema externo.

Captulo 5. Intermediate Documents (IDocs)

53

5. Os dados IDoc so passados para o gateway. A consulta aos logs do IDoc indicaro uma mensagem Passagem para a Porta OK. 6. A camada de comunicao conecta-se ao sistema externo conforme configurado no Destino de RFC. Se a comunicao for bem-sucedida, a comunicao de sada ser iniciada. Se a comunicao falhar, o monitor de Transao do RFC (SM58) indicar um erro de comunicao. 7. Para conexes bem-sucedidas, a camada de comunicao se conectar funcionalidade do servidor SAP R/3 do adaptador R/3. A camada de comunicao faz as chamadas RFC para estabelecer a comunicao, executar as funes de gerenciamento do TID e passar os dados IDoc. 8. Os dados IDoc so passados para o adaptador R/3 por meio de memria. Isso implica em que o sistema e o usurio externos tenham recursos de memria adequados na plataforma externa. A camada de RFC requer at o dobro do tamanho dos dados IDoc para que haja memria suficiente para descompactao dos dados IDoc. (Os dados so transmitidos na rede no formato compactado para aumentar o desempenho da rede.) Alm disso, necessrio ter memria igual ao tamanho dos dados para manter os dados na memria. Os dados so mantidos da hora em que so recebidos at que possam ser processados pelo(s) mapa(s) apropriado(s). Isso requer ateno no planejamento se o Launcher estiver sendo usado, especialmente se os mapas tiverem baixo rendimento (ou tiverem um nico encadeamento) porque os mapas no estado pendente de inicializao esto consumindo memria para IDocs divididos em estgios. 9. Quando o adaptador R/3 receber os dados IDoc, um arquivo de backup de dados IDoc ser criado se a opo de adaptador -B for usada. O servidor de transformao comea a validao de todos os arquivos de entrada, construindo arquivos de trabalho temporrios conforme necessrio. 10. O servidor de transformao constri todos os dados de sada e se conecta a qualquer sistema que no for de arquivo atravs de adaptadores de recursos. 11. Se o mapa for concludo com xito, o adaptador R/3 fechar a conexo do SAP. Se o mapa no for concludo com xito, um arquivo de retrocesso dos dados IDoc ser criado se a configurao OnFailure estiver configurada como Retrocesso para a entrada de ALE.

Registros de Controle para Mapeamento de IDoc


A seguir esto exemplos de registros de controle 3.x e 4.x para ajud-lo no mapeamento de e para um IDoc.

Exemplo de Registro de Controle 3.x


Pos 1 2* 3* Campo TABNAM MANDT DOCNUM Descrio Nome da estrutura de tabela Cliente Nmero do IDoc Valor EDI_DC ou EDI_DC40 Status, Cliente Nmero incrementado automaticamente, comeando com 1, para cada pacote de IDocs Status, Release do SAP

4*

DOCREL

Release do SAP do IDoc

54

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Pos 5* 6 7* 8* 9* 10 11* 12* 13* 14* 15* 16* 17* 23* 19* 20

Campo STATUS DOCTYP DIRECT RCVPOR RCVPRT RCVPRN RCVSAD RCVLAD STD STDVRS STDMES MESCOD MESFCT OUTMOD TEST SNDPOR

Descrio Status do IDoc Tipo de IDoc Direo Porta do receptor Tipo de receptor do parceiro Nmero de receptor do parceiro Campos SADR no total Endereo lgico do receptor Padro EDI Verso do padro EDI Tipo de mensagem da EDI Cdigo da mensagem lgica Funo da mensagem lgica Modo de sada Sinalizador de teste Porta do emissor Se ALE tiver que comear com A Se EDI usar uma porta Arquivo

Valor WMMBID01 1=sada 2=entrada Sempre SAP + Nome

SCC4, Sistema Lgico

WE21; Pode ser qualquer porta Transacional definida A000000002

22* 22

SNDPRT SNDPRN

Tipo de emissor do parceiro Nmero de emissor do parceiro Campos SADR no total Endereo lgico do emissor Referncia ao arquivo de troca Referncia ao grupo de mensagens Referncia mensagem Chave de archive da EDI

LS BD64 LSEXT

23* 24* 25* 26* 30* 28*

SNDSAD SNDLAD REFINT REFGRP REFMES ARCKEY

Captulo 5. Intermediate Documents (IDocs)

55

Pos 29* 33* 31 32 33 34*

Campo CREDAT CRETIM MESTYP IDocTYP CIMTYP RCVPFC

Descrio Data de criao do IDoc Hora de criao do IDoc Tipo de mensagem lgica Nome do tipo de IDoc bsico Nome do tipo de extenso Funo de receptor do parceiro

Valor Formato CCYYMMDD Formato HHMMSS WE82, Tipo de Mensagem WMMBID01

WE20, apenas se usar a funo de Mensagem. Nota! Deve ser equivalente ao alemo!

35* 36* 37*

SNDPFC SERIAL EXPRSS

Funo de emissor do parceiro Campo de serializao Processamento de entrada de substituio Symbol(13) Retorno de linha apenas para a EDI no NT

38*

CR

* Opcional

Exemplo de Registro de Controle 4.x


Pos 1 2 3 4 5 6 7 8 Campo TABNAM MANDT DOCNUM DOCREL STATUS DIRECT OUTMOD EXPRSS Descrio Nome da estrutura de tabela Cliente Nmero do IDoc Release do SAP do IDoc Status do IDoc Direo Modo de sada Substituio no processamento de entrada Sinalizador de teste Nome do tipo bsico CREMAS01 Valor EDI_DC40

9 10

TEST IDocTYP

56

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Pos 11 12 13 14 15 16 17 18

Campo CIMTYP MESTYP MESCOD MESFCT STD STDVRS STDMES SNDPOR

Descrio Nome do tipo de extenso Tipo de mensagem lgica Cdigo da mensagem lgica Funo da mensagem lgica Padro EDI, sinalizador Padro EDI, verso e release Tipo de mensagem da EDI Porta do emissor (sistema SAP, subsistema externo) Tipo de emissor do parceiro Funo de emissor do parceiro Nmero de emissor do parceiro Endereo do emissor (SADR) Endereo lgico do emissor Porta do receptor (sistema SAP, subsistema externo) Tipo de destinatrio do parceiro Funo de destinatrio do parceiro Nmero do destinatrio do parceiro Endereo do destinatrio (SADR) Endereo lgico do destinatrio Criado em Hora da criao Referncia transferncia (troca da EDI)

Valor

CREMAS

19 20 21

SNDPRT SNDPFC SNDPRN

BD64 LSEXT

22 23 24

SNDSAD SNDLAD RCVPOR

25 26

RCVPRT RCVPFC

27

RCVPRN

T90CLNT090

28 29 30 31 32

RCVSAD RCVLAD CREDAT CRETIM REFINT

Captulo 5. Intermediate Documents (IDocs)

57

Pos 33

Campo REFGRP

Descrio Referncia ao grupo de mensagens (grupo de mensagens da EDI) Referncia mensagem (mensagem da EDI) Chave para o archive de mensagens (externo) Campo de serializao

Valor

34

REFMES

35

ARCKEY

36

SERIAL

Enviando IDocs EDI Usando ALE


Para maximizar o desempenho durante o desenvolvimento e teste, use sempre IDocs no formato ALE ao enviar dados usando um destino ALE do SAP R/3. O adaptador SAP R/3 converter IDocs no formato EDI em ALE quando necessrio. Isso simplifica o esforo de desenvolvimento ao converter interfaces baseadas em arquivo, como EDI em ALE. Nota: Esse recurso de converso automtica dever ser usado apenas para desenvolvimento e teste. Ele no deve ser usado em um ambiente de produo porque diminui muito o desempenho (aproximadamente 1.000 vezes).

58

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Captulo 6. Objetos de Transferncia de Dados (DXOB)


Objetos de transferncia de dados (DXOB) so objetos de negcios SAP R/3 que podem ser transferidos para um sistema SAP R/3. Para usar o SAP R/3 para criar interfaces DXOB, incluindo a criao de arquivos de transferncia de dados iniciais (relatrios DXOB) e o uso do Importer Wizard para gerar as rvores do tipo correspondentes, leia as sees a seguir: v Viso Geral dos Objetos de Transferncia de Dados v Gerando Metadados DXOB v Mapeando v Transferindo os Dados Mapeados

Viso Geral dos Objetos de Transferncia de Dados


Os relatrios DXOB (Objeto de Transferncia de Dados) so produzidos a partir de DXOBs fornecidos pelo SAP ou de DXOBs modificados fornecidos pelo SAP. O Importer Wizard trabalha com um desses tipos de DXOB. Esses DXOBs fornecidos pelo SAP esto disponveis nas verses 4.0 e posterior do SAP R/3. Nota: Os DXOBs fornecidos pelo SAP podem ser alterados de uma verso do SAP R/3 para outra. Ao atualizar as verses do SAP R/3, use o Importer Wizard para gerar novamente as rvores do tipo adequadamente. A definio de DXOB que serve como entrada de metadados para o Importer Wizard deve estar no formato produzido pela execuo do relatrio DXOB a partir do sistema SAP R/3. Ao executar o programa DXOB, possvel salvar o relatrio em um arquivo com a extenso .dx, que o padro no Importer Wizard. Depois de ter produzido o(s) relatrio(s) DXOB apropriado(s) a partir do SAP R/3, transfira o arquivo de relatrio para o PC em que o Type Designer est instalado. Nota: O arquivo de metadados produzido pelo relatrio DXOB conter definies para um nico DXOB. Para processar interfaces DXOB: 1. Gerando Metadados DXOB (SXDA). 2. Usando o SAP:DXOB Importer para gerar a rvore do tipo. 3. Criando um Mapa para Dados Formatados DXOB 4. Transferindo os Dados Mapeados para a Camada de Aplicativo. 5. Processando a Sesso de Entrada de Lote (SM35)

Gerando Metadados DXOB


A partir da verso 3.1G, o SAP R/3 fornece um Ambiente de Trabalho de Transferncia de Dados (cdigo de transao SXDA) para facilitar os carregamentos iniciais de dados no SAP R/3. O Ambiente de Trabalho de Transferncia de Dados fornece um ponto de controle central para a criao de relatrios DXOB e o incio de programas DX.

Copyright IBM Corp. 2006, 2009

59

Ambiente de Trabalho de Transferncia de Dados (SXDA)


Por Que e Quando Desempenhar Esta Tarefa
Para gerar metadados DXOB: 1. Insira /nsxda no campo de comando e clique em Enter. A janela Ambiente de Trabalho de Transferncia de Dados aberta. 2. No menu Ir para, selecione Ferramentas DX. A janela Transferncia de Dados - Ferramentas aberta. 3. No campo Tipo de Objeto, selecione o DXOB na lista suspensa para a qual deseja gerar um relatrio. (Por exemplo, use o objeto DX KNA1 para Cliente.) 4. No campo Tipo de Programa, selecione um tipo de programa na lista suspensa. (Por exemplo, BINP.) 5. No campo Programa, selecione um mtodo na lista suspensa. (Por exemplo, RFBIDE00.) 6. No menu Extras, selecione Exibir Estrutura de Importao. A janela Tipos de Registro do Conjunto de Dados da Documentao para Transferncia de Dados Inicial (Analisador) aberta. Esse exemplo mostra a estrutura de interface necessria para Dados Principais do Cliente do objeto DX 0050. 7. No menu Lista, selecione Download para transferir essa estrutura para um caminho que exista no PC em que o Design Studio est instalado. O dilogo Salvar Lista no Arquivo aberto. 8. Selecione no convertido e clique no smbolo Enter. O dilogo Salvar como aberto. 9. Especifique o caminho completo para o arquivo que est sendo transferido por download e clique em Salvar. (Neste exemplo, o arquivo DXOB0050.dx.) A transferncia de arquivos est completa.

Mapeamento
Por Que e Quando Desempenhar Esta Tarefa
Depois que terminar de criar o relatrio DXOB e transferir esse arquivo de metadados, use o Map Designer para criar o mapa.

Usando o SAP:DXOB Importer


Por Que e Quando Desempenhar Esta Tarefa
Depois de ter produzido um relatrio DXOB descrevendo o formato do(s) DXOB(s) desejado(s) e de ter transferido esse arquivo para o PC do Design Studio, voc est pronto para executar o Importer Wizard. O SAP:DXOB (Transferncia de Dados Inicial [DX]) Importer para SAP R/3 um recurso para gerar automaticamente rvores do tipo que descrevam o formato de Objetos de Transferncia de Dados (DXOBs) usados no sistema SAP R/3. Um exemplo do relatrio DXOB est nos diretrios examples\packs\sap_r3\r3\ ERP\DXOB includos na instalao do WebSphere Transformation Extender Pack para SAP. Esse arquivo de relatrio DXOB contm as definies para o objeto de transferncia de dados de Recursos Humanos. possvel usar esse arquivo como entrada de metadados para executar o SAP:DXOB Importer.

60

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Para executar o SAP:DXOB Importer: 1. No Type Designer, selecione Importar no menu rvore. 2. Escolha SAP:DXOB como a estrutura para a qual voc deseja gerar uma rvore do tipo. Clique em Avanar. 3. Continue clicando em Avanar at que o campo Nome do Arquivo aparea na janela. No campo Nome do Arquivo, insira o arquivo de metadados que deseja importar (neste exemplo, DXOB0050.dx) para gerar uma rvore do tipo.

Formatos DXOB
A estrutura Objeto de Transferncia de Dados (DXOB) do SAP est disponvel em dois formatos diferentes: v Formato liberado: Este o formato padro na verso 4.0 e acima. A segunda linha do formato Liberado comea com BEGIN_DXOB 00200000 e conter, normalmente, campos IDENTVALUE no incio de cada segmento. v Formato beta: Esse formato apareceu primeiramente no R/3 3.1G e 3.1H do SAP. A segunda linha do relatrio comea com BEGIN_IDOC DXOB0020 e os segmentos no incluem um campo IDENTVALUE.

Entendendo a rvore do Tipo DXOB


O arquivo de metadados DXOB produzido pelo relatrio DXOB contm a definio para um nico DXOB. A rvore do tipo gerada pelo Importer Wizard corresponder adequadamente. Os tipos gerados na rvore do tipo representam o seguinte: v Sesso nica v 0 o identificador do registro que contm um prefixo de Sesso v 1 o identificador do registro que contm dados de Cabealho v 2 o identificador do registro que contm dados de segmento do Documento Nota: Um caractere de barra (/) indica que no h dados.

Criando um Mapa para Dados Formatados DXOB


Por Que e Quando Desempenhar Esta Tarefa
Usando o Map Designer, crie um mapa que contenha a lgica necessria para transformar dados de entrada em dados formatados DXOB. Para criar um mapa para transformar dados em dados formatados DXOB: 1. Crie o carto de entrada (para dados de sada) que especifique a origem dos dados de entrada do mapa. Selecione Arquivo para o valor da configurao Origem e especifique as configuraes do carto. 2. Crie um carto de sada (para dados de entrada) que especifique o destino para os dados de sada do mapa. Selecione Arquivo para o valor da configurao Destino e especifique as configuraes do carto. 3. Depois de definir os cartes de entrada e de sada, insira as regras de mapeamento para fornecer valores para cada um dos campos e telas que voc deseja criar para esta transao. Insira =NONE como a regra do mapa para campos e telas no usados. 4. Continue com o processo de mapeamento (construir, analisar e executar) at que o mapa esteja produzindo os dados de sada corretos.

Captulo 6. Objetos de Transferncia de Dados (DXOB)

61

Transferindo os Dados Mapeados


Por Que e Quando Desempenhar Esta Tarefa
A execuo do mapa criou os dados de sada. Os dados precisam ser transferidos do PC para a camada de aplicativo.

Transferindo os Dados Mapeados para a Camada de Aplicativo


Por Que e Quando Desempenhar Esta Tarefa
Use a janela Ambiente de Trabalho de Transferncia de Dados para transferir os dados de sada resultantes da execuo do mapa do PC para a camada de aplicativo. As etapas baseiam-se no design do Aplicativo Corporativo 4.7. Para transferir os dados mapeados do PC para a camada de aplicativo: 1. Insira /nsxda no campo de comando e clique em Enter. A janela Ambiente de Trabalho de Transferncia de Dados aparece. 2. No menu Ir para, selecione Ferramentas DX. A janela Transferncia de Dados - Ferramentas aberta. 3. Clique em Copiar. A janela Copiar Arquivo aberta. 4. Selecione Servidor de Apresentao e especifique o nome do arquivo de sada de mapa a ser transferido. Ele a sada do mapa que contm os dados necessrios para o Cliente principal no formato do objeto SAP DX. 5. Selecione Servidor de Aplicativos e selecione um tipo de dado para o destino na lista suspensa no campo Tipo de Arquivo. 6. No campo Nome do Arquivo, insira o nome de arquivo do destino no servidor de aplicativos R/3 no local padro. 7. Clique em Enter. O arquivo copiado para a camada de aplicativo. A janela Transferncia de Dados - Ferramentas aberta. 8. No campo Tipo de Arquivo, selecione um tipo de dado para o arquivo de entrada na lista suspensa. 9. No campo Nome do Arquivo, insira o local do arquivo de entrada no servidor de aplicativos R/3. 10. Clique em Exibir. 11. A janela Arquivo &: & Transaes aparece contendo os nomes dos vrios segmentos e os campos de dados associados a esses segmentos. O caractere de barra (/) usado para transferir campos vazios para o SAP. 12. Clique em Salvar.

Criando a Sesso de Entrada de Lote


Por Que e Quando Desempenhar Esta Tarefa
Os dados criados pelo mapa foram transferidos do PC para a camada de aplicativo. Agora uma sesso de entrada de lote ser criada para o arquivo .txt que reside, no momento, no servidor de aplicativos. As etapas acima baseiam-se no design do Aplicativo Corporativo 4.7. Para criar a Sesso de Entrada de Lote:

62

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

1. Insira /nsxda no campo de comando e clique em Enter. A janela Ambiente de Trabalho de Transferncia de Dados aparece. 2. Clique em Converter dados. 3. Clique em Ambiente de Trabalho LSM. A janela Ambiente de Trabalho de Migrao do Sistema Legado aberta. 4. Clique em Executar. A janela Ambiente de Trabalho LSM aberta. 5. Na janela Ambiente de Trabalho LSM, clique em Menu do Usurio. O dilogo Menu do Usurio exibido. 6. Selecione Criar Sesso de Entrada de Lote e clique em Enter. A opo Criar Sesso de Entrada de Lote agora includa na janela Ambiente de Trabalho LSM. 7. Selecione Criar Sesso de Entrada de Lote e clique em Executar. A janela Interface de Entrada de Lote para Clientes aberta. O nome de caminho do arquivo padronizado como customer.txt. 8. Ative Verificar apenas arquivo. 9. No menu Programa, selecione Executar para procurar as terminaes na sesso de entrada de lote. Nota: Esse programa tambm pode ser executado no plano de fundo selecionando-se Executar no plano de fundo. 10. Clique em Enter. 11. Aps a validao do arquivo .txt, execute o programa de interface de entrada de lote para a transferncia de dados. 12. Desative a caixa de opo Verificar apenas arquivo. 13. Execute o programa selecionando Executar no menu Programa. A caixa de dilogo Informaes exibida fornecendo informaes de status sobre a sesso de entrada de lote. O exemplo a seguir mostra a sesso de entrada de lote sendo criada. 14. Clique em Enter.

Processando a Sesso de Entrada de Lote (SM35)


Por Que e Quando Desempenhar Esta Tarefa
Os dados criados pelo mapa foram transferidos do PC para a camada de aplicativo. Alm disso, uma sesso de entrada de lote foi criada para o arquivo .txt que reside, no momento, no servidor de aplicativos. Agora possvel acessar a Sesso de Entrada de Lote e processar os dados no arquivo .txt. Para processar as Sesses de Entrada de Lote: 1. Insira o cdigo de transao /nsm35 para acessar as sesses de entrada de lote. 2. Na lista Sesso, selecione a sesso que deseja processar. 3. No menu Sesso, selecione Processar sesso. A caixa de dilogo Processar sesso aberta. 4. Selecione uma das opes para o Modo de execuo como a seguir: v Processar/primeiro plano: Executa a sesso no primeiro plano, exibindo cada tela e campo. Se voc alterar uma tela nessa opo, o processo interrompido.
Captulo 6. Objetos de Transferncia de Dados (DXOB)

63

v Exibir apenas erros: Executa a sesso no primeiro plano, exibindo apenas erros. v Plano de fundo: Executa a sesso no plano de fundo. 5. Selecione Funes adicionais conforme desejado. (Neste exemplo, TESTDXOB ser processado no modo de execuo Exibir apenas erros com Tamanho padro Dynpro.) 6. Clique em Processar. Nota: possvel terminar uma sesso a qualquer momento selecionando-se Sistema Servios Entrada de Lote Excluir Transao. 7. Clique em Sim para salvar os dados principais do cliente. A sesso de entrada de lote processada e a caixa de dilogo Informaes aberta com o status do processo. 8. Clique em Sair. O processamento concludo. (Neste exemplo, uma sesso de entrada de lote foi criada para cada dado principal do cliente.) 9. Realce a sesso BDC recm-processada e clique em Log para acessar os resultados. A janela Entrada de Lote: Viso Geral do Log aberta. 10. Selecione o log e clique em Exibir para visualizar os resultados. A janela Log de Entrada de Lote para a Sesso session_name aberta.

64

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Captulo 7. Batch Data Communication (BDC)


O SAP R/3 automatiza implementando solues de interface para o fluxo de dados Batch Data Communication (BDC). O suporte fornecido pelo SAP R/3 para desenvolver interfaces BDC inclui: v v v v v Viso Geral do BDC Gravando uma Sesso BDC (SHDB) Criando o Relatrio de Estrutura BDC (ZBDC) Mapeando Carregando os Dados da Sesso BDC

Viso Geral do BDC


As Sesses BDC so usadas normalmente para carregar sistemas SAP com dados legados ou para automatizar tarefas repetitivas de entrada de dados. Elas simulam a entrada on-line de transaes e dados, incluindo todas as validaes construdas em cada transao. As sesses BDC tambm so conhecidas como Sesses de Entrada de Lote. Historicamente, em um ambiente BDC, um programador teria que examinar manualmente a transao inteira, observando cada campo (Nome, Tipo e Comprimento). Com essas informaes, ele teria que gravar um programa de entrada de lote para formatar os recebidos em uma tabela BDC. O SAP R/3 elimina essas etapas usando o recurso de Gravao BDC construdo no SAP R/3 (verso 3.1G e superior). O usurio grava uma transao de amostra e o Importer Wizard formata essa gravao em uma rvore do tipo. Essa rvore do tipo usada no Map Designer para mapear os dados diretamente para um formato de tabela BDC, que processado pelo programa de sesso BDC do SAP R/3. Para carregar sistemas SAP com dados por meio de uma sesso BDC 1. Identifique a transao a ser usada para criar os dados SAP. 2. Execute o SHDB (gravao SM35). Esta uma transao SAP usada para tarefas de carregamento inicial de dados. O sistema SAP R/3 (verso 3.1G ou superior) necessrio para essa funo. Geralmente, a maioria de sua configurao deveria estar concluda e testada antes da execuo desta sesso de gravao e a sesso deveria ser gravada em um ambiente de teste. 3. Execute o ZBDC. Executando essa transao (ZBDC), possvel gerar um relatrio estruturado de metadados a partir de uma gravao. A transao ZBDC est includa com os arquivos de Correo e Transporte instalados no diretrio install_dir\bdc como parte da instalao do WebSphere Transformation Extender Pack para SAP. Assegure-se de que esses arquivos tenham sido importados e ativados como objetos no sistema SAP R/3 antes de executar a transao ZBDC. 4. Faa download do arquivo de metadados produzido pelo ZBDC. 5. Execute o Importer Wizard e selecione BDC para gerar sua rvore do tipo. 6. Crie o mapa usando essa rvore do tipo em um carto de sada. O mapa produzir um arquivo semelhante ao que conhecido pelos usurios do SAP como uma tabela BDC.
Copyright IBM Corp. 2006, 2009

65

7. Execute o ZBDS. Este processo l o arquivo existente no PC em que o Design Studio (que, na terminologia SAP o servidor de apresentao) est instalado. Em seguida, ele o copia para o servidor SAP R/3, preenche a tabela BDC do SAP e cria a sesso BI (Batch Input) ou realiza a DI (Direct Input). 8. Execute o SM35 para processar a sesso de lote.

Gravando uma Sesso BDC (SHDB)


Por Que e Quando Desempenhar Esta Tarefa
Depois de ter identificado a transao a ser usada para criar os dados SAP, execute SHDB (gravao SM35). Para gravar uma sesso BDC: 1. Insira /nshdb no campo de comando e clique em Enter. A janela Gravador de Transao: Viso Geral da Gravao aberta. 2. No menu Gravao, selecione Criar. A caixa de dilogo Criar Gravao aberta. 3. No campo Gravao, insira um nome para o arquivo de registro. (Por exemplo, MakeFK01.) 4. No campo Cdigo de Transao, insira um cdigo de transao e clique em Enter. (Por exemplo, FK01.) 5. 6. 7. 8. 9. A janela Criar Fornecedor: Tela Inicial aberta. Insira o identificador do fornecedor no campo Fornecedor. (Por exemplo, 22321.) Insira o identificador da empresa no campo Cdigo da Empresa. (Por exemplo, 0001.) Insira o identificador do grupo da conta no campo Grupo da Conta. (Por exemplo, 0001.) Clique em Enter. A janela Criar Fornecedor: Endereo aberta. Insira as informaes do fornecedor nos campos apropriados:
Para o exemplo John Smith Smith Nova York 11023 EUA pt

Tabela 7. Informaes do fornecedor para gravao de uma sesso BDC Campo Nome Item de Procura Cidade Cdigo de Endereamento Postal Pas Chave do Idioma

10. Clique em Enter. A janela Criar Fornecedor: Controle aberta. 11. Clique em Enter. A janela Criar Fornecedor: Transaes de Pagamento aparece. 12. Clique em Enter.

66

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

A janela Criar Fornecedor: Contabilidade das Informaes de Contabilidade aberta. 13. No campo Conta de Rec., insira o identificador apropriado. (Esse exemplo usa 160000.) 14. No campo Grupo de Gerenc. de Dinheiro, insira o identificador do grupo de planejamento. (Esse exemplo usa A1.) 15. Clique em Enter. A janela Criar Fornecedor: Contabilidade das Transaes de Pagamento aberta. 16. No campo Termos de Pagamento, insira o termo apropriado. (Esse exemplo usa 0002.) 17. Clique em Enter. A janela Criar Fornecedor: Contabilidade da Correspondncia aberta. 18. No campo Procedimento Dunn, selecione o cdigo desejado. (Esse exemplo usa 0001.) 19. Clique em Enter. Uma caixa de dilogo de confirmao aberta. 20. Clique em Sim. A janela Gravador de Transao: Alterar Dados de Gravao MAKEFK01 aparece exibindo as informaes inseridas. 21. No menu Gravao, escolha Salvar. 22. Valide sua gravao. Nota: Se BDC_OKCODE for igual a NO, a gravao ser invlida e a gerao da rvore do tipo falhar.

Criando o Relatrio de Estrutura BDC (ZBDC)


Por Que e Quando Desempenhar Esta Tarefa
Depois de ter salvo a gravao BDC, execute a transao ZBDC para gerar o relatrio de estrutura de metadados. ZBDC uma transao desenvolvida para este Pack como parte da oferta SAP R/3. Essa transao est includa com os arquivos de Correo e Transporte instalados no diretrio install_dir\bdc. Assegure-se de que esses arquivos tenham sido importados e ativados como objetos no sistema SAP R/3 antes de executar a transao ZBDC. Para gerar o relatrio de estrutura BDC: 1. Insira /nzbdc na caixa de comando e clique em Enter. A janela Criar rvore do Tipo a partir da Sesso Gravada BDC aberta. 2. Insira um nome para o primeiro campo GROUPID e, em seguida, clique em Executar. (Por exemplo: MAKEFK01.) A janela Criar rvore do Tipo a partir da Sesso Gravada BDC aberta. 3. Selecione a gravao desejada clicando duas vezes no nome da gravao. (No exemplo, a gravao MAKEFK01.) A janela Criar rvore do Tipo a partir da Sesso Gravada BDC aberta novamente com a gravao selecionada. 4. Clique em Fazer Download do Arquivo Local.
Captulo 7. Batch Data Communication (BDC)

67

A caixa de dilogo Transferir para um Arquivo Local aberta. 5. Especifique o nome de caminho completo para salvar o arquivo de estrutura com a extenso de arquivo padro .bdc e formato ASC. 6. Clique em Transferir.

Mapeamento
Por Que e Quando Desempenhar Esta Tarefa
Depois de ter concludo a criao do arquivo de estrutura BDC e de ter transferido esse arquivo de metadados, use o Design Studio para criar o mapa. O SAP:BDC (Batch Data Communications) Importer um recurso para gerar automaticamente rvores do tipo que descrevam o formato de dados usados em sesses BDC no sistema SAP R/3. Para executar o SAP:BDC Importer: Depois de ter produzido um estrutura de estrutura descrevendo o formato do BDC desejado e de ter transferido esse arquivo para o PC do Design Studio, voc est pronto para executar o Importer Wizard. Consulte Executando o Importer Wizard para obter instrues sobre como executar o importador. Um arquivo de estrutura de exemplo est no diretrio examples\packs\sap_r3\r3\ERP\BDC includo na instalao do WebSphere Transformation Extender Pack para SAP. possvel usar esse arquivo como entrada de metadados para testar o Importer Wizard. No menu rvore do Type Designer, selecione Importar. 1. Escolha SAP:BDC como a estrutura para a qual voc deseja gerar uma rvore do tipo. Insira as informaes nas caixas de dilogo do Importer Wizard, conforme necessrio. 2. No campo Nome do Arquivo, especifique o arquivo de estrutura que deseja usar como a entrada de metadados para gerar uma rvore do tipo.

Entendendo a rvore do Tipo BDC


A rvore do tipo gerada pelo Importer Wizard para uma transao FK01 (Criar Fornecedor) descrita nas seguintes sees: ID da Transao (FK01), DYNPRO, Campo. O tipo de grupo BDC_Session composto por uma ou mais transaes.

Transaction ID (FK01)
O tipo de grupo com o nome do cdigo de transao define o contedo de uma nica transao. Por exemplo, o tipo de grupo FK01 na rvore do tipo fk01_47.mtt representa o contedo de uma nica transao FK01 que inclui as telas que fazem parte da transao. Neste exemplo, uma ocorrncia de tipo FK01 criar um fornecedor. Um exemplo de cdigo de transao para uma sesso BDC, FK01, est no diretrio examples\packs\sap_r3\r3\ERP\BDC includo na instalao do WebSphere Transformation Extender Pack para SAP.

68

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

DYNPRO
Uma transao composta por um conjunto de programas dinmicos (DYNPROs). DYNPRO uma tela dentro da sesso BDC e sua lgica de fluxo. Uma DYNPRO pode ser considerada o equivalente de uma tela. Portanto, a transao ser composta por um objeto DYNPRO para cada tela que tiver sido processada no gravador BDC. Na rvore do tipo BDC, haver um grupo para cada DYNPRO na transao que foi gravada.

Campo
Cada DYNPRO individual composta pelos campos ou loops de etapas que compem essa tela na transao. Na janela de propriedades do Type Designer, o nome do tipo corresponde ao nome do campo no dicionrio de dados do R/3. As informaes do dicionrio de dados do SAP R/3 de um determinado campo podem ser visualizadas interativamente na GUI do SAP apontando-se para um campo com o mouse, pressionando-se F1 para obter ajuda e, em seguida, selecionando-se Informaes Tcnicas. A janela Informaes Tcnicas inclui o nome do campo com o rtulo Nome do Campo. Frequentemente, ela tambm conter informaes sobre os dados a serem inseridos neste campo. Alm disso, a janela conter informaes usadas para a entrada de lote.

Criando um Mapa para Dados Formatados da Sesso BDC


Por Que e Quando Desempenhar Esta Tarefa
Usando o Map Designer, crie um mapa que contenha a lgica necessria para transformar dados de entrada em dados formatados da sesso BDC.

Criando um Carto de Entrada


Por Que e Quando Desempenhar Esta Tarefa
Crie o carto de entrada que especifique a origem dos dados de entrada do mapa. Especifique os valores para: v Configuraes de CardName, TypeTree e Tipo. v Selecione Arquivo como o valor para a configurao Origem. (O adaptador R/3 no usado para uma origem BDC.) v Especifique a origem na configurao FilePath de Origem e defina outras configuraes do carto que desejar para seus requisitos de execuo. Nota: Para exceder duas ou mais entradas de lote usando um mapa, altere a configurao Escopo para CARD.

Criando um Carto de Sada


Por Que e Quando Desempenhar Esta Tarefa
Crie um carto de sada que especifique o destino para os dados de sada do mapa. Considere as seguintes informaes ao criar o carto de sada para mapeamento para o formato BDC: v Se o mapa for criar vrias transaes, o carto de mapa executvel dos dados da sesso BDC dever fazer referncia ao objeto BDC_Session.

Captulo 7. Batch Data Communication (BDC)

69

v Se o mapa for criar uma nica transao apenas, o carto de mapa executvel dos dados da sesso BDC poder fazer referncia ao objeto BDC_Session ou ao objeto de transao. Selecione R/3 BDC como o valor da configurao AdapterTarget. Para a configurao TargetAdapterCommand, insira os comandos de adaptador necessrios para enviar a sada automaticamente para uma Sesso de Entrada de Lote. Para obter informaes adicionais sobre como usar os comandos do adaptador R/3 para uma sesso de lote BDC, consulte Usando Comandos do Adaptador R/3. Nota: Alternativamente, possvel selecionar Arquivo como a configurao AdapterTarget e usar o ZBDS da transao para carregar os dados. Depois de definir os cartes de entrada e de sada, insira as regras de mapeamento para fornecer valores para cada um dos campos e telas que voc deseja criar para esta transao. Insira =NONE como a regra do mapa para campos e telas no usados. Construa, analise e execute o mapa. Os dados de sada corretos so gerados.

Carregando os Dados da Sesso BDC


Por Que e Quando Desempenhar Esta Tarefa
Aps a execuo do mapa, o prximo processo carregar os dados da Sesso BDC criados com o mapa. H dois mtodos para realizar isso: v Enviar Dados da Sesso BDC Usando o Adaptador R/3 v Carregando os Dados Manualmente Usando a Transao ZBDS Enviar Dados da Sesso BDC Usando o Adaptador R/3 Esse mtodo usa a funcionalidade da RFC do adaptador R/3 BDC para enviar automaticamente a entrada de dados mapeados para o SAP. Ao criar o mapa, selecione R/3 BDC como o valor da configurao Destino no carto de sada e especifique os comandos do adaptador necessrios compilados no mapa. A seguir est um exemplo do comando do adaptador BDC nas configuraes de destino:
-c 800 -u SAPLOGON_USER -p SAPLOGON_PASS -h 299.455.101.22 -s 00 -ar3 -trans FK01 -group DOCS -keep X -asuser SAP_USER

Se a configurao Destino em um mapa compilado no for R/3 BDC, voc poder designar o adaptador R/3 para ser usado para um carto de sada especificando o comando de execuo Substituio da Sada (-OABDC) com os comandos de adaptador necessrios do SAP R/3 na linha de comandos. A seguir est um exemplo de uma substituio do carto de sada, que especifica o uso do adaptador R/3 para transmitir dados BDC diretamente. Nota: No exemplo a seguir, a varivel DOCS um parmetro de tempo de execuo e no possui associao ou anexo do SAP a nenhum grupo de tempo de design.

70

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

dstx xBDC.mmc -ADE -WDU -OABDC1 `-c 800 -u SAPLOGON_USER -p SAPLOGON_PASS -h 299.455.101.22 -s 00 -ar3 -trans FK01 -group DOCS -keep X -asuser SAP_USER'

Comando/Valor do Adaptador Interpretao -c 800 Identifica o nmero do cliente. Necessrio para efetuar logon no sistema SAP R/3. No exemplo, o nmero do cliente 800. -u SAPLOGON_USER Identifica o nome do usurio. Necessrio para efetuar logon no sistema SAP R/3. No exemplo, o nome do usurio SAPLOGON_USER. -p SAPLOGON_PASS Identifica a senha. Necessrio para efetuar logon no sistema SAP R/3. No exemplo, a senha SAPLOGON_PASS. -h 299.455.101.22 Identifica o nome do host ou a cadeia de rota do SAP do servidor R/3 ao qual se conectar. No exemplo, a cadeia de rota do SAP 299.455.101.22. -s 00 -ar3 Identifica o nmero do sistema. No exemplo, o nmero do sistema 00. Especifica a criao de um arquivo de log do adaptador contendo informaes sobre as transaes ocorridas para esse destino durante a execuo do mapa AR3 significa Auditoria R/3. FK01 Identifica o Cdigo de Transao. No exemplo, o cdigo de transao FK01.

Grupo Identifica o Grupo. No exemplo, o nome do grupo DOCS. -keep -asuser Identifica o ID DE USURIO do SAP. No exemplo, o ID de Usurio do SAP SAP_USER. Carregando os Dados Manualmente Usando a Transao ZBDS Esse mtodo executado no sistema R/3 em que voc insere os valores necessrios nas vrias telas fornecidas pela transao ZBDS (janela Iniciar Sesso BDC). No exemplo, a sesso manter possui o valor X significando sim.

Carregando os Dados (ZBDS)


Por Que e Quando Desempenhar Esta Tarefa
A transao ZBDS outra transao desenvolvida para este Pack. Quando essa transao usada para carregar os dados, possvel processar os dados recuperados como uma Sesso de Entrada de Lote ou como uma Transao de Chamada. Nota: A transao ZBDS s pode ser usada para processar tabelas BDC criadas por mapeamento. Para carregar os dados usando a transao ZBDS: 1. Insira o cdigo de transao ZBDS no campo de comando. A janela Iniciar Sesso BDC aberta.

Captulo 7. Batch Data Communication (BDC)

71

2. No grupo Entradas Necessrias, selecione o processamento Sesso de Entrada de Lote ou Transao de Chamada. 3. Insira o cdigo de Transao do SAP que est sendo processado. 4. Se voc escolheu o processamento Sesso de Entrada de Lote, insira as informaes para a caixa de grupo Parmetros de Sesso de Entrada de Lote nos campos apropriados como a seguir: v Grupo: Insira um ID para esta Sesso de Entrada de Lote. O ID usado para identificar esta submisso no SM35. v Usurio: Para processar a sesso com um usurio diferente, insira o ID de usurio aqui. Observe que o processamento padro sempre feito no cliente atual. v Manter: Quando selecionada, a sesso salva aps o processamento at que o administrador a exclua manualmente. v Data de Suspenso: O processamento da Sesso BDC planejado para comear depois da data inserida neste campo. Deixe em branco para que o processamento comece sem restries de data. 5. Se voc escolheu o processamento Transao de Chamada, para a caixa de grupo Parmetros da Transao de Chamada, selecione o cdigo apropriado para o Modo de Exibio: v A: Todas as telas so exibidas durante o processamento da transao. v E: Apenas as telas relatando erros so mostradas, permitindo correo manual. v N: Nenhuma tela mostrada. 6. Para a caixa de grupo Opes de Processamento, selecione as opes a seguir, conforme necessrio: v Exibir Arquivo antes da Execuo: Selecione essa opo para exibir a tabela BDC (entrada para a Sesso BDC) antes de realmente process-la. v Exibir apenas: Selecione para exibir a tabela BDC, mas no process-la. v Normal; Processar BDC Agora: Selecione essa opo para processar sem a exibio da tabela BDC. 7. Por padro, o ZBDS renumera os loops de etapas, no entanto, h situaes em que voc pode querer controlar a numerao do loop de etapas sozinho. Neste caso, voc poderia alterar os iniciadores na rvore do tipo e ativar Ignorar a Renumerao do Loop de Etapas. Quando forem encontrados loops de etapas em uma gravao, a rvore do tipo gerada gerar o ndice do loop de etapas como (01). Quando o mapa for concludo, cada ocorrncia do loop de etapas ser numerado (01). 8. Clique no smbolo Executar. 9. A caixa de dilogo Importar Arquivo BDC de um Arquivo Local aberta. No campo Nome do Arquivo, insira o nome do caminho completo do arquivo a ser processado. Este o arquivo de sada criado pelo servidor de transformao para representar os dados da Sesso BDC. Insira o Formato de dados, que ASC para ASCII. Clique em Transferir para continuar. Os dados sero transferidos por upload e a seguinte mensagem ser exibida na barra de status (canto esquerdo inferior). Transferindo dados por upload a partir da estao de trabalho Para continuar o processamento, clique em Executar BDC. Uma janela aberta indicando que a tabela BDC foi processada com xito.

10. 11.

12.

72

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Processando uma Sesso de Lote (SM35)


Por Que e Quando Desempenhar Esta Tarefa
Aps a criao de uma sesso de lote usando ZBDS, processe a sesso de lote usando o cdigo de transao SM35. Para processar uma sesso de lote (SM35): 1. Insira o cdigo de transao SM35 no campo de comando. 2. Na lista Sesso, selecione a sesso que deseja processar. Este o nome do grupo especificado usando o comando do adaptador -G (em um carto de sada ou na linha de comandos) ou aquele inserido usando a transao ZBDS. 3. No menu Sesso, selecione Processar sesso. A caixa de dilogo Processar Sesso TESTDXOB aberta. 4. Selecione uma das opes para a caixa de grupo Modo de execuo: v Processar/primeiro plano: Executa a sesso no primeiro plano, exibindo cada janela e campo. Se voc alterar uma tela nessa opo, o processo interrompido. v Exibir apenas erros: Executa a sesso no primeiro plano, exibindo apenas erros. v Plano de fundo: Executa a sesso no plano de fundo. 5. Ative as configuraes na caixa de grupo Funes adicionais conforme desejar. 6. Clique em Processar. 7. Realce a sesso BDC recm-processada e clique em Log para acessar os resultados. A janela Entrada de Lote: Viso Geral do Log aberta. 8. Selecione o log e clique em Exibir para visualizar os resultados. A janela Log de Entrada de Lote para a Sesso session_name aberta.

Captulo 7. Batch Data Communication (BDC)

73

74

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Captulo 8. Business Application Programming Interface (BAPI)


O SAP R/3 automatiza implementando solues de interface para objetos Business Application Programming Interface (BAPI). Esta seo discute o suporte fornecido pelo SAP R/3 para desenvolver interfaces BAPI. Os tpicos discutidos incluem: v Viso Geral da Interface (BAPI) v Mapeando Nota: O adaptador BAPI (na verso 6.7.x ou posterior) s pode ser usado na funo GET. Ele no pode ser usado em um carto de entrada de mapa, carto de sada de mapa ou funo PUT.

Viso Geral da Interface (BAPI)


Os Objetos de Negcios do SAP residem na Estrutura de Negcios e fornecem a interoperabilidade dos componentes de software. Coletivamente, os Objetos de Negcios esto contidos no Business Object Repository (BOR). Eles incluem um intervalo amplo de dados de negcios e processos do SAP R/3. As BAPIs permitem que sistemas no-SAP R/3 externos, como produtos no WebSphere Transformation Extender Pack para SAP, acessem os mtodos em um Objeto de Negcios do SAP. Os Objetos de Negcios do SAP e suas BAPIs fornecem uma visualizao orientada a objetos da funcionalidade do SAP R/3. As BAPIs foram introduzidas no SAP verso 3.1 e obtiveram maior alcance e cobertura no release 4.5. As BAPIs so usadas em regras de mapeamento. So usadas geralmente em outros mtodos de interface, que precisam de acesso a informaes fornecidas pelo Objeto de Negcios. Um desenvolvedor pode chamar uma BAPI sncrona na regra de mapeamento de um carto de sada conforme fornecida pelo suporte do adaptador BAPI R/3 para as BAPIs. Os dados retornados da BAPI podem ser mapeados para outros objetos de dados de sada ou podem ser usados para lgica condicional. O adaptador R/3 possui a funcionalidade para chamar uma BAPI em um sistema R/3. O adaptador R/3 suporta a BAPI assim como qualquer mdulo de funo ativado remoto (RFC).

Copyright IBM Corp. 2006, 2009

75

BAPI ALE RFC EDI BDC

DMI

As BAPIs so acessadas no SAP R/3 verso 4.0 e superior usando o cdigo de transao BAPI. Fornecedor um Objeto de Negcios na rea de Contabilidade Financeira da Estrutura de Negcios. Expandir o Objeto de Negcios do Fornecedor expe os mtodos disponveis. ChangePassword um mtodo (BAPI) no Objeto de Negcios do Fornecedor. Esse mtodo fornece o recurso para alterar a senha de um fornecedor, selecionada pelo campo-chave VendorNo. O nome da BAPI desse mtodo localizado clicando-se na guia Detalhe. O nome da BAPI BAPI_VENDOR_CHANGE_PASSWORD, o nome que ser especificado no Importer Wizard. A caixa de dilogo tambm fornece a documentao sobre os parmetros e atributos da BAPI. Todas as BAPIs so compostas por uma combinao de parmetros de Importao, Exportao e/ou Tabela. Os parmetros de Importao so entrada; de Exportao so sada e de Tabelas so entrada/sada. Uma BAPI pode ter qualquer combinao desses tipos de parmetro. A documentao para os parmetros, as estruturas e os escalares de uma BAPI pode ser localizada no Navegador da BAPI, no Assistente SAP e no Mdulo de Funo.

Mapeamento
Por Que e Quando Desempenhar Esta Tarefa
O SAP:BAPI (Business Application Programming Interfaces) Importer um recurso para gerar automaticamente rvores do tipo que descrevam o formato de dados usados em programas BAPI no sistema SAP R/3. Depois de ter identificado uma BAPI a ser usada como a entrada de metadados para o Importer Wizard, gere a rvore do tipo e crie o mapa. Nota: As rvores do tipo construdas com o SAP:BAPI Importer no WebSphere Transformation Extender V6.5 e superior e o WebSphere Transformation Extender Pack para SAP tero as tags CDATA nas rvores. Para executar o SAP:BAPI Importer: 1. No Type Designer, selecione Importar uma rvore do tipo. Clique em OK.

76

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

2. Escolha SAP:BAPI como a estrutura para a qual voc deseja gerar uma rvore do tipo e clique em Avanar. 3. Continue a clicar em Avanar at que o campo Linha de Comandos do Adaptador aparea na janela. Insira os parmetros de conexo do adaptador no campo Linha de Comandos do Adaptador. Ou clique no boto Configurar para exibir a caixa de dilogo Configuraes da Conexo R/3 na qual possvel inserir os valores de conexo. Clique na guia Diagnsticos para ativar o Rastreio do adaptador, especificando um rastreio detalhado e um nome de arquivo de rastreio. Ao concluir, clique em OK. 4. Clique em Avanar. 5. No campo Nome do Mdulo de Funo, insira o nome de um mdulo de funo vlido no SAP; ou selecione o mdulo apropriado clicando no boto Configurar para exibir o Explorador de BAPI. Se for selecionar um mdulo BAPI Temporria BW, ative a caixa de opo BAPI Temporria BW antes de clicar no boto Configurar. Apenas os mdulos BAPI sero selecionveis na lista de mdulos no Explorador de BAPI. No Explorador de BAPI, expanda um Objeto de Negcios, selecione um mtodo e clique em OK. O mtodo aparece no campo Nome do Mdulo de Funo. 6. Clique em Avanar. 7. A janela Nome do Arquivo aberta. Insira o nome da rvore do tipo que deseja criar ou selecione um nome de arquivo. BAPI o padro da lista de menus suspensos. 8. Ao nomear a rvore do tipo, h uma opo para criar um arquivo de metadados. Ative essa opo para salvar o arquivo de metadados. Clique em Avanar. O Importer Wizard se conecta ao sistema SAP R/3 e l os parmetros de importao e exportao do mdulo de funo. Enquanto o Importer Wizard est se conectando ao Sistema SAP R/3, aparece uma mensagem e a rvore do tipo gerada.

Entendendo a rvore do Tipo BAPI


O exemplo a seguir mostra uma rvore do tipo chamada bapi_creditor_getdetail.mtt e fornece uma viso geral da correlao entre a estrutura da BAPI e a rvore do tipo gerada pelo Importer Wizard. Um exemplo est no diretrio install_dir\ examples\packs\sap_r3\r3\ERP\BAPI includo na instalao do WebSphere Transformation Extender Pack para SAP. possvel usar esses diretrios para testar o Importer Wizard. v O tipo de Grupo chamado BAPI possui um componente, que Mtodo BAPI_CREDITOR_GETDETAIL. v Contido no componente Mtodo BAPI_CREDITOR_GETDETAIL esto os Parmetros de Importao, os Parmetros de Exportao e os Parmetros de Tabelas. v Os Parmetros de Importao so os atributos de importao CREDITORID e COMPANYCODE. v Os Parmetros de Exportao so as estruturas CREDITOR_GENERAL_DETAIL, CREDITOR_COMPANY_DETAIL e RETURN. v Os Parmetros de Tabelas so compostos pela estrutura CREDITOR_BANK_DETAIL.

Captulo 8. Business Application Programming Interface (BAPI)

77

Chamando uma BAPI a partir de um Mapa


Por Que e Quando Desempenhar Esta Tarefa
Aps a gerao da rvore do tipo, crie um mapa que chame a BAPI. Para chamar uma BAPI a partir de um mapa: 1. Usando o Map Designer, crie um carto de sada que use a rvore do tipo gerada pelo Importer Wizard, incluindo regras de mapas para fornecer valores para os parmetros de importao BAPI. O objeto desse carto o objeto de grupo BAPI da raiz BOR. 2. Crie um segundo carto de sada que usar a funo GET() e uma funo RUN(). A funo GET() usada para chamar o adaptador BAPI, passando os parmetros de importao como dados ecoados e recebendo, em retorno, um blob de texto contendo a estrutura BAPI preenchida.

Resultados
O objeto de carto o objeto de grupo xBAPI da rvore do tipo BAPI. A funo RUN() usada para passar os parmetros de exportao como os dados de um carto de entrada de outro mapa. Consulte Funes e Expresses no Centro de Informaes para obter informaes adicionais sobre como usar as funes GET() e RUN(). Nota: Se os dados passados para o mapa de execuo no corresponderem definio esperada, seu processo de mapeamento no ser concludo com xito. O arquivo de rastreio dos dados de entrada ajuda a resolver problemas. Para produzir um rastreio de entrada, inclua TI nas opes da funo RUN(). LEMBRE-SE, -TI DEVE SER USADO SOMENTE PARA FINS DE DEPURAO. Nota: As rvores do tipo BAPI devem ser geradas novamente usando-se o importador R/3 BAPI. As rvores do tipo BAPI so especficas da verso SAP R/3. necessrio gerar novamente a rvore do tipo BAPI no exemplo de BAPI para executar esse mapa com xito. O mapa executado pela funo RUN() de exemplo possui um carto de entrada correspondente a outro carto de entrada para o qual o resultado da funo GET() ecoado. Alm disso, ele possui um ou mais cartes de sada que representam os dados de sada. Nota: Os exemplos de BAPI esto no diretrio examples\packs\sap_r3\r3\ERP\ BAPI includo na instalao do WebSphere Transformation Extender Pack para SAP. O exemplo de BAPI, bapi_example.mms, demonstra o mtodo para implementar um cenrio BAPI com um ambiente SAP R/3. A chamada do adaptador BAPI feita a partir de uma regra de mapa no carto de sada usando a funo GET(). Os dados retornados pela chamada BAPI podem ento ser usados para serem mapeados para qualquer sada desejada. Isso alcanado usando-se a funo RUN() para passar os dados para o segundo mapa.

78

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Unicode
O adaptador JBAPI baseia-se em JCo, a API Java do SAP e totalmente compatvel com o adaptador BAPI atual. O adaptador JBAPI suporta toda a funcionalidade do adaptador BAPI e fornece suporte completo ao Unicode.

Pr-requisitos
Para usar o adaptador JBAPI, a presena dos arquivos a seguir necessria na varivel de ambiente PATH. WIN: librfc32.dll, sapjcorfc.dll UNIX: librfccm.so, libsapjcorfc.so Alm disso, necessrio especificar sapjco.jar na varivel de ambiente CLASSPATH. Consulte o arquivo readme_sap.txt para obter detalhes adicionais.

Captulo 8. Business Application Programming Interface (BAPI)

79

80

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Captulo 9. Resoluo de Problemas


As sees a seguir explicam vrias ferramentas de resoluo de problemas que esto disponveis quando voc encontra problemas ao usar objetos SAP R/3 como origens ou destinos de dados para um mapa. Os mtodos de visualizao de dados extrados de um sistema SAP R/3 ou carregados em um sistema SAP R/3 tambm so apresentados. v Ferramentas de Resoluo de Problemas v Log MapAudit v Arquivos de Auditoria do Adaptador R/3 v Arquivos de Rastreio do Adaptador R/3 v Cdigos de Retorno e Mensagens de Erro do R/3 v Visualizando Dados de Origem e de Destino do R/3 v Dados Temporrios Restantes no Diretrio TIDDATA

Ferramentas de Resoluo de Problemas


Se voc receber um erro ao gerar uma rvore do tipo no Assistente do Importador, ou executar uma mapa que usa origens e/ou destinos e receber um erro de tempo de execuo ou no obter a sada esperada, use qualquer uma ou todas as seguintes ferramentas de resoluo de problemas: v Log de Auditoria do Mapa (map_name.log) v Arquivo de Rastreio de Execuo do Mapa (map_name.mtr) v Dados de Origem e de Destino do Mapa v Arquivo de Auditoria do Adaptador R3 (m4r3adapter.log) v Arquivo de Rastreio do Adaptador R3 (m4r3adapter.mtr)

Log MapAudit
Se o problema encontrado foi o resultado da execuo de um mapa com origens ou destinos, voc poder produzir a seo Execuo do Log de Auditoria. Os logs MapAudit podem ser ativados a partir da caixa de dilogo MapSettings no Map Designer, Integration Flow Manager ou servidor de transformao baseado no Windows ou a partir da linha de comandos. Consulte Map Designer ou Servidor de Comandos no Centro de Informaes para obter informaes sobre como ativar o log de execuo a partir da caixa de dilogo MapSettings. Consulte o Comando de Execuo no Map Designer para obter informaes sobre como usar um comando de execuo. O nome padro para o log de auditoria o nome completo do mapa com uma extenso .log. Por padro, ele est localizado no mesmo diretrio que o arquivo de mapeamento compilado. O MapAudit pode conter quatro sees diferentes: BurstAudit, SummaryAudit, SettingsAudit e AuditLocation. As sees produzidas dependem das configuraes de Log para MapAudit.

Copyright IBM Corp. 2006, 2009

81

Log de Dados
As informaes na seo Log de Dados do MapAudit so configurveis usando a guia Configuraes de Auditoria de Dados no Organizador. Consulte Map Designer no Centro de Informaes sobre como configurar essas opes e interpretar as informaes no Log de Dados.

Auditoria de Execuo
Quando a configurao Log de Execuo configurada como ATIVO, o log MapAudit contm uma entrada ExecutionLog para cada burst no mapa. A seo ExecutionSummary fornece um resumo dos cdigos de retorno, origens, destinos e reas de trabalho para o mapa.

ExecutionLog por Burst


Quando a configurao Log de Dados ou Log de Execuo configurada como ATIVO, o log MapAudit contm uma seo para cada burst no mapa. Se todas as entradas tiverem um CardMode de Integral, haver uma nica seo Burst. A seo ExecutionLog identifica o cdigo de retorno e o tempo decorrido para o burst, assim como o status de cada entrada ou sada, incluindo um cdigo de retorno do adaptador e um cdigo de retorno do contedo.

ExecutionSummary por Mapa


O ExecutionSummary fornece informaes no nvel do mapa. O log de execuo pode fornecer informaes de depurao de alto nvel, incluindo: v Cdigo de retorno e mensagem do mapa: O cdigo de retorno e a mensagem do mapa indicam como a operao de mapeamento foi concluda e se houve quaisquer problemas. Por exemplo, um cdigo de retorno do mapa de 0 e uma mensagem Mapa concludo com xito indicam que nenhum erro de execuo foi encontrado. Essas informaes ajudam a analisar as informaes de origem nesse log. v SourceReport e TargetReport: Para cada origem ou destino, o ExecutionSummary inclui informaes que indicam o adaptador, o tamanho dos dados para a origem ou o destino, o cdigo de retorno e a mensagem do adaptador, etc. v WorkArea: Para cada entrada ou sada para a qual uma WorkArea criada, o ExecutionSummary inclui informaes como, por exemplo, o local e o tamanho. O log de execuo um bom local para iniciar ao diagnosticar problemas de execuo do mapa porque voc pode determinar rapidamente as origens ou os destinos em erro. Depois, usando as informaes no log, voc pode produzir informaes de resoluo de problemas mais detalhadas apenas para as origens ou os destinos que encontraram problemas.

Configuraes do Mapa
As configuraes do mapa no Map Designer contm uma lista de todas as MapSettings, incluindo as configuraes para MapAudit, MapTrace, rea de Trabalho, Sculo, Validao, Tentar Novamente e Avisos.

82

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Essas informaes podem ser teis durante a depurao para determinar por que a execuo ocorreu de uma determinada maneira.

Configuraes de Dados
As configuraes de dados para cartes de entrada e sada no arquivo de origem do mapa no Map Designer contm uma lista de todas as configuraes de InputData e OutputData, incluindo FetchAs, WorkArea, Backup, PUT Destino Comando, GET Origem Comando, OnSuccess, OnFailure, Tentar Novamente, Escopo, FetchUnit, etc. Essas informaes podem ser teis durante a depurao para identificar se os dados devem ser copiados para um arquivo de backup, se as mudanas em um destino devero ser confirmadas se o mapa falhar, etc.

Arquivos de Auditoria do Adaptador R/3


Informaes adicionais sobre resoluo de problemas e diagnstico esto disponveis no arquivo de auditoria do adaptador R/3. Especifique o comando de adaptador -AR3 para criar um arquivo que grave a atividade do adaptador para cada atividade de objeto SAP R/3 especificada. Esse comando pode ser usado para uma origem ou um destino, ou em uma funo GET ou PUT. Esse comando do adaptador pode ser especificado para cartes de entrada e sada individuais em uma base carto por carto. O padro produzir um arquivo chamado m4r3adapter.log no diretrio em que o mapa est localizado, em que adapter o tipo de adaptador, como ALE e BAPI. Opcionalmente, voc pode anexar as informaes de auditoria a um arquivo existente ou especificar um nome ou o caminho completo para o arquivo.

Arquivos de Rastreio do Adaptador R/3


O uso das informaes contidas nos arquivos de rastreio do adaptador R/3 (m4r3adapter.mtr) uma das principais ferramentas que podem ser usadas para ajudar na resoluo de problemas. Esses arquivos contm informaes detalhadas geradas durante a execuo do mapa. O arquivo de rastreio produzido no tempo de execuo do mapa grava informaes detalhadas sobre a atividade do adaptador R/3, como objetos recuperados, atividade de origem e destino de dados, etc. Para produzir informaes de rastreio para origens ou destinos de dados R/3 especficos, use o comando do adaptador Rastreio (-T). Para obter informaes sobre a sintaxe do comando do adaptador Rastreio. Por exemplo, para produzir um rastreio do adaptador, inclua o comando do adaptador -T na configurao Origem Comando ou Destino Comando ou use-o com o comando de execuo apropriado na linha de comandos. Com esse comando do adaptador, as informaes de rastreio so geradas no arquivo .mtr.

Captulo 9. Resoluo de Problemas

83

Rastreio do Adaptador R/3 - Opo Detalhado


Quando o comando Rastreio especificado, h vrias opes que podem ser usadas, incluindo a opo Detalhado (V), que grava informaes de rastreio detalhadas.

Cdigos de Retorno e Mensagens de Erro do R/3


A seguir est uma listagem de todos os cdigos e mensagens que podem ser retornados como resultado do uso do adaptador R/3 para origens ou destinos. Nota: Os cdigos de retorno do adaptador com nmeros positivos so cdigos de aviso que indicam uma operao bem-sucedida. Os cdigos de retorno do adaptador com nmeros negativos so cdigos de erro que indicam uma operao falha.
Tabela 8. Cdigos de retorno e mensagens de erro do adaptador R/3 Cdigo de Retorno 0 1 2 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 Mensagem OK Nenhum dado fornecido. Criao no contedo especificado: nenhuma tentativa de conexo. Falha na execuo do mapa, dados no-enviados Erro em prep. de dados Erro: no possvel obter a definio da funo Falha de abertura de RFC Falha de colocao de Dados Erro Desconhecido Erro na configurao TID enviou duas vezes, portanto no foi processado O R/3 pode tentar novamente mais tarde No foi possvel inicializar o adaptador. New_semaphore() falhou. No foi possvel inicializar o adaptador. Contagem de observaes excedida. No foi possvel inicializar o watchpoint. New_thread() falhou. Erro em prep. de dados (Idocs invlidos). Erro em prep. de dados (dados BAPI invlidos ou EDI_DC ausente no Idoc) Falha no teste de conexo O teste de conexo no possvel, o identificador invlido Falha de aceitao de RFC Falha de funo de instalao Falha de InitRfcConn XXXXX = FAILURE(0) Para APIs que retornam no-zero no sucesso. -? XXXXX = FAILURE(?) Para APIs que retornam no-zero no sucesso.

84

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Tabela 8. Cdigos de retorno e mensagens de erro do adaptador R/3 (continuao) Cdigo de Retorno -1 -2 -3 -4 -5 Mensagem XXXXX = RFC_FAILURE: Ocorreu um erro. XXXXX = RFC_EXCEPTION: Uma exceo foi emitida. XXXXX = RFC_SYS_EXCEPTION: Exceo do sistema emitida, conexo encerrada.; XXXXX = RFC_CALL: Chamada recebida. XXXXX = RFC_INTERNAL_COM: Comunicao interna, repetir Apenas para uso interno. -6 -7 -8 -9 -10 -10 -11 -12 -13 XXXXX = RFC_CLOSED: Conexo encerrada pelo outro lado. XXXXX = RFC_RETRY: Nenhum dado ainda (apenas RfcListen ou RfcWaitForRequest). XXXXX = RFC_NO_TID: Nenhum ID de Transao disponvel. XXXXX = RFC_EXECUTED: Funo j executada. XXXXX = RFC_SYNCHRONIZE: Chamada Sncrona em Andamento (apenas para Windows).; Conexo invlida, falha de RFCPING; consulte o arquivo de rastreio para obter detalhes. XXXXX = RFC_MEMORY_INSUFFICIENT: Memria insuficiente. XXXXX = RFC_VERSION_MISMATCH: Incompatibilidade de verso. XXXXX = RFC_NOT_FOUND: Funo no-localizada. Apenas para uso interno. -14 -15 -16 -? -? XXXXX -464 -600 -1000 -2000 XXXXX = RFC_CALL_NOT_SUPPORTED: Esta chamada no suportada no WINDOWS. XXXXX = RFC_NOT_OWNER: O responsvel pela chamada no possui o identificador especificado. XXXXX = RFC_NOT_INITIALIZED: RFC no inicializada ainda. XXXXX = RFC_UNKNOWN: Cdigo de resultado desconhecido ?. um cdigo de erro especfico da API, torna-se negativo se >0 uma Funo Mgmt da API SAP ou do TID Falha na inicializao. (A verificao de integridade falhou) Erro Interno: Erro do gerenciador de recursos Falha na inicializao. (Argumentos de programa) Falha na inicializao. (Inicializao de backup/log)

Visualizando Dados de Origem e de Destino do R/3


Ao depurar um mapa que usa origens ou destinos do SAP R/3, no possvel visualizar os dados de origem ou de destino no Map Designer selecionando os Resultados da Execuo no menu Visualizar. No entanto, possvel capturar os dados que foram recuperados ou gravados em um objeto SAP R/3 para fins de depurao usando as configuraes de Backup.

Captulo 9. Resoluo de Problemas

85

Configuraes de Backup
As configuraes de backup so usadas para determinar quando, onde e como os dados de um carto especfico devem ser copiados para um arquivo de backup especificado. Essas configuraes so definidas em Configuraes de Carto, Entrada e Sada, no Map Designer e no Launcher ou em Configuraes de Comando no Integration Flow Manager. Nota: Consulte as informaes do Map Designer no Centro de Informaes para obter informaes adicionais sobre as configuraes de Backup.

Dados Temporrios Restantes no Diretrio TIDDATA


O adaptador usa o diretrio tiddata internamente para colocar arquivos intermedirios. Esse diretrio colocado no $MERC_TMP_DIR/tiddata para todas as plataformas UNIX.

86

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Captulo 10. WebSphere SAP QISS Adapter


WebSphere Adapters
Use os WebSphere Adapters para se comunicar com o Enterprise Information Systems (EIS). Os termos a seguir esto associados aos WebSphere Adapters: EIS Enterprise Information Systems. Esse termo usado para descrever sistemas, como o Enterprise Resource Planning (ERP) e o Customer Relationship Management (CRM). Enterprise Metadata Discovery. Uma especificao que pode ser usada para examinar um EIS e obter detalhes de estruturas de dados do objeto de negcios e APIs. Um EMD armazena as definies como esquemas XML por padro, e constri componentes que podem acessar o EIS. No WebSphere Transformation Extender, voc usa um importador para examinar um EIS. O EMD tambm pode ser conhecido como ESD (Enterprise Service Discovery) ou ODA (Object Discovery Agent).

EMD

Objeto de Negcios Um conjunto de atributos que representa uma entidade de negcios (como Funcionrio), uma ao nos dados (como uma operao de criao ou de atualizao) e instrues para processamento dos dados. Os componentes do sistema de integrao de negcios usam objetos de negcios para trocar informaes e emitir aes. Os WebSphere Adapters suportam dois modos de comunicao: v Entrada: Um evento gerado no EIS e o adaptador responde ao evento enviando uma mensagem para o Launcher. Os WebSphere Adapters suportam comunicao de entrada. Quando o EIS envia um evento para o adaptador, um evento acionado. v Sada: O mapa usa o adaptador para enviar um pedido para o EIS. Os WebSphere Adapters suportam comunicao de sada. Quando um WebSphere Adapter chamado a partir de um carto de sada, o adaptador envia um pedido para o EIS. Os mapas do WebSphere Transformation Extender precisam de um componente adaptador para acessar o EIS. Os cartes de entrada precisam de um componente adaptador de entrada, que permite que o EIS chame o fluxo de mensagens quando ocorre um evento. Os cartes de sada precisam de um componente adaptador de sada, que usado pelo mapa para chamar um servio no EIS. Os WebSphere Adapters tambm precisam de um conjunto de mensagens para garantir que as mensagens do mapa do WebSphere Transformation Extender propagadas de e para os cartes reflitam a estrutura lgica dos dados no EIS.

Antes de Comear
Antes de comear a configurar e usar o adaptador, necessrio ter um conhecimento completo dos conceitos de integrao de negcios, dos recursos e requisitos das ferramentas de desenvolvimento de integrao e do ambiente de tempo de execuo que ser usado, alm do ambiente do servidor SAP em que a soluo ser construda e usada.
Copyright IBM Corp. 2006, 2009

87

Para configurar e usar o WebSphere Adapter para SAP, necessrio entender e ter experincia com os seguintes conceitos, ferramentas e tarefas: v Os requisitos de negcios para a soluo que voc est construindo. v Os recursos fornecidos pelas ferramentas de desenvolvimento de integrao que voc utilizar para construir a soluo. necessrio saber usar essas ferramentas para criar mapas, testar componentes e concluir outras tarefas de integrao. v Os recursos e requisitos do ambiente de tempo de execuo que voc pretende utilizar para a soluo de integrao. Voc deve saber como configurar e administrar o servidor host e como utilizar o console administrativo para configurar e modificar definies de propriedade, configurar conexes e gerenciar eventos. v O ambiente do servidor SAP onde est trabalhando. Isso inclui um entendimento detalhado da interface grfica com o usurio do SAP, funes ativadas pela RFC (como BAPIs) e IDocs da ALE.

Viso Geral do WebSphere Adapter para SAP Software


O WebSphere Adapter para SAP Software fornece uma maneira de criar processos integrados que incluem a troca de informaes com um servidor SAP. Usando o adaptador, o WebSphere Transformation Extender pode enviar pedidos para o servidor SAP (por exemplo, para consultar um registro do cliente em uma tabela do SAP ou para atualizar um documento do pedido) ou receber eventos do servidor (por exemplo, ser notificado de que um registro de cliente foi atualizado). O adaptador cria uma interface padro para os aplicativos e dados no servidor SAP para que o WebSphere Transformation Extender no tenha que entender os detalhes de nvel inferior (a implementao do aplicativo ou das estruturas de dados) no servidor SAP. O WebSphere Adapter para SAP Software compatvel com a Java Connector Architecture (JCA). A JCA padroniza a maneira com que componentes de aplicativos, servidores de aplicativos e sistemas de informaes corporativos, como o servidor SAP, interagem entre si. O adaptador, configurado com o Importer Wizard do WebSphere Transformation Extender, usa uma interface padro e objetos de dados padro. O adaptador usa o objeto de dados padro enviado pelo WebSphere Transformation Extender e chama a funo SAP. O adaptador retorna ento um objeto de dados padro para o WebSphere Transformation Extender. O WebSphere Transformation Extender no precisa lidar diretamente com a funo do SAP; o adaptador SAP que chama a funo e retorna os resultados. Por exemplo, um mapa que precisasse da lista de clientes enviaria um objeto de negcios padro com um intervalo de IDs de cliente para o adaptador SAP. O componente de aplicativo receberia, em retorno, os resultados (a lista de clientes) na forma de um objeto de negcios padro. O mapa no precisaria saber como a funo trabalhou ou como os dados foram estruturados. O adaptador executaria todas as interaes com a funo SAP real. Da mesma forma, possvel que um mapa quisesse saber sobre uma mudana nos dados no servidor SAP (por exemplo, uma mudana em um determinado cliente). possvel configurar um adaptador para atender esses eventos no servidor SAP e notificar os mapas com a atualizao. Neste caso, a interao comea no servidor SAP.

88

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Viso Geral Tcnica do Software Adapter para SAP


O WebSphere Adapter para SAP Software se conecta a sistemas SAP em execuo nos Servidores de Aplicativos da Web do SAP. O adaptador suporta o SAP Query Interface (SQI) para processamento de sada. Voc configura o adaptador para executar processamento de sada usando a descoberta de servio corporativo para gerar objetos de negcios com base nos servios descobertos no servidor SAP. O adaptador usa a API do SAP Java Connector (SAP JCo) para se comunicar com aplicativos SAP.

Importador SAP
Use o Importer Wizard do WebSphere Transformation Extender para configurar o adaptador. O assistente estabelece conexo com o servidor SAP, descobre servios (com base nos critrios de procura fornecidos) e gera objetos de negcios e interfaces com base nos servios descobertos. Usando o WebSphere Transformation Extender, voc estabelece uma conexo com o servidor SAP para navegar pelo repositrio de metadados no servidor SAP. O repositrio de metadados do SAP, que um banco de dados dos dados do SAP, fornece um meio consistente e confivel de acesso a esses dados. Voc especifica informaes de conexo (tais como o nome de usurio e a senha necessrios para acessar o servidor, conforme mostrado na figura a seguir) e especifica a interface que deseja usar (por exemplo, QISS). Os metadados de servio associados a essa interface so exibidos. Em seguida, possvel fornecer critrios de procura e selecionar as informaes. O resultado da execuo do Importer Wizard do WebSphere Transformation Extender um mapa que contm as interfaces e os objetos de negcios juntamente com o adaptador.

A Interface SQI
A Query interface for SAP Software (QISS) fornece o meio para recuperar dados de tabelas de aplicativos em um servidor SAP ou para consultar tabelas de aplicativos SAP durante a existncia dos dados. O adaptador pode executar recuperao de dados hierrquicos das tabelas de aplicativos do SAP. A Query interface for SAP Software suporta interaes de sada apenas para operaes de leitura (RetrieveAll e Exists). possvel usar essa interface em transaes locais para procurar registros antes das operaes de gravao (Criar, Atualizar ou Excluir). Por exemplo, voc poderia usar a interface como parte de uma transao local para realizar uma verificao de existncia em um cliente antes de criar uma ordem de vendas. Tambm possvel usar a interface em cenrios de no-transao. A Query interface for SAP Software suporta recuperao de dados de tabelas de aplicativos SAP, incluindo a recuperao de dados hierrquicos de vrias tabelas. A interface suporta especificao esttica, assim como dinmica, de clusulas where para as consultas. O assistente de Conexo do Adaptador localiza as tabelas de dados do aplicativo no SAP, interpreta o relacionamento hierrquico entre as tabelas e constri uma representao das tabelas e seus relacionamentos na forma de um objeto de negcios. O assistente tambm constri uma clusula where padro para a consulta.

Captulo 10. WebSphere SAP QISS Adapter

89

possvel controlar a profundidade da recuperao de dados, assim como a quantidade de informaes, usando as propriedades maxRow e rowSkip. Para obter informaes adicionais, consulte os tpicos a seguir. v Processamento de Sada da Query interface for SAP Software v Objetos de Negcios: Processamento de Sada da Query interface for SAP Software: A Query interface for SAP Software usada apenas para processamento de sada. Nota: O aplicativo cliente que faz o pedido usa as informaes da interface que foram geradas pelo Importer Wizard do WebSphere Transformation Extender. As etapas a seguir descrevem como o adaptador suporta o processamento de sada da interface SQI. 1. O adaptador recebe um pedido, que inclui um objeto da tabela, de um aplicativo cliente. 2. O adaptador determina, a partir do objeto de tabela enviado com a consulta, o nome da tabela a ser examinada. 3. O adaptador determina as colunas a serem recuperadas ou examinadas. 4. O adaptador determina as linhas a serem recuperadas ou examinadas. 5. O adaptador responde. v No caso de uma operao RetrieveAll, o adaptador retorna os dados. v Se no existirem dados, o adaptador ir gerar uma exceo. Objetos de Negcios:: Um grfico de negcios SQI, que age como a entrada para a interface SQI, consiste em um objeto de negcios de tabela e um verbo. O objeto de negcios de tabela representa as colunas em uma tabela no servidor SAP. O verbo suportado para um grfico de negcios SQI RetrieveAll. Um exemplo de grfico de negcios associado a um objeto de negcios de tabela mostrado na figura a seguir. O objeto de negcios de tabela contm colunas selecionadas na tabela SAP especificada. Um exemplo de objeto de negcios de tabela (representando a tabela KNA1) mostrado na figura a seguir. Alm das informaes da coluna, o objeto de negcios de tabela tambm contm um objeto de negcios de consulta como o ltimo parmetro. O objeto de negcios de consulta semelhante a isto: As tabelas podem ser modeladas como objetos de negcios hierrquicos. Voc especifica o relacionamento pai-filho das tabelas ao selecionar os objetos de negcios durante o processo de descoberta de metadados corporativos. As tabelas so vinculadas por uma chave estrangeira para formar relacionamentos pai-filho. O objeto de negcios de tabela-filho possui uma chave estrangeira que faz referncia a uma propriedade no objeto de negcios de consulta pai.

90

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

No objeto de negcios KNA1, observe a referncia a SapAdrc, um objeto de negcios filho. O objeto da tabela SapAdrc, mostrado na figura a seguir, possui uma coluna chamada AddressNumber. Essa coluna possui uma propriedade associada (ForeignKey) que contm uma referncia ao objeto de negcios pai. possvel ver a propriedade clicando em AddressNumber e observando a guia Propriedades.A propriedade ForeignKey contm uma referncia coluna Endereo do objeto da tabela SapKna1. O retorno da chamada Query interface for SAP Software de uma operao RetrieveAll um continer de grficos de negcios ou um continer de objetos de tabela. Selecionando Objetos de Negcios e Servios: Para especificar quais dados voc deseja consultar, fornea informaes no Importer Wizard do WebSphere Transformation Extender. Antes de Iniciar Certifique-se de ter configurado as propriedades de conexo para o Importer Wizard do WebSphere Transformation Extender. Por Que e Quando Desempenhar Esta Tarefa Especifique critrios de procura usados pelo Importer Wizard do WebSphere Transformation Extender para consultar dados no servidor SAP. O Importer Wizard do WebSphere Transformation Extender retorna os dados que atendem aos critrios de procura. possvel usar as tabelas descobertas para gerar objetos individuais (objetos que no possuem nenhum relacionamento entre si) ou para gerar objetos que possuem uma estrutura hierrquica. v Se estiver gerando objetos individuais, no ser possvel importar um ou mais objetos da lista de tabelas descobertas ao mesmo tempo. v Se estiver gerando objetos hierrquicos, ser necessrio importar primeiro as tabelas-pai e, em seguida, importar as tabelas-filho. Ao configurar as tabelas-filho para importao, voc pode selecionar a tabela-pai importada anteriormente como seu pai. Repita este processo para incluir mais tabelas na estrutura hierrquica. O objeto hierrquico com trs nveis, por exemplo, necessita de trs importaes separadas para estabelecer o relacionamento pai/filho. Para especificar os critrios de procura, use o procedimento a seguir. 1. Na janela Descoberta e Seleo de Objetos, indique com qual tabela ou tabelas deseja trabalhar. a. Clique em QISS para ativar o boto de filtro. b. Clique no boto de filtro. Nota: Em vez de usar o recurso de filtro, possvel expandir QISS e selecionar a tabela na lista. 2. Na janela Propriedades do Filtro, especifique informaes sobre a tabela. a. Selecione Descobrir objetos pelo nome ou Descobrir objetos pela descrio na lista Atributo de objeto a ser usado para a descoberta. b. Digite uma cadeia de procura (por exemplo, KN*) que represente a tabela.
Captulo 10. WebSphere SAP QISS Adapter

91

Este o nome da tabela no SAP mais um asterisco como caractere curinga para indicar que voc deseja uma lista de todos os componentes de aplicativo do SAP iniciados com KN. c. Indique o nmero de objetos que deseja que sejam retornados alterando o valor no campo Nmero Mximo de Objetos a Serem Recuperados ou aceitando o valor-padro. d. Clique em OK. 3. Selecione os objetos da tabela. a. Expanda QISS (filtrado). b. Clique no objeto da tabela que deseja usar. c. Clique no boto de seta para incluir o objeto da tabela na lista Objetos Selecionados. 4. Na janela Propriedades de Configurao da table, fornea informaes sobre a tabela: a. O campo Incluir uma Clusula WHERE especifica a chave principal para a tabela. fornecido um valor-padro. Altere esse valor se quiser usar uma chave principal diferente. No exemplo da tabela KNA1 mostrada na figura a seguir, o valor-padro KUNNR = /CustomerNumber1. O campo KUNNR uma das chaves principais na tabela KNA1. A consulta WHERE retornar informaes com base no nmero de cliente fornecido na consulta. b. Selecione, opcionalmente, a caixa de opo Usar Nomes do Campo SAP para Gerar Nomes de Atributos. Por padro (quando a caixa de opo no est selecionada), as descries de campo so usadas para gerar propriedades. c. Indique quais colunas voc deseja incluir na consulta. Observe que, no exemplo da tabela KNA1 mostrada na figura a seguir, h vrias colunas e, por padro, todas elas esto selecionadas. possvel limpar o visto das colunas que voc no deseja incluir, ou, se quiser selecionar apenas algumas delas, poder usar a caixa de opo Selecionar ou desmarcar todas as colunas. Por exemplo, se quiser apenas duas colunas, limpe Selecionar ou desmarcar todas as colunas para remover o visto de todas as colunas e, em seguida, selecione as duas colunas desejadas. d. Clique em OK 5. Para incluir outra tabela na consulta, execute as seguintes tarefas: a. Clique em QISS para ativar o boto de filtro. b. Clique no boto de filtro. Nota: Em vez de usar o recurso de filtro, possvel expandir QISS e selecionar a tabela na lista. 6. Na janela Propriedades do Filtro, especifique informaes sobre a tabela. a. Selecione Descobrir objetos pelo nome ou Descobrir objetos pela descrio na lista Atributo de objeto a ser usado para a descoberta. b. Digite uma cadeia de procura (por exemplo, ADRC) que represente a tabela. c. Indique o nmero de funes que deseja que sejam retornadas alterando o valor no campo Nmero Mximo de Objetos a Serem Recuperados ou aceitando o valor-padro. d. Clique em OK. 7. Selecione os objetos da tabela.

92

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

a. Expanda QISS (filtrado). b. Clique no segundo objeto da tabela. c. Clique no boto de seta para incluir o objeto da tabela na lista Objetos Selecionados. 8. Na janela Propriedades de Configurao da table, fornea informaes sobre a tabela: a. O campo Incluir uma Clusula WHERE especifica a chave principal para a tabela. fornecido um valor-padro. Altere esse valor se quiser usar uma chave principal diferente. b. Selecione, opcionalmente, a caixa de opo Usar Nomes do Campo SAP para Gerar Nomes de Atributos. Por padro (quando a caixa de opo no est selecionada), as descries de campo so usadas para gerar propriedades. c. Associe essa tabela quela includa anteriormente (KNA1, no exemplo) selecionando-a na seo Selecionar uma Tabela-pai da janela. d. Em Mapear as colunas-chave principais para as colunas de referncia de chave estrangeira da tabela-pai, selecione um valor para vincular as tabelas. Por exemplo, possvel selecionar ADRNR para ADDRNUMBER. e. Indique quais colunas voc deseja incluir na consulta. f. Clique em OK 9. Clique em Avanar. Resultados O Importer Wizard do WebSphere Transformation Extender retorna os dados que correspondem aos critrios de procura. O que Fazer Depois Na janela Configurar Propriedades Compostas, especifique, opcionalmente, um espao de nomes e um diretrio no qual o objeto de negcios gerado ser armazenado e indique se deseja gerar um grfico de negcios.

Preparando o Ambiente para os WebSphere Adapters


Antes de usar os WebSphere Adapters, necessrio configurar o ambiente de tempo de execuo do WebSphere Transformation Extender para que seja possvel acessar o Enterprise Information System (EIS).

Por Que e Quando Desempenhar Esta Tarefa


Para ativar os WebSphere Adapters no tempo de execuo do WebSphere Transformation Extender, configure o WebSphere Transformation Extender com o local dos arquivos jar e das bibliotecas nativas do provedor EIS. Os WebSphere Adapters precisam de bibliotecas dos fornecedores EIS. Para obter informaes adicionais sobre como obter e usar essas bibliotecas, consulte a documentao dos WebSphere Adapters.

O que Fazer Depois


Quando tiver configurado o ambiente para os WebSphere Adapters, poder executar as tarefas preparatrias listadas em Desenvolvendo Mapas Usando o WebSphere Adapters na pgina 104.
Captulo 10. WebSphere SAP QISS Adapter

93

Propriedades de Conexo do SAP para o Assistente de Conexo do Adaptador


As propriedades de conexo estabelecem uma conexo entre o assistente de Conexo do Adaptador, uma ferramenta usada para criar objetos de negcios, e o servidor SAP. As propriedades configuradas no assistente de Conexo do Adaptador especificam coisas, como configurao de conexo, propriedades bidi e opes de rastreio e de criao de log. Depois que uma conexo entre o assistente de Conexo do Adaptador e o servidor SAP estabelecida, o assistente de Conexo do Adaptador pode acessar os metadados necessrios a partir do servidor SAP para criar objetos de negcios. Algumas das propriedades configuradas no assistente de Conexo do Adaptador so usadas como o valor inicial para o adaptador de recursos, o connection factory gerenciado e as propriedades de especificao de ativao que podem ser especificadas posteriormente no assistente. As propriedades de conexo e suas finalidades so descritas na tabela a seguir. Uma descrio completa de cada propriedade fornecida nas sees que seguem a tabela.
Tabela 9. Propriedades de conexo do Adapter para SAP Software Nome da Propriedade Direo Bidi na pgina 95 Esquema de ordem de Bidi na pgina 96 Formato numrico Bidi na pgina 96 Formato Bidi na pgina 96 Troca simtrica Bidi na pgina 97 Descrio O componente de orientao da especificao do formato bidi. O esquema de ordenao da especificao do formato bidi. O componente de forma numrica da especificao do formato bid. O componente de forma da especificao do formato bidi. O componente de troca simtrica da especificao do formato bid.

Propriedades de Conexo do SAP para o Essa propriedade o nmero do cliente do sistema SAP com o qual o Assistente de Conexo do Adaptador adaptador se conecta. Propriedades de Conexo do SAP para o Indica o identificador numrico da pgina de cdigos. Assistente de Conexo do Adaptador Propriedades de Conexo do SAP para o Configura o caminho local qualificado para a pasta onde os arquivos de Assistente de Conexo do Adaptador rastreio de RFC so gravados. Propriedades de Conexo do SAP para o Especifica o endereo IP ou o nome do host do servidor de aplicativos Assistente de Conexo do Adaptador no qual o adaptador efetua logon. Propriedades de Conexo do SAP para o Essa propriedade especifica o idioma em que o adaptador efetua logon. Assistente de Conexo do Adaptador Propriedade de Local de Sada do Arquivo de Log na pgina 97 Propriedade de Nvel de Criao de Log na pgina 98 Essa propriedade especifica o local do arquivo de log para a descoberta de metadados corporativos. Essa propriedade especifica o tipo de erro para o qual a criao de log ocorrer durante

Propriedades de Conexo do SAP para o Essa propriedade a senha da conta do usurio do adaptador no Assistente de Conexo do Adaptador servidor SAP. Propriedades de Conexo do SAP para o Essa propriedade especifica o nvel de rastreio global. Assistente de Conexo do Adaptador Propriedades de Conexo do SAP para o Especifica se necessrio gerar um arquivo de texto que detalha a Assistente de Conexo do Adaptador atividade do RFC para cada listener de eventos.

94

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Tabela 9. Propriedades de conexo do Adapter para SAP Software (continuao) Nome da Propriedade Descrio

Propriedades de Conexo do SAP para o Indica a interface SAP a ser usada. Assistente de Conexo do Adaptador na pgina 94 Propriedades de Conexo do SAP para o Essa propriedade o nmero do sistema do servidor de aplicativos. Assistente de Conexo do Adaptador na pgina 94 Propriedades de Conexo do SAP para o Essa propriedade a conta do usurio para o adaptador no servidor Assistente de Conexo do Adaptador na SAP. pgina 94

O assistente de Conexo do Adaptador usa as propriedades da conexo bidirecional para aplicar a transformao bidirecional apropriada aos dados passados para o servidor SAP. As propriedades bidi especificam o formato bidirecional dos dados vindos de um aplicativo externo para o adaptador na forma de qualquer objeto de negcios suportado por este adaptador. Voc deve aceitar os valores-padro para as propriedades de formatao bidirecional no assistente de Conexo do Adaptador fornecendo a especificao de formato bidirecional do servidor SAP. Quando combinado, essas propriedades bidirecionais definem um nico formato bidirecional. Os valores-padro das propriedades de formatao bidirecional listadas a seguir baseiam-se na formatao bidirecional do Windows. Se o sistema de informaes corporativo suportar um formato bidirecional diferente do formato bidirecional padro do Windows, voc dever fazer mudanas apropriadas nas propriedades bidi listadas a seguir.

Direo Bidi
Essa propriedade especifica o componente de orientao da especificao do formato bidi.
Tabela 10. Detalhes da direo bidi Necessrio Valores Possveis No Os valores possveis so: v LTR A orientao esquerda--direita v RTL A orientao direita--esquerda v contextualLTR A orientao esquerda--direita por causa do contexto v contextualRTL A orientao direita--esquerda por causa do contexto Padro Tipo de Propriedade Utilizao LTR String Especifica o componente de orientao da especificao do formato bidi.

Captulo 10. WebSphere SAP QISS Adapter

95

Tabela 10. Detalhes da direo bidi (continuao) Globalizado Bidirecional Suportado Sim No

Esquema de ordem de Bidi


Essa propriedade especifica o esquema de ordenao da especificao do formato bidi.
Tabela 11. Detalhes do esquema de ordenao bidi Necessrio Valores Possveis Padro Tipo de Propriedade Utilizao Globalizado Bidirecional Suportado No Implcito Visual Implicit String Especifica o esquema de ordenao da especificao do formato bidi. Sim No

Formato numrico Bidi


Essa propriedade especifica o componente de forma numrica da especificao do formato bidi.
Tabela 12. Detalhes numricos bidi Necessrio Valores Possveis No Nominal Nacional Contextual Nominal String Especifica o componente de forma numrica da especificao do formato bidi. Sim No

Padro Tipo de Propriedade Utilizao Globalizado Bidirecional Suportado

Formato Bidi
Essa propriedade especifica o componente de forma da especificao do formato bidi.
Tabela 13. Detalhes da forma bidi Necessrio No

96

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Tabela 13. Detalhes da forma bidi (continuao) Valores Possveis Nominal Formado Inicial Centro Final Isolado Nominal String Especifica o componente de forma da especificao do formato bidi. Sim No

Padro Tipo de Propriedade Utilizao Globalizado Bidirecional Suportado

Troca simtrica Bidi


Essa propriedade especifica o componente de troca simtrica da especificao do formato bidi.
Tabela 14. Detalhes da troca simtrica bidi Necessrio Valores Possveis Padro Tipo de Propriedade Utilizao Globalizado Bidirecional Suportado No True Falso True Booleano Essa propriedade especifica o componente de troca simtrica da especificao do formato bidi. Sim No

Propriedade de Local de Sada do Arquivo de Log


Essa propriedade especifica o local do arquivo de log para a descoberta de metadados externos.
Tabela 15. Detalhes do local de sada do arquivo de log Necessrio Padro Tipo de Propriedade Utilizao Sim O diretrio .metadata da rea de trabalho. String

Use esse diretrio para receber o arquivo de log que listar os erros ocorridos durante o processo de descoberta. O tipo de erros de descoberta para o qual a criao de log ocorre controlado pela propriedade Nvel de criao de log

Exemplo Globalizado

C:\IBM\wmbt61\workspace\.metadata\SAPMetadataDiscovery.log Sim
Captulo 10. WebSphere SAP QISS Adapter

97

Tabela 15. Detalhes do local de sada do arquivo de log (continuao) Bidirecional Suportado No

Propriedade de Nvel de Criao de Log


Essa propriedade especifica o tipo de erro para o qual a criao de log ocorrer durante a descoberta de metadados corporativos.
Tabela 16. Detalhes do nvel de criao de log Necessrio Valores Possveis No FATAL GRAVE AVISO AUDITORIA INFORMAO CONFIGURAO DETALHE GRAVE String Use essa propriedade para adaptar os recursos de rastreio. Ao especificar um tipo de erro, voc est indicando que operaes de rastreio ocorrero apenas para erros do tipo especificado. Aceitar o valor-padro GRAVE fornecer informaes de rastreio sobre erros indicados na categoria GRAVE. Erros graves significam que uma operao no pode continuar, embora o adaptador ainda possa funcionar. Erros graves tambm incluem condies de erro que indicam um erro fatal iminente, ou seja, relato sobre situaes que sugerem claramente que os recursos esto prestes a ser esgotados. Outras descries do erro so os seguintes: v Fatal O adaptador no pode continuar. O adaptador no pode funcionar v Aviso Erro potencial ou erro iminente. Isso tambm inclui condies que indicam uma falha progressiva, por exemplo, a possvel fuga de recursos. v Auditoria Evento significativo que afeta o estado ou os recursos do adaptador v Informao Informaes gerais que descrevem o progresso geral da operao. v Configurao Alterao ou status da configurao. v Detalhe Informaes gerais que descrevem o progresso da operao Globalizado Bidirecional Suportado Sim No

Padro Tipo de Propriedade Utilizao Exemplo

98

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Nome da interface SAP


Essa propriedade indica se voc est criando objetos de negcios para o processamento de eventos ALE, BAPI, Avanados ou para a Query interface for SAP Software.
Tabela 17. Detalhes do nome da interface SAP Necessrio Valores Possveis Sim Para sada: AEP ALE BAPI QSS Para entrada: AEP ALE Padro Para sada: BAPI Para entrada:ALE Tipo de propriedade Utilizao String Especifica a interface usada pelo adaptador. O adaptador interage com a interface para suportar o processamento de sada e/ou de entrada ativando a troca de dados na forma de objetos de negcios. Globalizado Bidirecional Suportado No No

Configurando o Adaptador para Processamento da Query interface for SAP Software


Para configurar o adaptador para o processamento de sada da Query interface for SAP Software, voc usa o Importer Wizard do WebSphere Transformation Extender para localizar dados em uma tabela SAP ou em um conjunto de tabelas. Em seguida, voc configura os objetos de negcios gerados e cria um mapa implementvel.

Selecionando Objetos de Negcios e Servios


Para especificar quais dados voc deseja consultar, fornea informaes no Importer Wizard do WebSphere Transformation Extender.

Antes de Iniciar
Certifique-se de ter configurado as propriedades de conexo para o Importer Wizard do WebSphere Transformation Extender.

Captulo 10. WebSphere SAP QISS Adapter

99

Por Que e Quando Desempenhar Esta Tarefa


Especifique critrios de procura usados pelo Importer Wizard do WebSphere Transformation Extender para consultar dados no servidor SAP. O Importer Wizard do WebSphere Transformation Extender retorna os dados que atendem aos critrios de procura. possvel usar as tabelas descobertas para gerar objetos individuais (objetos que no possuem nenhum relacionamento entre si) ou para gerar objetos que possuem uma estrutura hierrquica. v Se estiver gerando objetos individuais, no ser possvel importar um ou mais objetos da lista de tabelas descobertas ao mesmo tempo. v Se estiver gerando objetos hierrquicos, ser necessrio importar primeiro as tabelas-pai e, em seguida, importar as tabelas-filho. Ao configurar as tabelas-filho para importao, voc pode selecionar a tabela-pai importada anteriormente como seu pai. Repita este processo para incluir mais tabelas na estrutura hierrquica. O objeto hierrquico com trs nveis, por exemplo, necessita de trs importaes separadas para estabelecer o relacionamento pai/filho. Para especificar os critrios de procura, use o procedimento a seguir. 1. Na janela Descoberta e Seleo de Objetos, indique com qual tabela ou tabelas deseja trabalhar. a. Clique em QISS para ativar o boto de filtro. b. Clique no boto de filtro. Nota: Em vez de usar o recurso de filtro, possvel expandir QISS e selecionar a tabela na lista. 2. Na janela Propriedades do Filtro, especifique informaes sobre a tabela. a. Selecione Descobrir objetos pelo nome ou Descobrir objetos pela descrio na lista Atributo de objeto a ser usado para a descoberta. b. Digite uma cadeia de procura (por exemplo, KN*) que represente a tabela. Este o nome da tabela no SAP mais um asterisco como caractere curinga para indicar que voc deseja uma lista de todos os componentes de aplicativo do SAP iniciados com KN. c. Indique o nmero de objetos que deseja que sejam retornados alterando o valor no campo Nmero Mximo de Objetos a Serem Recuperados ou aceitando o valor-padro. d. Clique em OK. 3. Selecione os objetos da tabela. a. Expanda QISS (filtrado). b. Clique no objeto da tabela que deseja usar. c. Clique no boto de seta para incluir o objeto da tabela na lista Objetos Selecionados. 4. Na janela Propriedades de Configurao da table, fornea informaes sobre a tabela: a. O campo Incluir uma Clusula WHERE especifica a chave principal para a tabela. fornecido um valor-padro. Altere esse valor se quiser usar uma chave principal diferente. No exemplo da tabela KNA1 mostrada na figura a seguir, o valor-padro KUNNR = /CustomerNumber1. O campo KUNNR uma das chaves principais

100

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

na tabela KNA1. A consulta WHERE retornar informaes com base no nmero de cliente fornecido na consulta. b. Selecione, opcionalmente, a caixa de opo Usar Nomes do Campo SAP para Gerar Nomes de Atributos. Por padro (quando a caixa de opo no est selecionada), as descries de campo so usadas para gerar propriedades. c. Indique quais colunas voc deseja incluir na consulta. Observe que, no exemplo da tabela KNA1 mostrada na figura a seguir, h vrias colunas e, por padro, todas elas esto selecionadas. possvel limpar o visto das colunas que voc no deseja incluir, ou, se quiser selecionar apenas algumas delas, poder usar a caixa de opo Selecionar ou desmarcar todas as colunas. Por exemplo, se quiser apenas duas colunas, limpe Selecionar ou desmarcar todas as colunas para remover o visto de todas as colunas e, em seguida, selecione as duas colunas desejadas. d. Clique em OK 5. Para incluir outra tabela na consulta, execute as seguintes tarefas: a. Clique em QISS para ativar o boto de filtro. b. Clique no boto de filtro. Nota: Em vez de usar o recurso de filtro, possvel expandir QISS e selecionar a tabela na lista. 6. Na janela Propriedades do Filtro, especifique informaes sobre a tabela. a. Selecione Descobrir objetos pelo nome ou Descobrir objetos pela descrio na lista Atributo de objeto a ser usado para a descoberta. b. Digite uma cadeia de procura (por exemplo, ADRC) que represente a tabela. c. Indique o nmero de funes que deseja que sejam retornadas alterando o valor no campo Nmero Mximo de Objetos a Serem Recuperados ou aceitando o valor-padro. d. Clique em OK. 7. Selecione os objetos da tabela. a. Expanda QISS (filtrado). b. Clique no segundo objeto da tabela. c. Clique no boto de seta para incluir o objeto da tabela na lista Objetos Selecionados. 8. Na janela Propriedades de Configurao da table, fornea informaes sobre a tabela: a. O campo Incluir uma Clusula WHERE especifica a chave principal para a tabela. fornecido um valor-padro. Altere esse valor se quiser usar uma chave principal diferente. b. Selecione, opcionalmente, a caixa de opo Usar Nomes do Campo SAP para Gerar Nomes de Atributos. Por padro (quando a caixa de opo no est selecionada), as descries de campo so usadas para gerar propriedades. c. Associe essa tabela quela includa anteriormente (KNA1, no exemplo) selecionando-a na seo Selecionar uma Tabela-pai da janela. d. Em Mapear as colunas-chave principais para as colunas de referncia de chave estrangeira da tabela-pai, selecione um valor para vincular as tabelas. Por exemplo, possvel selecionar ADRNR para ADDRNUMBER. e. Indique quais colunas voc deseja incluir na consulta.
Captulo 10. WebSphere SAP QISS Adapter

101

f. Clique em OK 9. Clique em Avanar.

Resultados
O Importer Wizard do WebSphere Transformation Extender retorna os dados que correspondem aos critrios de procura.

O que Fazer Depois


Na janela Configurar Propriedades Compostas, especifique, opcionalmente, um espao de nomes e um diretrio no qual o objeto de negcios gerado ser armazenado e indique se deseja gerar um grfico de negcios.

Configurando os Objetos Selecionados


Para configurar o objeto, voc especifica informaes sobre onde ele deve ser armazenado.

Antes de Iniciar
Certifique-se de ter selecionado e importado o objeto de negcios.

Por Que e Quando Desempenhar Esta Tarefa


Para configurar o objeto de negcios, utilize o procedimento a seguir. 1. No campo Espao de Nomes do Objeto de Negcios, use o espao de nomes padro (http://www.ibm.com/xmlns/prod/websphere/j2ca/sap), exceto na circunstncia a seguir. Se voc estiver incluindo o objeto de negcios em um mapa existente e o mapa j incluir esse objeto de negcios (de uma execuo anterior do Importer Wizard do WebSphere Transformation Extender), altere o valor do espao de nomes. Por exemplo, voc poderia alterar o espao de nomes para http://www.ibm.com/xmlns/prod/websphere/j2ca/sap1. 2. Para indicar onde as informaes do objeto de negcios devem ser armazenadas, digite o caminho para o local no campo Pasta. Esta uma etapa opcional. 3. Para que o objeto de negcios seja inserido em um grfico de negcios, deixe Gerar um Grfico de Negcios para cada Objeto de Negcios selecionado. Caso contrrio, cancele a seleo. 4. Clique em Avanar.

Resultados
Voc especificou, opcionalmente, um local em que o objeto est armazenado e alterou o espao de nomes. A janela Gerao de Servio e Configurao da Implementao exibida.

O que Fazer Depois


Gere um mapa implementvel que inclua o adaptador e os objetos de negcios.

102

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Configurando Propriedades de Implementao e Gerando o Servio


Para gerar o mapa, que o artefato que est implementado no WebSphere Transformation Extender, voc cria o mapa, associa o adaptador ao mapa e especifica um alias usado para autenticar o responsvel pela chamada no servidor SAP.

Antes de Iniciar
Certifique-se de que tenha configurado o objeto de negcios. A janela Gerao de Servio e Configurao de Implementao deve ser exibida.

Por Que e Quando Desempenhar Esta Tarefa


Gere o mapa, que inclui o adaptador e o objeto de negcios configurado. O mapa o artefato implementado no servidor. Para gerar o mapa, use o procedimento a seguir. 1. Selecione, opcionalmente, Editar Operaes, se quiser alterar o nome da operao padro. Em seguida, na janela Editar Nomes da Operao, digite um novo nome e descrio opcional e clique em OK. 2. Para integrar os arquivos do adaptador no mapa, clique em Implementar conector com o mapa. Para usar o mapa com um adaptador independente, limpe a opo. v Implementao embutida. Com os arquivos do adaptador embutidos no mdulo, voc pode implementar o mdulo em um servidor de aplicativos. Utilize a implementao embutida quando quiser que mais de um mdulo utilize o mesmo adaptador, mas necessrio impedir que diferentes verses de bibliotecas compartilhadas empacotadas com os adaptadores interfiram umas nas outras. A implementao embutida tambm permite atualizar uma nica instncia do adaptador de uma vez sem se preocupar em desestabilizar instncias utilizadas por outros mdulos. v Implementao independente. Sem os arquivos do adaptador no mdulo, voc deve instal-los em cada servidor de aplicativos onde deseja executar o mdulo. Utilize a implementao independente quando o adaptador for utilizado por apenas um mdulo ou quando vrios mdulos puderem utilizar a mesma verso do adaptador. A utilizao de uma implementao independente reduz os recursos necessrios executando uma nica instncia do adaptador para vrios mdulos. 3. No campo Entrada de Dados de Autenticao J2C, digite o nome especificado na seo Segurana do console administrativo. 4. Clique em Utilizar Propriedades da Conexo Descobertas para configurar as propriedades neste momento. Se voc selecionar Utilizar Propriedades de Conexo Especificadas no Servidor, voc pode configurar propriedades posteriormente utilizando o console administrativo. 5. Na seo Propriedades da Conexo, configure ou altere quaisquer propriedades de conexo aplicveis sua configurao. Consulte Propriedades do Connection Factory Gerenciado na pgina 107 para obter informaes sobre essas propriedades. As propriedades marcadas com um asterisco (*) so obrigatrias. 6. Para configurar propriedades adicionais, clique em Avanado.
Captulo 10. WebSphere SAP QISS Adapter

103

Consulte Propriedades do Connection Factory Gerenciado na pgina 107 para obter informaes sobre essas propriedades opcionais. 7. Crie um mapa. a. Na janela Propriedades do Local de Servio, clique em Novo no campo Mapa. b. Na janela Projeto de Integrao, clique em Criar um projeto de mapa ou em Criar um projeto de mapa de mediao e clique em Avanar. 8. Na janela Novo Mapa, execute as seguintes tarefas: a. Digite um nome para o mapa. Conforme voc digita o nome, ele includo no local de trabalho especificado no campo Diretrio. Este o local padro. Se quiser especificar um local diferente, cancele a seleo da opo Utilizar Local Padro e digite um novo local ou clique em Procurar e selecione o local. b. Especifique se deseja abrir o mapa no diagrama de montagem (para projetos de mapas) ou se deseja criar um componente de fluxo de mediao (para projetos de mapas de mediao). Por padro, estas opes esto selecionadas. c. Clique em Concluir. 9. Na janela Propriedades do Local de Servio, execute as seguintes etapas: a. Se quiser alterar o espao de nomes padro, limpe a caixa de opes Utilizar Espao de Nomes Padro e digite um novo caminho no campo Espao de Nomes. b. Especifique a pasta dentro do mapa em que a descrio do servio deve ser salva digitando um nome no campo Pasta ou procurando uma pasta. Esta uma etapa opcional. c. Altere, opcionalmente, o nome da interface. O nome padro SAPOutboundInterface. Voc pode alter-lo para um ttulo mais descritivo se preferir. d. Se quiser salvar os objetos de negcios para que eles possam ser utilizados por outro aplicativo, clique em Salvar Objetos de Negcios em uma Biblioteca e selecione uma biblioteca da lista ou clique em Novo para criar uma nova biblioteca. e. Digite, opcionalmente, uma descrio do mapa. 10. Clique em Concluir.

Resultados
O novo mapa includo na perspectiva Integrao de Negcios.

Desenvolvendo Mapas Usando o WebSphere Adapters


Antes de poder se conectar a um Enterprise Information System (EIS), execute as tarefas a seguir, na ordem mostrada, para preparar o sistema.

Antes de Iniciar
Antes de iniciar: v Leia Viso Geral do WebSphere Adapter para SAP Software na pgina 88 v Preparando o Ambiente para os WebSphere Adapters na pgina 93

104

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

O que Fazer Depois


Depois de ter preparado seu sistema, conecte-se a um EIS seguindo as instrues de Conectando-se a um Enterprise Information System.

Conectando-se a um Enterprise Information System


Crie os recursos necessrios para os WebSphere Adapters e conecte-se a um Enterprise Information System (EIS).

Antes de Iniciar
Antes de iniciar: v Leia Importador SAP na pgina 89 v Prepare o ambiente para os WebSphere Adapters v Execute as tarefas preparatrias listadas em Desenvolvendo Mapas Usando o WebSphere Adapters na pgina 104

Por Que e Quando Desempenhar Esta Tarefa


Um mapa que usa um dos WebSphere Adapters requer os seguintes recursos: v Um ou mais cartes que contm um ou mais WebSphere Adapters v Um esquema do WebSphere Transformation Extender que contm o XML Schema Definitions (XSD) para os objetos de negcios no Enterprise Information System (EIS) O Importer Wizard do WebSphere Transformation Extender cria esses recursos automaticamente. Antes de executar o assistente, necessrio reunir as seguintes informaes do EIS: v SAP Nome do usurio do sistema SAP Senha do sistema SAP Nome do host ou endereo IP do SAP ID do Cliente SAP (por exemplo, 001) Nmero do sistema SAP (por exemplo, 00) Cdigo do idioma (por exemplo, EN) Para maiores informaes, consulte Propriedades de Conexo do SAP para o Assistente de Conexo do Adaptador na pgina 94 As etapas a seguir descrevem como se conectar a um EIS. 1. Alterne para a perspectiva Transformation Extender Development. 2. Clique em Arquivo Importar Transformation Extender. 3. Escolha um assistente do WebSphere Adapter para SAP e, em seguida, clique em Avanar. O Importer Wizard do WebSphere Transformation Extender ser aberto. 4. Siga as instrues no assistente. Para ver uma descrio de cada campo no assistente, passe o mouse sobre o campo.

Resultados
Ao concluir as etapas no assistente, o projeto WebSphere Transformation Extender especificado conter um esquema para cada objeto de negcios.
Captulo 10. WebSphere SAP QISS Adapter

105

Depurando Mapas que Contm WebSphere Adapters


possvel usar vrios mtodos para mapear dados que incluem WebSphere Adapters.

Por Que e Quando Desempenhar Esta Tarefa


Antes de usar qualquer um dos mtodos listados a seguir, assegure-se de que os arquivos jar apropriados e as bibliotecas compartilhadas estejam disponveis para os WebSphere Adapters. Para obter mais informaes, consulte Preparando o Ambiente para os WebSphere Adapters na pgina 93. 1. Arquivos de rastreio do adaptador - especificados pela opo de linha de comandos -T. O padro j2ca.mtr 2. Ative o rastreio de Java em dtx.ini 3. Arquivos de auditoria e rastreio do mapa

Informaes de Referncia
Para lhe oferecer suporte em suas tarefas, as informaes de referncia incluem detalhes sobre objetos de negcios que so gerados pelo Importer Wizard do WebSphere Transformation Extender e informaes sobre propriedades do adaptador, incluindo aquelas que suportam transformao para bidi. Elas tambm incluem ponteiros para mensagens do adaptador e informaes relacionadas ao produto.

Incluindo Dependncias de Software Externas


Para incluir o arquivo sapjco.jar necessrio e os arquivos relacionados em seu projeto, instale os arquivos e, em seguida, use o WebSphere Integration Developer para especificar o local dos arquivos.

Antes de Iniciar
Certifique-se de ter criado o projeto.

Por Que e Quando Desempenhar Esta Tarefa


Para obter os arquivos necessrios e especificar seus locais, use o procedimento a seguir. 1. Obtenha o arquivo sapjco.jar e os arquivos associados para seu sistema operacional com o administrador do SAP ou no Web site do SAP. Os arquivos so listados na Tabela 18.
Tabela 18. Arquivos a serem instalados Sistema Operacional Windows

Arquivos a serem instalados Quaisquer arquivos *.dll fornecidos com o download do SAP JCo a partir do Web site do SAP Quaisquer arquivos .so e .o fornecidos com o download do SAP JCo a partir do Web site do SAP

UNIX (incluindo os Servios do Sistema UNIX no z/OS )

2. Apenas para ambientes Windows, obtenha os arquivos msvcp71.dll e msvcr71.dll (se ainda no estiverem instalados em seu computador). 3. Instale os arquivos no computador.

106

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

4. Na janela Arquivos e Bibliotecas Necessrios, especifique o local dos arquivos: a. Para cada arquivo, clique em Navegar e selecione o local em que o arquivo foi instalado. Observe que ser feita uma solicitao pelo local de msvcp71.dll e msvcr71.dll apenas se ainda no estiverem localizados no caminho do sistema Windows. b. Clique em Avanar.

Resultados
O arquivo sapjco.jar e os arquivos associados so agora parte de seu projeto.

O que Fazer Depois


A primeira etapa no processo de configurao do adaptador especificar informaes sobre o servidor SAP para que o Importer Wizard do WebSphere Transformation Extender possa estabelecer uma conexo com o servidor.

Propriedades do Connection Factory Gerenciado


As propriedades do connection factory gerenciado so usadas pelo adaptador no tempo de execuo para criar uma instncia de conexo de sada com o servidor SAP. A propriedade a seguir que foi especificada como uma propriedade do connection factory gerenciado na verso 6.0.2 se aplica ao grupo de propriedades de especificao de interao na verso 6.1.0. v IgnoreBAPIReturn Voc configura as propriedades do connection factory gerenciado usando o Importer Wizard do WebSphere Transformation Extender. A tabela a seguir lista e descreve as propriedades da connection factory gerenciada. Uma descrio mais detalhada de cada propriedade fornecida aps a tabela. Para obter informaes sobre como ler as tabelas de detalhes das propriedades na sees a seguir, consulte Guia para Informaes sobre Propriedades. Nota: O Importer Wizard do WebSphere Transformation Extender refere-se a essas propriedades como propriedades do connection factory gerenciado.
Tabela 19. Propriedades do connection factory gerenciado para o WebSphere Adapter para SAP Software Propriedades No assistente depurao do ABAP na pgina 108 Cliente na pgina 109 Nmero da Pgina de Cdigos na pgina 109 Pasta para os Arquivos de Rastreio do RFC na pgina 110 Opo de linha de comandos Descrio

-mcf:abapDebug <true|false> Propriedade do depurador ABAP. -mcf:client <client> -mcf:codepage <codepage> -mcf:RFCTracePath <RFCTracePath> Essa propriedade o nmero do cliente do sistema SAP com o qual o adaptador se conecta. Indica o identificador numrico da pgina de cdigos. Configura o caminho local qualificado para a pasta onde os arquivos de rastreio de RFC so gravados.

Captulo 10. WebSphere SAP QISS Adapter

107

Tabela 19. Propriedades do connection factory gerenciado para o WebSphere Adapter para SAP Software (continuao) Propriedades No assistente Host do Gateway na pgina 110 Servio de Gateway na pgina 111 Nome do host na pgina 111 Cdigo do idioma na pgina 112 Host do Servidor de Mensagens na pgina 112 Conjunto de Caracteres Padro na pgina 112 Senha na pgina 113 Nvel de Rastreio de RFC na pgina 113 Rastreio de RFC em na pgina 114 ID do Sistema SAP na pgina 115 Nmero do Sistema na pgina 115 Nome de usurio na pgina 115 Opo de linha de comandos -mcf:gatewayHost <gatewayhostname> -mcf:gatewayService <gatewayServiceId> -mcf:applicationServerHost <applicationserverhost> -mcf:language <language> -mcf:messageServerHost <hostname> -mcf:partnerCharset <partnerCharset> -mcf:password <password> -mcf:RFCTraceLevel <1|3|5> -mcf:RFCTraceOn <true|false> -mcf:sapSystemID <SAPsystemid> -mcf:systemNumber <sysnumber> -mcf:userName <username> Descrio Esta propriedade o nome do host do gateway SAP. Essa propriedade o identificador do gateway no host do gateway que transporta os servios de RFC. Especifica o endereo IP ou o nome do host do servidor de aplicativos no qual o adaptador efetua logon. Essa propriedade especifica o Cdigo de idioma em que o adaptador efetua logon no SAP. Especifica o nome do host onde o servidor de mensagens est sendo executado. Essa propriedade especifica a codificao PartnerCharset. Esta propriedade a senha da conta do usurio do adaptador no servidor de aplicativos SAP. Essa propriedade especifica o nvel de rastreio global. Especifica se necessrio gerar um arquivo de texto que detalha a atividade do RFC para cada listener de eventos. Essa propriedade especifica o ID do sistema SAP para o qual o balanceamento de carga de logon permitido. Esta propriedade o nmero do sistema do servidor de aplicativos SAP. Essa propriedade a conta do usurio para o adaptador no servidor SAP.

depurao do ABAP
Essa propriedade especifica se o adaptador chamar o Depurador ABAP para o mapa de funo apropriado quando o adaptador comear a processar um objeto de negcios.
Tabela 20. Detalhes de depurao do ABAP Necessrio Valores Possveis Padro Tipo de Propriedade No True Falso Falso Booleano

108

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Tabela 20. Detalhes de depurao do ABAP (continuao) Utilizao Quando a propriedade est configurada como True, o adaptador fornece a GUI do SAP no modo de depurao. necessrio ter autorizao adequada para usar o depurador. Crie um ID de usurio do dilogo porque um ID de usurio CPI-C no pode abrir uma sesso GUI do SAP. necessrio autorizao para executar no modo de depurao, assim como quaisquer autorizaes necessrias para o cdigo ABAP que est sendo depurado. Por exemplo, se um BAPI_CUSTOMER_CREATEFROMDATA1 estiver sendo depurado, voc precisar de autorizao para criar clientes. possvel incluir pontos de interrupo apenas aps a abertura do depurador. Essa propriedade sempre dever ser configurada como False em um ambiente de produo. Essa propriedade suportada apenas na plataforma Windows. Globalizado Suporte para Bidirecional No No

Cliente
Essa propriedade o nmero do cliente do sistema SAP com o qual o adaptador se conecta.
Tabela 21. Detalhes do Cliente Necessrio Valores Possveis Padro Tipo de Propriedade Utilizao Sim Voc pode digitar diversos valores de 000 a 999. 100 Integer Quando o aplicativo tenta efetuar logon no servidor SAP, o servidor SAP requer que o aplicativo tenha um nmero de Cliente associado a ele. O valor da propriedade do Cliente identifica o cliente (o adaptador) que est tentando efetuar logon no servidor SAP. No No

Globalizado Suporte para Bidirecional

Nmero da Pgina de Cdigos


O identificador numrico da pgina de cdigos.
Tabela 22. Detalhes do Nmero da Pgina de Cdigos Necessrio Valores Possveis No Voc pode digitar diversos valores de 0000 a 9999. Para obter uma listagem completa de idiomas e de nmeros de pginas de cdigos associados suportados pelo SAP, acesse SAP Note 7360. Padro Tipo de Propriedade O valor padro para esta propriedade determinado condicionalmente pelo valor definido para a propriedade Cdigo do idioma. Integer

Captulo 10. WebSphere SAP QISS Adapter

109

Tabela 22. Detalhes do Nmero da Pgina de Cdigos (continuao) Utilizao O valor designado ao Nmero da pgina de cdigos define a pgina de cdigos que ser utilizada e tem um relacionamento um-para-um com o valor definido para a propriedade Cdigo do idioma. O Nmero da pgina de cdigos estabelece uma conexo com o idioma apropriado. Cada valor de cdigo de idioma tem um valor de nmero de pgina de cdigos associado a ele. Por exemplo, o cdigo do idioma para ingls EN. Se voc selecionou EN (ingls) como cdigo do idioma, o nmero da pgina de cdigos ser configurado automaticamente para o valor numrico associado com EN (ingls). O nmero da pgina de cdigos do SAP para EN (ingls) 1100. Exemplo Globalizado Suporte para Bidirecional Se o Cdigo do idioma for configurado como JA (Japons), o Nmero da pgina de cdigos ser configurado como 8000. No No

Pasta para os Arquivos de Rastreio do RFC


Configura o caminho local completo para a pasta na qual gravar arquivos de rastreio da RFC.
Tabela 23. Detalhes da Pasta para os Arquivos de Rastreio de RFC Necessrio Padro Tipo de Propriedade Utilizao No Nenhum valor padro String Identifica o caminho local qualificado onde os arquivos de rastreio de RFC so gravados. Se Rastreio de RFC ativado estiver configurado como False (no selecionado), voc no ter permisso para configurar um valor na propriedade Pasta para arquivos de rastreio de RFC. Exemplo Globalizado Suporte para Bidirecional c:\temp\rfcTraceDir Sim No

Host do Gateway
Esta propriedade o nome do host do Gateway. Digite o endereo IP ou o nome do host do Gateway. Consulte o administrador do SAP para obter informaes sobre o nome do host do Gateway.
Tabela 24. Detalhes do Host do Gateway Necessrio Padro Tipo de Propriedade Sim Nenhum valor padro String

110

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Tabela 24. Detalhes do Host do Gateway (continuao) Utilizao Esta propriedade o nome do host do gateway SAP. O gateway permite a comunicao entre processos de trabalho no sistema SAP e programas externos. O host identificado utilizado como o gateway para o adaptador de recursos. Comprimento mximo de 20 caracteres. Se o nome do computador tiver mais 20 caracteres, defina um nome simblico na tabela THOSTS. Globalizado Suporte para Bidirecional No No

Servio de Gateway
Essa propriedade o identificador do gateway no host do gateway que transporta os servios de RFC.
Tabela 25. Detalhes do Servio de Gateway Necessrio Padro Tipo de Propriedade Utilizao Sim sapgw00 String Esses servios permitem a comunicao entre processos de trabalho no servidor SAP e programas externos. Normalmente, o servio tem o formato de sapgw00, em que 00 o nmero do sistema SAP. Mximo de 20 caracteres. Globalizado Suporte para Bidirecional No No

Nome do host
Especifica o endereo IP ou o nome do host do servidor de aplicativos no qual o adaptador efetua logon.
Tabela 26. Detalhes do Nome do Host Necessrio Padro Tipo de Propriedade Utilizao Sim (quando o balanceamento de carga no utilizado). Nenhum valor padro String Quando o adaptador configurado para execuo sem balanceamento de carga, essa propriedade especifica o endereo IP ou o nome do host do servidor de aplicativos no qual o adaptador efetua logon. sapServer No No

Exemplo Globalizado Suporte para Bidirecional

Captulo 10. WebSphere SAP QISS Adapter

111

Cdigo do idioma
Essa propriedade especifica o Cdigo do idioma no qual o adaptador efetua logon.
Tabela 27. Detalhes do Cdigo do Idioma Necessrio Valores Possveis Padro Tipo de Propriedade Utilizao Sim Para obter uma listagem completa de idiomas e de nmeros de pginas de cdigos associados suportados pelo SAP, acesse SAP Note 7360. O valor padro para a propriedade de Cdigo do idioma baseado no cdigo de idioma do sistema. String Cada um dos idiomas suportados precedido por um cdigo de idioma de 2 caracteres. O idioma exibido entre parnteses. Os cdigos de idiomas exibidos na lista representam o conjunto padro do SAP de 41 idiomas para sistemas Unicode, mais o idioma rabe. O valor que voc seleciona determina o valor da propriedade Nmero da pgina de cdigos. Se voc digitar manualmente um cdigo de idioma, no ser necessrio digitar o idioma entre parnteses. Exemplo Globalizado Suporte para Bidirecional Se o cdigo de idioma do sistema for ingls, o valor para essa propriedade ser EN (ingls). No No

Host do Servidor de Mensagens


Essa propriedade especifica o nome do host onde o servidor de mensagens est sendo executado.
Tabela 28. Detalhes do Host do Servidor de Mensagens Necessrio Padro Tipo de Propriedade Utilizao Sim (se o balanceamento de carga for utilizado) Nenhum valor padro String Essa propriedade especifica o nome do host que informar todos os servidores (instncias) pertencentes a este sistema SAP da existncia dos outros servidores a serem utilizados para balanceamento de carga. O host do servidor de mensagens contm as informaes sobre o balanceamento de carga para clientes de RFC para que um cliente de RFC possa ser direcionado para um servidor de aplicativos apropriado. Exemplo Globalizado Suporte para Bidirecional SAPERP05 No No

Conjunto de Caracteres Padro


Essa propriedade especifica a codificao do conjunto de caracteres padro.

112

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Tabela 29. Detalhes do Conjunto de Caracteres Padro Necessrio Padro Tipo de Propriedade Utilizao Globalizado Suporte para Bidirecional No ISO-8859-1 String Quando uma codificao especificada, ela utilizada; caso contrrio, ser utilizada a codificao padro. No No

Senha
Esta propriedade a senha da conta do usurio do adaptador no servidor de aplicativos SAP.
Tabela 30. Detalhes da Senha Necessrio Padro Tipo de Propriedade Utilizao Sim Nenhum valor padro String As restries sobre a senha dependem da verso do SAP Web Application Server. v Para o SAP Web Application Server verso 6.40 ou anterior, a senha: Deve estar em letras maisculas Deve ter 8 caracteres de comprimento v Para verses do SAP Web Application Server posteriores 6.40, a senha: No faz distino entre maisculas e minsculas Pode ter at 40 caracteres de comprimento Globalizado Suporte para Bidirecional No Sim

Nvel de Rastreio de RFC


Essa propriedade especifica o nvel de rastreio global.
Tabela 31. Detalhes do Nvel de Rastreio de RFC Necessrio Valores Possveis No 1 3 5 1 Integer

Padro Tipo de Propriedade

Captulo 10. WebSphere SAP QISS Adapter

113

Tabela 31. Detalhes do Nvel de Rastreio de RFC (continuao) Utilizao Os nveis de rastreio so os seguintes: v 1 Esse o nvel de rastreio RFC padro. Quando especificado, ocorre a criao de log da API Java do SAP JCo. v 3 Quando especificado, ocorre a criao de log da API do SAP JCo JNI. v 5 Quando especificado, ocorre a criao de log do diagnstico de erro. Se Rastreio de RFC ativado estiver configurado como False (no selecionado), voc no ter permisso para configurar um valor na propriedade Nvel de rasteio de RFC. Globalizado Bidirecional Suportado No No

Rastreio de RFC em
Essa propriedade especifica se voc deve gerar um arquivo de texto detalhando a atividade de RFC para cada listener de evento.
Tabela 32. Detalhes de Rastreio de RFC em Necessrio Valores Possveis Padro Tipo de Propriedade Utilizao No TrueFalse .False Booleano Um valor true ativa o rastreio, o que gera um arquivo de texto. Esse arquivo criado no diretrio onde o processo do adaptador foi iniciado. O arquivo tem um prefixo de rfx e um tipo de arquivo de trc (por exemplo, rfc03912_02220.trc).Um valor True ativa o rastreio, que gera um arquivo de texto. Utilize esses arquivos de texto apenas em um ambiente de desenvolvimento, porque eles podem aumentar rapidamente. Se Rastreio de RFC ativado estiver configurado como False (no selecionado), voc no ter permisso para configurar valores nas propriedades Pasta para arquivos de rastreio de RFC ou Nvel de rastreio de RFC. Exemplo Exemplos das informaes no arquivo incluem RfcCall FUNCTION BAPI_CUSTOMER_GETLIST, seguidas pelas informaes para os parmetros na interface, ou RFC Info rfctable, seguidas pelos dados de uma das tabelas da interface. O arquivo de rastreio criado no diretrio onde o processo do adaptador foi iniciado. O arquivo de rastreio tem uma extenso de arquivo .trc e o nome do arquivo comear com as letras rfc seguidas por um identificador exclusivo. Por exemplo, rfc03912_02220.trc. Globalizado Suporte para Bidirecional No No

114

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

ID do Sistema SAP
Essa propriedade especifica o ID do sistema SAP para o qual o balanceamento de carga de logon permitido.
Tabela 33. Detalhes do ID do Sistema SAP Necessrio Padro Tipo de Propriedade Utilizao Exemplo Globalizado Suporte para Bidirecional Sim (quando o balanceamento de carga utilizado) Nenhum valor padro String O valor deve ter trs caracteres DYL No No

Nmero do Sistema
Esta propriedade o nmero do sistema do servidor de aplicativos SAP.
Tabela 34. Detalhes do Nmero do Sistema Necessrio Valores Possveis Padro Tipo de Propriedade Utilizao Globalizado Suporte para Bidirecional Sim possvel inserir um intervalo de valores de 00 a 99 00 Integer O nmero do sistema identifica ainda o servio de Gateway. No No

Nome de usurio
Essa propriedade a conta do usurio para o adaptador no servidor SAP.
Tabela 35. Detalhes do Nome do Usurio Necessrio Padro Tipo de Propriedade Utilizao Sim Nenhum valor padro String Comprimento mximo de 12 caracteres. O nome do usurio no faz distino entre maisculas e minsculas. recomendado configurar uma conta de usurio de CPIC no aplicativo SAP e que voc conceda a essa conta os privilgios necessrios para manipular os dados requeridos pelos objetos de negcios suportados pelo adaptador. Por exemplo, se o adaptador tiver que executar certas transaes de negcios do SAP, a conta do adaptador no aplicativo SAP dever ter as permisses configuradas para permitir sua execuo dessas transaes. Exemplo Globalizado SapUser Sim
Captulo 10. WebSphere SAP QISS Adapter

115

Tabela 35. Detalhes do Nome do Usurio (continuao) Suporte para Bidirecional Sim

Propriedades de Especificao de Interao


As propriedades de especificao de interao controlam a interao para uma operao. O Importer Wizard do WebSphere Transformation Extender configura as propriedades de especificao de interao quando voc configura o adaptador. Normalmente, no necessrio alterar essas propriedades. No entanto, possvel alterar algumas propriedades das operaes de sada. Por exemplo, possvel aumentar o valor da propriedade de especificao de interao que especifica o Nmero mximo de ocorrncias da descoberta a serem retornadas por uma operao RetrieveAll se as operaes RetrieveAll no retornarem informaes completas. Use o editor de mapa no WebSphere Transformation Extender para alterar a linha de comandos no carto WebSphereTX. A propriedade de especificao de interao do WebSphere Adapter para SAP Software lista e descreve a propriedade de especificao de interao configurada. Para obter informaes sobre como ler as tabelas de detalhes das propriedades na sees a seguir, consulte Guia para Informaes sobre Propriedades.
Tabela 36. Propriedade de especificao de interao do WebSphere Adapter para SAP Software Propriedades No assistente Nome da Funo Nmero Mximo de Ocorrncias da Descoberta na pgina 117 Opo de linha de comandos -is:functionName <true|false> -is:resultSetLimit <maximumnumber> Descrio Preenche o nome da funo da interface SAP especfica. Nmero mximo de conjuntos de resultados a serem retornados durante uma operao RetrieveAll.

Nome da Funo
A propriedade de especificao de interao functionName controla a interao associando operaes interface adequada.
Tabela 37. Detalhes do nome da funo Necessrio Valores Possveis Padro Tipo de Propriedade Utilizao Sim True Falso Nulo String A interface Query interface for SAP software (QISS) suporta os seguintes valores para a propriedade de especificao de interao functionName: v WBIInteractionSpec.RETRIEVEALL Emite excees QISSQueryFailedException Globalizado Suporte para Bidirecional No No

116

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Nmero Mximo de Ocorrncias da Descoberta


Para a Query interface for SAP Software, essa propriedade especifica o nmero mximo de conjuntos de resultados, que representa dados para cada linha recuperada de uma tabela por meio de uma operao RetrieveAll.
Tabela 38. Detalhes de Limite do Conjunto de Resultados Necessrio Padro Tipo de Propriedade Utilizao Sim 100 Integer Se o nmero de ocorrncias na tabela no servidor SAP exceder o valor da propriedade ResultSetLimit, o adaptador retornar o erro MatchesExceededLimitException. O adaptador utiliza essa propriedade para ajudar a evitar problemas de falta de memria. No No

Globalizado Suporte para Bidirecional

Captulo 10. WebSphere SAP QISS Adapter

117

118

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Avisos
Estas informaes foram desenvolvidas para produtos e servios oferecidos nos Estados Unidos. A IBM pode no oferecer os produtos, servios ou recursos discutidos nesta publicao em outros pases. Consulte um representante IBM local para obter informaes sobre produtos e servios disponveis atualmente em sua rea. Qualquer referncia a produtos, programas ou servios IBM no significa que apenas produtos, programas ou servios IBM possam ser utilizados. Qualquer produto, programa ou servio funcionalmente equivalente, que no infrinja nenhum direito de propriedade intelectual da IBM ou outros direitos legalmente protegidos, poder ser utilizado em substituio a este produto, programa ou servio. Entretanto, a avaliao e verificao da operao de qualquer produto, programa ou servio no-IBM so de responsabilidade do Cliente. A IBM pode ter patentes ou solicitaes de patentes pendentes relativas a assuntos tratados nesta publicao. O fornecimento deste documento no garante ao Cliente nenhum direito sobre tais patentes. Pedidos de licena devem ser enviados, por escrito, para: Gerncia de Relaes Comerciais e Industriais da IBM Brasil Av. Pasteur, 138-146 Botafogo Rio de Janeiro, RJ CEP 22290-240 Para pedidos de licenas com relao a informaes sobre DBCS (Conjunto de Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu pas ou envie pedidos, por escrito, para: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106-0032, Japan O pargrafo a seguir no se aplica ao Reino Unido ou a nenhum pas em que tais disposies no estejam de acordo com a legislao local: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAO NO ESTADO EM QUE SE ENCONTRA, SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA OU IMPLCITA, INCLUINDO, MAS NO SE LIMITANDO A, AS GARANTIAS IMPLCITAS DE NO-INFRAO, COMERCIALIZAO OU ADEQUAO A UM DETERMINADO PROPSITO. Alguns pases no permitem a excluso de garantias expressas ou implcitas em certas transaes; portanto, esta disposio pode no se aplicar ao Cliente. Estas informaes podem conter imprecises tcnicas ou erros tipogrficos. Periodicamente, so feitas alteraes nas informaes aqui contidas; tais alteraes sero incorporadas em novas edies do documento. A IBM pode, a qualquer momento, aperfeioar e/ou alterar os produtos e/ou programas descritos nesta publicao, sem aviso prvio. Referncias nestas informaes a Web sites que no sejam da IBM so fornecidas apenas por convenincia e no representam de forma alguma um endosso a estes
Copyright IBM Corp. 2006, 2009

119

Web sites. Os materiais contidos nestes Web sites no fazem parte dos materiais deste produto IBM e a utilizao desses Web sites de inteira responsabilidade do Cliente. A IBM pode utilizar ou distribuir as informaes fornecidas da forma que achar apropriada, sem incorrer em qualquer obrigao para com o Cliente. Licenciados deste programa que desejam obter informaes sobre este assunto com o objetivo de permitir: (i) a troca de informaes entre programas criados independentemente e outros programas (incluindo este) e (ii) a utilizao mtua das informaes trocadas, devem entrar em contato com: Gerncia de Relaes Comerciais e Industriais da IBM Brasil Av Pasteur, 138-146 Botafogo Rio de Janeiro, RJ CEP 22290-240 Tais informaes podem estar disponveis, sujeitas a termos e condies apropriados, incluindo em alguns casos, o pagamento de uma taxa. O programa licenciado descrito neste documento e todo material licenciado disponvel para ele so fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, o Contrato de Licena do Programa Internacional IBM, ou qualquer outro contrato equivalente. Todos os dados de desempenho aqui contidos foram determinados em um ambiente controlado. Portanto, os resultados obtidos em outros ambientes operacionais podem variar significativamente. Algumas medidas podem ter sido tomadas em sistemas em nvel de desenvolvimento e no h garantia de que estas medidas sero as mesmas em sistemas disponveis em geral. Alm disso, algumas medidas podem ter sido estimadas por extrapolao. Os resultados reais podem variar. Os usurios deste documento devem verificar os dados aplicveis para seu ambiente especfico. As informaes relativas a produtos no-IBM foram obtidas junto aos fornecedores dos respectivos produtos, de seus anncios publicados ou de outras fontes disponveis publicamente. A IBM no testou estes produtos e no pode confirmar a preciso do desempenho, da compatibilidade ou de qualquer outra reivindicao relacionada a produtos no-IBM. Dvidas sobre os recursos de produtos no-IBM devem ser enviadas diretamente a seus fornecedores. Todas as declaraes relacionadas aos objetivos e intenes futuras da IBM esto sujeitas a alteraes ou cancelamento sem aviso prvio, e representam apenas metas e objetivos. Estas informaes contm exemplos de dados e relatrios utilizados nas operaes dirias de negcios. Para ilustr-los de forma mais completa, os exemplos incluem os nomes de indivduos, empresas, marcas e produtos. Todos esses nomes so fictcios e qualquer semelhana com nomes e endereos utilizados por uma empresa real mera coincidncia. LICENA DE COPYRIGHT: Essas informaes contm programas aplicativos de amostra no idioma de origem, que ilustram as tcnicas de programao em diversas plataformas operacionais. O Cliente pode copiar, modificar e distribuir esse programas de amostra de qualquer

120

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

forma, sem pagamento IBM, com o propsito de desenvolvimento, utilizao, comercializao ou distribuio dos programas aplicativos de acordo com a interface de programao de aplicativo da plataforma operacional para qual os programas de amostra so gravados. Esses exemplos no foram totalmente testados sob todas as condies. A IBM, ento, no pode garantir ou oferecer segurana, manuteno ou o funcionamento desses programas. Se estas informaes estiverem sendo exibidas em cpia eletrnica, as fotografias e ilustraes coloridas podem no aparecer.

Informaes sobre a Interface de Programao


As informaes sobre a interface de programao, se fornecidas, tm como objetivo ajudar voc a criar software aplicativo utilizando esse programa. As interfaces de programao de uso geral permitem que voc grave o software aplicativo que obtm as ferramentas desse programa. Contudo, essas informaes podem conter informaes de diagnstico, modificao e ajuste. As informaes sobre diagnstico, modificao e ajuste so fornecidas para ajudar voc a depurar seu software aplicativo. Aviso: No utilize essas informaes de diagnstico, modificao, e ajuste como uma interface de programao, pois elas esto sujeitas a alteraes.

Marcas Registradas e Marcas de Servio


Os termos a seguir so marcas ou marcas registradas da International Business Machines Corporation nos Estados Unidos e/ou em outros pases: AIX AIX 5L AS/400 Ascential Ascential DataStage Ascential Enterprise Integration Suite Ascential QualityStage Ascential RTI Ascential Software Ascential CICS DataStage DB2 DB2 Universal Database developerWorks Footprint Hiperspace IBM o logotipo IBM ibm.com IMS Informix Lotus Lotus Notes MQSeries MVS
Avisos

121

OS/390 OS/400 Passport Advantage Redbooks RISC System/6000 Roma S/390 System z Trading Partner Tivoli WebSphere z/Architecture z/OS zSeries Java e todas as marcas baseadas em Java so marcas registradas da Sun Microsystems, Inc. nos Estados Unidos e/ou em outros pases. Microsoft, Windows, Windows NT, e o logotipo Windows so marcas registradas da Microsoft Corporation nos Estados Unidos e/ou em outros pases. Intel, o logotipo Intel, Intel Inside, o logotipo Intel Inside, Intel Centrino, o logotipo Intel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium e Pentium so marcas ou marcas registradas da Intel Corporation ou de seus subsidirios nos Estados Unidos ou/e em outros pases. UNIX uma marca registrada da The Open Group nos Estados Unidos e em outros pases. Linux uma marca registrada de Linus Torvalds nos Estados Unidos e/ou em outros pases. Outros nomes de empresas, produtos e servios podem ser marcas registradas ou marcas de servio de terceiros. Esse produto inclui o software desenvolvido pela Eclipse Project (http://www.eclipse.org/).

IBM WebSphere Transformation Extender, Pack para SAP R/3, Verso 8.3

122

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

ndice Remissivo Caracteres Especiais


.bdc .dx .ido .ini .log .mtr .mts .tid 68 59 46 22, 23, 24, 30, 31, 32, 33, 41, 43 27, 81, 83 38, 39, 81, 83 17 28, 29 rvores do tipo BAPI (continuao) entendendo 77 rvores do tipo BDC R/3 68 criando 68 rvores do tipo IDoc criando 46 entendendo 47 Assistente do Importador entrada de metadados 17 executando 50, 60 para BDC 68 para IDocs 47 Ativador opes do comando do adaptador R/3 -LSN

Numricos
1 1, 17, 19

36

A
adaptadores R/3 19 ALE 21, 22, 23, 43, 50, 51, 58, 70 BAPI 42, 78 BDC 69, 70 viso geral 19 aliases para adaptadores R/3 42 Ambiente de Trabalho de Transferncia de Dados (SXDA) arquivo JAR, incluindo externas 106 arquivo sapjco.jar importando no projeto 106 arquivos de correo e transporte requisitos de instalao 5 arquivos de definio 59 arquivos de log auditoria de execuo 81, 82 arquivos de log de auditoria (.log) 81, 83 arquivos de log de auditoria de execuo 81, 82 arquivos de rastreio 83 .mtr 81 exemplos 83 VERBOSE 84 arquivos de script para rvores do tipo 17 arquivos m4r3adapter.log 27, 83 exemplos 83 arquivos m4r3adapter.mtr 38 arquivos saplogon.ini 43 arquivos saprfc.ini balanceamento de carga 30 especificando a chave de destino 24, 31 exemplos 22, 32 arquivos transaction_id.tid 28 rvores de tipo ALE 47 arquivos de script 17 BAPI 76, 77 BDC 68 DXOB 61 EDI 47 rvores do tipo IDoc, gerando 49 rvores do tipo ALE 47 rvores do tipo BAPI criando 76 Copyright IBM Corp. 2006, 2009

B
balanceamento de carga comandos do adaptador 29 exemplo de cadeia de caracteres de comando 30 exemplo usando arquivos saprfc.ini 30 grupo de logon 24, 29 princpio 29 BAPI (Business Application Programming Interface) chamando a partir de um mapa 24, 78 definio 3 parmetros de importao 78 viso geral 75 Batch Data Communication (BDC) Consulte BDC (Batch Data Communication) 4 BDC (Batch Data Communication) arquivos de exemplo 68 carregando dados manualmente usando ZBDS 71 definio 4 BOR (Business Object Repository) 46 Business Application Programming Interface (BAPI) Consulte BAPI (Business Application Programming Interface) 3 Business Object Repository (BOR) 46

59

C
chave de destino para arquivos saprfc.ini 31 cliente R/3 configurando 8 Codificao do Conjunto de Caracteres (-enc) -enc 31 cdigo de transao BD54 Consulte transao de criao/manuteno do Sistema Lgico (BD54) 8 cdigo de transao BD64 Consulte transao de manuteno do modelo de distribuio (BD64) 12 cdigo de transao BD82 Consulte transao de gerao de perfil do parceiro (BD82) 13 cdigo de transao SE37 Consulte transao de seleo da BAPI (SE37) 77 cdigo de transao SHDB Consulte transao de gravao de sesso BDC (SHDB) 65 cdigo de transao SXDA Consulte Transao do Ambiente de Trabalho de Transferncia de Dados (SXDA) 59 cdigo de transao WE20 Consulte transao de definio de perfil do parceiro (WE20) 13

123

cdigo de transao WE63 Consulte transao de download de metadados IDoc (WE63) 48 cdigo de transao ZBDC Consulte transao de relatrio de estrutura BDC (ZBDC) 67 cdigo de transao ZBDS Consulte transao de carregamento de dados de sesso BDC (ZBDS) 71 cdigos de retorno e mensagens de erro para adaptadores 84 para execuo do mapa 82 cdigos de transao BD54 Consulte transao de criao/manuteno do Sistema Lgico (BD54) 8 BD64 Consulte transao de manuteno do modelo de distribuio (BD64) 12 BD82 Consulte transao de gerao de perfil do parceiro (BD82) 13 BD88 Consulte transao de dispatch/coleta de IDoc (BD88) 50 SE37 Consulte transao de seleo da BAPI (SE37) 77 SHDB Consulte transao de gravao de sesso BDC (SHDB) 65 SXDA Consulte Transao do Ambiente de Trabalho de Transferncia de Dados (SXDA) 59 WE20 Consulte transao de definio de perfil do parceiro (WE20) 13 ZBDC Consulte transao de relatrio de estrutura BDC (ZBDC) 67 ZBDS Consulte transao de carregamento de dados da sesso BDC (ZBDS) 70 cdigos de transao BD88 Consulte transao de dispatch/coleta de IDoc (BD88) 50 comando do adaptador ID do Programa (-A) especificando 10 comando do adaptador R/3 -A 27 comando do adaptador R/3 -AR3 27 comando do adaptador R/3 -ASCLNT 28 comando do adaptador R/3 -ASUSER R/3 28 comando do adaptador R/3 -B 28 comando do adaptador R/3 -BAL 29 comando do adaptador R/3 -C 30 comando do adaptador R/3 -D 31 comando do adaptador R/3 -enc 31 comando do adaptador R/3 -G 33 comando do adaptador R/3 -GEN 33 comando do adaptador R/3 -GROUP 34 comando do adaptador R/3 -H 35 comando do adaptador R/3 -HOLDDATE 35 comando do adaptador R/3 -KEEP 35 comando do adaptador R/3 -L 36 comando do adaptador R/3 -LSN 36 comando do adaptador R/3 -P 37 comando do adaptador R/3 -PKT 37 comando do adaptador R/3 -REL 37 comando do adaptador R/3 -S 38 comando do adaptador R/3 -T 38 comando do adaptador R/3 -TID 39 comando do adaptador R/3 -TRANS 40 comando do adaptador R/3 -TY 40 comando do adaptador R/3 -U 40 comando do adaptador R/3 -X 41 comando do adaptador R/3 Auditoria (-AR3) 27 comando do adaptador R/3 Backup (-B) 28 comando do adaptador R/3 Balanceamento de Carga (-BAL) 29 comando do adaptador R/3 Cliente (-ASCLNT) 28 comando do adaptador R/3 Cdigo de Transao (-TRANS) 40

comando do adaptador R/3 Data de Suspenso (-HOLDDATE) 35 comando do adaptador R/3 Destino (-D) 31 comando do adaptador R/3 Escuta (-LSN) 36 comando do adaptador R/3 Grupo (-GROUP) 34 comando do adaptador R/3 Host Gateway (-G) 33 comando do adaptador R/3 ID do Host (-H) 35 comando do adaptador R/3 ID do Programa (-A) 27 comando do adaptador R/3 ID do Sistema (-S) 38 comando do adaptador R/3 ID do Usurio (-U) 40 comando do adaptador R/3 ID do Usurio do SAP (-ASUSER) 28 comando do adaptador R/3 Idioma de Logon (-L) 36 comando do adaptador R/3 Manter Sesso (-KEEP) 35 comando do adaptador R/3 Nmero do Cliente (-C) 30 comando do adaptador R/3 Rastreio (-T) 38 ativando 23 comando do adaptador R/3 Release (-REL) 37 comando do adaptador R/3 Senha (-P) 37 comando do adaptador R/3 Servio de Gateway (-X) 41 comando do adaptador R/3 Tamanho do Pacote (-PKT) 37 comando do adaptador R/3 Tipo de IDoc (-TY) 40 comando do adaptador R/3 Transaction ID (-TID) 39 comandos de conexo do adaptador ALE R/3 necessrio para destinos 24 necessrio para origens 24 opcional para destinos 24 opcional para origens 24 comandos de conexo do adaptador BAPI R/3 necessrio para destinos 24 comandos de conexo do adaptador BDC R/3 necessrio para destinos 24, 25 opcional para destinos 25 comandos de conexo do adaptador de sesso de entrada de lote -ASCLNT 28 -ASUSER 28 -GROUP 34 -HOLDDATE 35 -KEEP 35 -TRANS 40 para destinos de BDC 24 comandos de conexo do adaptador de Sesso de Entrada de lote para destinos de BDC 25 comandos de conexo do adaptador R/3 necessrio para origens ALE 24 necessrios para destinos de ALE, destinos de BDC e chamada de uma BAPI 24 opcional para origens e destinos de ALE 24 opcional para todas as origens e destinos 25 comandos de conexo do adaptador SAP R/3 necessrio para destinos de BDC 25 comandos de execuo 21 utilizando 22, 43, 81 comandos de execuo Consulte a lista de comandos dos adaptadores 43 comandos do adaptador ALE (Application Link Enabling) R/3 alias 42 resumos de sintaxe 42 comandos do adaptador BAPI (Business Application Programming Interface) R/3 alias 42 resumos de sintaxe 42 comandos do adaptador BDC (Batch Data Communication) R/3 alias 42

124

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

comandos do adaptador BDC (Batch Data Communication) R/3 (continuao) resumos de sintaxe 42 comandos do adaptador Consulte comandos do adaptador R/3 25 comandos do adaptador JALE R/3 resumos de sintaxe 41 comandos do adaptador R/3 41 aliases 42 enviando dados 22, 23, 51 na linha de comandos 21, 43 no Integration Flow Manager 23 no Map Designer 23 recuperando dados 21, 22, 43 resumos de sintaxe 41, 42 utilizando 22 comandos do adaptador R/3 IDoc comando do adaptador R/3 Gerao do Campo (-GEN) 33 comandos do adaptador SAP R/3 utilizando 23 compatibilidade de verses 5, 14, 59, 61, 76 comunicao entre sistemas a partir do sistema R3 12 com o sistema R/3 13 configuraes de backup em mapas 86 configuraes de dados 83 arquivos de log 81 configuraes do carto de entrada 21, 61, 78 exemplos 50, 69 configuraes do carto de sada exemplos 23, 51, 69, 70 consultando dados em tabelas do SAP viso geral 90 Criador da rvore de Tipo 17

exemplos (continuao) arquivos saprfc.ini 22, 32 balanceamento de carga usando arquivos saprfc.ini 30 cadeia de caracteres de comando para balanceamento de carga 30 cadeia de rota do SAP 35 comandos do adaptador na linha de comandos 21, 43, 70 funo GET() 22 funo PUT() 22 funo RUN() 22 registros de controle 3.x 54 registros de controle 4.x 56 substituio da sada para BDC 70 extenses de arquivo .bdc 68 .dx 59 .ido 46 .ini 22, 23, 24, 30, 31, 32, 33, 41, 43 .log 27, 81, 83 .mtr 38, 39, 81, 83 .mts 17 .tid 28, 29

F
formato beta DXOB 61 formato DXOB liberado 61 formatos de IDocs EDI convertidos em ALE 58 Formatos DXOB 61 beta 61 liberados 61 funo GET() 22, 83 funo PUT() 22, 83 funo RUN() 22, 78 funes 43 GET() 22, 78, 83 PUT() 22, 78, 83 RUN() 22, 78

D
dados principais 2, 3 para IDocs 45, 50 dependncias do software, incluindo externas 106 dependncias externas, incluindo 106 destino carto de sada 21, 70 placa de sada 61 diretrio tiddata 86 DXOB (Objeto de Transferncia de Dados) 59 arquivos de exemplo 60 rvores de tipo 61 definio 3, 59 mapeamento 61 relatrios 59 viso geral 59 DYNPRO (Dynamic Program) em sesses BDC 69

G
gateway especificaes 30, 32 gateway independente instalao 7, 9 grupo de logon usando para balanceamento de carga

24, 29

H
Host do Gateway especificando 10

E
entrada de metadados 17, 59, 60, 61, 68, 76 estrutura de negcios 75 exemplos arquivos .BDC 68 arquivos de log de auditoria 82 arquivos de rastreio detalhados 84 arquivos de rastreio do adaptador 83 arquivos DXOB 60 arquivos m4r3adapter.log 83

I
ID do usurio usando com o adaptador 32, 43, 52 Identificador Exclusivo Globalmente GUID 39 IDoc de comunicao 50 IDocs (Intermediate Documents) definio 2 fazendo download 47 formatos 45 ndice Remissivo

125

IDocs (Intermediate Documents) (continuao) registros de controle 46 registros de dados 46 registros de status 46 segmentos de dados 46 tipos 45 transmisso do pacote 14, 15 viso geral 45 IDs de transao 39 em sesses BDC 68 para arquivos de backup 28 para mensagens 19 importador BAPI R/3 executando 76 importador R/3 do BDC executando 68 importador R/3 do IDoc executando 47 importador R/3 DXOB executando 60 importadores R/3 BAPI 76 BDC 68 DXOB 60 IDoc 18, 46, 47 Importer Wizard executando 17, 48, 68 usando 17 Integration Flow Manager usando com comandos do adaptador R/3 23 usando com configuraes do mapa 86 interface ALE (Application Link Enabling) definio 3 implementao 48 viso geral 45 interface AMS (Message Handler) Consulte interface Message Handler (AMS) 3 interface Application Link Enabling (ALE) Consulte interface ALE (Application Link Enabling) 3 Interface de consulta para Software SAP processamento de sada 90 selecionando objetos de negcios 91, 99 viso geral 89 interface EDI (Electronic Data Interchange) rvores de tipo 47 definio 3 viso geral 45 interface Electronic Data Interchange (EDI) Consulte interface EDI (Electronic Data Interchange) 3 interface Message Handler (AMS) definio 3 interfaces R/3 2 interfaces SAP R/3 3 Intermediate Documents (IDocs) Consulte IDocs (Intermediate Documents) 2 intervalo 9, 15 configurando com o comando do adaptador R/3 -LSN 36

lista de comandos do adaptador para R/3 (continuao) Cliente (-enc) 31 Cdigo de Transao (-TRANS) 40 Data de Suspenso (-HOLDDATE) 35 Destino (-D) 31 Escuta (-LSN) 36 Gerao do Campo IDoc (-GEN) 33 Grupo (-GROUP) 34 Host Gateway (-G) 33 ID do Host (-H) 35 ID do Programa (-A) 27 ID do Sistema (-S) 38 ID do Usurio (-U) 40 ID do Usurio do SAP (-ASUSER) 28 Idioma de Logon (-L) 36 Manter Sesso (-KEEP) 35 Nmero do Cliente (-C) 30 Rastreio (-T) 38 Release (-REL) 37 Senha (-P) 37 Servio de Gateway (-X) 41 Tamanho do Pacote (-PKT) 37 Tipo de IDoc (-TY) 40 Transaction ID (-TID) 39 lista de comandos do adaptador R/3 Consulte lista de comandos do adaptador para R/3 25 loops de etapas 72

M
m4r3serial_number 28 manipulao de erros 11 mapas chamando uma BAPI 78 cdigos de retorno e mensagens de erro 82 configuraes 21, 69, 82, 86 criando 49, 50, 51, 61, 69 definindo regras de mapas 22, 78 Map Designer 23 resumo de execuo 82 usando comandos do adaptador R/3 21 mensagens 8, 21 tratado pelos adaptadores 36, 43 mtodo de Registro configurando como tipo de ativao 10 modo burst para adaptadores R/3 recuperao de dados 21

N
Nvel de rastreio de RFC 113 nome do campo em sesses BDC nmero da porta 41 69

O
Objeto de Transferncia de Dados (DXOB) Consulte DXOB (Objeto de Transferncia de Dados) 59 objetos de negcios 75 opes da lista de restrio utilizando 45 operaes de entrada 51 como um destino 61 definindo parmetros para perfis do parceiro 13, 15 para o SAP 19, 51, 70

L
linha de comandos comandos do adaptador 43 lista de comandos do adaptador para R/3 Auditoria (-AR3) 27 Backup (-B) 28 Balanceamento de Carga (-BAL) 29 Cliente (-ASCLNT) 28 25

126

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

operaes de sada como origem 50 definindo parmetros para perfis do parceiro do SAP 9, 51, 53 origem carto de entrada 19, 50 placa de entrada 21, 61, 69

14

P
Pasta do caminho de rastreio de RFC 110 Pastas para Arquivos de Rastreio de RFC 110 perfis do parceiro 13, 14 gerando 13 parmetros de entrada 15 parmetros de sada 14 processamento de entrada viso geral 89 processamento de erro coletivo 11 processamento de sada Interface de consulta para Software SAP 90 viso geral 89 programa de planejamento de transmisses falhas do processamento RSARFCEX 12 programas DX 59 programas/relatrios de planejamento RBDAPP01 Consulte o relatrio de planejamento de processamento de IDoc de plano de fundo RBDAPP01 15 RBDMOIND Consulte o relatrio de planejamento de transmisso de IDoc bem-sucedido RBDMOIND 15 RSARFCEX Consulte programa de planejamento de transmisses falhas do processamento RSARFCEX 12 properties connection factory (J2C) gerenciado configurando durante servio externo 103 Propriedade Cliente 109 propriedade de depurao do ABAP 108 Propriedade de entrega nica garantida 111 propriedade de especificao de interao 116 Propriedade de especificao de interao Nome da Funo 116 Nmero Mximo de Ocorrncias da Descoberta 117 Propriedade de ID do sistema SAP 115 Propriedade de nome da funo 116 Propriedade de nome do usurio 115 Propriedade de nmero da pgina de cdigos 109 Propriedade de nmero do sistema 115 Propriedade do cdigo do idioma 112 Propriedade do conjunto de caracteres padro 112 Propriedade do host do gateway 110 Propriedade do host do servidor de mensagens 112 Propriedade do servio de gateway 111 propriedade Nmero mximo de ocorrncias da descoberta 117 propriedade Senha 113 propriedades connection factory (J2C) gerenciado lista de 107 propriedades do connection factory (J2C) gerenciado configurando durante o importador 103 lista de 107

RBDMOIND relatrio de planejamento de transmisso de IDoc bem-sucedido 15 recuperao de dados para bursts 21 registros de controle para mapeamento de IDoc 46, 54 3.x 54 4.x 56 registros de dados de IDocs 46 registros de status de IDocs 46 relatrio de planejamento de processamento de IDoc de plano de fundo RDBAPP01 15 relatrio do analisador (RSEIDOC3) 17, 46, 47 relatrio do analisador de IDoc (RSEIDOC3) 46 relatrio do analisador de IDoc RSEIDOC3 46 relatrio RSEOUT00 de envio de IDocs 14, 50 Remote Function Calls (RFCs) configurando opes de gateway 10 Remote Function Calls (RFCs) Consulte RFCs 9 requisitos de instalao arquivos de correo e transporte 5 SAP Integration Pack 7 SAP Integration Package 5 Requisitos do Design Studio instalao 5 sistema 5 resoluo de problemas cdigos de retorno e mensagens de erro 82, 84 ferramentas 81 ressubmetendo uma transao 39 resumos de sintaxe 41, 42 comandos do adaptador ALE R/3 42 comandos do adaptador BAPI R/3 42 comandos do adaptador BDC R/3 42 comandos do adaptador JALE R/3 41 RfcOpenEx definindo comandos e parmetros de conexo suportados pelo sistema R/3 43 RFCs adaptadores 19 ativao de destino 27 configurando um destino de RFC 9 processamento de erro coletivo 11 roteador 35 cadeia de rota 33, 35

S
SAP interfaces R/3 3 parmetro Logon ou SAPGUI 35 SAP Integration Pack componentes 7 interfaces R/3 3 SAP Integration Package componentes 5, 19, 47, 60, 68, 77, 78 interfaces R/3 2 notas sobre o release 5 sobre 1 segmentos de dados de IDocs 46 Servio de gateway especificando 11 Servidor de Comandos Mtodo de Registro 36 opes do comando do adaptador R/3 -LSN Servidor de Eventos 23 sesses BDC 65 DYNPRO (Dynamic Programs) 69

R
Rastreio de RFC em 114

36

ndice Remissivo

127

sesses BDC (continuao) nome do campo 69 transaction ID (FK01) 68 sistemas externos 1, 3 sistemas lgicos 8, 9 sistemas R/3 criando um sistema lgico para opes de gateway 10 trocando dados 12 usando comandos 43 utilizando comandos 43 sistemas SAP R/3 trocando dados 2

U
userid para acesso ao sistema usurio CPIC 40 8 32

V
varivel de ambiente RFC_INI VERBOSE arquivos de rastreio 84 exemplos 84 Viso Geral 1 31

T
tabela BDC 65 tabela independente do cliente 8 tabelas SAP estrutura do objeto de negcios 90 target carto de sada 19, 21, 23, 69 placa de sada 51 TCP/IP 5 tipo de ativao configurando como Registro 10 tipo de documento OTHER$ 40 tipo de grupo BDC_Session 68 tipos de documentos OTHER$ 40 tipos de mensagens Modelo de Distribuio 12 transao de carregamento de dados da sesso BDC (ZBDS) 70 loops de etapas 72 transao de criao/manuteno do destino de RFC (SM59) 9, 27 transao de criao/manuteno do Sistema Lgico (BD54) 8 transao de definio de perfil do parceiro (WE20) criando 13, 14 modificando 14 transao de dispatch/coleta de IDoc (BD88) 50 transao de download de metadados IDoc (WE63) 48 transao de gerao de perfil do parceiro (BD82) 13 transao de gravao de sesso BDC (SHDB) 66 transao de manuteno do modelo de distribuio (BD64) 12 transao de manuteno do Modelo de Distribuio (BD64) tipos de mensagens 12 transao de monitoramento de RFC (SM58) 12, 40, 54 transao de processamento de sesso de entrada de lote (SM35) 63, 65, 66, 72, 73 transao de processamento de sesso de entrada de lote (ZBDS) 71 transao de relatrio de estrutura BDC (ZBDC) 67 transao de seleo da BAPI (SE37) 77 Transaes SM58 (monitoramento de RFC) 11 SM59 (destino de RFC) 10, 11 Transaction Identifier (TID) 28 transaction IDs (TIDs) da mensagem 19 transactional Remote Function Calls (tRFCs) 1 tRFCs Consulte transactional Remote Function Calls (tRFCs) 1

128

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3

Impresso em Brazil