The NewDownstreamAlternate action enables you to specify an existing downstream iteration and create a new iteration at the downstream branch. You can create the new downstream alternate only within the same view and BOM type as that of the existing downstream iteration. You can specify a single or multiple existing downstream iterations to create new iterations in the downstream structure. You can create a new iteration using inline or specific upstream and downstream navigation criteria.

You can also create the new downstream alternate in the context of change (change task or change notice).

See the Creating Alternate BOMs topic in the Windchill Help Center, for more information.

The attributes in the request payload of the NewDownstreamAlternate action are described in the following table:

The request creates a new iteration at the downstream branch from the specified existing downstream iteration. The request retains the equivalence between the specified existing downstream iteration and its upstream equivalent iteration. The same equivalence persists between the new downstream iteration and the upstream iteration. The request also returns information for the equivalence link.

If child parts exist for the specified existing downstream iteration, the request retains the equivalence link between each child part in the existing downstream iteration and in the upstream equivalent iteration. The request retains the equivalent links between the downstream and upstream equivalent child parts according to the specified child structure option.

For example, the response to the request URI is as follows:

The attributes in the response for the NewDownstreamAlternate action are described in detail in the following table: