Question:
How do you use the Migration Workflow in DocuWare 7 and higher?
Answer:
The migration workflow can be used to migrate data from DocuWare disks to another DocuWare disks within a file cabinet.
Complete the following steps in order to successful utilize a Migration Workflow;
1. First, we must obtain the File Cabinet GUID, which can be found in the File Cabinet configurations plugin.
- Go to "More options":
- The File Cabinet GUID can be found here, copy this to a notepad, as it will be used later on:
2. An XML will need to be created in the Background Process Service folder of the DocuWare installation. In this case, DocumentTool.SampleMigrationSettings.xml will be used as the XML file name.
3. Open the XML in notepad, in the XML will be the following:
<BatchDocumentSettings fileCabinetGuid="e3dcc667-3bb3-46fd-9b23-395bd28a0f52" destinationDiskNumber="1">
<DocumentsFilter fromStorageDateTime="2017-06-12T05:54:27" toStorageDateTime="2018-06-12T05:54:27" fromModificationDateTime="2017-06-12T05:54:27" toModificationDateTime="2018-06-12T05:54:27" fromDocID="0" toDocID="1500">
<DiskNumbers>
<System.Int32>2</System.Int32>
<System.Int32>3</System.Int32>
</DiskNumbers>
</DocumentsFilter>
</BatchDocumentSettings>
Note: Given this settings file, the job will migrate all documents that are on disk numbers 2 and 3, have modification datetime between 2017-06-12T05:54:27 and 2018-06-12T05:54:27, storage datetime between 2017-06-12T05:54:27 and 2018-06-12T05:54:27, and docId from 0 to 1500. Those documents will be moved to disk number 1.
4. The file cabinet GUID will need to be replaced, as well as the destination disk #. Set the filters how you would like, and adjust disk #'s accordingly. In this instance, only the Disk Numbers are going to be kept and altered in order to migrate Disk Number 2's contents over to Disk Number 1.
<BatchDocumentSettings fileCabinetGuid="0e455b69-63e1-4785-bb78-1c88dcbb54c70" destinationDiskNumber="1">
<DocumentsFilter>
<DiskNumbers>
<System.Int32>2</System.Int32>
</DiskNumbers>
</DocumentsFilter>
</BatchDocumentSettings>
5. Once everything is adjusted to your preference, save and close the XML.
6. To start the Migration Workflow, 'cd' to the folder where Background Process Service is installed and enter the following command:
DocumentTool.exe -filename=DocumentTool.SampleMigrationSettings.xml -jobtype=1 -username="admin" -password="admin"
***Adjust to your filename, DocuWare username, and password accordingly.***
Here is an example of the running Migration Workflow:
The Migration process has now been completed. The contents of Disk Number 2 has been successfully moved to Disk Number 1.
KBA applicable for On-premise Organizations ONLY.
