Specifying Values for a Document List Variable

You can assign values to Document List variables that have defined content, including referenced document lists. When setting values, if part of a document tree is collapsed, you can expand.

Tip: Click

to view and/or update your preferences for how Designer displays and expands the contents of Document variables.

Use the following procedure to specify values for a Document List 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

2. Do the following to append, insert, and delete Documents within the Document List:

To...	Do this...
Append a Document to the end of the list	Click Add Row.
Insert a Document into the middle of the list	Select the Document below where you want to add the new one and click Insert Row
Remove a Document from the list	Select the Document and click Delete Row

3. Assign values to the Document variables you added to the list.

How you assign values is based on the data type of a variable. For help for how to specify a value for the variable, see one of the following:

For this type of variable...	See...
String	Specifying a Value for a String Variable
String List	Specifying Values for a String List Variable
String Table	Specifying Values for a String Table Variable
Document Document Reference	Specifying Values for a Document Variable that Has Defined Content or Specifying Values for a Document Variable with No Defined Content
Document List Document Reference List	Specifying Values for a Document List Variable
Object	Specifying a Value for an Object Variable
Object List	Specifying Values for an Object List Variable

4. For each top-level Document that you added to the Document List, select how you want to handle String variables within that Document that have no value.

If you want to use empty Strings (i.e., a String with a zero-length), select either the check box next to the top-level Document in the tree or the Include empty values for String Types check box. Designer will select both check boxes.

If you want to use null values, clear the check box next to the top-level Document in the tree or the Include empty values for String Types check box. Designer will clear both check boxes.

Designer allows you to define this setting for each Document within a Document List.

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