← Back to catalogue
Published

Form / Submission

vr.wm-rec-007 · wm-rec-007-form-submission

Model the paired instrument definition and the completed, validated, transmitted response package so an agent can define a form, capture and constrain answers, submit them, and operate the resulting acceptance/rejection lifecycle with defensible provenance.

World Models Information and virtual systems INF.REC.FRM

Bundle → Layer → Finding → Questions Filled

7 bundles · 16 layers · 29 findings · 117 questions

Instrument definition The governed form definition: what is asked, how it is identified and versioned, what answers are permitted, what logic applies, and what notices it must carry.

Instrument identity and publication

How a form definition is named, versioned and moved through publication states so a submission can pin an exact, immutable definition.

Instrument identity, version lineage and publication state

The instrument carries a canonical identifier plus business identifiers, an ordered version string with a declared ordering algorithm, a publication status, an experimental flag, an effective period and approval/review dates. Submissions bind to a specific version, so version identity is a correctness requirement, not metadata hygiene.

  1. Which identifier is authoritative for this form definition: the issuing authority's official form number, a governed canonical URI, or a locally minted UUID? identity
  2. How is a substantive new version distinguished from an editorial correction, and which algorithm orders versions? lifecycle
  3. In which publication state is the instrument, and during exactly which period may it accept new submissions? state
  4. Which authority owns the instrument and may approve or retire a version? authority

Item model and answer constraints

The ordered item tree, the stable link identifiers that bind responses to questions, the permitted value domains, and the conditional and derived logic.

Item tree and link identifier contract

Items form an ordered, nestable tree of groups, display elements and answerable questions. Each item carries a link identifier that is the sole contract between definition and response; FHIR makes item.linkId mandatory on every response item and requires the response structure to stay consistent with the definition's grouping and nesting.

  1. Is each item's link identifier unique within the instrument and immutable across the version lineage, and is reuse for a different question forbidden? identity
  2. How are groups, repeating groups and display-only items distinguished from answerable questions? classification
  3. Must the response tree mirror the definition tree exactly, including nesting and sibling order? composition
  4. Is the presentation and transmission order of items semantically significant for interpretation or for legal completeness? constraint

Answer datatypes and value domains

Each answerable item declares a value type and a permitted value domain: a governed code list, an enumerated option set, numeric bounds, string length and pattern, or a unit-bearing quantity. Whether free text may accompany or replace coded options is itself a declared mode.

  1. Which datatype system defines the permitted value type for each item, and is it declared in the instrument or inherited from a schema? definition
  2. Is the answer restricted to a governed value set, and may free text be supplied alongside or instead of a coded option? constraint
  3. For quantity answers, which unit of measure and which precision or significant figures are required? measurement
  4. Which value-domain rules are declared in the instrument versus enforced only by the receiving system, and is any format keyword treated as an assertion rather than an annotation? validation

Conditional enablement and derived values

Items may be enabled by conditions over other answers with a declared combination behaviour, may be read-only or computed, and may be irrelevant. XForms prunes irrelevant nodes at serialization, so relevance directly changes what is transmitted and therefore what is validated and retained.

  1. Under what conditions is each item enabled, and how are multiple conditions combined? constraint
  2. Are values for disabled or irrelevant items pruned from the transmitted payload, retained as explicit nulls, or retained with a coded reason? composition
  3. Which items are computed rather than entered, and is the computation re-evaluated authoritatively by the receiver at submission time? process
  4. How are dependency cycles among conditional and calculated items detected, and is a cyclic instrument rejected at publication? exception

Mandated notices and respondent burden

Disclosures the instrument itself must carry before it may lawfully collect, and the burden and utility justification behind the collection.

Regulatory notice block and burden statement

Where a collection is regulated, the instrument must display specified content on the form itself: the authorising authority, whether response is mandatory or voluntary, the principal purposes and routine uses, the effects of not responding, a currently valid control number with its expiration, and an estimated burden. These are properties of the instrument, and an expired control number invalidates the collection rather than merely the paperwork.

  1. Which statutory or delegated authority permits or compels this collection, and is response mandatory, voluntary, or required to obtain a benefit? authority
  2. What control number and expiration date are displayed, and how are submissions received after expiry handled? requirement
  3. What are the stated principal purposes and routine uses of the collected data, and where are they published? privacy
  4. What per-respondent burden is estimated, how was it derived, and what evidence of practical utility supports the collection? measurement
Submission instance The concrete response package: its identity, its immutable binding to an instrument version, its answer set and its attachments.

Submission identity and instrument binding

How a submission is identified across parties and how it pins the exact definition it answers.

Submission identity and instrument version binding

A submission carries the receiving authority's identifier, the submitter's own reference and, where neither exists, a locally minted UUID/ULID. It binds to exactly one instrument version; FHIR makes that canonical reference mandatory. Drafts created against a version that is later superseded are the sharp edge: the binding must either be pinned or explicitly migrated with a recorded decision.

  1. Which identifier is authoritative for this submission: the receiving authority's receipt or filing number, the submitter's own reference, or an internally minted UUID? identity
  2. To exactly which instrument version is this submission bound, and is that binding immutable once the submission leaves draft? relationship
  3. What happens to an in-progress draft when the bound instrument version is superseded or retired? exception
  4. What is this submission about, and which prior request, order or submission is it based on or part of? relationship

Answer payload and attachments

The answer set with its repetition, ordering and missingness semantics, plus attached supporting evidence.

Answer set composition and missingness semantics

An item may carry several answers and groups may repeat, so the payload is a tree, not a map. RFC 7578 forbids coalescing identically named parts and asks that ordering be preserved. The hardest distinction is missingness: not asked, disabled by logic, asked and left blank, not applicable, and declined are five different facts that a single absent key cannot express.

  1. How are multiple answers to one item and repeated groups represented so that duplicates are not collapsed and occurrence identity is preserved? composition
  2. How is not asked distinguished from disabled by logic, left blank, not applicable and declined to answer? definition
  3. Is the transmitted order of answer entries semantically significant, and must it be preserved through every projection? constraint
  4. Is a partial payload a valid instance, and which items may be absent while the package remains well-formed? state

Attachment parts and supporting evidence

Files accompanying the answers carry field name, filename, media type, character encoding and size. ECF distinguishes lead from connected documents and prefers a binary URI reference over inline base64; RFC 7578 requires receivers to validate filenames against traversal attacks.

  1. Which attached document is the lead document and which are connected or supporting, and does that role affect adjudication? classification
  2. What filename, media type, character encoding and size limits apply, and how are unsafe or ambiguous filenames neutralised on receipt? security
  3. Is the attachment carried inline in the package or referenced by URI, and which party guarantees its continued availability for the retention period? interoperability
  4. What integrity value is recorded so the attachment can later be proven unaltered and reproduced as an accurate and complete copy? evidence
Validation and lifecycle How a submission is checked, what states it may occupy, which transitions are permitted, and how acceptance, rejection and correction are decided and recorded.

Constraint validation

The declared constraint set, the validity states failures produce, and which party's verdict is authoritative.

Constraint model and validity states

Constraints are declared on items and produce specific validity states on failure (value missing, type mismatch, pattern mismatch, too long, too short, range underflow/overflow, step mismatch, bad input, custom error). Crucially, elements can be barred from constraint validation - disabled, read-only or irrelevant items never block submission - and a novalidate/validate=false path exists by design for saving incomplete work.

  1. Which constraint is declared on each item and which validity state does its failure produce? validation
  2. Which items are barred from constraint validation because they are disabled, read-only or irrelevant, and therefore never block submission? exception
  3. Is a declared format treated as a non-blocking annotation or as an enforced assertion, and who made that choice? validation
  4. May validation be deliberately bypassed to save an incomplete draft, and under whose authority is the bypass recorded? authority

Validation tiers and authoritative revalidation

Validation occurs at several tiers: declarative in-form checks, receiver structural revalidation, and business or eligibility rules applied later. Only one tier can be authoritative. 21 CFR 11.10(a) requires validated systems able to discern invalid or altered records, and ECF has the court validate on receipt before docketing - so the receiver, not the client, decides.

  1. When the sending and receiving systems disagree on validity, whose verdict is authoritative and how is the disagreement recorded? authority
  2. Is the full constraint set re-evaluated on receipt, and against which instrument version - the bound one or the current one? validation
  3. How is a validation outcome recorded so it can be replayed and audited after rule sets have changed? evidence
  4. What is the disposition of a payload that passes structural validation but fails a business or eligibility rule? decision

Status model and transitions

The states a submission may occupy and the rules and authority checks governing movement between them.

Submission status model

FHIR defines a required status value set (in-progress, completed, amended, entered-in-error, stopped) and marks status as a modifier element - status changes how the content may be interpreted, not merely how it is displayed. ECF tracks review status and docketing status separately, plus per-document statuses, precisely because a filing can be accepted for review yet fail to record.

  1. What is the current status of the submission, and is status a modifier that changes how the payload may lawfully be used? state
  2. Are review status and recording or docketing status tracked separately, and what does it mean when they disagree? state
  3. Is status tracked per item or per document as well as per submission, and does a part-level rejection reject the whole? composition
  4. Which status values mean the content must not be used for clinical, legal, statistical or operational purposes? exception

Transition rules and sequencing controls

Not every status pair is a legal transition. 21 CFR 11.10(f) requires operational system checks that enforce permitted sequencing of steps and events, and 11.10(g) requires authority checks so only authorised individuals may perform an operation - together these make the transition table an enforced control, not documentation.

  1. Which status transitions are permitted, which are terminal, and what precondition guards each one? lifecycle
  2. What operational system check prevents steps from being performed out of order, for example signing before validation completes? process
  3. Which role is authorised to trigger each transition, and how is that authority checked at execution time? authority
  4. May a submission in a terminal state be reopened, and what record must that create? exception

Adjudication and remedy

Human or automated decision on the submission, and the routes available to correct, replace or withdraw it.

Decision outcome and reason codes

An adjudication records who decided, under what authority, the coded outcome, a human-readable explanation and any remediation instruction. ECF returns an error code with zero meaning success and notifies review completion asynchronously. Whether acceptance backdates to original receipt is a substantive legal question, not a storage detail.

  1. Who reviewed the submission and under what delegated authority did they accept, reject or return it? authority
  2. Which coded reason and human-readable explanation accompany a rejection or return, and are they drawn from a governed code list? decision
  3. Can a submission be partly accepted, and what is the status and disposition of the unaccepted parts? exception
  4. Does acceptance take effect from the original receipt time or from the decision time, and which governs any deadline? temporal

Amendment, withdrawal and resubmission

Corrections after submission are not edits. FHIR distinguishes amended from entered-in-error; CDISC requires an audit record with a reason for change on updates; 21 CFR 11 requires that changes not obscure previously recorded information. The choice between amending in place with version history and creating a superseding submission is a governance decision that must be declared.

  1. Is a correction recorded as a new version of the same submission or as a new submission that supersedes the prior one, and who decided that convention? lifecycle
  2. What explicitly links a resubmission to the rejected or withdrawn submission it replaces? relationship
  3. Is superseded or entered-in-error content retained and retrievable, and how is it excluded from downstream use without being destroyed? retention
  4. Who may withdraw a submission and up to which point in the lifecycle? authority
Provenance, authority and attestation Who supplied, recorded, signed and transmitted the submission, under what authority, and the time-stamped trail that proves it.

Actors, authority and attestation

Role separation among respondent, recorder, submitter and subject, the basis for acting on another's behalf, and the signature that closes the package.

Respondent, author and submitter roles

FHIR keeps source (who answered), author (who recorded) and subject (who the answers are about) as three separate elements, and ECF adds a filer/sender distinct from all three. Assisted or proxy completion, interviewer-administered forms and agent-filed packages all produce different combinations, and the difference is legally material.

  1. Who supplied the answers, who recorded them and who transmitted the package, and are any of these the same party? ownership
  2. Is the submission made on behalf of another party, and what evidence establishes that representation? authority
  3. At which site, organisational unit or jurisdiction was the data captured, and does that affect which rules apply? spatial
  4. What identity proofing or authentication was performed on the submitter before the package was accepted? security

Declaration and signature manifestation

21 CFR 11.50 requires a signed record to carry the printed name of the signer, the date and time of signing, and the meaning of the signature (review, approval, responsibility, authorship); 11.70 requires the signature be linked so it cannot be excised, copied or transferred. The declaration text the signer accepted must be retained verbatim, not regenerated from a current template.

  1. What exact declaration or certification text did the signer accept, and what meaning is attached to the signature? evidence
  2. By what method was the record signed, and how is the signature bound to this exact payload so it cannot be excised or transferred to another record? security
  3. What identity assurance and authority check were performed before the signature was accepted? security
  4. Is the signature manifestation reproducible in human-readable form on any export or printed copy? interoperability

Audit trail and temporal record

The independent, time-stamped record of every action on the submission, and the distinct time points that govern deadlines and timeliness.

Audit record and reason for change

21 CFR 11.10(e) requires secure, computer-generated, time-stamped audit trails that independently record the date and time of operator entries and actions that create, modify or delete records, without obscuring prior values. CDISC pairs each change with user, location, timestamp, reason for change and source identifier, plus a transaction type distinguishing insert from update and removal.

  1. What audit entry is generated for each create, modify and delete action on the submission, and does it capture the prior value? provenance
  2. For which classes of change is a reason for change mandatory, and is a free-text reason acceptable or must it be coded? requirement
  3. Is the audit trail generated independently of the operator and protected from modification or deletion by the parties it records? security
  4. For how long is the audit trail retained relative to the submission itself, and is it disposed of together with the record? retention

Temporal model, deadlines and timeliness

A submission has many distinct times: started, last saved, authored, signed, transmitted, received, decided and disposed. RFC 3339 requires an explicit offset or Z on each, and reserves -00:00 for a known UTC instant with unknown local offset. Deadlines are evaluated in the receiving authority's timezone, which is frequently not the respondent's - and ECF requires submission date and time as filing metadata precisely because that instant has legal effect.

  1. Which distinct time points are recorded for this submission: started, last saved, authored, signed, transmitted, received, decided and disposed? temporal
  2. How is event time (when the respondent answered or signed) kept separate from observation or ingestion time (when the receiver recorded it), and which is used for reporting? provenance
  3. In which timezone is a deadline evaluated, and is an explicit offset recorded with every stored timestamp? temporal
  4. If a submission is rejected and corrected within a grace period, which time counts for deadline compliance? temporal
  5. How long may a draft remain untouched before it expires, and is the respondent warned before expiry? lifecycle
Governance, privacy and disposition Who may see the submission and which parts, what is published or redacted, and how the package is ultimately retained, transferred or destroyed.

Access, confidentiality and disclosure

Authorisation to read and act on a submission, sensitivity at item level, and controlled release to third parties or the public.

Access control and field-level sensitivity

Authority checks must ensure only authorised individuals can use the system, sign, access the operation or alter a record. Submissions are rarely uniformly sensitive: a single package can mix routine fields with identifiers, health data or protected identities, so authorisation granularity below the package is normal rather than exceptional.

  1. Which roles may read, amend, decide on or export the submission, and at what granularity is that authorisation expressed? access
  2. Which items carry heightened sensitivity requiring separate authorisation or separate storage? privacy
  3. Is any part of the submission sealed or restricted from the submitting or responding parties themselves? exception
  4. How is each access to and export of a submission logged, and are denied attempts recorded too? security

Redaction and public release

Some submissions are published - court filings, public comments, regulatory disclosures. Release produces a distinct derived artifact with its own identifier, its own integrity value and a recorded authorisation, and the redaction rule set applied must be retained so the release can be audited against what was actually withheld.

  1. Is any version of this submission published or disclosed beyond the receiving authority, and to whom? privacy
  2. Which items or document regions must be redacted before release, and under which rule set? requirement
  3. Who authorises release, and is the authorisation recorded separately from the release itself? authority
  4. Is the redacted release a distinct artifact with its own identifier and integrity value, so it is never confused with the original? identity

Retention and disposition

How long the submission and its derivatives are kept, under whose authority they are destroyed or transferred, and how erasure requests are reconciled.

Retention, disposition and erasure reconciliation

Records must remain accurately and readily retrievable throughout the retention period, and disposal or transfer happens under a named authority. Drafts and abandoned answers are the neglected case - they contain personal data but often no disposition instruction. Erasure requests and statutory retention genuinely conflict, and the model must record the outcome of that conflict rather than resolve it silently.

  1. Which event starts the retention clock - receipt, final decision, or closure of the parent matter - and how long is the period? retention
  2. Under which named disposition authority is the submission destroyed or transferred, and to which destination? authority
  3. How are abandoned drafts and never-submitted answers disposed of differently from accepted submissions? lifecycle
  4. How is an erasure or correction request from the respondent reconciled with a statutory retention obligation, and is a refusal recorded? exception
  5. Is a legal hold or preservation order in force that suspends the disposition schedule? constraint
Interoperability and transport How the submission is serialised, digested, mapped downstream, transmitted and acknowledged without semantic loss.

Serialization and downstream mapping

The canonical abstract form, its wire projections, and the declared mapping from items to downstream data elements.

Serialization profile and format neutrality

The semantics live in the abstract answer tree; urlencoded pairs, multipart parts, XML and JSON are projections. This matters operationally because signatures and digests must cover a single named canonical form, and because flat name/value encodings cannot represent repeating nested groups without a declared convention.

  1. Which serialization is the canonical form for digesting and signing, as distinct from the transport encodings permitted on the wire? interoperability
  2. What character encoding is asserted for text values, and how is it signalled when the transport cannot carry an explicit declaration? interoperability
  3. How are hierarchical and repeating groups represented in a flat name/value encoding without loss of nesting or occurrence identity? composition
  4. Which encodings are permitted for a given channel, and who decides when they diverge from the instrument's declared serialization? constraint

Definition binding and downstream extraction

Items may carry a definition URI pointing at a target data element, enabling answers to be extracted into semantic records. The boundary must be explicit: FHIR keeps the question-faithful response distinct from derived observations, so extraction produces new entities and does not displace the submission as source of truth.

  1. To which target data element does each item map, and is the mapping declared in the instrument or maintained externally? interoperability
  2. Once answers are extracted downstream, is the extracted record authoritative or does the submission remain the source of truth? provenance
  3. How is the exact question wording preserved when answers are extracted into semantically typed records that discard phrasing? evidence
  4. How are extraction failures surfaced without invalidating an otherwise accepted submission? exception

Populate, extract and standard alignments

SDC populate builds an initial QuestionnaireResponse from existing data; after human review the filler must ensure validity. Extraction uses submitted answers to create or update other resources. Alignments to HTML, XForms, FHIR, PRA and eForms are not claims of joint conformance. Conflicts (R5 required questionnaire canonical versus older optional; XFA deprecated in PDF 2.0; eForms as notices not respondent forms) must be recorded.

  1. Was this response pre-populated, from which sources, and which answers were then edited by a human? provenance
  2. Into which target records or resources were answers extracted after submit, and with what mapping? interoperability
  3. Which external standards is this instance aligned to, and which known conflicts or non-conformances apply? interoperability
  4. If this instrument is an eForms notice, what form type and subtype govern mandatory and conditionally mandatory fields? classification

Channel, receipt and duplicate handling

How the package travels, what acknowledgement the submitter receives, and how repeated deliveries are resolved.

Submission channel and acknowledgement

XForms names the endpoint, method and replace behaviour and raises distinct done and error events; ECF returns a synchronous message status with an error code where zero means success, and reports the review result asynchronously afterwards. Three failure classes must stay distinguishable: transport failure, structural rejection and business rejection.

  1. Through which channel and endpoint was the submission transmitted, and was acceptance acknowledged synchronously or asynchronously? process
  2. What does the acknowledgement contain that lets the submitter prove the package was received at a particular instant? evidence
  3. How are transport errors distinguished from structural rejections and from business rejections in the response? exception
  4. What subsequent notification is owed to the submitter, and within what interval must it arrive? requirement

Duplicate detection and idempotency

At-least-once delivery and impatient respondents both produce repeated transmissions. FHIR treats each completion for a different subject or time as a distinct response, and ECF carries sender/receiver identifiers with a submission date and time - together these give the keys for deciding sameness. Note that a normative idempotency-key mechanism is common practice rather than a requirement in the sources consulted.

  1. Which key determines that two received packages are the same submission rather than two legitimately distinct ones? identity
  2. Within what window is a repeated transmission treated as a retry rather than a new submission? temporal
  3. What is returned when a duplicate is detected - the original receipt, a conflict error, or a new receipt referencing the original? exception
Respondent experience and quality How errors are communicated and prevented for the person completing the form, and how the collection's real burden and quality are measured.

Accessibility and error communication

Normative requirements on how a form labels its inputs, reports failures and prevents costly mistakes.

Error identification and suggestion

WCAG 2.2 requires at Level A that input errors be automatically detected, the item identified and the error described in text (3.3.1), and that labels or instructions be provided where input is required (3.3.2); at Level AA it requires correction suggestions where known (3.3.3) and that status messages be programmatically determinable without receiving focus (4.1.3). These bind the shape of the validation issue objects, not just the styling.

  1. For each failed constraint, is the erroneous item identified and the error described in text rather than by colour or position alone? quality
  2. Is a correction suggestion provided when one is known, and is it deliberately withheld where suggesting it would compromise security or purpose? exception
  3. Are validation results and progress exposed programmatically so assistive technology is notified without moving focus? access
  4. Does every item requiring input carry a label or instruction, and do headings and labels describe topic or purpose? requirement

Error prevention and confirmation

WCAG 2.2 requires at Level AA that submissions with legal or financial consequences, or that modify user-controlled data, be reversible, checked, or confirmed (3.3.4), and at Level A that previously entered information not be redundantly re-requested (3.3.7). Whether a submission is legally binding therefore changes the mandatory interaction design, so the classification must be recorded on the instrument.

  1. Is this submission legally binding, financial, or a modification of user-controlled data, and therefore subject to the reversible, checked or confirmed requirement? classification
  2. Is a review-and-confirm step presented before irreversible submission, and is the respondent's confirmation itself recorded? process
  3. Is information the respondent already supplied in the same process re-requested, and if so on what justification? requirement
  4. Is the purpose of each personal-data input programmatically identified so autofill and personalisation can operate? interoperability

Quality and paradata

Observed evidence about how the collection actually performs against its claimed burden and utility.

Submission quality metrics and paradata

Regulated collections must estimate burden and demonstrate practical utility that is actual rather than theoretical, and records must be accurate, relevant, timely and complete. Observed paradata - time to complete, abandonment point, item non-response, edit-check failure concentration and rejection rate - is the falsification test for those claims and the input to instrument revision.

  1. What measured time to complete is observed, and how does it compare with the published burden estimate? measurement
  2. What proportion of started submissions are abandoned, and at which item does abandonment concentrate? measurement
  3. Which items generate the most validation failures or rejections, and has the instrument been revised in response? quality
  4. What evidence shows the collected data is actually used, and which items have never been consumed downstream? evidence

Classifiers Filled

Family
World Models
Category
Information and virtual systems
Entry kind
aggregate
Navigation path
NAV.INF.REC.FRM
Domain
INF.REC.FRM
Industry
Cross-industry
Tags
formsubmissioninf.rec.frm

What it is Filled

Covers (a) the form/instrument definition: identity, versioning, publication state, item tree, answer value domains, conditional logic and mandated respondent notices; and (b) the submission instance: answer payload, attachments, validation runs, status lifecycle, adjudication, attestation, audit trail, disposition and downstream extraction. Every authoritative source pairs the two (FHIR Questionnaire<->QuestionnaireResponse via linkId; XForms model/bind<->instance/submission; CDISC FormDef<->FormData; HTML form element<->entry list; ECF filing profile<->FilingMessage), and the binding contract only exists across the pair, so splitting them would orphan the contract. Format-neutral: JSON, XML, multipart, Markdown, Git, MCP and MongoDB are projections.

In scope

  • Instrument definition: canonical identity, version lineage, publication state, effectivity, issuing authority
  • Item tree: stable link identifiers, item types, ordering, nesting, repeats, required flags
  • Answer value domains: datatypes, governed code lists, ranges, patterns, units, answer-constraint modes
  • Conditional enablement, calculated/derived items and relevance-driven pruning
  • Mandated respondent notices: legal authority, obligation, purpose, routine uses, control number and expiry, burden statement
  • Submission instance identity and immutable binding to an exact instrument version
  • Answer payload composition, repeats, ordering and missingness semantics
  • Attachments and supporting evidence carried in or referenced by the package
  • Constraint validation, validity states, validation tiers and authoritative revalidation on receipt
  • Submission status model, permitted transitions and enforced step sequencing
  • Review/adjudication outcomes, reason codes, amendment, withdrawal and resubmission
  • Respondent/author/submitter roles, delegation and attestation with signature manifestation
  • Time-stamped audit trail, reason for change, and the separation of event time from ingestion time
  • Access control, field-level sensitivity, redaction and public release
  • Retention, disposition, legal hold and erasure reconciliation
  • Serialization profiles, canonical form for digesting, and downstream extraction mapping
  • Acknowledgement/receipt, channel semantics and duplicate detection
  • Accessible error communication, error prevention and respondent-burden quality metrics

Out of scope

  • The generic records programme (registration, classification scheme, disposal authority as an instrument of governance) - belongs to WM-REC-001 Record
  • Party/Agent identity as an entity (natural person, organisation, credential) - referenced only
  • Binary document/file object modelling, format migration and rendition management - referenced only
  • Cryptographic signature construction and trust-service levels (certificate chains, seal validation) - aligned, not restated
  • Case, matter or business-process orchestration beyond the submission's own status
  • Payment, fee assessment and financial transaction handling
  • Consent as a standalone legal instrument with its own lifecycle
  • Governed vocabulary/value-set registry management
  • Survey methodology and statistical estimation (sampling frames, weighting, imputation)
  • Message transport infrastructure, queuing and notification delivery guarantees
  • User interface rendering, layout and theming

Why it exists Filled

Model the paired instrument definition and the completed, validated, transmitted response package so an agent can define a form, capture and constrain answers, submit them, and operate the resulting acceptance/rejection lifecycle with defensible provenance.

Distinguishing features Filled

  • Pairs a versioned form definition with each submission made against it, so every answer is read against the exact version that asked it.
  • Differs from an observation record: a submission captures what a respondent declared, not what was measured.
  • Differs from a case or workflow, which processes the submission after receipt.
  • Carries mandated respondent notices, attestation and validation runs as part of the record.

What robots and AI may and may not do Filled

Must not

  • Sign, declare or attest on behalf of a respondent without explicit delegation.
  • Change answers in a submitted record instead of recording an amendment.
  • Hide or skip mandated notices such as privacy or penalty warnings.
  • Validate a submission against a different form version than the one it was made on.
  • Collect answers that the form version does not ask for.

Only with a human decision

  • Signing a declaration or attestation that carries legal consequences.
  • Adjudicating a submission that fails validation or looks fraudulent.
  • Publishing a new form version that changes what respondents must disclose.

May

  • Open a draft submission and pre-fill answers from verified sources the respondent can review.
  • Validate answers against the value domains and conditional logic of the pinned form version.
  • Acknowledge receipt with a timestamped reference.
  • Extract answers to downstream records with a link back to the submission.

Moral aspects Filled

  • Forms collect personal and often sensitive data; questions should ask only what the stated purpose needs.
  • Poorly designed forms exclude people with disabilities, low literacy or other languages.
  • Pre-filled answers can lead respondents to declare things they did not check.

Who is affected

  • Respondents and the people they report about
  • Officers who adjudicate submissions
  • Downstream users who rely on extracted data

Owners Filled

Steward

Name one accountable owner for the instrument catalogue (form definitions) and, where different, one for the submission store; both must be named before any instrument is published.

Roles

