<Insert Picture Here>

Integration Broker: A Deep Dive

Seshagiri Veerapaneni
Integration Broker Software Developer - Oracle
 Program Agenda

• History <Insert Picture Here>

• Integration Broker Today

• Upgrade to 8.48 / 8.49
• Security
• Performance Tuning
• What's Next
• Other Resources
 <Insert Picture Here>

Integration Broker
Brief History
Integration Broker History
External Application Integrations

• 8.00 – Q4 1999 - Q1 2000

• Application Messaging
• Asynchronous (queued) messaging system
• Synchronous Integrations
• Component Interfaces (Business Components)
• Business Interlinks
• Web Libraries (iScripts)
• 8.12 – Q4 2000 - Q1 2001
• XML Schema Utility
• PSHttpEnable BI plug-in
• BIDocs class
• XML Links (Inbound BI)
 Integration Broker History

• Complete XML Based Integrations

• 8.40 – Q1 2002
• Integration Broker
• Synchronous Messages, Gateway Connectors, XSLT, etc.
• XMLDoc and SOAPDoc classes
• 8.42 – Q4 2002 - Q1 2003
• Publish EIPs (Enterprise Integration Points / ISRs)
• SOAPtoCI Web Library and Message
• WSDL support
• 8.46 - Web Services Foundation
• WS-I Compliance
• Schema Validation, Event Tester
• 8.47 - Interoperability with Fusion Middleware
• Integration with BPEL Process Manager
 Integration Broker History

• Service Oriented Architecture

• 8.48 - Web Services Optimization
• Web Services Standards adoption
• WS-I Compliance (WS-I Basic Profile 1.0 compliant )
• UDDI &WSIL
• WS-Security
• WS-Addressing
• JDeveloper XSLT Mapper
• Service Versioning, Workflow API using BPEL
 <Insert Picture Here>

Integration Broker
Today
 Integration Broker Today

• Service Oriented Architecture (SOA)

• A collection of services that communicate with each other
• Loosely coupled services, no dependencies
• Can be accessed without knowledge of their underlying
platform implementation
• Most common implementation is using Web Services
Standards

WSDL Loosely
Application SOAP
Coupled

Functional Self
XML Ubiquitous
Building described
Messaging Transport
Block Interface
 Integration Broker Today

• Web Service Platform

Discovery Mechanisms UDDI Registry of Endpoints

WSDL Endpoint descriptions

Descriptive Languages
XSD Portal type system

SOAP Framing, protocol binding

Wire Protocols
XML + Namespaces Serialized Messages
 Integration Broker Today

• PeopleTools Objects deployed as Web Services

PeopleTools
Services

Service Operations Application

Classes
Handlers
WSDLs

Component
Routings
Interfaces
Queues
DMS Scripts
Messages
Application
Schemas
Engine Programs
Integration Broker Today– Service Designer
 Integration Broker Today

• Services
• New in 8.48
• Used to logically group a set of service operations
• Typically represents a business entity
• Exposes a WSDL

Services
Services

Service Operations
Handlers

WSDLs
Routings

Queues

Messages
Schemas
 Integration Broker Today

• Service Component
 Integration Broker Today

• Service Operation
• New in 8.48
• Correspond to operations performed on business
objects
• Reference structures and processing definitions
• Can be
• Secured by permission lists
• Versioned Services
• When message structure is changed Service
Service Operations
Operations

• Add Logical Transform Programs to/from Handlers

WSDLs
Default Version to activate Routings

Queues
• Created using Introspection
Messages
• Setup for Schema Validation Schemas
 Integration Broker Today

• Service Operation Component

 Integration Broker Today
• Service Operation Component (cont.)
 Integration Broker Today

• Messages
• Define the shape/structure
• Provide schema for runtime validation
• Types of Messages
• Rowset-based
• PeopleSoft to PeopleSoft with proprietary XML
• Legacy PSCAMA tags
• Nonrowset-based
Services
• Primary used for 3rd Party Integration Service Operations

• Message Containers and Parts Handlers

WSDLs
Routings
• New in 8.48
Queues
• Standard XML Messages
Messages
Schemas
 Integration Broker Today

• Message Builder Component

 Integration Broker Today

• Message Container
• New in 8.48
• A container message is made up of one or more message
parts.
• The resulting shape is always non rowset-based.
• The message parts are either all rowset-based or all
nonrowset-based.
• The container cannot be nested.
 Integration Broker Today

• Message Parts
• New in 8.48
• Define shape based on industry standard XML
• Used in building a container message
• Can be reused in multiple containers
• Use these to move away from PeopleSoft proprietary XML
• Still support Rowset-based message parts
• Easily accessed using Rowset class
• Schema is auto generated
• Support nonrowset-based messages
• Accessed using XMLDoc and SOAPDoc classes
 Integration Broker Today

• Service Operation Handlers

• New in 8.48

• Actual implementation (business logic) happens here

• Defines the Implementation IB Events via App Class

OnNotify / OnRoute / OnRequest / OnAckRecive / OnSend

Services
• Can be Implemented using Component Interface Service Operations
(CI) or DataMover Scripts (DMS) Handlers
Handlers

WSDLs
Routings

• Deprecated – Handlers created by upgrade pointing Queues

to Message PeopleCode. Messages

Schemas
 Integration Broker Today

• Service Operation Handlers

 Integration Broker Today

• Handler PeopleCode in Application Classes

• Implement PS_PT interface
i.e.
import PS_PT:Integration:INotificationHandler;
• Allows IB to identify this as a event handler and runtime can invoke
right method
• Message object is passed as a parameter
• Error Handling Methods
• Each PS_PT application class interface contains an OnError
method that you can use for custom error handling.
interface INotificationHandler
method OnNotify(&message As Message);
method OnError(&message As Message);
end-interface;
Integration Broker Today
 Integration Broker Today

• Read Exception Object from within Message Object

i.e.
&MSG.IBException.MessageNumber;
&MSG.IBException.MessageSetNumber;
&MSG.IBException.ToString();

• User Exception Handling for Sync Requests

• User Exception check box on Sync Outbound routing
• Evaluate Error Response and throw Exception or continue
Processing
 Integration Broker Today

• Nodes
• Represent each system involved in integration
• ANONYMOUS node represents ~ANY~ or unknown node
• Defines node specific connection binding parameters
• Defines security mechanisms to be used to communicate
• WS-Security / Password / Certificate / Non Repudiation /
External user-id password.
• Can Throttle the messages using IB Throttle Threshold
• New in 8.48
• PeopleTools delivers following predefined nodes
• ANONYMOUS / WSDL NODE / BPEL
• New in 8.48
 Integration Broker Today

• Node Definition
 Integration Broker Today

• Service Operation Routings

• New in 8.48
• Define integration between two nodes
• The External Alias is the actual name used to
identify the operation to be invoked
• Physical Transform's are defined here
• Can create routings using introspection
• Introspection link in Service Operation Services

Service Operations
component
Handlers

WSDLs
Routings
Routings
Queues

Messages
Schemas
 Integration Broker Today

• Service Operation Routings

 Integration Broker Today

• Routings Parameters
 Integration Broker Today

• Queues
• Renamed from Channels from prior releases

• For asynchronous Service Operations

• Control operations processing order

• Can be partitioned to improve throughput
Services
• Can be unordered to increase throughput
Service Operations
Handlers

WSDLs
• Key elements for performance and tuning Routings

Queues
Queues
Messages
Schemas
 Integration Broker Today

• Queue Definition
 <Insert Picture Here>

Integration Broker
Upgrade to 8.48/8.49
 Upgrade to 8.48/8.49

• Seamlessly migrate to the new model

• Upgrade – Object Conversion
Messages Services

Message Shape Service Operations

Message / Subscription Message

PeopleCode Handlers
Application Packages

Transactions Routings

Relationships Security

Nodes
Nodes

Channels Queues
 Upgrade to 8.48/8.49

• PTIBUPGRADE DMS parameters

• Default userid on node
• default service namespace for service
• default permission list service operation
• These need to be modifed later
• Upgrade Log Warnings
• Invalid pre 8.48 data
• Transactions referring to missing messages, transformation,
nodes, etc.
• Conflicting transactions
• Message having multiple transactions that can not be added into
same service
• Migrating event peoplecode to App Class
• Un-Compilable people code
• Deprecated Handlers which refer to the old PeopleCode
• Should be manually converted to application packages
 Upgrade to 8.48/8.49

• IB Audits
• IB Handlers with missing operations
• Routing referencing invalid service operation (etc..)
• Duplicate Routings
• ptibfixduplicates.dms
• IB Administration page
• PSTOKEN / user based authentication
• 8.48 to 8.48 systems requires users to be in both system
• Single Sign-On
• Forward Port
• PRE 8.48 application bundles
 <Insert Picture Here>

Integration Broker
Security
 Security

• Customers demand for higher security model

• PeopleTools needs to maintain backward
compatibility
• Result a rich security algorithm
 Security

• PSTOKEN based security

• Single Sign On
• Default User ID
• Role / Permission list based security
• Grant or deny access for Service Operations via Permission Lists
• PTIBUPGRADE.dms script sets Permission Lists during the
upgrade.
• Service Operation Routings
• “Any to Local” routings
• For Web service
• Use “User password require” to be more secure
• Do not use Any to Local for Peoplesoft to Peoplesot integration
This may cause security issues.
 Security
• Authentication (Inbound) – PeopleSoft Node
 Security
• Authentication (Inbound) – External Node
 Security
• Authentication (Inbound) Web Service
 Security
• Authentication (Outbound) – PeopleSoft Node
 Security
• Authentication (Outbound) – External Node
 <Insert Picture Here>

Integration Broker
Performance Tuning
 Performance Tuning

ASync Outbound
 Performance Tuning

ASync Inbound
 Performance Tuning

Queue Partitioning
Performance Tuning

• Synchronous
 <Insert Picture Here>

Integration Broker
What's Next
 What’s Next

• WSDL and Schema Managed Objects

• Referenced/ Copy Based Message Parts
• Application Engine Handler
• Graphical Routings
• SAML
• Service Operation Tester
• Multi-Queue
• Transactional Local Sync
• Master/ Slave Enhancements
 <Insert Picture Here>

Other Resources
 Other Resources

• Instructor Lead Training

• PeopleTools 8.48 Integration Tools
• Demo Grounds
• Integration Technologies
• Additional Sessions
• (S291990) Building Web Services with PeopleTools
• (S291991) SOA Applications for PeopleSoft Enterprise
• (S291995) Implementing a Service Oriented Architecture with
PeopleTools
Meet the Experts
at the Applications and Industries lounges

PeopleSoft Meet the Experts

• Tuesday 11/13 from 10:00 am – 4:30 pm
• Moscone West – 2nd Floor Overlook #1
• Throughout the day development product experts will be available to
answer questions and discuss PeopleSoft applications