Sun Java System Portal Server 7.1 Developer Sample Guide

Removing a Button

To Remove a Button From All Channels in a Container

Find the container you want to work with. If you are working with one of the sample portals, you need to modify the appropriate “contained” container, which is part of the top-level container.

Add the appropriate property (within the <Properties></Properties>) tags from Removing a Button to the container’s display profile for the button you want to remove. This two column table lists the button in the first column and the property to hide the button in the second column.

The order of the buttons in this table corresponds to the order they appear in the channel, from left to right: Minimize, Maximize, Help, Edit, Detach, and Remove.

Button	Property to Hide the Button
Minimize	`<Boolean name="defaultChannelIsMinimizable" value="false"/>`
Maximize	`<Boolean name="defaultChannelIsMaximizable" value="false"/>`
Help	`<String name="helpURL" value=""/>`
Edit	`<Boolean name="isEditable" value="false"/>`
Detach	`<Boolean name="defaultChannelIsDetachable" value="false"/>`
Remove	`<Boolean name="defaultChannelIsRemovable" value="false"/>`

Note –

For the Help and Edit buttons, insert the respective property for each channel. You cannot insert the property within the container’s <Properties></Properties> tags.

Make sure the following properties are not defined in the container:

<Collection name="channelsIsRemovable">..</Collection>
<Collection name="channelsIsMinimizable"/>..</Collection>
<Collection name="channelsIsMaximizable"/>..</Collection>
<Collection name="channelsIsDetachable"/>..</Collection>

Load the display profile into LDAP using the psadmin subcommand or from the Portal Server management console.

To Remove a Button From All Channels in a Container From the Portal Server Management Console

Log in to the Portal Server management console and select the user, organization, or role in which the container is defined.

Select Manage Channels and Containers and click on the contained container.

Change the DefaultChannelIsMinimizable, DefaultChannelIsMaximizable, helpURL, isEditable, DefaultChannelIsDetachable, and DefaultChannelsIsRemovable properties to false.

Select Save to save the new values.

To Remove a Button From a Single Channel

For the channel from which you want to remove a button, add the appropriate property to a Collection tag in the container that contains the channel. See Removing a Button, for the button you want to remove. This two column table lists the button in the first column and the property to hide the button in the second column

The order of the buttons in this table corresponds to the order they appear in the channel, from left to right: Minimize, Maximize, Help, Edit, Detach, and Remove.

Button	Property to Hide the Button
Minimize	`<Collection name="channelsIsMinimizable">` `<Boolean name="channelname" value="false"/>` `</Collection>`
Maximize	`<Collection name="channelsIsMaximizable">` `<Boolean name="channelname" value="false"/>` `</Collection>`
Detach	`<Collection name="channelsIsDetachable">` `<Boolean name="channelname" value="false"/>` `</Collection>`
Remove	`<Collection name="channelsIsRemovable">` `<Boolean name="channelname" value="false"/>` `</Collection>`

For the channel in which you want to remove a button, add the appropriate property to a Collection tag in the controlling container.

For example, use the following XML to hide the Remove button for the Sample JSP channel in the JSP table container, MyFrontPageTabPanelContainer, whose container is JSPTabContainer.

<Container name="MyFrontPageFramePanelContainer" provider="JSPTableContainerProvider">
	<Properties>
		...
		<Collection name="channelsIsRemovable">
		<Boolean name="SampleJSP” value="false”/>
		</Collection>
	</Properties>
	...

Load the display profile into LDAP by using the psadmin subcommand or from the Portal Server management console.

To Remove a Button from a Single Channel From the Portal Server Management Console

Log in to the Portal Server management console and select the user, organization, or role in which the container is defined.

Select Manage Channels and Containers and click on the contained container.

Change the channelsIsMinimizable, channelsIsMaximizable, channelsIsDetachable, and channelsIsRemovable properties as follows:
1. Select the property (for example, channelsIsMinimizable) and click on New Property from the Properties table.
2. Create a boolean type property, specify the channel name that does not want that button, and set the value to be false.
3. Follow the steps to finish the wizard.
  
  There will be a new boolean property (for example, for the channelsIsMinimizable property) in the Properties table for the specified channel.