FAQ: Convert database from v1.x to v2.x
The main difference between data storage of powerDOCUMENTS version 1.x and
version 2.x is the storage of the structure fields ("Abstract", ...). In version 1.x these
texts are stored in RTF format. In version 2.x these texts are stored in HTML
format.
The conversion utility will convert the structure fields from RTF to HTML. Those formats
which can be defined with the RTF editor control of powerDOCUMENTS v1.x should
be transfered to the matching HTML constructs. If additonal formatting has been inserted
(eg: via dragging formatted text) this formatting may be removed. It is also possible
that some of the formatting looks slightly different in HTML than it looked in RTF due to
the differences in the two presentation engines.
To migrate existing data from powerDOCUMENTS version 1.x to powerDOCUMENTS
version 2.x you need to perform the following steps.
- Download and install powerDOCUMENTS version 2.x
powerDOCUMENTS version 2.x will not overwrite a existing installation
of powerDOCUMENTS version 1.x. Instead it will install separately
with a separate database. The actual version of powerDOCUMENTS can
be downloaded from
www.powerDOCUMENTS.com/powerdocuments-setup.exe
- Make sure nobody is using the database during the conversion process
- Backup database and related files
Make a backup of the database file which contains your powerDOCUMENTs. (In a
default installation this is "c:\Program Files\KLV\powerDOCUMENTS\powerDOCUMENTS.mdb")
If you have made changes to the document structure or to other config items
you should also make a backup of the config file (default:
"c:\Program Files\KLV\powerDOCUMENTS\Config.xml").
- Download and run the conversion utility
It can be downloaded from
www.powerDOCUMENTS.com/powerdocuments-dbconverter-setup.exe.
After download it will be extracted to a directory you specify and the
conversion dialog will be started.
- In the DB Conversion Dialog specify:
| ConversionType |
Select "Convert database from v1-format to v2-format" |
| From DB, Path |
Specify the path of the version 1.x database containig the data
to be converted. The default given will work fine for a default installation of
powerDOCUMENTS version 1.x
|
| To DB, Type |
Select the type of database to create.
Normally it's best to stay with 'MS Access' type when converting from version 1.x.
|
| To DB, Path |
Specify the path where the new database (2.x-format) shall be created.
This database must not already exist. If you want to overwrite an existing database
you can delete it from the Browse-Dialog
|
- Adjust Configuration
Make sure powerDOCUMENTS 2 is configured for Jet database engine
and has the correct database path. The configuration file of
powerDOCUMENTS 2 should contain:
<ConfigValue name="dbPath" item="">xxx</ConfigValue>
<ConfigValue name="dbType" item="">Jet</ConfigValue>
where 'xxx' is the path of the database you converted to.
- Check the results
Use powerDOCUMENTS 2 and have a look at the resulting powerDOCUMENTs.
Only the texts in the structure fields will be converted. All other data should remain
unchanged.
- Make sure everyone is using powerDOCUMENTS 2 and accessing the
converted database.
|
|
|