The IBM Docs Integration plug-in is included
with IBM Content Navigator. To use it, you must configure the
plug-in, install the IBM Docs add-on, and update your
custom menus.
Before you begin
IBM Docs requires IBM CMIS for FileNet® Content Manager and FileNet Collaboration
Services. Install
IBM CMIS for FileNet Content Manager and FileNet Collaboration
Services on the
same application server by using the same configuration profile and pointing to the same Content Engine or Content Platform Engine component. Then,
update the following properties:
- For IBM CMIS for FileNet Content Manager, edit the cmis.properties
file and set the following properties:
- enableTeamspaceAwareness =
true
- filterHiddenProperties =
false
- For FileNet Collaboration
Services, edit the
fncs-sitePrefs.properties file and set the following property:
- enableSharedDrafts =
true
If you install IBM Content Navigator in a WebSphere® Application
Server environment, disable the security integration property for session
management. If you do not disable the security integration property, a web client connection error
message is displayed when you log out of IBM Content Navigator after you
edit a document in IBM Docs. To disable security integration,
log in to the WebSphere Application
Server administrative console, go to and clear the option for Security integration.
About this task
The
IBM Docs Integration plug-in allows
you to perform the following tasks:
- From IBM Content Navigator, open a document that is stored in an
IBM
FileNet Content Manager repository, edit the document in IBM Docs, and check in a new version to the document to the
repository.
- From IBM Content Navigator, create and collaborate on a new document in
IBM Docs, and then save the document in an IBM
FileNet Content Manager repository.
You can also add document templates to the IBM Docs Integration plug-in. The document templates are applied when
you create a new word-processing document, spreadsheet, or presentation. The following table shows
the valid file extensions and MIME types for document templates:
Document type |
Valid file extensions |
Valid MIME types |
Word-processing documents |
- .docx
- .ott
- .odt
- .doc
- .txt
|
- application/vnd.openxmlformats-officedocument.wordprocessingml.document
- application/vnd.oasis.opendocument.text-template
- application/vnd.oasis.opendocument.text
- application/msword
- text/plain
|
Presentation documents |
|
- application/vnd.openxmlformats-officedocument.presentationml.presentation
- application/vnd.oasis.opendocument.presentation-template
- application/vnd.oasis.opendocument.presentation
- application/vnd.ms-powerpoint
|
Spreadsheet documents |
- .xlsx
- .ots
- .ods
- .xls
- .csv
|
- application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
- application/vnd.oasis.opendocument.spreadsheet-template
- application/vnd.oasis.opendocument.spreadsheet
- application/vnd.ms-excel
- text/csv
|
To enable the IBM Docs Integration features,
configure the IBM Docs Integration plug-in, install the
IBM Docs add-on for your repository, optionally add document
templates, and update your custom menus.
Procedure
To configure the IBM Docs
Integration plug-in:
-
Open the administration tool in the IBM Content Navigator web
application, and click .
-
Enter the JAR file path for the IBM Docs
Integration plug-in.
The default JAR file path for the IBM Docs Integration plug-in class on Windows
is C:\Program
Files\IBM\ECMClient\plugins\docsPlugin.jar.
-
Click Load.
-
For the IBM Docs Server URL, enter the URL for the
server where IBM Docs is installed. By default, the URL has
the format,
http://local_hostname:port_number/server_name/context_root.
The context root is the value that is specified for IBM Docs
in the WebSphere Application
Server configuration settings.
-
For each repository that you want to use with IBM Docs, install the add-on for the
repository:
-
Select the repository from the drop-down list, and click Connect.
-
Enter a repository administrator user name and password, and click
Log in.
-
After the repository is connected, click Install Addon.
- Optional:
Specify document templates to apply when you create a new document with
IBM Docs.
Initially, no document template is specified, and you can add a template.
After you add a template, you can either change the template or remove
it.
Results
The following menu actions are added to IBM Content Navigator:
- Edit in IBM Docs
- New Document
- New Spreadsheet
- New Presentation
The following menus are added to
IBM Content Navigator:
- Default IBM Docs Plug-in Banner Tools Context Menu
- Default IBM Docs Plug-in Favorite Item Context Menu
- Default IBM Docs Plug-in Item Context Menu
- Default IBM Docs Plug-in Teamspace Item Context Menu
These menus contain the existing default menu actions and the new menu actions for IBM Docs.
The following toolbars are added to IBM Content Navigator:
- Default IBM Docs Plug-in ContentList toolbar
- Default IBM Docs Plug-in Global toolbar
- Default IBM Docs Plug-in Teamspace ContentList
toolbar
These toolbars contain the existing default menu actions and a New
Document drop-down list that contains the new menu actions New
Document, New Spreadsheet, and New
Presentation.
What to do next
The new menus and toolbars replace the corresponding menus and toolbars for the
default desktop. However, to enable the new menu actions for a custom desktop, edit the custom
desktop and replace the corresponding menus and toolbars in your custom desktop with the IBM Docs Plug-in menus and toolbars. Or, to enable the IBM Docs menu actions for a custom menu, edit the custom menu and
select the new menu actions from the list of available actions and move them to the list of selected
actions.Tip: When you enable the IBM Docs
Integration plug-in, IBM Content Navigator creates the
ClbIBMDocsState property. The ClbIBMDocsState property is
not automatically indexed. If you want to improve the performance for adding default templates and
creating new documents, create a database index for the ClbIBMDocsState
property.