SP-2065 2012 Document Management For Projects
SP-2065 2012 Document Management For Projects
SP-2065 2012 Document Management For Projects
L.L.C.
Document Management in Engineering
Projects
Document ID SP-2065
Security Unrestricted
Revision 4.0
Document -2- Restricted
No.
This document is the property of Petroleum Development Oman, LLC. Neither the whole nor
any part of this document may be disclosed to others or reproduced, stored in a retrieval
system, or transmitted in any form by any means (electronic, mechanical, reprographic
recording or otherwise) without prior written consent of the owner.
Petroleum Development Oman LLC Revision: 4.0
Effective: Aug-
11
I Document Authorisation
II Revision History
The following are brief revision summary of this document. Details of all revisions prior
to these are held on file by the issuing department.
The related CMF Documents can be retrieved from the CMF Business Control Portal.
Table of Contents
1. INTRODUCTION............................................................................................... 6
1.1. Executive Summary...............................................................................6
1.2. Purpose.................................................................................................. 6
1.3. Scope..................................................................................................... 6
1.4. Distribution / Target Audience................................................................6
1.5. Review and Improvement.......................................................................6
1.6. Step-out Approval..................................................................................6
1.7. Definitions and Abbreviations.................................................................7
1.7.1. Abbreviations.............................................................................7
1.7.2. Definitions..................................................................................8
2. DOCUMENT MANAGEMENT STRATEGY............................................................9
2.1. General Control Protocol........................................................................9
2.2. Document Planning................................................................................ 9
2.2.1. Design Document Planning........................................................9
2.2.2. Vendor Document Planning........................................................9
2.3. Document File Format..........................................................................11
2.3.1. General Format........................................................................11
2.3.2. Sets and Sizes of Files..............................................................11
2.3.3. Document Title - Guideline.......................................................12
2.3.4. Drawing Practice......................................................................12
2.4. Document Handover............................................................................ 13
2.4.1. Design Document Handover....................................................13
2.4.2. Vendor Document Handover....................................................13
2.5. As-Built Update Strategy......................................................................14
2.6. Correspondence Numbering and Control.............................................15
3. ROLES AND RESPONSIBILITIES.....................................................................16
4. DOCUMENT REVIEW AND EXCHANGE...........................................................18
4.1. Collaboration Media.............................................................................. 18
4.2. Exchange of Documents.......................................................................18
4.2.1. Document Transmittal..............................................................18
4.2.2. CSV Files.................................................................................. 18
4.3. Review and Return of Comments.........................................................19
4.3.1. Review of Document................................................................19
4.3.2. Cancelling Document...............................................................19
4.3.3. Return of Comments................................................................19
4.4. Document Approval.............................................................................. 20
5. DOCUMENT TAXONOMY................................................................................21
5.1. Document Numbering..........................................................................21
5.2. Issue and Status Code..........................................................................21
5.3. Revision Convention and Control..........................................................22
5.3.1. Review Return Codes...............................................................22
5.4. Renumbering of “Old System” Documents...........................................23
5.5. Vendor Documents Numbering............................................................23
6. APPENDIXES................................................................................................. 24
Appendix 1 – User Feedback Form................................................................24
1. INTRODUCTION
1.1. Executive Summary
PDO engineering function has adopted an Information Management (IM) strategy that delivers
a common framework for IM practice in PDO and shall be used in conjunction with the
requirement of Engineering Information Specification (EIS); Project Contract Scope of Work SP-
2144; Project Data Specification SP-2142; Handover and As-Built Documentation SP-1131; and
Plant Lifecycle Information Plan (PLIP) SP-2143.
They constitute the body of business control documentation supporting the implementation of
document management in engineering projects.
1.2. Purpose
The purpose of this procedure is to define the requirements for Document Management in
Engineering Projects. The requirements comprise:
documents requirement planning
document taxonomy
document development, issue, review, approval and update
document exchange process and tools
Document exchange process refers to the flow of documents within the project team as well as
between the project team and external parties.
1.3. Scope
This document specifies the document management standard to be implemented in
Engineering project(s) and Operations. It covers the general strategy for document
management, Vendor requirement, review and exchange method and taxonomy. It defines the
relationships, roles and responsibilities of project team members, IM team, Contractor(s) and
Vendor(s) during the implementation.
Standards Variance (Projects) prior to any changes or activities associated with the
specification being carried out.
1.7.1. Abbreviations
In addition to the glossary and definition on the EIS, the following specific definition of
abbreviations applies:
AIC Asset Information Center
AI-PS Asset Integrity Process Safety
CSV Comma Separated Values, a document format that allows data exchange
between different applications.
CMMS Computerized Maintenance Management System
DCC/DC Document Control Centre / Document Controller – Office / individual(s) that
provides all document control services as outlined on this document.
DCAF Discipline Control and Assurance Framework
DCS Document Control System - System set up and used by DCC/DC to provide
document control services during the life of a project.
DDR Document Deliverables Register – list of all project deliverables to be
delivered in a project.
DRM Document Review Matrix – distribution of all project deliverables as listed on
the DDR
EDMS Electronic Document Management System (Livelink) – PDO system used for
document storage/retrieval
EPC Engineering Procurement and Construction
EMC Engineering Maintenance Contract
EOIM Engineering and Operations Information Management
ERP Enterprise Resource Planning
EPC, External Project Contractor responsible for all or part of the Design,
EMC, Engineering, Procurement, Construction, Commissioning or Management of
ODC etc a project, or operation or maintenance of a facility
FID Final Investment Decision
FTP File Transfer Protocol; the platform that allows document exchange between
project team and external parties.
IDC Inter-Discipline Check; review cycle involving team members/disciplines
outside the originating discipline/team
IM Information Management
ITT Invitation To Tender
PDF Portable Document Format - Application or Scanned rendition format for
read only files.
PDO Petroleum Development of Oman LLC of Muscat, Sultanate of Oman
PCAP Project Control and Assurance Plan
PM Project Manager
PDMS Plant Design Management System
RFI Form filled by the originator or responsible engineer of a document
Page 7 of 29 SP-2065: Document Management in Engineering Projects Printed: March 30,
2017
The controlled version of this CMF Document resides online in Livelink®. Printed copies are UNCONTROLLED.
Petroleum Development Oman LLC Revision: 4.0
Effective: Aug-
11
1.7.2. Definitions
Milestones will be set against the attained development status each document has reached
i.e. IFR, AFD, AFC etc. The document maturation progress can be measured as a percentage at
each new status attained.
The VDS also includes planned submission or due dates listed against each document stating
an estimated time for each initial document submission. Once reviewed and returned the
Vendor will be required to re-submit the revised VDS in line with any comments received and
subsequently submit updated VDS monthly or as agreed with Project team.
Typically the Vendor will include a CSV file with each VDS submission which will be uploaded
into the Project document control system. Each purchase order can be set up as an equipment
Work Package in the document control system against which the Vendor VDS can be loaded.
As documents are reviewed, returned and approved a percentage of overall completeness can
be rolled up against the work package. Overall package completeness will be dependent on
the current approval status of documents loaded against a given Purchase Order. When all
deliverables have been finally approved the Purchase Order would have reached 100%
completion within the document control system system.
Failure to comply with this requirement may result in delays to the Project Schedule. Meeting
deliverable dates for Vendor Documentation is critical to project success and therefore, once
agreed upon, can only be altered with consent of project team.
pdf with signature page signed and inserted; the Vendor or Contractor has to demonstrate that
a particular deliverable item could not be delivered in native format
Where dates are held in databases the format shall be DD-MM-YYYY e.g. 05-10-2010 while
dates used on correspondence, etc shall be e.g. 12 December 2007.
2.3.2. Sets and Sizes of Files
File size for document shall be 20Mb. Lager files like 3D-CAD design files, some Vendor
deliverables and document delivered in multiple renditions (e.g. doc and PDF), etc can be
delivered but shall be split into smaller files, assembled into sets and delivered against a
single document number revision. When splitting lager files into smaller files, the following
shall apply:
Split the document at natural section breaks (indicated by section markers).
If the document has no natural section breaks but exceeds the allowable file size, the
document shall be
Split into allowed file-size limit.
When assembling split files into sets of files, the following shall apply:
1. Nominate the primary document and treat it in the same way as any other document,
giving it a document number (primary), and revision.
2. Assign the same document number and revision to all other (secondary) files in the Set,
but name each with a Document Title reflecting the sequence of the files, as they
should appear in the complete document.
Acceptable examples are:
1. Vendor Manual Centrifugal Pump Model XYZ Sections 1 to 5 (primary)
Vendor Manual Centrifugal Pump Model XYZ Sections 6 to 10 (secondary)
Vendor Manual Centrifugal Pump Model XYZ Appendix 1 (secondary)
Vendor Manual Centrifugal Pump Model XYZ Appendix 2 (secondary)
2. Compressor Station Layout PDF(primary)
Compressor Station Layout dwg (secondary)
Compressor Station Layout xls (secondary)
Character Size
The Vendor shall at all times ensure that Sub-Vendor’s documents, etc prior to submission to
Contractor or PDO is contractually and grammatically correct. For those activities provided by
a sub-vendor, the sub-vendor data (contact, etc) shall be clearly documented.
Vendor Data Book and Manuals Index:
Section 1: Purchase Order and Sub-Orders
Section 2: Certificate of Compliance
Section 3: Waivers and release notes
Section 4: Independent Verification Body Release Notes
Section 5: Material and Test Certificates
Section 6: Welding Records
Section 7: Weight Data
Section 8: Quality Control and Inspection/Test Plan
Section 9: Drawings
Section 10: Operating and Maintenance Manuals (in separate binder) with index:
Section 1: Vendor/PO particulars
Section 2: Commissioning
Section 3: Operations
Section 4: Maintenance
Section 5: Spare Parts Data
Section 6: Lubrication
Section 7: Fault Finding and Corrections
Section 8: Document Reference list
Section 9: Drawings related to operation and maintenance
2.5. As-Built Update Strategy
All native file of As-Built drawing are domiciled and controlled at the AIC.
Rendition facility in Assai, and or CAD application used, shall be the platform for
creating drawing rendition during As-Built update process.
When multiple projects (A, B & C) requires updating the same As-Built drawing, the AIC
creates a rendition of the master As-Built file for each project (one for construction and
one for demolition), and append a project code each to the document number.
Each project (A, B, or C) continues to work (demolition and/or construction), modifying
As-Built as it affects their project requirement.
However if project B (for example) completes their work ahead of project (A and C) and
is ready to make actual update on the master file, then they request AIC to check out
and reserve the master file for final As-Built update. Note: If project B and C were
finished simultaneously and the As-Built update was carried out by the same Contractor,
the Contractor can make update on the master As-Built at the same time for the two
projects and indicate on the title block that the As-Building was done together for the
two projects.
Master file shall be checked out for a maximum of 10 working days, otherwise the
reservation becomes invalid and As-Built becomes available for another project check
out.
During final As-Built update, Project B updates the master file, steps-up revision by 1.
before returning the updated copy to AIC.
The AIC updates existing master file in the system with revision received from Project B.
Quality Management The Document Controller will ensure that the correct template,
document number, revision status and title are on a document
prior to issue or distribution, and will facilitate the timely document
review turnaround. The responsible Engineer shall ensure that
document is developed using the correct template and that all
meta-data are populated on the document.
The purpose to ensure that all Engineering Project documentation sent to PDO is received and
returned via formal communication channels and to standards and formats that have been
agreed between the Project and its contracting partners. Failure to agree upon a standard
approach for the receipt and return of deliverable documentation will lead to unnecessary
delay and possible financial loss among all parties working on the Project.
Note that the FTP site has a limited size hence documents sent by the first party should be
removed and stored in appropriate location once received by the other party. Documentation
sent via any other communication medium will not be accepted unless prior approval has been
sought and granted by the project team.
4.2. Exchange of Documents
Internal document issued within project team shall be under the cover of an internal
transmittal. Internal document distribution shall be according to the distribution matrix or
completed RFI. External document issued to or from the project team for the purposes of
review, approval or information should be placed to the FTP or Livelink extranet site under the
cover of a transmittal. An E-mail notification should be sent to relevant DCC notifying them
about the placement.
4.2.1. Document Transmittal
Both internal and external transmittals should contain the following information as a minimum:
Unique Transmittal Number
Purpose for Issue
Transmittal Date
Expected due date for (return of comments)
Project Document Number
Document Title
Revision Code
Document Status Code
Sender: Address, telephone, fax and e-mail details
Name of Sender
Purchase Order or Contract Number (For Vendor or Contractor)
CSV Template.xls
All comments made as a result of formal review of project external documentation shall be
returned via the DCC. DCC shall communicate comments via the dedicated project FTP or
Livelink extranet site under the cover of an external transmittal while following-up with an
email notification to the receiver advising comment placement.
Project team members will be trained to use AssaiWeb to enable them review and provide
comment (directly to ASSAI comment template or to mark-up and load to Livelink) on
document assigned to them. Hands-on training shall be provided by the DCC team but users
will benefit primarily from ‘learning by doing’. With this in mind, DCC will always be available
to provide one-on-one assistance when required.
There will be two primary ways to use Assai/LL while providing comments:
1. Entering comments directly using comment template on AssaiWeb referencing the
appropriate section(s) of the document being reviewed, or
2. Marking-up hardcopy drawing or electronic copy of the document and sent to DCC, who will
upload it to the same folder on Assai/Livelink containing the document under review. In this
case, the reviewer must indicate as comments, in AssaiWeb comments template that
his/her comments have been submitted by mark-up.
Document shall jointly be approved by the TA or document owner and, or PM (or delegate)
electronically (via Assai) before signing on the hardcopy (if required), when the electronic
approval is considered insufficient. When a document is issued for approval (IFA), it should
only be issued to designated approver as shown on distribution matrix; the remaining review
parties during the IDC review gets it FYI.
Drawing shall be checked and approved by the originating party at each revision submittal.
This shall be applicable for both Master Drawing and Project drawing changes.
Drawings shall not be accepted by PDO Engineering Drawing Office (AIC), unless the applicable
boxes on the Revision history have been completed by the Contractor and sign off by the
applicable Technical Authority.
5. DOCUMENT TAXONOMY
5.1. Document Numbering
Origina Discipli
Area Unit/Pla Documen Sequen Sheet
tor ne
Code nt Code t Type tial No. No.
Code Code
Alpha/ Numeric
Alpha Alpha Numeric Numeric Numeric
Numeric (6)
(3) (2) (4) (5) (4)
(2)
Area Code: As defined in Corporate ERP System (SAP) (level 5). This code will be supplied
by the Asset Information Centre (AIC) via the “Request / Advice / Record Form” see
Appendix 4
Unit/Plant Code: As defined by the Asset Information Centre (AIC) for new and existing
facilities. This code will be supplied by the AIC on the “Request / Advice / Record Form” see
Appendix 4
Originator Code: As defined in Corporate ERP System (SAP) for existing
organizations/entities registered as vendors (i.e. SAP vendor list). When the document is
generated by project team, the code is “000000” while if the document is generated by a
Contractor, then the code becomes the SAP registration code for that PO, or Contract.
NOTE: Updates to drawings that already have an Originator Code should retain the existing
Originator code.
Discipline Code: Refers to the technical discipline to which the document is
predominantly related.
Document Type: A standard 4-character numeric code denoting the type of document
based on content. This is the main classification code for documents and is based on the
standard list of allowable document types in EIS.
Sequential Number: A five digit numeric field starting from 00001, denoting one unique
document in that discipline and document type pattern; however where there are many of
the same document type pattern produced during the life of Project, the next will take
00002, etc.
Sheet Number: 4-digit number identifying the number of sheets applicable to that
drawing number. Shall start with 0001. Documents with a front sheet shall have “0000”.
Single sheet documents (e.g. General Arrangement Drawings, Detail drawings, Schematics,
Data Sheets, etc.) shall always be designated as ‘Sheet 0001’. Where additional
information is continued on to subsequent sheets, those sheets shall be numbered as Sheet
0002, 0003 etc. In this situation the drawing title block shall clearly identify the sheet
number as part of a set (e.g. Sheet 1 of 2).
For clarification, a sheet is a separate electronic file. Multiple pages within a single file
(such as a line list) should be noted as pages, not sheets. For the purpose of project
execution activities, dispensation may be applied for the use of document grouping to
facilitate effective document review and approval. However during final submission, these
grouped documents shall be split back to single sheet before delivery to PDO.
During Demolition
01 (first Plot Plan IFX IFX A
issue)
be clearly marked as such on the VDS. Superseded or cancelled document numbers shall on
no account be re-allocated to newly created documentation.
6. APPENDIXES
User Feedback
Form.docx
Vendor document
requirement listing.doc
Request-Advice-Rec
ord Form.xlsx
Document Status
Description 2.docx
Vendor A4 Document
Cover Sheet.docx
"Vendor Doc
S ched.xls"