Customize the Profiles user interface 

Specify which attributes should display in Profiles based on the needs of your organization.

Before you begin

To edit configuration files, use the wsadmin client. See Starting the wsadmin client for information about how to start the wsadmin command-line tool.

About this task

Once you have decided which of the Profiles attributes you would like to display and which ones you want to allow users to edit, you are ready to configure the attributes, using the wsadmin client scripts for customizing Profiles. These steps provide an overview.

A configuration change requires synchronization of the Profiles node and a restart of the Profiles server to become effective. The configuration changes being made are only for the node specified when you perform the checkOutConfig command. If you want to make those changes to other nodes, then you need to repeat this process for the other nodes.

To change Profiles configuration settings to customize the user interface...


  1. From the dmgr host:

      cd $DMGR_PROFILE/bin
      ./ -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.

  2. Check out the Profiles configuration files:

      ProfilesConfigService.checkOutConfig("<working_directory>", "<cell_name>")where:

      • <working_directory> is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes (/) to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          Note: AIX and Linux only: The directory must grant write permissions or the command does not complete successfully.

      • <cell_name> is the name of the WAS cell hosting the Profiles application. This argument is required. It is also case-sensitive, so type it with care. If you do not know the cell name, you can determine it by typing the following command in the wsadmin command processor: print AdminControl.getCell()

      For example:

      • AIX or Linux:


      • Microsoft Windows:


  • Although you should try to avoid directly editing XML configuration files, and use appropriate wsadmin commands to modify applications, this is one area where commands are not available. Locate the Profiles configuration file, profiles-config.xml, in the local working directory specified in the checkOutConfig command. The Profiles configuration file contains the various configuration settings for the Profiles application. Here is the relevant section for customizing the Profiles user interface:

  • Modify the files, following the steps (detailed in the topics that follow) for choosing attributes and specifying which are editable. Many of the attributes are already listed in the configuration file, so you simply need to comment out what you don't want, or remove the comment statement from attributes you do want. If an attribute you want is not listed, add it to this file.

  • After making changes, check the configuration files back in, and do so during the same wsadmin session in which you checked them out for the changes to take effect. See Apply property changes in Profiles for information about how to save and apply your changes.

    Parent topic

    Customize Profiles

    Related tasks

    Apply property changes in Profiles

    Related reference
    Update profile entries
    Retrieve the Profiles service document
    Retrieve the Profiles Administration API service document