Mass Copy Functoid

Use the Mass Copy functoid (Mass Copy Functoid Icon) to recursively copy all data in an input instance message, to arbitrary depth, that corresponds to a specified node in the source schema to the position in an output instance message that is specified by the output link.

Input

Parameter 1: A link from a Record or Field Element node in the source schema, which has an arbitrarily complex child node structure within it.

Output

Output 1: A link to a node in the destination schema, indicating the position within an output instance message into which to copy the element structure from the input instance message.

Remarks

One way to understand the Mass Copy functoid is to consider that you can completely map input instance messages to output instance messages, where both types of messages are described by identical schemas, by linking the root node of the source schema to the root node of the destination schema.

Note  The Mass Copy functoid only lets you connect nodes that have fixed names. If either node connected by the functoid has an undetermined name (like an ANY node), the functoid cannot generate the correct XSLT to do the copy.

This functoid is useful for mapping an Any Element or Any Attribute node from the source schema to the destination schema. For example, if you have a Record node named Src in the source schema and a Record node named Dst in the destination schema, and both of them have an Any Element or Any Attribute child node, then you can use the Mass Copy functoid to recursively copy the entire structure in an input instance message that corresponds to Src to the location in the output instance message that corresponds to Dst. To accomplish this, drag a Mass Copy functoid onto a grid page, connect the Record node named Src to the Mass Copy functoid to serve as its input parameter, and connect the Mass Copy functoid to the Record node named Dst to serve as the output of the functoid.

In general, you can use the Mass Copy functoid in this same way if the Record nodes Src and Dst, from the example above, have exactly the same structure in the source and destination schemas, respectively, regardless of whether the Any Element or Any Attribute nodes are present in those structures.

See Also

Advanced Functoids Reference

Advanced Functoids

Mass Copy Functoid

Adding Mass Copy Functoids to a Map

To download updated BizTalk Server 2004 Help from www.microsoft.com, go to http://go.microsoft.com/fwlink/?linkid=20616.

Copyright © 2004 Microsoft Corporation.
All rights reserved.
Show: