Study guide
5.2 Discovery Framework Assessments & Question Versioning
Salesforce Accredited Agentforce 360 for Public Sector Professional Exam
Track your progress as you read
Finished sections get a check mark.
1 Chapter 1: Overview, Architecture & Constituent Data Modeling
1.1 AP-222 Exam Blueprint, Passing Standards & Credential Overview 1.2 Public Sector Solutions Layered Architecture & Industry Common Layer 1.3 Person Accounts & Constituent Data Modeling
2 Chapter 2: Licenses, Permits, and Inspections (LPI) — Intake & Issuance
2.1 Regulatory Authorization Types & Application Intake 2.2 Business License & Permit Issuance, Conditions & Status Tracking 2.3 Application Reviews, Multi-Department Approvals & Renewals
3 Chapter 3: Inspections, Code Enforcement, and Compliance
3.1 Inspection Types, Action Plan Templates & Onsite Visit Execution 3.2 Regulatory Codes, Assessment Indicators & In-Field Checklists 3.3 Regulatory Code Violations, Enforcement Actions & Remediation Workflows
4 Chapter 4: Grants Management & Grantmaking Lifecycle
4.1 Funding Programs, Funding Opportunities (NOFOs) & Public Discovery 4.2 Grant Application Intake, Review Workspaces & Multi-Stage Scoring 4.3 Funding Awards, Disbursement Schedules & Post-Award Reporting
5 Chapter 5: Benefits Management & Assistance Programs
5.1 Benefit Programs, Benefit Schedules & Beneficiary Data Architecture 5.2 Discovery Framework Assessments & Question Versioning 5.3 Rules-Based Eligibility Determination & Recertification Lifecycle
6 Chapter 6: Employee Experience & Emergency Response Management
6.1 Public Sector Employee Experience & Workforce Operations 6.2 Emergency Response Management (ERM) Intake, Triage & Incident Dispatch 6.3 Rapid Resource Allocation, Volunteer Coordination & Contact Tracing
7 Chapter 7: Document Processing, Intelligent Automation & Reporting
7.1 Document Checklist Items, Content Management & Upload Portals 7.2 Intelligent Document Automation (IDA), the Document Workspace & the IDA vs. IDA/IFR Decision 7.3 Intelligent Document Reader (OCR with Amazon Textract) & eSignature Integration 7.4 OmniStudio Document Generation & Dynamic PDF Production 7.5 Public Sector Operational Reporting, Compliance Dashboards & CRM Analytics
8 Chapter 8: OmniStudio for Public Sector — Guided Intake & 360 Views
8.1 OmniScript Architecture, Step Design & Conditional Branching 8.2 Data Prefill Patterns, Context Passing & Save-for-Later 8.3 FlexCard Architecture, Constituent 360 Layouts & Action Frameworks
9 Chapter 9: OmniStudio Integration & Server-Side Processing
9.1 Data Mappers (DataRaptors) — Turbo Extract, Extract, Transform & Load 9.2 Integration Procedures — Action Chaining, Batching & Error Handling 9.3 External API Integrations, HTTP Actions & Named Credentials
10 Chapter 10: Business Rules Engine (BRE) & Dynamic Fee Calculation
10.1 Expression Sets — Calculation Steps, Formulas & Versioning 10.2 Decision Tables & Decision Matrices for Policy Decisioning 10.3 Dynamic Fee Schedules, Calculation Procedures & Regulatory Pricing
11 Chapter 11: Experience Cloud Citizen Portals & Service Console
11.1 Public Sector Experience Cloud Site Templates & Citizen Self-Service 11.2 Guest vs. Authenticated User Journeys & Identity Verification 11.3 Multilingual Localization, Custom Labels & Translation Workbench 11.4 Public Sector Service Console, Workspace Tabs & Omni-Channel Routing
12 Chapter 12: Security, Compliance, Government Cloud & Best Practices
12.1 Data Security, Org-Wide Defaults (OWD) & Sharing Architecture 12.2 Government Cloud Tiers, FedRAMP & DoD Compliance 12.3 Salesforce Shield, Field Audit Trail & Platform Encryption 12.4 Declarative-First Strategy, Process Library & Deployment with IDX Workbench
13 Chapter 13: Agentforce & AI Innovation for Public Sector
13.1 Agentforce Architecture, Agent Builder & Public Sector Agents 13.2 Topic Definitions, Instructions, Actions & CRM/Data Cloud Grounding 13.3 Einstein Trust Layer, Guardrails & Responsible AI Governance
14 Chapter 14: Discovery, Requirements & Solution Design
14.1 Documenting Business Needs, Agency Value & Vision for Desired Outcomes 14.2 Discovery & Design Approaches and Solution Documentation 14.3 Mapping Business Processes, Personas & Requirements
15 Chapter 15: Org Setup, Data Management & Integration Governance
15.1 Setting Up an Org for Agentforce Public Sector 15.2 Data Management Strategy, Data Quality & Integration Governance
5.2 Discovery Framework Assessments & Question Versioning
Key Takeaways Explain This Topic AI
The Discovery Framework is a core Industry Common Layer (ICL) engine that decouples dynamic, frequently changing public assistance intake questionnaires from fixed database schemas, preventing custom field proliferation across CRM objects.
The Discovery Framework data architecture separates abstract question concepts (AssessmentQuestion) from temporal, regulatory definitions (AssessmentQuestionVersion), grouping them into reusable bundles (AssessmentQuestionSet) and recording immutable constituent answers (AssessmentQuestionResponse).
Annual statutory policy updates and legislative revisions are managed by activating new Assessment Question Versions without modifying database schema, invalidating historical submissions, or requiring code refactoring.
Cross-program question reusability allows agencies administering multiple programs (such as SNAP, TANF, and Childcare Subsidies) to define universal questions once and evaluate them across disparate intake instruments.
Constituent responses are stored as immutable point-in-time legal records in AssessmentQuestionResponse for administrative fair hearings, while OmniStudio Data Mappers selectively synchronize required operational attributes into standard CRM records.
Last updated: September 2026
5.2 Discovery Framework Assessments & Question Versioning
Exam Focus: Public health and human services agencies operate under dynamic statutory environments. Legislative bodies alter welfare eligibility rules, asset limits, and deduction categories on an annual or biannual basis. In traditional CRM architectures, accommodating these frequent changes causes massive schema bloat, exhausting custom field limits and breaking historical data integrity. On the AP-222 exam, candidates must master the Discovery Framework —a foundational Industry Common Layer (ICL) capability—understanding its version-controlled data model, dynamic OmniStudio intake generation, declarative response mapping, and evidentiary legal auditability.
Discovery Framework Architectural Foundations
When constituents apply for public assistance, agencies must capture extensive, granular personal disclosures: household composition, gross wages, self-employment profits, child support disbursements, medical out-of-pocket expenses, utility heating sources, and vehicle market values.
The Schema Proliferation Anti-Pattern
In naive implementations, architects often attempt to satisfy these requirements by creating custom fields directly on the Case , Account , or IndividualApplication objects (e.g., Does_Applicant_Pay_Electric_Heat__c , Monthly_Medical_Expense_Elderly__c ).
This pattern creates severe architectural pathologies in government systems:
Custom Field Exhaustion : Social services screeners regularly contain 150 to 300 discrete questions. Adding hundreds of custom fields rapidly approaches platform schema limits.
Historical Data Corruption : When the state legislature redefines what qualifies as an "allowable medical deduction" in 2027, modifying the existing custom field changes the historical interpretation of applications submitted in 2025 and 2026.
Cluttered Page Layouts & Reporting Overhead : Case managers and intake workers are confronted with sprawling page layouts inundated with irrelevant fields, degrading usability and performance.
The Discovery Framework Solution
The Discovery Framework solves this fundamental challenge by treating questions and questionnaires as data and metadata , completely decoupled from the transactional database schema. Application questions are stored as discrete records, versioned across time, bundled into structured sets, and rendered dynamically via OmniStudio OmniScripts. Constituent submissions are recorded as atomic response records without adding a single custom field to the underlying Salesforce data model. ┌───────────────────────────────────────────────────────────────────┐
- │ Assessment Question (Abstract Question Concept) │
- │ • DeveloperName: Constituent_Monthly_Gross_Earned_Income │
- │ • Category: Financial / Income │
- └─────────────────────────────────┬─────────────────────────────────┘
- │ 1:M
- ▼
- ┌───────────────────────────────────────────────────────────────────┐
- │ Assessment Question Version (Point-in-Time Definition) │
- │ • Version 1.0 (2025 Mandate): Includes standard tips/overtime │
- │ • Version 2.0 (2026 Reform): Excludes gig-economy hazard pay │
- │ • Data Type: Currency • Status: Active │
- └─────────────────┬───────────────────────────────┬─────────────────┘
- │ M:M (via junction) │ 1:M
- ▼ ▼
- ┌─────────────────────────────────┐ ┌───────────────────────────────┐
- │ Assessment Question Set │ │ Assessment Question Response │
- │ • Bundle: SNAP Intake Screener │ │ • Actual constituent answer │
- │ • Section: Financial Resources │ │ • Response: $1,850.00 │
- │ • Question Display Order │ │ • Immutable historical proof │
- └─────────────────┬───────────────┘ └───────────────┬───────────────┘
- │ │
- │ Renders Dynamically │ Child of
- ▼ ▼
- ┌───────────────────────────────────────────────────────────────────┐
- │ Assessment (Intake Session Instance) │
- │ • Constituent: Maria Rodriguez (Person Account) │
- │ • Parent Record: IndividualApplication / Case │
- │ • Assessment Status: Completed • Date: 2026-10-04 │
- └───────────────────────────────────────────────────────────────────┘
- The Five Core Discovery Framework Objects
AssessmentQuestion : The master entity representing the abstract question concept. It defines the developer API name, administrative category (e.g., Household Composition , Income Verification , Disability Support ), and broad question type. It contains no text or data type definitions itself; it serves as the permanent umbrella for its historical versions.
AssessmentQuestionVersion : The actionable, temporal definition of the question. It specifies:
Question Text & Help Text : The precise, statutory language presented to the citizen.
Data Type : Text , Number , Currency , Date , Boolean , Single-Select Picklist , or Multi-Select Picklist .
Response Values & Picklist Choices : Defined formula constraints, selectable options, or numeric ranges.
Status : Draft , Active , Deprecated , or Archived .
AssessmentQuestionSet : A logical grouping or bundle that aggregates multiple AssessmentQuestionVersion records into a cohesive questionnaire or administrative intake instrument. For instance, an agency can create a Comprehensive Public Assistance Screener question set that bundles 80 questions across income, shelter, and medical categories.
Assessment : The top-level transactional record representing an individual assessment session. It links directly to the citizen ( AccountId / ContactId ), the operational transaction ( IndividualApplication , Case , or ProgramEnrollment ), the assessment date, and the overall status ( In Progress , Completed , Cancelled ).
AssessmentQuestionResponse : The atomic leaf record capturing the constituent's exact, point-in-time answer. It maintains a master-detail lookup to the parent Assessment and a lookup to the specific AssessmentQuestionVersion answered. Responses are stored in strongly typed fields ( ResponseText , ResponseValueNumber , ResponseValueDate , or ResponseValueCurrency ).
Discovery Framework Object Key Architectural Role Critical Fields Operational Governance
AssessmentQuestion Catalog master concept DeveloperName , QuestionCategory Created once; never modified during annual policy updates
AssessmentQuestionVersion Version-controlled prompt definition QuestionText , DataType , Status , VersionNumber Immutable once activated; new versions created for legislative shifts
AssessmentQuestionSet Form questionnaire bundle Name , DeveloperName , UsageType Groups questions into thematic intake sections and screening flows
Assessment Intake session transaction AccountId , ParentRecordId , Status , AssessmentDate Created per citizen application; anchors all submitted responses
AssessmentQuestionResponse Immutable constituent response AssessmentId , AssessmentQuestionVersionId , ResponseValue Write-once record; provides statutory legal audit evidence
Designing Dynamic Intake Questionnaires: Versioning & Branching
Public assistance questionnaires cannot present a monolithic, unyielding list of hundreds of queries to vulnerable citizens. The intake experience must be intelligent, dynamically revealing relevant questions based on prior answers, and accommodating changing legislative mandates seamlessly.
Legislative Policy Versioning Across Program Years
Consider a state human services agency administering energy and nutrition assistance:
2025 Legislative Standard : The statute requires asking: "What is your total monthly shelter expense including rent and heating utility costs?"
2026 Clean Energy & Utility Reform Act : The state legislature mandates decoupling electric heating costs from fossil fuel costs to qualify constituents for specialized clean energy subsidies. The new statute requires asking two discrete questions: "What is your monthly rent or mortgage payment?" and "What is your primary heating fuel source (Electric Heat Pump, Natural Gas, Propane, Heating Oil)?"
The Discovery Framework Implementation:
The system administrator leaves the historical 2025 AssessmentQuestionVersion untouched in Deprecated status. All historical 2025 applications remain permanently linked to this version.
The administrator generates a new AssessmentQuestionVersion (Version 2.0) for the shelter cost question with updated statutory wording.
The administrator creates a new AssessmentQuestion and active AssessmentQuestionVersion for the heating fuel source.
The administrator updates the Energy & Food Assistance Intake AssessmentQuestionSet to reference the new question versions.
Zero schema alterations, zero data migration scripts, and zero downtime.
Dynamic Branching Logic in OmniStudio OmniScripts
The Discovery Framework is natively integrated with OmniStudio. When designing an intake journey:
Administrators configure the OmniScript utilizing pre-built Discovery Framework components (such as the Assessment LWC component) or declarative OmniScript Step elements driven by conditional views.
Conditional Execution Rules : Complex branching logic evaluates answers in real time: IF [Question: "Are you currently employed?"] == "Yes"
- THEN Show Step: [Questions: "Employer Name", "Pay Frequency", "Gross Monthly Pay"]
- ELSE IF [Question: "Are you receiving Unemployment Insurance?"] == "Yes"
- THEN Show Step: [Question: "Weekly Benefit Amount"]
- ELSE
- THEN Show Step: [Question: "Date Employment Ended", "Reason for Separation"]
Conditional rules prevent constituent confusion, reduce cognitive load, and drastically lower abandonment rates on public self-service portals.
Cross-Program Question Reusability
In traditional agency silos, a citizen applying for SNAP, TANF, and Medicaid must answer identical questions regarding household income, citizenship, and residential address three separate times. Under the Discovery Framework:
The agency defines AssessmentQuestion records for core socioeconomic metrics once.
These standardized questions are bundled into multiple distinct AssessmentQuestionSet records (e.g., SNAP Intake Screener , Medicaid MAGI Screener , Universal Social Services Screener ).
Constituents answer the question once during universal intake, and the underlying responses are leveraged across all program eligibility determinations simultaneously.
Response Mapping: From Immutable Questionnaires to CRM Records
While storing constituent answers in AssessmentQuestionResponse records guarantees legal compliance and prevents schema proliferation, operational government workflows still require data in standard Salesforce CRM records. For example, case managers need updated telephone numbers on the constituent's Account , and social workers need active disability records linked to the constituent's profile.
Public Sector Solutions implements a Two-Tier Data Strategy to reconcile these conflicting requirements: ┌────────────────────────────────────────────────────────────────────────┐
- │ Constituent Intake Submission │
- │ (OmniScript via Experience Cloud Citizen Portal) │
- └───────────────────────────────────┬────────────────────────────────────┘
- │
- ▼
- ┌────────────────────────────────────────────────────────────────────────┐
- │ Tier 1: Immutable Evidentiary Record │
- │ • Assessment: Assessment-2026-9812 │
- │ • AssessmentQuestionResponse: [Income = $1,850.00] │
- │ • AssessmentQuestionResponse: [UtilitySource = Electric Heat Pump] │
- │ • Status: Write-Once / Read-Only / Point-in-Time Audit Proof │
- └───────────────────────────────────┬────────────────────────────────────┘
- │
- │ Integration Procedure executes
- │ OmniStudio Data Mapper (Load)
- ▼
- ┌────────────────────────────────────────────────────────────────────────┐
- │ Tier 2: Operational CRM Living Records │
- │ • Person Account: Updates BillingAddress, Phone, Email │
- │ • Person Income Object: Inserts active monthly wage stream │
- │ • IndividualApplication: Populates categorical eligibility flags │
- │ • Business Rules Engine (BRE): Passes JSON payload into Expression Set│
- └────────────────────────────────────────────────────────────────────────┘
- Declarative Response Mapping Mechanics
Integration Procedure Orchestration : When a constituent completes an intake assessment in OmniScript, the submission step triggers an Integration Procedure.
Data Mapper Load Execution : The Integration Procedure invokes an OmniStudio Data Mapper Load. The Data Mapper extracts key answers from the AssessmentQuestionResponse payload and maps them to standard or custom objects:
Maps Applicant_Residential_Street and Applicant_Residential_Zip to Account.BillingStreet and Account.BillingPostalCode .
Maps Applicant_Monthly_Gross_Earned_Income to a related PersonIncome or Asset record.
Maps Household_Dependent_Count to the parent IndividualApplication record.
Bi-Directional Prefill (Data Mapper Extract) : When an enrolled constituent returns to submit an annual recertification or report a life event, a Data Mapper Turbo Extract queries existing CRM records and prepopulates the Assessment questions. The constituent simply reviews, confirms, or edits their prior answers, eliminating repetitive data entry.
Regulatory Compliance, Immutability & Administrative Fair Hearings
Public sector assistance administration is governed by rigorous constitutional and statutory due process mandates (such as Title IV-A of the Social Security Act and state Administrative Procedure Acts). When an agency denies an application or reduces an allotment, the constituent possesses an absolute legal right to request an Administrative Fair Hearing .
Evidentiary Burden in Legal Appeals
During an administrative appeal, the government agency bears the burden of proving that its adverse decision conformed strictly to the statute based on the applicant's sworn disclosures. In court or before an Administrative Law Judge (ALJ), the agency must produce:
- The exact, unedited question text presented to the applicant on the date of submission;
- The applicant's exact sworn response value;
- The date, timestamp, and digital attestation IP address; and
Proof that the questionnaire definition has not been retroactively altered by subsequent administrative changes.
How Discovery Framework Enforces Legal Auditability
Immutable Version Binding : Every AssessmentQuestionResponse maintains a permanent foreign key lookup to the specific AssessmentQuestionVersion that was active when the citizen submitted the form. Even if an agency creates five subsequent versions of that question over the following decade, the historical response remains bound to Version 1.0.
Write-Once Enforcement : Platform security and validation rules automatically lock Assessment and AssessmentQuestionResponse records once the status transitions to Completed . Agency staff cannot modify historical answers.
Salesforce Shield Integration : For high-security state and federal deployments (such as IRS 1075 tax data protection or HIPAA health data), Discovery Framework entities are integrated with Salesforce Shield :
Platform Encryption : Encrypts sensitive responses (SSN, medical diagnoses, income figures) at rest in the database.
Field Audit Trail : Preserves complete field history and state changes for up to 10 years, complying with statutory public records retention schedules.
Event Monitoring : Tracks every user who views, exports, or queries constituent responses, detecting unauthorized access to confidential social safety net files.
- 💡 Real-World Exam Scenarios & Case Analysis
- Scenario 1: Legislative Policy Revision to Vehicle Asset Limits
A state legislature passes an emergency budget act raising the allowable vehicle asset exemption for TANF cash assistance from $4,500 to $9,500, effective October 1. The statutory wording required on the application question changes from 'List the fair market value of all vehicles exceeding $4,500' to 'List the fair market value of all vehicles exceeding $9,500.' Over 40,000 historical applications submitted under the previous standard must remain fully auditable for upcoming federal compliance reviews.
What is the architecturally correct implementation in Public Sector Solutions?
Flawed Solution : Update the label and question text on the existing Question Version or update a custom field on the Case object. (Fatal Error: This corrupts the historical legal context of the 40,000 past applications).
AP-222 Best Practice : Clone the existing AssessmentQuestionVersion to create Version 2.0 . Update the prompt text in Version 2.0 to reflect the $9,500 threshold and activate it with an effective date of October 1. Deprecate Version 1.0. Historical applications remain immutably linked to Version 1.0, while all new intake sessions automatically present Version 2.0.
Scenario 2: Universal Intake Screener with OmniStudio Response Mapping
A human services agency wants to deploy a 'No Wrong Door' citizen portal where constituents complete a single 45-question screening assessment. The system must evaluate eligibility for three distinct programs (Childcare Subsidies, SNAP, and Housing Choice Vouchers). Caseworkers insist that constituent address changes submitted during the assessment must update their master Person Account immediately, without manual re-typing.
How should the consultant architect the solution?
Configure a single AssessmentQuestionSet containing the 45 standardized questions.
Embed the question set within an OmniStudio OmniScript deployed on the citizen-facing Experience Cloud site.
On form submission, configure an Integration Procedure that simultaneously saves the raw immutable answers in AssessmentQuestionResponse records and triggers a Data Mapper Load to update the constituent's standard Account.BillingAddress fields.