Yoctobe · Documentation
Knowledge base
Search guides and browse topics for Promed HIS, Prolab LIS, middleware and Yoctobe services.
72 articles
Search results
No articles found.
DICOM Integration Flow
4-
Automating DICOM Data Integration with Apache NiFi: An Overview
Efficient management of DICOM (Digital Imaging and Communications in Medicine) data is essential in modern healthcare. However, manually handling large volumes of medical imaging files is time-consuming and prone to errors. Apache NiFi addresses this challenge by providing a robust,…
-
Automating DICOM Data Integration with Apache NiFi: Get Zipped DICOM from an SFTP source
Start by dragging the GetSFTP (or FetchSFTP) processor onto your canvas. This processor securely connects to your SFTP server, enabling NiFi to retrieve ZIP files containing the DICOM images. Double-click on the processor, go to settings tab, and name it…
-
Automating DICOM Data Integration with Apache NiFi: import and deploy NiFi DICOM Processors
In this demo, we are using nifi-dicom processor (download nar extension file from here) adds DICOM features to Apache's NiFi package. The new Processors reside in a nar file and extend NiFi with several new processors. After adding the nar…
-
Automating DICOM Data Integration with Apache NiFi: Processing, Zipping, and Pushing to Third-Party Apps via REST API
In this tutorial, we will use MergeContent to group and compress DICOM files into a ZIP archive, then send the ZIP file to a third-party application using InvokeHTTP. This ensures efficient data transfer and integration with external systems via a…
Medical Instrument Middleware
17-
Troubleshooting Guide: Medical Analyzer Serial Communication in Yoctobe Medical Instrument Middleware
This comprehensive guide addresses common issues when connecting medical analyzers via RS232/serial ports to Yoctobe Medical Instrument Middleware. Follow these detailed steps to diagnose and resolve communication problems with laboratory instruments using ASTM protocol. Problem Description Issue: Failure to receive…
-
Prolab LIS - Middleware Integration API Documentation
Overview This document describes the API integration between Prolab LIS, Middleware, and Laboratory Analyzers. The middleware acts as a bridge, receiving pending test orders from Prolab LIS and forwarding analyzer results back to the system. Integration Flow ┌─────────────┐ ┌──────────────┐ ┌─────────────┐ │ Prolab LIS…
-
Yoctobe Middleware Deployment Guide
Prerequisites Ubuntu 22.04 LTS or later Active internet connection Provided encrypted zip file link and credentials Installation Steps 1. Download and Extract Download the encrypted zip file from the provided link, then extract it to your preferred location. 2. Navigate…
- Yoctobe Middleware Installation Guide
- Analyser Integration Guide - Yoctobe Middleware + Prolab LIS
- ASTM Flow Technical Documentation
- Cobas C311 Interfacing with Yoctobe Middleware
- Cobas E411 Interfacing with Yoctobe Middleware
- Mindray BC-780 Interfacing with Yoctobe Middleware
- Mindray BC-5000 Direct TCP Interfacing with Yoctobe Middleware
- Biomerieux Vitek 2 Compact Interfacing via BCI Link to Yoctobe Middleware
-
Interfacing the Biobase Biochemistry Analyzer with a LIS via HL7 over TCP/IP
1. Overview The Biobase biochemistry analyzer communicates results over a local TCP/IP connection. The middleware listens on a fixed socket, receives a one-shot HL7 v2.3.1 ORU^R01 message encoded in hexadecimal, decodes and parses it, then writes structured result records into…
- Interfacing Beckman DxH 560 ASTM LIS2-A2 Hematology Analyzer
-
Yoctobe Middleware – Deployment Guide for Linux and Windows
Linux Linux deployment is straightforward. Open a terminal, navigate to the deployment folder, and run: ./deploy.sh The script will check whether Docker is installed and offer to install it automatically if you are on Ubuntu. Once it completes, the middleware…
- Interfacing Maglumi 1000 Immunoassay Analyzer
- Interfacing Bioassays 240 PLUS
- Interfacing Beckman Coulter DxI 9000 — Yoctobe Middleware
Prolab LIS Cloud
8-
Extended Result Formats (Microbiology Annexes Case)
Overview This documentation provides step-by-step instructions for configuring microbiology test panels, specifically focusing on urine culture and bacteriological examination (ECBU - Examen Cytobactériologique des Urines). Template Editing Capabilities The system offers widely available and highly flexible template editing capabilities, allowing…
-
Prolab LIS Templates : Invoices
HBS Template Structure <!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8"> <title>Facture</title> <style> /* CSS styles */ </style> </head> <body> {{{invoiceHeader}}} {{{customerInfo}}} <table class="params-table"> <thead> <tr> <th>Column headers</th> </tr> </thead> <tbody> {{{invoiceLines}}} </tbody> {{{invoiceSummary}}} {{{paymentTerms}}} {{{notes}}} {{{termsAndConditions}}} {{{footer}}} </body> </html> JSON…
-
Prolab LIS Templates : Quotes
HBS Template Structure <!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8"> <title>Devis</title> <style> /* CSS styles */ </style> </head> <body> {{{quoteHeader}}} {{{customerInfo}}} <table class="params-table"> <thead> <tr> <th>Column headers</th> </tr> </thead> <tbody> {{{quoteLines}}} </tbody> {{{quoteSummary}}} {{{paymentTerms}}} {{{notes}}} {{{termsAndConditions}}} {{{footer}}} </body> </html> JSON…
-
Prolab LIS Templates : Results
HBS Template Structure <!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8"> <title>Rapport de Résultats</title> <style> /* CSS styles */ </style> </head> <body> <div class="report-container"> {{{reportHeader}}} {{{patientInfo}}} {{{barcode}}} <table> <thead> <tr> <th>Test</th> <th>Résultat</th> <th>Unités</th> <th>Valeurs de Référence</th> <th>Précédent</th> </tr> </thead> <tbody> {{{testResults}}}…
- Prolab LIS — CSV Nomenclature Import/Export
-
Interfacing the Biobase Biochemistry Analyzer with a LIS via HL7 over TCP/IP
1. Overview The Biobase biochemistry analyzer communicates results over a local TCP/IP connection. The middleware listens on a fixed socket, receives a one-shot HL7 v2.3.1 ORU^R01 message encoded in hexadecimal, decodes and parses it, then writes structured result records into…
-
Minimal YoctoERP UI Setup with Prolab LIS / Promed HIS
To avoid the errors you saw, do only these UI/admin steps: 1) Company Go to Accounting > Company > CHU CO and set: Enable Perpetual Inventory = On Stock Adjustment Account = choose one valid expense account (e.g. 6031 -…
- Interfacing Beckman Coulter DxI 9000 — Yoctobe Middleware
Promed MRS
14-
Promed MRS, Getting Started
System Requirements & Browser Compatibility Recommended Browsers Promed MRS works best with modern web browsers. For optimal performance, use: Google Chrome (version 90 or higher) - Recommended Mozilla Firefox (version 88 or higher) Microsoft Edge (version 90 or higher) Safari…
-
Location Management (multi-site scenario)
Overview This guide shows how to set up a typical hospital structure in Promed MRS with multiple sites. Who should read this guide: System Administrators and Configuration Managers Example: District Hospital Network We'll configure a 3-site hospital network with typical…
-
Bed Management
Create Bed Types Path: Bed Management → Bed Types → Add Bed Type The display name must be 10 characters or fewer. Recommended examples: DepartmentBed Type Name (≤10 chars)MaternityMAT_BEDPediatricPED_BEDMale WardMALE_BEDFemale WardFEM_BEDSurgicalSURG_BEDEmergencyEMERG_BEDICU (optional)ICU_BEDGeneralSTD_BED Save after creating each bed type. (Optional) Create Bed Tags…
-
Dispensing Medication and Viewing Laboratory Results in Promed MRS
This section describes how to dispense prescribed medications and view laboratory results for an admitted patient.Example: Thomas Huddersfield, a male inpatient in Male Medical Ward (Bed MM-01). Dispensing Medication Step 1: Open the Dispensing Module Go to Dispensing. Search for Thomas Huddersfield. Step…
-
Managing Appointments in Promed MRS
This section explains how to create, view, and manage patient appointments.Example patient: Thomas Huddersfield 1. Creating a New Appointment Step 1: Open the Appointments Module Navigate to Appointments → Schedule Appointment Step 2: Select Patient Search for Thomas Huddersfield Confirm…
-
Billing Patients in Promed MRS
Example patient: Thomas Huddersfield, admitted to Male Medical Ward (Bed MM-01). 1. Configure Billable Services Step 1: Open the Billable Services Module Navigate to admin > Billable services Add new billable services: FieldExample ValueService NameMedicationShort NameMEDICATIONAssociated ConceptMetforminService TypePharmacyPayment ModeCash / Insurance…
-
Managing Service Queues in Promed MRS
This section explains how to create, monitor, and manage service queues for patients.Example patient: Thomas Huddersfield, currently in Male Medical Ward (Bed MM-01). 1. Understanding Service Queues A queue represents a workflow for a specific service or location (e.g., Male Ward, Lab,…
-
Managing Patient Lists in Promed MRS
This section explains how to use the Patient Lists module to view, filter, and manage groups of patients, and why it is useful.Example patient: Thomas Huddersfield. Purpose of Patient Lists Patient Lists help staff organise and monitor groups of patients efficiently. Key benefits:…
-
Promed MRS Concept Management with Open Concept Lab (OCL)
Overview This document provides technical implementation details for managing medical concepts in Promed MRS using Open Concept Lab (OCL) as the central terminology repository. The integration supports both automated synchronisation via the OCL Subscription Module and manual import via JSON…
-
Stock Management Module Configuration Guide
Location Tags Setup Required Location Tags The stock management module requires three specific location tags: Main Store - Primary storage location Main Pharmacy - Main pharmacy location Dispensary - Dispensing location Step-by-Step Location Tag Creation 1. Create Location Tags Access Admin Interface Go…
-
Promed MRS: Database Backup & Restore Documentation
Overview This document provides comprehensive technical documentation for the Promed HIS database backup and restore system, including remote access procedures and security considerations. Quick Commands Manual Operations # Manual backup (creates compressed .sql.gz file) ./backend/database/backup.sh # Restore from backup ./backend/database/restore.sh…
-
Service Queues - Queue Screen Setup Guide
Step 1: Create Visit Attribute Type for Queue Numbers Log in to PromedMRS as an administrator Navigate to: Administration → Visit Attribute Types Direct URL: https://youdomain.com/openmrs/admin/visits/visitAttributeType.list Click Add Visit Attribute Type (or go directly to the form) Fill in the form: Name*: Queue Number Description: Visit queue number…
-
Promed MRS Provider Account Setup Guide
Critical: Complete This Before Delivering Patient Services Why Provider Accounts Are Essential Before any clinician can deliver patient services in Promed MRS, they MUST have both a User Account and a Provider Account configured. This is not optional—it is a…
-
Decoding Healthcare IT: The Real Difference Between EMR and HIS
Yoctobe · Healthcare SaaS & AI As healthcare organisations accelerate their digital transformation, the technology landscape has become dense with overlapping platforms, acronyms, and…
System Administration
21-
How to Install Docker and Docker Compose on Ubuntu: Complete Guide
Docker has revolutionized how we deploy and manage applications, making it easier than ever to containerize your projects. Whether you're a developer looking to streamline your workflow or a system administrator managing multiple services, Docker and Docker Compose are essential…
-
ScriptCommunicator Installation Guide for Ubuntu Linux
What is ScriptCommunicator? ScriptCommunicator is a powerful serial terminal and communication tool that allows you to interact directly with devices through various interfaces including: Serial ports (RS232, RS485, RS422) TCP/IP connections UDP connections CAN bus Medical Instrument Troubleshooting ScriptCommunicator is…
-
Managing Let's Encrypt SSL Certificates for Nginx Running in Docker (nginx_prod)
This guide covers how to properly manage Let's Encrypt SSL certificates when running Nginx inside Docker containers, addressing common challenges and providing automated solutions. Prerequisites Before starting, ensure you have: Docker and Docker Compose installed A domain pointing to your…
-
AnyDesk Installation Guide for Ubuntu
Step 1: Download and Install AnyDesk Open Firefox and go to: https://anydesk.com/en/downloads/linux Click "Download Now" for Ubuntu Open the downloaded .deb file and click "Install" Step 2: Fix Black Screen Issue Switch from Wayland to X11 (required for screen sharing):…
- Connecting a Medical Instrument with ScriptCommunicator (Linux)
-
Windows to Linux Network TCP Connection Troubleshooting Guide
Problem: Windows Client Cannot Connect to Linux Server on Specific Ports Symptoms Test-NetConnection from Windows fails with connection timeout or refused ping works successfully between Windows and Linux Service appears to be running on Linux server Connection works locally on…
-
USB to RS232 Driver Setup on Linux
Most USB-to-RS232 adapters are automatically recognized by modern Linux distributions. Common chipsets like FTDI FT232, Prolific PL2303, and CH340/CH341 are supported out of the box by the Linux kernel. Steps Connect the AdapterPlug the USB-RS232 adapter into your USB port.…
-
How to Find Promed MRS Module Configuration Options
When customizing Promed MRS 3.x, documentation often lags behind new frontend modules. Developers frequently guess configuration keys or dig through minified JavaScript files. This guide provides a systematic and reliable method to discover configuration options for any Promed MRS 3.x…
-
VPS Security Setup
This documentation provides instructions for securely connecting to and configuring a fresh VPS instance. Following these steps will establish SSH key authentication and implement security best practices. Prerequisites A newly deployed VPS instance Terminal access on your local machine Root…
-
Secure SSH Setup on VPS
Part 1: Initial SSH Connection to Your VPS Step 1: Generate SSH Keys on Your Local Machine If you don't already have SSH keys, open your terminal and run: ssh-keygen -t rsa -b 4096 Press Enter to accept the default…
-
External Storage Mount Guide for XNAT Docker Deployment
Overview This guide provides instructions for mounting external SFTP/SSH-based storage to serve as the archive directory for an XNAT Docker deployment. This approach enables cost-effective long-term storage while maintaining local VPS resources for temporary processing operations. Prerequisites Root/sudo access to…
-
Add a GitLab SSH key on a machine
Step 1: Check for existing SSH keys Check if you already have an SSH key: ls -al ~/.ssh Look for files like id_rsa, id_ed25519, or id_ecdsa. Step 2: Generate a new SSH key (if needed) If you don't have an SSH key, generate…
-
Automated SSL Certificate Renewal for Docker Nginx
Prerequisites Docker and Docker Compose installed Nginx running in Docker container Certbot installed on host Sudo access Step 1: Configure Passwordless Sudo Install certbot sudo apt install certbot Allow certbot to run without password prompts: # Create sudoers entry echo…
-
Cloudflare Origin Certificate Setup Guide
Overview This guide covers setting up Cloudflare Origin Certificates with custom SSL paths for Docker Compose applications. Origin Certificates are free and included in Cloudflare's free tier. Prerequisites Domain managed by Cloudflare (free plan or higher) Docker Compose application with…
-
VPS Swap Configuration
Add persistent swap space to prevent OOM errors on memory-constrained VPS. Quick Setup # Create 4GB swap file sudo fallocate -l 4G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile # Make persistent across reboots echo '/swapfile…
-
Bastion (Jump Host) — short technical guide
Provide secure, auditable access to internal servers by routing admin SSH sessions through a hardened bastion host. Prerequisites SSH keypair present (private key kept secure). Bastion host reachable from your client. Bastion user account with key-based auth and, ideally, multi-factor…
-
SQL Server Connection Diagnostics with sqlcmd
Prerequisites Install sqlcmd (Linux/Ubuntu) # Add Microsoft repository curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add - # For Ubuntu 22.04 curl https://packages.microsoft.com/config/ubuntu/22.04/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list # For Ubuntu 20.04 curl https://packages.microsoft.com/config/ubuntu/20.04/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list # Install sudo apt-get update…
-
Laboratory Analyzer TCP connection to Middleware
Technical Implementation Guide Overview This document describes the successful implementation of direct communication between a laboratory analyzer and custom middleware, bypassing traditional laboratory middleware solutions like REMISOL Advance. Architecture Laboratory Analyzer (Client) ↓ ASTM Protocol over TCP/IP Middleware/Script Communicator (Server)…
-
Cisco AnyConnect Secure Mobility Client
Overview, Download, and Installation Guide for Linux 1. Overview Cisco AnyConnect Secure Mobility Client is an enterprise VPN solution used to provide secure remote access to private networks. It establishes an encrypted connection between a user’s device and an organisation’s…
- Diagnosing and Testing Database Backups
-
PostgreSQL 16 Installation & Configuration Guide
Ubuntu Linux — Open Connection to All Hosts Prerequisites Fresh Ubuntu instance (20.04, 22.04, or 24.04) Sudo privileges Internet access Step 1 — Add the PostgreSQL APT Repository Install dependencies and import the official PostgreSQL signing key: sudo apt install…
Yoctobe Medical ERP
6-
Initial Setup & Workspace Configuration
Step 1: Log In and Access Workspace Open erp.yoctobe.com Log in with a Manager account (required for creating or editing workspaces) From the dashboard, scroll down and find the default workspace named Home Click Edit to modify the workspace Step…
-
Data Setup - Items, Suppliers & Customers
Overview This tutorial covers setting up essential master data for medical device management: Items (medical devices), Suppliers, and Customers. This foundation enables procurement, quality control, and sales operations. Configure Item Groups for Medical Devices Access Item Group Setup From your…
-
Procurement Process - Request for Quotation to Purchase Order
Overview This tutorial demonstrates the complete procurement workflow for medical devices: from identifying stock needs, requesting quotations from suppliers, comparing prices, to creating purchase orders. This workflow ensures proper vendor evaluation and cost control. Step 1: Create Material Request (Stock…
-
Goods Receipt and Quality Inspection Process
Overview This tutorial covers the critical receiving and quality inspection process for medical devices. You'll learn to receive goods against purchase orders, perform mandatory quality inspections, handle compliance documentation, and update inventory. This process ensures regulatory compliance and maintains product…
-
YoctoERP Brand and Logo Setup Guide
This guide will walk you through the process of customising your YoctoERP installation with your organisation's branding, including logos and brand images. Prerequisites Administrative access to your YoctoERP instance Logo images prepared in recommended formats (PNG or SVG) Recommended image…
-
Email Server Setup
Create an Email Account Access Email Account Settings Go to Tools > Email Account Click Add Email Account Configure SMTP Server Email Address: Enter your sending email address (e.g., [email protected]) SMTP Server: Enter your SMTP server address Example: mail.smtp2go.com Other…
Yoctobe Middleware
2-
Host Communication Guides for 500+ Laboratory Analyzers and Diagnostic Devices
Abbott Architect c4000, c8000, i1000SR, i2000SR, i4000SR, i6000, i100SR, ARCHITECT Plus, B12100/B14100 Alinity ci Alinity s Alinity m Alinity i Alinity hq AxSYM AxSYM Plus m2000sp m2000rt IMx Cell-Dyn 1700 Cell-Dyn 1800 Cell-Dyn 2000 Cell-Dyn 3200 Cell-Dyn 3500 Cell-Dyn 3700…
- Interfacing Bioassays 240 PLUS
Support & resources
More help
Help Desk
Log tickets, track incidents and reach our technical support team 24/7.
Open Help DeskFAQs
Answers on SaMD, AIaMD, integration, middleware and working with Yoctobe.
View FAQsArticles
Case studies, regulatory insights and thought leadership from the Yoctobe team.
Read articlesCompliance & Security
Certifications, GDPR, ISO 27001 and healthcare data protection practices.
Learn moreDisaster Recovery
Business continuity, backup replication and recovery SLAs for clinical systems.
DR servicesContact support
Commercial and technical enquiries — Liverpool HQ, support available 24/7.
Contact us







