Skip to main content

Documents

A document is the project document-control record in Drixal ERP: metadata, attachments, and a multi-stage review workflow — or Upload Only with no workflow.

Navigation: Sidebar → Document Management → Documents
Pages: /Entities/DMS/Document · /Entities/DMS/Document/new · /Entities/DMS/Document/{id}
Useful queries: ?tab=workflow · ?tab=logs · ?attachmentsTab=supporting · ?LinkedDocumentId=

The record page is the workspace (details & attachments, workflow, logs).

What this screen does​

  • Links the file to a DMS project, document type, and contractor when needed
  • Manages the main attachment and supporting files
  • Runs a review workflow with a current reviewer and stage progress
  • Supports migrated documents, Upload Only mode, and linked prior documents (LinkedDocument)

Document list​

Views: list and cards.

Columns​

ColumnMeaning
Document Title (name)name with Migrated / Upload Only badges and document type as subtitle
Current reviewerWho is pending action
ContractorLinked contractor
DMS project (dmsProject)Project
Workflow progressStage progress
ActionsWorkflow step, download latest, delete

Filters​

FilterUse
NameSearch by name
ContractorContractor
DMSProjectDMS project
DocumentTypeDocument type
SourceAll · Migrated · NewSystem
Workflow kindAll · UploadOnly · WithWorkflow
Pending OnPending on user (PendingOnUsrIds)

Create a document​

Page: /Entities/DMS/Document/new

Required fields​

FieldNotes
Document type (DocumentType)Drives rules: files, extensions, disciplines, workflow or upload only
Code / nameOptional Prefix from the type’s prefixes
DMS project (DMSProject)Project link
EntityType / EntityStatusEntity type and status on the form
Data confidentiality (DataConfidentiality)Confidentiality classification when shown on the form

For a multi-discipline type, select at least one technical discipline (isTechnical).

Optional fields​

FieldNotes
ContractorContractor link
nameArArabic name
description / descriptionArDescriptions
LinkedDocumentPrior document via query; locks type, prefix, contractor, project, and disciplines

Record tabs​

TabPurpose
Details & AttachmentsIdentity + main attachment (Document) and supporting files (DocumentSupporting)
WorkflowReview stages; hidden for Upload Only and unsent new records
LogsChange trail

Lifecycle and workflow​

ModeBehavior
Draft / PendingEditable; Submit Document needs ≥1 attachment, then locks for review (unless Upload Only)
Stage changeChange status → save / Submit & Next; comment required to advance
Send Letter to OwnerWorkflow dialog option sent with the work-item payload
ApprovedBanners for Approved / Approved with Comments / Code-A / Code-B and matching Arabic statuses
RejectedBanners for Rejected / Code-C / Code-D; contractor can Reopen as Draft
Upload OnlyNo workflow and no submit for review; permanent badge; header often read-only after create
MigratedBadge when oldKey / OldKey is set
LinkedDocumentCopies/locks type, contractor, and project from the prior document

Submit steps (with workflow)​

  1. Create the document as a draft with type, project, and code
  2. Upload at least one main attachment
  3. If required, select technical disciplines for a multi-discipline type
  4. Select Submit Document
  5. On the Workflow tab, change status with a comment on Submit & Next
  6. Use Send Letter to Owner when needed
  7. On reject (contractor portal), Reopen as Draft, correct, and resubmit

Common mistakes​

  • Submit without an attachment
  • Missing disciplines for multi-discipline types
  • Skipping the comment on Submit & Next
  • Trying to edit the header after leaving draft (non-draft / Upload Only → partly read-only)

Best Practices​

Upload the file before submit

Submit rejects the path without a file. Prepare the final version first.

Comment is required to advance stages

Do not skip the comment on “Submit & Next” so the review trail stays complete.

Upload Only skips review

If the type is Upload Only, the Workflow tab does not appear and the document is not sent for review. Choose the correct type before create.

Linked document locks fields

With LinkedDocumentId, type, prefix, contractor, project, and disciplines lock with a copy banner.