Creating a System Import Map

A system import map is used by the system to find the partner relationship for a document (flat file definition), to determine which import map is used to translate the data. The system import map builds the key that the translator uses to find the partner relationship. The sole function of the system import map is to identify the appropriate partner relationship; the system import map does not map any data.

There are two ways to build the key in a system import map. The method that we recommend requires six EDI-specific fields in the header record: partner key, standard, version, transaction set, release (for TRADACOMS only), and test/production status. The combination of these six fields defines a unique key that identifies the appropriate partner relationship. We recommend using this method because it is very flexible. You typically use this method when you are defining your application from scratch and can easily add the EDI-specific fields that are not already present in the header record.

The second method is easier to build because it only requires three fields in the header record (partner key, application ID or application alias value, and test/production status). The combination of these three fields defines a unique key that identifies the appropriate partner relationship. However, because only three fields are combining to build the key, this method is not as flexible as the preferred method. You typically use this method when you are using a legacy (existing) application definition, and you do not want to add EDI-specific information.

Use this procedure to create a system import map.

Select File > New.
The system displays the New Map Wizard.
From the type of map list, select System Import.
In the name box, type the name of the map.
Verify that your name is already entered in the name box and click Next.
The system displays the New Map Wizard - Input Format dialog box.
From the Create a new data format list, select Positional and click Next.
The system displays the New Map Wizard - Output Format dialog box.
From the Create a new data format list, select Positional and click Next.
The system actually ignores the Output side of the map and only processes the Input side.
Click Finish to create the new system import map (this may take a few seconds).
The system displays the new map in the Sterling Gentran:Server® - Application Integration Window.
After creating the system import map, you need to define the header record for the system import map. You can use either a six-field key (this is the preferred method) or the alternate key method.