Process Integration

SAP NetWeaver

Treinamento

WorkShop SAP PI
Data: Fev/2011

Revises Autor Rogrio Marques Ribeiro Luis Naves Contato rogerio.ribeiro@firsteam.com.br luis.naves@firsteam.com.br Verso 1.0 1.1 Data dez/10 fev/11

Version 1.1

Pgina 2 de 62

WorkShop SAP PI
Data: Fev/2011

ndice
1. 2.

Pg.

Objetivo ................................................................................................................................ 6 Overview ............................................................................................................................... 6 2.1 2.2 2.3 2.4 2.5 2.6 2.7 Sap NetWeaver ..................................................................................................... 6 SAP NW Process Integration ................................................................................. 7 Arquitetura ............................................................................................................. 8 Benefcios ............................................................... Error! Bookmark not defined. Funcionalidades ...................................................... Error! Bookmark not defined. Aderncia a padres de Mercado ........................... Error! Bookmark not defined. Glossrio ................................................................ Error! Bookmark not defined.

3.

SAP PI Components ............................................................................................................ 8 3.1 3.2 3.3 3.4 3.5 3.6 3.7 SLD - System Landscape ...................................................................................... 8 Integration Builder .................................................................................................. 9 Integration Repository (IR) ................................................................................... 10 Integration Directory (ID) ...................................................................................... 10 Integration Server ................................................................................................ 11 Central Monitoring................................................................................................ 11 Adapter Engine .................................................................................................... 12

4.

SLD ..................................................................................................................................... 13 4.1 4.1.1 4.1.2 4.1.3 SLD Content Type ............................................................................................... 13 Software Catalog ................................................................................................. 13 Technical System (TS) ........................................................................................ 13 Business System (BS) ......................................................................................... 14

5.

Integration Repository .............................................................. Error! Bookmark not defined. 5.1 5.2 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.3 5.3.1 5.4 5.4.1 5.4.2 5.5 5.5.1 5.5.2 5.5.3 SWC e namespace .............................................................................................. 15 Interface Objects .................................................................................................. 15 Data Types .......................................................................................................... 15 Message Types ................................................................................................... 15 Message Interface ............................................................................................... 15 Data Type Enhancements ................................................................................... 16 Context Objects ...................................................... Error! Bookmark not defined. Mapping ............................................................................................................... 16 Interface Mapping ................................................................................................ 16 Business Process Objects ................................................................................... 16 Business Scenario ............................................................................................... 17 Business Process ................................................................................................ 17 Imported Objects.................................................................................................. 17 Imported Archives................................................................................................ 17 External Definition ............................................................................................... 17 RFC/IDOC ........................................................................................................... 17

6.

Integration Directory.......................................................................................................... 18 6.1 6.2 6.2.1 Integration Scenarios ........................................................................................... 18 Collaboration Profile............................................................................................. 18 Communication Channel ..................................................................................... 19
Pgina 3 de 62

Version 1.1

WorkShop SAP PI
Data: Fev/2011

6.3 6.4 7.

Logical Routing .................................................................................................... 19 Collaboration Agreement ..................................................................................... 20

Runtime .............................................................................................................................. 20 7.1 7.2 7.3 7.4 PI Pipeline............................................................................................................ 21 PI Message Format................................................. Error! Bookmark not defined. Message Handling ............................................................................................... 21 PI Runtime Cache ................................................................................................ 22

8.

Monitoring .......................................................................................................................... 22 8.1 8.1.1 8.1.2 8.1.3 8.2 8.3 Runtime Workbench (RWB) ................................................................................. 23 Component Monitoring ........................................................................................ 23 Message Monitoring ............................................................................................ 24 Performance Analysis ............................................. Error! Bookmark not defined. Alert Monitoring ....................................................... Error! Bookmark not defined. Integration Engine Monitoring .............................................................................. 24

9.

Proxies....................................................................................... Error! Bookmark not defined. 9.1 9.2 ABAP Proxy ............................................................ Error! Bookmark not defined. Java Proxy .............................................................. Error! Bookmark not defined.

10.

BPM Business Process Management............................................................................ 24 10.1 10.1.1 10.1.2 10.2 10.3 Business Process Editor ...................................................................................... 24 BPM: Desing Time ............................................................................................... 25 Process Step Types ............................................................................................. 26 BPM: Config Time ................................................... Error! Bookmark not defined. Business Process Engine Monitoring ................................................................... 27

11.

Adapter Framework .................................................................. Error! Bookmark not defined. 11.1 11.2 11.3 Adapter Engine ....................................................... Error! Bookmark not defined. PCK (SAP Partner Connectivity Kit) ........................ Error! Bookmark not defined. Technical Adapters Detail ....................................... Error! Bookmark not defined.

12.

Basic Administration ................................................................ Error! Bookmark not defined. 12.1 12.2 12.3 12.4 Integration Server ................................................... Error! Bookmark not defined. J2EE Engine ........................................................... Error! Bookmark not defined. Exchange Profile ..................................................... Error! Bookmark not defined. Lock Overview ........................................................ Error! Bookmark not defined.

13. 14.

Security ..................................................................................... Error! Bookmark not defined. Exerccio............................................................................................................................. 28 14.1 Descrio ............................................................................................................. 28

15.

Configuraes em SLD (System Landscape Directory) .................................................. 28 15.1 15.2 15.3 15.4 15.5 Acesso ao PI........................................................................................................ 28 System Landscape Directory ............................................................................... 29 System Landscape Directory - Define o Product .................................................. 30 System Landscape Directory - Define o Software ComponentError! Bookmark not defined. System Landscape Directory Define o Technical SystemError! Bookmark not defined.
Pgina 4 de 62

Version 1.1

WorkShop SAP PI
Data: Fev/2011

15.6 16.

System Landscape Directory Define o Business SystemError! Bookmark not defined.

