PodBOK brings industry guidance together with real-world experience from major projects. Use it to inform your approach, and check the facts and requirements that apply to your project.
101: decide what the data must help you do
Start with a decision and work backward. Who needs to act, what must they understand, and when will the information still be useful? A package manager reviewing delivery readiness needs a different view from a sponsor considering a funding change. Write those needs before deciding which fields to collect or which dashboard to build.
Orion Matthews and Tonya White's reporting presentation connects the groundwork to the implementation: scope, stakeholder needs, contractor requirements, calendars and workflow come before the integrated reporting solution.
Apply that discipline to model data as well. Agree what the model must help someone do, how often it needs updating and which inputs support that use. A logistics review and a quantity takeoff need different information and checks.
Settle the data wars before connecting systems
A disagreement over the project record is a governance problem before it is an integration problem. A shared platform does not decide who may approve a change, which revision the field should use or what the owner receives at handover. Agree those responsibilities with the organisations supplying and using the information.
Scroll sideways or use the arrow keys to see all columns.
| Decision | Agreement to make | Evidence to test |
|---|---|---|
| Authoritative record | Name the record, responsible organisation, approval state and version used for each purpose. | Follow a drawing revision or approved change into the view the receiving team actually uses. |
| Access and responsibility | Agree who may read, submit, approve, correct and export information, subject to the project requirements. | Test representative owner, contractor and delivery-team roles, including restricted information. |
| Conflicting copies | Define which source controls each field and how discrepancies and late corrections are resolved. | Change a record, introduce a failed transfer and show how the receiving team detects and reconciles it. |
| Handover and continued use | Agree the records, history, metadata and usable export the receiving organisation needs. | Open a representative handover package outside the originating platform and reconcile it to the source. |
Keep a current working view and an approved period record distinct. They can legitimately answer different questions. Do not erase a discrepancy by forcing two numbers to agree before understanding their dates, scope and approval status. Record the resolution and tell downstream users when their interpretation needs to change.
Connect systems through accountable people
Draw a simple map from source systems to the information people use. For each connection, identify who supplies the records, who checks them, how they arrive and what happens when they are late or incomplete. Review what existing tools already do well before adding another reporting layer. Leave a controlled space for analysts to explore questions that the standard reports do not answer.
Give source owners time to review recurring errors and fix how information is entered. If analysts keep repairing the same field in a reporting spreadsheet, carry that correction back to the source process and its owner.
Turn contractor reporting requirements into a working interface. Agree formats, definitions, cutoffs and correction responsibilities, then walk through an example submission together. Coordinate the contractor calendar with the internal review and publication calendar. A deliverable due date needs enough time for the people receiving it to check and use it.
Test representative records through the whole connection, including identifiers, units, revisions, permissions and failed updates. Confirm that corrections reach the right people and that a failed transfer is visible and recoverable. An available API is a starting point for this test, not evidence that the project has a working information flow.
How to create trust in the data
People trust people. When a project director relies on a number, they also rely on the people who collected it, checked it and explained what it means. Give those people a clear process and the authority to raise a problem before the information is used.
Make that accountability visible from the source record to the report. For each important dataset, name the person responsible for its content and the person accepting it for use. Give them time to investigate discrepancies with the team doing the work. Keep their review attached to a specific version and reporting date.
For example, a package lead could confirm that the installed quantities were checked against signed field records through the agreed cutoff, with two unresolved items listed separately. The controls reviewer records that confirmation with the dataset and accepts it for the period report. This makes the review specific enough for another person to understand and repeat.
Treat sign-off as a conversation about the evidence. If a reviewer cannot explain a significant movement, give them a route to hold or qualify the submission while it is investigated. Trust grows when people consistently make the checks visible, acknowledge what is uncertain and correct mistakes openly.
The wedding of the rivers: validate the combined picture
Orion Matthews uses the "wedding of the rivers" as an analogy for project data integration. A checked schedule meets cost, progress, risk and manual adjustments. Each stream may make sense on its own, yet the combined report can still be wrong. No discipline has a monopoly on clean data; the problem is what happens where the streams meet.
For a hypothetical December report, imagine joining progress measured on 31 December to costs through 25 December and a forecast revised on 4 January. Calling the result "December" hides three different positions. Another trap is mapping one package budget to several schedule activities and then adding that budget once per activity. The files can pass their individual checks while the combined number is misleading.
- Check the meaning, unit, level of detail, cutoff and version on both sides of every connection.
- Test missing matches, duplicate keys, one-to-many joins and reconciled totals before accepting an integrated result.
- Name an owner for the combined dataset as well as owners for each contributing source.
- Preserve the source records and mapping versions so an error can be traced back through the join.
Automation can repeat a bad join just as reliably as a good one.
When should the data move into a warehouse?
Start designing the integration when recurring reports depend on several systems, repeated manual reconciliations, historical comparisons or multiple downstream users. A governed warehouse can be useful then. A simpler controlled dataset may be enough for a small, stable reporting need. Decide from the work, ownership and history you need to support, rather than waiting for every source to be perfect or buying a platform first.
Capture and release are different decisions. Source files can arrive early in a restricted landing area. Record their origin, extraction time, cutoff and version, then check and reconcile them in a working area. Only promote a dataset to the approved reporting layer when its release criteria are met and exceptions have an owner. A warehouse can contain raw, working and approved data; readers must be able to tell which they are using.
- Keep recoverable source evidence separately from disposable processing tables, under the agreed retention policy.
- Record each harvest or load and its mapping version, checks, rejected records and approval status.
- Publish an explicit period, snapshot version, source coverage and exception list to reporting, exports and AI consumers.
- Before changing a code mapping or calculation, identify affected reports and models and test the proposed revision against the issued position.
If a load fails, retain the previous approved dataset with its original timestamp and a visible stale-data notice. Do not combine half of a new harvest with half of the old one and label it current. Reprocess affected dependencies, reconcile the totals, then release and notify consumers together. A warehouse is not automatically an archive, and a downstream dashboard refresh is not approval.
Run the harvest: collect, review, correct, repeat
The presentation's harvest animation shows source data moving into a warehouse and then into reports for review. Updates feed another harvest. A final harvest is locked for historical comparisons. Treat the illustrated rounds as a working pattern; the number of review cycles should fit the project and the reporting deadline.
- Collect the agreed inputs for the reporting period and record their source versions and cutoffs.
- Run checks and review the resulting reports with people who understand the work.
- Resolve discrepancies with source owners, then ingest the corrected information into the next harvest.
- Decide when the dataset is ready to issue and preserve the resulting reporting position.
Include content checks in the harvest. For drawings, compare the file name with the document number, sheet and revision shown inside it; check the expected sheet set for omissions and duplicates. Keep extracted quantities linked to their source drawing so reviewers can inspect a discrepancy before it reaches procurement or a work package.
For a hypothetical equipment package, a changed delivery date should be traceable to its source update and harvest. The report author should be able to explain why this issue differs from the previous one, without rebuilding the answer from emails.
Preserve a reporting position you can reproduce
Keep the current operational view separate from the dataset behind an issued report. Identify the effective cutoff, source versions, harvest, approval and report edition. Also record when information was received and accepted: a correction received in January may describe work performed in December. Keeping both dates helps distinguish what happened from what the team knew when it issued the report.
A period lock prevents ordinary changes to a designated approved version. Apply the control to imports, integrations and automated refreshes as well as on-screen edits. Define who may authorize a revision and how privileged changes are logged. A read-only dashboard is not enough if the tables underneath it can silently change.
- Preserve the approved data, relevant source evidence, mappings and calculations needed to reproduce the issued report.
- Keep change evidence: actor, time, before and after values, reason and authorization. An audit log serves a different purpose from a backup.
- Process a late correction through an identified new revision; retain the original as-issued record according to the records policy.
- Reconcile affected figures and conclusions, reapprove the revision and tell downstream users which edition supersedes which.
Locking preserves a state; review establishes whether it is fit to use. A file hash can help detect changes against a trusted reference, but cannot prove that a number was true. Define and test the whole control, including administrator access and restoration, rather than relying on the word "locked".
Treat reporting data as a project record
Reporting data can become part of the evidence for what was submitted, known, approved or changed. Manage the supporting records alongside the report: source submissions, review comments, approvals, transformations and issued versions. Preserve enough context to explain a figure later, while limiting access to information people need for their role.
Agree the applicable contract, retention, confidentiality and preservation requirements with the project's commercial, legal and records owners. Record what must be kept, where, for how long and who can authorize disposal. If a preservation obligation or legal hold applies, suspend affected deletion and overwrite routines across source systems, warehouse copies and downstream exports as directed. Keeping every copy forever is not a substitute for a records policy.
The practical aim is a traceable record and controlled correction process. Decide the applicable requirements before configuring the technology, then check that evidence remains retrievable when people, systems or suppliers change.
Advanced practice: make history useful for analysis and AI
Consistent records can support comparisons across periods and project stages. Before comparing, check whether scope, definitions and measurement methods match. Keep in-progress forecasts distinct from completed-project outcomes. Preserve the explanation of unusual conditions so a future analyst does not mistake a change in definition for a change in performance.
Retain the explanation alongside the numbers: what scope was included, how progress was measured and which conditions changed. When reviewing a completed project, compare the record with several people's accounts and keep unresolved differences visible. Future teams need to understand why a result is comparable before using it as a benchmark.
For an AI application, begin with the same foundation: known sources, understandable fields and appropriate access. Test any proposed extraction, mapping or commentary against representative project examples. Keep suggestions distinguishable from approved records.
Lessons from the field: operate the system together
The presentation includes standard communications and user training as part of the reporting setup. Make requests recognizable, explain the purpose of each submission and show contributors how their information is used. A documented process needs people who understand their responsibilities and can raise problems before the reporting deadline.
Use that pairing in routine reviews. Let a delivery specialist walk through what happened in the field while an analyst follows the same work through its codes, source records and calculations. Together they can spot a technically valid result that does not describe how the work was actually done.
This field guide's Bookshelf
Explore the sources behind this article and related reading from our Bookshelf.
Unlocking Project Success: Building Timely and Accurate Reporting for a Major Capital Project
Orion Matthews and Tonya White · Referenced by PodBOK
Why it's on the shelfThe presentation connects agreed scope, stakeholder needs, contractor requirements and reporting calendars with a common data model. Its harvest cycle collects data, reviews reports, makes corrections and repeats before locking the final dataset for historical comparison.
Referenced in this field guide 101: decide what the data must help you do.
Exploring an API Reporting Pipeline for Project Controls
Orion Matthews · Referenced by PodBOK
Why it's on the shelfThe confluence analogy describes the risk of combining separately managed project data without assurance of the whole. The presentation proposes collecting information, reconciling and revising it, approving and sealing a period, then sharing it with its context intact.
Referenced in this field guide The wedding of the rivers: validate the combined picture.
Dimensional modeling in Microsoft Fabric Warehouse: Load tables
Microsoft Learn · Referenced by PodBOK
Why it's on the shelfThe guidance explains staged loading, quality checks, logging and dependencies between warehouse tables and downstream models. It also distinguishes ways of handling historical changes. Those mechanics help explain why an upstream revision can change later reports unless versions and dependencies are managed deliberately.
Referenced in this field guide When should the data move into a warehouse?.
ISO 15489-1:2016: Information and documentation, Records management, Part 1: Concepts and principles
ISO · Referenced by PodBOK
Why it's on the shelfISO describes records management as covering records and their metadata, responsibilities, policies, controls and processes for creating, capturing and managing records. It provides a standards starting point for treating project information as a managed record throughout its lifecycle.
Referenced in this field guide Treat reporting data as a project record.
Federal Rules of Civil Procedure, Rule 37(e)
United States Courts · Referenced by PodBOK
Why it's on the shelfIn U.S. federal civil litigation, loss of electronic information that should have been preserved can lead to court measures when the rule's conditions are met. The rule distinguishes measures addressing prejudice from more severe consequences that require intent to deprive.
Referenced in this field guide Treat reporting data as a project record.
Project Controls & Data Analytics in the Era of Industry 4.0
AACE International, Source magazine · Referenced by PodBOK
Why it's on the shelfThe authors connect analytical capability to organizational goals, data quality, governance and complementary skills. Their discussion links acquiring and preparing information with analysis and action, and encourages consistent records throughout project delivery.
Referenced in this field guide Advanced practice: make history useful for analysis and AI.
Keep exploring
Bibliography
Explore the conversations, publications and reading behind this field guide.
Podcast conversations
-
Conversation with Omar Habib
Passages and links
-
Decide what the model is for
Omar Habib
Habib starts a 4D exercise at a whiteboard: who will use it, for what purpose, how often it will be updated, and what information goes in and comes out. He distinguishes a presentation model from one used to calculate quantities.
-
-
Conversation with Jovita Stander
-
Conversation with AJ Waters
Passages and links
-
Agree who controls the record before the data wars begin
AJ Waters
Waters describes the data wars as a question of whose system holds the authoritative project record, who can access it and what the owner receives at completion. He connects owner and contractor concerns to the way their systems exchange information.
-
Reduce duplicate entry before adding AI
AJ Waters
Waters argues for connecting owner and contractor platforms so the same information need not be entered in both systems. He follows this with a warning that AI can make incorrect data produce incorrect results faster. These are his observations about integration and data quality, not proof that a particular connection works.
-
Keep people connected to the current approved information
AJ Waters
Waters uses a drawing revision to explain why project information changes. He argues that people need access to the relevant updated drawings, change orders and RFIs, because different versions can lead to conflict and rework.
-
-
Conversation with Bruno Caldas
Passages and links
-
Put expertise where the source data is created
Bruno Caldas
Caldas describes moving effort from manually assembling reports toward analysis. His foundation was reliable source-system data, and he recommends someone in each team who understands the system and can look after its data.
-
-
Conversation with Ahmed Abdelfattah
Passages and links
-
Trust is earned through people
Ahmed Abdelfattah
Ahmed argues that executives rely on their trust in the person who gathered and interpreted the information. He describes that trust developing through decisions and interactions over the course of a project.
-
-
Conversation with Grant Stead
Passages and links
-
Validate the contents behind the file name
Grant Stead
Stead describes a drawing set whose file names appeared to cover all the sheets, while the files repeated the same page. Checking the contents exposed missing drawings and work that had not reached fabrication. His review also compared extracted title-block and material information with the drawings themselves.
-
-
Conversation with Roger Farish
Passages and links
-
Keep the story behind the historical numbers
Roger Farish
Farish describes combining historical project data with interviews to understand what happened. Different projects capture information differently, and he seeks more than one account from the people involved when interpreting the records.
-
-
Conversation with Geoff Ryan
Passages and links
-
Pair data skills with construction experience
Geoff Ryan
Ryan describes pairing data scientists with experienced construction people. The project manager starts with questions about quantities, upcoming work, staffing or available work fronts; the data specialist helps turn the available information into something the team can use.
-
Publications and further reading
-
Unlocking Project Success: Building Timely and Accurate Reporting for a Major Capital Project
Orion Matthews and Tonya White · Cited source
Publication details
Project Control Summit presentation, 2023
Orion Matthews and Tonya White. Unlocking Project Success: Building Timely and Accurate Reporting for a Major Capital Project. Project Control Summit, 2023. Public recording linked from the presenter’s events page.
Slides 7-19 and 21-27; harvest-process animation on slide 17.
The presentation illustrates the reporting setup and harvest cycle. Its dashboard figures are randomized examples.
-
Exploring an API Reporting Pipeline for Project Controls
Orion Matthews · Cited source
Publication details
Supplied deck labelled 2026; exact presentation date not established
Orion Matthews. Exploring an API Reporting Pipeline for Project Controls, subtitle in the supplied 2026 deck. Supplied presentation.
PDF pages 10-14, 19, 25-30 and 33-36.
-
Dimensional modeling in Microsoft Fabric Warehouse: Load tables
Microsoft Learn · Cited source
Publication details
Public technical guidance, updated April 6, 2025
Orchestration, staging, transformation, logging, historical changes and downstream dependencies.
This is Microsoft Fabric product documentation. Temporary staging data and retained project records serve different purposes.
-
ISO 15489-1:2016: Information and documentation, Records management, Part 1: Concepts and principles
ISO · Cited source
Publication details
Edition 2, April 2016; confirmed in 2021
Public abstract and publication status.
The source is ISO's public abstract for the records-management standard. It outlines concepts and principles without specifying a database lock or retention period.
-
Federal Rules of Civil Procedure, Rule 37(e)
United States Courts · Cited source
Publication details
Rules amended to December 1, 2025
Rule 37(e), printed pages 64-65 of the current official rules PDF (PDF pages 83-84).
Rule 37(e) concerns loss of electronically stored information in U.S. federal civil litigation.
-
Project Controls & Data Analytics in the Era of Industry 4.0
AACE International, Source magazine · Cited source
Publication details
April 2019 technical article
James E. Arrow, Arvid Markhus, Vijai Singh, Cesar Ramos and Stefan Bakker. Source, AACE International, April 2019, pp. 15-23.
Printed pp. 17-22, especially the data-science activities on p. 19; PDF pp. 19-24.
This is a technical article published in 2019, separate from AACE's standards and Recommended Practices. Its technology forecasts belong to that period.
From the knowledge library
The schedule–map handshake
Original card context
From the conversation, ~25:28–31:20 · the Friday-mosque scope change is the worked example
“What’s true today is not necessarily true tomorrow. A perfect example is a drawing revision.”
Original card context
AJ Waters · ~40:00 · ep 027 with AJ Waters
Source context
Orion Matthews and Tonya White's presentation supplies the reporting setup and harvest-cycle examples. Its dashboard figures are randomized.
The detailed controls and AI workflows are worked examples, rather than reported implementations from the presentation.
AJ Waters contributes a construction-software supplier perspective.
PodBOK · The Major Project Podcast
https://www.themajorprojectpodcast.com/podbok/project-data-foundations · Updated 2026-11-01