Workspaces, faceted tags, and access control
Hierarchical workspaces, multi-dimensional faceted tags, role-based workspace permissions, and external portal sharing.
1. Overview & Business Value#
This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Workspaces, faceted tags, and access control within SmartERP.

In SmartERP Documents Enterprise, document organization is managed through two complementary systems: Hierarchical Workspaces (defining storage boundaries and access permissions) and Faceted Tags (enabling multi-dimensional discovery).
2. Prerequisites & Security Access Groups#
- Required Modules:
documents, smarterp_dms - Security Groups:
Documents User(Technical ID:documents.group_documents_user)Documents Administrator(Technical ID:documents.group_documents_manager)
- Master Data Dependencies: Workspace hierarchies, document tags, automated actions, OCR rule definitions, and retention policies.
3. Step-by-Step Configuration & Execution#
Step 1: Navigating to the Interface#
- Log into your SmartERP instance at
https://smarterp.et/odoo. - Open the main App Switcher (grid icon in the top-left corner).
- Navigate to Settings → Technical.
Step 2: Operational Data Parameters & Controls#
Ensure all mandatory parameters comply with enterprise operational standards:
- Authorized Operator: Action executed under assigned RBAC permissions (System Administrator, Certified Specialist).
- Relational Integrity: Linked to upstream master records, approval requests, or transactional ledgers.
- Statutory & Quality Controls: Verified against Ethiopian statutory regulations and corporate governance standards.
Step 3: Operational Execution & State Progression#
- State Progression Gate: Advance record from Draft through Audited to Confirmed / Certified.
- Integrated System Impact: Automatically updates real-time operational states and posts financial/inventory journal moves.
- Audit Verification: System registers tamper-evident audit records logging user ID, timestamp, and cryptographic transaction digests.
Workspace hierarchy and security rules#
Workspaces (documents.workspace) structure the organization's document repository into parent-child trees:
Company Repository
├── Finance & Accounting
│ ├── Invoices & Bills (AP/AR)
│ ├── Bank Statements
│ └── Tax Filings & VAT
├── Human Resources
│ ├── Contracts & Offers
│ ├── Identification & Credentials
│ └── Payroll Slips
├── Operations & Projects
│ └── Project Deliverables
└── Legal & Corporate Governance
├── Board Resolutions
└── Registered Letters (DMS)
Access Control Levels#
Each workspace defines permissions per user group or individual:
- Read Only: Users can preview, search, and download documents, but cannot upload or modify tags.
- Read / Write: Users can upload new files, edit metadata, apply tags, and create revisions.
- Manager: Full administrative control over the workspace, including deleting documents, moving folders, and configuring tag categories.
Faceted tag categories (Facets)#
Unlike rigid folder structures where a file can only exist in one location, SmartERP Documents supports multi-dimensional faceted tagging:
flowchart TD
DOC[Document: Vendor_Agreement_2026.pdf]
DOC --> F1[Facet: Department -> Legal]
DOC --> F2[Facet: Document Type -> Contract]
DOC --> F3[Facet: Status -> Active]
DOC --> F4[Facet: Fiscal Year -> 2018 E.C. / 2026 G.C.]
Facets allow cross-cutting filters: for instance, finding all Contracts across all departments that have a status of Pending Renewal.
External sharing and secure upload links#
Documents and entire workspaces can be shared with external third parties (clients, auditors, vendors) without requiring an Odoo user account:
- Read-Only Download Links: Generates an expirable tokenized URL with optional password protection.
- External Upload Dropboxes: Creates an upload drop link allowing external suppliers or candidates to securely upload documents directly into a designated workspace.
4. Advanced Configuration Points#
- Automated Actions & Scheduled Tasks (Crons):
Documents: Run OCR field extraction(documents.ir_cron_ocr_process): Runs every 15 minutes to process incoming scanned document textDocuments: Archive expired records(documents.ir_cron_retention): Runs weekly to enforce statutory document retention schedules
- Custom Print Templates & Reports:
- Document Audit Trail & Access Log
- Workspace Document Storage & Activity Ledger
- Multi-Company Rules: Record-level security isolation under Company 1 (
Ashewa Technology Solutions S.C.), preventing cross-company ledger leakage across parent and subsidiary legal entities.
5. Comprehensive Troubleshooting Matrix#
| Error Symptom / Exception | Probable Root Cause | Corrective Action / Resolution |
|---|---|---|
Access Rights Error: Workspace access restricted | User lacks permissions for confidential legal or HR workspace. | Request workspace access clearance from Documents Administrator. |
OCR Extraction Failure: Low scan resolution | Scanned image DPI is below minimum threshold for optical character recognition. | Upload document at minimum 300 DPI resolution with clear contrast. |
Upload Blocked: File size exceeds maximum limit | File exceeds system maximum attachment size. | Compress file or upload via secure external cloud link. |