Returns a link to an item in the given channel.

Syntax

Smartsite SXML	Copy Code
locator channel.crosslink(locator item, string channelCode) locator channel.crosslink(locator item, string channelCode, boolean isRelative) locator channel.crosslink(locator item, string channelCode, boolean isRelative, enum aim) locator channel.crosslink(locator item, string channelCode, boolean isRelative, enum aim, enum aimOptions)

Smartsite SXML

Copy Code

locator channel.crosslink(locator item, string channelCode)
locator channel.crosslink(locator item, string channelCode, boolean isRelative)
locator channel.crosslink(locator item, string channelCode, boolean isRelative, enum aim)
locator channel.crosslink(locator item, string channelCode, boolean isRelative, enum aim, enum aimOptions)

Parameters

Name	Data Type	Description
item	Locator	The item code or number.
channelCode	String	The channel code to produce the link for.
isRelative	Boolean	True if the path must be shown as relative, false if an absolute Url should be shown.
aim	Enum	The AIM settings. Enum values: Off No AIM scan. Normal Automatically determine the source, meaning that relations are added to the actual rendered page being rendered. Autonomous Forces Autonomous registration of the relation as a relation of the source item itself, even if the source is a Translation or a RenderTemplate.
aimOptions	Enum	The aim relation options. Default: automatically determined. Enum values: Auto Automatic determine AIM link type. Softlink Soft link. Hardlink Hard link.

Return Value

Data Type	Description
Locator	Url to the specified item.

Examples

Embed Example

This is a snippet from the default render template in our test site. The results for the current item as rendered on the Functional test channel (FUN) are embedded in the page, followed by the expected result.

The actual render template includes JavaScript that compares the two results and changes the background colour of the divs to reflect a passed or failed test.

Smartsite SXML	Copy Code
<h3 class="section">Actual Result</h3> <se:embed whitespace="remove"> <se:parameters> <se:parameter name="location"> {channel.crosslink(itemdata.number(),FUN)} </se:parameter> <se:parameter name="resultformat"> <code id="actualresult" class="sxml bggray">{sxml.encode(string.xmldecode(this.result(), 'xml'), false)}</code> </se:parameter> <se:parameter name="error" whitespace="preserve"> <code id="actualresult" class="sxml bggray">EXCEPTION: {string.tolower(this.error.innerexception.type(), whitespace=preserve)}</code> </se:parameter> <se:parameter name="default"> <code id="actualresult" class="sxml bggray"></code> </se:parameter> </se:parameters> </se:embed> <h3 class="section">Expected Result</h3> <se:viewsource whitespace="remove" recurse="true"> <se:parameters> <se:parameter name="xml"> {itemdata.rawfield('expectedresult')} </se:parameter> <se:parameter name="resultformat"> <code id="expectedresult" class="sxml bggray">{this.result()}</code> </se:parameter> <se:parameter name="default"> <code id="expectedresult" class="sxml bggray"></code> </se:parameter> </se:parameters> </se:viewsource>

Smartsite SXML

Copy Code

<h3 class="section">Actual Result</h3>
<se:embed whitespace="remove">
    <se:parameters>
        <se:parameter name="location">
            {channel.crosslink(itemdata.number(),FUN)}
        </se:parameter>
        <se:parameter name="resultformat">
            <code id="actualresult" class="sxml bggray">{sxml.encode(string.xmldecode(this.result(), 'xml'), false)}</code>
        </se:parameter>
        <se:parameter name="error" whitespace="preserve">
            <code id="actualresult" class="sxml bggray">EXCEPTION: {string.tolower(this.error.innerexception.type(), whitespace=preserve)}</code>
        </se:parameter>
        <se:parameter name="default">
            <code id="actualresult" class="sxml bggray"></code>
        </se:parameter>
    </se:parameters>
</se:embed>
<h3 class="section">Expected Result</h3>
<se:viewsource whitespace="remove" recurse="true">
    <se:parameters>
        <se:parameter name="xml">
            {itemdata.rawfield('expectedresult')}
        </se:parameter>
        <se:parameter name="resultformat">
            <code id="expectedresult" class="sxml bggray">{this.result()}</code>
        </se:parameter>
        <se:parameter name="default">
            <code id="expectedresult" class="sxml bggray"></code>
        </se:parameter>
    </se:parameters>
</se:viewsource>

Smartsite SXML	Copy Code
{url.setparameters(channel.crosslink(SAMPLEDATA, DEF), 'a=1','b=2','c=3')}

SXML