Updated IOWA Reporting Forms - Test DATAGRID

Purpose: Visual verification of the updated IBHRS form (editgrid replaced by datagrid).
Sections: Client Data, Treatment Episode, Service Event
File: combinediowareportingforms.json Download JSON datagrid version
Loading form...

Changelog / Applied Changes

v3 - Set clearOnHide=false on all data fields

v2 - Snapshot before clearOnHide fix

v1 - Original Updated Form (Datagrid)


Linkage Priority Rules (for Export Code)

When processing ServiceEvent data in export mappers, linkage fields have TWO sources:

  1. Select box - for linking to episodes/care statuses in the CURRENT submission
  2. Text field - for manual entry (linking to PREVIOUS submissions)

Priority: Text field takes precedence over select box if both are filled.

// Episode linkage
const episodeId = data.linkedEpisodeIdentifier || data.linkedEpisodeIdentifierSelect;

// Care Status linkage
const careStatusId = data.linkedCareStatusIdentifier || data.linkedCareStatusIdentifierSelect;

Predecessor Care Status Linkage (for Export Code)

IBHRS Requirement: Transfer and Discharge care statuses must reference their predecessor (the Admission or Transfer they are transitioning from).

Care Status Chain: Admission -> Transfer -> Discharge

Two input methods (same pattern as Episode/Care Status linkage):

  1. Select box (predecessorCareStatusIdentifierSelect) - for linking to Admission/Transfer in CURRENT form
  2. Text field (predecessorCareStatusIdentifier) - for manual entry (linking to PREVIOUS submissions)

Priority: Select box takes precedence, text field is fallback.

// Predecessor Care Status linkage (for Transfer/Discharge only)
const predecessorId = data.predecessorCareStatusIdentifierSelect || data.predecessorCareStatusIdentifier;

Conditional Fields Reference (for Export Code)

Many fields are conditionally visible based on:

ASAM Fields by Care Status:

Field Pre-Admission Admission Transfer Discharge
asamLevelOfCare ERROR if provided Required Required Required
recommendedLevelOfCare Hidden Required Optional Optional
clinicalOverrideReason Hidden Required if ASAM != Recommended; Warning if provided when same

Export mappers should check conditional visibility before including fields.


Testing Conditional Fields

To test conditional field visibility:

  1. Load the form and expand the Treatment Episode section
  2. Change the Status field to different values:
    • Pre-Admission: Most fields should be hidden
    • Admission: Prior episode fields should appear
    • Transfer/Discharge: Discharge Reason should appear, Prior fields hidden
  3. Change the Program Area field:
    • Substance Use: Days Substance Used, Substance-related arrests visible
    • Gambling: Days Gambled, Bankruptcy, Money Lost, Gambling arrests visible
  4. Toggle Known fields to Yes/No to see count fields appear/disappear