1.3.1 Format dialog

Use the [Format] dialog to specify a format name or character code for a binary format definition file.

For operating procedure, see "4.4.3 Defining Elements (for Non-CSV Format) " in "Service Platform Basic Development Guide".

Figure 1-35 Figure [Format] dialog

[Figure]

[Information]
If there is any problem in the information entered in the [Format] dialog, a message indicating the problem is displayed in the top part of the dialog. For details on the messages displayed and the measures to be taken, see "4.4.6 Validating the binary format definition file" in "Service Platform Basic Development Guide".
[Format name]
Specify a format name for the binary format definition file. Specify a name having maximum 256 characters that can be used in the NCName format.
[Character code]
From the drop-down list, select the character code to be used for binary data.
The following table describes the type of character codes that you can select. For details on character codes, see "Appendix A. Character Code Mapping".

Table 1-8 TableCharacter code types that can be selected

Character code typeCode systemRange of character that are supportedSupplement
MS932SJISUCS-2Microsoft code page 932
However, IBM selected characters, NEC specified IBM extended characters are not included. If you want to use IBM selected characters, NEC specified IBM selected characters, then the user mapping definition is required.
UTF8UnicodeUCS-4#1Unicode UTF-8 encoding#2
UTF16_BIGUnicodeUCS-2Unicode UTF-16 encoding #2 handled in Big Endian.
UTF16_LITTLEUnicodeUCS-2Unicode UTF-16 encoding#2handled in Little Endian.
JISJIS Kanji codeUCS-2JIS X 0208-1983
KEIS+EBCDICKEISUCS-2KEIS'83, and EBCDIC for single byte alphanumeric characters
KEIS+EBCDIKKEISUCS-2KEIS'83, and EBCDIK for single byte alphanumeric characters
KEIS#3KEISUCS-2KEIS'83 exclusive of single byte alphanumeric characters and Katakana
IBM_CODE+EBCDIC(LATIN)IBM Kanji codeUCS-2IBM Kanji code + Standard or extended lowercase character set
IBM_CODE+EBCDIC(KANA)IBM Kanji codeUCS-2IBM Kanji code + Standard or Extended Katakana set
IBM_CODE#3IBM Kanji codeUCS-2IBM Kanji code (Does not include one byte alphanumeric characters and Katakana)
JEF+EBCDICJEFUCS-2JEF Kanji code + JEF EBCDIC
JEF+EBCDIKJEFUCS-2JEF Kanji code + JEF EBCDIK
JEF#3JEFUCS-2JEF Kanji code
CUSTOMCharacter code conversion UOCUCS-2External program created by the user to convert the character code
#1
Since the mapping process (XLST) is processed by encoding in UTF-16, Unicode supplementary characters (0x10000~0x10FFFF) are encoded in surrogate pair.
#2
Data with BOM cannot be handled. BOM (Byte Order Mark) is the code expressing the order of data bytes.
#3
Cannot be used in CSV format.

[Process when replacing undefined code]
If telegram-undefined-character-code=REPLACE (replace the undefined part of character code with Space) is specified in HCSC server runtime definition file, select one of the following space replacing methods.
  • [Replace with single byte or double byte space]
    Undefined characters are replaced with single byte or double byte space as described in the following table:
    Binary character codeType of space after replacing
    MS932Single byte space
    UTF8Single byte space
    UTF16_BIG
    UTF16_LITTLE
    Single byte space
    JIS
    • Double byte space if escape status is JISC6226_1978, JISX0208_1983, JISX0212_1990
    • Single byte space if escape status is JISX0201_LATIN, JISX0201_JIS8, ASCII
    KEIS+EBCDIC
    KEIS+EBCDIK
    • Single byte space if shift state is single byte
    • Double byte space if shift state is double byte
    KEISDouble byte space
    IBM_CODE+EBCDIC(LATIN)
    IBM_CODE+EBCDIC(KANA)
    • Single byte space if shift state is single byte
    • Double byte space if shift state is double byte
    IBM_CODEDouble byte space
    JEF_EBCDIC
    JEF_EBCDIK
    • Single byte space if shift state is single byte
    • Double byte space if shift state is double byte
    JEFDouble byte space
  • [Replace with double byte space]
    Replace all with double byte space.
[Binary integer endian]
Use the radio button to select the appropriate binary integer endian to be included in the binary data.
You can select this item only when the binary data to be used is not in CSV format.
[Custom definition of numeric values in pack format]
Custom definition of numerical values in pack format is applied when the specifications in the [Simple contents element] dialog satisfies all the following conditions:
  • [Numeric value in pack format] is selected in [Data type]
  • [Custom] is selected in [Code specification]
  • [Exists] is selected for [Code existence]
[Bit value (hexadecimal)]
Specify the coding bit for numeric value in pack format in hexadecimal.
  • [Plus code]
    Specify the plus code bit of numerical values in pack format in alphanumeric hexadecimal.
  • [Minus code]
    Specify the minus sign bit of numerical values in pack format in alphanumeric hexadecimal.
  • [No code]
    Specify no code bit (absolute value) of numerical values in pack format in alphanumeric hexadecimal.
[Custom definition of numeric values in zone format]
The custom definition of numeric values in zone format are applied when the settings in [Simple contents element] dialog satisfy all the following conditions:
  • [Numeric value in zone format] is selected in [Data type]
  • [Custom] is selected in [Code specification]
  • [Exists] is selected for [Code existence]
[Bit value (hexadecimal)]
Specify the bit value of zone format numbers in hexadecimal.
This is applied when [Code specifications] is [Code bit].
  • [Plus code]
    Specify the plus code bit of numerical values in pack format in alphanumeric hexadecimal.
  • [Minus code]
    Specify the minus sign bit of numerical values in pack format in alphanumeric hexadecimal.
  • [No code]
    Specify no code bit (absolute value) of numerical values in pack format in alphanumeric hexadecimal.
  • [Zone]
    Specify the zone bit of zone format numbers in alphanumeric hexadecimal.
[Code character (hexadecimal)]
Specify the characters that express code in zone format numbers, in hexadecimal.
This is applied when [Code specifications] is [Code character].
  • [Plus code]
    Specify plus code characters in 1-2 digit alphanumeric hexadecimals.
  • [Minus code]
    Specify minus code characters in 1-2 digit alphanumeric hexadecimals.
[Separator]
[Escape character]
Specify the characters to be used as escape characters when characters used as separators are included in the data. You can use single Latin characters (0x21 to 0x7E of JIS X 0201) or single-byte spaces (0x20 of JIS X 0201) as escape characters.
This item can be specified when the binary data to be used is not in CSV format
[Line feed code]
Select the linefeed characters to be used as separators from the drop-down list. The linefeed codes that you can use are CR+LF, or LF.
[Delete extra separators] checkbox
Select this checkbox to output the last separator.
[CSV format]
[Enclose the output in double quotes (")] checkbox
Select this checkbox to enclose data items in double quotes (").
[OK] button
Commits the specified contents and closes the [Format] dialog.
[Cancel] button
Closes the [Format] dialog, without committing the specified contents.