Enable custom widgets for Profiles 

To make custom widgets available for use in Profiles, configure the widgets in the widget definition file, widgets-config.xml.

Before you begin

To edit configuration files, use the IBM WAS wsadmin client. See Starting the wsadmin client for details.

About this task

The widgets-config.xml file contains information about widget definitions, widget attributes, widget location, default widget templates, and page definitions. Custom widget attributes are defined by the widget developer but, as administrator, configure the widgets by adding a <widgetDef> element containing the appropriate attributes for each widget in the widget configuration file. The file is stored in the following location:


You can integrate a custom widget as part of IBM Connections and you can also integrate the widget as an external application. To integrate the widget inside the IBM Connections application, your widget must provide a full page mode. To integrate the widget as an external application, use a navBarLink attribute to register a navigation link along with your widget configuration information.


To configure a custom widget for Profiles...

  1. From the dmgr host:

      cd $DMGR_PROFILE/bin
      ./wsadmin.sh -jython

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

  • Check out the widget configuration file:

  • Navigate to the temporary directory in which you saved the widgets_config.xml file, and then open the file in a text editor.

  • Define the custom widget by specifying a resource type of profile and adding a <widgetDef> element using the attributes and parameters defined in Profiles widget attributes.

  • Save your changes and check the widgets-config.xml file back in using the following command:

  • To exit the wsadmin client, type exit at the prompt.

  • Stop and restart the Profiles server.

    What to do next

    If you are adding widgets that are hosted on third-party servers, then you might need to update your proxy configuration. For more information on configuring the Ajax proxy for Profiles, see Configure the AJAX proxy for a specific application.

    Parent topic

    Add custom widgets to Profiles

    Related tasks

    Configure the AJAX proxy for a specific application
    Manage widgets in Profiles
    Configure profile types for widget layout
    Add custom strings for widgets and other specified scenarios

    Related reference
    Profiles widget attributes
    Profiles widget configuration variables