Respondent / source
Supply the answers and any supporting evidence; Accept the declaration text where attestation is required; Receive and retain the acknowledgement and any adjudication notice; Exercise access, correction and erasure requests
Author / recorder
Enter or transcribe answers on behalf of a respondent in assisted or interviewer-administered collections; Record the source of each answer where it differs from the recorder; Supply a reason for change on corrections to previously recorded answers
Submitter / filer of record
Transmit the package and hold the evidence of representation where filing on another's behalf; Resolve transport failures and rejections and manage resubmission; Retain the receipt as evidence of timely submission
Instrument steward
Own the instrument catalogue, version lineage and publication decisions; Keep mandated notices, control numbers and burden estimates current; Maintain link identifier uniqueness and the retired-identifier reservation list; Act on paradata evidence to revise or retire items
Reviewer / adjudicator
Apply review criteria and record accept, reject or return decisions with governed reason codes; Set the effective filing time and any remediation instruction; Handle partial acceptance and part-level statuses; Operate within delegated authority and permitted transitions
Records custodian
Bind retention schedules and disposition authorities to instruments and submissions; Apply and release legal holds; Execute disposition and retain destruction or transfer certificates; Ensure accurate and complete copies remain retrievable throughout retention
Privacy and disclosure officer
Approve the notice block, purposes and routine uses before publication; Authorise redacted releases against a versioned redaction rule set; Adjudicate erasure and correction requests against retention obligations; Review data minimisation at each instrument revision
Validation and system assurance owner
Maintain and version the constraint and edit-check specification; Validate the system so it can discern invalid or altered records; Prove that sequencing and authority checks are enforced, not merely documented; Preserve canonicalisation profiles and digest algorithms for the retention period

Links to other meta-models Filled

child

  • WM-REC-001 Record - Form/Submission is a specialisation of Record covering the pre-record elicitation and validation surface; an accepted submission is declared into Record for classification, registration and disposal, and inherits its records-programme obligations rather than restating them.

references

  • Party / Agent (respondent, author, submitter, reviewer, signer) - Every actor role on a submission resolves to an externally governed party identity; this model records the role and the evidence of authority, not the party's own attributes or credentials.
  • Electronic Signature / Seal - The signature manifestation and its binding digest are recorded here; certificate chains, trust lists and signature validation algorithms are resolved by the signature model.
  • Value set / code list registry - Items bind coded answer domains to governed value sets by canonical reference and pinned version; curation and publication of those vocabularies is out of scope.
  • Retention schedule / disposition authority - Supplies the trigger, period and approved action that this model applies to the submission, its audit trail and its derived releases.
  • Case / matter / workflow - Downstream docketing, assignment and business processing consume an accepted submission; the submission keeps its own review status separately because review and recording outcomes can diverge.
  • Consent / authorization instrument - Where a submission relies on consent as its lawful basis, that consent is a separate instrument with its own lifecycle; this model records only the reference and the basis code.
  • Payment / fee transaction - Filing fees and payment allowances accompany some submissions but are settled in a financial model; only the reference and its effect on acceptance belong here.

composes

  • Document / File object - Attachments are composed into the submission package with part-level metadata and digests, while the document's own lifecycle, renditions and format policy remain with the document model.
  • Audit event / provenance log - Supplies the append-only, tamper-evident, time-stamped trail that every mutating function on this model must write to, including the reason-for-change discipline.
  • Access policy / authorization - Supplies the authority-check mechanism enforcing which roles may read, amend, sign, decide, export or dispose, at package, document and item granularity.

aligned

  • HL7 FHIR Questionnaire and QuestionnaireResponse (R5) - Alignment target for the definition/response pairing, the linkId binding contract, the response status value set and the author/source/subject role separation. Alignment only - no conformance is claimed.
  • OASIS Electronic Court Filing 5.01 filing message - Alignment target for submission-as-filing: lead and connected documents, separate review and docketing statuses, synchronous status plus asynchronous review-complete callback, and document signature profiles.
  • CDISC ODM v2.0 FormDef / FormData - Alignment target for metadata/clinical-data separation, audit records with reason for change, transaction types and one abstract model across multiple serializations.
  • WHATWG HTML forms and IETF RFC 7578 multipart/form-data - Alignment target for entry-list construction, enctype selection, constraint validation and validity states, and the no-coalescing and ordering rules for identically named parts.
  • W3C WCAG 2.2 conformance profile - Alignment target for the normative respondent-facing criteria on labels, error identification, error suggestion, error prevention, redundant entry and status messages, at declared conformance levels.
  • W3C XForms 1.1 model / bind / submission - Alignment target for model-item properties, the submission element's resource/method/replace/validate attributes, submission events and relevance pruning at serialization.

neighbor

  • WM-REC-001 Record (parent) - Record governs registration, classification and disposal of any record. Form/Submission governs the pre-record surface: the instrument that elicits data, the validation and adjudication that decide whether a package becomes a record, and the answer<->question binding that Record does not carry. An accepted submission is declared into the Record model; a rejected or abandoned draft usually never becomes one.
  • Observation / semantic clinical or business record - QuestionnaireResponse deliberately preserves the specific phrasing and organisation of the questions; Observation preserves only the semantic meaning. Form/Submission is the wording-faithful artifact; extracted semantic records are separate downstream entities linked by item.definition.
  • Electronic Signature / Seal - This model records the signature manifestation and its binding to the payload (printed name, date and time, meaning of the signature, non-transferability). It does not model certificate chains, trust lists or validation algorithms.
  • Document / Attachment object - The model carries part-level metadata (field name, filename, media type, charset, role as lead vs connected document, digest, or a reference URI) but not the document's own lifecycle, renditions or format policy.
  • Case / Workflow - The submission has its own status and transitions. Downstream docketing, case assignment and business processing are separate; ECF separates filing review status from docketing status precisely because the two can disagree.
  • Value set / code list registry - Items bind to governed answer value sets by reference. Curation, versioning and publication of those code lists is out of scope.
  • Instrument definition vs submission instance (internal boundary, review-required) - Some registries split these into two entries. This model keeps them together because the linkId/definition binding contract, version pinning and validation semantics span both and would be orphaned by a split. If the registry later splits them, the split line is: everything under bundle 'instrument-definition' moves out and bundles 2-7 stay, with the version-binding finding duplicated as a REFERENCE.

