HowTo Guides

Content

• Archive Features
  • Attribute Coercions
  • General Features
  • Lifecycle Management
  • Export Triggered Features
  • HL7 Related Features
    • General HL7 Specific Features
    • HL7 Patient Administration Management
    • HL7 Order Management
    • HL7 Observation Reporting
  • RESTful Services Specific Features
  • Scheduler Triggered Features
  • Unified Procedure Step (UPS) Processing Specific Features
• Audit Records
• Secured Archive
• Tests
• Troubleshooting
• Miscellaneous

Archive Features

General Features

• Access control based on Archive AEs
• Attribute Coercions
• Comparing Archives
• Compression of received images
• Export previous entity of replaced instances
• External DICOM Archive for long term storage
• Forwarding of MPPS N‒CREATE and N‒SET messages
• Instance Availability Notification
• Invoke Image Display
• Metrics
• Multiple Archives with Direct Attached Storage sharing one DB
• Patient Information in System and Audit log
• Proxy retrieve requests to another Archive
• Proxy query requests to another Archive
• Reject Instances of Study
• Restrict C-MOVE destinations
• Restrict AE Titles opening associations with Archive
• Restrict retrieve silently
• Storage Commitment
• Validate hostname or IP address of association requester
• Validate objects on storage

Lifecycle Management

• Expire Studies
• Freeze Expiration Date Individual Studies
• Move Expired Studies before Rejection
• Protect Individual Studies from getting Expired
• Reject Expired Studies

Export Triggered Features

• Export Triggered IAN
• Export Triggered Storage Commitment
• Export Triggered Deletion of Objects from Storage
• Export Triggered Rejection of objects with Data Retention Expired

HL7 Related Features

General HL7 Specific Features

• Export Studies on receive of HL7 messages
• Forward received HL7 messages
• HL7 Receivers feeding MWL SCPs
• HL7 Triggered Expire Studies
• Log received HL7 messages
• Notify external HL7 receivers on Procedure Status Updates
• Prefetch Studies on receive of HL7 messages
• Suppress Patient Creation by HL7 Messages
• Synchronize external HL7 receivers on Patient Information Updates

HL7 Patient Administration Management

• Accessing external archive PAM Services
• Ignore HL7 messages referring already merged Patient

HL7 Order Management

• Conditional extraction of Scheduled Protocol Code
• Extract Scheduled Procedure Step Status
• Extract Scheduled station details
• Update MWL status to COMPLETED for received studies

HL7 Observation Reporting

• Import Report as DICOM

RESTful Services Specific Features

Note : Any external clients which want to access secured RESTful Services of archive, shall always pass an access token retrieved from Keycloak in HTTP Authorization header as Bearer {Token}. See Get OIDC Access Token using curl

• Accessing External Archive
• Activate GZip Compression for QIDO and WADO Metadata responses in Wildfly
• Forward RESTful services to other archive
• Imaging Object Change Management
• Import Instances on Storage
• Link Instances to MWL
• Prefetch QIDO responses
• Pre fetch of WADO objects
• Redirect WADO URI Requests
• Rescheduling Tasks within Cluster
• Store objects by STOW-RS
• STOW RS Upload Performance Measurements
• UI Triggered DICOM Export

One can also refer to the complete list of RESTful services supported by the archive

Scheduler Triggered Features

• Compression of images
• Deletion of least recently accessed studies
• Deletion of Rejected Instances
• Export prior Studies on receive of DICOM composite objects
• Export Studies on receive of HL7 messages
• Forwarding of received instances
• Patient Verification against external Patient Demographics Provider
• Prefetch Studies on receive of HL7 messages
• Purge instance records from DB
• Purge Queue Messages
• Reject Expired Studies
• Storage Verification
• Study Size Query Attributes Calculation

Unified Procedure Step (UPS) Processing Specific Features

• Create UPS for Failed UPS Processing
• Replace Queuing of Export Tasks using UWL
• Replace Queuing of Retrieve Tasks using UWL
• Reschedule UPS record
• Double Reading UPS
• UPS Template Workitem

Audit Records

• Emission of Audit Messages
  • Supported Audit Messages and Events
  • Supported Audit Trail Profiles
  • View Audit Messages in Kibana
    • Secure Kibana using OAuth2 Proxy
• Unknown Patient IDs and Study Instance UIDs in Audit messages
• Suppress Audit Messages

Secured Archive

• Keycloak Realm Management
• Secure Archive UI and RESTful Services using Keycloak
• Upgrade Secured
• Enable SSL HTTPS for the Keycloak Server
• Forward Authorization Requests
• Get OIDC Access Token using curl

Tests

• Archive UI Testplan
• Cache Storage over Several Filesystems
• Nearline Storage Testplan
• Rejection IAN
• Retrieve Cache for Nearline Storage
• Run MESA Image Manager Tests
• Run MESA Report Repository Tests
• Storage Verification
• Test IHE SWF using dcm4che-tools
• Tests with Genozip files using Dcm4che toolkit
• TLS Handshake Tests

Troubleshooting

• Monitor Archive on remote host or docker container by VisualVM

Miscellaneous

• Customize Keycloak Login Page
• Cluster Keycloak with MariaDB and LDAP using Docker Standalone
• Compare Studies in Archive with CSV Entries
• Master-to-Master Replication between two MariaDB Servers
• Predict size of database growth
• Running ApacheDS on Docker
• Update Vendor Data
• Use Custom Keystore with Archive