Modifying Channels and Container Properties (Sun Java System Portal Server 7.1 Administration Guide)

Sun Java System Portal Server 7.1 Administration Guide

Modifying Channels and Container Properties

This section discusses the properties of channels and containers, and how to modify them.

You can perform the following tasks:

Understanding Properties

The properties displayed when you click on the node in the tree are top level properties or channel level properties. These properties are defined at the provider level and you can customize these properties for a channel. However, new properties added to a channel cannot be added to the provider. This is the reason you cannot add new properties at the channel level.

The properties table displays client type and locale. There is no column to show the type of the property, however, the following convention is followed:

String: Value column has a wide text field for a maximum of 30 characters.
Integer: Value column has a narrow text field for a maximum of 5 characters.
Boolean: Value is a radio button.
Map: Name is a link.
List: Value column has an Edit Values link. Clicking this link opens a wizard to add and remove values.
Empty Collection: The name is a link showing Edit Values link. Name and value pairs may be added to an empty collection to behave like a map, and the Edit Values disappears. If values are added to an empty collection using Edit Values wizard, the collection behaves as a List and the name link disappears.

In addition to the Name and Value columns, the properties table has two more columns:

Category

Displays if the property is advanced or basic. The advanced properties generally are for experienced administrators.

State

Any property may be in three possible states:

Default – Value assigned at the provider.
Inherited – Values modified at some level above. For example, if the current node is a role, then the property may have been customized at the organization of the role. This organization may be the parent organization, or parent of the parent organization. When the property is inherited it is a link. Clicking this link shows all the possible parent nodes in the hierarchy from where this property was inherited from.
Customized – Value defined at this node.

There are buttons in the properties table:

Remove Customization

Removes values defined at this node from the display profile. This may result in properties to be inherited from some parent in the hierarchy if the properties are customized there. If the value has not been customized anywhere in the hierarchy, the value defined at the provider is displayed and the state will show as Default.

Save

Saves additions, deletions, and changes of value.

Reset

Ignores changes and resets values to last saved state from the data store.

Clear All Sorts

Clears all sorts.

Tip –

Table may be sorted by clicking on any column title. When you click the Name button first to sort by name, a + appears next to the Category and State buttons. Click the + to apply the next sort criteria.

Table Preferences

Sets the table preferences.

Unless modified, the client type and locale are set to default.

To Create a Property

From the New Property wizard you can edit the values and save. You can also add new name and value pairs.

Select the Portals tab.

Select a portal from Portals.

From Select DN drop-down menu, select any DN.

Under Task, click Manage Channels and Containers.

Select a container in the tree on left frame to display Edit Properties page on the right frame.

Click the New Property button to launch the wizard.

Select the property type, and click Next.

Type a Name, select a Value, and specify if the property is advanced or not.

Note –
Collection property behaves like a map when it contains name and value pairs. Property of type Collection can be nested. The property path above the table will change to display the current nesting and you can navigate back.

Any trailing values are optional. For example, the value may be en or en_US, but cannot be US only. The standard Java format for specifying a locale is followed.

Click Finish to create the property.

Click Close to display the new property in the table.

To Edit a List

Collection property behaves like a List when it contains only values.

Select the Portals tab.

Select a portal from Portals.

From Select DN drop-down menu, select any DN.

Under Task, click Manage Channels and Containers.

Select a container in the tree on left frame to display Edit Properties page on the right frame.

Click the Edit Values link of a property to launch the wizard.

Make your changes.
- To add a value, type the name of the value in the New Value text box, and click Add.
- To delete a value, select a value from the Values list, and click Remove.

Click Close.

The edit properties page will update number of values in the list.

To Modify Channel and Container Properties

Select the Portals tab.

Select a portal from Portals.

From Select DN drop-down menu, select any DN.

Under Task, click Manage Channels and Containers.

Select a channel or container in the tree on left frame to display Edit Properties page on the right frame.

Change the properties, and click Save.

Equivalent `psadmin` Command

psadmin modify-dp