Study guide

8.4 Document Analysis, Interface Analysis & Reverse Engineering

PMI Professional in Business Analysis PMI-PBA

Track your progress as you read

Finished sections get a check mark.

1 Chapter 1: Introduction, Exam Logistics & Business Analysis Framework

1.1 PMI-PBA Exam Format, Scoring, Logistics & Eligibility 1.2 Business Analyst vs Project Manager: Roles, Boundaries & Standards 1.3 Business Analysis Across Predictive, Adaptive & Hybrid Lifecycles

2 Chapter 2: Needs Assessment — Problem Framing & Opportunity Analysis

2.1 Defining Business Problems, Opportunities & Scope Statements 2.2 Root Cause Analysis: 5 Whys, Fishbone & Interrelationship Digraphs 2.3 Assessing Current Capabilities, Operational Constraints & Organizational Maturity

3 Chapter 3: Needs Assessment — Future State & Feasibility Analysis

3.1 Defining the Desired Future State & Product Scope Boundaries 3.2 Gap Analysis: Capability Matrices, Risk of Inaction & Transition States 3.3 Solution Option Evaluation: Feasibility Studies & Make/Buy/COTS Tradeoffs

4 Chapter 4: Needs Assessment — Business Case, Valuation & Stakeholder Values

4.1 Financial Valuation & Metrics: ROI, NPV, IRR, Payback & Cost-Benefit Analysis 4.2 Developing the Business Case & Aligning SMART Project Goals 4.3 Identifying Stakeholders & Establishing Stakeholder Values Baseline

5 Chapter 5: Planning — BA Approach & Context Framing

5.1 Reviewing Business Case, Project Charter & Context Framing 5.2 Establishing the Business Analysis Approach & Tailoring Strategy 5.3 Business Analysis Work Breakdown, Scheduling & Effort Estimation

6 Chapter 6: Planning — Stakeholder Engagement & Communication

6.1 Stakeholder Analysis: Power/Interest Grid, Salience Model & Onion Diagrams 6.2 Planning Stakeholder Communication, Engagement & Distributed Collaboration 6.3 Managing Stakeholder Expectations, Alignment & Conflict Resolution Pathways

7 Chapter 7: Planning — Governance, Traceability & Change Control

7.1 Developing the Requirements Management Plan (RMP) 7.2 Defining Requirements Traceability Strategy & Hierarchy 7.3 Defining Requirements Change Control Protocols & CCB Workflow 7.4 Document Control, Baselining & Defining Business Metrics/Acceptance Criteria

8 Chapter 8: Analysis — Requirements Elicitation Techniques & Collaboration

8.1 Elicitation Planning, Types & Stakeholder Preparation 8.2 Interactive Elicitation: Interviews, Focus Groups & JAD Workshops 8.3 Observational & User-Centered Elicitation: Job Shadowing & Surveys 8.4 Document Analysis, Interface Analysis & Reverse Engineering

9 Chapter 9: Analysis — Requirements Modeling & Decomposition

9.1 Scope Modeling: Context Diagrams, Ecosystem Maps & Feature Breakdowns 9.2 Process & Workflow Modeling: BPMN, Swimlanes & Value Stream Mapping 9.3 Data & Rules Modeling: ERDs, Data Dictionaries, DFDs & Decision Tables 9.4 Interface Modeling, Wireframing, User Journey Maps & Prototyping

10 Chapter 10: Analysis — Requirements Specification & Acceptance Criteria

10.1 Requirements Taxonomy: Business, Stakeholder, Solution, Transition, Project & Quality 10.2 User Stories, Epics, INVEST Criteria & Acceptance Criteria 10.3 Non-Functional Requirements & Quality Attributes 10.4 Consensus Building, Tradeoff Analysis & Resolving Competing Requirements

11 Chapter 11: Analysis — Verification, Validation, Prioritization & Approval

11.1 Requirements Verification & Quality Characteristics 11.2 Requirements Validation & Strategic Business Alignment 11.3 Requirements Prioritization Techniques: MoSCoW, Kano & WSJF 11.4 Product Risk Analysis & Design Option Evaluation

