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
To specify values for a Document List variable
1. Select the Document List 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 | |
String List | |
String Table | |
Document Document Reference | |
Document List Document Reference List | |
Object | |
Object List | |
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.
6. 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.