Contents
About this book
Audience
Typographic conventions
Related documents
New in this release
New in release 6.0
New in release 4.2.2
Introduction
Overview
Information needed to set up the hub
Overview of transports
Overview of document flow definitions
Overview of document processing
Configuring document processing components with handlers
Targets
Document Manager
Gateways
Overview of configuring the hub
Setting up the hub
Creating participants
Establishing document connections
Preparing to configure the hub
Creating a directory for a file-directory gateway
Configuring the FTP server for receiving documents
Configuring the required directory structure on the FTP server
How files sent over FTP are processed
Additional FTP server configuration
Security considerations for the FTPS server
Configuring the hub for the JMS transport protocol
Creating a directory for JMS
Modifying the default JMS configuration
Creating queues and the channel
Adding a Java
(TM)
run time to your environment
Defining the JMS configuration
Using FTP scripts for FTP Scripting targets and gateways
Using maps from the Data Interchange Services client
Starting the server and displaying the Community Console
Starting WebSphere MQ
Starting the WebSphere Partner Gateway components
Logging in to the Community Console
Configuring the Community Console
Specifying locale information and console branding
Branding the console
Changing the style sheet
Localizing the data on the console
Setting the password policy
Configuring permissions
How permissions are granted to users
Enabling or disabling permissions
Defining targets
Overview
Uploading user-defined handlers
Setting global transport values
Setting up an HTTP/S target
Target Details
Target Configuration
Handlers
Setting up an FTP target
Target Details
Target Configuration
Handlers
Setting up an SMTP target
Target Details
Target Configuration
Schedule
Setting up a JMS target
Target Details
Target Configuration
Handlers
Setting up a File-system target
Target Details
Target Configuration
Handlers
Setting up an FTP Scripting target
Creating the FTP script
FTP scripting commands
Target Details
Target Configuration
User-Defined Attributes
Schedule
Handlers
Setting up a target for a user-defined transport
Modifying configuration points
Preprocess
SyncCheck
Postprocess
Modifying the Configured List
Configuring fixed workflow steps and actions
Uploading handlers
Configuring fixed workflows
Inbound workflows
Outbound workflow
Configuring actions
Modifying a user-defined action
Creating actions
Configuring document flows
Overview
Step 1: Make sure the document flow definition is available
Step 2: Create interactions
Step 3: Create participant profiles, gateways, and B2B capabilities
Step 4: Activate connections
An example flow
Binary documents
EDI documents with Pass Through action
Creating document flow definitions
Creating interactions
RosettaNet documents
Overview
RNIF and PIP document flow packages
Creating document flow definitions
Configuring attribute values
Creating interactions
Web services
Identifying the participants for a Web service
Creating document flow definitions
Creating interactions
Restrictions and limitations of Web service support
cXML documents
Overview
Creating document flow definitions
Creating interactions
Custom XML documents
Overview
Creating a protocol definition format
Creating a document definition flow
Creating an XML format
Using validation maps
Adding validation maps
Associating maps with document flow definitions
Viewing documents
Configuring EDI document flows
Overview of EDI
The EDI interchange structure
Maps
Overview of XML and ROD documents
XML documents
ROD documents
Splitters and multiple documents
Overview of creating document flows and setting attributes
Step 1: Make sure the document flow definition is available
Step 2: Create interactions
Step 3: Create participant profiles, gateways, and B2B capabilities
Step 4: Activate connections
Overview of possible flows
EDI to EDI flow
EDI to XML or ROD flow
XML or ROD to EDI flow
Multiple XML or ROD documents to EDI interchange flow
XML to ROD or ROD to XML flow
XML to XML or ROD to ROD flow
How EDI interchanges are processed
How XML or ROD documents are processed
Setting up the EDI environment
Enveloper
Envelope profiles
Connection profiles
Control numbers
Control number initialization
Current control numbers
General steps for defining document exchanges
Importing maps
Setting up an EDI to EDI flow
Setting up an EDI to XML or ROD flow
Setting up an XML or ROD to EDI flow
Setting up multiple XML or ROD documents in one file to EDI flow
Setting up an XML to ROD or ROD to XML document flow
Setting up an XML to XML or ROD to ROD flow
Setting up acknowledgments
Adding an acknowledgment to the document flow
Viewing EDI interchanges and transactions
Creating the Community Manager profile and B2B capabilities
Creating the Community Manager profile
Setting up B2B capabilities
Creating gateways
Overview
Setting up global transport values
Configuring a forward proxy
Setting up an HTTP gateway
Gateway Details
Gateway Configuration
Setting up an HTTPS gateway
Gateway Details
Gateway Configuration
Setting up an FTP gateway
Gateway Details
Gateway Configuration
Setting up an SMTP gateway
Gateway Details
Gateway Configuration
Setting up a JMS gateway
Gateway Details
Gateway Configuration
Setting up a file-directory gateway
Gateway Details
Gateway Configuration
Setting up an FTPS gateway
Gateway Details
Gateway Configuration
Setting up an FTP Scripting gateway
Creating the FTP script
FTP script commands
FTP Scripting gateways
Gateway Details
Gateway Configuration
User-Defined Attributes
Schedule
Configuring handlers
Setting up a gateway for a user-defined transport
Specifying a default gateway
Creating participants and their B2B capabilities
Creating participant profiles
Setting up B2B capabilities
Managing connections
Overview
Activating participant connections
Specifying or changing attributes
Setting up security for inbound and outbound exchanges
Security terms and concepts
Security mechanisms and protocols used in WebSphere Partner Gateway
The iKeyman utility
Community Console
Key stores and trust stores
Certificate chains
Primary and secondary certificates
Changing the encryption strength
Creating and installing SSL certificates
SSL handshake
Inbound SSL certificates
Outbound SSL certificate
Adding a Certificate Revocation List (CRL)
Enabling access to CRL distribution points
Creating and installing signature certificates
Inbound signature certificate
Outbound signature certificate
Creating and installing encryption certificates
Inbound encryption certificate
Outbound encryption certificate
Configuring inbound SSL for the Console and Receiver
Certificate overview
Finishing the configuration
Enabling the use of APIs
Specifying the queues used for events
Specifying alertable events
Updating a user-defined transport
Appendix A. Basic examples
Basic Configuration - Exchanging passthrough EDI documents
Configuring the hub
Creating participants and participant connections
Basic configuration - Setting up security for inbound and outbound documents
Setting up SSL authentication for incoming documents
Setting up encryption
Setting up document signing
Extending the basic configuration
Creating an FTP target
Setting up the hub to receive binary files
Setting up the hub for custom XML documents
Appendix B. EDI examples
EDI to ROD example
De-enveloping and transforming an EDI interchange
Adding a TA1 to the exchange
Adding an FA map
EDI to XML example
Importing the transformation map
Verifying the transformation map and document flow definitions
Configuring the target
Creating the interactions
Creating the participants
Creating the gateways
Setting up B2B capabilities
Activating the connections
XML to EDI example
Importing the transformation map
Verifying the transformation map and document flow definitions
Configuring the target
Creating the interactions
Creating the participants
Creating the gateways
Setting up B2B capabilities
Creating the envelope profile
Creating the XML format
Activating the connections
Configuring attributes
ROD to EDI example
Importing the transformation map
Verifying the transformation map and document flow definitions
Configuring the target
Creating the interactions
Creating the participants
Creating the gateways
Setting up B2B capabilities
Creating the envelope profile
Activating the connections
Configuring attributes
Appendix C. Additional RosettaNet information
Deactivating PIPs
Providing failure notification
0A1 PIP
Updating contact information
Editing RosettaNet attribute values
Creating PIP document flow packages
Creating the XSD files
Creating the XML file
Creating the package
About validation
Cardinality
Format
Enumeration
PIP document flow package contents
0A1 Notification of Failure V1.0
0A1 Notification of Failure V02.00
2A1 Distribute New Product Information
2A12 Distribute Product Master
3A1 Request Quote
3A2 Request Price and Availability
3A4 Request Purchase Order V02.00
3A4 Request Purchase Order V02.02
3A5 Query Order Status
3A6 Distribute Order Status
3A7 Notify of Purchase Order Update
3A8 Request Purchase Order Change V01.02
3A8 Request Purchase Order Change V01.03
3A9 Request Purchase Order Cancellation
3B2 Notify of Advance Shipment
3B3 Distribute Shipment Status
3B11 Notify of Shipping Order
3B12 Request Shipping Order
3B13 Notify of Shipping Order Confirmation
3B14 Request Shipping Order Cancellation
3B18 Notify of Shipping Documentation
3C1 Return Product
3C3 Notify of Invoice
3C4 Notify of Invoice Reject
3C6 Notify of Remittance Advice
3C7 Notify of Self-Billing Invoice
3D8 Distribute Work in Process
4A1 Notify of Strategic Forecast
4A3 Notify of Threshold Release Forecast
4A4 Notify of Planning Release Forecast
4A5 Notify of Forecast Reply
4B2 Notify of Shipment Receipt
4B3 Notify of Consumption
4C1 Distribute Inventory Report V02.01
4C1 Distribute Inventory Report V02.03
5C1 Distribute Product List
5C2 Request Design Registration
5C4 Distribute Registration Status
5D1 Request Ship From Stock And Debit Authorization
6C1 Query Service Entitlement
6C2 Request Warranty Claim
7B1 Distribute Work in Process
7B5 Notify Of Manufacturing Work Order
7B6 Notify Of Manufacturing Work Order Reply
Appendix D. Attributes
EDI attributes
Envelope profile attributes
Document flow definition and connection attributes
Data Interchange Services client properties
AS attributes
RosettaNet attributes
Backend Integration attribute
Appendix E. Notices
Programming interface information
Trademarks and service marks
Index