What is the KMS RIS Agent?

The KMS RIS Agent is an automated system that assists hospitals in managing radiology orders and medical images. It works as a digital assistant that:

• Automatically fetches new radiology orders from your Hospital Information System (IHS)
• Processes medical images placed in a special folder
• Uploads images back to the hospital system for doctors to review
• Handles failures by renaming files with clear error descriptions and retrying automatically

How It Works

1. Order Management

Every minute, the system checks the hospital IHS for new radiology orders, then sends them to the system automatically.

2. Image Processing

When images (JPG, PNG, JPEG) are added to the Watch folder:

• The system detects them immediately
• Compresses the image
• Reads patient info from the filename (accession number)
• Uploads the image automatically into the hospital system

3. Smart Error Handling

• Failed files are renamed with a descriptive error message
• System retries automatically
• Error details are written in the filename for easy troubleshooting

C:\Medical_Images
├── Watch ← Place new images here
├── Processed ← Successfully processed
│   ├── failed_uploads ← Cannot upload
│   └── failed_originals ← Cannot process

Image Naming Requirements

Use only the accession number for the filename:

• 019966250821014.jpg
• ACC123456789.png
• RAD2024001234.jpeg

The accession number must match what exists in the hospital system.

Common Error Examples

Upload Errors

• FAILED_0199_AUTH_FAILED_CHECK_CREDENTIALS_123.jpg → Check login credentials with IT Technician
• FAILED_ACC123_ACCESSION_NOT_FOUND_IN_SYSTEM_123.jpg → Verify accession number
• FAILED_RAD2024_NETWORK_ISSUE_CHECK_CONNECTION_123.jpg → Check internet or check with the IT Technician

Processing Errors

• FAILED_img_INVALID_IMAGE_FORMAT_USE_JPG_PNG.jpg → Please convert to the supported image format
• FAILED_scan_CORRUPTED_IMAGE_FILE.jpg → Rescan/Redownload the image and retry
• FAILED_big_IMAGE_TOO_LARGE_REDUCE_SIZE.jpg → Compress image and retry
• FAILED_wrong_FILENAME_FORMAT_INCORRECT.jpg → Rename using accession number only

Monitoring the System

Health Check

Open a browser and go to:

http://localhost:9090/ris-agent/api/ris/health

• “OK” → System working fine
• Error page → Needs attention

Log Files

Check the /logs folder in the installation directory for details.

Daily Operations

Morning

• Check health status
• Review failed folders
• Fix any issues from filenames

When Adding Images

• Use correct accession number as filename
• Place file in Watch folder
• Wait 30–60 seconds
• If failed, check error message in filename

Handling Failed Files

1. Read the error in the filename
2. Fix the issue (rename file, check network, etc.)
3. Move corrected file to Watch
4. Delete failed file after resolved

Common Issues & Solutions

Troubleshooting Quick Reference

System Performance

• Order Fetching: every 1 min
• Image Processing: within 30 sec
• Failed Image Retry: every 5 min
• Failed Upload Retry: every 10 min

Success Indicators

• Health check returns “OK” consistently
• Images process within 1 minute
• Failed folders remain mostly empty
• Orders reach DICOM system smoothly
• Images are accessible to hospital staff
• Minimal manual intervention required

Remember: The system is designed to work automatically. If you find yourself fixing issues frequently, report it to IT to optimize the setup.