Disabling widgets in dashboard spaces

You can disable a widget by unregistering it. An unregistered widget is no longer available to users.

About this task

Related widgets are grouped into a catalog. To disable a widget, you edit its definition in the catalog XML file and then update the space. Disabling the widget prevents it from displaying on the widget palette and on pages while maintaining the code.

Disabling the widget instead of uninstalling it allows the product to update the widget with enhancements and fixes so that it is at the correct level if you enable it again. If the product changes the catalog containing the widget, you might have to disable the widget again.

Procedure

Navigate to the profile_root/BusinessSpace/node_name/server_name/widgets/installs.timestamp directory and open the catalog file containing the widget definition.
Tip: Save a copy of the file as a backup.
Comment out the catalog entry (from <entry> to </entry>) for the widget you want to disable. Ensure the file is still a valid XML file after the change.
Save the edited catalog file to an empty directory. The name of the file must be catalog_name.xml where name can be any name.
At a command prompt, change directories to the profile_root/bin or cluster_root/bin directory.
Enter wsadmin.bat -conntype NONE and then enter the appropriate command:
- To disable a widget in a stand-alone server:
```
$AdminTask updateBusinessSpaceWidgets {-nodeName node -serverName server -catalog fullpath}
```
- To disable a widget in a cluster:
```
$AdminTask updateBusinessSpaceWidgets {-clusterName cluster -catalog fullpath}
```
fullpath is the path to the directory containing the edited catalog file.
For information on updateBusinessSpaceWidgets, see updateBusinessSpaceWidgets command.
Enter Exit.
To see the changes in the browser, logout of the space, clear the cache in the browser, and then log in again.