eGate Integrator Tutorial Release 5.0.5 SeeBeyond Proprietary and Confidential The information contained in this document is subject to change and is updated periodically to reflect changes to the applicable software. Although every effort has been made to ensure the accuracy of this document, SeeBeyond Technology Corporation (SeeBeyond) assumes no responsibility for any errors that may appear herein. The software described in this document is furnished under a License Agreement and may be used or copied only in accordance with the terms of such License Agreement. Printing, copying, or reproducing this document in any fashion is prohibited except in accordance with the License Agreement. The contents of this document are designated as being confidential and proprietary; are considered to be trade secrets of SeeBeyond; and may be used only in accordance with the License Agreement, as protected and enforceable by law. SeeBeyond assumes no responsibility for the use or reliability of its software on platforms that are not supported by SeeBeyond. SeeBeyond, e*Gate, e*Way, and e*Xchange are the registered trademarks of SeeBeyond Technology Corporation in the United States and/or select foreign countries. The SeeBeyond logo, SeeBeyond Integrated Composite Application Network Suite, eGate, eWay, eInsight, eVision, eXchange, eView, eIndex, eTL, ePortal, eBAM, and e*Insight are trademarks of SeeBeyond Technology Corporation. The absence of a trademark from this list does not constitute a waiver of SeeBeyond Technology Corporation’s intellectual property rights concerning that trademark. This document may contain references to other company, brand, and product names. These company, brand, and product names are used herein for identification purposes only and may be the trademarks of their respective owners. © 2004 by SeeBeyond Technology Corporation. All Rights Reserved. This work is protected as an unpublished work under the copyright laws. This work is confidential and proprietary information of SeeBeyond and must be maintained in strict confidence. Version 20041118160439. eGate Integrator Tutorial 2 SeeBeyond Proprietary and Confidential Contents Contents List of Figures 6 Chapter 1 Introduction 10 About this Document 10 What’s in this Document 10 Intended Audience 11 Document Conventions 11 Screenshots Used in this Document 11 Related Documents 11 ICAN Suite Installation Requirements 12 SeeBeyond Web Site 12 SeeBeyond Documentation Feedback 12 Chapter 2 Features of the Enterprise Designer 13 Enterprise Designer Components 13 Menu Bar 14 Enterprise Explorer 15 Project Editor 15 Chapter 3 Building a Project - Scenario1 16 Business Challenge 16 Project Overview 17 Project Description 17 Process Overview 17 Project Flow Diagram - Scenario1 19 ICAN Files Required for the Tutorials 20 Repository, Logicalhost and Environment 20 eGate Integrator Tutorial 3 SeeBeyond Proprietary and Confidential Contents File Names 20 Sample Data 20 Download the Sample Files 20 Create Sample Input XML File 21 Create Input (DTD) File 22 Create Output (DTD) File 22 Create New Project 23 Create Connectivity Map 25 Add Components to the Connectivity Map 26 Create New Object Type Definition 28 Configure the Services 32 Create Service1 32 Apply the Business Rules 39 Apply the Collaboration 46 Link Components in the Connectivity Map 47 Configure the eWays 48 Multiple records per file (True or False) 51 Create Environment 52 Create Environment and Logical Host 52 Create and Activate Deployment Profile 55 Run the Bootstrap and Management Agent 57 Run the Bootstrap 58 Edit Properties and run bootstrap.bat (method 1) 58 Run Bootstrap.bat from a DOS command (method 2) 59 Run Project1 60 Verify Output Data 61 Edit Input File in Real Time 63 Chapter 4 Building a Project - Scenario2 64 Business Challenge 65 Project Overview 66 Required Resources 66 Project Description 66 Naming Conventions used in this Scenario 67 Project Flow Diagram - Scenario2 68 Sample Data 69 Download the Sample Files 69 Create Sample Input XML File 69 Create Input (DTD) File 69 Create Output (DTD) File 70 eGate Integrator Tutorial 4 SeeBeyond Proprietary and Confidential Contents Create New Project 71 Create Connectivity Map 72 Add Components to the Connectivity Map 74 Add Components to the Connectivity Map 74 Create New Object Type Definition 76 Configure Services for Input 82 Configure svcTimecard_to_topic 82 Apply Business Rules for jcdTimecardToTopic_collab 86 Configure Services for Output 88 Apply Business Rules for jcdTopicToPayrollOut_collab 92 Apply Collaborations and Link Components 103 Link Components in the Connectivity Map 103 Configure eWays and JMS Connections 105 JMS Client Configuration 108 Create Environment 109 Create and Activate Deployment Profile 111 Run Bootstrap and Management Agent 114 Run prjProject2 114 Verify Output Data 115 Chapter 5 Enterprise Manager Overview 116 Browser-based Monitor Console 116 Locating the Problem Node 116 Using Project View 117 Using Environment View 117 Starting and Using Enterprise Manager 117 Stop Service 121 Monitor Alerts 122 Check Log Messages 122 Glossary 124 e*Gate 4.x Terms in eGate 5.0 127 Index 129 eGate Integrator Tutorial 5 SeeBeyond Proprietary and Confidential List of Figures List of Figures Figure 1 SeeBeyond Enterprise Designer 14 Figure 2 Enterprise Designer Menu Bar 14 Figure 3 Project Connectivity Map 17 Figure 4 Project Flowchart - Scenario1 19 Figure 5 Enterprise Designer Login 23 Figure 6 Create a Project 24 Figure 7 Project Folder: Project1 24 Figure 8 Create a Connectivity Map 25 Figure 9 Project1 with a Connectivity Map (CMap1) 26 Figure 10 External Application Selection 27 Figure 11 Connectivity Map 27 Figure 12 OTD Wizard Selection 28 Figure 13 Select DTD Files 29 Figure 14 Select Document Elements 30 Figure 15 Select OTD Options 30 Figure 16 OTD Editor Input 31 Figure 17 Connectivity Map Window 32 Figure 18 New Collaboration Definition (Java) Name 33 Figure 19 New Collaboration Definition Wizard (Java) 34 Figure 20 New Collaboration Web Service Interface 35 Figure 21 Select OTDs 36 Figure 22 Select FileClient OTD 37 Figure 23 Selected OTDs 38 Figure 24 Collaboration Editor (Java) 39 Figure 25 Unmarshal Text 40 Figure 26 Select Unmarshal 40 Figure 27 Business Designer - Unmarshal Text 41 Figure 28 Concatenation Logic 42 Figure 29 Collapse For Loop 42 Figure 30 Source Code Mode 43 Figure 31 Click and Drag s1output 44 Figure 32 Marshal to String 44 eGate Integrator User’s Guide 6 SeeBeyond Proprietary and Confidential List of Figures Figure 33 View Business Rules 45 Figure 34 Write Output File 46 Figure 35 Objects in Connectivity Map 47 Figure 36 Using the Drag and Drop method 47 Figure 37 Connect FileClient to File1 48 Figure 38 Connect FileClient to File2 48 Figure 39 Inbound eWay 49 Figure 40 External Type Dialog Box 49 Figure 41 Properties Configuration (Inbound eWay) 49 Figure 42 Outbound eWay 50 Figure 43 Properties Configuration (Outbound eWay) 51 Figure 44 Environment with Logicalhost 53 Figure 45 External File Inbound 53 Figure 46 External File Outbound 54 Figure 47 Environment Editor 54 Figure 48 Deployment Profile 55 Figure 49 Environment, Drag and Drop Components 56 Figure 50 Populated Environment 57 Figure 51 Bootstrap Command Example 59 Figure 52 Activation in Progress Message 60 Figure 53 Activation Options 60 Figure 54 Apply Changes in Progress 61 Figure 55 Changes Applied to Logical Host 61 Figure 56 Output File 62 Figure 57 Input File 62 Figure 58 The Relationship Between the Two Systems 65 Figure 59 Project Connectivity Map 66 Figure 60 Project Flowchart - Scenario2 68 Figure 61 Enterprise Designer Login Dialog Box 71 Figure 62 Create a Project 72 Figure 63 Project Folder: prjProject2 72 Figure 64 Create a Connectivity Map 73 Figure 65 prjProject2 with a Connectivity Map (cmCMap2) 74 Figure 66 External Application Selection 75 Figure 67 Connectivity Map 76 Figure 68 OTD Wizard Selection 77 Figure 69 Select DTD Files 78 Figure 70 Select Document Elements 79 eGate Integrator User’s Guide 7 SeeBeyond Proprietary and Confidential List of Figures Figure 71 Select OTD Options 79 Figure 72 OTD Editor Input 80 Figure 73 Test Input Data File 81 Figure 74 New Collaboration Definition (Java) Name 82 Figure 75 New Collaboration Definition Wizard (Java) 83 Figure 76 New Collaboration Web Service Interface 84 Figure 77 New Collaboration Select OTD 85 Figure 78 Business Rules Designer 86 Figure 79 Methods Dialog Box 87 Figure 80 Send Text Payload 87 Figure 81 New Collaboration Definition Editor (Java) 89 Figure 82 Receive from Topic 90 Figure 83 Input/Output OTDs for jcdTopicToPayrollOut_collab 91 Figure 84 Drop Down Arrow button 91 Figure 85 OTDs for jcdTopicToPayrollOut_collab 92 Figure 86 Business Rules Designer for jcdTopicToPayrollOut_collab 93 Figure 87 Collaboration Editor (Java) - Unmarshal From String 94 Figure 88 Connect Input/Output OTD Nodes 95 Figure 89 Class Browser - parseInt(String s) 96 Figure 90 Window Adjust 97 Figure 91 Prepare for Multiplication 97 Figure 92 Class Browser Constructor 98 Figure 93 Class Browser - toString 99 Figure 94 Multiplication Operation 100 Figure 95 Select a Method 100 Figure 96 Marshal Text 101 Figure 97 Write File Application 102 Figure 98 Unlinked Objects in Connectivity Map 103 Figure 99 Connect Input to Client 104 Figure 100 Connect JMS to Topic 104 Figure 101 svcTimecard_to_topic Linked 104 Figure 102 Connect Topic to Output 105 Figure 103 Linked Connectivity Map 105 Figure 104 Inbound eWay 106 Figure 105 External Type Dialog Box 106 Figure 106 Properties Configuration