Configure custom Structured Report templates for clinical trials
Load a trial template from a JSON file and author Structured Reports from it.
Problem
Clinical research trials often require specialized case report forms and non-standard measurement hierarchies that deviate from baseline DICOM templates. You need Structured Report (SR) templates with trial-specific concept codes, units and required fields, shared as one file so every site records the same items.
Steps
-
Open the authoring form. Open an image of the study the report belongs to, then run Author Structured Report… from the command palette (⌘K), or click + New from template in the SR tab.
-
Start from an existing template. With RECIST 1.1 Tumor Response selected, click Save template…. dcmage saves it as
recist-1-1-template.json, a starting point that shows the format. The desktop app shows a save panel and the browser downloads the file. -
Edit the JSON in a text editor. A template has an
id(used in the file names), aname, atitleCodefor the document title, and a list offields. Each field has anid, theconceptNameshown in the form, acode, avalueTypeofTEXT,NUMERICorCODE, and optionallyrequired: true. Every code has avalue, aschemeand ameaning. ANUMERICfield also needsunits, as a code. There is no editor for templates inside dcmage. -
Load it. Click Load template… and choose the file. It appears in the Template list as its name followed by (custom), and its fields replace the form. A file that is not valid JSON, or a template with a missing or malformed part, is refused, and the error under the form names the field at fault. The loaded template lasts until you close the form, so load the file again next time.
-
Author the trial report. Fill in the fields. Required fields carry an asterisk, and numeric fields accept numbers only. Click Create Report. The browser downloads the
.dcmfile, named after the templateid, and the desktop app shows a save panel. -
Distribute the template. Send the same JSON file to every trial site, so each one loads identical codes and fields.
Result
Each site authors a Comprehensive SR from the same trial template: the document title and every field carry the concept codes and units the JSON defines, required fields cannot be left empty, and the report carries the open study’s patient and study identifiers, so it files under that study. A CODE field records the text you type as the code meaning. See Create new Structured Reports for what the file contains.