Portal URL Aliases

Display rules can be based on the portal alias of the URL that was entered into the browser to access the portal.

A portal alias is the part of the URL after the section that specifies the portal J2EE application (irj), which by default is http://<server>:<port>/irj. Standard portal aliases are defined in the portal's J2EE deployment descriptor (web.xml) for specific use cases or scenarios.

If a user specifies an undefined alias, it is ignored.

The following is the format for a portal URL (where /<quick link> is optional):

http://<hostname>:<port>/irj/<alias>/<quick link>

For example, the portal alias for displaying the light framework page is portal/light, so the URL for accessing the portal with the light framework page is:

http://<hostname>:<port>/irj/portal/light

For information on incorporating portal URL aliases in a rule collection, see Defining Portal Display Rules.

Defining Custom Portal Aliases

You can define custom portal aliases for your own scenarios.

In addition to its use in display rules, a portal alias automatically sets system properties, which indicate the type of portal access to provide for URLs with this alias, including:

Whether the user is anonymous.
Whether the user is accessing to the portal via a low-bandwidth connection.
Whether the user is allowed to access the portal via a proxy server.
Whether the alias is part of the URL returned to the client.
Whether the portal application name (irj) is part of the URL returned to the client.

To define an alias:

In web.xml for the irj J2EE application, add an initial parameter (<init-param> element) for the gateway servlet.
Set the parameter name (<param-name> element) to the new portal alias.

Set the parameter value (<param-value> element) to a string of key-value pairs, separated by commas (,). All values are either 0 (false) or 1 (true).

The following keys are available:

Key	Description
anonymous	Indicates whether anonymous access is enabled.
proxy	Indicates whether users can access the portal via a proxy server.
low_bandwidth	Indicates whether users are accessing the portal via low-bandwidth connections.
include_in_url	Indicates whether the alias is part of the URL returned to the client.
include_application_name in_url	Indicates whether the portal application name (`irj`) is part of the URL returned to the client.

The following is a sample parameter value:

anonymous=<value>,proxy=<value>,low_bandwidth=<value>, include_in_url=1, include_application_name in_url =1

Restart the portal.

The following shows, in bold, the XML added to create a new alias myAlias:

Syntax Syntax

```
<servlet>
```
```
  <servlet-name>gateway</servlet-name>
```

  <servlet-class>com.sap.portal.navigation.Gateway</servlet-class>

```
  <load-on-startup>0</load-on-startup>
```
```
  .
```
```
  .
```
```
  .
```
```
  <init-param>
```
```
    <param-name>myAlias</param-name>
```

    <param-value>anonymous=0,proxy=0,low_bandwidth=0, include_in_url=1,include_application_name_in_url=1

```
    </param-value>
```
```
  </init-param>
```
```
  .
```
```
  .
```
```
  .
```
```
</servlet>
```

End of the code.