UN/EDIFACT ETD Library User’s Guide - Oracle

1 SeeBeyond Proprietary and ConfidentialUN/ edifact OTD Library user s GuideRelease 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.

2 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 , 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.

3 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 SeeBeyond Technology Corporation. All Rights Reserved. This work is protected as an unpublished work under the copyright work is confidential and proprietary information of SeeBeyond and must be maintained in strict OTD Library user s Guide2 SeeBeyond Proprietary and ConfidentialContentsUN/ edifact OTD Library user s Guide3 SeeBeyond Proprietary and ConfidentialContentsList of Figures6 List of Tables7 Chapter 1 Introduction8 Overview8 Intended Reader8 Compatible Systems8 Document Organization9 Writing Conventions9 Additional Conventions9 Supporting Documents10 SeeBeyond Web Site10UN/ECE Web Site10 Chapter 2 overview of UN/EDIFACT11UN/ edifact Components11 Message Structure12 Messages13 Segment Table18 Loops19

4 Envelopes20 UNA segment20 Control messages20 Delimiters21 OTD Libraries21UN/ edifact Versus X1222 Security22 Examples of EDI Usage22 overview of EDI Payments Processing22 ContentsUN/ edifact OTD Library user s Guide4 SeeBeyond Proprietary and ConfidentialExchange of remittance information23 Routing of remittance information23 Exchange of payment orders23 Functions a payment must perform24 Formats for transporting a payment24 Issuance of a payment order24 Payment-Related EDI Transactions25X1225UN/EDIFACT25 Understanding Enveloping Scenarios26 Point-to-point scenario28 End-to-end scenario28 Payment Acknowledgments29 Key Parts of EDI Processing Logic30 Structures30 Validations, Translations, Enveloping, Acknowledgments30 Chapter 3 Installation31 System Requirements31 Installation Procedure32 Uploading to the Repository32 Refreshing Enterprise Designer33UN/ edifact Library Templates34UN/ edifact OTDs34 Transaction Template Names34eGate Project Explorer Display of UN/EDIFACT OTDs35 Chapter 4UN/ edifact OTD Library36UN/ edifact Files and Directories36UN/ edifact Batch, Interactive, and Envelope File Names36 Existing v3 Envelope Names36 Existing v4 Envelope Names38 Chapter 5 Working With the edifact OTDs42 Importing.

5 Jar Files42 Viewing an edifact OTD in the OTD Editor43 Setting the Delimiters46 Methods for Getting and Setting46 ContentsUN/ edifact OTD Library user s Guide5 SeeBeyond Proprietary and ConfidentialBean Nodes for Getting and Setting Data47 Bean Nodes for Getting Errors and Results47 Using Validation in the Java Collaboration Editor48 Creating a Collaboration Rule to Validate an OTD48 Alternative Formats: ANSI and XML49 XML Format for EDIFACT49 Possible Differences in Output When Using Pass-Through52 Limitations of edifact OTDs52 Memory Requirements52 Delayed Unmarshaling53 Errors and Exceptions53 Special Methods for Error Classes54 Chapter 6 Java Methods for edifact OTDs55 Using the OTD Editor to View and Test an OTD55To open an OTD55To test OTDs against sample data using the OTD Editor56 Delimiters56 Using the Collaboration Rules Editor to Validate an OTD57 Methods57 Java Methods to Set or Get

6 Delimiters57setDefaultEdifactDelimiters5 8getSegmentTerminator58setSegmentTermina tor59getElementSeparator60setElementSepa rator60getSubelementSeparator61setSubele mentSeparator61getRepetitionSeparator62s etRepetitionSeparator63validate63 Index65 List of FiguresUN/ edifact OTD Library user s Guide6 SeeBeyond Proprietary and ConfidentialList of FiguresFigure 1 Example Payment Scenario27 Figure 2 Update Center Wizard: Select Modules to Install33 Figure 3 Some of the Transaction Set Structures for edifact Version D00A34 Figure 4v3 Envelope Segments37 Figure 5v4 Batch Envelope Segments39 Figure 6v4 Interactive Envelope Segments39 Figure 7 Importing 8X12 270 Transaction in the OTD Editor45 Figure 9 Accessing a Method in an X12 OTD48 Figure 10 Accessing the performValidation Method from the Root Node49 Figure 11 XML edifact DTD50 Figure 12 edifact 997 Functional Acknowledgment XML51 Figure 13 edifact 997 Functional Acknowledgment ANSI Format51 Figure 14 Setting the Maximum Heap Size52 Figure 15 Example of an.

