1.6.17 Acquire Substring Dialog

In the Acquire Substring dialog, specify a substring to be acquired from a string.

This dialog opens when you perform one of the following operations:

The following figure shows the Acquire Substring dialog.

Figure 1-113 FigureAcquire Substring dialog

[Figure]

Organization of this subsection
(1) Displayed items
(2) Operations that can be performed in this dialog

(1) Displayed items

Input
Specify the source node and function from which a substring is to be extracted. If an extraction source is already mapped to substring acquisition, that extraction source is displayed.
For details about the display format in Input, see the description for the display format of the mapping source in the manual Cosminexus Service Platform Development Guide.
Select Node button
The Node Selection dialog opens. Click this button to specify in Input a source node from which a substring is to be extracted.
For details about the Select Node dialog, see 1.6.6 Select Node Dialog (Data Transformation).
Set Node Condition button
The Set Node Condition dialog opens. Click this button to specify a condition for the source node and allow mapping to take place only when that condition is satisfied.
For details about the Set Node Condition dialog, see 1.6.9 Set Node Condition Dialog. For details about how to set up the conditions for transformation source nodes, see the description of node condition settings in the manual Cosminexus Service Platform Development Guide.
Select Function button
The Select Function dialog opens. Click this button to specify in Input a function from which a substring is to be extracted.
For details about the Select Function dialog, see 1.6.7 Select function dialog.
Acquisition method
Specify range from left side radio button
Select this button to specify the extraction range from the start of the string.
Start position
Specify the start position of the substring to be extracted. A surrogate pair is handled as two characters.
Count
Specify the character count of the substring to be extracted, in the range between 0 and 2,147,483,647. A surrogate pair is handled as two characters.
Acquire from start position to end of string check box
Select this check box to extract the substring that begins at the start character specified in Start position to the end of the string.
Specify range from end radio button
Select this button to specify the extraction range from the end of the string.
Start position
Specify the start position of the substring to be extracted.
Count
Specify the character count of the substring to be extracted, in the range between 0 and 2,147,483,647.
Acquire from start position to beginning of string check box
Select this check box to extract the substring that begins at the start character specified in Start position to the beginning of the string.
Specify division string radio button
Select this button to divide a string into two segments and specify either the initial or subsequent segment.
Division string
Specify a string to use for dividing the string in the mapping source. A maximum of 1,024 characters can be specified.
Acquired Part
Select either Pre or Post.
  • Pre
    Acquires the substring that begins at the beginning character and ends at the character preceding the string specified in Division string.
  • Post
    Acquires a string succeeding the string specified in Division string.
OK button
Commits the specified contents and closes the dialog.
Cancel button
Cancels the specified contents and closes the dialog.

(2) Operations that can be performed in this dialog

In the Acquire Substring dialog, you can set up the acquire substring function. For details about how to set up the acquire substring function, see the description for processing values using functions in the manual Cosminexus Service Platform Development Guide.