The widgets-config.xml files
contains
configuration settings for each of the widgets supported by Profiles.
To update settings in the file, you must check the file out and, after
making changes, you must check the file back during the same wsadmin
session as the checkout for the changes to take effect.
Before you begin
To edit configuration
files, you must use the IBM® WebSphere® Application
Server wsadmin client. See Starting
the wsadmin client for details.
About this task
The widgets-config.xml file
defines
the widgets available for use in Profiles and Communities. You can
edit configuration settings in this file to perform various tasks.
For example, if you want to make custom widgets available, you define
the widgets in this file. You also edit settings in this file if you
want to configure the Recent Posts widget to only display tabs for
the applications included in your deployment. For more information,
see Configuring the Recent Posts widget.Procedure
To configure settings in the widgets-config.xml file
for Profiles, complete the following steps.
- Start the wsadmin client from the following
directory of the system on which you installed the Deployment Manager:
app_server_root\profiles\dm_profile_root\bin
where app_server_root is the WebSphere Application Server
installation directory and dm_profile_root is the
Deployment Manager profile directory, typically dmgr01.You must
start the client from this directory or subsequent commands that you
enter do not execute correctly. For more information, see Starting
the wsadmin client.
- Start the Profiles Jython script interpreter.
- Use the following command to access the Profiles configuration
files:
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,
you must pick the node where the file is stored.
- Use
the following
command to 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 WebSphere Application
Server 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 and make the required changes.
- 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.