12 Chapter 12: Traceability & Monitoring — Traceability Matrix & Baselining

12.1 Constructing & Maintaining the Requirements Traceability Matrix (RTM) 12.2 Monitoring Requirements Across Lifecycle Artifacts 12.3 Requirements Baselining, Scope Management & Preventing Creep

13 Chapter 13: Traceability & Monitoring — Lifecycle States & Change Management

13.1 Managing Requirements Status & Lifecycle State Transitions 13.2 Communicating Requirements Status, Visual Dashboards & Burndowns 13.3 Requirements Change Management & Multi-Dimensional Impact Analysis 13.4 Resolving Requirements Conflicts, Defect Triage & Variance Management

14 Chapter 14: Evaluation & Professional Conduct

14.1 Validating Test Evidence & Results Against Acceptance Criteria 14.2 Solution Gap Analysis, Discrepancy Resolution & Workarounds 14.3 Facilitating Stakeholder Sign-Off, Operational Readiness & Transition 14.4 Evaluating Long-Term Solution Performance & Value Realization 14.5 PMI Code of Ethics, Professional Conduct & Continuing Certification (CCR)

8.4 Document Analysis, Interface Analysis & Reverse Engineering

Key Takeaways Explain This Topic AI

Document analysis extracts foundational requirements, business rules, and regulatory constraints from existing enterprise artifacts before engaging stakeholders, minimizing operational disruption.

Verifying document currency and credibility is essential to detect the operational disparity between de jure policy (written procedures) and de facto execution (actual practice).

Interface analysis defines boundaries, interaction mechanisms, and data exchange contracts across human-to-system, system-to-system, and hardware touchpoints to prevent integration failures.

Reverse engineering extracts underlying business logic, decision trees, and data architectures directly from undocumented legacy source code, database tables, stored procedures, and batch scripts.

Competitive benchmarking and external market analysis provide objective performance baselines and functional parity matrices, helping the enterprise evaluate custom capabilities against industry standards.

Last updated: September 2026

8.4 Document Analysis, Interface Analysis & Reverse Engineering

Important

The Power of Research-Based Elicitation : While collaborative human interaction is vital, high-performing business analysts recognize that people are subjective, forgetful, and politically motivated. Systems and written artifacts, by contrast, contain hard, objective records of historical decisions, regulatory boundaries, data schemas, and operational constraints. Domain 3 of the PMI-PBA exam frequently tests your capability to extract foundational requirements from documents, specify rigorous system interface contracts, and reverse engineer undocumented legacy systems.

Document Analysis: Methodology and Currency Verification

Document analysis is a research elicitation technique used to harvest business requirements, operational constraints, system capabilities, and compliance mandates by reviewing existing organizational documentation. It is the premier pre-elicitation technique: by reviewing documents first , the analyst acquires domain vocabulary, maps process boundaries, and formulates intelligent, targeted questions for subsequent collaborative sessions. +-----------------------------------------------------------------------------------+

  • | Document Analysis Workflow |
  • +-----------------------------------------------------------------------------------+
  • | 1. Artifact Discovery & Harvesting |
  • | Identify and gather candidate documents across business and IT domains. |
  • | ↓ |
  • | 2. Credibility & Currency Verification |
  • | Evaluate authoritativeness, publication date, revision history, and status. |
  • | ↓ |
  • | 3. Content Extraction & Decomposition |
  • | Mine documents for business rules, functional needs, metrics, and constraints. |
  • | ↓ |
  • | 4. Discrepancy Triangulation (De Jure vs. De Facto) |
  • | Identify conflicts between written policy and observed operational practice. |
  • | ↓ |
  • | 5. Requirements Formulation & Gap Logging |
  • | Draft structured requirements and log gaps for targeted SME interviews. |
  • +-----------------------------------------------------------------------------------+
  • Primary Document Archetypes to Mine

Standard Operating Procedures (SOPs) & Process Maps : Reveal official, authorized operational workflows and governance handoffs.

Regulatory Statutes, Compliance Guidelines & Legal Frameworks : Define non-negotiable legal constraints, audit retention mandates, and privacy controls (e.g., HIPAA, GDPR, Sarbanes-Oxley).

Contracts, Statements of Work (SOWs) & Service Level Agreements (SLAs) : Document legally binding performance metrics, system availability guarantees, and penalty thresholds.

System Architecture Documents & Data Models : Detail existing databases, legacy technical constraints, and entity relationships.

Defect Logs, Help Desk Tickets & Audit Reports : The goldmine of operational pain points. Reviewing the top 1,000 IT support tickets reveals authentic operational failure points that management often ignores.

Corporate Policy Handbooks & Training Manuals : Provide onboarding procedures, business definitions, and operational expectations.

Document Currency and Credibility Verification

Documents can be dangerously obsolete. Basing software requirements on a 6-year-old SOP that has not been maintained since a major database overhaul leads to catastrophic scope errors. The business analyst must subject every document to rigorous verification:

Provenance and Authoritativeness : Who authored the document? Was it created by an authorized enterprise architect or an informal contractor? Was it formally approved by executive governance?

Currency and Revision Timestamps : When was the document last modified? Has the underlying software, operational team, or statutory law changed since that date?

Completeness and Scope Alignment : Does the document reflect the entire enterprise process, or only a localized regional subsidiary?

Warning

The "De Jure" vs. "De Facto" Reality Gap : On the PMI-PBA exam, you will encounter scenarios where written corporate policy ( de jure ) conflicts directly with observed operational reality ( de facto ). For instance, written policy dictates that credit card refunds require two managerial approvals, but in live practice, supervisors shared their passwords so clerks could process refunds instantly to meet call-handling speed metrics. A business analyst must never accept written policy blindly, nor adopt unauthorized shortcuts as official requirements. The BA documents the discrepancy, evaluates the compliance risk, and brings both realities to governance leadership for formal resolution.

Interface Analysis: Boundaries, Endpoints and Data Contracts

Modern software solutions never exist in isolation; they inhabit a dense, complex ecosystem of interconnected applications, databases, external partner platforms, and hardware peripherals. Interface analysis is the systematic discovery discipline that identifies, defines, and bounds the touchpoints where data, signals, and control pass between a system and external entities. +-----------------------------------------------------------------------------------+

  • | The Interface Spectrum |
  • +-----------------------------------------------------------------------------------+
  • | 1. Human-to-System Interfaces (User Interfaces - UI/UX) |
  • | - Screens, forms, mobile views, dashboards, accessibility standards. |
  • | |
  • | 2. System-to-System Interfaces (Application Integration) |
  • | - APIs (REST, GraphQL), SOAP web services, webhooks, message buses (Kafka). |
  • | - Enterprise Service Buses (ESB), flat file transfers (SFTP, CSV, EDI). |
  • | |
  • | 3. External Partner / Third-Party Interfaces |
  • | - Payment gateways (Stripe), credit bureaus (Experian), cloud identity (Okta). |
  • | |
  • | 4. Hardware / Device Interfaces (IoT & Physical Systems) |
  • | - Barcode scanners, RFID sensors, biometric thumbprint readers, robotics. |
  • +-----------------------------------------------------------------------------------+
  • The Core Components of an Interface Specification

Interface analysis is not merely a high-level architectural sketch; it demands rigorous functional and non-functional specification. The business analyst specifies ten critical operational dimensions for every system-to-system interface: [ SOURCE SYSTEM ] ──────── (Payload: JSON over HTTPS) ────────► [ TARGET SYSTEM ]

  • Trigger: New Account Created - Frequency: Real-Time Event
  • Auth: OAuth 2.0 Bearer Token - Latency SLA: <250 ms
  • Volume: 50,000 Trans/Day - Error: 3 Re-tries, then DLQ

Interface Boundaries & Endpoints : Explicit definition of the Source System and Target System, including network endpoints, environments (sandbox, staging, production), and transport mechanisms.

Trigger Mechanism : What operational event initiates the data exchange? Is it event-driven (triggered immediately when a user clicks submit) or scheduled/batch (triggered on a cron cadence, such as nightly at 02:00 UTC)?

Data Exchange Payload & Contract : The exact data schema passed across the boundary. Detailed field-by-field definitions including field name, data type (integer, string, boolean, timestamp), mandatory vs. optional status, validation business rules, and default values.

Data Format & Serialization : How the payload is structured (e.g., JSON, XML, Protocol Buffers, EDIFACT, comma-delimited CSV).

Transport Protocol : The underlying communication channel (e.g., HTTPS REST, SFTP, AMQP message queues, gRPC, WebSockets).

Volumetrics & Throughput : Average transactions per minute, expected daily payload sizes, and peak burst volumes (e.g., handling Black Friday surge traffic of 5,000 requests per second).

Performance & Latency SLAs : Non-negotiable time thresholds. Example: "Target system must return an HTTP 200 acknowledgment within 250 milliseconds for 99.9% of requests."

Security, Authentication & Encryption : Protocols required to secure the interface (e.g., TLS 1.3 encryption in-transit, OAuth 2.0 mutual authentication, API tokens, IP whitelisting).

Exception Handling, Retries & Dead Letter Queues : What happens when the target system is down or unreachable? Specifies timeout windows (e.g., 5-second timeout), retry policies (e.g., exponential backoff with 3 attempts), and fallback routing to a Dead Letter Queue (DLQ) for manual investigation.

Data Transformation & Mapping Rules : Detailed transformation algorithms required when the source system and target system utilize divergent data models (e.g., converting a 5-digit US ZIP code to an alphanumeric Canadian postal code).

Interface Analysis Specification Template

The following table illustrates a standard PMI-PBA compliant interface specification for an enterprise e-commerce to logistics payment interface:

Interface Field / Parameter Operational Description Enterprise Example Value Business Analysis Purpose

Interface ID & Name Unique tracking identifier and descriptive title. INT-PAY-042 : Payment Gateway Settlement Establishes unambiguous traceability in the RTM.

Source System The initiating entity transmitting the data payload. Digital Storefront E-Commerce Engine (AWS) Identifies data ownership and transmission origin.

Target System The receiving entity processing the incoming payload. Enterprise Financial Core Ledger (SAP S/4HANA) Binds destination architectural boundaries.

Trigger Type Operational condition causing transmission. Real-Time Event: Successful customer checkout Differentiates event streams from batch cadences.

Communication Protocol Underlying network transmission architecture. REST API over HTTPS (TLS 1.3) Governs networking, firewall, and security specs.

Data Payload Format Data serialization syntax. JSON (UTF-8 encoded) with standard schema Defines parsing requirements for integration coders.

Throughput & Volumetrics Expected normal and peak request loads. Average: 120 req/min; Peak: 1,800 req/min Establishes non-functional scalability baselines.

Latency Threshold Maximum acceptable response turnaround. Response time ≤ 350 ms at 99th percentile Defines non-functional SLA for acceptance testing.

Authentication Protocol Identity verification mechanism. OAuth 2.0 with rotating HMAC-SHA256 tokens Enforces enterprise cybersecurity compliance.

Error & Retry Governance Failure recovery and fault tolerance rules. Exponential backoff (3 tries), then log to DLQ Prevents silent transaction drops and revenue loss.

Data Contract Mapping Source-to-target field transformation logic. order_total (USD) mapped to ledger_credit_amt Prevents data corruption during financial settlement.

Reverse Engineering Legacy and Undocumented Systems

In brownfield enterprise environments, business analysts are frequently tasked with modernizing legacy systems whose original developers have retired, whose system architecture documents were lost decades ago, and whose source code has mutated through thousands of uncoordinated emergency patches. In these situations, the only reliable source of truth is the system itself.

Reverse engineering is the analytical process of dissecting an existing software system, database, or mechanical assembly to extract its underlying business rules, functional logic, data relationships, and operational constraints. +-----------------------------------------------------------------------------------+

  • | The Reverse Engineering Pipeline |
  • +-----------------------------------------------------------------------------------+
  • | 1. Black-Box Boundary Testing (Input / Output Tracing) |
  • | - Feed controlled test inputs into the legacy UI/API and observe outputs. |
  • | - Map observable business rules, validation errors, and boundary limits. |
  • | ↓ |
  • | 2. Database Schema & Artifact Inspection |
  • | - Mine SQL tables, foreign key constraints, column data types, and null rules. |
  • | - Extract business logic buried inside stored procedures, views, and triggers. |
  • | ↓ |
  • | 3. Source Code & Script Walkthroughs (White-Box Extraction) |
  • | - Review procedural code (COBOL, C, Java, PL/SQL) with a software engineer. |
  • | - Isolate hardcoded algorithms, conditional branching, and lookup tables. |
  • | ↓ |
  • | 4. System Telemetry & Log File Parsing |
  • | - Analyze server execution logs, error dumps, and batch job run histories. |
  • | - Identify undocumented exceptions and performance bottlenecks. |
  • | ↓ |
  • | 5. Extraction and Formulation of Verifiable Requirements |
  • | - Translate technical code structures into technology-agnostic business rules. |
  • | - Validate extracted rules with current business owners to purge legacy bugs. |
  • +-----------------------------------------------------------------------------------+
  • Analytical Tactics in Reverse Engineering

Database Schema Excavation : The database schema is the most durable artifact of enterprise truth. By inspecting entity relationship diagrams (ERDs), table primary keys, foreign key constraints, cascading triggers, and database check constraints, the business analyst extracts core data policies that are completely unmentioned in user documentation.

Stored Procedure and Trigger Auditing : In legacy client-server architectures, developers routinely embedded critical business logic directly inside SQL stored procedures and automated triggers. For example, a stored procedure may contain an uncodified formula that automatically recalculates tiered customer discounts based on 90-day purchase volume. The BA extracts this calculation and translates it into an explicit business rule.

Input/Output Boundary Tracing (Black-Box Analysis) : When source code is compiled or inaccessible, the analyst treats the legacy system as a black box. The BA systematically inputs boundary values (e.g., $0.00, $0.01, $999.99, $1,000.00, -$50.00) and observes the system's responses, error messages, and output records, thereby deducing the governing validation logic.

Caution

The Legacy Anti-Pattern Trap : A severe risk when reverse engineering legacy applications is perpetuating obsolete bugs and technical workarounds . Just because a legacy mainframe application performs a 7-step batch reconciliation does not mean the future-state solution should replicate that workflow. The 7 steps may have been a crude workaround for hardware memory constraints from 1985! A certified business analyst extracts the business intent behind the code, consults modern business SMEs to determine if the rule is still commercially valid, and discards obsolete technical baggage.

Competitive Benchmarking & Market Research

Not all requirements originate internally. To ensure solutions remain commercially competitive, operationally efficient, and technologically modern, business analysts employ Competitive Benchmarking and Market Research .

Benchmarking Modalities

External / Competitive Benchmarking : Comparing the enterprise's business processes, cycle times, customer satisfaction, and feature sets against direct industry competitors or market leaders. Identifies parity features (capabilities the enterprise must possess to compete) and differentiator features (innovations that create competitive advantage).

Internal Benchmarking : Comparing performance metrics across different divisions, subsidiaries, or regional operating units within the same enterprise (e.g., comparing the claims processing speed of the European branch against the North American branch to discover best-in-class internal practices).

Functional / Industry-Agnostic Benchmarking : Comparing a specific operational process against world-class leaders in completely unrelated industries. For example, a hospital emergency room benchmarks its patient turnaround logistics against Formula 1 pit crews, or a retail bank benchmarks its digital customer onboarding against leading consumer gaming applications.

Commercial Off-the-Shelf (COTS) Product Research

When an organization evaluates whether to build a custom solution or purchase a Commercial Off-the-Shelf (COTS) software package, document analysis and market benchmarking merge. The business analyst constructs a Functional Parity Matrix comparing business requirements against vendor feature specifications, evaluating licensing constraints, vendor roadmaps, and architectural compatibility before capital is committed.

Loading diagram... Document, Interface, and Reverse Engineering Discovery Architecture