Creating functional acknowledgment maps

Functional acknowledgment maps are used to create custom functional acknowledgments. Often, an existing functional acknowledgment map can be used by copying the map and then making changes in the copied map. If there is no similar existing functional acknowledgment map, then a new map must be created.

The following steps describe how to create a new functional acknowledgment map.

  1. Open the Functional acknowledgment Maps list window by clicking the Mapping button in Data Interchange Services client, then clicking the Functional Acknowledgment Maps tab.
  2. Click the New button on the Functional Acknowledgment Maps list window. The Create a Functional Acknowledgment Map - Map Name wizard appears.
  3. Enter the name of the map and a description, then press the Next button.
  4. Indicate whether the map will be source- or target- based, then click Next. In general, it is better to make the map source-based. You may want to make the map target-based if you are very familiar with the target document definition and not very familiar with the source document definition. Source-based maps usually result in more efficient translation of a document.
  5. Select the name of the document definition that describes the layout of the functional acknowledgment, then click Next. The list you can select from displays all 997, 999, and CONTRL EDI document definitions that are defined in the current database. The target function acknowledgment must be one of the document definitions in this list.
  6. On the Confirmation page, ensure that the information displayed is correct, then click Finish. The map information you entered is saved to the database, the wizard closes, and the Functional Acknowledgment Map editor opens.
  7. Click the Comments tab, and type any information you have about the map into the Comments field.
  8. Click the Details tab. In the Details page, perform the mapping tasks necessary to create the mapping commands that instruct the translator component of WebSphere Partner Gateway how to create a functional acknowledgment. Use the Details page on-line help for complete information on performing mapping. At this point, use the various available mapping techniques to create a map. This might include a "drag and drop" from a source field to target field, or the specification of an "assignment command" to set a target field to a specific value. Other mapping commands and mapping functions can be use to format data, convert data from one value to another, or qualify the movement of data based on the content of the source message. "Conditional statements" can be used to provide alternate courses of action for the translator component.
  9. Click the Save button when you are finished. Data Interchange Services client saves the map to the database. It is recommended that you periodically click the Save button to save your changes to the database while you are mapping. The first time a map is saved after mapping commands and comments have been entered, the save process may take a while, especially when the map is based on a large EDI document definition. This is because every node displayed in the Mapping Command page is saved to the database this one time. Subsequent saves will only save changes to the map.
  10. Click File > Close to close the editor when you are finished creating the map.

Copyright IBM Corp. 2003, 2005