Specifying Values for a Document Variable with No Defined Content
If the Document variable has no defined content, you can add String name/value pairs and then assign values.
Use the following procedure to specify values for a Document variable. You perform this procedure from:
The
Input tab if you are working with a launch configuration
The
Enter Input for serviceName dialog box if you are running or debugging a service
The
Enter Input for variableName dialog box if you are assigning a value to a pipeline variable
To specify String name/value pairs for a Document variable with no defined content
1. Select the Document variable that has no defined content.
Designer displays a document viewer at the bottom of the screen. You use the document viewer to add String name/value pairs.
2. Do the following to append, insert, and delete String name/value pairs:
To... | Do this... |
Append a name/value pair to the end | Click Add Row. |
Insert a name/value pair in the middle | In the document viewer, select the name/value pair below where you want to add the new one and click Insert Row |
Remove a name/value pair | Select the name/value pair in the document viewer and click Delete Row |
3. For each name/value pair you added, in the Name column type a name.
Note:
If you leave a Name column empty, Designer will discard the row.
4. For each name/value pair you added, in the Value column type a value:
If you want to assign a literal value, type a String value.
If you want to derive the value from a String variable in the pipeline, type the name of that variable enclosed in % symbols (for example,
%Phone%).
You can mix literal and pipeline variables. For example, if you specify
(%areaCode%) %Phone%, the resulting String would be formatted to include the parentheses and space. If you specify
%firstName% %initial%. %lastName%, the period and spacing would be included in the value.
5. If you assigned a value using the % symbol along with a pipeline variable (for example, %Phone%), select the Perform pipeline variable substitution check box so that the server performs variable substitution at run time.
Note:
The Perform pipeline variable substitution check box is not available when using a launch configuration.
6. If you want Integration Server to use the value you specified only when the variable does not contain a value at run time, clear the Overwrite pipeline value check box. (If you select this check box, Integration Server will always apply the value you specified.)
Note:
The Overwrite pipeline value check box is not available when using a launch configuration.
7. After assigning values, do one of the following:
If you are working with a launch configuration, click
Apply on the
Input tab to save the value you entered. You can continue to specify values or click
Run to execute the service.
If using the
Enter Input for serviceName dialog box, continue to specify input values, or if you are finished, click
OK to close the dialog box and execute the service.
If using the
Enter Input for variableName dialog box, click
OK to close the dialog box.