Mais e Mais Sobre IDOC

8/13/2019 Mais e Mais Sobre IDOC

1/136

IBM WebSphere Transformation Extender

Guia de Integrao do Pack para SAP R/3

Verso 8.3


2/136

NotaAntes de utilizar estas informaes, leia as informaes gerais emAvisos na pgina 119.

Novembro de 2009

Esta edio deste documento se aplica ao IBM WebSphere Transformation Extender Verso 8.3 e a todos os releasese modificaes subsequentes, at que seja indicado o contrrio em novas edies.

Para enviar comentrios sobre esse documento, envie um e-mail para [email protected]. Aguardamos seuscomentrios.

A IBM pode utilizar ou distribuir as informaes fornecidas da forma que julgar apropriada, sem incorrer emqualquer obrigao para com o Cliente.

Copyright International Business Machines Corporation 2006, 2009.


3/136

ndice

Captulo 1. Apresentao . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Viso Geral do WebSphere Transformation Extender Pack para SAP . . . . . . . . . . . . . . . . . 1

Integrando Informaes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Viso Geral das Interfaces SAP R/3. . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Intermediate Documents (IDocs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2DXOB/Data Migration Interface (DMI) . . . . . . . . . . . . . . . . . . . . . . . . . 3Business Application Programming Interface (BAPI) . . . . . . . . . . . . . . . . . . . . . 3Batch Data Communication (BDC) . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Captulo 2. Configurando seu Ambiente SAP R/3 . . . . . . . . . . . . . . . . . . 5Requisitos do Sistema e Instalao . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Instalando Arquivos de Correo e Transporte para o BDC . . . . . . . . . . . . . . . . . . . 5Servidor WebSphere Transformation Extender para SAP R/3 . . . . . . . . . . . . . . . . . . . 7SAP Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Configurando o Sistema SAP R/3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

1. Criando um Sistema Lgico (BD54) . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2. Criando um Destino de RFC para Dados de Sada (SM59) . . . . . . . . . . . . . . . . . . 93. Criando um Modelo de Distribuio (BD64). . . . . . . . . . . . . . . . . . . . . . . 124. Gerando um Perfil do Parceiro (BD82) . . . . . . . . . . . . . . . . . . . . . . . . 135. Criando Perfis do Parceiro Manualmente (WE20) . . . . . . . . . . . . . . . . . . . . . 13

Captulo 3. O Importer Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . 17Viso Geral do Importer Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Executando o Importer Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Captulo 4. Os Adaptadores R/3 . . . . . . . . . . . . . . . . . . . . . . . . . 19Viso Geral dos Adaptadores R/3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Suporte ao Unicode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Usando Comandos do Adaptador R/3 . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Substituies de Comandos de Execuo . . . . . . . . . . . . . . . . . . . . . . . . 21Configuraes de Cartes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Comportamento da Recuperao de Dados R/3 para Bursts . . . . . . . . . . . . . . . . . . 21Comportamento de OnFailure com Adaptadores R/3 . . . . . . . . . . . . . . . . . . . . 21Sintaxe e Uso de Comandos do Adaptador . . . . . . . . . . . . . . . . . . . . . . . . 21Funes RUN, GET e PUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22A partir do Map Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23A partir do Integration Flow Manager . . . . . . . . . . . . . . . . . . . . . . . . . 23

Comandos de Conexo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Comandos de Conexo Necessrios para Origens JALE e ALE . . . . . . . . . . . . . . . . . 24Comandos de Conexo Necessrios para Destinos de ALE, Destinos de BDC e Chamada de uma BAPI . . . 24Comandos de Conexo Opcionais para Origens e Destinos JALE e ALE . . . . . . . . . . . . . . 24Comandos de Conexo de Sesso de Entrada de Lote para Destinos BDC . . . . . . . . . . . . . 25Comandos de Conexo Opcionais para todas as Origens e Destinos . . . . . . . . . . . . . . . 25

Lista de Comandos do Adaptador . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25ID do Programa (-A) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Auditoria (-AR3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Cliente (-ASCLNT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28ID do Usurio do SAP (-ASUSER) . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Backup (-B) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Balanceamento de Carga (-BAL) . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Nmero do Cliente (-C) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Codificao do Conjunto de Caracteres (-enc) . . . . . . . . . . . . . . . . . . . . . . . 31Destino (-D) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Host Gateway (-G) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Gerao de Campo IDoc (-GEN) . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Copyright IBM Corp. 2006, 2009 iii


4/136

Grupo (-GROUP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34ID do Host (-H) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Data de Suspenso (-HOLDDATE). . . . . . . . . . . . . . . . . . . . . . . . . . . 35Manter Sesso (-KEEP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Idioma de Logon (-L) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Escuta (-LSN). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Encadeamentos do Ouvinte (-N) . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Senha (-P) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Tamanho do Pacote (-PKT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Release (-REL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Reprocessar Arquivos de Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . 38ID do Sistema (-S) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Tempo Limite (-timeout) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Rastreio (-T) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Transaction ID (-TID) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Cdigo de Transao (-TRANS). . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Tipo de IDoc (-TY) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40ID do Usurio (-U) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Servio de Gateway (-X) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Resumos de Sintaxe para Adaptadores R/3 . . . . . . . . . . . . . . . . . . . . . . . . . 41Resumo de Sintaxe de Comandos do Adaptador JALE . . . . . . . . . . . . . . . . . . . . 41Resumos de Sintaxe de Comandos do Adaptador ALE . . . . . . . . . . . . . . . . . . . . 42Resumos de Sintaxe de Comandos do Adaptador BDC . . . . . . . . . . . . . . . . . . . . 42Resumos de Sintaxe de Comandos do Adaptador BAPI. . . . . . . . . . . . . . . . . . . . 42

Aliases do Adaptador R/3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Usando Comandos do Sistema R/3 . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Captulo 5. Intermediate Documents (IDocs). . . . . . . . . . . . . . . . . . . . 45Viso Geral de IDocs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Formato Estrutural do IDoc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Gerando o Relatrio do Analisador de IDoc . . . . . . . . . . . . . . . . . . . . . . . . 46Usando o Importer Wizard para IDocs . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Entendendo a rvore do Tipo IDoc . . . . . . . . . . . . . . . . . . . . . . . . . . 47Implementando uma Interface ALE . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Seleo e Download de Metadados IDoc (WE63) . . . . . . . . . . . . . . . . . . . . . . 48

Criando o Arquivo de Metadados Unicode . . . . . . . . . . . . . . . . . . . . . . . . 49Mapeamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Usando o Importer Wizard para ALE . . . . . . . . . . . . . . . . . . . . . . . . . . 49Criando um Mapa de Sada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Processos de Entrada e de Sada . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Entrada de ALE para o SAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Sada de ALE do SAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Registros de Controle para Mapeamento de IDoc . . . . . . . . . . . . . . . . . . . . . . . 54Exemplo de Registro de Controle 3.x . . . . . . . . . . . . . . . . . . . . . . . . . . 54Exemplo de Registro de Controle 4.x . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Enviando IDocs EDI Usando ALE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Captulo 6. Objetos de Transferncia de Dados (DXOB) . . . . . . . . . . . . . . . 59Viso Geral dos Objetos de Transferncia de Dados . . . . . . . . . . . . . . . . . . . . . . 59

Gerando Metadados DXOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Ambiente de Trabalho de Transferncia de Dados (SXDA) . . . . . . . . . . . . . . . . . . . 60

Mapeamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Usando o SAP:DXOB Importer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Criando um Mapa para Dados Formatados DXOB . . . . . . . . . . . . . . . . . . . . . 61

Transferindo os Dados Mapeados . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Transferindo os Dados Mapeados para a Camada de Aplicativo . . . . . . . . . . . . . . . . . 62Criando a Sesso de Entrada de Lote . . . . . . . . . . . . . . . . . . . . . . . . . . 62Processando a Sesso de Entrada de Lote (SM35) . . . . . . . . . . . . . . . . . . . . . . 63

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

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


5/136

Viso Geral do BDC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Gravando uma Sesso BDC (SHDB) . . . . . . . . . . . . . . . . . . . . . . . . . . . 66Criando o Relatrio de Estrutura BDC (ZBDC) . . . . . . . . . . . . . . . . . . . . . . . 67Mapeamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Entendendo a rvore do Tipo BDC . . . . . . . . . . . . . . . . . . . . . . . . . . 68Criando um Mapa para Dados Formatados da Sesso BDC . . . . . . . . . . . . . . . . . . 69

Carregando os Dados da Sesso BDC. . . . . . . . . . . . . . . . . . . . . . . . . . . 70Carregando os Dados (ZBDS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Processando uma Sesso de Lote (SM35) . . . . . . . . . . . . . . . . . . . . . . . . 73

Captulo 8. Business Application Programming Interface (BAPI) . . . . . . . . . . . 75Viso Geral da Interface (BAPI). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Mapeamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Entendendo a rvore do Tipo BAPI . . . . . . . . . . . . . . . . . . . . . . . . . . 77Chamando uma BAPI a partir de um Mapa . . . . . . . . . . . . . . . . . . . . . . . 78Unicode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Captulo 9. Resoluo de Problemas . . . . . . . . . . . . . . . . . . . . . . . 81Ferramentas de Resoluo de Problemas. . . . . . . . . . . . . . . . . . . . . . . . . . 81Log MapAudit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Log de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Auditoria de Execuo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Configuraes do Mapa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Configuraes de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Arquivos de Auditoria do Adaptador R/3 . . . . . . . . . . . . . . . . . . . . . . . . . 83Arquivos de Rastreio do Adaptador R/3 . . . . . . . . . . . . . . . . . . . . . . . . . 83

Rastreio do Adaptador R/3 - Opo Detalhado . . . . . . . . . . . . . . . . . . . . . . 84Cdigos de Retorno e Mensagens de Erro do R/3 . . . . . . . . . . . . . . . . . . . . . . 84Visualizando Dados de Origem e de Destino do R/3 . . . . . . . . . . . . . . . . . . . . . 85

Configuraes de Backup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Dados Temporrios Restantes no Diretrio TIDDATA . . . . . . . . . . . . . . . . . . . . . 86

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

Antes de Comear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Viso Geral do WebSphere Adapter para SAP Software . . . . . . . . . . . . . . . . . . . . 88

Preparando o Ambiente para os WebSphere Adapters . . . . . . . . . . . . . . . . . . . . . 93Propriedades de Conexo do SAP para o Assistente de Conexo do Adaptador. . . . . . . . . . . . . 94Configurando o Adaptador para Processamento da Query interface for SAP Software . . . . . . . . . . 99

Selecionando Objetos de Negcios e Servios . . . . . . . . . . . . . . . . . . . . . . . 99Configurando os Objetos Selecionados . . . . . . . . . . . . . . . . . . . . . . . . . 102Configurando Propriedades de Implementao e Gerando o Servio . . . . . . . . . . . . . . . 103

Desenvolvendo Mapas Usando o WebSphere Adapters . . . . . . . . . . . . . . . . . . . . 104Conectando-se a um Enterprise Information System . . . . . . . . . . . . . . . . . . . . 105Depurando Mapas que Contm WebSphere Adapters . . . . . . . . . . . . . . . . . . . . 106

Informaes de Referncia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Incluindo Dependncias de Software Externas . . . . . . . . . . . . . . . . . . . . . . 106

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

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

ndice v


6/136

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


7/136

Captulo 1. Apresentao

Uma introduo para o WebSphere Transformation Extender Pack para SAP R/3inclui:

v Viso Geral do WebSphere Transformation Extender Pack para SAPv Integrando Informaes

v Viso Geral das Interfaces SAP R/3

Viso Geral do WebSphere Transformation Extender Pack para SAPO WebSphere Transformation Extender Pack para SAP uma tecnologia exclusivade transformao de dados para servir de interface entre aplicativos de softwareSAP R/3 e aplicativos de terceiros e sistemas legados. A conectividade com oambiente SAP R/3 fornecida para dados de entrada e de sada, alm de sersuportada na maioria das plataformas SAP. As comunicaes so semelhantes comunicao do SAP R/3, exceto se os componentes usados no WebSphereTransformation Extender e no WebSphere Transformation Extender Pack para SAPaparecerem 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 garanteuma comunicao efetiva e segura entre sistemas externos e o SAP R/3. No necessrio um conhecimento detalhado das RFCs para criar interfaces para o SAPR/3 que sejam confiveis, eficientes e fceis de manter. Algum conhecimento daBase 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 deum 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 sseguintes verses: SAP R/3 4.6, 4.7, mySAP 2004 (ECC 5.0) e mySAP 2005(ECC 6.0).

Nota: Neste documento, install_dirrefere-se ao local em que o WebSphereTransformation Extender est instalado.

Integrando InformaesO sucesso com o SAP R/3 depende de uma capacidade de integrar e compartilharinformaes com outros sistemas. Em uma configurao corporativa tpica, umnico sistema SAP R/3 precisa integrar-se a uma ampla variedade de aplicativos.Isso inclui sistemas legados, aplicativos fornecidos por terceiros e outros sistemasSAP do corporativo.

Copyright IBM Corp. 2006, 2009 1
http://../concepts/c_pack_sapr3_Overview_Ascential_Pack_for_SAP_R_3.ditahttp://../concepts/c_pack_sapr3_Overview_Ascential_Pack_for_SAP_R_3.ditahttp://../concepts/c_pack_sapr3_Overview_Ascential_Pack_for_SAP_R_3.ditahttp://../concepts/c_pack_sapr3_Integrating_Information.ditahttp://../concepts/c_pack_sapr3_Integrating_Information.ditahttp://../concepts/c_pack_sapr3_Integrating_Information.ditahttp://../concepts/c_pack_sapr3_SAP_R_3_Interfaces.ditahttp://../concepts/c_pack_sapr3_SAP_R_3_Interfaces.ditahttp://../concepts/c_pack_sapr3_SAP_R_3_Interfaces.ditahttp://../concepts/c_pack_sapr3_SAP_R_3_Interfaces.ditahttp://../concepts/c_pack_sapr3_Integrating_Information.ditahttp://../concepts/c_pack_sapr3_Overview_Ascential_Pack_for_SAP_R_3.dita


8/136

Produo

Bancos de Dados Legados Aplicativos de Terceiros

Matrizes

Dados de refernciaRelatrio financeiroCompra centralSistemas de informaes

Remessa e recebimentoControle de produoGerenciamento de inventrioCompra local

Entrada do pedidoRemessa e faturamentoGerenciamento de inventrioCompra local

Comrcio Eletrnico

Outros Aplicativos

R/3

Aplicativos DistribudosVendas

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

Viso Geral das Interfaces SAP R/3O WebSphere Transformation Extender Pack para SAP, juntamente com oWebSphere Transformation Extender, suporta as seguintes interfaces e tecnologiasque 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 doAdaptador.

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

2 IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP R/3
http://../references/r_pack_sapr3_Adapter_Commands_List.ditahttp://../references/r_pack_sapr3_Adapter_Commands_List.ditahttp://../references/r_pack_sapr3_Adapter_Commands_List.ditahttp://../references/r_pack_sapr3_Adapter_Commands_List.ditahttp://../references/r_pack_sapr3_Adapter_Commands_List.ditahttp://../references/r_pack_sapr3_Adapter_Commands_List.ditahttp://../references/r_pack_sapr3_Adapter_Commands_List.dita


9/136

ALE (Application Link Enabling)A ALE vincula vrios sistemas SAP R/3 em ambientes distribudos e sistemasno-SAP ao SAP R/3 sem transferncias de arquivo para arquivo. A arquiteturaSAP R/3 suporta a transferncia de dados entre os aplicativos usando o sistema demensagens em vez de arquivos. O SAP R/3 permite a criao de um conjuntodistribudo totalmente integrado de aplicativos fracamente acoplados.

O Pack suporta a integrao de sistemas SAP R/3 distribudos na ALE e o fluxo deinformaes entre vrios sistemas SAP R/3 para realizar objetivos de negciosespecficos. O Pack tambm inclui a integrao entre aplicativos no-SAP R/3,como aplicativos de terceiros ou sistemas legados, fornecendo a tecnologia deconverso necessria para realizar esse nvel de integrao entre sistemas distintos.

O adaptador ALE (JALE) do SAP R/3 do WebSphere Transformation Extenderinclui suporte a dados do conjunto de caracteres Unicode para entrada e sada doSAP.

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

Electronic Data Interchange (EDI)A EDI fornece s empresas a capacidade de comunicar transaes de negcios edocumentos eletronicamente a seus parceiros, fornecedores e clientes.

DXOB/Data Migration Interface (DMI)DXOBs so objetos de negcios SAP R/3 que podem ser transferidosautomaticamente para o sistema SAP R/3. Exemplos de objetos de negcios sounidades organizacionais ou dados principais. O suporte ao WebSphere

Transformation Extender Pack para SAP da interface DXOB inclui estruturas deobjetos de transferncia de dados nos formatos beta e liberados. Durante atransferncia de dados, os dados so transferidos de um sistema externo para osistema SAP R/3.

Os aplicativos SAP suportam a transferncia de dados de diversos objetos denegcios SAP. O programa de transferncia de dados especifica a definio doformato de dados necessria para importar os dados para o sistema SAP R/3. OPack fornece o servidor de transformao de dados para converter o formato dedados do sistema externo no formato do objeto DX.

Business Application Programming Interface (BAPI)

O adaptador BAPI (JBAPI) do WebSphere Transformation Extender ativa o suportecompleto ao Unicode quando instalado com a verso mais recente do WebSphereTransformation Extender. O adaptador JBAPI fornece acesso unificado aos sistemasUnicode e no-Unicode. A BAPI fornece uma interface orientada a negcios paraacessar processos e dados de negcios SAP R/3 de sistemas externos. As BAPIsfazem parte da estrutura de negcios do SAP, uma arquitetura aberta baseada emcomponente que permite a integrao de componentes de software do SAP e deoutros provedores.

O WebSphere Transformation Extender Pack para SAP suporta a capacidade dechamar uma BAPI sncrona na regra de mapeamento de um carto de sada. Os

Captulo 1. Apresentao 3


10/136

dados retornados da BAPI podem ser mapeados para outros objetos de dados desada ou podem ser usados para lgica condicional. Os adaptadores SAP R/3suportam 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 dadose incluem todas as validaes construdas na transao. As sesses BDC tambmso conhecidas como Sesses de Entrada de Lote.

O WebSphere Transformation Extender Pack para SAP fornece um recurso degravao de BDC para gravar uma transao de amostra. O Importer Wizardformata a gravao em uma rvore do tipo que pode ser usada para mapear osdados diretamente para um formato de tabela BDC, que processado peloservidor de transformao.



11/136

Captulo 2. Configurando seu Ambiente SAP R/3

Os requisitos do sistema para instalao e execuo do SAP R/3 nas plataformasWindows 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 ativaode destinos de RFC so discutidos. H tambm uma descrio de como configuraro ambiente SAP R/3 para enviar e receber dados com xito.

v Requisitos do Sistema e Instalaov Servidor WebSphere Transformation Extender para SAP R/3v SAP Gateway

v Configurando o Sistema SAP R/3

Requisitos do Sistema e InstalaoConsulte o arquivo readme_sap.txtpara obter detalhes sobre os requisitos mnimos

do sistema e as instrues para instalar ou remover o produto SAP R/3 baseado noWindows.

Nota: Alm dos requisitos mnimos do sistema, o TCP/IP deve ser instaladosuportando o acesso do Design Studio para o sistema SAP R/3.

O WebSphere Transformation Extender instalado em uma plataforma MicrosoftWindows e contm os componentes do produto necessrios para estabelecer umambiente de tempo de construo para o desenvolvimento de mapas. Alm doDesign Studio, h vrios componentes do produto WebSphere TransformationExtender Pack para SAP instalados que facilitam o desenvolvimento de interfacesSAP R/3:

v Exemplos de cada uma das interfaces SAP R/3 suportadas pelo WebSphere

Transformation Extender Pack para SAPv 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 BDCPor Que e Quando Desempenhar Esta Tarefa

Durante o processo de instalao do WebSphere Transformation Extender Packpara SAP, os arquivos de Correo e Transporte so copiados para seu sistema.Esses arquivos so usados na criao de interfaces BDC e devem ser instaladoscomo objetos no sistema SAP R/3.

Nota: Geralmente, a equipe de instalao do Aplicativo SAP executa esteprocedimento.

Para instalar os arquivos de Correo e Transporte para o BDC:

1. Verifique se os seguintes objetos no existem como objetos gravados pelocliente no sistema R/3 de destino:

v Elemento de Data - ZTSIDE320

v Mdulo Funcional - Z_TSI_M4BDC_SUBMIT

http://../concepts/c_pack_sapr3_System_Requirements_and_Installation.ditahttp://../concepts/c_pack_sapr3_System_Requirements_and_Installation.ditahttp://../concepts/c_pack_sapr3_System_Requirements_and_Installation.ditahttp://../concepts/c_pack_sapr3_DataStage_TX_for_R_3_Server.ditahttp://../concepts/c_pack_sapr3_DataStage_TX_for_R_3_Server.ditahttp://../concepts/c_pack_sapr3_DataStage_TX_for_R_3_Server.ditahttp://../concepts/c_pack_sapr3_SAP_Gateway.ditahttp://../concepts/c_pack_sapr3_SAP_Gateway.ditahttp://../concepts/c_pack_sapr3_SAP_Gateway.ditahttp://../concepts/c_pack_sapr3_Configuring_the_R_3_System.ditahttp://../concepts/c_pack_sapr3_Configuring_the_R_3_System.ditahttp://../concepts/c_pack_sapr3_Configuring_the_R_3_System.ditahttp://../concepts/c_pack_sapr3_Configuring_the_R_3_System.ditahttp://../concepts/c_pack_sapr3_SAP_Gateway.ditahttp://../concepts/c_pack_sapr3_DataStage_TX_for_R_3_Server.ditahttp://../concepts/c_pack_sapr3_System_Requirements_and_Installation.dita


12/136

v Estrutura - ZTSIC320

v Grupo de Funo - ZTS9

v Programas - ZM4BDCSS e ZM4BDCTT

v Classe de Desenvolvimento - ZTS8

v Cdigos de Transao - ZBDC e ZBDS

Se algum desses objetos existir, ele dever ser renomeado ou redesignadono(s) sistema(s) de destino.

2. Confirme se os arquivos de Correo e Transportek900094.sp3e r900094.sp3esto localizados no diretrio install_dir\bdc.

3. Instalek900094.sp3e r900094.sp3como objetos no sistema R/3 de destino.Uma maneira de fazer isso usar o programaR3TRANSdo Nvel de SistemaOperacional em que o SAP est instalado.

a. Efetue logon no sistema operacional do servidor SAP como administradordo sistema SAP.

b. Copie os arquivos de Correo & Transporte para os diretrios a seguir,localizados usualmente emc:\usr\sap\transdo servidor SAP:

Copie o arquivo de Correo & Transportek900094.sp3para o diretrio

\cofiles\.c. No prompt do DOS do servidor SAP, v parac:\usr\sap\trans\bine

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 dosobjetos importados:

4 ETW000 Summary:4 ETW0004 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/nSE38no campo decomando do SAP.

4. InsiraZM4BDCSSpara o nome doPrograma.5. Ative a caixa de opoAtributospara modificar o programa ABAP.

6. Clique no botoAlterar.

A janela ABAP: Modificao dos Atributos do Programa ZM4BDCSS aparece.

7. Ative a caixa de opoVerificaes do Unicode ativas.

8. Clique no botoSalvar.

9. Clique no botoAtivar.

10. Repita estas etapas para alterar os atributos do programaZM4BDCTTparaVerificaes do Unicode ativas.



13/136

a. Efetue logon no cliente SAP. Insira a transaoSE80no campo decomando. Insira ZTSI para o Pacote. A janela a seguir aberta.

Nota: Se todos os objetos da captura de tela NO ficarem visveis ou sevoc receber um erro ao chamar essas duas transaes, sernecessrio investigar iniciando pelo arquivo R3Trans.log. Quandovoc tiver corrigido o erro, refaa a importao.

b. No campo de comando do SAP, chame as transaes/nZBDCe/nZBDS.

Servidor WebSphere Transformation Extender para SAP R/3O servidor no qual o WebSphere Transformation Extender e o WebSphereTransformation Extender Pack para SAP so instalados ser referido como ServidorWebSphere 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.3v Sun Solaris 9 e 10v 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 WebSphereTransformation Extender para R/3 ao sistema SAP R/3.

Nota: A biblioteca do cliente SAP RFC 6.40 ou mais recente usada em todas asplataformas.

Se o SAP Front End tiver sido instalado no sistema Windows, essa biblioteca jdever estar instalada em Windows\system32. Verifique para assegurar-se de quetenha a verso correta.

Se o SAP Front End no estiver instalado, consulte seu Administrador do SAP paraobter essa biblioteca do SAP. Consulte aNota 19466no Web site do ServiceMarketplace para obter detalhes sobre como obter downloads.

v Se voc estiver instalando o SAP Pack no Windows, copie a biblioteca paraqualquer diretrio em PATH.

v Se estiver instalando o SAP Pack no UNIX, transfira a biblioteca por ftp paraqualquer diretrio especificado pela varivel de ambiente LD_LIBRARY_PATH(Sun Solaris), LIB_PATH (aix) ou SHLIB_PATH (hp).

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

Captulo 2. Configurando seu Ambiente SAP R/3 7


14/136

comunicao recomendado pelo SAP. O SAP requer o uso de um gatewayindependente para todas as interfaces ALE certificadas.

Nota: Para obter informaes sobre como instalar o SAP Gateway, consulte adocumentao do SAP.

Configurando o Sistema SAP R/3Seu sistema SAP R/3 deve ser configurado adequadamente para enviar e receberdados. 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) debase associado ao cliente SAP.

Nota: Essa associao criada geralmente no momento da instalao pela equipede instalao dos Aplicativos SAP.

Todo LS de base torna-se o emissor de mensagens de sada e um receptor demensagens 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. Emuma interface ALE/RFC de entrada, este segundo LS representa o emissor emrelao ao LS de base. Em uma interface ALE/RFC de sada, este segundo LS umreceptor.

possvel criar um sistema lgico para cada sistema externo que se comunicarcom o SAP R/3. O design de seus mapas e sistemas determinam o que umsistema externo. Geralmente voc cria um sistema externo para corresponder acada sistema no-SAP distinto.

A transaoBD54cria um sistema lgico para representar o sistema servidor paraa distribuio de dados de e para o sistema SAP R/3.

Para criar um sistema lgico1. Insira/nBD54no campo de comando e clique em Enter.

2. Clique emEnterna janela de informaes, que alerta que voc est no processode manuteno de uma tabela independente do cliente e que quaisquermudanas feitas tero efeito em todos os outros clientes no sistema.

A janela Alterar Visualizao Sistemas Lgicos: Viso Geral aberta, listandoos sistemas lgicos definidos atualmente.

3. Clique emNovas entradaspara criar o sistema lgico (LS).

A janela Novas Entradas: Viso Geral de Entradas Includas aberta.

http://../tasks/t_pack_sapr3_1_Creating_a_Logical_System_BD54.ditahttp://../tasks/t_pack_sapr3_1_Creating_a_Logical_System_BD54.ditahttp://../tasks/t_pack_sapr3_1_Creating_a_Logical_System_BD54.ditahttp://../tasks/t_pack_sapr3_2_Creating_RFC_Destination_for_Outbound_Data_SM59.ditahttp://../tasks/t_pack_sapr3_2_Creating_RFC_Destination_for_Outbound_Data_SM59.ditahttp://../tasks/t_pack_sapr3_2_Creating_RFC_Destination_for_Outbound_Data_SM59.ditahttp://../tasks/t_pack_sapr3_3_Creating_a_Distribution_Model_BD64.ditahttp://../tasks/t_pack_sapr3_3_Creating_a_Distribution_Model_BD64.ditahttp://../tasks/t_pack_sapr3_3_Creating_a_Distribution_Model_BD64.ditahttp://../tasks/t_pack_sapr3_4_Generating_a_Partner_Profile_BD82.ditahttp://../tasks/t_pack_sapr3_4_Generating_a_Partner_Profile_BD82.ditahttp://../tasks/t_pack_sapr3_4_Generating_a_Partner_Profile_BD82.ditahttp://../tasks/t_pack_sapr3_4_Generating_a_Partner_Profile_BD82.ditahttp://../tasks/t_pack_sapr3_3_Creating_a_Distribution_Model_BD64.ditahttp://../tasks/t_pack_sapr3_2_Creating_RFC_Destination_for_Outbound_Data_SM59.ditahttp://../tasks/t_pack_sapr3_1_Creating_a_Logical_System_BD54.dita


15/136

4. Insira um nome para o LS e uma descrio significativa. (Neste exemplo, onome do LS serCUSTOMERLS. O nome do LS de base E47CLNT800.)

Nota: A conveno de nomenclatura seguida para o LS deve ser informativaporque ela ser usada para nomear o destino de RFC e os perfis dosparceiros.

5. SelecioneCTRL + F4.

A caixa de dilogoAlterar == Exibir aberta para confirmar a mudana.

6. Clique emSim 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. Crieum 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. EscolhaSalvarno menuVisualizao de Tabelae clique emEnter.

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 processamentoALE. Quando a Determinao do Receptor identifica uma comunicao tRFC, odestino de RFC define a comunicao fsica para o destino remoto. Os destinos deRFC 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 instalaro gateway independente.

v

Opcionalmente, definindo opes de tRFC para configurar as especificaes denovas tentativas de conexo no caso de tempos limite de comunicao ou errosde conexo. Isso feito especificando-se o nmero de novas tentativas, alm dointervalo entre duas tentativas consecutivas. Alternativamente, voc podesuprimir a tarefa de plano de fundo para novas tentativas de conexo. O SAPR/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 RFCPor 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/nsm59no campo de comando e clique em Enter.

A janela Exibir e Manter Destinos de RFC aberta.

2. Clique com o boto direito do mouse emConexes TCP/IPe clique emCriar.

A janela Destino de RFC aberta.

3. Insira as informaes conforme definido na tabela a seguir e clique em Enter. Ajanela Destino de RFC propagada com suas informaes.



16/136

Tabela 1. Detalhes da janela Destino de RFC

Campo Enter

Destino de RFC Insira o nome doDestino de RFC. Use o mesmo nome que oSistema Lgico.

Tipo de Conexo InsiraT (TCP/IP) para oTipo de Conexo.

Descrio Insira uma descrio significativa no campoDescrio.

4. Clique na guiaOpes Especiais. O recursoRastreioest localizado sob a guiaOpes Especiais. Voc pode ativar o Rastreiopara propsitos de teste;entretanto, no ative oRastreioem um ambiente de produo.

5. Clique na guiaConfiguraes Tcnicas. Insira as informaes conformedefinido na tabela a seguir e clique emEnter.

Tabela 2. Guia Configuraes Tcnicas

Campo Enter

Tipo de Ativao AtivePrograma do Servidor Registrado.

ID do Programa Insira oID do Programa. Esse o ID do programa especificado aousar o comando de adaptador ID do Programa (-A) para qualquerorigem R/3 (sada).

6. Clique na guiaLogon/Segurana. Ative ou desative a Opo de Segurana.Clique no botoSalvar.

Opes de GatewayPor Que e Quando Desempenhar Esta Tarefa

As opes de gateway so configuradas para corresponder exatamente aos valoresusados ao instalar o SAP Stand-Alone Gateway.

Para configurar as opes de gateway:

1. Insira a transao/nsm59no campo de comando e clique em Enter.A janela Exibir e Manter Destinos de RFC aberta.

2. ExpandaConexes TCP/IPe clique duas vezes na conexo TCP/IP aplicvel.

A janela Destino de RFC aberta.

3. Clique na guiaConfiguraes Tcnicas. Insira as informaes conformedefinido na tabela e, em seguida, clique em Enter.

Nota: Os valores paraHost Gatewaye Servio de Gatewaypodem ser nomessimblicos. Entretanto, a especificao do endereo IP e do nmero doservio pode melhorar o desempenho e reduzir erros.

Tabela 3. Opes de Gateway

Campo EnterHost Gateway Insira o nome ou o endereo IP de seu host gateway. (Neste exemplo,

192.168.1.229.)

O valor inserido emHost Gateway o valor especificado ao usar ocomando de adaptador Host Gateway (-G) para qualquer origemSAP R/3. Esse valor deve corresponder exatamente.



17/136

Tabela 3. Opes de Gateway (continuao)

Campo Enter

Servio de gateway Insira o nome de seu servio de gateway. O servio de gateway onome do servio criado durante a instalao do software SAPStand-Alone Gateway. O padro sapgw00. Alternativamente, vocpode usar o endereo de porta em vez do nome do servio degateway (neste exemplo, o valor 3300.)

O valor inserido emServio de Gateway (-A) o valor especificadoao usar o comando de adaptador Servio de Gateway para qualquerorigem SAP R/3. Esse valor deve corresponder exatamente.

Opes de tRFCPor Que e Quando Desempenhar Esta Tarefa

Dependendo de sua configurao, pode ser til especificar novas tentativasautomticas para dados de sada. As Opes de tRFC(opes de nova tentativa)determinam o comportamento do SAP R/3 durante erros de comunicao oufalhas. Se voc estiver encontrando tempos limites de comunicao ou erros de

conexo frequentes (visveis no Monitoramento de tRFC do SM58), implementeessas opes de nova tentativa.

Nota: A configurao de Opes detRFC uma etapa nica. possvel manter asOpes de tRFC clicando no bototRFCna janela Destino de RFC.

Configure asOpes de tRFCpara especificar novas tentativas automticas paradados de sada. Alm disso, o SAP R/3 possui um recurso de processamento deerro coletivo que pode ser ativado, que executa manipulao de erros por meio deuma 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 emEnter

.A janela Exibir e Manter Destinos de RFC aberta.

2. ExpandaConexes TCP/IPe clique duas vezes na conexo TCP/IP aplicvel.(Para este exemplo, clique duas vezes em DATASTGTX1.)

Ajanela Destino de RFCaparece.

3. No menuDestino, escolhaOpes de tRFC.

A caixa de dilogoRFC Transacional: Configurao do Sistema para Erro deConexo aberta.

4. No campoSuprimir Tarefa de Plano de Fundo se conn.error, insira o valor Xe, em seguida, clique emContinuar.

Ajanela Destino de RFCreaparece.

5. No menuDestino, escolhaSalvar.Processamento de Erro ColetivoPor Que e Quando Desempenhar Esta Tarefa

O SAP R/3 trata dos erros de RFC iniciando um processo de segundo plano quereinicia a RFC at que ela seja processada com xito. Se a conexo com o sistemade recebimento for interrompida, esse processo poder ser executadoindefinidamente. Esse esquema pode resultar em um grande nmero de processosde segundo plano em execuo no sistema de envio, o que degradar odesempenho geral. Para minimizar esses efeitos em um ambiente de execuo, use



18/136


19/136

Nota: Um modelo de comunicao do sistema SAP R3 com um sistemaexterno (CUSTOMERLS) estabelecido.

6. Clique emEnter.

7. Retorne para a janela Alterar Modelo de Distribuio e continue com oprocesso de incluso de outro tipo de mensagem para concluir o modelo dedistribuio.

8. SelecioneSUBSYSTEMSe, em seguida, clique emIncluir 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 como 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 usaDEBMAS).

Nota: Um modelo de comunicao de um sistema externo com o sistemaR3 estabelecido.

10. Clique emEnterpara retornar janela Alterar Modelo de Distribuio.

11. No menuModelo, escolhaSalvare clique emEnter.

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 doparceiro. O perfil do parceiro gerado com base no Modelo de Distribuio e nadefinio da porta.

Para gerar um perfil do parceiro:1. Insira/nbd82no campo de comando e clique em Enter.

A janela Gerando Perfil do Parceiro aberta.

2. No campoVisualizao Modelo, selecione uma visualizao de modelo dedistribuio na lista suspensa. (Neste exemplo, SUBSYSTEMS.)

3. No campoSistema Parceiro, selecione um Sistema Lgico na lista suspensa.(Neste exemplo, CUSTOMERLS.)

4. SelecioneColetar IDocs e transferir. (Esse o padro, que pode ser alteradousando o cdigo de transaoWE20.)

5. SelecioneAcionar pelo processamento de segundo planopara que no hajasubstituio por sinalizadores expressos. (Esse o parmetro padro, que podeser alterado usando o cdigo de transaoWE20.)

6. Clique emExecutar.

A janela Gerando Perfil do Parceiro aberta listando as mensagens econfirmando 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 deDistribuio, a transaoBD82atualizar/criar automaticamente as definies de



20/136

perfil do parceiro e criar definies de porta RFC conforme necessrio. Noentanto, essas definies devero ser criadas ou modificadas manualmente emsituaes 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 aBiblioteca SAP On-linepara obter informaes adicionais.

v

Ao usar o mtodo de criao de IDoc baseado no arquivo EDI, voc precisarcriar manualmente os perfis do parceiro.

v Ao modificar os parmetros de Perfil do Parceiro antes da produo ou paracriar perfis de parceiro manualmente.

H situaes em que os perfis do parceiro devem ser criados ou modificadosmanualmente.

Para Criar Perfis do Parceiro Manualmente1. Insira a transao/nWE20no campo de comando e clique em Enter.

A janela Perfis do Parceiro aberta.

2. Selecione no menuParceiros,Criarou Exibir Mudana, para criar um novo

perfil ou para modificar um perfil existente.3. InsiraParmetros de sadaou Parmetros de entrada, conforme apropriado.

Resultados

Na janelaParmetros 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 paraa 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 paraenviar IDocs usando RFCs transacionais. Isso envia pacotes de IDoc em umatransmisso, usando um logon e pode fornecer melhor desempenho do que enviarIDocs individualmente. Evite enviar IDocs individuais porque cada transmissoenvolve sobrecarga significativa, como o carregamento de programas, oestabelecimento de conexo e a realizao de logon.

Ao usar RSEOUT00, observe o tamanho dos pacotes de IDoc, que podem serdefinidos nos parmetros de sada do contrato de parceiro correspondente. Para

otimizao, o tamanho dos objetos de dados envolvidos e o nmero de processosdisponveis nas extremidades de transmisso e de recebimento devem serconsiderados. O SAP R/3 recomenda, geralmente, a compactao de 2 a 20 IDocspor pacote para IDocs com vrios segmentos (como ALEUD e GLDCMT) e de 20 a2.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 paraativar as transmisses paralelas de pacotes de IDoc. Para o SAP R/3 verses 3.1i esuperior, o suporte de gerenciamento de recurso tRFC est disponvel. O SAP R/3avisa que, para evitar tempos limite, o nmero de processos de trabalho de dilogo



21/136

do lado do emissor deve ser menor ou igual ao nmero de processos disponveisno receptor. Consulte OSS note 74141na Documentao do SAP R/3 para obterdetalhes.

Ao enviar pacotes de IDoc em paralelo usando este mtodo, os pacotes nopodero ser recebidos na ordem serial. Se a serializao da transmisso de pacotesde IDoc for necessria, use um processo peridico nos pacotes recebidos. Para isso,

configure seus perfis de parceiro para processamento de segundo plano e selecioneum intervalo de processamento grande o suficiente para garantir que todos ospacotes interdependentes possam ser recebidos. Com base em seus registros dedata 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 nosignifica que foi uma transmisso de tRFC bem-sucedida. O relatrio RBDMOINDdeSE38deve ser iniciado regularmente para verificar se a comunicao foiconcluda com xito. Se concluda com xito, o status do IDoc ser alterado.

O relatrio RBDMOIND indica se os IDocs de sada foram transmitidos para acamada de comunicao com xito e se devem ser planejados para execuoregularmente.

Para Planejar o Relatrio RBDMOIND1. Defina variantes para a tarefa.

2. Planeje a tarefa com o relatrio e uma variante em uma etapa.

Parmetros de EntradaNa janela Perfis do Parceiro: Parmetros de Entrada, possvel incluir ou alterar asinformaes do perfil do parceiro, conforme necessrio.

Para alterar parmetros de entrada do Perfil do Parceiro, escolha o Tipo demensagemapropriado e oCdigo de processocorrespondente, vinculado aoMdulo 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 significativaenvolvida (como carregamento de programa, conexo e logon).

O tempo de processamento de entrada afetado na extremidade de recebimentoquando os pacotes de IDoc so separados inicialmente em IDocs separados e osIDocs de entrada individuais so armazenados no banco de dados. O controle detransmisso de aplicativo definido no contrato do parceiro correspondentedetermina se o IDoc deve ser processado imediatamente ou planejado paraprocessamento pelo programa RBDAPP01. O SAP recomenda o uso do RBDAPP01para melhorar o desempenho se o processamento imediato no for necessrio.

As informaes fornecidas so mnimas e podem no tratar de todos os requisitosde comunicao, como informaes sobre manuteno do cdigo de empresa



22/136

global, ativao do ponteiro de mudana, manuteno de intervalos de nmeros,etc. Consulte a Biblioteca SAP On-linepara obter informaes adicionais.

Alm disso, os valores de parmetros padro no perfil da instncia no sosuficientes para interfaces ALE com alto volume. Consulte a equipe de instalaodos Aplicativos SAP e as notas OSS para obter as mudanas recomendadas paraesses valores.



23/136

Captulo 3. O Importer Wizard

Use o Importer Wizard para importar arquivos BAPI, BDC, IDoc e DXOB paragerar 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 WizardO Importer Wizard usa a entrada de metadados especfica da estrutura do SAPR/3 para gerar rvores do tipo contendo as definies de tipo correspondentes. OImporter Wizard usa vrios mapas para converter metadados em um arquivo descript de rvore do tipo (extenso de arquivo.mts). O Criador da rvore de Tipoprocessa ento esse script da rvore de tipo e gera uma rvore de tipo contendotodos os tipos suportados definidos nos metadados importados.

Por exemplo, a ilustrao a seguir mostra vrios arquivos de definio de IDocRSEIDOC3 sendo importados para o Importer Wizard, que gera, automaticamente,a rvore do tipo correspondente.

Sistema SAP R/3

Definies deIDoc RSEIDOC3

Importer Wizard

Mapas doImportador

Criador darvore de Tipo

rvore do Tipo(.mtt)

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

Executando o Importer WizardPor Que e Quando Desempenhar Esta Tarefa

Quando a entrada de metadados do SAP contiver uma das estruturas suportadasdescrevendo os dados para os quais voc deseja criar uma interface, voc estarpronto para executar o Importer Wizard.

Para executar o Importer Wizard:

1. Inicie o Type Designer.

2. SelecioneImportar rvore do tipoe clique em OK.

http://../concepts/c_pack_sapr3_Overview_of_the_Importer_Wizard.ditahttp://../concepts/c_pack_sapr3_Overview_of_the_Importer_Wizard.ditahttp://../concepts/c_pack_sapr3_Overview_of_the_Importer_Wizard.ditahttp://../tasks/t_pack_sapr3_Running_the_Importer_Wizard.ditahttp://../tasks/t_pack_sapr3_Running_the_Importer_Wizard.ditahttp://../tasks/t_pack_sapr3_Running_the_Importer_Wizard.ditahttp://../tasks/t_pack_sapr3_Running_the_Importer_Wizard.ditahttp://../concepts/c_pack_sapr3_Overview_of_the_Importer_Wizard.dita


24/136

O Importer Wizard aberto.

3. Selecione a interface SAP (IDOC, DXOB, BDC, BAPI) para a qual deseja geraruma rvore do tipo e clique em Avanar.

4. A prxima caixa de dilogo aberta, solicitando informaes sobre o sistemaSAP que originou o arquivo de metadados que est sendo importado. Insira asinformaes apropriadas e clique emAvanar.

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 emAvanar.

6. As prximas caixas de dilogo que aparecero dependem da interface para aqual voc est gerando uma rvore do tipo. O Wizard apresenta as caixas dedilogo aplicveis para que voc especifique informaes especficas dainterface. Por exemplo, ao gerar uma rvore do tipo para a BAPI, a caixa dedilogo Configuraes de Conexo do SAP aparece para que voc possaespecificar parmetros de conexo do adaptador. Consulte cada captuloespecfico da interface para obter essas informaes.

7. Depois de inserir informaes especficas da interface apresentadas peloWizard, uma caixa de dilogo aberta solicitando o caminho e o nome de

arquivo completos dos metadados para os quais voc est gerando uma rvoredo tipo.

Especifique o objeto de metadados para o qual voc deseja gerar uma rvoredo tipo e fornea quaisquer informaes adicionais que o Importer Wizardprecisar para a interface especfica. Por exemplo, ao gerar rvores do tipo apartir de um IDoc, necessrio designar se o arquivo IDoc representar dadospara uma interfaceALE ou EDI. Consulte cada seo especfica da interfacepara 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 precisarpara a interface especfica e clique emAvanar. Consulte o captulo especficoda interface para obter informaes adicionais.

Nota: til usar uma conveno de nomenclatura. Por exemplo, para umainterface BDC, useBDC-xxxx.mtt, em que xxxx o cdigo de transaodo SAP.

9. A prxima caixa de dilogo do Importer Wizard ser aberta mostrando o statusda rvore do tipo que est sendo criada.

possvel rolar pela rvore do tipo. A caixa de dilogo do Importer Wizardtambm mostra o nmero de erros e avisos ocorridos durante a gerao darvore do tipo.



25/136

Captulo 4. Os Adaptadores R/3

Os componentes especficos do SAP para o ambiente de tempo de execuo doSAP 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 doadaptador, configuraes do adaptador e comandos do adaptador, incluindo:

v Viso Geral dos Adaptadores R/3v Usando os Comandos do Adaptador R/3v Comandos de Conexo

v Resumos de Sintaxes para Adaptadores R/3

v Aliases do Adaptador R/3v Usando Comandos do Sistema R/3

Viso Geral dos Adaptadores R/3

Ambas as funcionalidades, de cliente e de servidor, so suportadas em umadaptador 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. Oadaptador inclui integrao transparente das RFCs para que no seja necessriopossuir conhecimento detalhado sobre elas. Os adaptadores tambm gerenciaminformaes transacionais, como transaction IDs (TIDs) da mensagem, conformenecessrio. Esse recurso garante integrao perfeita com o SAP R/3, alm defornecer um mecanismo de auditoria eficiente.

Quando um mapa possui um carto de entrada que define um adaptador R/3como a origem, a funo de servidor do adaptador chamada para executar asRFCs necessrias para garantir uma coleta bem-sucedida dos dados de entrada apartir do sistema SAP R/3. Por exemplo, um sistema SAP R/3 possui dados queforam definidos como entrada para um mapa especfico executado em um Servidorde Comandos. O mapa contm um carto de entrada que possui o adaptador R/3definido como a origem do adaptador. O adaptador R/3 (servidor) recebe as RFCsnecessrias para recuperar os dados do SAP R/3. O adaptador passa, ento, osdados por meio de buffers de memria do SAP R/3 diretamente para o mapa emexecuo para transformao no formato de destino.

Para um carto de sada, depois que um mapa do WebSphere TransformationExtender transforma os dados de origem, a funo de cliente do adaptador R/3 chamada, executando as RFCs necessrias para garantir uma entrega bem-sucedidados 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/3so:

v JALE (para Unicode)

v ALEv JBAPI (para Unicode e no-Unicode)

v BAPI

v BDC

http://../concepts/c_pack_sapr3_Overview_of_the_R_3_Adapters.ditahttp://../concepts/c_pack_sapr3_Overview_of_the_R_3_Adapters.ditahttp://../concepts/c_pack_sapr3_Overview_of_the_R_3_Adapters.ditahttp://../concepts/c_pack_sapr3_Using_R_3_Adapter_Commands.ditahttp://../concepts/c_pack_sapr3_Using_R_3_Adapter_Commands.ditahttp://../concepts/c_pack_sapr3_Using_R_3_Adapter_Commands.ditahttp://../concepts/c_pack_sapr3_Connection_Commands.ditahttp://../concepts/c_pack_sapr3_Connection_Commands.ditahttp://../concepts/c_pack_sapr3_Connection_Commands.ditahttp://../references/r_pack_sapr3_Syntax_Summaries_for_R_3_Adapters.ditahttp://../references/r_pack_sapr3_Syntax_Summaries_for_R_3_Adapters.ditahttp://../references/r_pack_sapr3_Syntax_Summaries_for_R_3_Adapters.ditahttp://../concepts/c_pack_sapr3_R_3_Adapter_Aliases.ditahttp://../concepts/c_pack_sapr3_R_3_Adapter_Aliases.ditahttp://../concepts/c_pack_sapr3_R_3_Adapter_Aliases.ditahttp://../concepts/c_pack_sapr3_Using_R_3_System_Commands.ditahttp://../concepts/c_pack_sapr3_Using_R_3_System_Commands.ditahttp://../concepts/c_pack_sapr3_Using_R_3_System_Commands.ditahttp://../concepts/c_pack_sapr3_Using_R_3_System_Commands.ditahttp://../concepts/c_pack_sapr3_R_3_Adapter_Aliases.ditahttp://../references/r_pack_sapr3_Syntax_Summaries_for_R_3_Adapters.ditahttp://../concepts/c_pack_sapr3_Connection_Commands.ditahttp://../concepts/c_pack_sapr3_Using_R_3_Adapter_Commands.ditahttp://../concepts/c_pack_sapr3_Overview_of_the_R_3_Adapters.dita


26/136

Suporte ao Unicode

O adaptador JBAPI baseia-se em JCo, a API Java do SAP, que permite comunicaocom sistemas SAP. O adaptador JBAPI totalmente compatvel com versesanteriores do adaptador BAPI nativo, no entanto, o adaptador JBAPI fornecesuporte completo de Unicode.

O adaptador JBAPI suporta o Unicode diretamente e fornece acesso unificado aossistemas Unicode e no-Unicode.

O adaptador JALE inclui suporte a dados do conjunto de caracteres Unicode paraentrada e sada do SAP. Para ativar mapas de suporte ao Unicode que usam oadaptador JALE, necessrio usar as rvores do tipo IDoc geradas peloimportador do IDoc com a opo de conjunto de caracteres de dados definidacomo 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 peloadaptador JALE UTF-16BE, big endian Unicode. Para fins de mapeamento, altamente recomendvel usar as rvores do tipo geradas pelo importador da rvoredo tipo IDoc. O uso de rvores do tipo IDoc Unicode garante que os dadospassados para o adaptador JALE tenham a sintaxe correta, que seja reconhecidapelo adaptador JALE. Para enviar dados Unicode para o adaptador JALE, use arvore do tipo ALE do conjunto de caracteres Unicode. O sistema SAP R/3 deveser compatvel com Unicode para poder processar os dados Unicode enviados a elea 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 Unicodesuportado pelo adaptador UTF-16BE, big endian Unicode. Antes de enviar dadosUnicode de um sistema SAP R/3 para um sistema externo, o destino de RFC doSAP designado ao sistema externo deve ser configurado corretamente. Para ativaras opes de Unicode:

1. Insira a transao SAP/nsm59.

2. Clique na guiaOpes Especiais.

3. Selecione a opo Unicodeem Largura do Caractere na seo Sistema deDestino.

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 dadosJALE tambm deve suportar dados Unicode. altamente recomendvel o uso doimportador da rvore do tipo IDoc para gerar a rvore do tipo IDoc. O uso dervores do tipo IDoc Unicode garante que os dados passados para o adaptador

JALE tenham a sintaxe correta, que seja reconhecida pelo adaptador JALE. Paraenviar dados Unicode para o adaptador JALE, use a rvore do tipo ALE doconjunto de caracteres Unicode.



27/136

Usando Comandos do Adaptador R/3Os comandos do adaptador R/3 so usados para customizar a operao doadaptador e podem ser especificados para a origem de dados de um carto demapa de entrada, para o destino de dados de um carto de mapa de sada, ou paraambos.

Para obter informaes adicionais, consulte Adaptadores de Recursosno Centro deInformaes.

Substituies de Comandos de ExecuoOs 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 destinoda mensagem.

Configuraes de CartesPara obter detalhes sobre as configuraes de cartes, consulte as informaes do

Map Designerno Centro de Informaes.

Os seguintes valores podem ser usados para o carto de entrada de origem e ocarto 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 BurstsTodos os objetos SAP R/3 (IDoc, BAPI, BDC e DXOB) so recuperados doadaptador antes do primeiro burst. O servidor os consome, ento, na taxaespecificada pela configuraoFetchUnit.

Comportamento de OnFailure com Adaptadores R/3Quando a configurao do carto de entrada Transao> OnFailure igual aConfirmare o mapa no concludo com xito, os dados IDoc so perdidos.

Sintaxe e Uso de Comandos do AdaptadorO exemplo a seguir uma configurao de Destino do comando em um carto desada 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 oqual os dados transformados esto sendo destinados.

Tabela 4. Sintaxe e Uso de Comandos do Adaptador

Comando/Valor do Adaptador Interpretao

-c 800 Identifica o nmero do cliente. Necessriopara efetuar logon no sistema SAP R/3.

-u ALE-USER Identifica o nome do usurio. Necessriopara efetuar logon no sistema SAP R/3.

-p IDES Identifica a senha. Necessrio para efetuarlogon no sistema SAP R/3.

Captulo 4. Os Adaptadores R/3 21


28/136

Tabela 4. Sintaxe e Uso de Comandos do Adaptador (continuao)

Comando/Valor do Adaptador Interpretao

-h M699 Identifica o nome do host ou a cadeia derota do SAP do servidor SAP R/3 ao qual seconectar.

-s 00 Identifica o nmero do sistema.

-ar3 Especifica a criao de um arquivo de log doadaptador contendo informaes sobre astransaes ocorridas para esse destinodurante a execuo do mapa.

(No exemplo, -ar3 significaAuditoria R/3.)

Consulte a Lista de Comandos do Adaptadorpara obter informaes sobre asintaxe 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 PUTao definir regras de mapas no Map Designer. Consulte as informaes de Funes eExpressesno Centro de Informaes para obter informaes sobre as funes RUN,GETe PUT.

Exemplo de RUN

O exemplo a seguir mostra regras de mapas usando uma funo RUN()para ALEusando 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 chamadosomemap.mmcest sendo executadosubstituindo o carto de sada #1.

Exemplo de GET

Uma funoGET()usa o adaptador R/3 para recuperar dados.

Os exemplos a seguir mostram as regras de mapas usando uma funo GET()paraALE e BAPI usando comandos do adaptador R/3 para especificar a chave dedestino 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 nafuno 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 funoPUT()envia dados para o adaptador R/3.

http://../references/r_pack_sapr3_Adapter_Commands_List.ditahttp://../references/r_pack_sapr3_Adapter_Commands_List.ditahttp://../references/r_pack_sapr3_Adapter_Commands_List.ditahttp://../references/r_pack_sapr3_Adapter_Commands_List.dita


29/136

O exemplo a seguir mostra a funo PUT()sendo usada para enviar dados para oadaptador 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 ouum destino. Por exemplo, no carto de sada, possvel selecionar R/3 ALE ouJALE como o valor para as configuraes de destino.

Esse carto de sada de exemplo chamadoLegacy_Data para um mapa chamadoSada de ALE DEBMAS.mms. A configuraoComando de Destino compostapor vrios comandos do adaptador R/3, incluindo os comandos de adaptadornecessrios-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 sistemanecessrios. O comando de adaptador -ar3especifica a criao de um arquivo delog do adaptador contendo informaes sobre as transaes ocorridas para essedestino durante a execuo do mapa.

A partir do Integration Flow ManagerA partir do Integration Flow Manager, ao acessar as configuraes de execuo(Launcher ou Command Server) de um mapa, possvel selecionar um dosadaptadores SAP R/3 como uma origem ou um destino.

Por exemplo, para substituir configuraes do adaptador de um carto de sada ouespecificar o adaptador SAP R/3 para um destino, acesse as configuraes deexecuo de um mapa. Selecione R/3 ALE ou JALE na lista suspensa Destinoeespecifique os comandos do adaptador no campoComando de Destino.

Esse exemplo das configuraes do Launcher para um componente do mapachamadoOrdersByDepartmentmostra que, paraContabilidade #1 de Sada, o

adaptador R/3 especificado como o destino. A configurao Comando deDestino composta por vrios comandos do adaptador R/3, incluindo oscomandos de adaptador necessrios para a conexo: -c,-u,-p,-h,-s queidentificam o cliente, o ID de usurio e a senha, respectivamente, e -d queespecifica a chave de destino para saprfc.ini que designa as informaes deconexo adicionais). O comando de adaptador rastreio (-t) especifica para ativar orastreio do adaptador, que cria um arquivo de rastreio que contm informaesdetalhando a atividade do adaptador e -ar3, que especifica para criar o log deauditoria.

Comandos de ConexoAo 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 emdeterminadas situaes e com interfaces SAP R/3 especficas. Os seguintes tpicosfornecem as explicaes das situaes em que o uso de determinados comandos doadaptador SAP R/3 aplicvel:

v Comandos de Conexo Necessrios para Origens JALE e ALEv 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 BDCv Comandos de Conexo Opcionais para todas as Origens e Destinos

http://../concepts/c_pack_sapr3_Required_Connection_Commands_for_ALE_Sources.ditahttp://../concepts/c_pack_sapr3_Required_Connection_Commands_for_ALE_Sources.ditahttp://../concepts/c_pack_sapr3_Required_Connection_Commands_for_ALE_Sources.ditahttp://../concepts/c_pack_sapr3_Required_Connection_Commands_for_ALE_Targets_BDC_Ta.ditahttp://../concepts/c_pack_sapr3_Required_Connection_Commands_for_ALE_Targets_BDC_Ta.ditahttp://../concepts/c_pack_sapr3_Required_Connection_Commands_for_ALE_Targets_BDC_Ta.ditahttp://../concepts/c_pack_sapr3_Required_Connection_Commands_for_ALE_Targets_BDC_Ta.ditahttp://../concepts/c_pack_sapr3_Optional_Connection_Commands_for_ALE_Sources_and_Ta.ditahttp://../concepts/c_pack_sapr3_Optional_Connection_Commands_for_ALE_Sources_and_Ta.ditahttp://../concepts/c_pack_sapr3_Optional_Connection_Commands_for_ALE_Sources_and_Ta.ditahttp://../concepts/c_pack_sapr3_Batch_Input_Session_Connection_Commands_for_BDC_Tar.ditahttp://../concepts/c_pack_sapr3_Batch_Input_Session_Connection_Commands_for_BDC_Tar.ditahttp://../concepts/c_pack_sapr3_Batch_Input_Session_Connection_Commands_for_BDC_Tar.ditahttp://../concepts/c_pack_sapr3_Optional_Connection_Commands_for_All_Sources_and_Ta.ditahttp://../concepts/c_pack_sapr3_Optional_Connection_Commands_for_All_Sources_and_Ta.ditahttp://../concepts/c_pack_sapr3_Optional_Connection_Commands_for_All_Sources_and_Ta.ditahttp://../concepts/c_pack_sapr3_Optional_Connection_Commands_for_All_Sources_and_Ta.ditahttp://../concepts/c_pack_sapr3_Batch_Input_Session_Connection_Commands_for_BDC_Tar.ditahttp://../concepts/c_pack_sapr3_Optional_Connection_Commands_for_ALE_Sources_and_Ta.ditahttp://../concepts/c_pack_sapr3_Required_Connection_Commands_for_ALE_Targets_BDC_Ta.ditahttp://../concepts/c_pack_sapr3_Required_Connection_Commands_for_ALE_Targets_BDC_Ta.ditahttp://../concepts/c_pack_sapr3_Required_Connection_Commands_for_ALE_Sources.dita


30/136

Comandos de Conexo Necessrios para Origens JALE e ALEOs comandos de adaptador a seguir so necessrios para uma origem ALE aoconectar-se a um sistema SAP R/3 e o arquivo Saprfc.ini no usado. Cadacomando do adaptador usado para fornecer as informaes de conexonecessrias 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, quecontm as informaes de conexo padro. O valor especificado com esse comandodo 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 paradestinos 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 deadaptador a seguir, necessrios para completar as informaes de conexo:

v Use esses comandos do adaptador para especificar o ID do host do SAP e onmero 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 essecomando do adaptador faz distino entre maisculas e minsculas.

-D dest_keyv 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 quepode ser usado sempre que necessrio para os requisitos de conexo especficos.Dependendo do sistema SAP, esse comando de adaptador pode ser necessriopara a conexo.-L lang_cd

Comandos de Conexo Opcionais para Origens e Destinos

JALE e ALEDepois de especificar os comandos de adaptador de conexo necessrios paraorigens e destinos de ALE, os comandos a seguir so comandos de adaptadoropcionais 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]



31/136

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 paraDestinos BDCDepois de especificar os comandos de adaptador de conexo necessrios-C,-U e-Pe um dos trs agrupamentos de comandos de adaptador necessrios1)-H,-S, ou 2)-D, ou 3)-BAL,-H,-G,-S, use esses comandos de adaptador paradestinos de BDC para passar valores especificados diretamente para uma Sesso deEntrada de Lote. Os valores devem ser especificados em maisculas.

v Estes comandos do adaptador sonecessriospara uma Sesso de Entrada deLote:-TRANS TRANS_CD -GROUP NAME -ASUSER USR_ID

v Estes comandos do adaptador soopcionaispara uma Sesso de Entrada deLote:-ASCLNT CLNT_NUM -KEEP X -HOLDDATE YYYYMMDD

Comandos de Conexo Opcionais para todas as Origens eDestinos

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

Nota: Opcionalmente, o adaptador R/3 passar quaisquer outros comandos deadaptador 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 asinterfaces para as quais ele pode ser usado para uma origem (dados de sada), umdestino (dados de entrada), ou ambos.

Tabela 5. Lista de comandos do adaptador

Nome Sintaxe de Comando ALE BDC BAPI

ID do Programa -A pgm_id origem

Auditoria -AR3[+][U][%tid% |full_path ]

origem/destino

Cliente -ASCLNT CLNT_NUM destino

ID do Usuriodo SAP

-ASUSER USR_ID destino

Backup -B[I][X][%tid% |full_path ]

origem/destino

Balanceamentode Carga

-BAL destino destino origem/destino



32/136

Tabela 5. Lista de comandos do adaptador (continuao)

Nome Sintaxe de Comando ALE BDC BAPI

Nmero doCliente

-C clnt_num destino destino origem/destino

Codificao doconjunto de

caracteres

-enc Origem JALE

Destino -D dest_key origem/destino

destino origem/destino

GatewayHost -G gtwy_name origem

Gerao doCampo IDoc

-GEN[0|!] [ flds ] destino

Grupo -GROUPNAME destino

ID do Host -H host_name destino destino origem/destino

Data deSuspenso

-HOLDDATE YYYYMMDD destino

Manter Sesso -KEEP X destinoIdioma doLogon

-L lang_cd destino destino origem/destino

Escuta -LSN {0|dur[: int ]} origem

Encadeamentosdo Ouvinte

-N Origem JALE

Senha -P pwd destino destino origem/destino

Tamanho doPacote

-PKT IDoc_qty destino

Reprocessar

Arquivos deBackup

-R Origem JALE

Release -REL 3|4 origem/destino

origem/destino

origem/destino

ID do Sistema -S sys_num destino destino origem/destino

Timeout -timeout secs origem

Rastreamento -T[V|E|N][+] [ full_path ] origem/destino

destino origem/destino

ID da Transao -TIDtrans_ID origem/destino

Cdigo deTransao

-TRANS TRANS_CD destino

Tipo de IDoc -TY OTHER$|doc_type* origem

ID de Usurio -U usr_id destino destino origem/destino

Servio deGateway

V origem



33/136

ID do Programa (-A)

Use o comando do adaptador ID do Programa (-A) para especificar o ID doprograma a ser usado para a ativao de RFC ao usar o mtodo de Registro. O IDdo programa um identificador exclusivo usado pelo SAP Gateway paraidentificar o listener (o programa). O SAP recomenda um formato demachine.program para o identificador do programa. Esse identificador devecorresponder ao ID do Programa de Registro definido no SM59. O SAP R/3 usaesse identificador para distinguir vrios programas registrados no mesmo SAPGateway. Por exemplo, os IDs de programaxyz.CREMASe xyz.MATMASpoderiam ser ambos registrados no mesmo SAP Gateway (-G186.114.3.126) enmero de gateway (-X3300).

-Apgm_id

Opo Descrio

pgm_idIdentificador exclusivo do programa.

Formato recomendado pelo SAP machine.program.

No possui relacionamento com o sistema lgico, embora uma prticacomum seja nomear a chave semelhante ao sistema lgico.

Auditoria (-AR3)

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

Opo Descrio

+ Anexa informaes de auditoria a um arquivo existente.

U Para o Command Server: Especifique para produzir um arquivo chamadotransaction_id.log, em que transaction_id o Transaction Identifier (TID)designado pelo SAP R/3 que sempre estar no diretrio do mapa, se uestiver no carto de entrada ou de sada do mapa.

Para o Launcher: Especifique para produzir um arquivo chamadotransaction_id.logem que transaction_id o Transaction Identifier (TID)designado pelo SAP R/3. Se u estiver no carto de entrada ou de sada,

transaction_id.logestar no diretrio do mapa.Se um Transaction Identifier (TID) no puder ser designado, transaction_idserm4r3serial_number. Quando essa opo for usada e o comando deadaptador 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 essaliteral como parte do nome do arquivo e ela ser substituda peloTID_number.



34/136

full_pathEspecifique o nome do arquivo de auditoria, que pode incluir o caminhodo diretrio.

Cliente (-ASCLNT)

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

Opo Descrio

CLNT_NUMNmero 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 paraespecificar o ID do Usurio do SAP sob o qual processar a submisso. Essecomando de adaptador usado para destinos de BDC apenas para passar o valordiretamente para uma Sesso de Entrada de Lote.-ASUSER USR_ID

Opo Descrio

USR_IDID 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 deIDocs processados. O padro produzir um arquivo chamado transaction_id.tid, emquetransaction_id o Transaction Ide

Mais e Mais Sobre IDOC

Documents

Transcript of Mais e Mais Sobre IDOC