webMethods EDI Module 6.5 readme

April 2005

This file provides important information you should read before using webMethods EDI Module 6.5.

Documentation about how to install webMethods EDI Module 6.5 is located in the webMethods Installation Guide. Procedures for upgrading webMethods EDI Module are located onthe webMethods EDI Module page of the webMethods Bookshelf.

Contents

1.0 Critical Information

2.0 Known Issues

3.0 Usage Notes

4.0 Enhancements and Fixes

5.0 Deprecated Items

6.0 Globalization

    6.1 Localization and Certification

    6.2 Configuration

    6.3 Known Globalization Issues

7.0 Documentation

    7.1 Major Documentation Changes

    7.2 Known Documentation Issues

8.0 Copyright Information

    8.1 webMethods Copyright

    8.2 Other Product Copyrights

9.0 Contacting webMethods

10.0 Viewing the readme for the Previous Version

1.0 Critical Information

If you process incoming EDI documents in a business process, do not install webMethods EDI Module 6.5 or webMethods Trading Networks 6.5 until the WmPRT package 6.5 and webMethods Modeler 6.5 are available. Even if you have the EDI Module set up to form a Conversation ID for an incoming EDI document, EDI Module 6.5 will not add the Conversation ID to the BizDocEnvelope that Trading Networks processes. As a result, Trading Networks will not pass the EDI document to process management, and the EDI document will not be processed in a business process even if you have defined a process model using webMethods Modeler. When the WmPRT package 6.5 and webMethods Modeler 6.5 are available, webMethods will release a fix for the webMethods EDI Module 6.5 to enable the logic to include a Conversation ID with an EDI document. This will allow you to process EDI documents using a business process.

2.0 Known Issues

-  Starting in X12 4020, X12 provides a repetition separator to separate repeated occurrences of elements or composites. We do not support the repetition separator in this release.

-  For ODETTE standards, we only support document recognition in Trading Networks.

For other known issues and troubleshooting information relating to webMethods EDI Module, see the Knowledge Base on the webMethods Advantage Web site.

3.0 Usage Notes

-  Certain EDI Standards, such as UCS, VICS, and EANCOM, restrict the default standard allowed code values using alternate code sets. Support for alternate code sets was first implemented in webMethods Integration Server 6.1 SP1. If users migrate from webMethods 6.1 to 6.5, schemas installed in 6.1 might be using alternate code sets while schemas installed in 6.5 might not. For consistency, we recommend that users re-generate EDI schemas created in 6.1.

-  For WmEDIINT users to continue to sign/verify/encrypt/decrypt SMIME payloads, they will have to either install their certificates in the Integration Server’s Trusted Directory or set the property watt.security.cert.wmChainVerifier.trustByDefault to true in the server.cnf file.

-  EDI ID qualifiers for different EDI standards and versions can use the same code. The EDI Module can only support mapping one description to a single EDI ID qualifier. If the default mapping of the EDI ID qualifier is not mapped as the customer intended, the user needs to write a custom service, custom.EDIIDMapping:addEDIIDMapping, to overwrite the mapping. For detailed information on the custom service, please go to the Knowledge Base Samples area on the webMethods Advantage Web site.

4.0 Enhancements and Fixes

For information on enhancements and fixes in webMethods EDI Module 6.5, go to the webMethods EDI Module 6.5 Enhancements and Fixes document on the webMethods Bookshelf.

5.0 Deprecated Items

The webMethods EDI Samples package (WmEDIsamples) is no longer available through the webMethods Installer. To obtain the latest webMethods EDI Samples package, go to the Knowledge Base Samples area on the webMethods Advantage Web site.

6.0 Globalization

The webMethods EDI Module Version 6.5 has not been tested for conformance with the internationalization standards of webMethods. This internal certification is planned for a future release. This release of the EDI Module currently does not support fixed-length fields for multi-byte and wide character encodings. As a result, the EDI Module has not been tested with character encodings other than ISO8859-1 ("Latin-1") and US-ASCII. These known issues are listed below.

6.1 Localization and Certification

webMethods EDI Module is provided with an English user interface, messages, and documentation. No language pack is available in this release.

6.2 Configuration

If you expect to display non-English data in your webMethods tools, make sure an appropriate font is installed in your operating environment. If you see hollow boxes or black squares where you expect to see non-English data, modify your JRE font.properties file to reference an appropriate font. For information on modifying your font.properties file, go to Sun's Java website. For instructions, see:

http://java.sun.com/j2se/1.4.2/docs/guide/intl/fontprop.html

http://www.unicode.org/help/display_problems.html

6.3 Known Globalization Issues

webMethods EDI Module has the following known limitations at the time of its release:

-  This release of the EDI Module currently does not support fixed-length fields for multi-byte and wide character encodings.

7.0 Documentation

For webMethods EDI Module 6.5 technical documentation, go to either one of the following directories or the webMethods Bookshelf:

<Integration_Server_Directory>\packages\WmEDI\pub\doc

<Integration_Server_Directory>\packages\WmEDIINT\pub\doc

The following manuals are provided as PDF files:

- webMethods EDI Module Concepts Guide 6.5

- webMethods EDI Module User’s Guide 6.5

- webMethods EDI Module Built-In Services Reference 6.5

- webMethods EDIINT Module User’s Guide 6.5

- webMethods EDI Modules Upgrading from 4.x to 6.5

- webMethods EDI Modules Upgrading from 6.0.1 or 6.1 to 6.5

To view the documentation, you must have Adobe Acrobat Reader 4.0 or later.

For information regarding this release of webMethods EDI Module, see the webMethods EDI Module 6.5 Release Notes on the webMethods Bookshelf.

For information about technical support, see the General Support Statement for webMethods Fabric.

7.1 Major Documentation Changes

All EDIINT user documentation and built-in services documentation has been moved to a newly-created document, the webMethods EDIINT Module User’s Guide 6.5.

7.2 Known Documentation Issues

None.

8.0 Copyright Information

8.1 webMethods Copyright

webMethods Administrator, webMethods Broker, webMethods Dashboard, webMethods Developer, webMethods Fabric, webMethods Glue, webMethods Installer, webMethods Integration Server, webMethods Mainframe, webMethods Manager, webMethods Mobile, webMethods Modeler, webMethods Monitor, webMethods Optimize, webMethods Portal, webMethods Trading Networks, and webMethods Workflow are trademarks of webMethods, Inc. webMethods and the webMethods logo are registered trademarks of webMethods, Inc.

All other marks are the property of their respective owners. Copyright (c) 2005 by webMethods, Inc. All rights reserved, including the right of reproduction in whole or in part in any form.

8.2 Other Product Copyrights

Java (TM) 2 Runtime Environment, Standard Edition, Version 1.4 Licensed material - Property of IBM (c) Copyright IBM Corporation, 1996-2004.  All rights reserved.

9.0 Contacting webMethods

Authorized technical support contacts can reach webMethods Customer Care for support via:

  webMethods Advantage Web site

  E-mail: support@webMethods.com

  US Phone: 1-888-222-8215

  Europe/EMEA Phone: +800-963-84-637 or +31-207783640

  Asia/Pacific Phone: +1800 117 411 or 8913 1111

Self-service support is also available in the webMethods Advantage Knowledge Base and in the Advantage Customer Forums.

10.0 Viewing the readme for the Previous Version

To view information about the previous release of webMethods EDI Module, see the previous readme on the webMethods Bookshelf.

EDI-RM-65-20050429