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.
Procedure
To customize the IBM Content
Navigator for Microsoft Office interface:
- Install IBM Content
Navigator for Microsoft Office.
- 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 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.
|
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.
|
- 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.
- 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
- To add a custom action to IBM Content
Navigator for Microsoft Office, modify the following
entries in the configuration.ini file:
- 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
- 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
- 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
What to do next
To customize the
IBM Content
Navigator for Microsoft Office clients
in your environment, take one of the following actions:
- Add the configuration.ini file to a shared
directory or mapped network directory and then specify the location
of the configuration file when you run a silent installation. For
more information, see Installing IBM Content Navigator for Microsoft Office silently.
- Update the configuration.ini file on each
client. To update the configuration.ini file,
take one of the following actions:
- Silently push the updated file to the client.
- Create a batch executable file that updates the file on the client
and instruct your users to download the executable file from a URL.
- Instruct your users to download the updated file and replace the
existing file on their client.