Integration Repository ....................................................................................................... 31 16.1 16.2 16.3 16.4 16.5 Criao de Data Type ............................................. Error! Bookmark not defined. Criao do Message Type ...................................... Error! Bookmark not defined. Criao do Message Interface ................................ Error! Bookmark not defined. Criao do Message Mapping................................. Error! Bookmark not defined. Criao do Massage Interface ................................ Error! Bookmark not defined.

17.

Integration Configuration .................................................................................................. 56 17.1 17.2 17.3 17.4 17.5 17.6 17.7 Criao do Cenrio ................................................. Error! Bookmark not defined. Criao do Business System .................................. Error! Bookmark not defined. Criao do Communications Channel ..................... Error! Bookmark not defined. Criao do Receiver Determination ........................ Error! Bookmark not defined. Criao do Interface Determination ......................... Error! Bookmark not defined. Criao do Sender Agreement ................................ Error! Bookmark not defined. Criao do Receiver Agreement ............................. Error! Bookmark not defined.

18.

Testes Realizados ..................................................................... Error! Bookmark not defined. 18.1 18.2 Arquivo a ser manipulado ....................................... Error! Bookmark not defined. Monitoramento ........................................................ Error! Bookmark not defined.

Version 1.1

Pgina 5 de 62

WorkShop SAP PI
Data: Fev/2011

1.

Objetivo

Este material foi desenvolvido para inicializao e treinamento de profissionais na ferramenta SAP NetWeaver PI 7.0. Os requisitos so: Conhecimento de XML, XSD

Caso no possua os requisitos mnimos faa os seguites cursos online: http://www.w3schools.com/xml/default.asp http://www.w3schools.com/schema/default.asp

2.
2.1

Overview
Sap NetWeaver

A Plataforma SAP NetWeaver composta vrios componentes que suportam todos os nveis de integrao, seja de pessoas (People Integration), informaes (Information Integration), processos (Process Integration) ou aplicaes (Application Platform). Para cada nvel destas integraes a SAP fornece um ou mais produtos e todos eles compem a plataforma Netweaver.

Version 1.1

Pgina 6 de 62

WorkShop SAP PI
Data: Fev/2011

As ferramentas da plataforma SAP NetWeaver foram construdas em cima de servidores de aplicao WEB (WEB AS), existem dois tipos de WEB AS em SAP (Java e ABAP) e podem ser encontrados nas seguintes configuraes: ABAP Java ABAP + Java

* ABAP (Advanced Business Application Programming) uma linguagem de programao de alto nvel desenvolvida pela SAP. O ABAP tem uma sintaxe semelhante ao COBOL.

2.2

SAP NW Process Integration

O SAP PI um dos produtos fornecidos pela plataforma SAP Netweaver e representa dentro da plataforma o nvel de integrao de processos. Foi desenvolvido at a verso 7.0 na configurao ABAP + Java.

Version 1.1

Pgina 7 de 62

WorkShop SAP PI
Data: Fev/2011

2.3

Arquitetura

O SAP PI no uma ferramenta composta de vrios outros componentes, cada um com uma funcionalidade.

SLD: System Landscape Directory, criao de software component e Business System Integration Repository: Criao de objetos de integrao. Integration Directory: Criao de objetos de configurao. Central Monitoring: Monitor de mensagens e processos.

3.
3.1

SAP PI Components
SLD - System Landscape

O SLD repositrio central para informaes de softwares e sistemas (ambientes). uma aplicao servidora, que promove informaes para as aplicaes Netweaver, da qual o PI um cliente tcnico. O SLD usa o padro CIM (Common Information Model) para estruturar as informaes de todo o landscape do cliente / empresa / companhia. E a base para se construir os objetos no "repository" (IR) e configurar as "routing rules" no "directory" (ID).

Version 1.1

Pgina 8 de 62

WorkShop SAP PI
Data: Fev/2011

3.2

Integration Builder

um framework para acessar e editar as duas bases onde est compartilhado todo o conhecimento referente aos objetos de integrao (Shared Collaboration Knowledge). responsvel por armazenar e compartilhar toda a informao contida em uma interface e ou em um processo de negcio. uma aplicao Java composta por 2 (dois) repositrios de objetos o Integration Repository (desing, IR) e o Integration Directory (configuration, ID), para as atividades de desing e configuration, ambas so ferramentas grficas e so cacheadas localmente atravs do Java Web Start (JWS) no sendo necessria a instalao local das ferramentas*.
* necessria a instalao da verso 1.4.2_XX do Java Runtime Enviroment (JRE).

O lado cliente da ferramenta permite trabalhar com os objetos PI e o lado do servidor oferece os servios de autenticao, bloqueio de objetos, importao / exportao de objetos, versionamento, gesto de mudanas e internacionalizao; Estas ferramentas podem ser acessadas via SAP GUI atravs da transao SXMB_IFR ou diretamente via browser atravs da URL http://<hostname>:5<InstanceNumber>00/rep/.

Version 1.1

Pgina 9 de 62

WorkShop SAP PI
Data: Fev/2011

3.3

Integration Repository (IR)

Ferramenta onde se constri e desenvolve os objetos de integrao, dentre eles as interfaces, processos e objetos de mapeamento que so utilizados para implementar um cenrio de integrao. Para cada tipo de objeto existe um editor grfico especfico: Scenario Editor, Process Editor (BPEL), mapping Editor, Condition Editor e Data Type editor.

3.4

Integration Directory (ID)

Ferramenta onde feita a configurao dos cenrios de integrao para os objetos construdos no IR, representando o cenrio do cliente. composto pelo Configurator Wizards e Configuration Editors (Routing Rules receiver determination, interface determination, Collaboration Agreements receiver e sender agreement, Collaboration Profiles parties, services e channels).

Version 1.1

Pgina 10 de 62

WorkShop SAP PI
Data: Fev/2011

Uma vez que o contedo da integrao foi criado no IR o cenrio configurado no ID para os sistemas que vo se integrar e trocar mensagens.

3.5

Integration Server

