Siebel Interactive Designer API Reference > Pageset Functions > BuildTarget >

Link Output Targets


Set the type argument for the BuildTarget function to LINK to create a link output target. The table column specified by the name argument can contain pageset IDs or URLs. The isPage argument defines how the data is handled. The dynDefCol argument points to a column that contains information that dynamically overrides the defaults of the specified pageset.

The syntax used to create a link output target is:

BuildTarget("LINK",window,name,isPage[,dynDefCol])

Argument
Description

name

Column in a Configuration table or Feature table that contains pageset IDs or URLs.

isPage

This optional argument is a Boolean value that determines whether data in the column identified by the name argument is a pageset (TRUE) or a URL (FALSE). If the data is a URL and you set the argument to FALSE, the URL loads into a separate window, instead of inside the main application, when you click the link output target.

dynDefCol

This optional argument is a string that specifies the name of a table column (or columns, separated by commas) in which a preconfigured condition is defined for the pageset.
When you click a link target containing a preconfigured condition, the application overrides the default settings of input UI controls in the pageset being loaded with the settings defined in the preconfigured condition.
The definition of a preconfigured condition must contain the name of the overriding Feature table and the feature (CODE) value of the desired override setting.
If you define a preconfigured condition column in a Configuration table, the dynDefCol argument references only the name of the Configuration table column whose values override the defaults.
If you define a preconfigured column in a Feature table, the dynDefCol argument must contain the name of the Feature table and the name of the specific column inside of it whose values override the defaults, separated by a dot (as in COLOR.PRECONFIG).

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

Example

The following sample code creates a link output target based on a Configuration table column named CLINK:

<SCRIPT>

document.write(ISS.BuildTarget("LINK",window,"CLINK",
true));

</SCRIPT>If you liked this thing, you'll definitely like these other things.</a>

When the user selections match a valid configuration, a pageset ID in the CLINK column is returned. When the user clicks the button, the pageset is loaded and displayed in the application.


 Siebel Interactive Designer API Reference 
 Published: 18 April 2003