ssLINK ssNODELINK Using Token Links

Link Formats 4-5

4.4 Using Token Links

Token links also known as late-resolving links are not resolved until they are actually clicked. View source would reveal a URL that has ssLINK or ssNODELINK in the URL. Token links are not resolved until they are clicked thus the term late-resolving, as the link resolution happens after the page is served. By comparison, the script links are resolved on the server before serving the Web page. You should be aware that ssLINK and ssNODELINK are token links; although ssLink and ssNodeLink have the same name as ssLINK and ssNODELINK, the camel case ssLink and ssNodeLink are script links. Token links are a recommended way of including a link in a native document. Because the Word doc goes through Dynamic Converter and converts to HTML, it is much easier to write them with token links. It is possible otherwise, but this way is simpler. This section contains these topics: ■ Section 4.4.1, ssLINK ■ Section 4.4.2, ssNODELINK ■ Section 4.4.3, Token Links Generated From Returned Server-Side Links

4.4.1 ssLINK

Used to create a late-resolving link to a data file. Unlike ssLink, the late-resolving link is not resolved until the link is clicked. Parameters ■ dDocName : the dDocName of the managed item. If only one parameter is specified, it is assumed to be the dDocName. ■ targetNodeId : a unique identifier for a node to use as the target context optional. ■ targetSiteId : the unique identifier for the web site to use as the target context optional. If you do wish to specify a targetSiteId, you must also specify the targetNodeId. Examples Before evaluation: --ssLINKdDocName-- Evaluated by the server: a href=ssLINKdDocName Note that the ssLINK is still in the URL. It will be visible this way to any browser, either by hovering on the link or by viewing the source. Once the link is clicked, the Oracle Content Server will evaluate the dDocName, determine what the friendly URL would be, and redirect to it. 4-6 Oracle Fusion Middleware Technical Reference Guide for Site Studio

4.4.2 ssNODELINK

Used to create a late-resolving link to a web site section. Parameters ■ nodeId : a unique identifier for a node. If only one parameter is specified, it is assumed to be the nodeId. ■ siteId : a unique identifier for the web site containing the node optional. If you specify a siteId, you must specify a nodeId. Examples Before evaluation: --ssNODELINK10027-- Evaluated by the server: a href=ssNODELINK10027 Note that the ssNODELINK is still in the URL. It will be visible this way to any browser, either by hovering on the link or by viewing the source. Once the link is clicked, the Oracle Content Server will evaluate the nodeId, determine what the friendly URL would be, and redirect to it.

4.4.3 Token Links Generated From Returned Server-Side Links