ncleo central de processamento do SAP PI central processing engine, toda e qualquer mensagem trafegada passa por aqui. composto por engines, como o IE (Integration Engine) e o BPE (Business Process Engines), onde o IE responsvel por processar as mensagens e o BPE por processar o ccBPM.

3.6

Central Monitoring

Permite a monitorao de todos os componentes do SAP PI, processos e mensagens referentes a um cenrio de integrao. Disponibiliza uma viso completada de todo o contexto envolvendo o runtime do SAP PI.

Version 1.1

Pgina 11 de 62

WorkShop SAP PI
Data: Fev/2011

3.7

Adapter Engine

Suporta todos os conectores do SAP PI baseados na tecnologia JCA (Java Connector Architecture) para serem utilizados nas conexes entre o PI e os demais sistemas.

Version 1.1

Pgina 12 de 62

WorkShop SAP PI
Data: Fev/2011

4. 5.

Exemplo de Integrao SLD

Todo e qualquer desenvolvimento em SAP NW PI comea na SLD com a criao de um software component para a integrao.

O repositrio de informaes de software e sistemas pode ser acessado via o link System Landscape Directory disponvel na pgina inicial onde se encontram os demais links para as ferramentas Java ou diretamente atravs da URL http://<hostname>:5<InstanceID>00/sld.

5.1

SLD Content Type

O contedo de dados que o SLD abrange e administra so: o Software Catalog, qual descreve as solues e suas dependncias e descritas por Products e Software Components, e o System Catalog, qual descreve as informaes de onde os elementos do landscape esto instalados e so descritos pelos Technical Systems e Business Systems.

5.1.1

Software Catalog

O Software Catalog formado por Products e Software Components. Um Product uma coleo de Software Components e ambos possuem suas prprias verses, e o relacionamento entre um Product version e um Software Component version (SWCV) descrito pelo SLD pela associao chamada Software Feature. Para o treinamento dever ser criado um novo produto e software component Product: FIRSTEAM_TREINAMENTO_ALUNO Domnio: firsteam.com.br Verso: NW04s.1 Software Component:TREINAMENTO_ALUNO Verso 1.0

5.1.2

Technical System (TS)

Promove a viso tcnica (Technical View) de um ambiente dentro do landscape do cliente. Faz a correlao entre o Product e o host fsico onde o mesmo est instalado. a base para se definir os Business Systems. Os tipos possveis de Technical System so:
Version 1.1 Pgina 13 de 62

WorkShop SAP PI
Data: Fev/2011

- Web AS ABAP, para descrever sistemas ABAP; - Web AS Java, para descrever sistemas Java SAP; - Standalone Java, para descrever sistemas Java no SAP; - Third Party, para descrever sistemas de terceiros.

5.1.3

Business System (BS)

a representao lgica (Logival View) do Technical System. As aplicaes se comunicam com os BS quais promovem uma viso lgica de um ambiente em um particular dentro do cenrio de Integrao. A associao entre o TS e o BS dependente do tipo do TS, quais so: - WebAS ABAP, representa sistemas ABAP (por client/mandante); - WebAS Java, representa sistemas Java SAP; - Standalone Java, representa sistemas Java no SAP; - Third Party, representa sistemas de terceiros.

6.

Import de Software Component

V em Tools Import from SLD e importe seu software component criado na SLD

Version 1.1

Pgina 14 de 62

WorkShop SAP PI
Data: Fev/2011

6.1

Criao de Namespace

O namespece um local onde estaro todos os seus objetos do IR. Deve ser criado dentro do seu software component. utilizado para organizao ou at mesmo versionamento de aplicaes. At a verso 7.0 do PI utilizado o seguinte padro.

6.2
6.2.1

Interface Objects
Data Types

Define a estrutura dos elementos XML, equivalente ao XSD e aceita todos os tipos bsicos XSD e pode ser exportada em formato XSD. Uma estrutura Data Type pode ser reutilizada em outro DataType. Da mesma forma que parmetros de uma RFC so baseados em Data Types definidos no dicionrio de dados.
Nota: As Mesages Types do PI so definidas por um XSD Type.

6.2.2

Message Types

Corresponde ao root de uma mensagem XML. A Message Type faz ref erncia a um nico tipo de Data Type. A representao XSD est disponvel para exportao. Nota: descreve o payload message de uma interface PI.

6.2.3

Message Interface

o mais alto nvel da representao do XML metadata de uma mensagem XML. A sua direo pode ser definida como inbound ou outbound de acordo com a representatividade da aplicao, ou ainda, como abstrata para uso via ccBPM. Possui 2 importantes atributos, o mode sync ou async e a direction inbound ou outbound para interfaces usadas por ccBPM definido somente o mode abstract e a direo definida em tempo de desenvolvimento pelo BPM. Possui representao via WSDL (WebService Definition Language) qual pode ser exportada e a base para gerao de proxies Java e ABAP.

Version 1.1

Pgina 15 de 62

WorkShop SAP PI
Data: Fev/2011

Nota: A representao de uma Message Interface em WSDL segue o padro: Interface Objects Message Interface Message Type Data Type WSDL portType elements (port type operation Name) Message Elements Type Elements (input ou output messages)

6.2.4

Data Type Enhancements

So utilizados para adicionar atributos e elementos a uma estrutura dentro do SWCV. So similares a APPEND-Structures no dicionrio de dados ABAP quando utilizados por proxies ABAP.

6.3

Mapping

O mapping no PI utilizado para transformar uma estrutura em outra, o responsvel em fazer o De/Para entre duas estrutura. Estas transformaes so baseadas em regras definidas por programas de transformao, quais podem ser dos tipos: - Message mapping: graphical mapping editor, default do SAP PI; - XSLT: transformao utilizando linguagem XSLT; (No ser tratado neste curso) - Java: transformao atravs de classe Java; (No ser tratado neste curso) - ABAP: transformao atravs de classe ABAP; (No ser tratado neste curso) Para cada tipo de transformao deve-se existir uma ou mais estruturas source (origem) e uma target (destino), quais so definidas por um XSD ou um Message Type. Nota: Transformaes Java XSLT e ABAP devem ser utilizadas em casos especficos ou quando a transformao for complexa.

