A Display Profile Example

This example demonstrates how certain SSO Adapter attributes work together with their corresponding display profile attributes to give end users the ability to change the entries for specific features in a communication channel’s edit page, thereby changing how the communication channels are configured and displayed on their Portal Desktops.

The SSO Adapter template in A Display Profile Example is for a sample mail channel. The SSO Adapter template contains two merged attributes:

• uid—User ID

• password—User password

A merged attribute is an attribute that end users can specify. Administrators decide which attributes are merged so that end users can edit them.

Example 9–2 Sample SSO Adapter Template

default|imap:///&configName=MAIL-SERVER-TEMPLATE
    &encoded=password
    &default=protocol
    &default=clientProtocol
    &default=type
    &default=subType
    &default=ssoClassName
    &default=smtpServer
    &default=clientPort
    &default=host
    &default=port
    &merge=username
    &merge=userpassword
    &clientProtocol=http
    &type=MAIL-TYPE
    &subType=sun-one
    &ssoClassName=com.sun.ssoadapter.impl.JavaMailSSOAdapter
    &smtpServer=example.sun.com
    &clientPort=80
    &host=company22.example.com
    &port=143


               

A Display Profile Example contains the channel’s display profile XML fragment for the channel’s ssoEditAttributes.

After you set an attribute to merge in an SSO Adapter template, you can edit that attribute in the display profile to reconfigure how the attribute is displayed to end users in an edit page and how end users can edit it.

Administrators edit the proper display profile collection to define how end users are queried for the necessary information. In this example, administrators could replace UserName with the question, What is your user name? The use of the string attribute display type before the “|” symbol is the most likely choice. However, an administrator can change this to the password type or to another type.

Example 9–3 Sample Mail Channel Display Profile XML Fragment

<Channel name="SampleMailChannel" provider="MailProvider">
<Properties>
<Collection name="ssoEditAttributes">
    <String name="username" value="string|User Name:"/>
    <String name="userpassword" value="password|User Password:"/>
</Collection>


               

For this example, in the Mail channel edit page, end users see text fields titled:

• User Name:

• User Password: