Home

 

Configure the vCard export feature for Profiles

Configure settings in the profiles-config.xml file to specify the character set encoding options used to export vCards. The table below lists the character set encoding options that work best.


To use administrative commands, use the IBM WebSphere Application Server wsadmin client. See Start wsadmin for details.


Profiles users can export vCards from people's profiles and then import the profiles into their e-mail client as contacts. You can configure the profiles-config.xml file to specify the encoding options that are available when exporting vCards from Profiles and determine which options are most appropriate for your users.

To configure the vCard export feature...

  1. Use wsadmin to access and check out the Profiles configuration files.

    1. Access the Profiles configuration files:

    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.

      • cell_name is the name of the WebSphere Application Server cell hosting the Profiles feature. This argument is required even in stand-alone deployments. This argument is case-sensitive, so type it with care. If you do not know the cell name, do one of the following to determine it:

        • Stand-alone deployment: See:

          WAS_HOME\profiles\profile_name\config\cells\

        • Network deployment: From wsadmin...

          print AdminControl.getCell()

      For example:

      • AIX/Linux: 

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

    3. Microsoft Windows: 

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

  2. Open the Profiles configuration file, profiles-config.xml, using a text editor and locate the <vcardExport> section, which looks like the following: 

      <vcardExport>
 <charset name="UTF-8">
  <label key="label.vcard.encoding.utf8"/>
 </charset>
 <charset name="ISO-8859-1">
  <label key="label.vcard.encoding.iso88591"/>
 </charset>
 <charset name="Cp943c">
  <label key="label.vcard.encoding.cp943c"/>
 </charset>
</vcardExport>

  3. To provide an export encoding that is specific to your language, include the following lines of code within the <vcardExport> tags: 

      <charset name="<character_encoding>">
  <label key="<ui_label>"/>
</charset>

    where:

    • <character_encoding> is the name of the character encoding to export.

    • <ui_label> is the label for the character encoding in the user interface.

    For example, to add an export setting for Arabic, include the following element: 

      <vcardExport>
 ...
 <charset name="Windows-1256">
  <label key="label.vcard.encoding.windows.arabic"/>
 </charset>
</vcardExport>

    The following character set encoding options work best:


    Export character set encodings
    Character encoding Description
    Windows-1250 Central European languages that use Latin script (Polish, Czech, Slovak, Hungarian, Slovene, Serbian, Croatian, Romanian, and Albanian)
    Windows-1251 Cyrillic alphabets
    Windows-1252 Western languages
    Windows-1253 Greek
    Windows-1254 Turkish
    Windows-1255 Hebrew
    Windows-1256 Arabic
    Windows-1257 Baltic languages
    Windows-1258 Vietnamese

    Complete this step for every language for which you require encoding support. There is no limit to the number of character set encodings that you can specify. Apply property changes


Administer Profiles

 

Related tasks

Apply property changes

Add custom strings to Communities and Profiles

+

Search Tips   |   Advanced Search