ECMap’s mapping engine is known for its high speed and ability to handle complex mapping requirements.
Running your map involves:
The final steps in the mapping process are to generate and run your map. During generation, your map is checked to make sure that everything is set up properly. When you run your map, the outbound EDI file or inbound application file is actually built.
Generating a map produces a .map file that contains the mapping instructions you created. Running a map—with the ECRTP runtime program—interprets the .map file and maps the data.
Generating your map
When you generate a map, you compile all your business rules and logic into your finished map.
Select Generate Map yellow traffic light icon on the toolbar or Workspace. The Generate Map window displays.
Make sure that the Multiple Files check box is not checked. Multiple Files is checked by default. Left-click the check box to uncheck it, or you receive a warning – “All Recd Files with Multiple Recs must have Record Type Fields”
Select Run on the Generate Map window. Messages flash across the text box until the following message appears: “Map Generation Completed Successfully”.
You can view the results of the map generation process by selecting View Log. The Generate Log window displays.
Select Exit to return to the main ECMap window.
Running your map
Map files can be distributed and deployed with the run-time engine.
Select Run Map (the green traffic light) on the toolbar or Workspace. The Run Outbound Map window displays. It has eight tabs – Required, Option 1, Option 2, File Alias, ODBC Alias, Parameters, I/O Redirect, and Web Script. For this exercise, enter information only on the Required tab.
In the Output EDI File text box on the Required tab, type c:\Program Files\Sybase\ECMap\maps\data\OUT.X12. This is the name of the file that the runtime program creates to contain the output EDI data. ECMap automatically populates the Map Name, Transaction Name, Map Directory, Log Type, and Trading Partner Directory.
Select Open.
The Log Type contains a default value and is therefore optional.
The Non-ODBC Trading Partner check box must contain a check because you are not using an ODBC trading partner database.
Select Store RunTime Trading Partner Data.
Do this the first time you run a map or anytime you
change trading partner information.
The runmap dialog box appears, with the message “Store TP Successfully!” Select OK.
Select Run Map.
If you have run this map before, you get a runmap dialog box, asking “Do you want to delete the existing output EDI file?” If you answer NO, the program overwrites the previous output EDI file. If you answer YES, the program appends the new output EDI file to the previous output EDI file.
Select View Trace to review the trace log. If the run was successful, the outgoing.err-Notepad window displays, with the message “Maprun Complete – No Errors Encountered”. If the run was not successful, you would use the information in this log to correct your errors and then run the map again. You can also select View Translog to display the translog.out-Notepad window. Select X in the upper right corner of the window to exit either window.
ECMap is designed for local development and testing. The EC Gateway product completes the cycle – allowing production to take place on a remote platform.
If the run was successful, the View EDI File button is active. Press the button to display the output EDI file on the EDI Viewer window. Your output should look like the example below - with the exception of the italicized numbers, which represent information such as dates that change with each maprun. Select Exit to return to the Run Outbound Map window.
Select X in the upper right corner of the window to close the Run Outbound Map window to return to the main ECMap window.
ISA*00* *00* *01*033459876 *01*024509876 *990808*1201*U*00200*000000001*0*P*> GS*PO*033459876*024509876*19990808*1201*0*X*004010 ST*850*1 BEG*00*SA*PO1133557799-1**19990109 N1*ST**1*027364321 PO1**160*EA*198.00**VN*11410-CP PO1**8*DZ*157.00**VN*21410-ZD PO1**32*EA*653.99**VN*31420-CP PO1**16*EA*193.50**VN*41420-HD SE*8*1 ST*850*2 BEG*00*SA*PO321335577-1**19990109 N1*ST**1*023364990 PO1**20*EA*79.98**VN*11409-CP PO1**8*EA*193.50**VN*31420-CP PO1**3*2D*99.00**VN*21409-ZD SE*7*2 GE*2*0 IEA*1*000000001