Customizing the IBM Content Navigator for Microsoft Office interface

You can use a configuration file to customize some of the options in the IBM® Content Navigator for Microsoft Office interface. However, most of the options in the configuration file can also be set at the desktop-level in the IBM Content Navigator administration tool.

Before you begin

Important: For an alternative method to customize the label and custom commands by using desktop settings in the administration tool, see Configuring desktops for Microsoft Office. The desktop settings take precedence over configuration file settings. However, if no desktop settings are specified, the configuration file settings are applied. If you configure the desktop settings, skip this task.

It is strongly recommended that you use the desktop settings rather than the configuration file. Changes to the desktop settings are automatically picked up by IBM Content Navigator for Microsoft Office clients. Conversely, if you update the configuration file, you must redistribute the configuration file to each IBM Content Navigator for Microsoft Office client in your environment.

To customize the IBM Content Navigator for Microsoft Office interface:

1. Install IBM Content Navigator for Microsoft Office.
2. Open the configuration.ini file in a text editor. The configuration.ini file is in the IBM Content Navigator for Microsoft Office application data directory:
   • If you installed IBM Content Navigator for Microsoft Office for all users, the default directory is C:\ProgramData\IBM\Content Navigator for Microsoft Office.
     Restriction: When you install IBM Content Navigator for Microsoft Office for all users, only the client administrator can edit the configuration.ini.
   • If you installed IBM Content Navigator for Microsoft Office for the current user, the default directory is C:\Users\user_account\AppData\Roaming\IBM\Content Navigator for Microsoft Office, where the user_account directory is the current user.
3. If you plan to use a central configuration.ini file, specify values for the following parameters:

   Option	Description
   BaseURL	Required Specify the URL by which you want users to access IBM Content Navigator from Microsoft Office. Do not include the ?desktop=desktop_name parameter in the URL. The parameter must have the format: BaseURL=public_Content_Navigator_URL
   Desktop	Optional. Specify the ID of the IBM Content Navigator desktop that you want users to access from Microsoft Office. If you do not specify a desktop ID, users are directed to the default desktop. The parameter must have the format: Desktop=desktop_ID
   BaseURLReadOnly	Optional. Specify whether you want the URL to IBM Content Navigator to be read-only. By default, the BaseURLReadOnly parameter is set to false. Valid values include: true false
   DesktopReadOnly	Optional. Specify whether you want the IBM Content Navigator desktop ID to be read-only. By default, the DesktopReadOnly parameter is set to false. Valid values include: true false

4. Specify any optional parameters for your environment.
   Remember: It is recommended that you configure these parameters from the IBM Content Navigator administration tool rather than in the configuration.ini file. By default, these parameters are not included in the configuration.ini file starting with IBM Content Navigator, Version 2.0.3.
   1. To change the label that is displayed for IBM Content Navigator for Microsoft Office, you can change the value of the IBMECMTabLabel parameter:

      IBMECMTabLabel=Custom toolbar label

   2. To add a custom action to IBM Content Navigator for Microsoft Office, modify the following entries in the configuration.ini file:
      1. To specify the label of the custom action, enter a value for the CustomCommand1Name parameter and remove the number sign (#) from the beginning of the line:

         CustomCommand1Name=Command label

      2. To specify the URL target of the custom action, enter a value for the CustomCommand1URL parameter and remove the number sign (#) from the beginning of the line:

         CustomCommand1URL=Target URL

      3. To specify the icon of the custom action, enter the fully qualified path of an icon file, such as a local file, for the CustomCommand1Icon parameter and remove the number sign (#) from the beginning of the line:

         CustomCommand1Icon=Fully qualified location of the icon file

      You can create up to four custom actions. To create more custom actions, copy the custom action parameters and increment the number in the parameter. For example, to create a second custom action, enter the following information in the configuration.ini file:

      CustomCommand2Name=Command label
      CustomCommand2URL=Target URL
      CustomCommand2Icon=Fully qualified location of the icon file