Mass Copy Functoid

The Mass Copy functoid enables your maps to use schemas that include any and anyAttribute elements. These elements are, in essence, wildcards provided in the XML Schema definition language to match unknown structures or attributes.

In addition to handling data with unknown structure, the Mass Copy functoid enables you to simplify schema development: only the portions of a schema that will be processed need to be specified in detail.

The Mass Copy functoid copies the element in the input instance message corresponding to the source schema node connected to the Mass Copy functoid. The functoid also copies any and all of its substructure, and re-creates it in the output instance message at the linked node in the destination schema. Thus, you can also use the Mass Copy functoid to copy any source and destination records having identical substructures.

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.

The following figure shows the Mass Copy functoid used in a map.

Mass Copy Functoid Map

Consider the following input instance message.

<ns0:Root xmlns:ns0="http://MassCopy.ComplexDocument">
    <PurchaseOrder>
        <From>Kevin F. Browne</From>
        <To>Northwind Traders</To>
        <LineItems>
            <Item>
                <Product>Laptop Computer</Product>
                <Description>Thin profile laptop</Description>
                <Price>1999.95</Price>
                <Quantity>1</Quantity>
            </Item>
        </LineItems>
    </PurchaseOrder>
</ns0:Root>

If the preceding map were used to process this message, the output instance message would be identical to the input instance message.

See Also

Adding Mass Copy Functoids to a Map

Advanced Functoids

Basic Functoids

Links To and From the Any Element and anyAttribute Nodes

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: