Software AG Products 10.7 | Integrating On-Premises and Cloud Applications | Service Development | Mapping Data in Flow Services | About Linking Variables | Linking to Document and Document List Variables
 
Linking to Document and Document List Variables
When working with Document variables in the pipeline, you can link a source variable to the Document variable or to the children of the Document variable. Keep the following points in mind when linking to or from Document, Document List, Document Reference, or Document Reference List variables:
*A Document (or a Document List) and its children cannot both be targets. After a Document or Document List is the target of a link, its children cannot be the targets of links.
*After the child variable of a Document or Document List is the target of a link, the parent Document or Document List cannot be a target of a link.
*If you link from a Document variable to another Document variable, the structure of the source Document variable overwrites the structure of the target Document variable.
*You cannot link a nested Document List to a target Document List when the Document Lists have different sizes. A nested Document List is one that is contained within a parent Document List. Document Lists are considered to have different sizes when they have a different number of entries within the lists. If you need to move values from the source Document List to the target, create user code that uses a LOOP flow step to assign values from the source to the target one by one.
*When a Document Reference or Document Reference List refers to an IS document type that contains identically named variables that are of the same data type and both identically named variables are assigned a value or are linked to another variable, Integration Server might not maintain the order of the document contents in the pipeline when the service executes. For example, Integration Server might group all of the identical variables at the end of the document. To prevent the change in the order of document contents, set default values for the identically named variables. To do this, insert a MAP step in the service before the step in which you want link or assign a value to the variables. In the MAP step, under Pipeline Out, select the Document Reference variable and click on the Pipeline view toolbar. In the Enter Input for dialog box, assign default values to the identically named variables.