5.4.2 How to use Data Store Plugin parts
To use Data Store Plugin parts, you place one such part in the guide area that contains the Guide Part whose input value you want to pass. You place another in the guide area that contains the Guide Part that is to receive the input value. Data Store Plugin parts are useful when:
-
You want users to be able to check input and selection results as they perform a task
-
You want to reduce the number of input and selection tasks the user has to perform
- Tip
-
Although users cannot enter data in a static-text part, a string displayed as static text can be passed as an input value by a Data Store Plugin part.
If you draw a mapping line from the output side of a Data Store Plugin part to a static-text part for which no displayed string is specified, it displays the input value of the Guide Part connected to the corresponding input parameter. You can, for example, use this approach to display a value entered in a text box in Process Node A as static text in Process Node B.
The following table describes the values input to or output from the Data Store Plugin for each type of Guide Part.
Guide Part type |
Value input to Data Store Plugin |
Result output to Guide Part |
---|---|---|
Static text |
The character string displayed as static text. |
The character string is output as the static text. |
Text box |
The character string entered in the text box. |
The character string is output to the text box. |
Text area |
The character string entered in the text area. |
The character string is output to the text area. |
Radio button |
The value of the selected radio button. |
The corresponding radio button becomes selected. |
Check box |
One of the following values, depending on whether the check box is selected:
|
The check box becomes selected if the value is true. For any other value, the check box remains cleared. |
Drop down |
The value of the selected list entry. |
The value corresponding to the selected list entry is output. |
Hyperlink |
A value consisting of the anchor text and URL specified in the Attribute Settings window connected by a linefeed code (\r\n). |
A value#1 is output consisting of the anchor text and URL connected by a linefeed code (\r\n). |
Image |
A value#2 consisting of the image URL and description (the value in the Tool tip text box) specified in the Attribute Settings window connected by a linefeed code (\r\n). |
A value#3 is output consisting of the image URL and description (the value in the Tool tip text box) connected by a linefeed code (\r\n). |
Inline frame |
The URL used to display the inline frame. |
The URL used to display the inline frame is output. |
HTML |
A character string that encodes the name and value attributes for text boxes, password boxes, hidden fields, check boxes, radio buttons, selection boxes, and text areas specified in the HTML source string area for the HTML part. |
The value set in the HTML source string area for the HTML part is output. |
- #1
-
Note the following regarding the output value:
-
An empty character string is output if the value is null, an empty character string, or consists only of a linefeed code.
-
If the value does not contain a linefeed code, the entire string is processed as anchor text (an empty character string is output for the URL component).
-
If the value contains two or more linefeed codes, the values on the third and subsequent lines are ignored.
-
- #2
-
If the Tool tip text box was left blank (an empty character string), the input value will be the URL followed by a linefeed code (\r\n). Take care not to include the linefeed code if your intention is to extract only the URL.
- #3
-
Note the following regarding the output value:
-
An empty character string is output if the value is null.
-
If the value does not contain a linefeed code (\r\n), the entire string is processed as a URL. An empty character string is output for the tool tip component.
-
If the value contains two or more linefeed codes, the values on the third and subsequent lines are ignored.
-