Forms Builder

Forms Builder - Ubiquitous Language & Terminology

Comprehensive glossary table for declarative form schemas, field controls, DAG conditional logic, draft lifecycles, and submission validation.

Ubiquitous Language & Terminology

In dynamic form generation and schema management, technical precision is paramount. Terms must have identical, unambiguous definitions for product managers, system architects, compliance officers, and software engineers. This glossary defines the ubiquitous language of the Forms Builder bounded context.


1. Comprehensive Terminology Glossary

TermCategoryBusiness Definition
Form BlueprintSchema GovernanceThe top-level administrative aggregate that represents a form concept (e.g., “Vendor Onboarding Form”), owning metadata, access permissions, and an ordered history of schema versions.
Form Schema VersionSchema GovernanceAn immutable, versioned definition of the form’s structural components, field types, validation rules, and layout at a specific point in time (e.g., Version 2.0).
Page / StepLayout & HierarchyThe highest-level structural division of a multi-step form, grouping sections and fields that are displayed together before progressive user navigation.
Layout SectionLayout & HierarchyA visual or logical grouping of fields within a page, optionally supporting collapsible containers, grid layouts, or repeatable card presentations.
Field Control (Component)Component HierarchyAn individual interactive element capable of capturing input (e.g., text box, date picker, file uploader) or rendering structural presentation (e.g., heading, callout, divider).
Field Identifier (FieldKey)Component HierarchyA unique, slug-style alphanumeric identifier (e.g., company_tax_id) assigned to a field within a schema version, used to store answers and evaluate conditional expressions.
Scalar ControlComponent HierarchyA primitive data entry control capturing a single discrete value, such as a string, integer, decimal, boolean, or date/time stamp.
Choice / Select ControlComponent HierarchyA field offering predefined options, rendered as radio buttons, dropdown selects, or multi-select checkbox groups with fixed or dynamically loaded option sets.
Matrix / Repeater ControlComponent HierarchyA composite field control that allows respondents to add multiple sequential rows of structured sub-fields (e.g., listing multiple dependent family members or line items).
Computed / Formula ControlComponent HierarchyA read-only field whose value is calculated dynamically at runtime by evaluating mathematical or string operations across other field answers in the form.
Validation Rule DescriptorValidation EngineA declarative specification defining valid inputs for a field (e.g., Required, MinLength: 8, RegexPattern: ^[A-Z0-9]+$, NumericRange: [0, 100]).
Conditional Visibility RuleLogic & RulesA declarative rule that determines whether a field, section, or page is visible and active based on the current answers of other preceding fields.
Skip Logic (Branching Rule)Logic & RulesA navigational directive evaluated at the completion of a page that dynamically redirects the user to a specific subsequent page, bypassing intervening steps.
Directed Acyclic Graph (DAG)Logic & RulesA mathematical graph representation of all field dependencies (visibility, calculations, skip logic) where relationships are strictly unidirectional and free of closed loops.
Cycle DetectionLogic & RulesThe algorithmic verification executed during schema publishing to mathematically prove that no field depends circularly on its own output ($A \rightarrow B \rightarrow A$).
The Schema Freeze LawVersion GovernanceThe architectural invariant dictating that once a schema version is published and has received at least one submission, its structure is permanently sealed against modification.
Submission Draft SessionResponse LifecycleA transient, state-tracked work session allowing a respondent to progressively complete and autosave form answers across multiple devices before final submission.
Answer MapResponse LifecycleA normalized key-value dictionary mapping FieldKey identifiers to validated response values captured from the user.
Form SubmissionResponse LifecycleThe final, immutable aggregate representing a verified, completed response to a specific form schema version, signed and sealed with a cryptographic hash.
Authoritative ValidationValidation EngineThe mandatory server-side re-execution of all schema validation descriptors against incoming answers, completely independent of any client-side JavaScript checks.
Response HashSecurity & ForensicA SHA-256 cryptographic digest generated over the normalized, sorted answer set, guaranteeing tamper evidence for legal and regulatory compliance.
Contextual Data HydrationIntegrationThe process of pre-populating specific form fields with external enterprise data (e.g., customer account details or employee ID) prior to user presentation.
Tabular ProjectionData ArchitectureA flattened, relational or columnar view generated from nested submission answer maps, enabling SQL reporting and CSV/Excel data exports.
Submission QuotaAccess GovernanceA hard constraint configured on a form blueprint specifying the maximum number of successful submissions permitted before the form automatically closes.

2. Conceptual Distinctions

Blueprint vs. Schema Version vs. Draft Session vs. Submission Record

flowchart TD
    BP["FormBlueprint<br/>Owns Identity, Slug, Quotas, Permissions"]
    SV1["FormSchemaVersion 1.0 (Frozen)"]
    SV2["FormSchemaVersion 2.0 (Active Published)"]
    SV3["FormSchemaVersion 3.0 (Draft)"]

    DS["SubmissionDraftSession<br/>Transient Autosave, Resumable Token"]
    SUB["FormSubmission<br/>Immutable Historical Fact, Sealed Answers"]

    BP --> SV1
    BP --> SV2
    BP --> SV3

    SV2 -->|Hydrates| DS
    DS -->|Atomic Commit & Server Validation| SUB
    SUB -->|Permanently Bound To| SV2
DimensionForm BlueprintSchema VersionDraft SessionForm Submission
LifespanPermanent enterprise entity.Immutable once published.Ephemeral (expires in 7–30 days).Permanent historical record.
MutabilityMetadata is mutable (title, quota).Completely frozen if submissions exist.Highly mutable (continuous autosave).Completely immutable.
Primary ActorForm Administrator.Form Designer / Architect.Respondent / User.Submitter & System Validator.
Aggregate RootFormBlueprintFormSchemaVersionSubmissionDraftSessionFormSubmission
Data ScopeAdministrative container.Structural field specifications.Incomplete, work-in-progress values.Final, verified answer map.

Client-Side Validation vs. Authoritative Server-Side Validation

AspectClient-Side Dynamic ValidationAuthoritative Server-Side Validation
Execution EnvironmentRespondent’s web browser or mobile client runtime.Sovereign domain service on backend cluster.
Primary PurposeUser experience (instant visual feedback, masked inputs).Security, data integrity, and invariant enforcement.
Trust ModelUntrusted; easily bypassed or tampered with via API requests.Absolute authority; gatekeeper of the submission database.
Dependency ContextEvaluates active visibility DOM elements.Evaluates full DAG dependency graph and frozen schema descriptors.
Failure ResultInline red UI highlight; disables “Next” button.Rejection with structured ValidationException error map.

Skip Logic (Page Jump) vs. Conditional Visibility (Field Hide/Show)

CharacteristicConditional VisibilitySkip Logic (Branching)
GranularityEvaluated at individual field or section level.Evaluated at page/step boundary.
ActionDynamically reveals or conceals elements on current page.Alters sequential navigation path to forward pages.
Answer Handling When HiddenAnswers in concealed fields are automatically purged.Bypassed pages are recorded as SkippedViaBranching.
Dependency TargetFields on current page or preceding pages.Page completion event; evaluates terminal step answers.
DAG VerificationChecks inter-field relationships for cycles.Checks page directed transitions for infinite loops.

Our Premium Sponsors

Obelaw is proudly open-source. Continued development, bug fixes, and community support are made possible by the generosity of our sponsors.

Sponsor Obelaw