Documents

Modified on Fri, 25 Sep at 3:37 PM

Documents

Cora PPM End-User Guide

A working guide to the Documents feature in Cora PPM — what it is, why teams rely on it, how manufacture-to-order, pharma, capital projects, and government-contracting customers typically configure it, and step-by-step instructions for everyday use.

Quick Facts

Lives At

Project, Company, Task, Risk, Issue, Register & Benefit level

Version Control

Check-out / check-in, toggled per project type

On Every Upload

Automatic virus scan

Storage

Database or File System — admin-configured


1. What is Documents?

Documents isn't one screen — it's a repository capability that shows up everywhere a project needs supporting files. The same document engine appears in several places, and it behaves identically wherever you meet it — same categories, same check-out rules, same custom fields:

  • Project Documents — the main tab on a project, for anything tied to that specific project.

  • Company Documents — an organisation-wide area for files not tied to any one project, such as templates or standard specifications reused across many jobs.

  • Task Documents — a lighter document list inside a task on the Task Manager / Gantt.

  • Linked-Entity Documents — Risks, Issues, Cost Book Estimations, Cost Book Budgets, Custom Registers, and Benefit records each carry their own attached documents, filtered inline from the same repository.

At its core, Documents lets you upload a file or link to one already stored elsewhere, file it under a category, describe it with whatever custom fields your organisation has defined, and — where a project type requires it — lock it while someone edits it so two people can't overwrite each other's work.


2. Why Does a Customer Use It?

  • One File, Many Owners: A document uploaded once to a project can be linked — not copied — onto a Risk, an Issue, a Task, a Register entry, or a Benefit. Everyone points at the same file, so there's only ever one version to go stale.

  • Version Control Without the Chaos: Where check-out is switched on, checking a document out stops anyone else changing it until it's checked back in. The version number increments automatically and the swap is written to project history.

  • Governance That Runs Itself: Every upload is scanned for viruses before it's usable, zip archives can be checked for disallowed file types hidden inside them, and an administrator can hand a document off to an external records system (EDRMS) for formal retention.

  • Speaks Your Industry's Language: Categories and custom Document Fields are configured by your own administrator, so a document can carry a Drawing Number, a CLIN, a Batch ID — whatever term your business actually uses — without waiting on custom development.


3. Common Use Cases by Project Type

Documents ships as a set of general-purpose building blocks — categories, custom fields, check-out, PDF markup, and the EDRMS hand-off. Below is how each of these project types typically arranges those blocks. None of this is a pre-built template inside Cora PPM — your administrator sets it up using the configuration screens covered later in this guide.

Manufacture-to-Order (MTO) ?

  • Categories for Engineering Drawings, Bill of Materials, Customer Purchase Orders, Test/Inspection Certificates, and Shipping Documents.

  • Check-out switched on for drawings and BOM revisions, so a design change mid-build can't be overwritten by a second edit.

  • Custom fields such as Drawing Number, Revision Class, and Work Order Reference.

  • The approved drawing is linked directly onto the shop-floor Task it's being built against, instead of a second copy floating around.

  • Document Markup used to redline a drawing PDF during design review.

Pharma & Life Sciences ?

  • Categories for Protocols, Batch Records, SOPs, Validation/Qualification evidence (IQ/OQ/PQ), and Regulatory Submissions.

  • Check-out switched on broadly — controlled documents, one editor at a time.

  • Custom fields such as GxP Classification, Effective Date, and Study/Protocol ID.

  • Controlled copies handed off to an EDRMS for validated, retention-governed storage outside Cora PPM.

Worth Knowing: Cora PPM does not include electronic signature or a Draft / In Review / Approved workflow state on documents out of the box. If your quality process needs e-signature or a formal approval chain, that has to be satisfied by the EDRMS or QMS the document is pushed to — or by applying the generic Workflow module to a custom register — not by the Documents grid itself.

Capital Projects ?️

  • Categories for Design Basis, Permits & Approvals, Contractor Submittals, Cost Estimate Backup, and Progress Photos.

  • Custom fields such as Discipline, Submittal Number, and Contract Package.

  • Backup documents linked directly onto the Cost Book Estimation or Budget line they support, so the evidence travels with the number.

  • Standard specifications and drawing templates held in Company Documents and reused across every capital project.

