Configuring the Edit Service client for IBM Content Navigator
If you use IBM® Content Navigator with IBM FileNet® P8 and IBM Content Manager repositories, you can install the Edit Service client on users' workstations to enable users to easily add files or edit files in the local apps that are installed on their computers.
Before you begin
The IBM Content Navigator web client communicates with the Edit Service
client through localhost.ibm.net, a global domain name server that points to
127.0.0.1.
- Configure your own DNS server with to point
localhost.ibm.netto127.0.0.1 - Configure the hosts file on each client workstation to include the following
entry:
127.0.0.1 localhost.ibm.net
The Edit Service client stores temporary files in the %TEMP%\IBM Content Navigator Edit\ directory. Ensure that the %TEMP% directory is a local directory and that the user has write access to it. The mapped network drive is not supported.
About this task
By default, the Edit Service client includes support for Microsoft Office documents. However, you can configure the Edit Service client to support other document types, such as PDF or HTML files.
When you use the Edit Service client on Mac OS and Windows, SAML SSO and Kerberos/SPNEGO SSO are supported.
- Creating and adding new documents to the repository
When the Edit Service client is enabled, a user can click New and select the type of file that they want to create. The file is added to the repository, checked out, and opened in the appropriate application on the user's workstation. Additionally, when the user saves their changes, the changes are checked into the repository.
- Saving changes that are made in native desktop applications to the repository.
When the Edit Service client is enabled and a user clicks , the file is checked out and opened in the appropriate application on their workstation. Additionally, when the user saves their changes, the changes are checked into the repository.
Note:
- Open the repository configuration in the IBM Content Navigator administration tool.
- Click the Edit Integration tab.
- In the Class and Role Settings section, select the classes that are used with Edit Service client for IBM Content Manager.
- In the Class and Role Settings section, specify the groups or roles who can use the Edit Service client templates and the draft items.
- Save your changes to the repository configuration.
Procedure
To integrate IBM Content Navigator with user desktop applications:
Disabling automatic validation of SSL certificates for the Edit Service client
About this task
- Windows: In the default installation directory, C:\Program Files (x86)\IBM\IBM Content Navigator Edit\EditClient\, open the IBM Content Navigator Edit.exe.config file and change the SSL parameter from True to False.
- Mac: In the default directory, /Users/%username%/Library/Application Support/IBM Content Navigator Edit, open the IBMContentNavigatorConfiguration.plist file and change the Validate SSL Certificate parameter from True to False.
Configuring the Edit Service client for an SSO container environment
About this task
Click the Edit Service client application icon, and then select Use Single Sign-On from the menu.
Customize the Edit client URL
About this task
You can configure an Edit client custom URL in the administration desktop by enabling the Edit Service custom URL, and then entering the same hostname with your custom SSL certificate. Following are the detailed steps.
- Retrieve the EditCustomURLPlugin source code from Windows Edit Client build file and open it with Visual Studio IDE, and then change the variable CertPassword value to the certificate's password in the file CustomURLPlugin.cs. Recompile the project EditCustomURLPlugin to generate the DLL file with Visual Studio IDE.
- Copy the EditCustomURLPlugin.dll file to the Edit client's installation directory: ....\IBM Content Navigator Edit\EditClient\Plugins\.
- Copy the certificate to the Edit client's installation directory: ...\IBM Content Navigator Edit\EditClient\.
- Open and modify the IBM Content Navigator Edit.exe.config file, which is under the installation directory: ...\IBM Content Navigator Edit\EditClient\. Change the certificate name to the name of your custom certificate. Update the DefaultCustomURLPlugin value if you have a different plug-in name.
- Restart the Edit client.
- Retrieve the EditCustomURLPlugin source code from the Mac Edit Client build file. Open the code with Xcode IDE, and then change the variable certPassword value to the certificate's password in the CustomURLPlugin.m file. Clean and build the project CustomURLPlugin to generate the plug-in file with Xcode IDE.
- Copy the CustomURLPlugin.plugin file to the Mac Edit client's configuration directory: /Users/%username%/Library/Application Support/IBM Content Navigator Edit/Plugins/.
- Copy the custom certificate to the Edit client's configuration directory: /Users/%username%/Library/Application Support/IBM Content Navigator Edit/.
- Open and modify the IBMContentNavigatorConfiguration.plist file, which is under the configuration directory: /Users/%username%/Library/Application Support/IBM Content Navigator Edit/. Change the CertificateName value to the name of your custom certificate. Update the DefaultCustomURLPlugin value if you have a different plug-in name.
- Restart the Edit client.