1.3.2 Simple content element dialog

Use the [Simple Content Element] dialog to specify simple content elements in the binary format definition file.

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

Tabs displayed in the [Simple Content Element] dialog differ depending on whether you specify globally or locally defined simple content elements.

Organization of this subsection
(1) Simple content element tab
(2) Component tab
(3) Contents common to both tabs

(1) Simple content element tab

The simple content element tab is displayed regardless of whether you specify globally or locally defined simple content elements. Use this tab to specify simple content element information.

Figure 1-36 Figure [Simple content element] dialog (simple content element tab)

[Figure]

[Data type]
Select the data type to be used for the simple content element from the drop-down list. The following table describes the data types that can be selected and the contents displayed in [Details]:
Data typeContents displayed in [Details]
StringSee "(a) In case of string type".
IntegerSee "(c) For integer, real numbers and numeric value with fixed decimal part".
Real number
Fixed decimal number
Numeric value in zone-format#See "(b) For numeric values zone-format and pack format".
Numeric value in pack format#
Signed binary integer#Nothing is displayed in [Details].
Unsigned binary integer#
Byte string#See "(d) For byte string type".
Bit string#Nothing is displayed in [Details].
Date/timeSee "(e) For date/time".
#
You cannot select these items when you handle binary data in CSV format.

[Size]
Specify a size for the data to be used as simple content elements.
  • For a fixed value
    Select the [Fixed] radio button and, specify a size.
    The range of sizes that can be specified differs depending on the data type and character code. The following table describes the range of sizes that can be specified:

    Table 1-9 Table Size ranges that can be specified for simple content elements with fixed values

    Data typeCharacter codeRange that can be specifiedUnit
    String, integer, real numbers, fixed decimal numberNot UTF161~2,147,483,647Byte
    UTF162~2,147,483,646Byte
    Numerical value in zone and packed format-1~2,147,483,647Byte
    Signed binary integer, unsigned binary integer-1~8Byte
    Byte string-1~2,147,483,647Byte
    Bit string-1~64Bit
    Date/timeCCYYMMDDNot UTF168~2,147,483,647Byte
    UTF1616~2,147,483,646Byte
    YYMMDDNot UTF166~2,147,483,647Byte
    UTF1612~2,147,483,646Byte
    hhmmssNot UTF166~2,147,483,647Byte
    UTF1612~2,147,483,646Byte
    CCYYMMDDhhmmssNot UTF1614~2,147,483,647Byte
    UTF1628~2,147,483,646Byte
    YYMMDDhhmmssNot UTF1612~2,147,483,647Byte
    UTF1624~2,147,483,646Byte
    Legend:
    -: Indicates that the range that you can specify is independent of the character code.

  • In case of a variable value
    Select the [Variable] radio button. Specify the size determination method in [Size] on the Component tab (or [Component] dialog).
[Details]
Contents displayed in [Details] differ depending on the contents selected in [Data type] as follows:
(a) In case of string type

The following figure shows the [Simple content element] dialog which is displayed when you have selected [String] in [Data type].

Figure 1-37 Figure [Simple content element] dialog (when you select "String" for [Data type] in the Simple content element tab)

[Figure]

[Individual character code]
Specify individual character code, if the character code of the data to be used as simple content element is different than the character code set in the [Format] dialog.
[Specify] checkbox
Check the checkbox, when you want to specify the individual character code.
[Format setting value]
The character code which you set in the [Format] dialog is displayed.
[Character code]
Select the character code to be specified from the dropdown list.
For details about character code types that can be selected, see Table 1-8 Character code types that can be selected. And for details about character codes, see"Appendix A. Character Code Mapping".
[Embedding]
If the data to be used as simple content element is smaller in size than the specified size, select the characters to fill the excess portion, from the dropdown list. Select [Space] to fill in a blank and select [Blank character (0x00)] to fill in blank characters (0x00).
[Consider characters till blank character (0x00) as data] checkbox
Check this checkbox to treat the characters till blank characters (0x00) as data.
You can specify this checkbox only when you have selected [Blank characters (0x00)], in [Embedding].
[Left-Right alignment]
Select the direction for aligning data with the [Left] or [Right] radio button. You can specify this item in case of one of the following:
  • When the [Consider characters till blank character (0x00) as data] checkbox is inactive
  • When the [Consider characters till blank character (0x00) as data] checkbox is activated and is not checked
[Unwanted characters]
Specify if the unwanted characters are to be deleted with this radio button. You can specify this item in case of one the following:
  • When the [Consider characters till blank character (0x00) as data] checkbox is inactive
  • When the [Consider characters till blank character (0x00) as data] checkbox is activated and is not checked
For details on how to delete unwanted characters, see "4.4.1 Types of data type and character code of binary format definition file" in "Service Platform Basic Development Guide".
[Unavailable characters]
Specify characters to be used in place of the characters in XML that cannot be used. The characters that cannot be used are as follows:
  • 0x00~0x1F (Except 0x09, 0x0A, 0x0D)
    Control code
  • 0xFFFE~0xFFFF
    Undefined characters (Use prohibited originally as Unicode)
[Substitute with a Replacement Character] checkbox
Select this checkbox to replace unavailable characters with replacement characters.
[Leading replacement character (Hexadecimal)]
Specify the replacement character to be used in hexadecimal. You can specify this item if the [Substitute with a Replacement Character] checkbox is selected.
If you specify the first character of a replacement character, the following 34 characters are used as replacement characters for 0x00 to 0x1F and 0xFFFE to 0xFFFF respectively. Specify hexadecimal without putting the prefix "0x". For example, in case of 0x2400, hexadecimal will be 2400.
The values that you can specify as leading replacement characters are as follows:
  • 0020~D7DE
  • E000~FFDC