6.3.1

Interface Mapping

Toda transformao deve ser associada ao menos a uma Interface Mapping. na Interface Mapping onde se define quais so as Message Interfaces de origem e destino e qual ou quais programas de transformao e a sequncia que sero utilizados para se transformar uma mensagem A na mensagem B. Nota: Programas de mapeamento podem ser chamados em sequencia dentro de uma mesma Interface Mapping.

6.4

Business Process Objects

Version 1.1

Pgina 16 de 62

WorkShop SAP PI
Data: Fev/2011

6.4.1

Business Scenario

Descreve o processo de colaborao completo do ponto de vista do PI. Utilizado para modelar, planejar e documentar cenrios de integrao. Pode ser criado antes ou depois de o processo de desenvolvimento ser finalizado.

6.4.2

Business Process

Define o processo e como ele ser executado utilizado para a implementao de ccBPM. Possui editor grfico e suporta receive e send messages entre outros objetos.

6.5
6.5.1

Imported Objects
Imported Archives

Permite importar transformaes XSLT, Java mapping, Java extensions para XSLT mapping e classes Java para serem utilizadas como user defined function para um message mapping. Estes arquivos devem ser importados da mquina local sempre no formato .jar ou .zip.

6.5.2

External Definition

Definies do tipo WSDL, XSD, DTD e BPEL podem ser importadas como External Definition. E aps serem importados todos so convertidos no formato wsdl para que o IR possa suportlos. Esta funcionalidade muito utilizada para importar a definio (WSDL) de um WebService, em um cenrio de integrao, que em algum momento o SAP PI ter que executar.

6.5.3

RFC/IDOC

Version 1.1

Pgina 17 de 62

WorkShop SAP PI
Data: Fev/2011

possvel importar IDOCs e RFCs como uma Message Interface para um SWCV em particular, porm devem seguir os prrequisitos: A importao de interfaces SAP de um sistema SAP deve estar permitida no SWCV; Os parmetros de conexo para o sistema SAP devem estar especificados no SWVC; Deve-se utilizar para logar-se um usurio que tenha permisso para importar interfaces. Nota: Quando uma RFC ou um IDOC importado de um sistema SAP existente para um SWCV todos os seus metadados so importados conforme suas definies no dicionrio de dados.

7.

Integration Directory

Tem como objetivo configurar os relacionamentos entre os sender/receiver de uma mensagem para que todo o fluxo de processamento possa ser executado no runtime. Esta ferramenta nos permite configurar os cenrios de integrao criados no IR e nestes cenrios esto envolvidos: - Business Scenario: utilizado para agrupar configuraes de objetos; - Services Objects: (Collaboration Profile); - Business Service; - Business System; - Business Process. Os Services Objects so utilizados como Senders/Receivers de Messages Interfaces, agrupando as mensagens que sero trocadas e os canais de comunicao que sero criados para suportar estas trocas de mensagens.

7.1

Integration Scenarios

Os cenrios de integrao so desenvolvidos no IR, configurados no ID e executados no IS. Para cada cenrio deve-se criar um Business Scenario (Configuration Scenario) no ID.

7.2

Collaboration Profile

Define tecnicamente os envolvidos no cenrio de integrao e como ser feita a comunicao entre eles. Collaboration Profile: Party: parceiro lgico, opcional utilizado em cenrios B2B; Service: Business System: representao lgica de um sistema;

Version 1.1

Pgina 18 de 62

WorkShop SAP PI
Data: Fev/2011

Business Service: representao abstrata de um servio; Business Process: representao lgica de um processo, importado do ID e utilizado na implementao de ccBPM; Communication Channel: Sender: define o inbouding process, ou seja, a forma como uma mensagem chegar ao PI; Receiver: define o outbounding processing, ou seja, a forma como uma mensagem sair do PI;

7.2.1

Communication Channel

Todo Communication Channel (canal de comunicao) ser definido pelo tipo de Adapter utilizado por ele (Adapter Type). Desta forma possvel definer como as mensagens sero transportadas (Transport Mechanism) entre um sistema e outro, por exemplo, via RFC, IDOC, SOAP, FILE, HTTP, etc. Todo canal de comunicao receber ou enviar uma mensagem, de acordo com o processamento requisitado pela interface, desta forma necessrio escolher qual ser a direo do canal de comunicao, Sender ou Receiver: Canal
Sender Receiver

Direo
Adapter->IS IS->Adapter

Tipo Mensagem
message outbound message inbound

Processamento
inbounding processing outbounding processing

Os demais dados de um canal de comunicao so os dados especficos de acordo com os requisitados por seu tipo, onde podem ser informaes como: dados de path, URL, conexo, etc. Nota: A direo de um canal de comunicao define o seu comportamento, ou seja: se ele for um Sender, receber a mensagem do Sistema Origem e a enviar ao Integration Server (IS); se ele for um Receiver, receber a mensagem do Integration Server (IS) e a enviar ao Sistema Destino.

7.3

Logical Routing

Define tecnicamente as rotas das mensagens trocadas entre os envolvidos no cenrio de integrao. Logical Routing: Receiver Determination (routing rule): Determina um ou mais receivers para uma mensagem enviada (outbound interface) por um sender. Permite condies dinmicas de roteamento de acordo com o contedo da mensagem (dados do payload) ou via xPath / Context Objects.

Version 1.1

Pgina 19 de 62

WorkShop SAP PI
Data: Fev/2011

Interface Determination: define um ou mais inbound interfaces para uma mensagem. Define qual ser a mensagem de destino para uma mensagem de origem. Nota: Juntos o Receiver Determination e a Interface Determination, definem o fluxo de uma mensagem.

7.4

Collaboration Agreement

Define qual ir ser o canal de comunicao que ser utilizado para processar uma Mensage Interface. Collaboration Agreement: Sender Agreement: faz a ponte entre o canal de comunicao e a Message Interface utilizada no inbound processing; Receiver Agreement: faz a ponte entre o canal de comunicao e a Message Interface utilizada no outbound processing; Nota: Juntos o Sender Agreement e o Receiver Agreement definem os detalhes do processamento de uma mensagem.

8.

Runtime

O SAP PI abandona a integrao point-to-point, baseando-se em um modelo totalmente desacoplado via comunicao XML/SOAP/HTTP. Toda mensagem executada no Integration Server (IS) que inclui os mecanismos (engines) para executar, processar mensagens e conectar sistemas, ento podemos descrever o Runtime como local onde esto e so executados os engines do PI, Integration Engine (IE), Business Process Engine (BPE) e Adapter Engine (AE).

Cada um destes engines possui uma responsabilidade, o Integration Engine (IE) o responsvel por receber e processar todas as mensagens, o Business Process Engine (BPE) responsvel por executar os ccBPMs e o Adapter Engine responsvel hostear os canais de comunicao para conectar os sistemas envolvidos em um cenrio de integrao.

Version 1.1

Pgina 20 de 62

WorkShop SAP PI
Data: Fev/2011

8.1

PI Pipeline

O Pipeline do PI representa o fluxo da execuo de uma mensagem no IS, onde o mensagem recebida e examinada pelo runtime enviroment qual baseado na configurao para o tipo da mensagem e seu contedo faz o roteamento para o receiver (recebedor) aplicando o mapeamento requerido.

Nota: O PIPELINE ENTRY POINT acessado via HTTP, definida no servio ICF atravs da transao SICF. A URL para enviar uma mensagem ao pipeline definida pelo padro: http://<host>:<port>/sap/xi/engine?type=entry

8.2

Message Handling

Define o tipo do processamento da mensagem, como ela ser manipulada, de forma sncrona ou assncrona. Esta informao definida pelo QoS (Quality of Service) da mensagem: Synchronous Processing (QoS = BE, BestEffort): Neste caso o processamento de quem enviou a mensagem fica bloqueado at que se obtenha uma resposta. Equivalente ao sRfc. As mensagens sncronas no so logados no Integration Server, a no ser que seja necessrio. Asynchronous Processing (QoS = EO, Exactly Once ou EOIO, Exactly Once In Order): Neste caso as mensagens so enfileiradas para ser processadas pelo Integration Engine. As mensagens so persistidas no Integration Server e pode ser reenviado se existir algum problema com o envio inicial. Podem ser feitas rotinas de limpeza de DB para as mensagens assncronas atravs de Jobs de deleo, ou tambm em conjunto com Archiving. A diferena entre a EO e a EOIO que para a segunda o processamento direcionado em filas especficas. A EO equivalente ao tRfc e a EOIO ao qRfc. Nota: possvel monitorar as filas de processamento do SAP PI atravs da transao SMQR.

Version 1.1

Pgina 21 de 62

WorkShop SAP PI
Data: Fev/2011

8.3

PI Runtime Cache

Todas as configuraes so cacheadas no IS para melhorar a performance. Quando os objetos so ativados no ID eles so cacheados no IS, ou seja, o cache refresh automtico. Pela transao SXI_CACHE possvel visualizar os objetos: Tipos de Objetos cacheados: Parties, Services, Receiver Determination, Interface Determination, Sender / Receiver Agreement, Communication Channel, Mappings, SWC e Business Process. Adapter Engine Cache: Para visualizar o cahe do Adapter Engine utilize a opo: GOTO -> AE Cache IDOC Adapter Cache: Os metadados dos IDOCs entre as transformaes IDOC_XML->IDOC e vice versa so cacheados e podem ser vistas via a transao IDX2. Nota: Se uma mudana no ID no est replicada no runtime cache possvel fazer um cach refresh manual a partir do menu XI Runtime Cache, Delta ou Complete ou ainda fazer um refresh full via browser a partir da URL http://<hostname>:5<InstanceID>00/CPACache/refresh?mode=full. Deve se usar o usurio pidiruser para fazer o refresh

9.

Monitoring

O SAP PI fornece algumas ferramentas e opes de monitorao para mensagens, processos, componentes, performance e alertas. O componente que suporta todas essas funcionalidades o Central Monitoring.

Version 1.1

Pgina 22 de 62

WorkShop SAP PI
Data: Fev/2011

9.1

Runtime Workbench (RWB)

O ponto central de monitorao do SAP PI o XI Runtime Workbench (RWB). Esta ferramenta utilizada para monitorar o PI em todo seu contexto, baseada em uma interface Java qual amigvel ao usurio e com ela possvel monitorar: - PI componentes: (Component Monitoring); - Mensagens; Message Monitoring - Processos; - End-to-End Monitoring; - Performance Monitoring.

9.1.1

Component Monitoring

Disponibiliza o status de todos os componentes do PI. Permite monitorar os componentes ABAP e JAVA

Version 1.1

Pgina 23 de 62

WorkShop SAP PI
Data: Fev/2011

9.1.2

Message Monitoring

Utilizado para encontrar e diagnosticar erros com mensagens PI. Somente disponvel para mensagens assncronas ou se deve configurar para que o pipeline persista tambm mensagens sncronas.

9.2

Integration Engine Monitoring

A partir da transao SXMB_MONI possvel navegar para a SXI_MONITOR atravs da opo Monitor para mensagens processadas e tambm para outras opes pertinentes ao contexto do Integration Engine. Nota: possvel monitorar as mensagens persistidas no Integration Server (IS), porm as mensagens que no forem entregues e ou persistidas no IS no podero ser visualizadas.

10.

ccBPM Business Process Management

ccBPM, gerenciamento de processos de negcios, um conceito para modelar e automatizar processos de negcios. O SAP PI fornece o componente ccBPM (crosscomponent Business Process), dentro de seu ambiente, para suportar os conceitos requeridos pelo BPM, possibilitando assim a implementao de processos em uma nica e unificada interface. Algumas das principais caractersticas do ccBPM: - Dirige processos dentro ou atravs de diferentes aplicaes; - Desenha, automatiza, executa, monitora, analiza e optimiza processos. - Permite a uma empresa automatizar e gerenciar seus processos. - a tecnologia certa para integrar pessoas, aplicaes e recursos internos e externos. - Contm um editor grfico GRAPHICAL PROCESS EDITOR - Contm um BPE Business Process Engine prov a execuo do ccBPM - Faz parte do IR, ID e IS (Runtime) - Adere o padro BPEL4WS 1.1 - Integrado com a Monitorao do PI - Permite monitorao grfica O Integration Process (Business Process) executado pelo BPE no runtime. O sistema usa o workflow engine do SAPWebAS para a execuo, controle e monitorao dos processos. Nota: O Business Process ocorre/acontece em todos os nveis do Netweaver e em outras ferramentas SAP. Por esta razo existe uma confuso quando o termo Business Process usado. Para resolver esta questo o termo Integration Process usado para implementao do ccBPM no PI.

10.1

Business Process Editor

Version 1.1

Pgina 24 de 62

WorkShop SAP PI
Data: Fev/2011

O desenho do Integration Process (Business Process) feito no IR, atravs de seu editor grfico, onde possvel modelar o trabalho com processos e depois o mesmo deve ser importado e configurado no ID utilizando o assistente de importao. Algumas caractersticas do Business Process Editor: - Permite a construo utilizando editor grfico (Graphical Process Editor); - Utiliza padro BPEL; - Permite a importao / exportao da definio dos processos; - Utilizam interfaces abstratas, quais podem ser bi-direcional (inbound ou outbound) definidas em tempo de desenvolvimento. O Integration Process est localizado na rvore do Business Scenario, e um Integration Process sempre est linkado a um SWCV.

10.1.1

BPM: Desing Time

Quando abrimos ou iniciamos um Integration Process no editor, temos 6 diferente reas: Header Data, Editing Area, Process Overview, Property Area, Output Area e Object Area.

possvel ter trs vises do editor: - Graphical Definition

Version 1.1 Pgina 25 de 62

WorkShop SAP PI
Data: Fev/2011

- Correlation Editor - BPEL Display Tipos de steps que se pode fazer uso: - Receive - Send Messaging Relevant - Transformation - Receiver Determination - Container Operation (assign, append) - Control (deadlines, exceptions, allerts) - While loop - Fork (paralel) Process Flow Control Relevant - Block - Empty - Wait - Switch

10.1.2

Process Step Types

RECEIVE: Utilizado para receber uma mensagem, ao receber a mensagem os dados so transferidos ao processo. Pode-se utilizar o receive para comear um processo ou em algum outro step dentro do processo. SEND: Utilizado para enviar uma mensagem async, sync ou um acknowlegment. TRANSFORMATION: Utilizado para transformao de dados. RECEIVER DETERMINATION: Recupera a lista de receivers (recebedores) para o passo subseqente, ou seja, retorna a lista de receivers que esto configurados no ID do prximo Send Step. SWITCH: Utilizado para definir diferentes processamentos (condicional). O branch Otherwise (seno) criado automaticamente. A condio verificada em tempo de runtime e o primeiro branch que retornar true processado, se nenhum retornar true o processo continuado no branch otherwise CONTAINER OPERATION: Utilizado para atribuir algum valor para um elemento do container em tempo de execuo. CONTROL STEP: Pode ser utilizado para terminar o processo corrente, disparar uma exceo ou disparar um alerta para o SAP Alert Management. BLOCK: Define o contexto/escopo dos objetos que esto dentro dele. Utilizado para criar deadline ou exception handler ou para definir uma correlao local. FORK: Utilizado quando se quer continuar um processo em branches independentes um do outro, ou seja, execuo de dois passos em paralelo. WHILE LOOP: utilizado para se repetir uma execuo de passos dentro de um lao. O loop continuar at que a condio para seu fim (end condition) retorne true.
Version 1.1 Pgina 26 de 62

WorkShop SAP PI
Data: Fev/2011

WAIT: Utilizado para incorporar um delay (espera) no processo. Pode ser definido um tempo ou um perodo. Usualmente utilizado para definir quando o prximo passo no processo deve comear. EMPTY: um passo no definido e no tem influncia no processo. Utiliza-se o empty com os seguintes propsitos: Para um passo que no pode ser definido; um passo sem funo definida; CORRELATIONS: A correlao utilizada no caso de mensagens que devem possuir correlao uma com outra, geralmente utilizadas em dois passos assncronos onde mais de uma instncia do mesmo processo pode estar em memria e o retorno de uma mensagem deve ser feito para a instncia correta.

10.2

Business Process Engine Monitoring

Outra funcionalidade disponibilizada pelo BPE a monitorao de processos, e o ponto de entrada a transao SXMB_MONI_BPE, a partir dela possvel visualizar e monitorar os processos executados no SAP PI. A opo PROCESS SELECTION executa a transao SXWF_XI_SWI1, e atravs dela possvel selecionar o processo e ver seus detalhes. Nota: Tambm possvel navegar at o processo atravs da transao SXI_MONITOR.

10.3

Tipos de Canais de comunicao

Em linhas gerais, os canais se dividem em: - Sender: pegam a mensagem, convertem formato XML e escrevem ela no o payload do XISOAP message e a postam no pipeline do IS via HTTP; - Receiver: Recebem a mensagem no format XI-SOAP message do IS, extraem o XML payload, convertem no formato esperado no destino e escrevem ela no destino; Caractersticas dos principais adaptadores disponveis: RFC ADAPTER: RFC faz parte do Adapter Engine, suporta JRFC e tRFC (BE e EO). IDOC ADAPTER: Est hosteado no IS qual recebe o IDOC via tRFC pelo Inbound IDOC Adapter. O IDOC Adapter requer os metadados do IDOC para poder escrever sua representao XML, por isso necessrio confirgurar na IDX1 a porta para conexo e recebimento dos metadados entre o sistema SAP e o PI, na IDX2 possvel visualizar o cache dos metadados. FILE: Permite a troca de dados com o IS via File Interface ou FTP. Utiliza codepage UTF-8, suporta EO e EOIO.
Version 1.1 Pgina 27 de 62

WorkShop SAP PI
Data: Fev/2011

JDBC / JMS ADAPTER: Ambos os adaptadores requerem drivers do fornecedor. Estes que devem ser instalados conforme documentao. HTTP ADAPTER: Est hosteado no IS e usado por sistemas externos para se conectar ao Integration Engine usando HTTP. Estes sistemas so conectados usando o ICF (Internet Communication Framework) do SAP WebAS. Para este propsito o Integration Engine contm um servio HTTP disponibilizado pela SAP chamado: \sap\xi\adapter-plain. Para a comunicao inbound com o PI no requerido um canal de comunicao, j para o outbound requerido um canal de comunicao Receiver. Utiliza HTTP 1.0, no suporta retorno de fault messages e suporta QoS BE, EO e EOIO especificados na query string da URL. SOAP ADAPTER: Habilita a troca de mensagens SOAP entre um cliente remoto ou webservices e o Integration Server. Se for um canal Sender, preencher interface name e namespace e o modo de processamento BE, EO e EOIO. Se for um Receiver, preencher target URL, parmetros de converso para o HeaderSoap. Se o acesso for passar por Proxy Internet tambm informar dados de conexo do Proxy.

11.
11.1

Exerccio
Descrio

Suponha que voc queira transferir a partir de um servio consultar a lista de aeroportos de um pas. Voc dever fornecer um endereo IP para um servio e este lhe retornar a lista de aeroportos.temas.

12.
12.1

Configuraes em SLD (System Landscape Directory)

Acesso ao PI

Aps realizar o logon no PI, acesse a transao (SXMB_IFR):

Logo em seguida ser aberto url com o respectivo endereo para acesso ao PI:

Version 1.1

Pgina 28 de 62

WorkShop SAP PI
Data: Fev/2011

Clique na ferramenta do SLD

12.2

System Landscape Directory

Clicar no link descrito abaixo: Colocar o usurio e senha para acesso:

Isto ir abrir a primeira tela do SLD (System Landscape Directory). Aqui iremos definir o nosso Product, Software Component, Technical System and Business System.

Version 1.1

Pgina 29 de 62

WorkShop SAP PI
Data: Fev/2011

12.3

System Landscape Directory - Define o Product

O primeiro passo definir um produto. Para isso, click no link "Products" na parte de Software Catalog.

Agora click no boto (New Product Version):

Colocamos as seguintes entradas:

Logo aps defina o software component

Version 1.1

Pgina 30 de 62

WorkShop SAP PI
Data: Fev/2011

13.

Integration Repository

Clique no link (Integration Repository) para abri-lo, se voc estiver usando o PI pela primeira vez isso vai levar algum tempo de carregamento.

Ser mostrado o construtor

O primeiro passo importar o componente de software que voc criou na seo (System Landscape Directory)

Carregando a lista de Software Componentes:

Version 1.1

Pgina 31 de 62

WorkShop SAP PI
Data: Fev/2011

Seleo do Software Component do nosso exerccio:

Aps a importao ser exibido no construtor:

Version 1.1

Pgina 32 de 62

WorkShop SAP PI
Data: Fev/2011

Devemos criar um Namespace chamado: http://firsteam.com.br/xi/FIRSTEAM_TREINAMENTO_ALUNO * Obs: Esta no uma url para acesso, sendo apenas uma caracterizao do ns. D um clique duplo no seu software componente Coloque em modo de edio Adicione seu namespace e clique em salvar

13.1

Desenho do ccBPM

Crie um novo Integration Process com o nome IP_BuscaAeroporto clicando com o boto direito em Integration Process New

Version 1.1

Pgina 33 de 62

WorkShop SAP PI
Data: Fev/2011

Utilizando a barra de ferramentas da esquerda vamos desenhar o seguinte ccBPM:

Version 1.1

Pgina 34 de 62

WorkShop SAP PI
Data: Fev/2011

Passo 1 Crie um Receiver em modo Open S/A Bridge com as seguintes informaes.

Para criao da varivel de container ERPRequest, dever ser importada a RFC ZPI_AIRPORTINF_BY_IPMACHINE

Version 1.1

Pgina 35 de 62

WorkShop SAP PI
Data: Fev/2011

Depois devero ser criadas as Message Interface s abs_async_ZPI_AIRPORTINF_BY_IPMACHINE_Request e abs_sync_ZPI_AIRPORTINF_BY_IPMACHINE conforme figuras abaixo.

Version 1.1

Pgina 36 de 62

WorkShop SAP PI
Data: Fev/2011

Passo 2 Adicione um bloco em modo Default e depois insira 2 Exception Branches.

No Branch principal adicione um objeto transformation

Version 1.1

Pgina 37 de 62

WorkShop SAP PI
Data: Fev/2011

Importe o WSDL do Servio GetGeoIP que pode ser encontrado em

http://www.webservicex.net/geoipservice.asmx?WSDL

Crie a Message Interface abs_async_GetGeoIPSoapIn

Version 1.1

Pgina 38 de 62

WorkShop SAP PI
Data: Fev/2011

Crie a varivel de container GeoIPRequest do tipo abs_async_GetGeoIPSoapIn Crie um novo Message Mapping MM_ZPI_AIRPORTINF_BY_IPMACHINE_TO_GetGeoIPSoapIn

Crie um novo Inteface Mapping IM_ZPI_AIRPORTINF_BY_IPMACHINE_TO_GetGeoIPSoapIn

Version 1.1

Pgina 39 de 62

WorkShop SAP PI
Data: Fev/2011

Passo 3 Adicione um novo step do tipo Sender Sincrono com as seguintes configuraes

Crie uma Message Interface abs_sync_GetGeoIP

Version 1.1

Pgina 40 de 62

WorkShop SAP PI
Data: Fev/2011

Crie uma Message Interface inbound_sync_GetGeoIP

Crie uma Message Interface abs_async_GeGeoIPSoapOut

Version 1.1

Pgina 41 de 62

WorkShop SAP PI
Data: Fev/2011

Passo 4 Adicione um step transformation

Importe o WSDL de consulta de aeroportos que pode ser obtido no seguinte endereo http://www.webservicex.net/airport.asmx?WSDL Crie a interface abs_async_GetAirportInformationByCountrySoapIn

Version 1.1

Pgina 42 de 62

WorkShop SAP PI
Data: Fev/2011

Faa o mapeamento MM_GetGeoIPSoapOut_TO_GetAirportInformationByCountrySoapIn de acordo com a figura abaixo.

Crie o Interface Mapping IM_GetGeoIPSoapOut_TO_GetAirportInformationByCountrySoapIn

Version 1.1

Pgina 43 de 62

WorkShop SAP PI
Data: Fev/2011

Passo 5 Adicione um step sender do tipo sncrono conforme figura

Crie a Message Interface abs_sync_GetAirportInformationByCountry

Version 1.1

Pgina 44 de 62

WorkShop SAP PI
Data: Fev/2011

Crie a Message Interface inbound_sync_GetAirportInformationByCountry

Crie a Message Interface abs_async_GetAirportInformationByCountrySoapOut

Version 1.1

Pgina 45 de 62

WorkShop SAP PI
Data: Fev/2011

Passo 6 Adicione um step transformation

Crie o Message Mapping MM_GetAirportInformationByCountrySoapOut_TO_ZPI_AIRPORTINF_BY_IPMACHINE

Version 1.1

Pgina 46 de 62

WorkShop SAP PI
Data: Fev/2011

Crie o Interface Mapping IM_GetAirportInformationByCountrySoapOut_TO_ZPI_AIRPORTINF_BY_IPMACHINE

Version 1.1

Pgina 47 de 62

WorkShop SAP PI
Data: Fev/2011

Passo 7 Adicione um Step do tipo Send fechando a S/A Bridge aberta no inicio do ccBPM

Crie a Message Interface abs_async_ZPI_AIRPORTINF_BY_IPMACHINE_Response

Version 1.1

Pgina 48 de 62

WorkShop SAP PI
Data: Fev/2011

Passo 8 Adicione um step Transformation para gerar a mensagem de erro caso o primeiro Web Service esteja inacessvel.

Associe o erro ErroConsultaIP ao exception Branch

Version 1.1

Pgina 49 de 62

WorkShop SAP PI
Data: Fev/2011

Crie o mapeamento MM_ZPI_AIRPORTINF_BY_IPMACHINE_TO_ZPI_AIRPORTINF_BYIPMACHINE_Response para gerar a mensagem de erro.

Version 1.1

Pgina 50 de 62

WorkShop SAP PI
Data: Fev/2011

Crie o mapeamento IM_ZPI_AIRPORTINF_BY_IPMACHINE_TO_ZPI_AIRPORTINF_BYIPMACHINE_Response para gerar a mensagem de erro.

Passo 9 - Adicione um step Transformation para gerar a mensagem de erro caso o segundo Web Service esteja inacessvel.

Version 1.1

Pgina 51 de 62

WorkShop SAP PI
Data: Fev/2011

Associe o erro ErroConsultaAP ao exception Branch

Crie o mapeamento MM_ZPI_AIRPORTINF_BY_IPMACHINE_TO_ZPI_AIRPORTINF_BYIPMACHINE_Response2 para gerar a mensagem de erro.

Version 1.1

Pgina 52 de 62

WorkShop SAP PI
Data: Fev/2011

Crie o mapeamento IM_ZPI_AIRPORTINF_BY_IPMACHINE_TO_ZPI_AIRPORTINF_BYIPMACHINE_Response.

Version 1.1

Pgina 53 de 62

WorkShop SAP PI
Data: Fev/2011

Passo 10 Crie um novo Integration Scenario e adicione 3 colonas conforme figura, todas como template e a do meio como representao do Integration Process

Crie a action BuscaAeroporto

Version 1.1

Pgina 54 de 62

WorkShop SAP PI
Data: Fev/2011

Crie a Action ProcessaRequisicao

Crie a action RecebeRequisicao

Version 1.1

Pgina 55 de 62

WorkShop SAP PI
Data: Fev/2011

14.

Integration Directory

Crie um novo Business Service dentro de Party para receber os canais do WSX

Crie um canal SOAP para comunicao com o primeiro WS

Version 1.1

Pgina 56 de 62

WorkShop SAP PI
Data: Fev/2011

Crie um canal de comunicao para falar com o segundo Web Service

Crie um canal do tipo RFC para comunicao com o SAP ERP que far a requisicao

Version 1.1

Pgina 57 de 62

WorkShop SAP PI
Data: Fev/2011

Instancie o ccBPM IP_BuscaAeroporto dentro de service without party

Clique em importa Configuration Scenario from Integration Directory e escolha o cenrio desenvolvido no IR

Version 1.1

Pgina 58 de 62

WorkShop SAP PI
Data: Fev/2011

Clique em assign services e escolha quais os sistemas envolvidos SAP ERP

ccBPM

Version 1.1

Pgina 59 de 62

WorkShop SAP PI
Data: Fev/2011

WebServiceX

Version 1.1

Pgina 60 de 62

WorkShop SAP PI
Data: Fev/2011

Escolha os canais em Configure Connections

Version 1.1

Pgina 61 de 62

WorkShop SAP PI
Data: Fev/2011

Clique em Generate Objetcs e teste.

Version 1.1

Pgina 62 de 62