Manage widgets in Profiles 

Configure settings in the widget definition file, widgets-config.xml, when you want to modify the widgets that display in the Profiles application.


Before starting

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. Each widget has a corresponding <widgetDef> element that contains the attributes for the widget. When you want to edit the widget, enable or disable it, or move it to a different location, you need to update the corresponding <widgetDef> element in the widgets-config.xml file.

The widgets-config.xml file is stored in the following location:

<WAS_HOME>\profiles\AppSrv01\config\cells\<CELL_NAME>\LotusConnections-config\widgets-config.xml


Procedure

To edit the widgets that display in Profiles...

  1. From the dmgr host:

      cd $DMGR_PROFILE/bin
      ./wsadmin.sh -jython
      execfile("profilesAdmin.py")

      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:

      ProfilesConfigService.checkOutWidgetConfig("<working_directory>", "<cell_name>")

      where:

      • <working_directory> is the temporary working directory to which the configuration XML and XSD files will be copied. The files are kept in this working directory while you make changes to them.

      • <cell_name> is the name of the WAS cell hosting the Profiles application. This argument is required.

      For example: 

      ProfilesConfigService.checkOutWidgetConfig("/wsadminoutput", "jdoe30Node02Cell")

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

  • Do one of the following:

    • To edit a widget's properties, look for the corresponding <widgetDef> element, and then modify the widget attributes and parameters as needed. For information about the attributes and parameters, see Profiles widget attributes.

    • To associate a widget with a different profile type, look for the relevant <widgetDef> element, and then modify the value of the resourceSubType attribute. For information about the resourceSubType attribute, see Profiles widget attributes.

    • To move a widget to a different location, look for the relevant <widgetDef> element, and then modify the value of the pageId and uiLocation attributes. For information about these attributes, see Profiles widget attributes.

    • To disable a widget, look for the relevant <widgetDef> element and either delete the element or comment it out of the code.

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

      ProfilesConfigService.checkInWidgetConfig()

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

  • Stop and restart the Profiles server.

    Example

    <layout resourceSubType="default"> <page pageId="searchView"> <widgetInstance uiLocation="col1" defIdRef="commonTags"/> <widgetInstance uiLocation="col3" defIdRef="sand_DYK"/> <widgetInstance uiLocation="col3" defIdRef="sand_recomItems"/> </page > <page pageId="profilesView"> <widgetInstance uiLocation="col1" defIdRef="socialTags"/> <widgetInstance uiLocation="col1" defIdRef="sand_thingsInCommon"/> <widgetInstance uiLocation="col2" defIdRef="multiWidget"/> <widgetInstance uiLocation="multiWidget" defIdRef="board"/> <widgetInstance uiLocation="multiWidget" defIdRef="contactInfo"/> <widgetInstance uiLocation="multiWidget" defIdRef="backgroundInfo"/> <widgetInstance uiLocation="multiWidget" defIdRef="multiFeedReader"/> <widgetInstance uiLocation="col3" defIdRef="sand_socialPath"/> <widgetInstance uiLocation="col3" defIdRef="reportStructure"/> <widgetInstance uiLocation="col3" defIdRef="friends"/> <widgetInstance uiLocation="col3" defIdRef="linkRoll"/> </page > <page pageId="searchView"> <widgetInstance uiLocation="col1" defIdRef="commonTags"/> </page > <page pageId="networkView"> <widgetInstance uiLocation="col1" defIdRef="sand_DYK"/> </page > <page pageId="editProfileView"> <widgetInstance uiLocation="col1" defIdRef="socialTags"/> <widgetInstance uiLocation="col1" defIdRef="sand_thingsInCommon"/> <widgetInstance uiLocation="col3" defIdRef="sand_socialPath"/> <widgetInstance uiLocation="col3" defIdRef="reportStructure"/> <widgetInstance uiLocation="col3" defIdRef="friends"/> <widgetInstance uiLocation="col3" defIdRef="linkRoll"/> </page > </layout>

      Profiles widgets
      The following table lists the widgets that are available for the Profiles application.


    Parent topic

    Configure widgets in Profiles

    Related concepts
    Add custom widgets to Profiles

    Related reference
    Profiles widget attributes

    +

    Search Tips   |   Advanced Search