Skip to content

Document how to replay HL7 messages #71

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jeremyestein wants to merge 2 commits into
base: dev
Choose a base branch
from
Open

Document how to replay HL7 messages #71

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d728717
Document how to replay HL7 messages
jeremyestein Feb 25, 2026
5a8dc56
Document how to run a one-off exporter (de-id) run
jeremyestein Feb 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 36 additions & 1 deletion docs/deployment.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -139,4 +139,39 @@ Waveform repo: `docker compose up -d`

### Replay old HL7 data

Not yet supported, see https://github.com/SAFEHR-data/emap/issues/139
Make sure you have built the image (it's the same image as waveform-reader):
`emap docker build waveform-reader-hl7-replay`

To run:
```
emap docker run waveform-reader-hl7-replay --start-datetime '2024-08-25T00:00:00Z' --end-datetime '2024-08-26T00:00:00Z' --source-location 'UCHT03ICURM06' --dry-run
```

Note: timestamps must be parseable by Java's Instant.parse(). Ie. in ISO long form, with hours, minutes, seconds, and UTC indicator 'Z', as shown above.

Date intervals are half-open (inclusive on the start, exclusive on the end)

`--source-location` is optional; all locations included if it's not specified.

Filtering by variable is not currently possible.

# Run de-id on ad adhoc basis

> [!NOTE]
> Due to the way scheduled-script.sh pulls in its config from the config file, the contents of
> that file will override any env vars you specify on the command line below.

You need to temporarily change the exporter.env config file to run this command.

You are likely to want to set the following values (example date shown):
```
ONLY_USE_CSV_FROM_YESTERDAY=FALSE
# something shorter than the standard 180 may be needed if you only just processed the data
CSV_AGE_THRESHOLD_MINUTES=???
# use actual date you want to process
PROCESS_CSV_FROM_DATE=1234-12-12
```
docker compose run --entrypoint /app/exporter-scripts/scheduled-script.sh waveform-exporter
```

Remember to put the config back afterwards.
Loading