Servlet: /daris/dicom.mfjp

Owned by Andy Tseng
Mar 21, 2024
2 min read

  • Path: /daris/dicom.mfjp

The servlet can

  • be used to extract and download a individual file from a dicom series (archive);
  • be used to view dicom series using Papaya viewer;
  • be used to get the dicom file header (metadata);
  • be used to download a dicom file as web browser supported PNG format;

1. Generic Arguments

  • Argument _skey: The session key if known. If this argument and the _token argument are not given or invalid. It will redirect to the login page(/daris/main.mfjp?module=logon)
  • Argument _token: The secure identity token if known. If this argument and the _skey argument are not given or invalid. It will redirect to the login page(/daris/main.mfjp?module=logon)
  • Argument module: It is the action to execute. There are there moudles can be chosen from: “file”, “view”, “metadata” and “image”.
  • Argument id: the asset id of the dicom series/dataset. Must be specified if cid argument is not specified.
  • Arguement cid: the asset cid of the dicom series/dataset. Must be specified if id argument is not specified.

2. Module: file

  • Extract and download the dicom file at the specified index from the dicom seires.
  • Example path: /daris.mfjp?module=file&cid=1.5.1.1.1.1.1&idx=1

2.1. Arguments for “file” module

  • Argument idx: the index of the dicom file in the series. Starts from 1. Defaults to 1.
  • Argument filename: the name for the downloaded file. If not given, defaults to ${idx}.dcm

2.2. Examples

  • Get the first dicom file in the series:

    https://daris.yourdomain.org:port/daris/dicom.mfjp?module=file&cid=1.5.1.1.1.1.1&idx=1&filename=1.5.1.1.1.1.1_1.dcm

3. Module: image

  • Get the dicom file at the specified index from the dicom seires as PNG format.
  • Example path: /daris.mfjp?module=image&cid=1.5.1.1.1.1.1&idx=1&frame=1

3.1. Arguments for “image” module

  • Argument idx: the index of the dicom file in the series. Starts from 1. Defaults to 1.
  • Argument frame: the frame index of the dicom image is a multi-frame dicom image. Defaults to 1.
  • Argument filename: the name for the png file. If not given, defaults to ${idx}.png

3.2. Examples

  • Get the first dicom slice as png file:

    https://daris.yourdomain.org:port/daris/dicom.mfjp?module=image&cid=1.5.1.1.1.1.1&idx=1&frame=1

4. Module: view

  • View the whole dicom series in Papaya viewer.

4.1. Arguments for “view” module

  • NONE

4.2. Examples

  • Abort shopping cart 16:

    https://daris.yourdomain.org:port/daris/dicom.mfjp?module=view&cid=1.5.1.1.1.1.1

5. Module: metadata

  • Gets the dicom header of the specified dicom file in the series.
  • Argument filename: the name for the downloaded dicom header(XML) file.

5.1. Arguments for “metadata” module

  • Argument idx*: the index of the dicom file in the series. Starts from 1. Defaults to 1.

5.2. Examples

  • Get dicom header as xml

    https://daris.yourdomain.org:port/daris/dicom.mfjp?module=metadata&cid=1.5.1.1.1.1.1&idx=1&filename=1.5.1.1.1.1.1_1-dicom-header.xml
  • For more details about the arguments of dicom.mfjp servlet, run following command in Aterm:
    • http.servlet.describe :url /daris
  • See other servlets