parent

  • WM-REC-001

What else AI and robots need to interact with it Filled

Identity and identifiers required Filled

  • Authoritative master-system identifier issued by the receiving authority or issuing body - receipt/filing number, official form number, or control number - used whenever one exists.
  • Governed global identifier or canonical IRI for the instrument version or submission, minted in the registered namespace of the owning Dimension.
  • UUID or ULID assigned by the adopting Dimension, used only when neither an authoritative nor a governed global identifier is available, and always recorded alongside any later-issued authoritative identifier rather than replaced by it.

Direct properties not applicable Not applicable

Not applicable

Institutional or informational subject: no invented physical properties.

Recognition optional Filled

  • A submission references a form definition version and holds answers keyed to its items, with status and receipt.
  • Often confused with the form template itself, a document upload and the case that processes it.

Capabilities and actions required Filled

  • Publish instrument version: Promote a draft form definition to an immutable, bindable published version.
  • Open submission draft: Create a draft submission pinned to an exact instrument version and mint its identifier.
  • Capture answer: Record or change an answer for one item, re-evaluating enablement and derived values.
  • Attach supporting document: Add or reference a file part with its metadata, role and integrity value.
  • Validate submission: Evaluate the declared constraint set against a payload revision and emit a replayable verdict.
  • Sign and declare: Bind an attestation to a specific payload digest with a full signature manifestation.
  • Transmit submission: Serialise the package into a permitted transport encoding and deliver it to the receiving endpoint.
  • Acknowledge receipt: Issue a receipt binding a payload digest to a received instant.
  • Revalidate on receipt: Re-evaluate the full constraint set at the receiver against the bound instrument version, independently of any sender verdict.
  • Adjudicate submission: Record an accept, reject or return decision with reason codes and effective time.
  • Amend or withdraw submission: Record a correction, retraction or withdrawal without destroying prior content.
  • Extract to downstream record: Populate semantically typed downstream records from mapped items while preserving question wording.
  • Release redacted copy: Produce and authorise a derived, redacted artifact for disclosure or publication.
  • Apply disposition: Execute retention, hold, transfer or destruction under a named authority.
  • Populate a response: Create an initial response package from an instrument and available source data, then present it for human review.
  • Author or revise instrument: Create or version a form instrument with unique link ids, constraints, labels and submission parameters.
  • Clear an information collection: Obtain or extend authority to use an instrument as a collection of information, including burden, notices and control number.

Hazards and failure modes required Filled

  • Submissions interpreted against the wrong form version produce wrong decisions.
  • Lost or unacknowledged submissions cause missed deadlines and penalties for the respondent.
  • Attachments and answers leak sensitive personal data if access is too broad.

Standards and interfaces required Filled

  • HL7 FHIR Questionnaire and QuestionnaireResponse resources.
  • W3C HTML forms.
  • RFC 7578 multipart/form-data.
  • W3C XForms 1.1.
  • ISO 15489-1 records management.

Context of use required Filled

  • Mandated-notice content is drawn from United States instruments (5 CFR 1320 control number, expiration and burden statement; 5 U.S.C. 552a(e)(3) authority, purposes, routine uses and effects of non-response). Other jurisdictions impose analogous but differently structured notice duties, and the notice block finding must be re-parameterised per jurisdiction rather than copied.
  • 21 CFR Part 11 controls are United States FDA-regulated-industry requirements. They are used here as an authoritative articulation of audit-trail, sequencing, authority-check and signature-manifestation practice, not as a claim that all submissions are subject to them.
  • NARA Universal ERM Requirements are United States federal-agency requirements; the capture/maintenance/disposal/transfer structure generalises well but the Must Have classification does not bind outside that context.
  • OASIS ECF reflects United States court filing practice; the review-versus-docketing status separation is a strong general pattern but the specific code sets are jurisdiction-bound.
  • EU data-protection obligations (lawful basis, storage limitation, information-to-be-provided, automated decision-making) are structurally parallel to the Privacy Act provisions used here, but the EUR-Lex text could not be retrieved live during this research and is therefore not cited; a European adoption must re-derive the notice and retention findings from the regulation directly.
  • WCAG 2.2 conformance levels are cited as the criteria themselves state them; whether Level A, AA or AAA is mandatory depends on the adopting jurisdiction's procurement or accessibility law, which is not modelled.
  • OMB control numbers, public-protection statements and ICR processes apply to US federal collections, not to all jurisdictions.
  • eForms obligation matrices and TED publication apply to EU public-procurement notices above threshold (mandatory from October 2023) and to listed voluntary subtypes.
  • WCAG-based error-prevention is treated as the default accessibility floor for interactive web instruments; other modalities must still associate labels with controls as XForms requires.
  • FHIR party compartments are healthcare-centric; other sectors map them to equivalent respondent, subject and recorder roles.
  • Qualified electronic signature legal effect is EU-specific and unverified in this run.

