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:
![*](bullet.gif)
The
Input tab if you are working with a launch configuration
![*](bullet.gif)
The
Enter Input for serviceName dialog box if you are running or debugging a service
![*](bullet.gif)
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:
![*](bullet.gif)
If you want to assign a literal value, type a String value.
![*](bullet.gif)
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%).
![*](bullet.gif)
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:
![*](bullet.gif)
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.
![*](bullet.gif)
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.
![*](bullet.gif)
If using the
Enter Input for variableName dialog box, click
OK to close the dialog box.