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 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

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 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.

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.