Standard Tags
Tag gatewaylink


This tag allows you to build gatewayed links to remote pages and include references to associated portal objects, usually a portlet or community. When the link is executed, the portal sends any preferences associated with the referenced object to the remote server.

Example:
The code below creates a link to a remote page associated with the portlet with ID 201.

<pt:standard.gatewaylink class="myStyle" pt:objectid="201" pt:href="doStuff.aspx?ID=5">Click here</pt:standard.gatewaylink>

The arguments in the resulting URL tell the portal to send the preferences associated with the portlet to the remote server. The code is replaced with a link of the following form:

<a href="http://portal.plumtree.com/portal/server.pt/gateway/PTARGS_0_0_201_0_0_43/doStuff.aspx?ID=5" class="myStyle">Click here</a>

The code below creates a link to a page associated with the Web Service with ID 200, and also sends the Community preferences from the Community with ID 301 to the remote server.

<pt:standard.gatewaylink pt:href="http://myRemoteServer/myTestPage.jsp" pt:objectid="200" pt:classid="47" pt:communityid="301">Click here</pt:standard.gatewaylink>

You can use the pt:gatewayLink tag to gateway documents that have not been crawled or uploaded to the portal using the ID for the associated WWW Data Source, as shown in the code below.

<pt:standard.gatewaylink pt:href="http://myRemoteServer/mydocs/WhitePaper2002.doc" pt:objectid="202" pt:classid="35">WhitePaper2002</pt:standard.gatewaylink>


Tag Information
Tag Namegatewaylink

Attributes
NameTypeRequiredDefault ValueDescription
communityidintfalse0The ID of the associated Community. The Community preferences from this Community will be sent to the remote server.
pageidintfalse0The ID of the associated page (can be positive or negative).
objectidinttruenullThe ID of the portal object referenced in the Class ID attribute (i.e., the User or Community ID). To access the object ID, use the PRC.
classidintfalse43The portal object type. The default is portlet (43). This tag also supports cards (18), Data Sources (35), and Web Services (47).
hrefstringtruenullThe URL to the remote page. If you pass in a relative URL, the portal will use the configuration settings for the referenced portal object to create the gatewayed URL.


Copyright 2005 Plumtree Software, Inc.