7 Xsc File in the OTD Editor56 List of TablesUN/ edifact OTD Library user s Guide7 SeeBeyond Proprietary and ConfidentialList of TablesTable 1 Writing Conventions9 Table 2 Batch Messages Defined in Version D00A13 Table 3 Comparison BetweenX12 and UN/EDIFACT Envelopes20 Table 4 Comparison of X12 to UN/EDIFACT : Payment Order/Remittance Advice26 Table 5 Other Related Transactions26 Table 6 Sample X12 and UN/EDIFACT Headers27 Table 7 Types of UN/EDIFACT and X12 Acknowledgments29 Table 8 Key Terms of EDI Processing30 Table 9UN/ edifact Versions Supported31 Table 10 OTD Library Hierarchy in Project Explorer35 Table 11v3 Control Message37 Table 12v3 Batch Segments 37 Table 13v4 Control Message40 Table 14v4 Segments40UN/ edifact OTD Library user s Guide8 SeeBeyond Proprietary and ConfidentialChapter 1 IntroductionThis chapter introduces you to the UN/EDIFACT OTD Library user s of the eGate Object Type Definition (OTD)

8 Libraries contains sets of pre-built structures for industry-standard formats. The UN/EDIFACT OTD Library is one of the producst within the SeeBeyond Technology CorporationTM (SeeBeyondTM) ICAN Suite. The OTD Library contains message definitions for edifact messages. This document gives a brief overview of both edifact and the edifact message structures that are provided, and provides information on installing and using the OTD ReaderThe reader of this Guide is presumed to be a developer or system administrator with responsibility for maintaining the SeeBeyond ICAN Suite (such as eGate Integrator and eXchange Integrator), to have familiarity with Windows operations and administration, and to be thoroughly familiar with Microsoft Windows graphical user SystemsThe UN/EDIFACT OTD Library is available on the following platforms.

9 Microsoft Windows 2000, Windows XP, and Windows 2003 Sun Solaris 8 and Solaris 9 IBM AIX 5L Version and AIX 5L Version HP-UX and HP-UX 11i (PA-RISC) HP Tru64 UNIX Version Red Hat Linux 8 (Intel Version) and Linux Advanced Server (Intel version)Chapter 1 Section OrganizationUN/ edifact OTD Library user s Guide9 SeeBeyond Proprietary and OrganizationThis document is organized topically as follows: Chapter 1 Introduction gives a general preview of this document, its purpose, scope, and organization. Chapter 2 overview of UN/EDIFACT provides an overview of UN/EDIFACT , including examples of a batch message and a segment table, along with additional information about their components, structure, and validation rules.

10 Chapter 3 Installation explains how to installUN/ edifact files and where to find them after installation. Chapter 4 UN/EDIFACT OTD Library lists sample file and directory names in the UN/EDIFACT OTD Library . Chapter 5 Working With the edifact OTDs provides instructions and examples on how to load, view, and test edifact OTDs. Chapter 6 Java Methods for edifact OTDs lists and explains the bean nodes and Java methods that can be used to extend the functionality of the OTDs in the ConventionsThe following writing conventions are observed throughout this ConventionsWindows SystemsFor the purposes of this Guide , references to Windows will apply to Microsoft Windows Server 2003, Windows XP, and Windows 1 Writing ConventionsTextConventionExampleNames of buttons, files, menus and menu items, icons, parameters, variables, methods, and objectsBold text Select the file.