IBM BPM, V8.0.1, All platforms > Administer the IT infrastructure > Administer Process Portal > Administer Process Portal spaces > Remove widgets

Uninstalling custom widgets individually from Process Portal spaces

Use this procedure to uninstall a custom widget from a space that is not the only widget defined in its catalog.

You can move a widget from a space in one of the following ways:

When the custom widget is installed, the following actions occur:

When you individually uninstall a custom widget, you are deleting the widget files and removing the definition for that widget from its catalog file. You are also updating the endpoints and widget help if you include them in the uninstallation.


Procedure

  1. Uninstall the WAR containing the widget.
  2. Edit the catalog XML (widget registration) file containing the widget and remove its entries. Copy the edited file into a catalog directory.

  3. If the widget has help, do the following steps:

    1. Copy the documentation plug-in containing the help from the profile_root/config/BusinessSpace/help/eclipse/eclipse/plugins directory.
    2. Edit the navigation XML file and delete the entries for the widget.
    3. Open the doc.zip file and delete the help files for the widget. If there are hyperlinks in other files to the widget help, edit these files to delete the links.

    4. Copy the documentation plug-in into a help/eclipse/plugins directory.

      If you have other documentation plug-ins that have hyperlinks to the plug-ins that you are deleting, you need to update the other plug-ins separately. See the final step in Create a documentation plugin for information.

  4. Compress the catalog and help directories. Check that the structure of the .zip file contains the following items:

    • catalog\catalog_ name.xml
    • help\eclipse\plugins\*

  5. At a command prompt, change directories to the profile_root/bin or cluster_root/bin directory.

  6. Enter wsadmin.bat -conntype NONE and then enter the appropriate command:

    • For uninstalling the widgets from a non-clustered environment: $AdminTask updateBusinessSpaceWidgets {-nodeName node -serverName server -widgets fullpath}

    • For uninstalling the widgets from a clustered environment:$AdminTask updateBusinessSpaceWidgets {-clusterName cluster -widgets fullpath}

    fullpath is the name and location of the .zip file created.

    For information on updateBusinessSpaceWidgets, see updateBusinessSpaceWidgets command: .

  7. Enter Exit

  8. Log in to Process Portal and delete the widget from any templates and spaces that use it. If you do not delete the widget, a placeholder image and a message that the widget is unavailable are displayed.

Remove widgets from Process Portal spaces


Related tasks:
Disabling widgets in Process Portal spaces