Technical Specifications & Compatibility
Technical Module Name
Supported Odoo Versions
v19.0
License
Odoo
Deployment Support
Odoo OnlineOdoo.shOn Premise
Lines of Code
752 lines (Python / XML / JS)
Overview & Description
Odoo 19 Odoo 20 Community and Enterprise OPL-1 Version 19.0.1.0.0 Document Workspaces Folders, inherited access rights, tags, owners and a search that reads the text inside your PDFs, spreadsheets and documents. A complete document manager for Odoo Community, built on the attachments you already have. Nothing is copied, nothing is moved. Module Overview What this module solves. Odoo Community has no document manager What Community has is ir.attachment: a flat pile of files with a name and a mimetype. No folder, no tag, no owner, no access rule. The Documents app, along with its bridge modules, Sign and Knowledge, is Enterprise only. Odoo already reads your files The standard attachment_indexation module extracts the full text of every PDF, Word, Excel, PowerPoint and OpenDocument file you upload and stores it in index_content. That field appears in no view anywhere in Odoo. The text is indexed and unreachable. This module makes it searchable. Documents are attachments, not copies. Filing is a field, not a duplicate. The invoice PDF that arrived by email is filed where it is and keeps its link to the invoice. A document manager with its own table can only manage what was uploaded through its own screen, which is never the file people are looking for. Key Features Everything included in the module. Search Inside Your Files Search reads name, description and the text inside the file Dedicated Text Inside Files field for content-only searches Has Extracted Text filter shows what is really indexable The extracted text is visible on the document form Search always respects folder permissions Folder Tree Unlimited hierarchy with a computed full path Paths stay correct when a parent folder is renamed Document counts, direct and including subfolders Duplicate names in the same parent are refused A folder holding documents cannot be deleted by accident Inherited Access Rights Readable By and Writable By groups per folder Inherit From Parent grants the cabinet, not each drawer Subfolder grants are a union with the parent Effective groups shown read-only, so nothing is guesswork Read and write enforced separately by real record rules File What You Already Have Unfiled lists attachments already in your database Field attachments such as product images are left out A wizard files a whole selection with tags and an owner Nothing is copied or moved on disk Remove From Folder unfiles without deleting Tags and Owners Tags cross folders, so one query answers everywhere Coloured tags with a live document count Multi-select tag facet in the search panel An owner and a filing date on every document Group by folder, owner, related record or upload date The Workspace Folder tree sidebar with live counts and a tag facet Kanban, list and form views of every document Filters for mine, unfiled, PDFs and images Filter for documents not attached to any record Two roles: Documents User and Documents Manager Business Benefits Why it matters day to day. Find Documents Faster Type a clause from inside a contract and the contract comes back, even when nobody remembers the file name it was saved under. Keep Documents Confidential Payroll, contracts and board papers sit in folders only the right groups can open, and search never reveals what it must hide. No Parallel File System Your files stay in Odoo, attached to the records they belong to. No second copy to keep in step and no shared drive to police. Community Friendly Document management on Odoo Community under OPL-1, with no Enterprise subscription and no third-party service. Screenshots A tour of the interface. Workspace Kanban Screenshot Placeholder Folder tree sidebar with counts, tag facet and document cards. Full-Text Search Result Screenshot Placeholder A word that appears only inside a PDF returning the file. Folder Access Rights Screenshot Placeholder Readable By, Writable By, inheritance and the effective groups. File Into Workspace Wizard Screenshot Placeholder Bulk filing of unfiled attachments with a folder, tags and an owner. Workflow From an empty workspace to a searchable archive. Build the folder tree. Create top-level folders such as HR, Finance and Legal, then the subfolders under them. The full path is computed for you. Grant access. Set Readable By and Writable By on the top folders and leave Inherit From Parent on, so subfolders follow the cabinet. Create tags. Contract, Invoice, Policy, Signed. Tags cross folders and answer the questions the tree cannot. File what is already there. Open Documents, then Unfiled, select the attachments and choose Actions, then File Into Workspace. Upload new documents. Upload straight into a folder, or file an attachment from any record without detaching it from that record. Search. Type any word. The search reads the name, the description and the text inside the file, within the folders you are allowed to open. Configuration Menus, roles and settings. Menu Structure Menu Purpose Documents The workspace: kanban, list and form of every filed document Documents, then Unfiled Attachments already in the database that have no folder yet Configuration, then Folders The folder tree and its access rights Configuration, then Tags Tag list with colours and document counts User Roles Group Can do Documents, User Find and file documents in the folders granted to them Documents, Manager Manage the folder tree, the tags and every document in it Leaving Readable By and Writable By empty on a folder means everybody holding the Documents User role can open it. Restrict the folders that need restricting. Technical Details Models, fields and dependencies. Module Information Technical Name dms_workspace_aura Version 19.0.1.0.0 Category Productivity / Documents License OPL-1 Dependencies base, mail, attachment_indexation Python Library pdfminer.six, required for PDF text extraction only External Service None. Everything runs inside your own Odoo instance. Automated Tests 52 unit tests and 2 browser tours Models Model Description dms.folder Hierarchical folder with access rights and counts dms.tag Cross-folder tag with colour and document count dms.file.wizard Bulk filing of selected attachments ir.attachment Inherited and extended, never replaced Fields Added To Attachments Field Type dms_folder_id Many2one to dms.folder dms_tag_ids Many2many to dms.tag dms_owner_id Many2one to res.users dms_filed_on Datetime, read-only Safe by construction. Every record rule added by this module starts by letting through attachments with no folder, so web assets, product images, report copies and chatter attachments behave exactly as they did before installation. Compatibility Where the module runs. Item Supported Odoo Version 19.0 Current Hosting Odoo.sh, On-Premise and any self-managed deployment Multi-Company Yes, standard Odoo company rules apply Multi-Language Yes, all labels and messages are translatable Mobile and Tablet Yes, standard responsive Odoo web client Indexable File Types PDF, Word, Excel, PowerPoint and OpenDocument Supported Editions Both editions, one code base. Community Edition Supported The edition this module was written for. It brings folders, access rights and full-text search to an Odoo that has none of them. Enterprise Edition Supported Runs on Enterprise as a lightweight alternative to the Documents app, with no conflict with the standard modules. Odoo.sh Supported Add pdfminer.six to your requirements file so PDF text extraction is available on every build. Installation Four steps and a note about PDFs. Copy the module. Place the dms_workspace_aura folder in your Odoo addons path. Install pdfminer.six. Run pip3 install pdfminer.six so PDF text can be extracted. Update the apps list. Activate developer mode, then choose Apps and Update Apps List. Install Document Workspaces. Search for it in Apps and install. The Documents menu appears at once. Without pdfminer.six Odoo logs a warning at startup and silently indexes no PDFs at all. Word, Excel, PowerPoint and OpenDocument work out of the box. A scanned page has no text layer and nothing to extract, with or without the library. Frequently Asked Questions The questions asked most often. No. Filing sets a folder field on the existing attachment. Nothing is copied and nothing moves on disk. An invoice PDF keeps pointing at its invoice and simply gains a folder, tags and an owner. No. Every rule added by the module lets an attachment with no folder through untouched, so product images, report copies, web assets and chatter attachments keep the access they had before. No. Content search runs through the same record rules as every other query, so a document in a folder you cannot open never appears in your results and its existence is never revealed. With Inherit From Parent on, a subfolder adds its own groups to the groups of its parent, so Finance can be given one drawer inside the HR cabinet without being given the cabinet. Turn inheritance off to cut the chain and make a subfolder narrower than its parent. A scanned page is an image with no text layer, so there is nothing to extract and no OCR is performed. The document form shows exactly what was read out of a file, so you always know why a search matched or did not. No. Versioning and check-out, retention and legal hold, and automatic filing rules are deliberately out of scope. This module does folders, access and search, and does them properly. No. It depends only on base, mail and attachment_indexation, and adds its own models and fields. It can be installed alongside Enterprise modules or used entirely on its own on Community. Changelog Release history. Version 19.0.1.0.0 Initial Release Folder tree with computed paths and document counts Readable By and Writable By groups with parent inheritance Effective access groups shown read-only on every folder Full-text search across name, description and file content Text Inside Files search field and Has Extracted Text filter Coloured tags with counts and a search panel facet Unfiled view and the File Into Workspace bulk wizard Remove From Folder action that never deletes a file Documents User and Documents Manager roles with record rules 52 unit tests and 2 browser tours Support We answer, and we keep our modules current. Email odooaura@gmail.com Website www.auraodoo.tech YouTube youtube.com/@Auraodoo Free support for bug fixes on the Odoo version you downloaded. Customisation and installation help available on request. Aura Odoo Tech Odoo modules built to be understood, not just installed. Odoo 19 OPL-1 dms_workspace_aura www.auraodoo.tech | odooaura@gmail.com | youtube.com/@Auraodoo
Key Capabilities & Features
- Search reads name, description and the text inside the file
- Dedicated Text Inside Files field for content-only searches
- Has Extracted Text filter shows what is really indexable
- The extracted text is visible on the document form
- Search always respects folder permissions
- Unlimited hierarchy with a computed full path
- Paths stay correct when a parent folder is renamed
- Document counts, direct and including subfolders
- Duplicate names in the same parent are refused
- A folder holding documents cannot be deleted by accident
- Readable By and Writable By groups per folder
- Inherit From Parent grants the cabinet, not each drawer
- Subfolder grants are a union with the parent
- Effective groups shown read-only, so nothing is guesswork
- Read and write enforced separately by real record rules
- Unfiled lists attachments already in your database
- Field attachments such as product images are left out
- A wizard files a whole selection with tags and an owner
- Nothing is copied or moved on disk
- Remove From Folder unfiles without deleting
- Tags cross folders, so one query answers everywhere
- Coloured tags with a live document count
- Multi-select tag facet in the search panel
- An owner and a filing date on every document
- Group by folder, owner, related record or upload date
- Folder tree sidebar with live counts and a tag facet
- Kanban, list and form views of every document
- Filters for mine, unfiled, PDFs and images
- Filter for documents not attached to any record
- Two roles: Documents User and Documents Manager
- Build the folder tree. Create top-level folders such as HR, Finance and Legal, then the subfolders under them. The full path is computed for you.
- Grant access. Set Readable By and Writable By on the top folders and leave Inherit From Parent on, so subfolders follow the cabinet.
- Create tags. Contract, Invoice, Policy, Signed. Tags cross folders and answer the questions the tree cannot.
- File what is already there. Open Documents, then Unfiled, select the attachments and choose Actions, then File Into Workspace.
- Upload new documents. Upload straight into a folder, or file an attachment from any record without detaching it from that record.
- Search. Type any word. The search reads the name, the description and the text inside the file, within the folders you are allowed to open.
- Copy the module. Place the dms_workspace_aura folder in your Odoo addons path.
- Install pdfminer.six. Run pip3 install pdfminer.six so PDF text can be extracted.
- Update the apps list. Activate developer mode, then choose Apps and Update Apps List.
- Install Document Workspaces. Search for it in Apps and install. The Documents menu appears at once.
- Folder tree with computed paths and document counts
- Readable By and Writable By groups with parent inheritance
- Effective access groups shown read-only on every folder
- Full-text search across name, description and file content
- Text Inside Files search field and Has Extracted Text filter
- Coloured tags with counts and a search panel facet
- Unfiled view and the File Into Workspace bulk wizard
- Remove From Folder action that never deletes a file
- Documents User and Documents Manager roles with record rules
- 52 unit tests and 2 browser tours
- The author can leave a single reply to each comment.
- This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
- If you want to start a discussion with the author or have a question related to your purchase, please use the support page.
Screenshots & Previews
1 image availableExpand Preview
The AuraOdoo Quality Guarantee
100% Tested
Verified with Odoo 17, 18, and 19 test pipelines for stability and no conflicts.
Clean Architecture
Built according to official Odoo guidelines and PEP 8 standards with zero bloat.
Dedicated Support
Free installation assistance and quick bug turnaround from our team.