IBM WebSphere Transformation Extender Guia de Integração Do Pack para SAP PI

IBM WebSphere Transformation Extender
Guia de Integrao do Pack para SAP PI

V erso 8.3
Nota Antes de utilizar estas informaes, leia as informaes gerais em Avisos na pgina 51.
Novembro de 2009 Esta edio do documento se aplica ao IBM WebSphere Transformation Extender Pack para SAP PI 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
IBM Websphere Transformation Extender e o IBM Websphere Transformation Extender Pack para SAP PI . Requisitos de seus Negcios . . . . . . . . . . . . . . . . . . . . . . . . . . . Modelos de Comunicao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 . 1 . 2
Captulo 2. Entendendo o Transformation Extender . . . . . . . . . . . . . . . . . 3

Antes de Comear . . . . . . . . . . . . . . . . . . . . . . Requisitos do Sistema e Instalao . . . . . . . . . . . . . . . . . O Launcher . . . . . . . . . . . . . . . . . . . . . . . . . Como o Launcher Funciona . . . . . . . . . . . . . . . . . . Usando o Launcher . . . . . . . . . . . . . . . . . . . . . Launcher Administration . . . . . . . . . . . . . . . . . . . O Type Designer . . . . . . . . . . . . . . . . . . . . . . . Entendendo o Tipo de Mensagem XML do SAP . . . . . . . . . . . Como Importar Definies de WSDL ou de XSD para Criar uma rvore do Tipo Como Criar uma rvore do Tipo Usando o Importador de Esquema XML. . . Entendendo a rvore do Tipo Gerada . . . . . . . . . . . . . . . O Map Designer . . . . . . . . . . . . . . . . . . . . . . . Extenses do Nome do Arquivo . . . . . . . . . . . . . . . . Entendendo o Mapa de Transformao de XML em EDI . . . . . . . . Entendendo o Mapa Payext2swiftmt202.mms . . . . . . . . . . . . Servidor RMI . . . . . . . . . . . . . . . . . . . . . . . Iniciando e Parando o Servidor RMI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . para a Carga til . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 . 3 . 4 . 4 . 5 . 5 . 6 . 6 . 6 . 7 . 7 . 9 . 10 . 10 . 11 . 11 . 11
Captulo 3. Configurando o SAP . . . . . . . . . . . . . . . . . . . . . . . . . 13

Antes de Comear . . . . . . . . . . . . . . . Suporte para este Captulo . . . . . . . . . . . Definindo a Comunicao ALE entre o SAP R/3 e o SAP PI . Configurar o SAP R/3 para se Comunicar com o SAP PI . . Criar um Sistema Lgico para o SAP PI (BD54) . . . . Definir um Destino RFC no SAP R/3 para o SAP PI (SM59) Criar um Modelo de Distribuio (BD64) . . . . . . Gerar Perfis do Parceiro (WE20) . . . . . . . . . Configurar o SAP PI para se Comunicar com o SAP R/3 . . Criar um Sistema Lgico (BD54) . . . . . . . . . Definir um Destino RFC no SAP PI para o SAP R/3 (SM59) Criando um Modelo de Distribuio . . . . . . . . Gerar Perfis do Parceiro . . . . . . . . . . . . Configurando a Estrutura do Adaptador IDoc do SAP PI . Configurar a Integrao do SAP PI . . . . . . . . . Configurando o System Landscape . . . . . . . . SAP Integration Builder: Design . . . . . . . . . SAP Integration Builder: Configurao . . . . . . . Configurando os SAP PI Technical Adapters . . . . . . Instalando os Technical Adapters . . . . . . . . . . Iniciando o Mecanismo Adaptador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 13 13 13 14 14 14 15 15 15 15 16 16 16 17 17 19 21 22 23 23
Captulo 4. Transformation Extender Plug-in

Antes de Comear . . . . . . . . . . WebSphere Transformation Extender Plug-in Modelo de Comunicao . . . . . . . . Cenrio: Cenrio de Negcios Swift do Plug-in Cenrio: Cenrio de Negcios EDI do Plug-in . Design . . . . . . . . . . . . . . Instalando o Transformation Extender Plug-in .
Copyright IBM Corp. 2006, 2009
. . . . . . . . . . . . . . . . . . . 25
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 25 27 27 27 27 28
. . . . . . .
. . . . . . .
. . . . . . .
iii
Arquivos de Configurao do Transformation Extender Plug-in . . . . . . . . . Configuration Files Builder . . . . . . . . . . . . . . . . . . . . . Abrindo o Configuration Files Builder . . . . . . . . . . . . . . . . . Configurando os Arquivos de Configurao do Plug-in. . . . . . . . . . . . Lista de Parmetros no Arquivo de Configurao Global . . . . . . . . . . . Lista de Parmetros no Arquivo de Configurao do Cenrio. . . . . . . . . . Gerenciando os Arquivos de Configurao do Plug-in . . . . . . . . . . . . Arquivo de Propriedades XML . . . . . . . . . . . . . . . . . . . . Lista de Parmetros de Mapeamento . . . . . . . . . . . . . . . . . . Usando o Arquivo de Propriedades XML para Substituir Parmetros do Mapa Original . Implementando o Transformation Extender Plug-in no Repositrio do SAP PI . . . . Implementando os Arquivos de Configurao do Transformation Extender Plug-in . . Criando uma Interface de Mapeamento . . . . . . . . . . . . . . . . . Configurao . . . . . . . . . . . . . . . . . . . . . . . . . . Tempo de Execuo . . . . . . . . . . . . . . . . . . . . . . . Monitorando a Comunicao . . . . . . . . . . . . . . . . . . . . Mensagem de Erro - Suporte ao Mapeamento . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
28 29 29 29 30 30 30 32 32 33 33 34 34 35 36 36 37
Captulo 5. Conexo do IDoc . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Antes de Comear . . . . . . . . . . . . . . . . . . Adaptadores IDoc . . . . . . . . . . . . . . . . . . Modelo de Comunicao . . . . . . . . . . . . . . . . Pr-requisitos . . . . . . . . . . . . . . . . . . . Configurar o Sistema SAP R/3 para a Comunicao ALE . . . . Configurando o Sistema SAP PI . . . . . . . . . . . . Configurando o Adaptador JALE do Transformation Extender . . Cenrio 1: Entrada (Enviando um IDoc para o Sistema SAP R/3) . . Enviando um IDoc para o Sistema SAP R/3 . . . . . . . . Monitorando a Comunicao . . . . . . . . . . . . . Cenrio 2: Sada (Enviando um IDoc a partir do SAP R/3 Enterprise) . Enviando um IDoc a partir do SAP R/3 Enterprise . . . . . . Monitorando a Comunicao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 39 40 40 40 41 41 42 42 43 44 44 47
Captulo 6. Recursos do SAP . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Informaes sobre a Interface de Programao. Marcas Registradas e Marcas de Servio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 . 53
ndice Remissivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
iv
IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP PI
Captulo 1. Apresentao
Neste captulo discutimos os principais componentes do SAP Exchange Infrastructure (SAP PI) e explicamos como usar o SAP PI 3.0 em sua capacidade total com os produtos IBM WebSphere Transformation Extender.
IBM Websphere Transformation Extender e o IBM Websphere Transformation Extender Pack para SAP PI
O Transformation Extender uma soluo de integrao de dados eficaz, orientada a transaes, que automatiza a transformao de transaes complexas de grande volume sem a necessidade de codificao manual, fornecendo aos corporativos um rpido retorno sobre investimento. Ele suporta EDI, XML, SWIFT, HIPAA e outra integrao B2B baseada em padres, bem como a integrao em tempo real de dados de vrios aplicativos, bancos de dados, middleware do sistema de mensagens e tecnologias de comunicao no corporativo. A soluo Transformation Extender usada para a integrao de dados operacionais e transacionais acionados por eventos internos e/ou externos ao corporativo. A integrao bem-sucedida de sistemas diferentes em um corporativo de grande porte orientado em tempo real, uma tarefa grandiosa, mas que traz recompensas notveis, como menores custos com inventrio, maior conformidade com padres, alm de melhor acesso a dados de negcios crticos. O IBM WebSphere Transformation Extender Pack para SAP PI foi projetado para abrir totalmente as possibilidades de comunicao de troca de dados entre sistemas externos (sistemas no-SAP, como PeopleSoft Enterprise, Siebel Systems e qualquer sistema legado) usando o SAP Exchange Infrastructure. possvel gerenciar com facilidade os system landscapes para usar integralmente a tecnologia de mapeamento potente no Transformation Extender e, ao mesmo tempo, mover informaes usando o SAP Exchange Infrastructure. O produto Transformation Extender Plug-in includo no Pack e definido no captulo quatro, fornece a capacidade de executar mapas do Transformation Extender a partir do SAP Exchange Infrastructure, complementando as capacidades de mapeamento do SAP PI. Os canais de comunicao entre o SAP PI e o IBM WebSphere Transformation Extender Pack para SAP PI incluem: v conexes usando o Transformation Extender Plug-in v conexes usando o adaptador JALE
Requisitos de seus Negcios

Ao trabalhar com o IBM WebSphere Transformation Extender Pack para SAP PI, a primeira coisa a ser considerada so os requisitos do system landscape. Geralmente, seu system landscape incluir ambos os sistemas de negcios, SAP e no-SAP. So necessrios adaptadores diferentes para a comunicao entre esses sistemas de negcios. O IBM WebSphere Transformation Extender Pack para SAP PI, juntamente com o SAP Exchange Infrastructure foram projetados para ajud-lo a integrar totalmente sistemas SAP e no-SAP em um landscape homogneo.
A maneira mais fcil de se ter uma ideia sobre o SAP PI como um canal de mensagens XML. H dois tipos de informaes bsicas que entram e saem do canal de mensagens, os dados de entrada e de sada. v Os dados de entrada requerem um adaptador emissor que receba dados do sistema externo usando a tecnologia Transformation Extender, que serve como um ambiente intermedirio entre os sistemas externo e SAP PI. v Os dados de sada requerem um adaptador receptor que receba dados do PI e envie dados para o sistema Transformation Extender, que serve como um ambiente intermedirio entre os sistemas externo e SAP. Os requisitos de seu system landscape e o tipo de dados de entrada e de sada que sero usados definem o tipo de modelo de comunicao necessrio para integrar seus requisitos de negcios. H dois modelos de comunicao includos no Pack; cada um deles foi projetado como guia para implementar suas prprias necessidades comerciais. Cada modelo de comunicao descrito em seu prprio captulo.
Modelos de Comunicao
Cada modelo de comunicao definido primeiramente pelo tipo de sistema de negcio e, em segundo lugar, pelo tipo de tecnologia de middleware para a troca de contedo. Esta verso do Pack usa adaptadores e todos os seus importadores correspondentes de um lado (para os dados de entrada e de sada) e os adaptadores de conectividade IDoc e PI do SAP PI do outro lado. O IBM WebSphere Transformation Extender Pack para SAP PI fornece exemplos usando duas interfaces para integrao dos modelos de comunicao: v Adaptador ALE para Comunicao do IDoc v Transformation Extender Plug-in como uma interface de mapeamento Cada modelo de comunicao descreve como configurar um cenrio usando cada interface. Os exemplos mostram como configurar os dados de entrada e de sada com base em requisitos de negcios diferentes. O SAP PI e as tecnologias Transformation Extender foram projetados para trabalhar em conjunto para entregar as informaes corretas, no formato correto, na hora certa para suportar a integrao de solues on demand.
Captulo 2. Entendendo o Transformation Extender

Este o ponto de incio para a implementao tcnica de seu system landscape de negcios, que inclui o Transformation Extender e o SAP Exchange Infrastructure. Este captulo fornece uma viso geral dos componentes do Transformation Extender que possuem recursos em todos os modelos/exemplos de comunicao. Os requisitos do sistema so definidos para instalao e execuo do Transformation Extender nas plataformas Windows e UNIX.
Antes de Comear
Recomenda-se que se tenha um conhecimento prtico das tecnologias Transformation Extender e do SAP Exchange Infrastructure. Este captulo supe que voc tenha: v Instalado o IBM WebSphere Transformation Extender e o IBM WebSphere Transformation Extender Pack para SAP PI. v Estabelecido uma conexo com servidores em seu system landscape. v Recebido o nvel adequado de acesso de usurio ao SAP Exchange Infrastructure e a outros sistemas SAP em seu landscape. Consulte as notas sobre o release e readme_sap.txt do IBM WebSphere Transformation Extender Pack para SAP PI, para obter detalhes da instalao. O arquivo est localizado no diretrio install_dir. Neste guia, install_dir refere-se ao local de instalao do IBM WebSphere Transformation Extender.
Requisitos do Sistema e Instalao

Por Que e Quando Desempenhar Esta Tarefa
O Transformation Extender Design Studio 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. Os mapas sero discutidos em detalhes posteriormente neste captulo. Alm do Design Studio, so instalados os seguintes componentes do produto IBM WebSphere Transformation Extender Pack para SAP PI que facilitam o desenvolvimento de interfaces SAP PI: v Exemplos de cada uma das interfaces suportadas pelo IBM WebSphere Transformation Extender Pack para SAP PI. v Adaptador JALE e importador SAP R/3 IDoc correspondente; para obter informaes, consulte a documentao especfica da plataforma. v Transformation Extender Plug-in, Configuration Files Builder e uma coleta de arquivos de configurao padro. O Pack pode ser instalado no Microsoft Windows, no HP-UX, no IBM AIX e no Sun Solaris. Consulte o arquivo readme_sap.txt para obter detalhes sobre os requisitos do sistema, alm de instrues de instalao ou remoo do produto. O Pack instalado sobre o Transformation Extender. Ele no compatvel com verses anteriores do Pack devido ao ambiente de configurao do Transformation Extender Plug-in.
O TCP/IP deve ser configurado suportando acesso do Design Studio para o sistema SAP. Alm desse Pack, necessria a instalao dos seguintes componentes para que se obtenha funcionalidade total: v IBM WebSphere Transformation Extender v IBM WebSphere Launcher Componentes de Terceiros: v JAVA/JMS: j2sdkee 1.3.1.x ou 1.4.x da SUN, jdk1.4.2 ou superior da SUN. Nota: O SAP PI enviado com estes componentes: v SAP PI 3.0 de complemento v PI Technical Adapters v Java Web Start v 1.0.1 v SAP Front End (software Cliente), que inclui a biblioteca do cliente SAP RFC librfc32.dll 6.20 ou posterior Nota: O SAP RFC librfc32.dll no est includo nas instalaes. Assegure-se de que essa biblioteca esteja instalada no diretrio do sistema Windows. Se o SAP Front End tiver sido instalado no sistema Windows, essa biblioteca j dever estar instalada no diretrio Windows\system32, no entanto, verifique para assegurar-se de que seja a verso correta. Se o SAP Front End no estiver instalado, consulte o Administrador SAP para obter essa biblioteca do SAP. Consulte a Nota 19466 no Web site SAP Service Marketplace para obter detalhes sobre como obter downloads. Se voc estiver instalando o SAP Pack no Windows, copie a biblioteca para qualquer diretrio em %PATH%. Se estiver instalando o SAP Pack no UNIX, envie a biblioteca por FTP para qualquer diretrio especificado pela varivel de ambiente LD_LIBRARY_PATH (Sun Solaris), LIB_PATH (AIX), SHLIB_PATH (HP-UX) ou LD_LIBRARY_PATH (HP-UX).
O Launcher
O Launcher fornece um modelo baseado em eventos em tempo real para executar mapas e sistemas de mapas definidos no Integration Flow Designer. possvel usar o Launcher no modelo de comunicao IDoc como um listener para a chegada dos IDocs de sada. Aps a instalao do WebSphere Transformation Extender, ser necessrio modificar as configuraes de Administrao.
Como o Launcher Funciona

