================================================================================ ================================================================================ == == == Fix pack 3 for IBM Document Connect for Lotus Notes and Lotus Domino for == == Multiplatforms V2.0 == == == == Date: 2003-12-22 == == Version: 2.0.200.1 (Build: 584, 2003-12-22) == == == == Find the newest information and updates at the Document Connect home page: == == == == http://www.ibm.com/software/applications/office/connect/index.html == == == ================================================================================ ================================================================================ 0 Contents ================================================================================ This file includes the following information: 1 Installation 1.1 Installing the fix pack for Document Connect for Lotus Notes V2 1.2 Installing the fix pack for Document Connect for Lotus Domino V2 (Windows only) 2 Updating the databases 2.1 Updating a template database 2.1.1 Updating a template database without having installed fix pack 2 2.1.2 Updating a template database from fix pack 2 to fix pack 3 2.2 Updating a configuration database 3 Trademarks 1 Installation ================================================================================ IBM Document Connect must be installed on the system where you want to install this fix pack. If you do not follow the necessary steps you may lose program elements from your source code repository or it will not function properly. IMPORTANT: FixPack 2 (Version: 2.0.100.4.450, 2003-05-27) must have been installed before installing this fix pack! 1.1 Installing the fix pack for Document Connect for Lotus Notes V2 ------------------------------------------------------------------- Download the appropriate client fix pack (according to the installed language of Document Connect) to the Notes directory (preferred), for example C:\Notes, or to a temporary directory, for example C:\Temp. The fix pack is a self-extracting archive. Its file name depends on the language you have selected on the download page: - ibm-dc4notes-da-202001584-w32.exe (Danish) - ibm-dc4notes-nl-202001584-w32.exe (Dutch) - ibm-dc4notes-en-202001584-w32.exe (English) - ibm-dc4notes-fr-202001584-w32.exe (French) - ibm-dc4notes-de-202001584-w32.exe (German) - ibm-dc4notes-it-202001584-w32.exe (Italian) - ibm-dc4notes-no-202001584-w32.exe (Norwegian) - ibm-dc4notes-es-202001584-w32.exe (Spanish) Close Lotus Notes, Lotus Domino Designer and Lotus Domino Administrator and then run the self-extracting archive. If you have NOT downloaded the fix pack to the Notes directory, change the unzip folder to the Notes directory. Ensure the "Overwrite Files Without Prompting" check box is checked and click Unzip. After 20 files are extracted successfully, close the self-extracting archive. The downloaded file ibm-dc4notes-xx-202001584-w32.exe can be deleted now. Attention! If the data directory is not located in the Notes directory, a directory named 'data' is created in the Notes directory. While extracting, the following two files are written to this directory: - cdtmplxx.ntf - cdccfgxx.ntf where xx is your language identifier. Copy these two files to your Notes data directory. When you are prompted to replace existing files while copying, select yes. Additionally, a directory structure data\domino\java is created in the Notes directory. While extracting, the file doc.jar is written to this directory. Copy this file to your Notes data\domino\java directory. When you are prompted to replace existing files while copying, select yes. You can verify successful installation by starting Lotus Notes. Select the menu Actions -> Document Connect Information. Check the Document Connect Version: 2.0.200.1 (Build: 584, 2003-12-22). 1.2 Installing the fix pack for Document Connect for Lotus Domino V2 (Windows ----------------------------------------------------------------------------- only) ----- Download the appropriate server fix pack (according to the installed language of Document Connect) to the Domino directory (preferred), for example C:\Domino or to a temporary directory, for example C:\Temp. The fix pack is a self-extracting archive. Its file name depends on the language you have selected on the download page: - ibm-dc4domino-da-202001584-w32.exe (Danish) - ibm-dc4domino-nl-202001584-w32.exe (Dutch) - ibm-dc4domino-en-202001584-w32.exe (English) - ibm-dc4domino-fr-202001584-w32.exe (French) - ibm-dc4domino-de-202001584-w32.exe (German) - ibm-dc4domino-it-202001584-w32.exe (Italian) - ibm-dc4domino-no-202001584-w32.exe (Norwegian) - ibm-dc4domino-es-202001584-w32.exe (Spanish) Stop the Domino server and all Document Connect servers and then run the self-extracting archive. If you have NOT downloaded the fix pack to the Domino directory, change the unzip folder to the Domino directory. Ensure the "Overwrite Files Without Prompting" check box is checked and click Unzip. After 18 files are extracted successfully, close the self-extracting archive. The downloaded file ibm-dc4domino-xx-202001584-w32.exe can be deleted now. Attention! If the data directory is not located in the Domino directory, a directory named 'data' is created in the Domino directory. While extracting, the following file is written to this directory: - cdscfgxx.ntf where xx is your language identifier. Copy this file to your Domino data directory. When you are prompted to replace existing files while copying, select yes. Additionally, a directory structure data\domino\java is created in the Domino directory. While extracting, the file doc.jar is written to this directory. Copy this file to your Domino data\domino\java directory. When you are prompted to replace existing files while copying, select yes. You can verify successful installation by starting one of the Document Connect Servers (i.e. CMS Server). Check for version 2.0.200.1.584 in the header. 2 Updating the databases ================================================================================ 2.1 Updating a template database -------------------------------- Document Connect template databases are Notes databases (.nsf files) created by you to contain your document templates and elements. For example, the sample database shipped with Document Connect (docsampledben.nsf) is a template database. To update the design of each of your Document Connect template databases, use the Document Connect Refresh Design option. Do NOT use the Refresh Design option of Notes! Perform the following steps: 1. If your Notes data directory is not located in the Notes directory, please ensure you have copied the new .ntf files to your data directory (see topic 1.1 above). 2. Open Lotus Notes where the fix pack and the Document Connect template database is installed locally. 3. Open the workspace and then the workspace page where the database icon of the template database you want to update is located. Alternatively you can open the bookmarks pane if you have a bookmark for the database. 4. It is recommended that you create a backup of your database before refreshing the design. For this you can use the Database -> New Copy... function of Lotus Notes or you can create a backup copy of the database file using Windows Explorer. 5. Keep in mind that while refreshing the design, all design elements found in the updated template cdtmplxx.ntf are copied to your Document Connect template database. Be sure that you do not overwrite changes you made to the design elements in your Document Connect template database. Keep in mind that it is recommended you make no changes to these design elements. It is recommended that you create a copy of the default Document Connect design element and then make your changes in the copy. 6. Open the database and then close it again. In the menu bar select Actions -> Document Connect Refresh Design. If the database contains a lot of design elements, this operation can take some time. When the database opens the operation has finished successfully. Because only the design elements shipped with Document Connect are copied to your Document Connect template database you need to manually update any copies you've made of these elements. If you have not installed fix pack 2 Version: 2.0.100.4 (Build: 450, 2003-05-27), proceed with 2.1.1 to first apply the fix pack 2 changes to your template database. Then proceed with 2.1.2 to apply the fix pack 3 changes. If you have already installed fix pack 2, you should already have applied the fix pack 2 changes to your copies of the default Document Connect design elements. Proceed with 2.1.2 to update your template database to fix pack 3. 2.1.1 Install fix pack 2 first , follow the instructions in the readme, then proceed with 2.1.2. 2.1.2 Updating a template database from fix pack 2 to fix pack 3 The following list contains all changed elements, a description what has been changed in each, and which manual actions are needed to update your copies from fix pack 2 to fix pack 3: - Form .cdTOC - new form: -> placeholder for Table of Contents. - Form '.cdBasicEventsAndActions' -> Actions (web) Submit & View Save Save & Close Print Archive Save as Draft Send as Email: - Replace (in Formula) @RightBack(@NoteID;6) by @ReplaceSubstring(@Text(@DocumentUniqueID);":" : "-"; "" : "") - Form 'CDTemplate (Web)' Field 'DocID': - Replace Default Value @RightBack(@NoteID;6) by @ReplaceSubstring(@Text(@DocumentUniqueID);":" : "-"; "" : "") 2.2 Updating a configuration database ------------------------------------------- The Document Connect configuration database default name is cdConfiguration.nsf To update the design of the Document Connect configuration database, use the Refresh Design option of Notes. Perform the following steps: 1. If your Notes data directory is not located in the Notes directory, please ensure you have copied the new .ntf file to your data directory (see topic 1.1 above). 2. Open Lotus Notes where the fix pack and a local replica of the configuration database is installed. 3. Open the workspace and then the workspace page where the database icon of the configuration database you want to update is located. Alternatively you can open the bookmarks pane if you have a bookmark for the database. 4. It is recommended that you create a backup of your database before refreshing the design. For this you can use the Database -> New Copy... function of Lotus Notes or you can create a backup copy of the database file using Windows Explorer. 5. Right click the database icon / bookmark and select Database -> Refresh Design... 6. Select Local as Server and click OK. 7. When you are asked to proceed with the refresh click Yes. 3 Trademarks ================================================================================ The following terms are trademarks of the International Business Machines Corporation in the United States, or other countries, or both: Lotus Notes is a trademark of Lotus Development Corporation in the United States, or other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are registered trademarks of Microsoft Corporation. Other company, product, and service names may be trademarks or service marks of others. THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. (C) Copyright IBM Corporation 2003. All rights reserved. ================================================================================ ================================================================================ == == == E N D O F D O C U M E N T == == == ================================================================================ ================================================================================