Overview
The idgen module provides a facility for managing identifier generation and allocation within an OpenMRS implementation. Below is an overview of the primary components and how they are meant to be used.
...
Kept deliberately separate from the notion of Identifier Sources is the ability to enable auto-generation and allocation of a Patient Identifier from a particular source. This can be managed by going to the "Auto-Generation Options" screen. On this page you will see one row per Patient Identifier Type in the system. If one or more Identifier Sources is configured for an Identifier Type, then a hyperlink will be available you can add a Auto Generation Option for that Identifier Source. For each Identifier Source, you are able to configure the following options:
- Source to Auto-generate From: Choose from each Identifier Source configured for this type
- Location (optional): Add this if you want to limit a source to patient identifiers assigned for a specific location (this option is not compatible with the IDGen integration with the OpenMRS 1.0 patient dasboard, but does work with the Paper Record module)
- Automatic Generation Enabled?: Set to true if you want to allow users to auto-generate identifiers of this type for patients
- Manual Entry Enabled?: Set to true if you want to allow users to manually enter identifiers of this type for patients
...
There is a new module underway called idgenws. This module exposes a rest url on the server running idgen that allows for remote sites to ping the server to get a new identifier. This is a WIP, please see TRUNK-345
Download
Release Notes
Version 2.2 and above
...
Problem: An error occurs when submitting the "Create Patient" form and a blank page is displayed. (OpenMRS 1.6.x, tribe-module not installed)
| No Format |
|---|
ERROR - errorhandler_jsp._jspService(72) |2010-10-22 10:52:21,853| Error on page /openmrs/WEB-INF/view/module/idgen/editPatientForm.jsp
org.springframework.beans.NotReadablePropertyException: Invalid property 'tribe' of bean class org.openmrs.web.controller.patient.ShortPatientModel: Bean property 'tribe' is not readable or has an invalid getter method: Does the return type of the getter match the parameter type of the setter?
at org.springframework.beans.BeanWrapperImpl.getPropertyValue(BeanWrapperImpl.java:540)
|
...
Make sure the global properties value of use_patient_attribute.tribe is set to false.
Problem:
You've created an identifier type and an identifier source. You create or edit the patient and attempt to add a new identifier. The new identifier type appears in the dropdown list, but there's no checkbox to auto-generate it.
Solution:
Confirm that you enabled auto-generation. See the "Auto Generation Configuration" section of this page.
The long edit patient form doesn't currently have a checkbox. Use the short patient edit form to add the new identifier.
Problem:
You've created an identifier type and enabled automatic generation. When you add the new identifier to a patient, the "generate" checkbox appears but nothing happens when you click it. The Identifier field remains blank. When you save, there's an error message that patients must have at least one identifier.
...
If you get an error or a blank page, IDGen is unable to generate an ID. Look at the Tomcat logs for clues, and consult the Implementers mailing list for further help.