Package: odoo-addon-dms
DMS is a module for creating, managing and viewing document files directly
within Odoo.
This module is only the basis for an entire ecosystem of apps that extend and
seamlessly integrate with the document management system.This module adds portal functionality for directories and files for allowed users, both portal or internal users. You can get as well a tokenized link from a directory or a file for sharing it with any anonymous user.Table of contentsInstallationConfigurationMigrationFile Wizard SelectionUsagePortal functionalityKnown issues / RoadmapBug TrackerCreditsAuthorsContributorsOther creditsMaintainersInstallationPreviewmail_preview_baseis required for DMS but it is recommended to install all
the othermail_previewmodules fromsocialOCA repository
in order to improve the preview of files.python-magiclibrary is recommended to be installed for having whole support
to get proper file types and file preview.ConfigurationTo configure this module, you need to:Go toDocuments -> Configuration -> Storages.Create a new document storage. You can choose between two options onSave Type:Database: Store the files on the database as a fieldAttachment: Store the files as attachmentsNext create an administrative access group. Go toConfiguration -> Access Groups.Create a new group, name it appropriately, and turn on all three permissions (Create, Write and Unlink - Read is implied and always enabled).Add any other top-level administrative users to the group if needed (your user should already be there).You can create other groups in here later for fine grained access control.Afterwards go toDocuments -> Directories.Create a new directory, mark it as root and select the previously created setting.Select theGroupstab and add your administrative group created above.On the Directory you can also add other access groups (created above) that will be able to:readcreatewritedeleteMigrationIf you need to modify the storage Save Type you might want to migrate the file data.
In order to achieve it you need to:Go toDocuments -> Configuration -> Storageand select the storage you want to modifyModify the save typePress the buttonMigrate filesif you want to migrate all the files at oncePress the buttonManual File Migrationin order to specify files one by oneYou can check all the files that still needs to be migrated from all storages
and migrate them manually onDocuments -> Configuration -> MigrationFile Wizard SelectionThere is an action calledaction_dms_file_wizard_selectorto open a wizard to list files in kanban view.
This can be used (exampledms_attachment_linkmodule) to add a button in kanban view with the action we need.UsageThe best way to manage the documents is to switch to the Documents view.
Existing documents can be managed there and new documents can be created.Portal functionalityYou can add any portal user to DMS access groups, and then allow that group in directories, so they will see in the portal such directories and their files.
Another possibility is to click on “Share” button inside a directory or a file for obtaining a tokenized link for single access to that resource, no matter if logged or not.Known issues / RoadmapFiles preview in portalAllow to download folder in portal and create zip file with all contentSave in cache own_root directories and update in every create/write/unlink functionAdd a migration procedure for converting an storage to attachment one for populating existing records with attachments as foldersAdd a link from attachment view in chatter to linked documentsIf Inherit permissions from related record (the inherit_access_from_parent_record field from storage) is changed when directories already exist, inconsistencies may occur because groups defined in the directories and subdirectories will still exist, all groups in these directories should be removed before changing.Since portal users can readdms.storagerecords, if your module extends this model to another storage backend that needs using secrets, remember to forbid access to the secrets fields by other means. It would be nice to be able to remove that rule at some point.Searchpanel in files: Highlight items (shading) without records when filtering something (by name for example).Bug TrackerBugs are tracked onGitHub Issues.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomedfeedback.Do not contact contributors directly about support or help with technical issues.CreditsAuthorsMuK ITTecnativaContributorsMathias Markl <mathias.markl@mukit.at>Enric Tobella <etobella@creublanca.es>Antoni RomeraGelu Boros <gelu.boros@rgbconsulting.com>Tecnativa:Víctor MartínezPedro M. BaezaJairo LlopisElego:Yu Weng <yweng@elegosoft.com>Philip Witte <phillip.witte@elegosoft.com>Khanh Bui <khanh.bui@mail.elegosoft.com>Other creditsThe migration of this module from 15.0 to 16.0 was financially supported byAgentERPSome pictures are based on or inspired by:RoundiconsSmashiconsMaintainersThis module is maintained by the OCA.OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.This module is part of theOCA/dmsproject on GitHub.You are welcome to contribute. To learn how please visithttps://odoo-community.org/page/Contribute.