Documentation for Testing Unidirectional Interface with LIS Agent

Documentation for Testing Unidirectional Interface with LIS Agent

Overview

Unidirectional interfacing is commonly used for analyzers that lack the capability to internally scan barcodes and directly communicate with a Laboratory Information System (LIS).
This method allows data to flow in one direction—from the analyzer to the LIS—via a host system and middleware agent.

System Flow Diagram


Steps:

  1. Analyzer: Processes the sample and generates test results.

  2. Middleware: Acts as a listener to collect data from the analyzer.

  3. Host PC: Runs the middleware executable.

  4. LIS Instance / Cloud: Receives and stores test results via SQL push.


How It Works

  • The analyzer is configured to output test results after the sample is processed.

  • The patient ID and test order are pre-entered into the analyzer manually or via barcode (if supported).

  • Once the test is completed, the analyzer sends the data through a communication cable to a middleware installed on the Host PC.

  • The middleware parses the result data and then pushes it into the LIS database using SQL.


Testing Procedure

  1. Prepare the Test Environment

    • Ensure the analyzer is connected to the Host PC via the proper communication cable (RS232, TCP/IP, etc.).

    • Ensure the middleware is also up and running.

    • Confirm that the LIS Agent is installed and running. Make sure that the Machine ID and Test ID has been mapped correctly.

      • How to add Machine in the LIS Agent

        • Open the LIS Agent interface and go to the Machine Master tab

        • Cick Create+ and insert the machine details (LIS Machine ID, LIS Machine Name, and set the LIS Machine is Active to 1)

        • Click Save to save the changes.

      • How to map the Test ID and Machine ID in the LIS Agent

        • Open the LIS Agent Interface and go to the Test Mapping Master tab

        • Click Create+ and insert the mapping details (LIS Machine ID, LIS Machine Name, LIS Machine Test ID, HIS Test ID, and HIS Test Name)

        • Make sure that the mapped details are correct and correlates to the data available in the eHospital (eg. the HIS Test Name and Test ID).

        • ​Click Save to save the changes.

  2. Run Sample Test

    • Create new patient order on the eHospital:

      • Go to the diagnostic support examination, choose the examination item, and click Add Item

      • Scroll down to the Sample Collection Information section, then input all required details, make sure that the Machine model is correct. You can input the Sample Number manually or you can left it blank as it will be automatically generated later. Click Next to continue.

      • Go back to the examination page, and choose/input the correct Sample Number in the Examination Results section. The lab order now has been sent to the LIS Agent.

  3. Verify on LIS

    • Check if the test result appears correctly in the LIS interface.

    • Verify if the test results were sent properly to the eHospital

    • Validate test code mapping and data consistency.

Notes

IMPORTANT NOTES:
The conditions that the lab order will be sent to the LIS Agent are as follows:

  1. The correct machine type has been chosen in the Sample Collection Information section
  2. The correct sample number has been inputted in the Examination Results section
  3. The status of the examination item is Ordered
If the patient order is not received by the LIS Agent, please recheck whether all the conditions has been fulfilled.

For more detailed explanation, please watch this explanation video below:



    • Related Articles

    • How to Setup and Configure LIS Agent

      Overview Integration with medical laboratory equipment into an Electronic Medical Record (EMR) system is crucial for seamless data exchange, reducing manual input errors, and improving workflow efficiency in healthcare facilities. To address this ...

    • Changelog Ksatria eHospital v2509092 (09-09-2025)

      Changelog Ksatria eHospital v2509092 (09-09-2025) New Features and Enhancements: > Enhancement to add a new column in the registration database > To add validation in patient provider > New features to Show Notification for SOAP AI Generation ...

    • Changelog Ksatria eHospital v2508271 (27-08-2025)

      New Features and Enhancements: Added capability to update expiry date automatically Added new User interface for Unit of Measurements (UOM) settings in the configuration: To export and import UOM configuration data To Create and edit UOM ...

    • Introduction to SOAP Note Creation Feature using Artificial Intelligence (AI)

      In the rapidly evolving medical world, Artificial Intelligence (AI) technology is now available to assist healthcare professionals in recording medical notes more efficiently. Ksatria Medical System (KMS) provides a SOAP Note Creation feature powered ...

    • Informasi Technology Stack dan Spesifikasi Server On-Premise

      Artikel ini menjelaskan mengenai technology stack yang digunakan dalam pengembangan Ksatria eHospital serta spesifikasi server standar untuk instalasi on-premises dan server untuk training/testing. 1. Technology Stack / Framework Frontend / Antarmuka ...