Government Contracting (GovCon) ?️

  • Categories for the Contract & its Modifications, CDRLs, Compliance/Audit Evidence, and Past Performance.

  • Custom fields such as CLIN, Deliverable Due Date, and Classification/Distribution Statement.

  • Check-out on, plus an EDRMS hand-off where the contracting agency requires records to live in a specific system of record.

  • The zip-content extension check is worth confirming with your security office — GovCon environments often mandate file-type allow-lists on inbound attachments.


4. Acronyms Used on This Page

Terms shown as code below are literal Cora PPM interface or configuration values. Others are industry terms customers commonly map into a category or custom field — Cora PPM has no built-in knowledge of them.

Acronym

Stands For

Context

PPM

Project Portfolio Management

The product category Cora PPM belongs to.

EDRMS

Electronic Document and Records Management System

Cora PPM term — the external system a document can be pushed to or pulled from for formal retention.

MTO

Manufacture-to-Order

Project type discussed in this guide.

GovCon

Government Contracting

Project type discussed in this guide.

GxP

Good "x" Practice (e.g. GMP, GLP, GCP)

Industry term; a common custom Document Field value in pharma, not a Cora PPM concept.

CDRL

Contract Data Requirements List

Industry term; a common GovCon document category.

CLIN

Contract Line Item Number

Industry term; a common GovCon custom Document Field.

IQ / OQ / PQ

Installation / Operational / Performance Qualification

Industry term; pharma validation evidence categories.

SOP

Standard Operating Procedure

Industry term; a common pharma document category.

PDF

Portable Document Format

The only file type Document Markup (annotation) supports.

DB / FS

Database / File System

Cora PPM term — the two places uploaded files can be physically stored, set by an administrator.


5. Step-by-Step Guide

Every walkthrough below applies wherever you find a Documents list — Project, Company, or Task — unless a step says otherwise.

Reading the Screen

The left-hand pane lists categories, each showing how many documents it holds. The Hide Empty Categories / Show Empty Categories button trims the tree down to categories that actually contain something. The right-hand grid lists the documents in whatever you've selected, with columns for file type, category, check-out status, name, version, a Properties link, who added it and when, file size, and (for PDFs) markup.

Uploading a New Document

  1. Click the category you want the document filed under in the left-hand tree, then click Add above the grid.

  2. Stay on the Upload Files tab. Drag your file onto the drop zone, or use the file picker — you can select more than one file at once.

  3. Save. The file is uploaded, virus-scanned, and appears in the grid under the category you chose.

If a document shows as disabled or won't open right after upload, the virus scan probably hasn't cleared it yet — see the FAQ below.

Adding a Hyperlink Instead of a File

  1. Click Add, then switch to the Link to Document tab.

  2. Set Type to HyperLink. Enter a Name and a Link — the link must start with http:// or https://.

  3. Save. The link appears in the grid like any other row, minus a file size — clicking the name opens it in a new tab.

Linking an Existing Document Onto Another Record

Use this instead of uploading a second copy when the same file also belongs on a Risk, Issue, Task, Register entry, or Benefit.

  1. Open the target record and click Add on its Documents section.

  2. Switch to Link to Document, set Type to Project Document. The existing project document list appears with a Link Document checkbox column.

  3. Tick the document(s) you want and Save. The record now shows the document without a second file having been stored anywhere.

A linked document can't be deleted from its original location until it's unlinked everywhere it's used.

Editing a Document's Properties

  1. Click Properties on the document's row (shows as View instead if you only have read access).

  2. Update Name, Link, Category, or "Available for Markup", plus any custom fields your administrator has added.

  3. Save.

Checking a Document Out and Back In

Only appears if your administrator has switched on check-out for this project type. If you don't see a Check In/Out column, this project doesn't use it.

  1. Click Check Out before you start editing your local copy. The row now reads Check In for you, and Checked Out (with your name in a tooltip) for everyone else — they can't check it out or delete it while you hold it.

  2. When you're done, click Check In. Upload the revised file — keep the same file name. If you check in without choosing a new file, you'll be asked to confirm that's intentional.

  3. Save. The version number increments by one and the check-out/check-in is recorded in project history.

Only the current version is kept — there's no browsing of prior revisions, so treat the version number as a change counter rather than a full revision archive.

Marking Up a PDF

Only available where your organisation has licensed and enabled Document Markup, and only for PDF files.

  1. Click the Markup icon on a PDF row (shows as a view-only eye icon if the document is checked out by someone else, or if you only have view rights).

  2. Add your annotations and save. The icon changes to show the document now carries markup, so reviewers can tell at a glance which files have comments on them.

Renaming, Exporting, and Deleting

  • Rename — open the rename option from the document's row, update the Document Name and, if needed, its Category. The file extension can't be changed.

  • Export the List — use Export to Excel on the grid toolbar to get the current document list as a spreadsheet.

  • Delete — click the delete icon on the row. It's disabled — with a tooltip explaining why — if the document is currently checked out or currently linked to another record; resolve that first.


6. For Administrators

What to Configure

Where

Effect

Custom Document Fields

Document Fields admin screen

Add labelled fields (text, number, date, dropdown, user list, or checkbox), mark them required, and choose whether they show as a grid column by default.

Categories

Categories admin screen

Define the folder structure documents are filed under, restrict which categories accept uploads, and control portal visibility.

Check-Out

Project Type configuration (with a per-project override)

Turns the Check In/Out column and lock behaviour on or off.

Storage Location

General Document Configuration

Choose whether uploaded files are stored in the database or on a file-system path.

Zip Content Check

General Document Configuration

Blocks disallowed file types hidden inside uploaded zip archives.


7. FAQ

 Where Do I Find Documents for a Specific Project?

Open the project and go to its Documents tab. That's separate from Company Documents, which holds files not tied to any one project — templates, standard specs, and the like.

 Can I Attach the Same File to More Than One Record Without Uploading It Twice?

Yes — use Add → Link to Document → Project Document on the target record and tick the file you want. It links the existing document rather than storing a second copy.

 Why Can't I Delete a Document?

The delete icon is disabled while a document is checked out by someone, or while it's linked to another record. Check it in, or unlink it everywhere it's used, and the delete option reappears.

 I Don't See a Check In/Out Column — is Something Wrong?

No — check-out is switched on per project type. If your administrator hasn't enabled it for this project, the column simply doesn't appear and documents can be edited freely.

 What Happens to the Old File When I Check In a New Version?

The version number goes up by one, but only the current file is kept — there's no screen for browsing or restoring earlier revisions. Treat the version number as a change counter, not a full revision history.

 Does Cora PPM Support Electronic Signatures or a Formal Approval Workflow for Documents?

Not on the Documents grid itself — there's no built-in Draft / In Review / Approved status or e-signature capability. If your process requires either, it has to be met by the external EDRMS or QMS a document is pushed to, or by applying the generic Workflow module to a custom register.

 What is the EDRMS Hand-Off, and Do I Need to Use It?

EDRMS stands for Electronic Document and Records Management System — an external system Cora PPM can push a document to (or pull one from) for formal, validated records retention. It's an administrator-configured integration; most day-to-day users won't interact with it directly.

 A Document Won't Open and Its Row Looks Greyed Out — Why?

Every upload is virus-scanned automatically. Anything that isn't confirmed clean — scanning in progress, scan error, or a detected threat — is shown disabled with most actions suppressed until it resolves.

 Can I Annotate a PDF for Review?

Yes, if your organisation has Document Markup enabled — it works on PDF files only. You'll see a view-only version if the file is checked out by someone else or you don't have edit rights on it.

 Where Are Documents Actually Stored?

Either in the database or on a file-system path, depending on a system-wide setting your administrator controls. It has no effect on how you use the screen day to day.

 Can I Select Several Documents and Delete or Download Them All at Once?

No — delete, check-in/check-out, and markup are all per-row actions today. Exporting the whole list to Excel is available from the grid toolbar if you need an overview to work from.

 Who Can Edit Documents Versus Just View Them?

It depends on your role and the context. Admin and User roles can generally add and edit; a Monitor role or portal-only access is typically view-only, and portal users only ever see categories your administrator has flagged as available in the portal.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article