Moved

This is now part of esm-patient-management.

The old documentation follows.

---

Patient Registration ESM

The Patient Registration MF module for OpenMRS Version 3.0 Frontend. The Patient Registration facilitates the registration of a new patient.

Overview

The Patient Registration module consists of a configurable form consisting of multiple custom/basic inputs (fields).

Built With

• React (TypeScript) - Front-end JS library
• Formik - Form builder JS library
• Day.js - Date library
• Jest - JS testing framework
• React Testing Library - JS testing library for React components
• npm - Node package manager
• webpack - JS module bundler
• ESLint - JS linter
• Prettier - Code formatter
• Babel - JS compiler

Installation

Prerequisites

• Node
• Git
• openmrs-esm-patient-registration

Setup Patient Registration Module

1. Clone the openmrs-esm-patient-registration repo.

git clone https://github.com/openmrs/openmrs-esm-patient-registration.git

2. Install dependencies in the root directory of the repo.

npm i

3. Run the module from localhost:8080.

npm run serve -- --https

Setup Dev Tools

1. Click Add new module in the dev tools window.
2. Type in the Module Name: @openmrs/esm-patient-registration-app.
3. Type in the Override URL: 8080.
4. Go to the browser's development tools (e.g. via Inspect).
5. Go to the Application tab.
6. Go to Local Storage.
7. Find the key: import-map-override:@openmrs/esm-patient-registration-app
8. Update the corresponding value to: //localhost:8080/openmrs-esm-patient-registration.js.
9. Click on the padlock/warning message next to the URL in the browser.
10. Select the Allow option from the Insecure content dropdown in the browser settings page.
11. Refresh the page.

Tests

To verify that all of the tests run:

npm test

Note: Run npm i before running tests for the first time.

Deployment

The master branch of this repo is deployed in a demo environment.

Configuration

This module is designed to be driven by configuration files. These files define the look and functionality required to drive the Patient Registration module.

Resources

• JIRA Epic

License

The project is licensed under the MIT License - see the LICENSE.md file for details.