Sources Filled

  1. HTML Standard - Form control infrastructure (form data set, constraint validation, form submission) - WHATWG
  2. QuestionnaireResponse - FHIR v5.0.0 - HL7 International
  3. Questionnaire - FHIR v5.0.0 - HL7 International
  4. XForms 1.1 - World Wide Web Consortium (W3C)
  5. RFC 7578: Returning Values from Forms: multipart/form-data - Internet Engineering Task Force (IETF)
  6. Electronic Court Filing Version 5.01 - OASIS Open (LegalXML Electronic Court Filing TC)
  7. Web Content Accessibility Guidelines (WCAG) 2.2 - World Wide Web Consortium (W3C)
  8. 21 CFR Part 11 - Electronic Records; Electronic Signatures - U.S. Food and Drug Administration / U.S. Government Publishing Office
  9. 5 CFR Part 1320 - Controlling Paperwork Burdens on the Public - U.S. Office of Management and Budget (OIRA) / U.S. Government Publishing Office
  10. 5 U.S.C. 552a - Records maintained on individuals (Privacy Act) - U.S. Government Publishing Office (U.S. Code)
  11. JSON Schema Validation: A Vocabulary for Structural Validation of JSON (draft 2020-12) - JSON Schema Organization / IETF Internet-Draft (draft-bhutton-json-schema-validation-01)
  12. Universal Electronic Records Management (ERM) Requirements - U.S. National Archives and Records Administration (NARA)
  13. ODM v2.0 (Operational Data Model) - CDISC
  14. RFC 3339: Date and Time on the Internet: Timestamps - Internet Engineering Task Force (IETF)
  15. XForms 1.1 W3C Recommendation - World Wide Web Consortium
  16. HL7 FHIR R5 Resource Questionnaire - Health Level Seven International
  17. HL7 FHIR R5 Resource QuestionnaireResponse - Health Level Seven International
  18. 5 CFR Part 1320 Controlling Paperwork Burdens on the Public - United States Office of Management and Budget
  19. PRA approval process - U.S. General Services Administration / Office of Information and Regulatory Affairs
  20. TED eForms standards and eForms SDK - Publications Office of the European Union
  21. W3C WAI Tutorials — Validating Input - World Wide Web Consortium Web Accessibility Initiative
  22. FHIR ValueSet Questionnaire Response Status - Health Level Seven International
  23. HL7 FHIR Structured Data Capture — Form Data Extraction - Health Level Seven International

Open questions

  • Localisation and translation equivalence across instrument versions: whether a translated item is the same question for binding, validation and legal-completeness purposes, and how locale is carried on item text, notices, error messages and declaration text. Both providers carry language only as an attribute; neither has a governing source.
  • EU profile re-derivation from primary text: Regulation (EU) 2019/1780 and the eForms SDK, GDPR erasure and storage-limitation duties, and eIDAS advanced versus qualified signature effect - all unretrieved or secondary in both packs and currently blocking any European adoption of the notice, retention and attestation findings.
  • PRA clearance-authorization lifecycle taxonomy (standard, generic, emergency, extension, revision, reinstatement; approval not granted beyond three years) to be folded into the existing mandated-notice finding rather than materialised as a second finding, once the new obtain-or-renew-collection-authority function is in place.
  • Offline and intermittent capture: trusted time, clock-skew tolerance and the gap between authored instant and received instant for disconnected field capture. No source in either pack governs trusted timestamping.
  • Record-capture handoff to WM-REC-001: the linkage carrying record identifier and capture instant when an accepted submission is declared into the parent Record model, pending retrieval of ISO 15489 or an equivalent primary authority.
  • Response-driven instance replacement (XForms replace and targetref): which copy is authoritative after the receiving system returns values that overwrite the submitter's instance, and how that interacts with the signed canonical form.
  • Multi-party sequential co-signing, countersigning and power-of-attorney to submit: both providers flag this as an omission and the signature block supports multiple signers with no ordering or quorum semantics asserted.
  • No trusted-timestamp or time-attestation mechanism is modelled; received-at is asserted by the receiving authority and its trustworthiness is assumed rather than proven.
  • Instrument authoring, review and approval workflow is not modelled - only the resulting publication state and approval dates.
  • Multi-party or sequential co-signing and countersigning of one submission is not modelled; the signature block supports multiple signers but no ordering or quorum semantics are asserted.
  • Fee calculation, waiver and payment settlement are referenced but not modelled.
  • Rendering, pagination, progressive disclosure and multi-page wizard state beyond draft persistence are out of scope.
  • Anti-automation, rate limiting and bot detection on public submission endpoints are not modelled despite being operationally significant for open collections.
  • Translation equivalence between localised instrument versions is not governed.
  • Statistical treatment of item non-response (imputation, weighting) is deliberately excluded as survey methodology.
  • Long-term signature validation and re-timestamping to survive algorithm obsolescence across a multi-decade retention period is acknowledged in the integrity rule but not modelled.
  • ISO 15489 authenticity, reliability, integrity and usability principles were not retrieved as full text; record-capture therefore leans on PRA recordkeeping and the parent Record model.
  • Regulation (EU) No 910/2014 eIDAS full text was not retrieved; qualified versus advanced signatures are an evidence gap and an alignment, not a native profile.
  • ISO 32000 PDF AcroForm and deprecated XFA were discovered in secondary discussion and not fetched as primary text.
  • ICH eCTD, national tax-return, court e-filing, ODK/XLSForm, JSON Forms and NIEM IEPD specializations were not modelled.
  • GDPR erasure interaction with records schedules is only asked, not specified.
  • Concurrent editing, autosave intervals, CAPTCHA and rate-limiting are operational controls not specified here.
  • Multi-signer sequential routing and power-of-attorney to submit are likely omissions.
  • Statistical Part B methods, sampling and statistical-disclosure control are out of scope and unmodelled.

Machine files

Provenance

world-models research · reviewable-draft

Built from: models/wm-rec-007-form-submission/spec.yaml, ver-cy/world-models/card-supplements/wm-rec-007-form-submission.json