Siebel Interactive Designer API Reference > Pageset Functions > BuildTarget >

Optional Subconfiguration Link Output Targets

Set the type argument for the BuildTarget function to OPT_SUBCONFIG_LINK to create an optional subconfiguration link output target. Use an optional subconfiguration link output target when a pageset is used for both a subconfigured item and a standalone item.

For example, if your application allows users to build fast food value meals, suppose that a user wanted to buy a drink without purchasing any food. By using an optional subconfiguration target link to the parent pageset on the DRINK pageset, the same DRINK pageset could be used, regardless of whether the person is ordering a value meal.

A subconfiguration link back to the parent is not appropriate unless the user arrives at the pageset from a parent pageset. The optional link does not appear unless the user arrives from a parent pageset.

The syntax to create an optional subconfiguration link output target is:

BuildTarget("OPT_SUBCONFIG_LINK",window,instanceName,preText,postText)

NOTE:  Pagesets must be located in the application pg subdirectory.

Example

Use the following sample code:

<SCRIPT>

document.write(ISS.BuildTarget("OPT_SUBCONFIG_LINK"
window, "PARENT","<TR><TD>","Link to Burger Meal</A>
</TD></TR>"));

</SCRIPT>

returns:

"<TR><TD><a HREF="javascript:InstanceWrapper ('PARENT','window')">Link to Burger Meal</A></TD>
</TR>"

if there is a parent. If there is not a parent, it returns an empty string (" ").