O Launcher executa sistemas de mapas criados e gerados usando-se o Integration Flow Designer (IFD). Esses sistemas de mapas gerados especificamente para execuo no Launcher so chamados de arquivos de sistema do Launcher (.msl), referidos s vezes, como arquivos de controle do Launcher. Quando o Launcher comea a ser executado, ele inicializado com o arquivo .msl no diretrio de implementao. possvel especificar um diretrio de implementao a partir da interface Launcher Administration.
Nota: Ao usar as interfaces de administrao local do mainframe, o diretrio de implementao padronizado como install_dir/systems e as etapas da prxima seo no se aplicam.
Usando o Launcher
Para usar o Launcher, necessrio concluir vrias etapas. A lista a seguir fornece uma viso geral resumida das etapas que devem ser seguidas. Essas etapas consideram que voc j gerou um arquivo de sistema do Launcher (.msl). Os arquivos de sistema (.msl) dos cenrios so acessveis a partir da pasta install_dir/systems. v Configure o Launcher a partir da interface Launcher Administration. v Inicie o servio Launcher. v Opcional - Configure uma conexo do Launcher no Console de Gerenciamento e comece a visualizar dados estatsticos do processo em execuo. (A partir da, tambm possvel controlar o sistema composto que est em execuo). v Para visualizar as procuras executadas dinamicamente e obter capturas instantneas, use o Launcher Monitor. v Para visualizar capturas instantneas capturadas pelo Launcher Monitor, use o Visualizador de Captura Instantnea. Nota: Ao executar o Launcher nos Servios do Sistema UNIX (USS), por padro, o Launcher usa o valor calculado subtraindo-se 1 da porta de atendimento inicial para parar, continuar ou pausar o Launcher. A porta de atendimento inicial configurada na guia Geral na interface Launcher Administration. Consulte Launcher no Centro de Informaes para obter informaes adicionais.
Launcher Administration
Launcher Administration a interface administrativa para o Launcher. Para acessar a Launcher Administration, no menu Iniciar, selecione Programas IBM WebSphere Transformation Extender Launcher Launcher Administration. 1. Escolha uma porta disponvel. Nota: Devido a um provvel conflito com uma porta usada pelo produto Real Time Integration (RTI), a porta padro do Launcher 8081. Os exemplos do Launcher includos no Transformation Extender usam a porta 8081. Usar um nmero de porta diferente de 8081 causar a falha dos exemplos. Se o produto RTI no estiver instalado, a configurao da porta padro do Launcher poder ser alterada por meio da interface com o usurio da Launcher Administration. 2. Customize o acesso. Crie um usurio que tenha acesso a todos os sistemas.
Resultados
Consulte Launcher no Centro de Informaes para obter informaes adicionais.
O Type Designer
O Type Designer usado para definir, modificar e visualizar rvores do tipo. Uma rvore do tipo descreve a sintaxe, a estrutura e a semntica dos metadados. A sintaxe de metadados refere-se a seu formato, incluindo tags, delimitadores, terminadores e outros caracteres que separam ou identificam sees de dados. A estrutura de metadados refere-se a sua composio, incluindo a repetio de subestruturas e agrupamentos aninhados. A semntica de metadados refere-se ao significado dos metadados, incluindo regras para valores de dados, relacionamentos entre as partes de um grande objeto de dados e a deteco de erros e recuperao.
Entendendo o Tipo de Mensagem XML do SAP

Uma rvore do tipo semelhante a um dicionrio de metadados porque contm uma coleta de definies de tipo. Em um Tipo de Mensagem XML do SAP, os elementos do tipo de Mensagem XML do SAP so definidos. A rvore do tipo projetada para corresponder aos requisitos do SAP PI de uma mensagem XML com cabealho. Uma mensagem no Exchange Infrastructure estruturada da seguinte forma: v Cabealho da Mensagem - Atributos da mensagem, por exemplo, emissor, modo (sncrono/assncrono) v Carga til - Valores de dados dos negcios v 1.Anexo - Qualquer anexo (opcional) As propriedades da mensagem contidas no Cabealho da Mensagem (por exemplo, Destino, Modo de Entrega e ID da Mensagem). Os dados de negcios reais so transferidos na Carga til. Tambm possvel anexar um nmero ilimitado de anexos mensagem antes de envi-la. Os anexos so compostos geralmente de dados no-XML, por exemplo, figuras, documentos de texto e dados binrios. Usando um esquema XML, possvel descrever qualquer nmero de definies de esquemas XML para a carga til de uma mensagem. A instncia de um esquema que descrita enviada usando-se o Exchange Infrastructure no tempo de execuo.
Como Importar Definies de WSDL ou de XSD para Criar uma rvore do Tipo para a Carga til
Para gerar uma rvore de tipo do Transformation Extender, importe uma Verso de Componente de Software do Diretrio System Landscape e copie as interfaces da Verso de Componente de Software. Em seguida, as definies de esquema WSDL e XSD da interface (interface IDoc, por exemplo) so exportadas. A definio de esquema XSD usada para criar uma rvore do tipo para a configurao de mapa do Transformation Extender. Nota: Se no estiver familiarizado com as Verses de Componente de Software e com o Diretrio System Landscape do SAP PI, revise o Captulo 3 Configurando o SAP PI, antes de continuar com as etapas abaixo.
Para exportar a definio do tipo de mensagem IDoc do Repositrio do SAP PI como uma definio de esquema XSD: 1. Abra a interface IDoc no Repositrio do SAP PI. Por exemplo, escolha o tipo IDoc PAYEXT.PEXR2002; essa uma mensagem comum usada nos cenrios de exemplo. 2. Na interface IDoc/mensagem, escolha Ferramentas > Exportar XSD e salve a definio de XSD em um arquivo. Escolha um local e um nome para o arquivo de metadados. Uma amostra dos metadados da mensagem de tipo IDoc PAYEXT.PEXR2002 est localizada no diretrio: install_dir\examples\packs\ sap_xi\3.0\plug-in\SWIFT\config\. O nome do arquivo PAYEXT.PEXR2002.xsd.
Como Criar uma rvore do Tipo Usando o Importador de Esquema XML

Para criar uma rvore do Tipo usando o Importador de Esquema XML: 1. No Type Designer, selecione Importar no menu rvore. A janela Assistente do Importador aberta. 2. Selecione a interface Esquema XML e clique em Avanar. Uma caixa de dilogo aberta solicitando informaes sobre o caminho para o arquivo de metadados que est sendo importado. 3. Selecione o arquivo PAYEXT.PEXR2002.xsd em que os metadados foram criados e clique em Avanar. 4. Clique em Avanar. 5. Digite o nome do arquivo da rvore do tipo a ser criado pelo Assistente de Importador. Selecione Modo Clssico. Clique em Avanar. Nota: Escolha o modo Clssico porque o analisador Xerces XML no consegue ler arquivos de entrada do SAP PI verso 3.0. 6. O Assistente do Importador l o arquivo de metadados e a rvore do tipo gerada. 7. Clique em Concluir. O Type Designer exibe a rvore do tipo criada.
Entendendo a rvore do Tipo Gerada

Uma rvore do tipo exibe tipos de dados em uma hierarquia. Na rvore do tipo PAYEXT, o tipo de raiz da rvore do tipo de Esquema XML XSD. A rvore do tipo possui as categorias XMLS, NonDocData, Prolog, Element e Doc derivadas do tipo de raiz XSD.
Categoria XMLS
A categoria XMLS contm construes de rvores do tipo usadas para representar: v v v v declaraes de espaos de nomes atributo noNamespaceSchemaLocation atributo schemaLocation atributo nil
A rvore do tipo gerada a partir de um documento de esquema permite que as declaraes de espaos de nomes apaream nas tags abertas dos elementos globais,
bem como em tipos globais. Os elementos globais tambm podem conter o atributo schemaLocation ou noNamespaceSchemaLocation no espao de nomes Instncia do Esquema XML: xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance Alm disso, para os elementos que foram declarados como podendo conter zeros no documento de esquema, o atributo nil pode ser usado no documento da instncia. Esse atributo tambm pertence ao espao de nomes Instncia do Esquema XML.
Categoria de Item NonDocData

O item NonDocData particionado e representa os dados no pertencentes ao documento que podem estar contidos no documento da instncia XML. O item NonDocData contm trs subtipos, PI, Comment e CDATA que podem ser visualizados quando a rvore expandida. O item de texto PI representa uma instruo de processamento XML, o item de texto Comment representa um comentrio XML e o item de texto CDATA representa uma seo CDATA.
Categoria Prolog
A categoria Prolog contm as construes da rvore do tipo usadas para descrever o prolog XML no documento da instncia. Quando a rvore expandida, trs itens so exibidos, version, encoding, standalone. Esses itens representam atributos que podem aparecer no prolog XML. O grupo Decl no ordenado contm os itens version, encoding e standalone. O item version obrigatrio, enquanto que os itens encoding e standalone so opcionais no grupo Decl. A categoria DOCTYPE contm tipos que representam um document type declaration (DTD) opcional no documento da instncia XML.
Categoria Type
A categoria Type contm construes que representam os tipos globais no esquema. O tipo complexo EDI_DC40.PAYEXT.PEXR2002 contm uma sequncia de elementos. Os componentes da sequncia so organizados na categoria Comp. O grupo AttrList contm os itens que foram definidos na categoria Attr.
Categoria Element
A categoria Element contm construes que representam os elementos globais do esquema. O esquema possui apenas um elemento global - PEXR2002, motivo pelo qual a categoria Element possui apenas um n-filho - a categoria PEXR2002. O grupo no ordenado Attr e AttrList contm os atributos do elemento PEXR2002. O tipo do elemento PEXR2002 contm uma sequncia de elementos, representada pela categoria Comp. Cada Elemento da categoria Comp identifica o segmento, por exemplo, EDI_DC40.
O grupo ElementDecl do elemento PEXR2002 representa todo o contedo do tipo IDoc PEXR2002 que inclui atributos do PEXR2002, bem como subelementos do PEXR2002 (Seq).
Grupo Doc
O grupo Doc representa o documento da instncia XML inteiro. Isso inclui o Prolog do documento e o elemento de nvel superior do documento da instncia - grupo ElementDecl do elemento PEXR2002. Clique duas vezes em Doc e expanda para mostrar a hierarquia. A estrutura em rvore do tipo corresponde estrutura da mensagem.
O Map Designer
O Map Designer um componente do cliente do Design Studio usado para desenvolver mapas definindo especificaes de entrada e de sada e regras de mapeamento que executam transformao de dados. O Map Designer usa as definies de dados armazenados nas rvores do tipo para especificar a lgica de transformao na forma de regras de mapas. As regras de mapas operam em objetos de dados de entrada e constroem objetos de dados de sada. O mapa pode ser construdo para plataformas especficas e, em seguida, executado nessa plataforma para executar a transformao dos dados. Durante a fase de design, voc constri e executa mapas a partir do Map Designer em uma plataforma Windows. possvel visualizar os resultados de um mapa no Map Designer. Tambm possvel usar o Map Designer para construir um mapa para ser executado em outras plataformas. O Map Designer usado para: v Criar mapas para especificar a lgica necessria para transformar os dados de entrada nos dados de sada desejados v Identificar os objetos de dados e de origem dos dados de entrada v Validar e resolver as propriedades dos tipos de dados de origem definidas no Type Designer v Identificar os objetos de dados e de destino dos dados de sada v Especificar e construir os dados de sada de acordo com as regras de mapas v Fornecer informaes sobre a validao de dados pela gerao de arquivos de rastreio v Visualizar os resultados da execuo do mapa Depois de definir objetos de dados e suas propriedades no Type Designer, defina um mapa no Map Designer em que os cartes dos mapas especifiquem a origem de entrada e o destino de sada. Um mapa define como gerar um objeto de dados de um determinado tipo ou vrios objetos de dados independentes, cada um de um determinado tipo. Um mapa contm cartes de entrada e de sada que transformam o contedo de dados de formatos de origem em formatos de destino de acordo com regras contidas no mapa.
Extenses do Nome do Arquivo

A seguir est uma lista das principais extenses de nome de arquivo do Transformation Extender usadas nos cenrios:
Tabela 1. Extenses do Nome do Arquivo Extenso .log .mmc .mme .mms .msd .msl .mtr .mtt .tmp Aplicativo Map Designer Map Designer Map Designer Map Designer Map Designer Integration Flow Designer Map Designer Type Designer Map Designer Descrio do arquivo Log de auditoria Mapa compilado Resultados da anlise de construo do mapa Origem do mapa Definio do sistema Arquivo de sistema do Launcher Rastreio rvore do tipo Arquivos de trabalho do mapa temporrio
Entendendo o Mapa de Transformao de XML em EDI

O mapa de origem IDoc2edi.mms, criado para o cenrio de integrao do Transformation Extender Plug-in, converte dados IDoc XML recebidos em um arquivo formatado X12 EDI ilustrando a capacidade do mecanismo de transformao do Transformation Extender. O mapa est localizado na pasta: install_dir\examples\packs\sap_xi\3.0\plug-in\ edi\mms. O mapa l dados IDoc ORDERS.ORDERS06 e os transforma em uma ordem de compra X12 EDI 850. Cada IDoc est associado a uma ordem de compra. No mapa IDoc2edi.mms, o mapa funcional Each_PO usado para gerar um conjunto de transaes. O mapa obtm um IDoc e o mapeia para a Transao #850 do FunctlGroup do Parceiro de Sada da ordem de compra. O mapa funcional EachLineItem, por exemplo, mapeia o segmento IDoc E1EDPO1 para o LoopPO1 de EDI. Ele possui uma nica entrada do tipo ORDERS.ORDERS05, Componente E1EDP01 do IDoc e uma nica sada do tipo LoopPO1 #850, Conjunto de Parceiros de Sada de V4010 ANSI EDI. Os dados so mapeados arrastando-se e soltando-se valores do campo do carto de entrada para o carto de sada.
Carto de Entrada
O carto de entrada do mapa usa a rvore do tipo que suporta a mensagem IDoc XML ORDERS.ORDERS06. O carto de entrada sobrescrito pela entrada do Transformation Extender Plug-in. Os dados de origem so aqueles enviados do sistema de negcio emissor do SAP R/3.
10
Carto de Sada
O carto de sada do mapa usa a rvore do tipo que suporta o formato de dados X12 850 EDI da ordem de compra. Os dados resultantes so criados pelo mapa e retornados para o sistema de negcio receptor SAP PI para EDI.
Entendendo o Mapa Payext2swiftmt202.mms

O mapa de origem Payext2swiftmt202.mms usado no cenrio de integrao do Transformation Extender Plug-in. O mapa converte os dados IDoc formatados XML recebidos em um arquivo de dados no formato SWIFT para ilustrar o recurso de mecanismo de transformao do mapa. O mapa est localizado na pasta install_dir\examples\packs\sap_xi\3.0\plug-in\swift\mms . O mapa l o arquivo de dados IDoc XML PEXR2002 recebido e cria dados no formato SWIFT M 202. Os dados resultantes so retornados para o sistema de negcio receptor.
Primeiro Carto de Entrada

O primeiro carto de entrada do mapa payextIdoc2SwiftMT202 usa o adaptador de arquivo como uma origem. O primeiro carto de entrada sobrescrito pela entrada do Transformation Extender Plug-in.
Segundo Carto de Entrada

O segundo carto de entrada fornece os dados de moeda recentes da tabela de consulta.
Terceiro Carto de Entrada

O terceiro carto de entrada fornece os dados de moeda antigos da tabela de consulta.
Primeiro Carto de Sada

O arquivo formatado SWIFT resultante criado pelo mapa com o primeiro carto de sada e retornado para o SAP PI.
Segundo Carto de Sada

O segundo carto de sada valida e arquiva o arquivo resultante do primeiro carto de sada para a exclusividade dos registros.
Servidor RMI
O Servidor RMI executa mapas em seu prprio processo e opera em um de dois modos: processo nico e multiprocesso. O modo especificado quando o servidor iniciado. Consulte a ajuda da Web do RMI para obter informaes adicionais. A ajuda da Web do RMI est disponvel em: Iniciar > Programas > IBM WebSphere Transformation Extender > Pack para SAP PI > Ajuda do RMI.
Iniciando e Parando o Servidor RMI

O servidor RMI iniciado a partir da linha de comandos nas plataformas Windows e UNIX. Consulte a Ajuda da Web do RMI para obter informaes adicionais. Para o UNIX iniciar o Servidor RMI: v Edite o arquivo install_dir/startRMIServer.sh configurando a seguinte varivel JAVAHOME: diretrio de instalao Java 2 SDK.
11
v No diretrio de instalao, insira o seguinte comando a partir de um prompt de comandos: . ./setup. v No diretrio bin do diretrio de instalao, insira em um prompt de comandos: ./startRMIServer.sh -verbose. Para o WINDOWS iniciar o Servidor RMI: v Edite o arquivo install_dir\startRMIServer.bat configurando as seguintes variveis: MERCHOME: diretrio de instalao WebSphere Transformation Extender DK CONFIG_FILE: nome do arquivo e caminho da propriedade do Servidor RMI. v No diretrio de instalao, insira o seguinte comando a partir de um prompt de comandos para iniciar o Servidor RMI: install_dir\startrmiserver.bat -verbose. No Windows, o incio do Servidor RMI mostrado abaixo.
****************************************************** * Servidor RMI x.x do WebSphere Transformation Extender * ****************************************************** Iniciando o Servidor RMI... Carregando o arquivo de configurao. Porta de atendimento do servidor: 2500 Modo de criao de log: integral Modo do servidor: processo nico Modo do servidor: JRMP Servidor RMI em execuo.
Para parar o Servidor RMI a qualquer momento, use a tecla Ctrl e C.
12
Captulo 3. Configurando o SAP

Neste captulo, voc aprender como configurar o Repositrio e o Diretrio de Integrao, incluindo a configurao do Diretrio System Landscape do SAP PI. O SAP faz distino entre dois tipos de sistemas: sistemas de negcios e sistemas tcnicos. Sistemas de negcios so sistemas lgicos que funcionam como emissores ou receptores em uma visualizao do aplicativo do cenrio de integrao. Esses Sistemas de Negcios so baseados e implementados em Sistemas Tcnicos que possuem propriedades tcnicas, como endereos e so sistemas aplicativos instalados fisicamente.
Antes de Comear
Recomenda-se que o usurio tenha um conhecimento prtico dos aplicativos SAP R/3, do SAP Technical Adapter Framework e do ambiente SAP PI. Este captulo supe que: v O SAP PI esteja instalado. v O system landscape esteja definido como um grupo de componentes integrantes, como os sistemas SAP R/3, SAP BW e no-SAP. v Os PI Technical Adapters estejam instalados.
Suporte para este Captulo

Se voc tiver problemas ou dvidas relacionados configurao geral de um cenrio de negcios ou aos requisitos do adaptador tcnico discutidos neste captulo, entre em contato com o SAP ou use a Ajuda on-line do SAP.
Definindo a Comunicao ALE entre o SAP R/3 e o SAP PI

Application Link Enabling (ALE) uma ferramenta de tecnologia de middleware importante. Essa arquitetura baseada em componente permite que os componentes de software do SAP e outros fornecedores de software se comuniquem e se tornem integrados juntos. Ser necessrio configurar a comunicao ALE entre o SAP R/3 e o SAP Exchange Infrastructure.
Configurar o SAP R/3 para se Comunicar com o SAP PI

Para configurar o sistema SAP R/3 para se comunicar com o SAP PI, ser necessrio: v Criar um Sistema Lgico para o SAP PI (BD54) v Definir um destino RFC no SAP R/3 para o SAP PI (SM59) v Criar um Modelo de Distribuio (BD64) v Gerar Perfis do Parceiro (WE20)
13
Criar um Sistema Lgico para o SAP PI (BD54)

No SAP R/3, crie um Sistema Lgico para o SAP Exchange Infrastructure com a transao BD54. 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 a transao BD54 no campo de comandos do SAP R/3 e clique em Enter. 2. Clique em Novas entradas para criar um Sistema Lgico. 3. Insira um nome para o Sistema Lgico e uma descrio. O nome do Sistema Lgico usado neste exemplo XI3CLNT800. O nome do Sistema Lgico do SAP R/3 U47CLNT800.
Definir um Destino RFC no SAP R/3 para o SAP PI (SM59)

O destino RFC usado durante a Camada de Comunicao do processamento ALE. Quando a Determinao do Receptor identifica uma comunicao, o destino RFC define a comunicao fsica para o destino remoto. Siga as etapas para configurar um destino RFC para o SAP Exchange Infrastructure. Para obter informaes adicionais, consulte a documentao do SAP. Para criar um destino RFC no SAP R/3 Enterprise: 1. Insira a transao SM59 no campo de comandos do SAP R/3 e clique em Enter. A janela Exibir e manter destinos RFC aberta. 2. Clique com o boto direito do mouse em Conexes R/3 e clique em Criar. A janela Destino RFC aberta. 3. Insira como o Destino RFC XI3CLNT800 com o Tipo de conexo 3, definindo uma Conexo R/3. O nome do Destino RFC igual ao nome do Sistema Lgico. 4. Configure os valores para o Complemento SAP PI como um ponto de destino. Insira o host de Destino como o servidor SAP PI. 5. Clique na guia Logon/Segurana. Insira as informaes de logon apropriadas com o usurio XIAPPLUSER. 6. Salve.
Criar um Modelo de Distribuio (BD64)

O Modelo de Distribuio define o tipo de mensagem de dados a ser trocado. Crie um Modelo de Distribuio entre o SAP R/3 e o SAP PI com a transao BD64. Inclua os tipos de mensagem IDoc DEBMAS, ORDERS e PAYEXT. Para criar um Modelo de Distribuio: 1. Insira a transao BD64 no campo de comandos do SAP e clique em Enter. 2. Selecione o Sistema SAP R/3 (U47CLNT800). 3. Clique em Incluir tipo de mensagem. 4. Insira os dados de tipo de mensagem para comunicao do SAP R/3 com o SAP XI: Emissor R/3, Receptor PI, Tipo de mensagem Debmas, Orders, Payext.
14
5. Salve. 6. Insira os dados de tipo de mensagem para comunicao do SAP PI com o SAP R/3: Emissor PI, Receptor R/3, Tipo de mensagem Debmas. 7. Salve.
Gerar Perfis do Parceiro (WE20)

No Modelo de Distribuio, possvel gerar Perfis do Parceiro automaticamente pela seleo de Gerar perfis do parceiro no menu Ambiente, ou manualmente, usando a transao WE20. Para gerar perfis do parceiro: 1. Selecione Gerar perfis do parceiro no menu Ambiente. A janela Gerar Perfis do Parceiro aberta. 2. Escolha XI3CLNT800. 3. Clique em SUBSYSTEMS e gere. Uma lista das mensagens, das portas geradas e dos perfis do parceiro aparece. A porta RFC um nmero designado internamente.
Configurar o SAP PI para se Comunicar com o SAP R/3

Para configurar o SAP Exchange Infrastructure para se comunicar com o SAP R/3, ser necessrio: 1. 2. 3. 4. 5. Criar um Sistema Lgico (BD54). Definir um Destino RFC no SAP PI para o SAP R/3 (SM59). Criar um Modelo de Distribuio (BD64). Gerar Perfis do Parceiro (WE20). Configurar a estrutura do adaptador SAP PI.
Criar um Sistema Lgico (BD54)

Crie um Sistema Lgico para o SAP R/3 no SAP PI com a transao BD54. Para criar um Sistema Lgico: 1. Insira a transao BD54 no campo de comandos do SAP R/3 e clique em Enter. 2. Clique em Novas entradas para criar um Sistema Lgico. 3. Insira um nome para o Sistema Lgico e uma descrio. O nome do Sistema Lgico do SAP R/3 U47CLNT800.
Definir um Destino RFC no SAP PI para o SAP R/3 (SM59)

Ser necessrio configurar um destino RFC no SAP PI para o SAP R/3. Para os exemplos, crie destinos RFC para U47CLNT800 e C46CLNT800. Para criar um destino RFC: 1. Insira a transao SM59 no campo de comandos do SAP R/3 e clique em Enter.
15
A janela Exibir e manter destinos RFC aberta. 2. Clique com o boto direito do mouse em Conexes R/3 e clique em Criar. A janela Destino RFC aberta. 3. Insira como o Destino RFC U47CLNT800 com o Tipo de conexo 3, definindo uma Conexo R/3. O nome do Destino RFC igual ao nome do Sistema Lgico. 4. Configure valores para o SAP R/3 como um ponto de destino. Insira o Host de Destino como SAP R/3. Neste exemplo, o Destino RFC U47CLNT800. 5. Clique na guia Logon/Segurana. Insira as informaes de logon apropriadas para o usurio XIAPPLUSER. 6. Salve.
Criando um Modelo de Distribuio

Crie um Modelo de Distribuio entre o SAP PI e o SAP R/3 com a transao BD64. Inclua os tipos de mensagem IDoc ALEAUD, ALEREQ e TRIDOC. Para criar um Modelo de Distribuio: 1. Insira a transao BD64 no campo de comandos do SAP e clique em Enter. 2. Selecione o Sistema SAP R/3 (U47CLNT800). 3. Clique em Incluir tipo de mensagem. 4. Insira os dados de tipo de mensagem para comunicao do SAP R/3 com o SAP PI: Emissor R/3, Receptor PI, Tipo de mensagem ALEAUD, ALEREQ e TRIDOC. 5. Salve. 6. Insira os dados de tipo de mensagem para comunicao do SAP PI com o SAP R/3: Emissor PI, Receptor R/3, Tipo de mensagem ALEAUD, ALEREQ e TRIDOC. 7. Salve.
Gerar Perfis do Parceiro

No Modelo de Distribuio, possvel gerar Perfis do Parceiro automaticamente pela seleo de Gerar perfis do parceiro no menu Ambiente, ou manualmente, usando a transao WE20.
Configurando a Estrutura do Adaptador IDoc do SAP PI

Para configurar a estrutura do adaptador IDoc do SAP PI: v Crie uma Porta no adaptador IDoc (IDX1) v Crie os metadados para o IDoc (IDX2)
Criar uma Porta no Adaptador IDoc (IDX1)

Crie uma porta no adaptador IDoc com a transao IDX1. Ao criar uma porta, voc estabelece uma conexo RFC com o sistema que contm os metadados de IDocs. Defina uma porta como SAP U47, o cliente como 800, com o destino RFC U47CLNT800 para estabelecer a conexo RFC com o sistema SAP R/3 Enterprise. Crie uma segunda porta como SAPC46, o cliente como 800, com o destino RFC C46CLNT800 para estabelecer a conexo com o sistema SAPC46.
16
1. Chame a manuteno da porta do adaptador IDoc da transao com a transao IDX1. 2. Escolha Criar para criar uma nova porta para o sistema selecionado. 3. Especifique a Porta. O nome da porta composto pelo tipo e ID do sistema. Por exemplo, SAP E47. 4. Especifique o Cliente. Nota: As especificaes para Porta e Cliente correspondem porta e ao cliente do emissor no registro de controle IDoc. 5. Especifique o destino RFC do sistema conectado. Por exemplo, U47CLNT800. 6. Salve.
Criar os Metadados para o IDoc (IDX2)

Crie os metadados para o adaptador IDoc com a transao IDX2. Para os exemplos, crie os metadados DEBMAS06 na porta SAPU47 e DEBMAS03 na porta SAPC46 do adaptador IDoc. 1. Os metadados IDoc (Intermediate Document) so compostos por estruturas do tipo IDoc correspondente necessrio para que o adaptador IDoc converta esses IDocs no formato IDoc XML. 2. Usando a conexo RFC, os metadados IDoc podem ser chamados no tempo de execuo ou carregados no Servidor de Integrao no tempo de design. 3. A janela que aberta exibe o diretrio de todos os sistemas conectados com os adaptadores IDoc para os quais os metadados foram carregados.
Configurar a Integrao do SAP PI

H trs reas principais no SAP PI que requerem desenvolvimento: v Configurando o System Landscape v SAP Integration Builder: Design v SAP Integration Builder: Configurao As mudanas nas trs podem ser navegadas a partir da janela SAP PI Integration Builder, acessvel on-line. Para abrir a janela Integration Builder: 1. Efetue logon no servidor SAP PI. 2. Na janela Fcil Acesso ao SAP, expanda Exchange Infrastructure Ambiente. 3. Clique duas vezes em Iniciar o Integration Builder. A janela principal aberta.
Configurando o System Landscape

No Diretrio System Landscape do SAP PI, possvel definir a topologia do sistema, as estruturas dos componentes e as informaes dos componentes do software instalado. No Diretrio Landscape ser necessrio introduzir software de terceiros (WebSphere Transformation Extender) no System Landscape.
17
Todos os componentes de software com suas verses devero ser definidos no Diretrio System Landscape. Todos os componentes e produtos de software do SAP vm predefinidos no Catlogo do Software. Para desenvolver o System Landscape, ser necessrio: 1. Incluir o Produto Transformation Extender no Catlogo do Software 2. Definir um Sistema Tcnico para o Transformation Extender 3. Definir um Sistema de Negcio para o Transformation Extender 4. Criar um Sistema Tcnico e um Sistema de Negcio para o SAP R/3
Incluir o Transformation Extender no Catlogo do Software

Para incluir o Transformation Extender como software de terceiros no Diretrio System Landscape do SAP PI: 1. Na janela principal do Integration Builder, selecione Diretrio System Landscape. Insira os detalhes do login. O Diretrio System Landscape aberto. 2. Selecione Catlogo do Software. O Catlogo do Software aberto. 3. Clique em Novo Produto. 4. Insira o Fornecedor, o Nome e a Verso para definir o Produto. Clique em Criar. Por exemplo, defina o nome do Fornecedor (ibm.com), o Nome do produto (WebSphere Transformation Extender), Verso (8). 5. Para definir um componente de software para um novo produto, escolha o Produto na lista suspensa. Insira o Nome e a Verso. Clique em Criar. Para continuar com o exemplo, defina o componente para o produto (WebSphere Transformation Extender), o fornecedor (ibm.com), com o nome (PACK_FOR_SAP_XI) e o nmero da verso (2).
Definir um Sistema Tcnico para o WebSphere Transformation Extender

Um Sistema Tcnico possui propriedades tcnicas, como endereos, e so sistemas aplicativos instalados fisicamente. No Diretrio Landscape Tcnico, defina dois sistemas tcnicos (EDI_SYSTEM, SWIFT_SYSTEM) para o produto criado (PACK_FOR_SAP_XI, 2 de ibm.com): 1. Na janela principal do Integration Builder, selecione Diretrio System Landscape. 2. Selecione Landscape Tcnico. 3. Escolha o Tipo de Sistema Tcnico Terceiro na lista suspensa. Clique em Novo Sistema Tcnico. 4. Ative Terceiro. Clique em Prximo. 5. Insira um Nome de Sistema e um Nome do Host. Para o Nome do Host, insira o nome do host em que o Transformation Extender e os SAP PI Technical Adapters esto instalados. Clique em Concluir. 6. Selecione o produto apropriado, WebSphere Transformation Extender. Clique em Incluir. O produto e os componentes aparecem na rea Produtos Selecionados. Clique em Concluir.
18
Definir um Sistema de Negcio para o Transformation Extender

Sistemas de Negcios so sistemas lgicos que funcionam como emissores ou receptores em uma visualizao do aplicativo do cenrio de integrao. Esses Sistemas de Negcios so baseados e implementados em Sistemas Tcnicos que so sistemas aplicativos instalados fisicamente. No Diretrio PI Landscape, crie dois Sistemas de Negcios (EDI_SYSTEM, SWIFT_SYSTEM) para o Sistema Tcnico definido na seo anterior. 1. Selecione Landscape de Negcios no Diretrio System Landscape. 2. 3. 4. 5. 6. 7. Clique em Novo Sistema de Negcio. Insira um nome exclusivo para o Sistema de Negcio. Clique em Avanar. Ative Terceiro. Clique em Avanar. Selecione o Sistema Tcnico para o Sistema de Negcio. Clique em Avanar. Selecione os produtos instalados nesse Sistema de Negcio. Clique em Avanar. Especifique um servidor de integrao para o Sistema de Negcio, neste caso, selecione XI3. Clique em Concluir. O Sistema de Negcio criado.
Criar um Sistema Tcnico e um Sistema de Negcio para o SAP R/3

Repita as etapas descritas nas pginas anteriores e crie um Sistema Tcnico e um Sistema de Negcio para o SAP R/3. Durante essa criao, possvel escolher no Catlogo do Software a verso de componente de software SAP apropriada para o system landscape. Para suportar os exemplos, crie os sistemas U47 e C46.
SAP Integration Builder: Design

O Repositrio de Integrao do SAP uma localizao de armazenamento central para dados no SAP Exchange Infrastructure. Estruturas de dados, mensagens e mapeamentos so todos especificados no Repositrio de Integrao. No Repositrio de Integrao, ser necessrio: v Importar Componentes de Software do Diretrio Landscape para o Repositrio de Integrao v Criar Objetos para os Cenrios de Negcios
Importar Componentes de Software no-SAP e SAP

Para importar novos componentes de software: 1. Na janela principal do Integration Builder, selecione Repositrio de Integrao. 2. No menu Ferramentas, selecione Transferir do Diretrio System Landscape Importar Verses de Componente de Software. 3. Na lista de verses de componentes de software, selecione o produto criado (PACK_FOR_SAPXI, 2 de ibm.com) e SAP BASIS C46 ou a verso apropriada. Clique em Importar. O componente de software aparece na rvore.
19
Criando Objetos para os Cenrios de Negcios

Para criar objetos para os Cenrios de Negcios: 1. Na janela principal do Integration Builder, selecione Repositrio de Integrao. 2. Abra o componente de software importado (PACK_FOR_SAP_XI, 2 de ibm.com). 3. Inclua um Espao de nomes http://ibm.com/xi/Plug-in/demo/content. Verifique se Importao de Interface No Permitido est ativado. Salve. Os Objetos de interface so criados e aparecem na rvore. Os Objetos de Interface consistem em: v Tipos de Dados v Tipos de Mensagens v Interfaces de Mensagens 4. Crie Tipos de Dados para os tipos de entrada e de sada. a. Expanda Objetos de Interface. b. Clique com o boto direito do mouse em Tipos de Dados e selecione Novo. A janela Criar Objeto aberta. c. Insira um Nome e uma Descrio. d. Clique em Criar. e. Insira o Tipo. Para os cenrios, insira a Estrutura como payext, a Categoria como Simples, o Tipo como xsd:string. f. Salve e Ative. 5. Para criar Tipos de Mensagens para as mensagens de entrada e de sada: a. Clique com o boto direito do mouse em Tipos de Mensagens e selecione Novo. b. Insira um Nome e uma Descrio. c. Clique em Criar. d. Defina um Tipo de Dado a ser usado para esse Tipo de Mensagem. e. Salve e Ative. 6. Crie a Interface de Mensagem para as mensagens de entrada e de sada. a. Clique com o boto direito do mouse em Interface de Mensagem e selecione Novo. b. Insira um Nome e uma Descrio. c. Clique em Criar. d. Selecione o Tipo de Mensagem e Atributos. e. Salve. 7. Ative os objetos modificados. 8. Execute a transao SXI_CACHE. 9. No Cache de Diretrio do SAP PI, selecione Iniciar Atualizao Completa do Cache para atualizar o Cache. O objeto aparece no Cache de Diretrio do SAP PI.
Importar e Ativar as Interfaces IDoc do SAP BASIS 6.20

Para configurar a Interface IDOC do SAP BASIS 6.20:
20
1. Na janela Integration Builder: Design, inicie a verso do componente de software. Importe usando Ferramentas >Transferir do LSD > Importar Verses de Componente de Software. 2. Selecione as verses de componente de software SAP BASIS 6.20 e SAP BASIS 4.6C. Importe. 3. Abra a verso de componente de software SAP BASIS 6.20. a. Para configurar a verso de componente de software: Na janela Verses de Componente de Software, defina os Dados de Conexo para Importao do sistema SAP: ID do Sistema e Nmero do Cliente. b. Alterne para o modo de Edio. c. Na seo Importao de Interface, ative Importao das interfaces RFC e IDoc dos Sistemas SAP Permitida. d. Insira o ID do Sistema. e. Insira o Servidor de Mensagens. f. V para Objetos Importados> IDocs > Importar do Objeto SAP. Fornea o nome do host e os parmetros de login do sistema SAP 4.7. g. Na lista de IDocs, escolha IDocs DEBMAS06. Importe. Ative. 4. Abra Verses de Componente de Software SAP BASIS 4.6C. a. Para configurar a verso de componente de software: Na janela Verses de Componente de Software, defina os Dados de Conexo para Importao do sistema SAP: ID do Sistema e Nmero do Cliente. b. V para Objetos Importados> IDocs > Importar do Objeto SAP. Fornea o nome do host e os parmetros de login do sistema SAP 4.6. c. Na lista de IDocs, escolha IDoc DEBMAS03. Importe. Ative.
SAP Integration Builder: Configurao

O Diretrio de Integrao do SAP gerencia os objetos disponveis no Repositrio de Integrao do SAP, juntamente com os requisitos de configurao especficos de um system landscape. No tempo de execuo, as informaes do Diretrio de Integrao do SAP so avaliadas no Servidor de Integrao. Use o SAP Integration Builder: Diretrio de Integrao para criar um cenrio de negcios.
Criando um Cenrio de Negcios

Para criar um cenrio de negcios, siga as etapas abaixo. O exemplo detalha a criao de um cenrio de negcios do adaptador de arquivo. 1. Na janela principal do Integration Builder, selecione Diretrio de Integrao. Insira os detalhes do login. 2. Clique no cone Assistente de Configurao. 3. Escolha Comunicao Interna. 4. Especifique o Emissor. Insira os detalhes do sistema de negcio Emissor. Escolha o Servio e a Interface. Para o Cenrio EDI, defina o Emissor como um sistema de negcio SAP R/3 Enterprise U47 com a interface IDoc ORDERS.ORDERS05. Clique em Continuar.
21
5. Especifique o Receptor. Insira os detalhes do sistema de negcio Receptor. Escolha o Servio e a Interface. Para o Cenrio EDI, defina o Receptor como o sistema no-SAP EDI_SYSTEM com a interface EDI_IN. Clique em Continuar. 6. No necessrio um contrato de emissor neste caso. Clique em Continuar. 7. Especifique a Determinao do Receptor. Ative Incluir Receptor. Clique em Continuar. 8. Defina o Mapeamento de Interface. A interface de mapeamento definida anteriormente, order_edi para o par U47-EDI_SYSTEM aparecer automaticamente. Clique em Continuar. Para obter detalhes adicionais, consulte o Captulo 4 Criando uma Interface de Mapeamento. 9. Na janela Contrato do Receptor, defina o Canal de Comunicao como o Ponto de Extremidade. Defina o Canal de Comunicao do Receptor como file_receiver da Conectividade de PI. Clique em Continuar. A configurao do Canal de Comunicao descrita em detalhe na etapa 12. 10. Insira ou inclua o nome do Cenrio. Para o Cenrio EDI, o nome PluginEDIMapping. Clique em Concluir. O Log do Assistente de Configurao aberto. 11. Para continuar, crie um ponto de extremidade, TF_FILE, como uma conexo HTTP para um sistema externo usando a transao SM59. Insira o host e a porta do adaptador file_receiver para as Configuraes do Sistema de Destino. Salve. 12. Para completar a configurao do Canal de Comunicao, abra o cenrio (o exemplo de EDI usa PluginEDIMapping). Selecione Servio sem Parte > Sistema de Negcio > EDI_SYSTEM > Canal de Comunicao > file_receiver. Abra o Canal de Comunicao. Insira as informaes apropriadas para o Canal de Comunicao: a. b. c. d. Verifique se o Tipo de Adaptador PI. Insira o protocolo de Transporte, HTTP 1.0. Insira o Protocolo de Mensagem, PI 3.0. Verifique se o Mecanismo Adaptador est definido como Servidor de Integrao.
e. Selecione Destino HTTP como o Tipo de Endereamento. f. Insira o nome do Destino HTTP como TF_FILE. 13. Ative todas as mudanas no Diretrio de Integrao usando a guia Alterar Listas. 14. Execute a transao SXI_CACHE. 15. No Cache de Diretrio do SAP PI, selecione Iniciar Atualizao Completa do Cache para atualizar o Cache.
Configurando os SAP PI Technical Adapters

O Mecanismo Adaptador do SAP conecta o Mecanismo de Integrao aos sistemas externos. H quatro adaptadores tcnicos do SAP: v Adaptador de Arquivo - troca arquivos com sistemas externos. v Adaptador JMS - comunica-se com os sistemas de mensagens. v Adaptador SOAP - comunica-se com provedores e clientes de Servios da Web.
22
v Adaptador JDBC - no suportado pelo IBM WebSphere Transformation Extender Pack para SAP XI. Esses adaptadores tcnicos so usados para comunicao nas duas direes, do adaptador com o sistema externo (Transformation Extender) e do sistema externo com o mecanismo adaptador. Os adaptadores SAP enviam para uma fila, uma pasta, uma URL ou um destino RFC. Os trs adaptadores JMS, SOAP e Arquivo podem funcionar como adaptadores de entrada e de sada. Um adaptador receptor envia dados para o sistema Transformation Extender. Um adaptador emissor obtm as mensagens do sistema Transformation Extender. Os adaptadores do Transformation Extender so complementares aos PI Technical Adapters. Eles foram projetados para obter a mensagem do destino do SAP PI, transformar, processar e enviar a mensagem para terceiros. Usando os adaptadores do Transformation Extender, as mensagens baseadas em XML e HTTP podem ser facilmente convertidas em qualquer protocolo e formato. Os Technical Adapters so configurados usando-se o menu Configurao do mecanismo adaptador. Ser necessrio modificar partes do menu Configurao para configurar os parmetros corretos juntamente com seus valores para que os Technical Adapters se comuniquem com um sistema externo. Algumas configuraes de parmetros no mecanismo adaptador so obrigatrias, algumas so obrigatrias para tipos especiais de adaptadores e outras so opcionais. Consulte a documentao do SAP para obter detalhes adicionais. Para comear a trabalhar com os Technical Adapters, cada adaptador de entrada e de sada deve ser instalado, configurado e iniciado. Consulte a documentao do SAP para obter detalhes, se no estiver familiarizado com esta atividade.
Instalando os Technical Adapters

Antes de Iniciar
Os PI Technical Adapters so distribudos como um Arquivo SDA.

Instale os PI Technical Adapters na mquina local em que reside o Transformation Extender. Descompacte o arquivo ZIP de tech.adapters SDA - Arquivo no diretrio local. Por exemplo, em um diretrio ...\TechnicalAdapter\ em seu PC. Verifique se incluiu servlet.jar no caminho \TechnicalAdapters\tech_adapter. possvel fazer download de servlet.jar do Web site da SUN.
Iniciando o Mecanismo Adaptador

Antes de Iniciar
Antes de iniciar o Mecanismo Adaptador, configure as propriedades do adaptador file_receiver. Um arquivo de configurao file_receiver.properties fornecido. As configuraes correspondem ao cenrio.
23

Copie o arquivo file_receiver.properties da pasta install_dir\examples\packs\ sap_xi\3.0\plug-in\EDI\config\. Cole e substitua o arquivo padro file_receiver.properties na pasta ...\TechnicalAdapters\Configuration\ do diretrio de instalao do adaptador tcnico. Para iniciar o Mecanismo Adaptador: 1. Execute run_adapter.bat para Windows ou run_adapter.cmd para UNIX localizado no diretrio Tcnico do PC. 2. Para monitorar o Mecanismo Adaptador, usando um navegador, chame a URL http://localhost:8200. Efetue logon como um usurio SAP com a senha init. 3. Inicie o adaptador receiver_file.
O que Fazer Depois

Para obter informaes adicionais, consulte a documentao da estrutura do adaptador PI do SAP
24

Este captulo descreve o Transformation Extender Plug-in, reala seus recursos-chave e explica como introduzir o Plug-in no system landscape.
Antes de Comear
Antes de usar o IBM WebSphere DataStage Transformation Extender Plug-in, recomenda-se que se tenha um conhecimento prtico do WebSphere DataStage Transformation Extender, do Servidor de Aplicativos da Web do SAP e das interfaces do SAP PI. Este captulo supe que voc j tenha: v Instalado o IBM WebSphere Transformation Extender Launcher, o IBM WebSphere Transformation Extender Pack para SAP PI e os PI Technical Adapters. v Instalado os PI Technical Adapters. v Configurado o Diretrio Landscape. v Estabelecido uma conexo com os servidores SAP Exchange Infrastructure e SAP R/3. v Recebido o nvel adequado de acesso de usurio aos servidores SAP Exchange Infrastructure e SAP R/3.
WebSphere Transformation Extender Plug-in

O IBM WebSphere Transformation Extender Pack para SAP PI foi projetado para abrir as possibilidades de comunicao de troca de dados entre sistemas externos (sistemas legados e no-SAP, como o PeopleSoft) usando o SAP Exchange Infrastructure (PI). Este Pack contm o Transformation Extender Plug-in desenvolvido para combinar o SAP Exchange Infrastructure, com suas interfaces para sistemas SAP, com as funcionalidades de mapeamento altamente sofisticadas do mecanismo do Transformation Extender. A arquitetura do plug-in mostrada
Origem
SAP PI DataStage TX Plug-in
Destino
Servidor RMI
Mapear
IBM DataStage TX
abaixo.
25
Os usurios podem gerenciar facilmente seus system landscapes para explorar totalmente a tecnologia de mapeamento potente no Transformation Extender e, ao mesmo tempo, mover informaes usando o SAP Exchange Infrastructure. O Transformation Extender Plug-in fornece a capacidade de executar mapas do Transformation Extender a partir do SAP Exchange Infrastructure, complementando as capacidades de mapeamento do SAP PI e estendendo as possibilidades de desenvolvimento de seu system landscape. O SAP Exchange Infrastructure baseia-se nas mensagens formatadas XML. Essas mensagens so mapeadas atravs de programao java, Mapeamentos de XSLT ou mapeamentos implementados pela ferramenta de mapeamento do SAP. O SAP PI executa roteamento e resoluo de endereo e o Transformation Extender executa mapeamento e transporte. A configurao e a funcionalidade do Transformation Extender Plug-in incluem: v Programa de mapeamento Java v Configuration Files Builder, uma interface com o usurio para construir arquivos de configurao de cenrios v Arquivo de parmetros de configurao globais para promover/transportar definies de configurao do SAP PI no landscape de desenvolvimento, QA e na produo. Isso tornar o movimento de todas as configuraes do Transformation Extender entre os ambientes totalmente transparente. v Um arquivo de configurao exclusivo por cenrio de mapa/negcios. Os arquivos usados para a configurao do Pack fazem parte do Repositrio do SAP. Isso garante a autorizao geral das funes e cria uma estratgia de implementao tolerante a falhas. v Suporte para o arquivo de propriedades XML contendo os parmetros de tempo de execuo e as propriedades do mapa. O arquivo possibilita a substituio das propriedades do mapa do Transformation Extender, como vrias entradas e sadas, incluindo logs, rastreio, configuraes da rea de trabalho, adaptadores e suas linhas de comandos no tempo de execuo. Os arquivos de mapeamento so executados em diferentes ambientes (Desenvolvimento/QA/Produo). Isso sugere que os mapas possuem propriedades diferentes quando executados em ambientes diferentes. v Retorna um status de mapeamento completo para o SAP PI, incluindo o cdigo de erro e a mensagem de erro do mapa. v Suporte Unicode para comunicao com o SAP. No Transformation Extender (e no Map Designer), as informaes so disponibilizadas em UTF-16. O design do Transformation Extender Plug-in fornece os seguintes benefcios ao usurio final: v Aproveita as ferramentas existentes de terceiros v Persistncia no h perda de mensagens v Acompanhamento e comrcio de fluxos de mensagens com entrega automtica garantida v Limpeza de dados v Ativao da execuo da funo CONSULTA v Validao da ativao de dados
26
Modelo de Comunicao
Os dois modelos de comunicao do Transformation Extender Plug-in suportam a transformao do formato de mensagem de negcios IDoc do SAP XML em formatos de mensagem de negcios EDI e SWIFT.
Cenrio: Cenrio de Negcios Swift do Plug-in

O cenrio de negcios Swift segue as mesmas etapas do cenrio de negcios EDI do Plug-in; apenas o mapa, o acionador e a sada so diferentes. Siga as etapas detalhadas do design e do tempo de execuo do cenrio EDI. O mapa de transformao PAYEXT em Swift explicado no Captulo 2, Entendendo o Mapa Payext2swiftmt202.mms.
Cenrio: Cenrio de Negcios EDI do Plug-in

Este cenrio de negcios modela a troca de mensagens do processo de integrao. A ordem de compra enviada do SAP R/3 Enterprise para SAP PI usando ALE. No SAP PI, o plug-in usado como uma interface de mapeamento. O plug-in executa um mapa do Transformation Extender. O mapa converte o tipo de mensagem XML IDoc ORDERS05 no tipo de mensagem X12 EDI 850. A mensagem EDI roteada para o adaptador file_receiver de PI. O adaptador faz a transferncia dele por FTP para um diretrio c:\temp. A definio, a configurao, o mapeamento, a execuo e o monitoramento do processo do cenrio de negcios esto todos integrados no SAP Exchange Infrastructure e no IBM WebSphere Transformation Extender. A configurao do Transformation Extender Plug-in consiste em trs estgios: 1. Design 2. Configurao 3. Tempo de Execuo
Design
O desenvolvimento do cenrio de negcios comea com seu design. Neste cenrio de negcios: 1. A ordem de compra definida como uma mensagem processada. 2. As interfaces da mensagem ORDERS no Repositrio de Integrao so definidas como um formato de dados da mensagem de entrada. Para obter detalhes, consulte o Captulo 2, Entendendo a rvore do Tipo Gerada. 3. O Arquivo de Java importado para o Repositrio de Integrao para definir o mapeamento da mensagem. Os pr-requisitos para as etapas de tempo de design do Plug-in so descritos em detalhes no Captulo 3, incluindo a: v Configurao da comunicao ALE e dos Perfis do Parceiro entre os servidores SAP PI e SAP R/3. v Configurao do Diretrio Landscape System. v Definio dos objetos de design da Integrao para os componentes de software no-SAP e SAP. O design do processo de integrao consiste em quatro etapas: 1. Instalando o Transformation Extender Plug-in
27
2. Implementando o Transformation Extender Plug-in no Repositrio do SAP PI 3. Implementando os Arquivos de Configurao do Transformation Extender Plug-in 4. Criando uma Interface de Mapeamento
Instalando o Transformation Extender Plug-in

Os dois arquivos a seguir esto includos na instalao do IBM WebSphere Transformation Extender Pack para SAP PI. Os arquivos so instalados inicialmente no diretrio de instalao do Transformation Extender. v dstxxi.jar A instalao do Transformation Extender Plug-in requer o arquivo dstxxi.jar. Esse arquivo usado durante o registro do Plug-in. Esse arquivo dstxxi.jar possui dependncias no arquivo dtxpi.jar. v dtxpi.jar Copie o arquivo dtxpi.jar para os diretrios de sistema do Servidor SAP PI: <xiservermachine>\j2ee\cluster\server\bin\system Para instalar o plug-in, necessrio ter permisso de gravao ao diretrio do sistema SAP. A permisso para esta ao deve ser configurada para poder ser copiada para o diretrio.
Arquivos de Configurao do Transformation Extender Plug-in

As propriedades usadas pelo Plug-in em um ambiente de tempo de execuo so separadas: v Um arquivo de configurao global contendo as configuraes padro para todos os parmetros usados no Plug-in. O nome desse arquivo dstx_xi_global.properties. v Vrios arquivos de configurao exclusivos do cenrio. Um arquivo de configurao exclusivo construdo para cada cenrio de negcios. O arquivo de configurao contm o nmero de parmetros usado pelo Plug-in. Todos os arquivos de configurao so armazenados em um arquivo zip. O Pack fornece um arquivo de amostra scenarios_demo.zip com a instalao. O arquivo est localizado na pasta install_dir\examples\packs\sap_xi\3.0\plug-in\EDI\ config\ e contm um arquivo de configurao global e dois arquivos de configurao exclusivos que suportam dois cenrios de negcios demo. Cada cenrio de negcios identificado exclusivamente por um nome de sistema, um espao de nomes e um nome de interface. Os nomes dos arquivos de configurao dos cenrios so criados para ser exclusivos e formatados usando-se os identificadores emissores e receptores como a seguir:
<SenderName>&<SenderSystem>&<SenderNameSpace>&<SenderName>&<SenderSystem>& <ReceiverNameSpace>&.properties
O nome padro scenarioX.properties designado automaticamente a cada arquivo de configurao do cenrio durante sua criao e a referncia ao nome do arquivo original armazenada no arquivo container.properties como uma lista de referncia:
Scenario3=PAYEXT.PEXR2002&U47&urn:sap:com:document:sap:idoc:messages&SWIFT_IN& SWIFT_SYSTEM&http://ibm.com/xi/demos/content
28
Essa lista usada pela funo Localizar, por exemplo. O arquivo container.properties armazenado no arquivo zip. Nome da Configurao. possvel designar uma descrio significativa para o arquivo de configurao do cenrio. Ela chamada de nome da configurao. Nota: Use o Configuration Files Builder para editar os arquivos de configurao. A edio manual dos arquivos de configurao dentro do zip no recomendada.
Configuration Files Builder

Todos os arquivos de configurao de propriedades do Plug-in so criados e atualizados pela interface com o usurio, o Configuration Files Builder, removendo a necessidade de configurao manual dos parmetros necessrios. A interface com o usurio um aplicativo independente. O aplicativo fornece uma interface que diferencia entre as configuraes globais dos parmetros do Plug-in (armazenados no arquivo de configurao global dstx_xi_global.properties) e cada um dos arquivos de configurao de acordo com o cenrio de negcios, fornecendo a interface baseada no parmetro.
Abrindo o Configuration Files Builder

No menu Iniciar, selecione Iniciar > Programas > IBM Websphere Transformation Extender > PACK PARA SAP PI > ConfigFilesBuilder.
Configurando os Arquivos de Configurao do Plug-in

Antes de Iniciar
Para comear a trabalhar com o Configuration Files Builder, necessrio carregar um de dois arquivos de configurao. O arquivo de configurao padro fornecido no arquivo global.properties.zip localizado no diretrio de instalao. O arquivo zip inclui apenas o arquivo de propriedades globais. possvel incluir qualquer nmero de arquivos de configurao do cenrio usando o Configuration Files Builder.

Com os exemplos, use o arquivo scenarios_demo.zip fornecido com este Pack e localizado no diretrio: install_dir\examples\packs\sap_xi\3.0\plug-in\EDI\ Config. Para carregar os parmetros do Transformation Extender Plug-in: 1. Carregue os arquivos de configurao do arquivo scenarios_demo.zip a. Clique em Carregar Arquivos de Configurao. b. Navegue at o local do arquivo scenarios_demo.zip. c. Clique em Abrir. d. Verifique o contedo dos arquivos de configurao. 2. Salve as configuraes. Clique em Salvar Arquivos de Configurao e/ou em Concluir. 3. Implemente o arquivo zip no Repositrio de Integrao do SAP PI.
29
O que Fazer Depois

O arquivo scenarios_demo.zip fornecido com a instalao e contm um arquivo de configurao global e dois arquivos de configurao de cenrio que suportam os cenrios do Plug-in. O arquivo zip inclui o arquivo container.properties. O arquivo container.properties no fica visvel na interface com o usurio.
Lista de Parmetros no Arquivo de Configurao Global

Os parmetros do servidor so especficos do ambiente em que os mapas esto sendo executados. Como resultado, os seguintes parmetros do servidor precisam ser especificados no arquivo dstx_xi_global.properties: v v v v v v Host RMI Java (necessrio) - Nome do host RMI a ser usado Porta RMI Java (necessrio) - Porta de execuo do RMI Nome do Mapa (opcional) - necessrio usar barras invertidas. Nmero do Carto de Entrada (opcional) Nmero do Carto de Sada (opcional) O Arquivo de Propriedades XML fica desativado. No possvel configurar o arquivo de propriedades XML no arquivo de propriedades globais.
Lista de Parmetros no Arquivo de Configurao do Cenrio

Os parmetros do cenrio de negcios so especficos do roteamento de mensagens do cenrio de negcios. Como resultado, os seguintes parmetros do processo de negcios precisam ser especificados em cada arquivo scenarioX.properties exclusivo, (em que X um nmero entre 1 e 10.000): v Servio Emissor v Interface do Emissor v Espao de Nomes do Emissor v Servio Receptor v v v v Interface do Receptor Espao de Nomes do Receptor Host RMI - Nome do host RMI a ser usado. Porta RMI - Porta de execuo do RMI.
v Nome do Mapa - Caminho completo do mapa que ser executado. Nota: necessrio usar barras invertidas. v Nmero do Carto de Entrada - O nmero do carto de entrada que ser sobrescrito pelo fluxo de entrada. v Nmero do Carto de Sada - O nmero do carto de sada que ser sobrescrito pelo fluxo de sada. v Arquivo de Propriedades XML Os parmetros do arquivo de configurao substituem os valores de parmetros do arquivo de configurao global.
Gerenciando os Arquivos de Configurao do Plug-in

possvel localizar, incluir, editar, remover, ativar o rastreio e salvar os arquivos de configurao.
30
Localizar Arquivo de Configurao

possvel localizar um arquivo de configurao anexado a um cenrio especfico fornecendo o nome da configurao ou fornecendo um ou mais dos seis identificadores exclusivos: v v v v v v Interface do Emissor Servio Emissor Espao de Nomes do Emissor Interface do Receptor Servio Receptor Espao de Nomes do Receptor
Para localizar um arquivo de configurao: 1. Clique em Localizar Arquivo de Configurao. 2. Insira as informaes de procura. 3. Clique em Localizar Arquivo de Configurao. O primeiro cenrio com uma correspondncia da cadeia solicitada aparece.
Incluir Arquivo de Configurao

Para incluir um arquivo de configurao: 1. Clique em Incluir Arquivo de Configurao. 2. Insira uma descrio do cenrio no campo Nome da Configurao e defina os seis outros identificadores exclusivos. 3. Clique em Incluir Arquivo de Configurao. O arquivo de configurao do cenrio especfico includo com o nome scenarioxx.properties, em que xx um nmero designado automaticamente na ordem crescente sequencial. O arquivo de configurao do cenrio inserido no arquivo zip do Transformation Extender Plug-in. 4. Clique em Salvar Arquivo de Configurao.
Editar Arquivo de Configurao

Para editar um arquivo de configurao: 1. Clique em Editar Arquivo de Configurao. 2. Modifique os valores exclusivos do cenrio na seo Propriedades do Cenrio. 3. Modifique a descrio para o cenrio ativando o Nome da Configurao e inserindo detalhes significativos. 4. Clique em Editar Arquivo de Configurao. 5. Clique em Salvar Arquivo de Configurao. O arquivo de configurao anexado ao cenrio atualizado.
Remover Arquivo de Configurao

Para remover um arquivo de configurao: 1. Clique em Remover Arquivo de Configurao. 2. Feche o arquivo de configurao a ser excludo. 3. Clique em Remover Arquivo de Configurao. O arquivo de configurao excludo e o nmero do cenrio designado anteriormente a ele no ser mais usado.
31
Rastreamento
A ativao da opo de rastreio criar arquivos de log no diretrio Servios de Terceiros do SAP PI: \\SAPXISERVERHOST\SAPSERVICExi3
Salvar Arquivo de Configurao

Salva a lista do arquivo de configurao de parmetros do Plug-in em um arquivo formatado zip em qualquer diretrio.
Concluir
Clique em Concluir. Depois de salvar o arquivo zip, reimporte o arquivo de configurao ou o archive de cenrio para o SAP XI. Para reimportar o arquivo zip contendo os arquivos de configurao para o Repositrio de Integrao do SAP PI, necessrio confirmar as mudanas nos arquivos de configurao.
Arquivo de Propriedades XML

O Arquivo de Propriedades XML possibilita a substituio de parmetros de mapas compilados ao executar um mapa a partir do SAP XI. O utilitrio ExportXML fornecido para criar o Arquivo de Propriedades XML a partir do arquivo de mapeamento compilado do Transformation Extender. 1. Verifique se Java est na varivel de ambiente PATH. 2. Edite setenv.bat - altere MERCHOME para apontar para o diretrio de instalao local do Transformation Extender. 3. Execute setenv.bat. Para usar o utilitrio: 1. Execute o utilitrio da seguinte forma: <nome_do_mapa> com a extenso .mmc. Por exemplo, test1.mmc. 2. Inclua o caminho completo para o mapa se o mapa no estiver no mesmo diretrio que ExportXML.class java ExportXML <nome_do_mapa> 3. O arquivo map.xml criado em c:\dir. Atualize O arquivo conforme apropriado.
Lista de Parmetros de Mapeamento

Um mapa compilado contm, geralmente, configuraes para o teste de desenvolvimento e local de um mapa. Por exemplo, entradas e sadas so baseadas geralmente no arquivo e as configuraes de auditoria e rastreio suportam acompanhamento de erro. Para execuo durante o uso produtivo, vrios desses parmetros precisam ser configurados de forma diferente para garantir, por exemplo, segurana de encadeamento e bom desempenho. Os seguintes parmetros permitem alterao: v Configuraes de auditoria - todas v Configuraes de rastreio - todas v Configuraes de rea de trabalho - todas v Gravar a carga til do PI no carto de entrada principal
32
v Substituir a carga til do PI pela sada principal do mapa v Substituir outros cartes de entrada por Cadeias v Adaptadores para cartes de Entrada e de Sada: altere o tipo do adaptador (de arquivo para MQSeries); altere a linha de comandos do adaptador
Usando o Arquivo de Propriedades XML para Substituir Parmetros do Mapa Original

Para visualizar o Arquivo de Propriedades XML de amostra MapSettingsOverride.xml fornecido na instalao do Pack, abra o arquivo no diretrio install_dir\examples\packs\sap_xi\3.0\plug-in\EDI\config\. A varivel $MercatorEnvironment substituda durante a execuo do mapeamento, dependendo do ambiente em que a execuo ocorre. O carto de entrada denominado MainInputCard ser substitudo pela carga til do PI e o contedo do carto de sada denominado ReturnCard substituir a carga til do PI como resultado do mapeamento. As configuraes do mapa original sero sobrescritas no tempo de execuo de acordo com as especificaes do arquivo XML.
Implementando o Transformation Extender Plug-in no Repositrio do SAP PI

Para implementar o Transformation Extender Plug-in, siga estas etapas: 1. Efetue logon no SAP XI. 2. 3. 4. 5. 6. Na janela Fcil Acesso ao SAP, expanda a pasta Exchange Infrastructure. Selecione Iniciar o Integration Builder. A janela principal aberta. Selecione Repositrio de Integrao. Expanda seu objeto de componente de software. Expanda Objetos de Mapeamento.
7. Clique com o boto direito do mouse em Arquivos Importados e selecione Novo. 8. Insira um nome, TX_Plugin, por exemplo. Um Espao de Nomes e uma Verso de Componente de Software sero selecionados. Clique em Criar. 9. Clique duas vezes no archive criado. 10. No menu Ferramentas, selecione Importar Archive. 11. Localize o diretrio de instalao do Transformation Extender e selecione dstxxi.jar. Clique em Abrir. O Integration Builder reconhece e exibe automaticamente trs classes: scenario.class, TXMap.class e TXMapProperties.class. 12. Clique com o boto direito do mouse no archive e selecione Ativar. 13. Inicie a transao SXI_CACHE.
O que Fazer Depois

No Cache de Diretrio do SAP PI, selecione Iniciar Atualizao Completa do Cache para atualizar o Cache. O Plug-in implementado no repositrio do SAP PI como um programa de mapeamento java.
33
Implementando os Arquivos de Configurao do Transformation Extender Plug-in

Antes de Iniciar
Os arquivos de configurao usados pelo Plug-in precisam ser configurados e implementados para que sejam uma parte integrada do mecanismo de transporte padro do SAP.

Para implementar o archive de arquivos de configurao: 1. Efetue logon no SAP XI. Na janela Fcil Acesso ao SAP, expanda a pasta Exchange Infrastructure. 2. Selecione Iniciar o Integration Builder. A janela principal aberta. 3. Selecione Repositrio de Integrao. 4. Expanda seu objeto de componente de software. 5. Expanda Objetos de Mapeamento. 6. Clique com o boto direito do mouse em Arquivos Importados e selecione Novo. 7. Insira um nome cenrios. Um Espao de Nomes e uma Verso de Componente de Software sero selecionados. Clique em Criar. 8. Clique duas vezes no archive criado. 9. No menu Ferramentas, selecione Importar Archive. 10. Localize o diretrio de instalao do Transformation Extender e selecione scenarios_demo.zip. Clique em Abrir. O Integration Builder reconhece e exibe o contedo do archive automaticamente. 11. Clique com o boto direito do mouse no archive e selecione Ativar. Isso importa o archive para o Repositrio do SAP PI. 12. Inicie a transao SXI_CACHE. 13. No Cache de Diretrio do SAP PI, selecione Iniciar Atualizao Completa do Cache para atualizar o Cache. O objeto aparece no Cache de Diretrio do SAP PI.
O que Fazer Depois
Criando uma Interface de Mapeamento

Antes de Iniciar
O mapeamento da interface registra o Plug-in para o par de interfaces no Repositrio de Integrao. Defina e salve as interfaces que voc deseja conectar no Repositrio de Integrao. Para obter detalhes sobre como definir e salvar interfaces, consulte as instrues no captulo trs.

Continuando da seo anterior, para criar uma Interface de Mapeamento: 1. Clique na guia Objetos. 2. Clique com o boto direito do mouse em Mapeamento da Interface na janela esquerda e selecione Novo.
34
3. Insira um nome (por exemplo, orders_edi) e uma descrio. Clique em Criar. 4. Salve. A interface de mapa criada aparece direita. O Programa de Mapeamento mapeia mensagens de diferentes componentes de aplicativo entre si. 5. Na rea Interfaces, selecione uma Interface de Origem e uma Interface de Destino. A Interface de Origem a Interface IDoc do componente de software SAP BASIS 6.20. No exemplo EDI, ORDERS.ORDERS05. A Interface de Destino a interface assncrona (EDI_IN) de entrada do componente de software no-SAP. Para fazer referncia a interfaces de qualquer verso de componente de software, clique no cone de ajuda (?). 6. Clique em Ler Interfaces. As interfaces de destino e de origem aparecem na rea de Mapeamento. 7. Na rea Programa de Mapeamento, clique no cone de ajuda localizado ao lado do campo da caixa de edio. Selecione um programa de mapeamento como uma Classe Java. Nota: possvel fazer referncia a programas de mapeamento (mapeamentos de mensagens, mapeamentos de XSLT ou Java) a partir do mesmo espao de nomes e da mesma verso de componente de software do mapeamento de interface. 8. Selecione a seguinte Classe Java: com/ibm/websphere/dtx/sap/xi/txplugin/TXMap Aparece o seguinte na seo Programa de Mapeamento: Classe Java com/ibm/websphere/dtx/sap/xi/txplugin/TXMap 9. Ative suas mudanas. Selecione a guia Alterar Listas localizada do lado esquerdo superior da janela. 10. Clique com o boto direito do mouse na Interface de Mapeamento (orders_edi). Selecione Ativar. 11. Execute a transao SXI_CACHE. 12. No Cache de Diretrio do SAP PI, selecione Iniciar Atualizao Completa do Cache para atualizar o Cache. O objeto aparece no Cache de Diretrio do SAP PI.
Configurao
O tempo de configurao do processo de integrao consiste em quatro etapas: 1. Criando o Cenrio de Negcios. No tempo de configurao, no Diretrio de Integrao, crie um servio sem uma parte para o prprio processo de integrao e para cada sistema de negcio do cenrio de integrao. Em seguida, defina um cenrio de integrao que faa referncia ao cenrio de integrao no Repositrio de Integrao. Para obter detalhes sobre como criar um cenrio de negcios, consulte o Captulo 3, Criando um Cenrio de Negcios. 2. Entendendo o Mapa de Transformao. Para obter detalhes sobre o mapa de transformao EDI, consulte o Captulo 2, Entendendo o Mapa de Transformao XML em EDI. 3. Iniciando o Servidor RMI. Para obter detalhes sobre como iniciar o servidor RMI, consulte o Captulo 2, O Servidor RMI. 4. Iniciando o Mecanismo Adaptador do PI. Para obter detalhes sobre como iniciar o Mecanismo Adaptador, consulte o Captulo 3, Iniciando o Mecanismo Adaptador.
35
Tempo de Execuo
No cenrio, as ordens de compra so criadas no sistema SAP R/3 Enterprise e o IDoc ORDERS enviado para o Servidor de Integrao. A mensagem IDoc convertida em uma mensagem EDI pelo programa de mapeamento do Transformation Extender Plug-in. A mensagem EDI roteada, em seguida, para o adaptador file_receiver e salva no diretrio c:\temp.
Antes de Iniciar
Inicie o servidor RMI se ele ainda no estiver em execuo. Para obter detalhes, consulte o Captulo 2, O Servidor RMI. O Perfil do Parceiro ALE j dever ter sido configurado em um sistema SAP R/3 e a Interface IDoc ORDERS06 introduzida ao SAP XI. Para obter detalhes, consulte o Captulo 3, Gerar Perfis do Parceiro (WE20). Verifique se a Mensagem de Controle est customizada e configurada para a Sada do EDI com o tipo de mensagem NEU. O Perfil do Parceiro (tipo LI e funo VN) criado com a mensagem de controle para o tipo de mensagem ORDERS. Consulte a biblioteca on-line do SAP para obter informaes adicionais.

Um processo de integrao ORDERS para EDI iniciado quando uma mensagem ORDERS enviada. Para criar e enviar um IDoc ORDERS06, que acione a execuo do cenrio: 1. Crie uma Ordem de Compra usando a transao ME21. Insira o Fornecedor, o tipo de Ordem, a data da Ordem de compra, a Organizao da compra e o Grupo de compra. Salve. 2. Use o cdigo de transao ME22N com a ordem de compra recm-criada para enviar sua ordem. a. No menu Ordem de Compra, selecione Outra Ordem de Compra. b. Insira o nmero da ordem de compra criada. c. Clique em Outro Documento. d. Clique em Mensagens, que aciona a execuo da mensagem. e. Se as configuraes de sada no estiverem completas, insira/verifique as configuraes e envie no modo imediato.
O que Fazer Depois

A ao Enviar aciona a comunicao ALE entre os sistemas SAP R/3 e SAP PI. O tipo de mensagem IDoc ORDERS.ORDERS06 enviado para o sistema SAP PI. Um integrao PAYEXT a SWIFT iniciada quando a mensagem PAYEXT enviada.
Monitorando a Comunicao
Existem diferentes opes para monitorar o processamento: 1. Verifique o status do IDoc de sada no sistema SAP R/3 executando a transao WE05. 2. No monitor do SAP Exchange Infrastructure para mensagens XML processadas usando a transao SXMB_MONI.
36
3. Verifique o modo de comunicao RFC em seu PC. Os arquivos de rastreio e de log esto localizados em: c:\Documents and Settings\user_name\ SapWorkDir. 4. Verifique os logs do Transformation Extender Plug-in no diretrio \\SAPXISERVERHOST\SAPServicexi3. 5. Verifique o arquivo de log do mapa no diretrio do mapa. 6. Verifique o log do adaptador file_receiver. possvel visualizar o log no monitor do Mecanismo Adaptador usando o boto Visualizar Log. 7. Como resultado, o arquivo de dados da mensagem formatada EDI aparece no diretrio designado C:/temp.
Mensagem de Erro - Suporte ao Mapeamento

A seguir est a lista de mensagens retornadas pelo Plug-in para SAP XI em caso de erro:
// Mensagens de erro "Impossvel criar diretrio" "O arquivo zip no contm o(s) arquivo(s) de configurao" "O cenrio j existe" "No possvel excluir o arquivo de cenrio global" "Cenrio no localizado!" "No foram localizados mais cenrios. Deseja procurar do incio?"
Os cdigos de erro e as mensagens de execuo do mapa no esto includas nesta lista. Para obter informaes sobre os cdigos de erro do mapa e as mensagens correspondentes, use a Ajuda no Map Designer ou no Map Designer Reference Guide.
37
38
Captulo 5. Conexo do IDoc

