Specify external labels for attributes 

In IBM Connections, you can apply custom labels stored in an external resource bundle to any attribute, editable attribute, or custom extension attribute.


Before starting


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


When you specify external labels for attributes, editable attributes, or custom extension attributes, the labels are only applied to the user interface element that the configuration object represents. For example, if you apply a custom label to a business card <attribute> element, the label does not automatically apply to the same element in the advanced search page layout. The label configuration must be applied to each user interface element individually. For information about how to add the custom strings for labels to IBM Connections, see Add custom strings for widgets and other specified scenarios.


Procedure


To specify external labels for attributes...

  1. Add an external resource bundle to IBM Connections by following the steps outlined in the topic, Add custom strings for widgets and other specified scenarios.

  2. 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.

  3. 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: 

          ProfilesConfigService.checkOutConfig("/opt/prof/temp","foo01Cell01")

      • Microsoft Windows: 

          ProfilesConfigService.checkOutConfig("c:/prof/temp","foo01Cell01")

  • Open the profiles-config.xml file using a text editor.

  • Locate the <attribute>, <editableAttribute>, or <extensionAttribute> element that corresponds to the user interface application to which you want to apply the custom label.

  • Add the following attributes to the element:

    • labelkey. Specifies the label to display for the attribute.

    • bundleIdRef. Specifies the external resource bundle id that contains the label.
      The bundleIdRef maps to the bundle prefix that you defined when you registered the resource bundle in LotusConnections-config.xml. For more information, see Add custom strings for widgets and other specified scenarios.

      For example: 

      <attribute labelKey="labels.custom.officeName" bundleIdRef="example">officeName</attribute>

  • For <extensionAttibute> elements only: If you have defined the field to be a required field, specify an extensionIdRef attribute with a value that corresponds to the value of the field attribute defined in the validation.xml file. See Specify a required field for more details.

  • Save your changes.

  • 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 the Profiles user interface

    Related tasks
    Add custom strings for widgets and other specified scenarios
    Apply property changes in ProfilesSpecify a required field 

    +

    Search Tips   |   Advanced Search