Admin Staff Signatures - hmislk/hmis GitHub Wiki

Staff Signatures

Overview

Staff members can have a digital signature image stored in the system. This signature appears on printed documents — typically lab reports, prescriptions, discharge summaries, and official letters — where the clinician's authorisation needs to be represented visually.

When to Use

  • A new doctor joins and their signature needs to be added for report printing
  • A staff member's signature image needs to be updated or replaced
  • An existing signature is incorrect and must be removed

Navigating to Signature Management

  1. Click Administration → Manage Staff
  2. In the left index, click Add Signature for Staff (under the Staff section)
  3. The Add Staff Signature screen opens

To view existing signatures:

  1. Click View Staff Signatures from the same index

Required privilege: AdminStaff

Uploading a New Signature

  1. In the Add New Signature panel (left side):
    • Search for the staff member in the Name autocomplete field
    • Click Choose File and select the signature image (PNG, JPG, or similar format)
  2. Click Save
  3. The current signature for that staff member appears in the Current Signature panel on the right

Replacing a Signature

To replace an existing signature, simply upload a new image for the same staff member. The new image will overwrite the previous one.

Removing a Signature

In the Current Signature panel on the right:

  1. Select the staff member to see their current signature
  2. Click Remove (red button with trash icon)

Signature Format Recommendations

  • Use a white or transparent background image
  • PNG format gives the clearest result for signatures
  • Keep the image to a reasonable size — very large files slow down printing
  • Ensure the signature is legible at the size it will appear on printed documents

How Signatures Appear on Documents

Once uploaded, the signature image is embedded in printed outputs (lab reports, etc.) in the section designated for the clinician's authorisation. The exact placement depends on the report template configuration.

Technical Notes (Admin/Developer)

Signature images are stored and served by StaffImageController. The uploadSignature() method processes the file upload; removeSignature() deletes the stored image. The signature is retrieved in print composites via staffImageController.signatureFromStaffController as a StreamedContent. There is a companion page in admin/institutions/ (admin_staff_signature.xhtml and admin_staff_signature_url.xhtml) for URL-based signature configuration.

Related Features