Practitioner Signatures - hmislk/hmis GitHub Wiki

Practitioner β€” Signatures

A staff signature image (uploaded scan of the handwritten signature) can be attached to any staff record and printed automatically on selected bills, reports, and certificates. This article covers uploading, viewing, and removing signatures.

Navigation

To… Open…
Upload or replace a signature Administration β†’ Manage Staff β†’ Add Signature for staff
Browse all staff with their signatures Administration β†’ Manage Staff β†’ View Staff Signatures

Paths:

  • Upload: /admin/staff/admin_staff_signature.xhtml.
  • View: /admin/staff/admin_staff_view_signature.xhtml.

Privilege required: AdminStaff.

Uploading a new signature

  1. Open Add Signature for staff.
  2. In the left Add New Signature panel:
    1. Type the staff member's name in the autocomplete (it searches by name and pulls from the All Staff list).
    2. Click Choose File and pick the signature image. The recommended format is a transparent-background PNG or a high-contrast JPG with white background and dark ink. Crop tightly around the signature.
    3. Click Save. A confirmation appears.
  3. The right Current Signature panel refreshes and shows the uploaded image at full width.

Practical tips

  • Scan at 300 DPI or higher, then crop to remove white margins.
  • Keep file size below 200 KB if possible; large images slow bill printing.
  • Use the same aspect ratio for all staff so signatures look consistent on printed bills.

Replacing a signature

There is no separate "replace" action. Simply upload a new file for the same staff member. The new image overwrites the old one.

Removing a signature

  1. Open Add Signature for staff.
  2. Select the staff member in the autocomplete on the left panel. The right Current Signature panel shows the existing image.
  3. Click the red Remove button in the Current Signature header.

The image is cleared from the staff record. The staff record itself is not deleted β€” only the signature image is removed.

Viewing all signatures

Open View Staff Signatures. You see a paginated grid (5, 10, or 15 rows per page) with two columns:

Column Content
Name Name with title. Filter and sort by typing in the column header.
Signature Inline preview of the uploaded signature image (50 px tall). Empty for staff with no signature.

Use this screen to do a quick audit β€” for example, to spot staff who still need a signature on file before bills can be printed with their endorsement.

Where the signature is printed

The uploaded signature is referenced via the signatureUrl / image fields on the Staff record. It appears on:

  • Bill footers where the issuing/signing staff member is configured to be shown.
  • Selected report printouts where a signature line is part of the layout.
  • Lab report formats that include a verifying officer signature.

The exact placement depends on the printout layout, which can be customised by the administrator. If a signature does not appear on an expected printout, confirm with the administrator that the layout has been configured to reference the signature image.

Limitations

  • The system stores a single signature per staff member; you cannot keep multiple signatures (e.g., one for English forms and one for Sinhala forms) on one record.
  • There is no audit log of who uploaded or removed a signature; the operation is recorded against the staff record's update timestamp, not a separate signature history table.
  • The Remove button does not ask for confirmation; once clicked, the image is gone. Keep a backup before removing.

Related articles

Back to Practitioner Module Overview