The default value is 2400. These characters are not case-sensitive.
(b) For numeric values zone-format and pack format

The following figure shows the [Simple content element] dialog which is displayed when [Numeric value in zone format] or [Numeric value in pack format] is selected in [Data type].

Figure 1-38 Figure [Simple content element] dialog (when you select "Numeric value in zone format" or "Numeric value in pack format" for [Data type] in the Simple content element tab)

[Figure]

[Number of digits]
Specify the number of digits.
[Total] checkbox
Always passive for zone and pack format numeric values. As a result, you cannot specify a maximum value for the total number of digits.
[Decimal part] checkbox
You can specify the maximum value of digits in decimal part, in the range of 0~33.
[Code specification]
Select [Automatic] or [Custom] as the method for setting decimal code.
If you select [Custom], items specified in the [Format] dialog are used.
[Code existence]
Select [Does not exist] when you do not use code and select [Exists] when you use code.
You can specify this item if you have specified [Custom] in [Code specification].
[Code type]
Select [Code bit] to add the code with code bit and select [Code character] to add the symbol with code character.
You can specify this item if the following conditions are satisfied:
  • [Numeric value in zone format] is selected in [Data type]
  • [Custom] is selected in [Code specification]
  • [Exists] is selected in [Code existence]
[Code position]
Select [Before] to add the code before item and select [After] to add the code after item.
You can specify this item if the following conditions are satisfied:
  • [Numeric value in zone format] is selected in [Data type]
  • [Custom] is selected in [Code specification]
  • [Exists] is selected in [Code existence]
(c) For integer, real numbers and numeric value with fixed decimal part

The following figure shows the [Simple content element] dialog which is displayed when "Integer", "Real number" or "Fixed decimal number" is selected in [Data type].

Figure 1-39 Figure [Simple content element] dialog (when you select "Integer", "Real number" or "Fixed decimal number" for [Data type] in the Simple content element tab)

[Figure]

[Number of digits]
Specify the number of digits.
[Total] checkbox
If you select this checkbox, you can specify the maximum value for number of digits in a range of 1~34. The number of digits that you can specify differ as per settings for [Size] as follows:
  • If [Fixed] is selected in [Size]
    The total number of digits will be the total of the integer part, code, and decimal part.
    Note that when you specify a numeric value above 1 in the [Decimal part] of number of digits for a real number, the total number of digits includes the decimal point.
  • If [Variable] is selected in [Size]
    The total number of digits does not include the number of digits for code and decimal point.
[Decimal part] checkbox
If you select this checkbox, you can specify the maximum value for number of digits in the decimal part in a range of 0~33.
You can specify this item when data type is real number or numeric value with a fixed decimal part.
You cannot uncheck the checkbox, in case of numeric value with a fixed decimal part.
[Code existence]
When the data type is integers, real numbers or numeric value with a fixed decimal part, select the existence of plus and minus code with Radio button.
  • When there is no code
    Select [None].
  • When there is only a minus code
    Select [Only minus exists].
  • When there is always a plus or minus code
    Select [Always exists].
[Embedding]
When the data type is integer, real number or numeric value with fixed decimal part, and when the data to be used as simple content element is small in size than the specified size, select the characters to fill the excess portion from the dropdown list. Select [Space] when filling in a blank with space and select [0] when filling in a blank with 0.
[Left-Right alignment]
Select the direction for aligning data with the [Left] or [Right] radio button.
You cannot select [Left] radio button, when [Embedding] is set to [0].
[Unwanted characters]
Specify if the unwanted characters are to be removed with this radio button.
(d) For byte string type

The following figure shows the [Simple content element] dialog which is displayed when "Byte string" is selected in [Data type].

Figure 1-40 Figure [Simple content element] dialog (when you select "Byte string" for [Data type] in the Simple content element tab)

[Figure]

[Encoding format]
Set the hex Binary or base64Binary which is data type of schema, with radio button, as the encoding format.
(e) For date/time

The following figure shows the [Simple content element] dialog which is displayed when "Date/time" is selected in [Data type]:

Figure 1-41 Figure [Simple content element] dialog (when you select "Date/time" for [Data type] in the Simple content element tab)

[Figure]

[Date/time]
Specify the format of date/time for the date/time data type.
[Format]
Select a date/time format from the drop-down list.
[Decimal digits - seconds]
When the date/time format includes the time (hhmmss), specify a value between 0 and 3 for the number of decimal digits for the seconds.
[Left-Right alignment]
Select the direction for aligning data with the [Left] or [Right] radio button.

(2) Component tab

The Component tab is displayed only when you specify locally defined simple content elements. Use this tab to specify component information.

Figure 1-42 [Simple content element] dialog (Component tab)

[Figure]

The contents to be specified are same as the Component tab of the Component dialog.

For details about the component tab in [Component] dialog, see "1.3.4(3) Component tab (Simple content element)".

(3) Contents common to both tabs

The following contents are common to both tabs:

[Information]
If there is a problem in the information that is entered in the [Simple content element] dialog, a message indicating the problem is displayed in the title bar of the dialog. For details about the displayed messages and measures to be taken, see "4.4.6 Validating the binary format definition file" in "Service Platform Basic Development Guide".
[Name]
Specify a name for the simple content element. Specify a name that consist of not more than 256 characters that can be used in the NCName format.
[OK] button
Commits the specified contents and closes the [Simple content element] dialog.
[Cancel] button
Closes the Simple Content Element dialog without committing the specified contents.