uCosminexus Service Platform, Basic Development Guide

[Contents][Glossary][Index][Back][Next]

6.13.4 SubstringObjects (Acquire substring function)

Acquire substring function (substr).

Organization of this subsection
(1) Definition items
(2) Definition example

(1) Definition items

Following table describes the definition items.

Table 6-29 TableSubstringObjects definition items

Item name Definition contents Value that you can define Additional description
Name Function name Value of NCName type This is mandatory item. You cannot define same Name in Objects, in duplication.
Input Input See "6.12.2 Setting up the mapping definition" -
Acquisition Specification item Either of "left", "right", "division" This is mandatory item.

In case of "left"
As specification method, set "Specify range from the beginning"

In case of "right"
As specification method, set "Specify range from end"

In case of "division"
As specification method, set "Specify division character string"
Start Start position Integer of 1~2,147,483,647 This is mandatory item when acquisition is "left" or "right".
In other cases, setting value is not incorporated.
Surrogate pair is handled as 2 characters.
Count Characters count Integer of 0~2,147,483,647 or space When Acquisition is "left" or "right" and Count is blank, set "all after start position".
When Acquisition is other than "left" and "right", setting value is not incorporated.
Surrogate pair is handled as 2 characters.
String Division character string Character string less than 1,024 characters (you cannot define linefeed) This is mandatory item when Acquisition is "division".
In other cases, setting value is not incorporated.
Part Acquisition position "pre" or "post" This is mandatory item when Acquisition is "division".
In other cases, setting value is not incorporated.

In case of "pre"
Set "Previous" as acquisition part.

In case of "post"
Set "Post" as acquisition part.

(Legend)
-: Corresponding item does not exist.

(2) Definition example

Following figure shows the definition example:

Figure 6-66 FigureSubstringObjects definition example1

[Figure]

Figure 6-67 FigureSubstringObjects definition example2

[Figure]

Figure 6-68 FigureSubstringObjects definition example3

[Figure]