Fields settings

This section explains the fields of multi format information.

(1) Fields for Multi Format - Detailed Information

ID

The ID used to identify registered multi format information.

Business group

A business group for which general users have access rights.

Alternatively, a business group that is used as a filter condition only.

Comment

Comment about the multi format information.

Settings type

Selects either the unified or separate settings as the format ID in Multi Format information.

Unified settings

: Specifies the same key value for all format IDs.

Separate settings

: Specifies different key values depending on format IDs.　The maximum number of keys that you can specify is 3.

Start position

The start position of the key set in the record. The unit is bytes.

Length

The length of the key set in the record. The unit is number of characters.

Example: Key value abc

If the Input kanji code type is Shift JIS, the key length is 3.

If the Input kanji code type is UTF-16, the key length is 3 as well.

Key category(when Unified settings is selected)

Selects whether the key value is specified in characters or in hexadecimal notation. If the Input kanji code type is JIS and the data type for the Key value is M, set this to Binary.

Character

: Specify the key value in characters. We recommend you to choose Character when character-based data, such as type M and type X, is selected as the key value.

Binary

: Specify the key value in hexadecimal notation. We recommend you to choose Binary when binary-based data, such as type I and type B, is selected as the key value.

Note

When "Kanji code type" for the input settings is "JIS" and "Field type" for "Key value" is "M", set to "Binary".

No.

The row number in the table. Serial numbers are input automatically.

Format ID

The format ID used when the key matches.

Key value

The key value that identifies what format information to use.

When the Extension is specified for Key category

If the Extension is specified for Key category, the regular expression can be used.

To use the control character or multi-byte character as a key, specify the character using "\xHH".

Example:

In the case of Shift JIS, to specify a fullwidth character "あ", specify "\x82\xA0".

Comment

Comment about each key setting.

Key category (when Separate settings is selected)

Selects whether the key value is specified in characters or in hexadecimal notation.

Character

: Specify the key value in characters. We recommend you to choose Character when character-based data, such as type M and type X, is selected as the key value.

Binary

: Specify the key value in hexadecimal notation. We recommend you to choose Binary when binary-based data, such as type I and type B, is selected as the key value.

Extension

: Specify the key value as an ASCII character string. If you want to specify the key value by any of the following, select Extension:

  • Specifying a regular expression for the key value

  • Using \xHH notation to escape hexadecimal characters in the key value

  • Specifying a key value of 21 bytes or more

Note

  • When "Kanji code type" for the input settings is "JIS" and "Field type" for "Key value" is "M", set to "Binary" or "Extension".

  • When the encoding is set the one of the following value, to specify a regular expression for the key value, use the \xHH notation (where H denotes a hexadecimal character) for characters inside the expression.

    • EBCDIC

    • JIS

    • UTF-16

Scope of keys

Specify the scope of key value set to record with 1 to 256 (the unit is bytes).

Specify it when Extension is specified for Key category.

Example 1:

To specify "start position is 1" and "three bytes that begin with A" as the key value, specify "3" in Scope of keys.

Start position

: 1

Key value

: ^A

Scope of keys

: 3

Example 2:

To specify "start position is 5" and "four numeric characters" as the key value, specify "4" in Scope of keys.

Start position

: 5

Key value

: ^\d+$

Scope of keys

: 4

Note

If Extension is selected, part of data is read up to the number of bytes specified in Scope of keys, and then a regular expression search is performed over the part. If the data part of the specified number of bytes is successfully read and the regular expression matches the part, the search results in a match.

(Example) When Scope of keys and Key value are set to 5 and "ab", respectively:

  • If the read part is 5 bytes long and stores "12ab3" value,

    Because the "12ab3" value matches the regular expression "ab", the search result is a match.

  • If the rest of the data is 4 bytes long and stores "12ab" value,

    Because the part does not reach the specified size, the search result is a non-match.

Conditional logic formula

If you use multiple key settings, use key settings numbers (such as 1, 2, and 3) to identify the setting entry in the conditional logic formula. You can use logical operators, AND (logical product) and OR (logical sum), parentheses, '(' (left parenthesis) and ')' (right parenthesis), and a space character.

Default format

The format ID used when the key in the data does not match the key value that was set by using multi format information If the default format ID is set, and if the key within the data does not match the key that was set by using multi format data, the format information of the default format ID is used. If the default format ID is not set, and if the key does not match, a conversion error occurs.

(2) Fields for Multi Format Information Field Settings(when unified settings is selected)

Format ID

The format ID used when the key matches.

Specify the ID registered in the format information.

Key value

See Fields settings (1) Fields for Multi Format - Detailed Information

Comments

See Fields settings in (1) Fields for Multi Format - Detailed Information.

(3) Fields for Multi Format Information Field Settings(when separate settings is selected)

Format ID

The format ID used when the key matches.

Specify the ID registered in the format information.

Comments

See Fields settings in (1) Fields for Multi Format - Detailed Information.

Start position

See Fields settings in (1) Fields for Multi Format - Detailed Information.

Key category

See Fields settings in (1) Fields for Multi Format - Detailed Information.

Scope of keys

See Fields settings in (1) Fields for Multi Format - Detailed Information.

Key value

See Fields settings in (1) Fields for Multi Format - Detailed Information.

Conditional logic formula

See Fields settings in (1) Fields for Multi Format - Detailed Information.

(4) Fields for Import HULFT settings

The same function is supplied in format information.

Name of host to connect to

Specify any name in order to identify the connection host.

Request acknowledge port No.

The number of port that receives requests for the HULFT started up by the connection host.

Specify a value from 1 to 65535.

records

The number of records of multi-format information to be imported.

ID

The multi format information ID read from HULFT.

Comment

Comment registered in the multi format information.

Note

If you are using HULFT Ver.8.4.0 or later, and "1" (Enabled) is specified for "Forced Strong Key Mode (strongkeymode)", you cannot connect to HULFT from DataMagic.