Addressing Portlets by Functional Name

Introduction

This page teaches you how to create links that point directly to content within the portal. This technique may also be referred to as external linking or deep linking. Direct links to tabs may be possible when the url redesign is complete in 3.2/3.3?

Dumb links

You can link to a portlet or channel using the functional name like so:

However, this only works as long as the user has a session or the channel is available in the Guest layout.

Authenticated links

To create a link that forces the user to authenticate through CAS and works whether the user has a session or not, do this:

The Login servlet looks for the uP_fname parameter and passes your user to that channel after authenticating.

Adding parameters

As of uPortal 3.0.4 and 3.1.0 (See UP-2308) the Login servlet passes any other parameters on to your channel.

Make sure to encode ampersands with %26, otherwise /cas/login will eat up your additional parameters without passing them to your service url; it doesn't hurt to url encode your entire service parameter either

Old Information

For more information, see Andrew Petro's blog post on addressing channels by functional name.
Some of the links in this post are dead.