DICOM Review Queue
Category: Healthcare Standards
Node id: dicom-review-queue
Maturity: production
Risk tier: C
Opens a human review request for every de-identified instance the detector declined to clear, so escalated images are recorded instead of lost.
What it does
- Opens one review per instance the detector declined to clear, carrying the reasons and the detection geometry
- Idempotent per SOP Instance UID: a retried study does not file the same image twice
- Carries references, never pixels — the image stays in the source archive
- Queues a de-identifier failure too, labelled apart from a deliberate escalation
Use cases
- Routing images with burned-in PHI the detector could not clear to a human reviewer
- Keeping a research export auditable: every image withheld from publication leaves a record
- Telling a de-identifier failure apart from a clinical escalation, which look identical downstream
Runtime
- Performance tier:
fast
Input ports
| Name | Type | Required | Description |
|---|---|---|---|
instances | json | Yes | The dicom-deid result (array mode): result.instances[]. Emitted instances are ignored; escalated and errored ones are queued. |
Output ports
| Name | Type | Required | Description |
|---|---|---|---|
result | json | No | What the run did: reviews opened, already-queued instances skipped, and what could not be queued and why. Whether the STUDY is waiting for a person is reported by dicom-deid, which is the node that knows what it emitted — and which lands a batch earlier, where a marking step still runs when publication fails. |
reviews | json | No | The review requests opened by this run, each linked to the instance it is about. |
count | number | No | How many reviews this run opened. |
Settings
Basic
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Accession | accession | string | No | The episode the run is driven by, recorded on each review so a reviewer can find the study. | ||
| Concentrator Base URL | concentrator_base_url | string | No | Used to build the WADO-RS reference to the ORIGINAL instance. No pixels are copied; the reviewer fetches it through an authorised path. | ||
| Priority | priority | enum | No | high | low, medium, high, urgent, critical | Priority of the reviews this run opens. High by default: an unreviewed escalation is an image withheld from the study it belongs to. |
| Required Role | required_role | string | No | imaging_reviewer | Role a reviewer must hold. These rows carry original identifiers. |
Advanced
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Workflow ID | workflow_id | string | No | dicom-deid-review | Groups these reviews in the inbox and is recorded on each request, so imaging work can be told from other review traffic. | |
| Escalation Hours | escalation_hours | number | No | 24 | Hours before an untouched review escalates. The image is already withheld, so the cost of waiting is a gap in the study, not an exposure. |
Errors
| Code | Description |
|---|---|
REVIEW_STORE | Executed without a human-review store (no platform database) |
REVIEW_INPUT | The instances input is missing or is not a list |
Runtime notes
- Requires the platform database: registered without a store and wired at server boot; reports a clear error when it is missing rather than silently leaving escalated images unreviewed.
- Idempotent per SOP Instance UID, so a study that retries does not file the same image again.
- Carries REFERENCES and findings, never pixels. The row holds original PACS identifiers, so it is marked contains_phi and belongs under the same restriction as the crosswalk.
- An instance the de-identifier ERRORED on is queued too, labelled apart from a deliberate escalation: both need a human, and a crash must not pass for a clinical judgement.
See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.
Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.