File Structure V2
With Document Archive 1.56.0.0 a new file structure is implemented. The new file structure doesn't change any functional features, only the technical implementation of how the files on the File Handlers are referenced in Business Central has been updated.
Important
In version 1.58.0.0 the new file structure is introduced, but not yet activated after update to this version or for new installations. In version 1.60.0.0 the feature is expected to be automatically actived for new installations. Current installations won't be switched to the new folder structure yet(!).
For the new release, at least Business Central version 24.0 is required. With File Structure V2, the DCAFile table is replaced by the DCARemoteFile and DCARemoteFileLink tables. Migration to File Structure V2 can be started by enabling File Structure V2 Enabled in Document Archive Setup.
You will then see the following screen:
After confirmation, the data migration will start:
Technical details¶
The existing DCAFile records are NOT deleted by the migration. They are only deactivated and replaced by DCARemoteFile and DCARemoteFileLink records. With File Structure V2 enabled, it is easy to move all existing files to the new File Handler storage after changing the File Handler.
Warning
This can be done (by committing per record) during working hours, but it may take some time. If the process is interrupted, it can be restarted and will continue from where it left off. The files are NOT deleted from the old File Handler storage.
With File Structure V2, the full file path is now stored in the DCARemoteFile record. Due to all the excessive options built into the Remote Folder Structures, the Move Files Current Remote Folder Structure option will no longer be available if the current remote folder structure is set to Based on Entities or Custom Folder Structure.
Custom extensions¶
Important
When enabling Document Archive File Structure V2, custom extensions on Document Archive also need to be modified.
