Field Definition Properties

Property

Description

Mandatory

Specifies whether or not an instance of this field definition is required to exist in the flat file.

Select...

To...

True

Indicate the field is required.

If you select True and the validate parameter in the pub.flatFile:convertToValues service is set to true, Integration Server generates errors when the field does not exist in a flat file.

False

Default. Indicate the field is optional.

Note:

This property does not apply to field definitions in flat file dictionaries.

Extractor

Location of the data to extract for this field. Click

to open the Extractors dialog box and specify an extractor.

The extractor works for a field only if field delimiters have been defined for this flat file schema.

Select...

To...

Nth Field

Specify the position of the field to extract.

Note:

Software AG recommends that you use this extractor instead of ID node.

ID Node

Specify the position of the field to extract. The ID Node extractor is a variation of the Nth Field extractor and is available for backward compatibility for users of the webMethods Module for EDI.

Fixed Position

Specify the start and end positions of the bytes to extract.

Note:

This property does not apply to field definitions in flat file dictionaries.

Validator

Specifies the type of validator to use to perform validation for the field.

Click

to open the Validators dialog box and select a validator.

Select...

To...

None

Default. Indicate that no validator is used.

Length Validator

Specify the maximum and minimum number of characters this field can contain to be considered valid.

Byte Length Validator

You specify the maximum and minimum number of bytes this field can contain to be considered valid.

Note:

Use the byte length validator for multi-byte encoded records.

Code List Validator

Specify a comma–separated list of the allowed values for this field. If the value of the field is not contained in the code list, errors will be generated.

Format service

Enter the fully-qualified name of the service to use to format data from this field. You can click

to navigate to and select a service.

Alternate name

Another name for the field definition. When an IS document type is generated from a flat file schema, the alternate name is used as the name of the String field that corresponds to this field definition.

Description

Description of the field definition.

Note:

This property does not apply to a field definition in a composite reference or a record reference.

ID Code

IDCode for the field definition. The IDCode is provided in a SEF file and is used by the WmEDI package.

Data type

Data type for the field as specified in the SEF file. This information is used by the WmEDI package.

Local description

For a field definition in a composite reference or a record reference, specifies a description for the field definition at this particular location in the flat file schema.

Note:

This property does not apply to field definitions in flat file dictionaries.