Customize the main section of the Profiles business card by editing settings in the profiles-config.xml
Before you begin
To edit configuration files, you must use the wsadmin client. See Starting the wsadmin client
for information about how to start the wsadmin command-line tool.
About this task
The main section of the business card displays the contact information and location information associated with a profile. You can customize this area by configuring the type of information that displays and the order in which it displays. You can also add custom extension attributes and blocks of HTML to this section of the business card.
To customize the main section of the business card:
- Start the wsadmin client from the following directory of the system on which you installed the deployment manager:
You must start the client from this directory or subsequent commands that you enter do not execute correctly.
- Use the wsadmin client to access and check out the Profiles configuration files.
- Enter the following command to access the Profiles configuration files:
- Enter the following command to check out the Profiles configuration files:
- <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 WebSphere® Application Server 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()
- AIX or Linux:
- Microsoft Windows:
- Open the profiles-config.xml file using a text editor.
- Locate the <businessCardLayout> element, and specify the information that you want to display by adding the following attributes under the <attributes> element:
Table 1. Business card attributes
|attribute||Specifies the predefined attribute that you want to display.|
|extensionAttribute||Specifies the custom extension attribute that you want to display. For information on adding custom extension attributes to Profiles, see Adding custom extension attributes for Profiles.|
|html||Specifies a block of HTML to display in the business card.|
Each subelement can optionally include the following attributes:
- labelKey. Specifies the label to display with the attribute.
Note: There is no default label for attributes. If showLabel is set to true, you must explicitly define a label to use using the labelKey attribute.
- bundleIdRef. Enables you to reference an external bundle contained in a ZIP file.
<html prependHtml="<div class='adr'>"/>
<attribute showLabel="false" hideIfEmpty="true" ...>workLocation.city</attribute>
<extensionAttribute extensionIdRef="region" showLabel="true" labelKey="label.region" bundleIdRef="mylabels" hideIfEmpty="true" prependHtml="..."/> ...
- Save your changes.
- After making changes, you must check the configuration files back in, and you must do so during the same wsadmin session in which you checked them out for the changes to take effect. See Applying property changes in Profiles for information about how to save and apply your changes.
Parent topic: Customizing the Profiles business card
Adding custom extension attributes for Profiles
Applying property changes in Profiles