Prerequisites to using the EDI to XML Map utility
Define your map just as you would define any other inbound EDI X12 map. Refer to Chapter 3, “Working with Maps” for instructions.
Specify the X12 EDI standard or version and transaction to be mapped.
Select the year to be used as the Century Minimum when 6-digit date fields are mapped to 8-digit date fields, specify whether 8-digit dates are used in X12 envelopes, and optionally enter a description of the map. The map direction must be IN.
Creating an XML map
When you create an XML map, ECMap automatically creates a compete map based on the X12 transaction, including XML elements and attributes, the mapping, and the rules and flow.
In ECMap’s main menu, select Utilities > Generate EDI to XML Map.
The Generate EDI to XML Map window displays. The names of the current Project and Map appear in the Map group.
In the Options group, click Run.
The program converts your EDI map into an XML map. A text box appears in the Options group, which processes visible messages. The messages reflect the map generation activity taking place; for example, actions such as creating map transaction files, creating and mapping record fields, creating cross-reference files, creating XML map rules, creating flow, processing application files, processing rules, processing master element and condition tables, and processing reference files. when all activity is finished, the message in the text box gives the final status of the map generation process. The initial generation of the XML map will be successful.
Click View Log, and the Generate Log window displays results similar to the following:
7/7/2004 5:49:56 PM Log For Project: My Map:HIPAA_270_4010_50 Map Generation Completed Successfully No Errors and No Warnings
Click Cancel to return to the EDI to XML Map window.
Generating the map and troubleshooting the results
Under certain circumstances, such as when an EDI transaction contains HL segments, the map may require modifications if it was based on the native X12 transaction definition.
Modify the map just like any other data transformation map, and then use the Generate utility to generate a new .map file. Refer to “Modifying a map”.
In ECMap’s main window, select Build > Generate Map or click the Generate Map icon.
While the program generates the map, it creates a log file. This log file includes a list of all the warnings, not referenced messages, or errors found during map generation. For reference, the first line contains the date and time and the names of the project and map. At the end of the log, there is a summary of the problems encountered and a message indicating whether or not the map generated successfully.
Click View Log, and the Generate Log window displays results similar to the following:
7/7/2004 5:49:56 PM Log For Project: My Map:HIPAA_270_4010_50 Map Generation Completed Successfully No Errors and No Warnings
If the map generation processes succeeded, proceed to Run Map.
If the map generation process failed, find and fix the problems that caused the failure and regenerate the map until no errors remain.
Warnings and “Not Referenced” messages indicate potential problems. They do not prevent your map from being generated, nor do they necessarily have to be corrected, although you should check them. For example, you receive a “Not Referenced” message if your data contains records that are not used in the map. If you intentionally excluded these records from your map, ignore the message. However, if you do need information from the records and simply did not include the correct instructions in your mapping, you need to change your mapping instructions and regenerate the map.
Refer to the ECMap Reference Guide for a description of messages that you might receive while generating a map.
Click Cancel to return to the EDI to XML Map window.
Associating an XML map with the ALL trading partner
After generating the XML map, you must create a trade agreement associating the map with the ALL TradePartner. Unless you are going to build specific versions based on the Trade Partner, choose ALL TradePartner.
In ECMap’s main window, select File > Address Book > Contacts (Trading Partner). The Trading Partners window displays.
On the Trading Partners window, highlight the ALL trading partner.
Right-click the ALL trading partner and choose Trade Agreement from the submenu. The Trade Agreement with Trade Partner:ALL displays.
Select File > Add Map. The program automatically creates a trade agreement linking the current map with this trading partner. The map information displays on the window and highlighted.
The map is highlighted. From the menu, select Edit > Properties. If you have not selected the standard for your map, the Standard Type for Map window displays.
Select the appropriate standard for your map. The Trade Agreements window displays.
The program automatically enters the information.
Click OK on the Trade Agreements window.
Close the Trade Agreements With Trade Partner:ALL and Trading Partner windows to return to the main ECMap window.