Neste captulo, voc aprender como o adaptador ALE R/3 do Transformation Extender funciona com o adaptador IDoc do SAP PI e como introduzir os adaptadores em seu system landscape. O adaptador JALE fornece suporte a dados do conjunto de caracteres Unicode para entrada e sada de sistemas SAP R/3.
Antes de Comear
Antes de usar os adaptadores, recomenda-se que se tenha um conhecimento prtico da tecnologia Transformation Extender e das interfaces SAP PI. Este captulo supe que voc j tenha: v Instalado o IBM WebSphere Transformation Extender, incluindo o Launcher, o IBM WebSphere Transformation Extender Pack para SAP PI e os PI Technical Adapters. v Estabelecido uma conexo com servidores em seu system landscape v Recebido o nvel adequado de acesso de usurio ao SAP Exchange Infrastructure e a outros sistemas SAP em seu landscape v Configurado o Sistema de Negcio Emissor e Receptor e definido o adaptador IDoc como o ponto de extremidade nos Cenrios de Negcios Os exemplos deste captulo foram documentados em um ambiente Windows.
Adaptadores IDoc
O adaptador IDoc do SAP PI faz parte do Servidor de Integrao. Esse adaptador conecta os componentes do SAP ao SAP Exchange Infrastructure usando a comunicao do IDoc. O adaptador converte documentos baseados em XML e HTTP em IDocs e, em seguida, de volta ao seu formato original. O adaptador IDoc do SAP consiste basicamente em duas partes, no adaptador IDoc de entrada e no adaptador IDoc de sada, com metadados comuns nos tipos IDoc envolvidos. v O adaptador IDoc de entrada transforma o IDoc em uma mensagem XML para processamento adicional pelo Servidor de Integrao. v O adaptador IDoc de sada transforma a mensagem XML de volta em um tipo IDoc e o envia para um receptor SAP. Este Pack estende as opes de conectividade do adaptador IDoc do SAP a aplicativos externos no-SAP. Os sistemas SAP at o release Basis 4.6 (inclusive), no podem se comunicar usando mensagens XML e HTTP. Isso significa que usar o adaptador IDoc (ou o adaptador RFC) a nica maneira de conectar esses sistemas diretamente ao SAP Exchange Infrastructure. O processamento de IDocs uma alternativa para processar mensagens XML. Essa alternativa considerada para todos os aplicativos SAP e sistemas externos que j definiram IDocs.
39
Use o adaptador IDoc para integrar sistemas de negcios ao Servidor de Integrao apenas quando houver um benefcio real para o cenrio, isto , para conectar sistemas ou processos de negcios no integrados anteriormente. Interrompa os cenrios de comunicao existente e funcional do IDoc (cenrios ALE, por exemplo) e roteie novamente o trfego de IDoc correspondente usando o Servidor de Integrao apenas quando houver benefcio adicional (para disponibilizar os dados IDoc enviados para receptores adicionais na forma de mensagens XML ou quando for necessrio mapeamento adicional, por exemplo). Use o IBM WebSphere Transformation Extender Pack para SAP R/3 quando for necessrio que os adaptadores do Transformation Extender estejam conectados diretamente aos sistemas aplicativos do SAP pela tecnologia ALE ou RFC do SAP.
Modelo de Comunicao
O modelo de comunicao IDoc fornece um exemplo de integrao de ponta a ponta usando o adaptador ALE do Transformation Extender de um lado e o adaptador IDoc do SAP PI do outro. H dois cenrios: v No cenrio de entrada, o mapa do Transformation Extender transforma dados no-SAP no tipo IDoc DEBMAS e posta dados do IDoc para um sistema SAP R/3 Enterprise como um sistema de negcio de recebimento. v No cenrio de sada, o mapa do Transformation Extender recebe dados do tipo de mensagem IDoc DEBMAS03 de um sistema SAP R/3 Enterprise (sistema de negcio emissor) e transforma o IDoc em dados de sistema no-SAP. Em cada cenrio, uma seo com o ttulo Monitorando a Comunicao includa para ajud-lo a verificar as atividades de comunicao entre o SAP e o Transformation Extender.
Pr-requisitos
Antes de executar os cenrios: v Configure o sistema SAP R/3 v Configure o sistema SAP PI v Configure o sistema IBM WebSphere Transformation Extender (Captulo 2)
Configurar o Sistema SAP R/3 para a Comunicao ALE

1. Mantenha um destino RFC (transao SM59) para o Servidor de Integrao com o usurio definido como XIAPPLUSER. Para obter detalhes, consulte o Captulo 3, Definir um Destino RFC no SAP R/3 para o SAP PI (SM59). 2. Crie um Modelo de Destino (transao BD64). Para obter detalhes, consulte o Captulo 3, Criar um Modelo de Distribuio (BD64) 3. Mantenha o Perfil do Parceiro (transao WE20) e o nmero do parceiro do tipo de sistema lgico: XI3CLNT800/LS. Mantenha o tipo de mensagem DEBMAS para ser enviado como parmetro de sada e registre a porta como receptora. Para obter detalhes, consulte o Captulo 3, Gerar Perfis do Parceiro (WE20).
40
Configurando o Sistema SAP PI

1. Configure o destino RFC (Conexo do tipo TCP/IP) para o sistema receptor externo e o destino RFC (Conexo R/3) para o sistema SAP R/3. Consulte o Captulo 3, Definir um Destino RFC no SAP PI para o SAP R/3 (SM59) Importante: Defina o destino RFC como Unicode. 2. Com a transao IDX1, designe portas no adaptador IDoc para o Transformation Extender e para os sistemas SAP R/3. Consulte o Captulo 3, Criar uma Porta no Adaptador IDoc (IDX1) 3. Com a transao IDX2, carregue metadados para o tipo IDoc DEBMAS06 a partir da porta SAP47U e para o tipo IDoc DEBMAS03 a partir da porta SAPC46. Consulte o Captulo 3, Criar os Metadados para o IDoc (IDX2) 4. Defina os sistemas de negcios emissor e receptor no Diretrio System Landscape (U47 e C46). Para executar o adaptador IDoc, tanto o emissor quanto o receptor devem ser sistemas SAP com interfaces IDoc. O adaptador ALE R/3 do Transformation Extender imita um sistema R/3. Para obter detalhes, consulte o Captulo 3, Criar um Sistema Tcnico e um Sistema de Negcio para o SAP R/3. 5. Defina o cenrio de negcios com o adaptador IDoc do SAP PI como um ponto de extremidade. Para obter detalhes, consulte o Captulo 3, Definir um Sistema Tcnico para o Transformation Extender. Ao carregar metadados de um sistema emissor ou receptor, verifique se todos os tipos de IDoc e/ou segmentos de IDoc necessrios foram liberados (isso pode ser verificado com a transao WE30 no sistema correspondente). Verifique se a funo do Mecanismo de Integrao est configurada como Servidor de Integrao (transao SXMB_ADM) como parte dos dados de configurao globais. Essa configurao assegura que os IDocs recebidos sejam redirecionados para o processamento do adaptador IDoc em vez da manipulao normal de ALE.
Resultados
O adaptador IDoc do SAP PI possibilita a troca de mensagens IDoc com aplicativos SAP conectados atravs do protocolo RFC. No Servidor de Integrao, os IDocs podem ser transferidos como IDocs nativos. Nota: Apenas a carga til de uma mensagem recebida avaliada. Apenas interfaces IDoc assncronas. A comunicao baseada em IDoc usando o Servidor de Integrao funciona da seguinte forma: v O registro de controle do IDoc contm os nmeros dos parceiros emissor e receptor, que especificam o sistema emissor lgico e o Servidor de Integrao como receptor. v O roteamento lgico chamado para determinar o sistema receptor real. v O IDoc final (depois do Servidor de Integrao) contm o SAP PI como um sistema emissor lgico e o SAP R/3 como um sistema receptor. As informaes do sistema receptor vm do roteamento lgico.
Configurando o Adaptador JALE do Transformation Extender

Alm dos recursos presentes no adaptador ALE nativo, o adaptador JALE inclui suporte a dados do conjunto de caracteres Unicode para entrada e sada do SAP R/3 quando instalado com o IBM WebSphere Transformation Extender.
41
So necessrios arquivos do SAP JCo 2.1.6 para uso com adaptadores JALE. Esses arquivos esto disponveis no SAP Service Marketplace. v No Windows, use sapjco.jar e sapjcorfc.dll v No HP-UX, use sapjco.jar e libsapjcorfc.sl v Nas outras plataformas UNIX, use sapjco.jar e libsapjcorfc.so Copie as bibliotecas necessrias para o PATH: v Se voc estiver instalando o Pack no Windows, copie a biblioteca para qualquer diretrio em PATH. v Se estiver instalando o Pack no UNIX, envie a biblioteca por FTP para qualquer diretrio especificado pela varivel de ambiente LD_LIBRARY_PATH (Sun Solaris), LIB_PATH (AIX) ou SHLIB_PATH (HP-UX). Alm disso, a biblioteca SAP RFC librfc32.dll deve ser instalada no diretrio do sistema Windows.
Cenrio 1: Entrada (Enviando um IDoc para o Sistema SAP R/3)

No cenrio de entrada, o mapa do Transformation Extender converte dados legados em um tipo de IDoc DEBMAS03 e envia o IDoc usando o adaptador ALE do Transformation Extender para o adaptador IDoc de entrada do SAP PI. O adaptador IDoc de entrada do SAP PI transforma a mensagem do formato IDoc para o formato XML do IDoc, l o cabealho de controle do IDoc e recupera as informaes do sistema de negcio emissor e receptor para roteamento. Antes que a mensagem saia do Servidor de Integrao, o sistema chama o adaptador IDoc de sada. O adaptador IDoc de sada a transfere do formato XML para IDoc e a envia para o sistema SAP R/3 Enterprise.
Enviando um IDoc para o Sistema SAP R/3

Para enviar um IDoc para o sistema SAP R/3, siga as etapas abaixo. 1. Abra o mapa xi_inbound_debmas.mms no Map Designer. O arquivo est localizado na pasta: install dir\examples\packs\sap_xi\3.0\IDoc\inbound\ mms. Este mapa usado para postar dados de entrada no SAP Exchange Infrastructure. Os dados so mapeados de um carto de entrada que l dados legados do cliente. 2. Altere os parmetros do Registro de Controle para que suportem o cenrio de negcios projetado para esta transao: SNDPOR, SNDPRT, SNDPRN, PCVPOR, RCVPRN, PCVPRN. 3. Altere os parmetros -C, -U, -P, -S e -H no carto de sada dos comandos do adaptador especficos de sua instalao do SAP. Clique com o boto direito do mouse no cabealho e selecione Editar para abrir o carto de sada. Parmetro Descrio Nmero do Cliente (-C) Especifique o nmero do cliente no sistema R/3 ao qual se conectar usando o comando do adaptador de Nmero do Cliente (-C). Esse
42
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 R/3 sempre que voc efetua login no sistema R/3. -C clnt_num ID do Usurio (-U) Especifique o nome de usurio do R/3 para efetuar login no sistema R/3 usando o comando do adaptador de ID do usurio (-U). Esse comando do adaptador necessrio para a conexo do sistema R/3 ao chamar um BAPI e para os destinos 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 Senha (-P) Especifique a senha designada ao nome de usurio para autorizao do sistema R/3 usando o comando do adaptador de Senha (-P). Esse comando do adaptador necessrio para a conexo SAP de origens BAPI e todos os destinos. -P pwd|@full_path ID do Sistema (-S) Especifique o nmero do sistema R/3 ao qual se conectar usando o comando do adaptador de 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 ID do Host (-H) Especifique o nome do host ou a cadeia de rota do SAP do servidor R/3 ao qual se conectar usando o comando do adaptador de ID do Host (-H). Esse comando do adaptador pode ser necessrio para a conexo. Use o parmetro SAPLogon ou SAPGUI. -H host_name Para obter informaes adicionais, consulte o Resource Adapter Reference Guide. 4. Construa e execute o mapa legacytoinboundxi.mmc.
Resultados
Esse mapa envia um IDoc do carto de sada do mapa para o adaptador IDoc de entrada do SAP. O Servidor de Integrao transporta o IDoc para o adaptador IDoc de sada. O adaptador de sada envia, ento, o IDoc para o sistema SAP R/3 Enterprise. Isso conclui o cenrio de entrada.
Para monitorar a comunicao no cenrio de entrada: 1. Verifique o log de execuo do mapa. O diretrio do mapa est localizado na pasta install_ dir\examples\packs\sap_xi\3.0\idocconnector\ inbound\mms.
43
2. Verifique o arquivo de rastreio do adaptador JALE R/3 (arquivo *.mtr) do Transformation Extender no diretrio do mapa. O arquivo de rastreio um arquivo de texto que registra o progresso durante a execuo de um mapa. O arquivo de rastreio um auxlio de depurao que deve ser usado para diagnosticar dados invlidos ou definies de tipo incorreto. 3. Verifique o log de auditoria do adaptador ALE R/3 (*.log) do Transformation Extender no diretrio do mapa. 4. Monitore a mensagem no SAP PI usando a transao SXMB_MONI. 5. Como resultado, verifique a entrega do IDoc usando a transao WE02 no sistema SAP R/3 Enterprise.
Cenrio 2: Sada (Enviando um IDoc a partir do SAP R/3 Enterprise)

No cenrio de sada, um sistema SAP R/3 Enterprise envia um IDoc do tipo DEBMAS05 para o adaptador IDoc de entrada no Servidor de Integrao. O IDoc convertido em uma mensagem XML e processado pelo SAP Exchange Infrastructure. No lado de sada do SAP Exchange Infrastructure, o adaptador IDoc de sada transforma a mensagem XML de volta em um IDoc do tipo DEBMAS03 e o envia para o destino RFC do sistema Transformation Extender no qual o adaptador JALE do Transformation Extender aguarda processamento adicional do IDoc pelo mapa.
Enviando um IDoc a partir do SAP R/3 Enterprise

