Specialized modalities

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

  1. 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.

  2. 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.

  3. Edit the JSON in a text editor. A template has an id (used in the file names), a name, a titleCode for the document title, and a list of fields. Each field has an id, the conceptName shown in the form, a code, a valueType of TEXT, NUMERIC or CODE, and optionally required: true. Every code has a value, a scheme and a meaning. A NUMERIC field also needs units, as a code. There is no editor for templates inside dcmage.

  4. 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.

  5. 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 .dcm file, named after the template id, and the desktop app shows a save panel.

  6. 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.