Refer to documentation Implementation
The definition of templates is performed on two tabs.
It is strongly recommended to copy the templates so as to keep track of the standard templates.
Presentation
Name of the template to be defined. Use a simple coding system based on the structure, for example: Site + Name of the interface.
Close
Fields
The following fields are present on this tab :
| Table code on 20 characters, numeric or alphanumeric according to the table type. In this latter case, the format is not controlled on the entry. Also, all non numeric characters are not taken into account. In addition, only the decimal point (".") serves as a separator : the comma is not taken into account. |
|   |
| Select or clear this check box to respectively enable or disable the Sort code.
|
Close
Presentation
Code of the interface linked to the template: these codes correspond to standard Warehousing GX interfaces, being:
ITM: Product interface
EIN: Expected input Interface
XEIN: Receipt report
INP: Direct Input Interface
XINP: Put-away report
DLO: Delivery Order (DO) Interface
XDLO: Picking report
XCRR: Carriage report
XSHP: Shipment report
XEND: DO end
EDH: Carrier EDI Interface
BOM: Assembly Order Interface
XBOM: Assembling report
XAJM: Assembling report
XISO: Stock image
XINV: Logistical preinvoice (GEOPLO module)
INISKO: Stock initialization
INISLO: Location assignments
Specify the type of file to be sent, using ranges or a fixed length. If ranges are used, the "field separator" splits fields when moving from one to the other. This "field delimiter" is used on alphanumerical fields to specify the start and end of these fields.
Whether the field has a "fixed length" or is "delimited" by ranges, you need to enter the record separator in order to easily identify movements from a header to a line for instance.
Transcoding information is used to specify the required type of characters in a list of values, to select one of the four date formats (DDMMYY, DDMMYYYY, YYMMDD, YYYYMMDD), the required local menu type and a decimal separator for numerical fields.
The Blank field symbol is used to define characters for: using default transaction values in creation mode; keeping the information modified in the warehouse in modification mode.
Tables of the Identifier block are displayed depending on the interface chosen for the template.
A free code must be set up so it can be used later on during the definition of fields, making it possible to identify the fields of the various tables.
ITM: Product interface (ITM / ITMCTR / ATEXTRA)
EIN: Interface Expected Input (EINPUTH / EINPUTL)
XEIN: Input report (EINPUTH / RECEIPTH / RECEIPTL / EINPUTL)
INP: Direct input interface (INPUTH / INPUTL)
XINP: Put-away report (INPUTH / INPUTL / SERIALNBR)
DLO: Delivery Order Interface (DLVORDERH / DLVORDERL)
XDLO: Picking report (DLVORDERH / DLVORDERL / PARCEL / UNITSHIP)
XSHP: Shipment report (CARNOTE / QUAYMGT / TRANSNOTE / DLVORDERH / DLVORDERL / DELIVERY / UNITSHIP / PARCEL / OUTPUTM / SERIALNBR)
XCRR: Transportation report (CARNOTE / QUAYMGT / TRANSNOTE / DELIVERY / PARCEL / UNITSHIP)
XEND: DO end (DLVORDERH / DLVORDERL)
EDH: Carrier EDI interface (EDIHIS)
BOM: Assembly order interface (BOMORDERH / BOMORDERL)
XBOM: Assembly report (BOMORDERH / BOMORDERL / BOMMVT)
XAJM: Adjustment report (ADJUSTM / SERIALNBR)
XINV: Logistical preinvoice - GEOPLO module (INVOICEH / INVOICEL)
XISO: Stock image (INTSKO)
INISKO: Stock initialization (ADJUSTM / SERIALNBR)
INISLO: Location assignments (SLOT)
Note on the "XML" option for the file type:
This option is used to manage an interface in XML format. The tag names used are defined for each flag table ('Level' column) and at the level of each field (last column called 'Tag').
Example of XML file for the EIN interface (expected inputs): Let us consider the following level definition
Table EINPUTH = Lev. "H", Table EINPUTL = Lev. "L" and tags on fields (ACTION = ACTION, SITE = FCY)
The file would be:
<E> (1st EA)
<ACTION>1</ACTION>
<FCY>EBO</FCY>
……
<L> (1st EA line)
<ACTION>1</ACTION>
<LINREF>0001<\LINREF>
……
</L>
<L> (2nd EA line)
<ACTION>1</ACTION>
<LINREF>0002<\LINREF>
……
</L>
<\E> (End 1st EA)
<E> (2nd EA)
……
<\E>
Close
Fields
The following fields are present on this tab :
Interface
| Code of the interface on which the template is based. |
Structure
| It defines the structure used to manage the data in the file to be imported or exported. For further information, refer to the corresponding paragraph. |
| It defines the separator between two fields. To enter a non-printable character, it is necessary to enter a '\' (back slash) followed by 3 numbers representing the ascii code of the character in decimal base. |
| It defines the separator between two records (data groups). To enter a non-printable character, it is necessary to enter a '\' (back slash) followed by 3 numbers representing the ascii code of the character in decimal base. The following is often used :
|
| It defines the separator between two fields. To enter a non-printable character, it is necessary to enter a '\' (back slash) followed by 3 numbers representing the ascii code of the character in decimal base. |
| It defines the structure used to manage the data in the file to be imported or exported. For further information, refer to the corresponding paragraph. |
Transcoding
| When the ascii character set is being used, it is possible to use various standardized formats :
|
| It defines how the date type fields are coded (order and number of characters for the year). Only the order of characters and the number of characters in the year can be specified. Upon import, any separation characters between fields are filtered; in this way, the dates in the form 29-05-59 or 09/04/1991 are correctly decoded. The decoding sub-program takes into account the engine adxdcs variable, documented via the DCS setup that is found in the general parameters in order to define the manner in which a year is decoded over two characters. DCS represents the "pivot" year that defines the century change. For instance, if DCS is set to 1940, any year made up of two numbers less than or equal to 40 will be considered to be part of the 21st century and any year greater than 40 will be considered to be part of the 20th century. It will therefore be possible to express the years between 1940 and 2039 with two numbers. The AAAA-MM-JJ format is kept only for XML exports. |
|   |
| The fields of type "local menu" are stored under the form of a number representing their rank in the table. According to the value of this field the template will export (or expect to find in import).
Taking into account the fact that the local menu titles are only the labels used in display, the value stored in the database being the rank in the table, it is entirely possible to change the title of the local menus at the time of an import, in order for the search algorithm to operate correctly. However be aware that the fact of changing the local menu titles can only be made in single user mode, also it is not designed for regular or automatic transfers. |
|   |
| It defines the decimal separator used for numbers. If this field is empty, the system will consider that the decimal separator is '.' (full stop). |
| When integrating an interface upon modification, the fields containing this symbol will not be updated. |
|   |
Grid Identifiers
| It defines the group's overlapping level. Level 1 is the main level, a N+1 level defines a sub-level of the preceding N level. |
|   |
| This indicator grid defines the structure of the record groups. Refer to the corresponding paragraph. |
| In the case of a file with fixed length, it is necessary to indicate the number of characters for each record. |
Close
Presentation
Depending on the interface template chosen to define the template, as you browse down the table, lines are incremented in relation to the interface table.
The set up code is used to insert lines of the defined tables.
Each template definition and each table change within the template must begin with the two following lines:
the "$" action code in the "fields" zone with the value Create/Modify/Delete/Read (values 1, 2, 3 or 4),
the separation code "/" indicating the start of the recording and used to link this recording to an interface table. For example: 'H' (header), 'L' (line linked to a header), 'P' for associated parcels.
The next lines are free, however, it will useful to continue with the "site" and "depositor" lines.
The "position", "length" and "format" fields are calculated by the system upon creation, provided the template has been defined as a "fixed length" file. The length can be restricted or extended with no specific limit (caution: data can be truncated in the process). The minimum length of a line cannot be lower than the position of the last character of the last field.
The template structure can be modified: adding or deleting a field within the same table of the template is quite possible. The positions of the framework should simply be recalculated via right click on the mouse ("Position adjustment", to by performed systematically in case of template modification).
When modifying a header, lines do not need to be impacted.
It is not necessary to include all the tables of the interface in the template.
Close
Fields
The following fields are present on this tab :
|   | |
| This field is only entered if the group indicator grid in the previous tab is not empty. It is used to attach the information to be exported or imported to a group of data. | |
|   | |
| Code of the field selected in the table used in this template. | |
|   | |
| The storage location can be entered manually, or be automatically assigned, depending on the type of location associated with the product and based on the stock transaction setup. | |
| This field determines the length of the field for a sequential file. | |
| This column is only entered if the format is fixed length. For numeric amounts, the format entered is defined in the form of nnn or nnn.mmm, remembering that these numbers can be prefixed by < or > (left or right framing being completed with zeros, the right alignment must be used by default), prefixed or suffixed by the character + (mandatory sign before/after the number), and prefixed by the character * (the decimal separator must not appear). The grid below displays examples of the formatting for a given amount (the spaces are replaced here by #).
For an alphanumeric format, the only formatting directives that are possible are < or > (left or right alignment, remembering that the character strings are completed with spaces). | |
| This field is used when imports/exports are carried out under the XML format. Indeed, when a XML file is created, some more information are required, especially in order to create a XSD file describing the structure of the XML file and then, to control its validity with syntax check tools integrated to the different ETL software. This field defines the code of the tag describing the field exported in the template, as it appears in the XML file. |
Close
Action icon
In addition to the generic error messages, the following messages can appear during the entry :
Template XX: Record does not exist
The entered template is not defined in the table of templates.
File name: mandatory field.
The file name has not been entered.
Inconsistent length and position
For a fixed length file, the field positions cannot overlap.
Value out of range
The maximum length of a record is 3,000 characters.
Non-existent field
The template field must be a table field