Para enviar um IDoc a partir do SAP R/3 Enterprise: 1. Abra o mapa xi_outbound_debmas.mms no Map Designer. Esse mapa recupera dados do SAP PI e o mapeia para um arquivo legado. Ele usa o mtodo de registro para a comunicao ALE. Essa mapa serve como origem para o sistema idocconnector.msd. 2. Altere os parmetros -A, -G e -X no carto de entrada dos comandos do adaptador ALE especficos de sua configurao do Destino RFC. Parmetro Descrio ID do Programa (-A) Use o comando do adaptador de ID do Programa (-A) para especificar o ID do programa a ser usado para ativao do RFC ao usar o mtodo de Registro. O ID do programa um identificador exclusivo usado pelo Gateway do SAP 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 de Programa do Registro definido em SM59. O R/3 usa esse identificador para distinguir vrios programas registrados no mesmo Gateway do SAP. Por exemplo, os IDs de programa xyz.CREMAS e xyz.MATMAS poderiam ambos ser registrados no mesmo Gateway do SAP (-G 186.114.3.126) e nmero do gateway (-X 3300). -A pgm_id Nmero do Cliente (-C) Use o comando do adaptador de Cadeia de Conexo (-CONNECT) para especificar a cadeia de conexo de host Oracle. Esse comando pode ser usado para uma origem ou um destino, ou em uma funo DBLOOKUP, DBQUERY, GET ou PUT. Se uma cadeia de conexo de
44
host SQL*Net for especificada, a conexo ser estabelecida por meio de SQL*Net. Se nada for especificado, uma conexo direta ser estabelecida com o banco de dados identificado pela configurao do ambiente ORACLE_SID. -CONNECT connect_string 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. O tipo IDoc Debmas no Unicode. A rvore de comandos converte o fluxo de dados unicode em no-Unicode, portanto, a validao dos dados no falharia. -enc ch_set_command Host Gateway (-G) Especifique o nome do host ou a cadeia de rota do SAP do host gateway usando o comando do adaptador de Host Gateway (-G). Quando o arquivo Saprfc.ini no est sendo usado, esse comando do adaptador necessrio para fins de conexo de todas as origens ALE (sada de R/3). -G gtwy_name ID do Host (-H) Especifique o nome do host ou a cadeia de rota do SAP do servidor R/3 ao qual se conectar usando o comando do adaptador de ID do Host (-H). Esse comando do adaptador pode ser necessrio para a conexo. Use o parmetro SAPLogon ou SAPGUI. -H host_name Senha (-P) Especifique a senha designada ao nome de usurio para autorizao do sistema R/3 usando o comando do adaptador de Senha (-P). Esse comando do adaptador necessrio para a conexo SAP de origens BAPI e todos os destinos. -P pwd|@full_path ID do Sistema (-S) Especifique o nmero do sistema R/3 ao qual se conectar usando o comando do adaptador de 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 ID do Usurio (-U) Comando do adaptador de ID (-U). Esse comando do adaptador necessrio para a conexo do sistema R/3 ao chamar um BAPI e para os destinos 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
45
-U usr_id|@full_path 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 de 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 Consulte Adaptador de Recursos no Centro de Informaes para obter mais detalhes. 3. Construa o mapa xioutboundtolegacy.mmc. 4. Abra o arquivo idocconnector.msd no Integration Flow Designer. O arquivo de definio do sistema est localizado na pasta: install_dir\examples\ packs\sap_xi\3.0\idocconnector\outbound\mms. O arquivo de definio do sistema idocconnector.msd foi projetado para processar o IDoc de sada. O adaptador ALE R/3 atende IDocs recebidos no gateway. O mapa recebe os IDocs ALE de sada do SAP PI usando o adaptador ALE do Transformation Extender, converte o IDoc em um arquivo legado e o armazena no sistema de arquivos. Consulte a documentao do Transformation Extender Pack para SAP R/3 para obter informaes sobre como criar um mapa para transformar dados de origem do SAP R/3 no sistema externo de destino. 5. Selecione Sistema Construir Mapas para construir os mapas. 6. Selecione Sistema Analisar para analisar o arquivo de definio do sistema idocconnector.msd. Depois que os mapas tiverem sido construdos com xito e o arquivo de definio do sistema tiver sido analisado com xito, o arquivo .msl pode ser gerado. 7. Selecione Sistema Gerar para gerar o arquivo xioutbound.msl. Nota: Um arquivo de definio do sistema (.msd) no ser executado no Launcher. O Launcher s pode reconhecer arquivos .msl, que so arquivos .msd que foram gerados em um formato de arquivo especificamente para o Launcher. Quando o Launcher executado, ele gerencia a execuo do arquivo .msl no diretrio de implementao. 8. Salve o arquivo xioutbound.msl no diretrio install_dir\systems. 9. Dependendo da configurao do Destino RFC, inicie uma instalao do gateway. 10. Configure o Launcher. 11. Inicie o Launcher como um servio. Para iniciar o Launcher (Windows): a. No desktop, clique com o boto direito do mouse em Meu Computador e selecione Gerenciar. b. Na janela Gerenciamento do Computador, expanda a lista Servios e Aplicativos e selecione Servios. c. Clique com o boto direito do mouse em Launcher e selecione Iniciar. Para iniciar o Launcher (UNIX): No diretrio de instalao, digite: . setup e, em seguida, digite: eventserver.sh -start
46
12. Inicie o Console de Gerenciamento. No menu Iniciar, selecione Programas IBM WebSphere Transformation Extender ->Console de Gerenciamento.
Para monitorar a comunicao no cenrio de entrada: 1. Depois de trabalhar no exemplo, verifique a entrega do IDoc para o gateway do sistema SAP R/3 Enterprise usando a transao WE02. 2. Monitore a mensagem no SAP PI usando a transao SXMB_MONI. 3. Verifique o log de auditoria de execuo do mapa, o log do adaptador IDoc e os arquivos de rastreio do adaptador no diretrio do mapa. Verifique o log do adaptador ALE R/3 (*.log) do Transformation Extender no diretrio do mapa. 4. Monitore os mapas que esto sendo executados por meio do Console de Gerenciamento do Launcher. 5. Como resultado, verifique a presena do arquivo AleOutbound.TXT na pasta: install_ dir\examples\packs\sap_xi\3.0\idocconnector\ outbound\mms.
47
48
Captulo 6. Recursos do SAP

O material publicado do SAP relacionado configurao de IDoc, ALE e BAPI pode ser localizado no CD SAP Interface Advisor, na Documentao On-line do SAP e no Implementation Guide for R/3 Customizing on-line (IMG, use a transao SPRO e selecione Enterprise IMG). Consulte o SAP ALE Implementation Guide para obter informaes detalhadas sobre as etapas necessrias para configurar o R/3 para funcionalidade bsica, assim como informaes, como a manuteno de intervalos de nmeros, configurao de cdigos ISO, configurao de cdigos globais da empresa, ativao de ponteiros de mudana e tudo que possa ser necessrio para implementao. Assistncia e informaes adicionais esto disponveis nestes vrios recursos: v Administrador do Basis v Consultor SAP Platinum v OSS Notes v Laboratrios SAP: http://www.saplabs.com v v v v v Tecnologias SAP: http://www.SAPpro.com Grupo de Usurios do SAP da Amrica: http://www.asug.com Perguntas mais Frequentes do SAP: http://www.sapfaq.com Solues SAP e-Business: http://www.sap-ag.de MySAP.com: http://www.sap.com
v O SAP mantm vrios servidores de listas; por exemplo, EDI, BAPI, BW. Para obter informaes sobre os servidores de listas e as assinaturas disponveis, entre em contato com o SAP. v Existem agora vrios manuais SAP, BAPI e ALE teis disponveis.
49
50
Avisos
Estas informaes foram desenvolvidas para produtos e servios oferecidos nos Estados Unidos. possvel que a IBM no oferea 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 desta publicao no lhe garante direito algum 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 licena relacionados a informaes de DBCS (Conjunto de Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu pas ou envie pedidos de licena, 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 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 A ELAS NO SE LIMITANDO, 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, essa disposio pode no se aplicar ao Cliente. Essas informaes podem conter imprecises tcnicas ou erros tipogrficos. So feitas alteraes peridicas nas informaes aqui contidas; tais alteraes sero incorporadas em futuras edies desta publicao. 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 no-IBM so fornecidas apenas por convenincia e no representam de forma alguma um endosso a esses Web sites.
51
Os materiais contidos nesses 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 julgar apropriada sem incorrer em qualquer obrigao para com o Cliente. Licenciados deste programa que desejam obter informaes sobre este assunto com 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 apropriadas, incluindo em alguns casos, o pagamento de uma taxa. O programa licenciado descrito nesta publicao e todo o material licenciado disponvel so fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, do Contrato Internacional de Licena do Programa IBM ou de 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 iguais em sistemas geralmente disponveis. 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 de seu desempenho, compatibilidade nem qualquer outra reivindicao relacionada a produtos no-IBM. Dvidas sobre os recursos de produtos no-IBM devem ser encaminhadas 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 estes nomes so fictcios e qualquer semelhana com nomes e endereos utilizados por uma empresa real mera coincidncia. LICENA DE COPYRIGHT: Estas informaes contm programas de aplicativos de exemplo na linguagem fonte, ilustrando as tcnicas de programao em diversas plataformas operacionais. O Cliente pode copiar, modificar e distribuir estes programas de exemplo sem a
52
necessidade de pagar IBM, com objetivos de desenvolvimento, utilizao, marketing ou distribuio de programas aplicativos em conformidade com a interface de programao de aplicativo para a plataforma operacional para a qual os programas de exemplo so criados. Esses exemplos no foram testados completamente em todas as condies. Portanto, a IBM no pode garantir ou implicar a confiabilidade, manuteno ou funo destes 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 interface de programao destinam-se a facilitar a criao de software aplicativo utilizando este programa. As interfaces de programao de uso geral permitem que o cliente desenvolva o software aplicativo que obtm os servios das ferramentas deste programa. No entanto, estas informaes tambm podem conter informaes sobre diagnsticos, modificaes e ajustes. As informaes sobre diagnsticos, modificaes e ajustes so fornecidas para ajud-lo a depurar seu software aplicativo. Aviso: No utilize estas informaes sobre diagnsticos, modificaes e ajustes 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
Avisos
53
MVS 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 registradas 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 suas subsidirias nos Estados Unidos ou/e em outros pases. UNIX uma marca registrada do 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 PI, Verso 8.3
54
ndice Remissivo Caracteres Especiais

.log 10 .mmc 10 .mme 10 .mms 10 .msd 10 .msl 10 .mtr 10 .mtt 10 .tmp 10
L
Launcher 4 Administration 5 Como Funciona 4 Usando o Launcher 5 Launcher, Administration 5
M
Map Designer 9 mapa de transformao de XML em EDI mapa Payext2swiftmt202.mms 11 Modelo de Comunicao 27 IDoc 40 Modelos de Comunicao 2 Monitorando a Comunicao 43, 47 10
A
Adaptadores IDoc Apresentao 1 39
C
Categoria de Item NonDocData 8 Categoria Element 8 Categoria Prolog 8 Categoria Type 8 Categoria XMLS 7 Cdigo de transao, BD54 14 Cdigo de Transao, BD64 14 Cdigo de Transao, WE20 14 Comunicao Definindo a Comunicao entre o SAP R/3 e o SAP XI 13 Conexo do IDoc 39 Configurando o SAP 13 Configurar o SAP R/3 para se Comunicar com o SAP PI 13 Configurar o Sistema SAP PI 41 Configurar o sistema SAP R/3 40 Criar um Modelo de Distribuio 14 Criar um Sistema Lgico para o SAP XI 14
P
Perfis do Parceiro 14
R
Requisitos do Sistema e Instalao, Transformation Extender 3 Requisitos dos Negcios 1
S
Servidor RMI 11
T
Tipo de Mensagem XML do SAP 6 Transformation Extender 3 Transformation Extender Plug-in 25 Instalao 28 Modelo de Comunicao 27 Monitorando a Comunicao 36 Type Designer 6
D
Definies de WSDL 6 Definies de XSD 6 Definir um Destino RFC no SAP R/3 Destino RFC 14 14
E
Extenses do Nome do Arquivo 10
W
WebSphere Transformation Extender 25
G
Grupo Doc 9
I
Importador de Esquema XML 7
55
56
Impresso em Brazil

IBM WebSphere Transformation Extender Guia de Integração Do Pack para SAP PI

Hochgeladen von

Dokumentinformationen

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

IBM WebSphere Transformation Extender Guia de Integração Do Pack para SAP PI

Hochgeladen von

Copyright:

Verfügbare Formate

IBM WebSphere Transformation Extender

Guia de Integrao do Pack para SAP PI

Captulo 2. Entendendo o Transformation Extender . . . . . . . . . . . . . . . . . 3

Captulo 3. Configurando o SAP . . . . . . . . . . . . . . . . . . . . . . . . . 13

Captulo 4. Transformation Extender Plug-in

Captulo 5. Conexo do IDoc . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Captulo 6. Recursos do SAP . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP PI

Requisitos de seus Negcios

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP PI

Captulo 2. Entendendo o Transformation Extender

Requisitos do Sistema e Instalao

Como o Launcher Funciona

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP PI

Captulo 2. Entendendo o Transformation Extender

Entendendo o Tipo de Mensagem XML do SAP

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP PI

Como Criar uma rvore do Tipo Usando o Importador de Esquema XML

Entendendo a rvore do Tipo Gerada

Captulo 2. Entendendo o Transformation Extender

Categoria de Item NonDocData

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP PI

Captulo 2. Entendendo o Transformation Extender

Extenses do Nome do Arquivo

Entendendo o Mapa de Transformao de XML em EDI

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP PI

Entendendo o Mapa Payext2swiftmt202.mms

Primeiro Carto de Entrada

Segundo Carto de Entrada

Terceiro Carto de Entrada

Primeiro Carto de Sada

Segundo Carto de Sada

Iniciando e Parando o Servidor RMI

Para parar o Servidor RMI a qualquer momento, use a tecla Ctrl e C.

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP PI

Captulo 3. Configurando o SAP

Suporte para este Captulo

Definindo a Comunicao ALE entre o SAP R/3 e o SAP PI

Configurar o SAP R/3 para se Comunicar com o SAP PI

Copyright IBM Corp. 2006, 2009

Criar um Sistema Lgico para o SAP PI (BD54)

Definir um Destino RFC no SAP R/3 para o SAP PI (SM59)

Criar um Modelo de Distribuio (BD64)

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP PI

Gerar Perfis do Parceiro (WE20)

Configurar o SAP PI para se Comunicar com o SAP R/3

Criar um Sistema Lgico (BD54)

Definir um Destino RFC no SAP PI para o SAP R/3 (SM59)

Criando um Modelo de Distribuio

Gerar Perfis do Parceiro

Configurando a Estrutura do Adaptador IDoc do SAP PI

Criar uma Porta no Adaptador IDoc (IDX1)

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP PI

Criar os Metadados para o IDoc (IDX2)

Configurar a Integrao do SAP PI

Configurando o System Landscape

Incluir o Transformation Extender no Catlogo do Software

Definir um Sistema Tcnico para o WebSphere Transformation Extender

IBM WebSphere Transformation Extender: Guia de Integrao do Pack para SAP PI

Definir um Sistema de Negcio para o Transformation Extender

Criar um Sistema Tcnico e um Sistema de Negcio para o SAP R/3

SAP Integration Builder: Design

Importar Componentes de Software no-SAP e SAP