Report Builder

Use Admin > Report Builder to create reusable report templates, shared content blocks and the Lab Submission Receipt. These editing screens are available to admins; staff generate reports from cases they can access.

Generate a case report

Open a case and choose Report in its submenu. Choose Report Wizard for an admin-created template, or Default Report for the standard report.

The wizard has up to five steps; steps that the template does not need are skipped:

  1. Choose Template — switch between Case Reports and Evidence Reports. Each tab has its own Recently Used list when available; evidence templates cannot be selected for a case without evidence.
  2. Select Evidence — choose the evidence to include, or use Select All for a case report. An evidence report requires one evidence item.
  3. Fill in Prompts — enter the text requested by the template. Templates without prompts skip this step.
  4. Choose Options — choose Skip Empty Fields or Print Empty Fields, and Skip Empty Rows or Print Empty Rows. Select the items offered by the template, such as memos, uploads, expenses, assignments, forensic tools, custody and reviews.
  5. Print/Preview — inspect the report, then choose Generate. Use the step menu to return to earlier choices.

Options depend on the template and enabled features. Evidence report templates do not offer case uploads.

Report Wizard template chooser with Case Reports and Evidence Reports tabs and a template card

  1. Case Reports: choose a template for case information and associated evidence.
  2. Evidence Reports: choose a template for one evidence item.
  3. Open a template card to continue.

Uploads and ZIP downloads

When the wizard includes Uploads, select the files to include and choose a Zip option:

Option Download
None The PDF report without a ZIP archive.
All Requests a ZIP containing the PDF report, images and files.
Selected A ZIP containing the PDF report and only the selected images and files.

Report Wizard upload controls showing Embed PDF Documents and ZIP All or Selected

  1. Embed PDF Documents: embed supported PDF uploads in the PDF report.
  2. All: request the report and file archive.
  3. Selected: request an archive of selected uploads.

In this release, both wizard ZIP choices use the selected upload list. Select every required upload even when choosing All, and check the downloaded archive.

Embed PDF Documents embeds supported PDFs in a PDF export; fillable PDFs are flattened. Missing or unsupported files are listed rather than embedded; review any warning beside an upload.

Default Report options

The Default Report has its own options rather than the template wizard. Select evidence and included sections, then choose Word or PDF under Export as.

  • Print Empty Pages: choose No to exclude pages with no content.
  • Zip all files, Zip selected files or Do not zip: control the accompanying file archive.
  • Reviews: choose Result Only, Full Reviews or Nothing when reviews are available.

Check the preview and the selected uploads before sharing the output.

Report traces

Each case report and Report Builder report writes a trace of every part as it's built. If a report fails, the error offers Download the report trace to send to support: attach it to your support ticket.

Admins find the traces of the last 24 hours in Admin > Report Traces, with who ran each report, on which case, and how long it took.

Report Traces page with one trace and its Outcome and Download link

  1. Outcome: Success, Failed or Did not finish.
  2. Download: the trace to attach to your support ticket.

Traces are deleted after 24 hours. To keep traces of reports that succeeded too, turn on Keep Traces of Successful Reports in About / Settings.


Create or edit a template

A template sets the report's overall structure. Its blocks hold rows and columns of fields; the Content Library stores blocks that several templates can share.

  1. Open Admin > Report Builder > Template Gallery.
  2. Filter using the left sidebar, and switch between Grid View and List View as needed.
  3. Open an existing template, choose Copy to start from one, or choose Add New Report Template.
  4. Set Template Name and Template Description so staff can identify the report.
  5. Open Content Library in the builder sidebar and choose blocks for the report.
  6. Use Sort Blocks to reorder them, then check Preview.

Default templates can be copied, but their Delete action is unavailable. Editing a template changes future reports that use it.

Template names and descriptions save when you leave the field; layout changes and setting switches save as you use them. Formatting changes in the side panel require Save; check Preview when finished.

Report template editor showing Content Library, Customize, Sort Blocks and Preview controls

  1. Content Library: add a reusable block.
  2. Customize: make this block local to the template.
  3. Sort Blocks: reorder the report sections.
  4. Preview: check the template output.

Shared and customized blocks

A linked Content Library block is shared: editing the original changes every template using that block. The library identifies blocks IN USE and lists the templates that use them; remove those links before deleting the library block.

Choose Customize to unlink a block and edit a local copy in one template. Save to Content Library creates a reusable library block and links the template to it.

Use Switch Block to replace a section's content with another block, or Remove to remove it from the template. Replacement and removal display confirmation prompts; replacing a block discards its current content.

Page layout

  • Header Footer enables content repeated on each page.
  • Requires Signature adds a signature section.
  • Grouping selects blocks to group under evidence.
  • Include Evidence Type Data, when offered, includes fields from the appropriate evidence-type report block, such as the Mobile Phone block.
  • Show Evidence section at the end of the report moves evidence after the standard sections.


Build a Content Library block

Open Admin > Report Builder > Content Library. Open a block to edit it, use Copy to make a variation, or choose Add to Content Library for a new block.

  1. Choose the block type and give it a recognizable Content Name and Description.
  2. Choose Add Row and select a column layout, Spacer Row or Page Break.
  3. Use Add Field inside a cell to choose a data field or another content type.
  4. Use the pencil control to format a cell, then Save the sidebar changes and check Preview.

Available data fields depend on the block type and your configured forms; disabled fields and USSS stats fields are excluded. For example, case and evidence blocks offer their form fields; other block types offer memo, upload, expense, custody, forensic software, assignment, review or author fields.

Content type Use
Short Text, Rich Text Field Fixed wording, with formatting for rich text.
Prompt Ask the report's author for text during generation.
Current Date, Page Number Generated date or page numbering.
Image, Agency Logo An image or the configured agency logo.
Empty A blank cell for the layout.

Format Cell controls background, borders, font, label display and label alignment. A customized template block can also use Format Section to style its section.

A field added or removed in Form Builder may require the corresponding report block to be updated. Check the relevant block and preview after changing a form.


Lab Submission Receipt

Open Admin > Report Builder > Lab Submission Receipt to edit the receipt used by Request Submission. This is a separate builder, rather than a case-report template in the wizard.

Lab Submission Receipt toolbar showing Add Row, Auto Generate Report and Preview

  1. Add Row: extend the receipt layout.
  2. Auto Generate Report: replace its content from request-enabled form fields.
  3. Preview: check the receipt output.

Configure the receipt content:

  • Add rows and fields under Request and Evidence; configure the header, footer and Requires Signature as needed.
  • Request fields include Request ID, Submitted Date, the configured Case ID field, and eligible case-form fields.
  • Evidence fields include Evidence Name and eligible evidence-intake fields. Include Evidence Type Data includes the matching evidence-type report fields.
  • Auto Generate Report replaces the current content with fields marked In Request Submission in Form Builder. Clear Report removes the fields; both actions require confirmation.
  • Use Preview to check the receipt after changing its layout.

The request field chooser also offers Status Entry Date, Status Type Code and Status Note from the linked case's current status. Adding them lets external users see that status information on generated receipts; only include information suitable for external visibility.

Prompt is not offered in the Lab Submission Receipt builder. Use request/evidence fields and fixed text for receipt content.