### Liquibase Directory Structure Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/liquibase.md
Illustrates a typical directory structure for Liquibase changelog files.
```bash
liquibase/
└── liquibase.xml
└── concepts.xml
└── encounterTypes.sql
```
--------------------------------
### Queues CSV File Structure Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/queues.md
This example shows the directory structure for queue CSV import files. Ensure the 'queues.csv' file is present in the 'queues' directory.
```bash
queues/
├──queues.csv
└── ...
```
--------------------------------
### Directory Structure Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/datafiltermappings.md
Illustrates the expected directory structure for the datafiltermappings configuration files.
```bash
datafiltermappings/
└── mappings.csv
```
--------------------------------
### Example idgen Directory Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/idgen.md
Illustrates a typical directory structure for idgen configuration files.
```bash
idgen/
└── idgen.csv
```
--------------------------------
### Build and Install OpenMRS Module Initializer
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/README.md
Instructions to clone the repository, build the master branch using Maven, and install the resulting OMOD file to your OpenMRS instance.
```bash
git clone https://github.com/mekomsolutions/openmrs-module-initializer/tree/master
cd openmrs-module-initializer
mvn clean package
```
--------------------------------
### Global Properties XML Configuration Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/globalproperties.md
Provides an example of an XML file used to define global properties. Use this to set specific OpenMRS global properties.
```xml
addresshierarchy.i18nSupport
true
locale.allowed.list
en, km_KH
```
--------------------------------
### Basic Configuration and Checksum File Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/checksums.md
Shows a simple configuration file and its corresponding checksum file within the directory structure.
```bash
├── configuration
│ └── concepts
│ └── diagnoses.csv
└── configuration_checksums
└── concepts
└── diagnoses.checksum
```
--------------------------------
### Program CSV Row Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/prog.md
Example of a single row in the program CSV import file. This illustrates the required fields and their expected format for defining a program.
```csv
Uuid | Void/Retire | Name | Description | Program concept | Outcomes concept | _order:1000
eae98b4c-e195-403b-b34a-82d94103b2c0 | | TB Program | Program for tracking TB patients | Tuberculosis Treatment Program | TB Program Outcomes |
```
--------------------------------
### JSON Key-Value Configuration File Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/jsonkeyvalues.md
This JSON file defines key-value pairs for runtime configurations, such as concept UUIDs and names.
```json
{
"main.report.diagnose.concept.uuid": "4421da0d-42d0-410d-8ffd-47ec6f155d8f",
"main.report.chiefcomplaint.concept.fsn": "CHIEF COMPLAINT",
"main.report.finding.concept.mapping": "Cambodia:123",
"main.report.fathername.pat.uuid": "9eca4f4e-707f-4bb8-8289-2f9b6e93803c",
"main.report.mothername.pat.name": "Mother name",
"main.report.active": "true"
}
```
--------------------------------
### Relationship Types Directory Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/relationshiptypes.md
Example of the directory structure for relationship type configuration files.
```bash
relationshiptypes/
└── relationshiptypes.csv
```
--------------------------------
### Metadata Header Examples
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/csv_conventions.md
Provides examples of special metadata headers used to provide information about the CSV file itself. These headers start with an underscore.
```text
_version:1
_order:1000
```
--------------------------------
### HTML Form XML Definition Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/htmlforms.md
An example of an HTML Form XML definition file, showcasing various configuration attributes.
```xml
Date:
Location:
Provider:
Weight:
```
--------------------------------
### Concept CSV Header Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/concepts.md
Example of a header line in a concepts CSV file, showing metadata fields.
```markdown
| Uuid | Void/Retire | Fully specified name:en | Short name:en | Description:en | ... | _version:1 | _order:1000 |
| - | - | - | - | - | - | - | - |
```
--------------------------------
### Program Workflow States CSV Row Examples
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/prog.md
Examples of rows in the program workflow states CSV import file. These illustrate how to define initial and terminal states for a workflow.
```csv
Uuid | Void/Retire | Workflow | State concept | Initial | Terminal | _order:1000
cfa241f4-2700-102b-80cb-0017a47871b2 | | TB Treatment Status (workflow) | Active treatment (initial) | true | |
```
```csv
Uuid | Void/Retire | Workflow | State concept | Initial | Terminal | _order:1000
88b717c0-f580-497a-8d2b-026b60dd6bfd | | TB Treatment Status (workflow) | Transferred out | | true |
```
--------------------------------
### Concept Name UUID Specification Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/concepts.md
Example showing how to assign a specific UUID to a concept name using a 'Uuid' column.
```markdown
| Synonym 1:en | Synonym 1:en:Uuid |
|--------------|------------------------|
| Diabetes | d4bce1d7-1a1b-4108-b87f-e630e43c7374 |
```
--------------------------------
### Autogeneration Options CSV Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/autogenerationoptions.md
This example shows the directory structure for autogeneration options CSV files and a sample CSV content with its headers.
```bash
autogenerationoptions/
└── autogenerationoptions.csv
```
```csv
Uuid,Identifier Type,Location,Identifier Source,Manual Entry Enabled,Auto Generation Enabled,_order:2000
eade77b6-3365-47ed-9ee3-2324598629eb,Legacy ID,,9eca4f4e-707f-4lb8-8289-2f9b6e93803f,true,false,
```
--------------------------------
### Program Workflow CSV Row Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/prog.md
Example of a single row in the program workflow CSV import file. This demonstrates how to link workflows to specific programs and concepts.
```csv
Uuid | Void/Retire | Program | Workflow concept | _order:1000
2b98bc76-245c-11e1-9cf0-00248140a5eb | | TB Program | TB Treatment Status (workflow) |
```
--------------------------------
### Drug CSV Header Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/drugs.md
An example of a header line for the drugs.csv file, including standard and version-specific fields.
```markdown
| Uuid | Void/Retire | Name | Description | Concept Drug | ... | _version:1 | _order:1000 |
| - | - | - | - | - | - | - | - |
```
--------------------------------
### Visit Types CSV Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/visittypes.md
This example shows the directory structure for visit type CSV imports and a sample data row with headers.
```bash
visittypes/
├──visittypes.csv
└── ...
```
```text
Uuid | Void/Retire | Name | Description | _order:1000
32176576-1652-4835-8736-826eb0237482| | General | A General Visit |
```
--------------------------------
### Program CSV File Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/prog.md
Example of the directory structure and content for program CSV import files. Use this to understand the expected file organization.
```bash
programs/
├── opd_programs.csv
└── ...
```
--------------------------------
### Locale Preferred Concept Name Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/concepts.md
Example demonstrating how to mark a specific concept name as locale preferred using a 'Preferred' column.
```markdown
| Synonym 1:en | Synonym 1:en:Preferred |
|--------------|------------------------|
| Diabetes | TRUE |
```
--------------------------------
### Attribute Header Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/loc.md
This example demonstrates how to set attribute values for a location using headers prefixed with 'Attribute|'. The value '2017-05-15' is shown for the 'Last Audit Date' attribute.
```markdown
| Attribute|Last Audit Date |
|----------------------------|
| 2017-05-15 |
```
--------------------------------
### Concept Sources CSV Configuration Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/conceptsources.md
Provides a sample CSV structure for configuring concept sources, including headers for UUID, Void/Retire, Name, Description, HL7 Code, and Unique ID. Both 'name' and 'description' are mandatory and not localized.
```csv
Uuid | Void/Retire | Name | Description | HL7 Code | Unique ID
| true | Ministry Code | A source to be retired | |
| | New concept source with random UUID | Has some description too | |
| | SNOMED CT | SNOMED Preferred mapping | SCT |
| | RadLex | Radiology Terms | RADLEX | 2.16.840.1.113883.6.256
```
--------------------------------
### Concept Classes CSV Configuration Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/conceptclasses.md
Provides a sample CSV structure for configuring concept classes, including options for specifying UUID, voiding/retiring, naming, and describing classes.
```csv
"Uuid"|"Void/Retire"|"Name"|"Description"
|true|"Procedure"|""
|""|"New concept class with random UUID"|"Has some description too"
"1dd85dab-f6d6-4bec-bde6-c4cddea92d35"|""|"A concept class with UUID specified"|""
```
--------------------------------
### Cash Points CSV Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/cashpoints.md
Example directory structure for cash points CSV import files. Ensure the 'cashPoints.csv' file is present.
```bash
cashpoints/
├──cashPoints.csv
└── ...
```
--------------------------------
### Concept Reference Range Directory Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/conceptreferencerange.md
Example directory structure for organizing concept reference range CSV configuration files.
```bash
conceptreferencerange/
└── conceptreferencerange.csv
```
--------------------------------
### Example MDS Package Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/mds.md
Illustrates the typical file structure within a metadatasharing folder, containing .zip files for different metadata types. These packages are imported using the 'prefer theirs' rule.
```bash
metadatasharing/
├── PatientIdentifierType.zip
├── PersonAttributeType.zip
└── ...
```
--------------------------------
### Program Workflow CSV File Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/prog.md
Example of the directory structure and content for program workflow CSV import files. This shows how to organize workflows for bulk import.
```bash
programworkflows/
├── opd_program_workflows.csv
└── ...
```
--------------------------------
### Liquibase XML Changelog Configuration
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/liquibase.md
An example of a Liquibase XML changelog file, demonstrating how to include other changelogs and define database updates.
```xml
Set encounter type 'Admission' UUID
name='Admission'
```
--------------------------------
### Concepts CSV Directory Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/concepts.md
Example structure of CSV files within the concepts subfolder for bulk concept import.
```bash
concepts/
├── diagnoses.csv
├── findings.csv
├── misc.csv
└── ...
```
--------------------------------
### Encounter Roles CSV Configuration Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/encounterroles.md
This table illustrates the format and fields for configuring encounter roles via a CSV file. It supports creating new roles or modifying existing ones.
```csv
Uuid,Void/Retire,Name,Description
,true,Surgeon,
, ,New encounter role with random UUID,Has some description too
1dd85dab-f6d6-4bec-bde6-c4cddea92d35,,A encounter role with UUID specified,
```
--------------------------------
### Message Properties File Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/messageproperties.md
Example structure of message properties files for i18n support. Files are placed in the 'messageproperties' subfolder.
```bash
messageproperties/
├── metadata_en.properties
├── metadata_km_KH.properties
└── ...
```
--------------------------------
### Basic Drug CSV Line Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/drugs.md
A sample CSV line demonstrating how to define a drug with its concept, dosage form, and strength.
```markdown
| Uuid | Name | Concept Drug | Concept Dosage Form | Strength |
| - | - | - | - | - |
| | Cetirizine 10mg Tablet | Cetirizine | Tablet | 10mg |
```
--------------------------------
### Program Workflow States CSV File Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/prog.md
Example of the directory structure and content for program workflow states CSV import files. Use this to understand the file organization for states.
```bash
programworkflows/
├── opd_program_workflow_states.csv
└── ...
```
--------------------------------
### Relationship Type CSV Configuration Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/relationshiptypes.md
Sample CSV content for defining a relationship type, including UUID, name, description, and relationship directions.
```csv
Uuid,Void/Retire,Name,Description,A is to B,B is to A,Weight,Preferred,_order:2000
c86d9979-b8ac-4d8c-85cf-cc04e7f16315,,Grandparent/Grandchild,The child of one's child, or parent of one's parent,Grandparent,Grandchild,3,true,
```
--------------------------------
### Localized Display Headers Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/csv_conventions.md
Demonstrates how to use localized display headers for OpenMRS metadata entities. Append the locale ISO code to 'Display' to specify the language for the metadata's display string.
```text
| UUID | ... | Display:en | Display:fr | ... | Void/Retired | ...|
| --- | --- | --- | --- | --- | --- | --- |
| eb96c0d4-6248-476b-a079-0aaabfa2f614 | ... | Emergency Room | Salle d'urgences | ... | false | ... |
```
--------------------------------
### Attribute Types CSV Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/atttypes.md
This is an example of the directory structure and the main CSV file for importing attribute types. Ensure your CSV file adheres to this structure for bulk import.
```bash
attributetypes/
├── attributetypes.csv
└── ...
```
--------------------------------
### Location CSV Header Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/loc.md
This table displays the possible headers and a sample data set for a single location CSV line. It illustrates various fields including UUID, void/retire status, name, description, parent, tags, and attributes.
```markdown
| Uuid | Void/Retire | Name | Description | Parent | Tag|Login Location | Tag|Facility Location | Attribute|9eca4f4e-707f-4bb8-8289-2f9b6e93803c | Attribute|Last Audit Date | Address 1 | Address 2 | Address 3 | Address 4 | Address 5 | Address 6 | City/Village | County/District | State/Province | Postal Code | Country | Tags |
|--------------------------------------|-------------|--------------------------|-------------|--------------------------|---------------------|------------------------|-------------------------------------------------|----------------------------|-----------------|-----------|-----------|-----------|-----------|-----------|--------------|-----------------|----------------|-------------|----------|-----------------------------------|
| a03e395c-b881-49b7-b6fc-983f6bddc7fc | | The Lake Clinic-Cambodia | | | TRUE | TRUE | HQ Facility | 2017-05-15 | Paradise Street | | | | | | | Siem Reap | Siem Reap | | Cambodia | Login Location; Facility Location |
| | | OPD Room | | The Lake Clinic-Cambodia | | TRUE | | | | | | | | | | | | | | Consultation Location |
```
--------------------------------
### Address Configuration XML Example (Haiti)
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/addresshierarchy.md
This XML file defines the address template and maps hierarchy levels to address fields. Ensure the 'addressHierarchyFile' section correctly points to your CSV file.
```xml
true
COUNTRY
...
STATE_PROVINCE
...
CITY_VILLAGE
...
ADDRESS_2
...
addresshierarchy.csv
,
...
```
--------------------------------
### Privilege CSV Header and Sample Data
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/priv.md
This table outlines the possible headers for the privilege CSV file and provides a sample data set. Note that headers starting with an underscore are metadata and not processed.
```markdown
|Uuid |Privilege name | Description | _order:1000 |
| - | - | - | - |
|| Read Attachments | Has read access to attachments. ||
| 9d4cbaeb-9c87-442f-bfdd-0d17402f319f | Create Attachments | Has write access to attachments. ||
```
--------------------------------
### Configuration File Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/checksums.md
Illustrates the directory structure for configuration files and the corresponding checksum files.
```bash
configuration_checksums/
├── addresshierarchy/
├── appointmentsspecialities/
├── appointmentsservicesdefinitions/
├── ...
```
```bash
configuration_checksums/
├── concepts
├── diagnoses_ncd_diagnoses.checksum
├── diagnoses_oncology_diagnoses.checksum
├── drugs_conceptdrugs.checksum
└── program_concepts.checksum
```
--------------------------------
### Display CLI Arguments Help
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/validator.md
Run the Initializer Validator fatjar without arguments or with the --help flag to display a list of all available command-line options and their usage.
```bash
java -jar validator/target/initializer-validator-2.13.0-SNAPSHOT.jar
```
--------------------------------
### Global Properties Directory Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/globalproperties.md
Illustrates the expected directory structure for global properties configuration files.
```bash
globalproperties/
├── gp_core.xml
├── gp_coreapps.xml
└── ...
```
--------------------------------
### FHIR Concept Source CSV Example Row
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/fhir.md
An example row for the conceptsources.csv file, showing a mapping for the CIEL concept source with its corresponding FHIR URL.
```csv
Uuid,Void/Retire,Concept source,Url,_order:1000
befca738-1704-4a47-9f6a-0fcacf786061,,CIEL,https://api.openconceptlab.org/orgs/CIEL/sources/CIEL,
```
--------------------------------
### AMPath Forms Translations JSON Schema Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/ampathformstranslations.md
Provides an example of a JSON file defining translations for a form, including localized names and specific term translations.
```json
{
"uuid": "c5bf3efe-3798-4052-8dcb-09aacfcbabdc",
"form": "Form 1",
"form_name_translation": "Formulaire 1",
"description": "French Translations for Form 1",
"language": "fr",
"translations": {
"Encounter": "Rencontre",
"Other": "Autre",
"Child": "Enfant"
}
}
```
--------------------------------
### Nested Configuration and Checksum File Naming
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/checksums.md
Demonstrates how nested configuration files are represented by checksum files with a naming convention that includes the path.
```bash
├── configuration
│ └── concepts
│ ├── diagnoses
│ │ ├── ncd_diagnoses.csv
│ │ └── oncology_diagnoses.csv
│ ├── drugs
│ │ └── conceptdrugs.csv
│ └── program_concepts.csv
└── configuration_checksums
└── concepts
├── diagnoses_ncd_diagnoses.checksum
├── diagnoses_oncology_diagnoses.checksum
├── drugs_conceptdrugs.checksum
└── program_concepts.checksum
```
--------------------------------
### FHIR Patient Identifier System CSV Example Row
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/fhir.md
An example row for the identifiersystems.csv file, showing a mapping for the OpenMRS ID patient identifier type with its corresponding FHIR URL.
```csv
Uuid,Void/Retire,Patient identifier type,Url,_order:1000
87c87473-b394-430b-93d3-b46d0faca26e,,OpenMRS ID,http://openmrs.org/identifier,
```
--------------------------------
### Patient Flags CSV Header Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/flags.md
Illustrates the headers and a sample data row for the patient flags CSV import file. This example shows how to define a flag for HIV Positive patients.
```csv
Uuid,name,criteria,evaluator,message,priority,enabled,tags,description
526bf278-ba81-4436-b867-c2f6641d060a,HIV Positive,SELECT patient_id FROM patient WHERE ...,org.openmrs.module.patientflags.evaluator.SqlFlagEvaluator,patientflags.message.hivPositive,High Priority,true,HIV;Clinical,Flag for HIV positive patients
```
--------------------------------
### AMPATH Form JSON Schema Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/ampathforms.md
Provides an example of a JSON schema for an AMPATH Form, including its name, description, version, encounter type, and page/section/question structure. Ensure the 'encounter' field is specified for encounter-based forms.
```json
{
"name": "Test Form 1",
"description": "Test 1 Description",
"version": "1",
"published": true,
"retired": false,
"encounter": "Emergency",
"pages": [
{
"label": "Page 1",
"sections": [
{
"label": "Section 1",
"isExpanded": "true",
"questions": [
{
"label": "Height",
"type": "obs",
"questionOptions": {
"rendering": "number",
"concept": "5090AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"max": "",
"min": "",
"showDate": "",
"conceptMappings": [
{
"type": "CIEL",
"value": "5090"
},
{
"type": "AMPATH",
"value": "5090"
},
{
"type": "PIH",
"value": "5090"
}
]
},
"id": "Ht"
}
]
}
]
}
],
"processor": "EncounterFormProcessor",
"referencedForms": []
}
```
--------------------------------
### Queues CSV Header and Sample Data
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/queues.md
This table illustrates the expected headers and a sample data row for the queues.csv import file. Note the mandatory 'Name' header and optional fields like 'Description' and 'Location'.
```markdown
| Uuid | Void/Retire | Name | Description | Service | Status Concept Set | Priority Concept Set | Location |
|--------------------------------------|-------------|-----------------------------|---------------|--------------------|--------------------|-----------------------------------|--------------------|
| 32176576-1652-4835-8736-826eb0237482 | | Clinical Consultation Queue | Consult Queue | Outpatient Service |Queue entry statuses | Queue entry priorities | Outpatient Clinic|
```
--------------------------------
### Build Initializer with Validator Profile
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/validator.md
Build the Initializer fatjar with the 'validator' profile enabled. This command is necessary to create the standalone validator executable.
```bash
mvn clean package -P validator
```
--------------------------------
### Concept Sources Directory Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/conceptsources.md
Illustrates the expected directory structure for concept source CSV configuration files.
```bash
conceptsources/
└── conceptsources.csv
```
--------------------------------
### Sample Encounter Types CSV Configuration
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/et.md
Provides a sample CSV structure for configuring encounter types, including headers for UUID, void/retire status, name, description, and privileges.
```csv
Uuid,Void/Retire,Name,Description,View privilege,Edit privilege,_order:1000
, ,Triage Encounter,An encounter for triaging patients.,,,
"aaa1a367-3047-4833-af27-b30e2dac9028",,Medical History Encounter,An interview about the patient medical history.,,,
"439559c2-a3a4-4a25-b4b2-1a0299e287ee",,X-ray Encounter,An encounter during wich X-rays are performed on the patient.,Can: View X-ray encounter,Can: Edit X-ray encounter,
```
--------------------------------
### Hibernate PropertyValueException Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/pit.md
Demonstrates a common exception related to the 'Required' header when a null or transient value is encountered for the 'required' property.
```java
org.hibernate.PropertyValueException:
not-null property references a null or transient value : org.openmrs.PatientIdentifierType.required
```
--------------------------------
### Concept Classes Directory Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/conceptclasses.md
Illustrates the expected directory structure for concept class CSV configuration files.
```bash
conceptclasses/
└── conceptclasses.csv
```
--------------------------------
### Insert Initial Data into Concept Table
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/validator/src/test/resources/trimmed_ciel_excerpt.txt
Populates the 'concept' table with initial records. This script should be run after the table schema has been created.
```sql
LOCK TABLES `concept` WRITE;
INSERT INTO `concept` VALUES (1,0,'','',NULL,4,4,0,1,'2004-01-01 00:00:00','',1,'2020-05-07 21:08:06',1,NULL,NULL,'1AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(2,0,'','',NULL,4,4,0,1,'2004-01-01 00:00:00','',1,'2016-08-09 10:11:28',1,NULL,NULL,'2AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(3,1,'','',NULL,4,4,0,1,'2004-01-01 00:00:00','',1,'2007-10-14 07:33:14',1,NULL,NULL,'3AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(4,0,'','',NULL,4,4,0,1,'2004-01-01 00:00:00','',1,'2016-08-09 10:24:48',1,NULL,NULL,'4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(5,1,'','',NULL,4,4,0,1,'2004-01-01 00:00:00','',1,'2011-03-04 21:23:54',1,NULL,NULL,'5AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(6,1,'','',NULL,4,3,0,1,'2004-01-01 00:00:00','',1,'2005-02-17 21:21:09',1,NULL,NULL,'6AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(7,0,'','',NULL,4,4,0,1,'2004-01-01 00:00:00','',1,'2016-08-09 10:41:21',1,NULL,NULL,'7AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(8,0,'','',NULL,4,4,0,1,'2004-01-01 00:00:00','',1,'2016-08-09 10:45:28',1,NULL,NULL,'8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(9,1,'','',NULL,1,1,0,1,'2004-01-01 00:00:00','',1,'2005-02-12 11:32:33',1,NULL,NULL,'9AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(10,0,'','',NULL,4,4,0,1,'2004-01-01 00:00:00','',1,'2020-05-01 00:20:35',1,NULL,NULL,'10AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(11,0,'','',NULL,4,4,0,1,'2004-01-01 00:00:00','',1,'2016-08-09 11:02:43',1,NULL,NULL,'11AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(12,0,'','',NULL,2,22,0,1,'2004-01-01 00:00:00','',1,'2016-08-09 11:08:37',1,NULL,NULL,'12AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(13,1,'','',NULL,4,3,0,1,'2004-01-01 00:00:00','',1,NULL,1,NULL,NULL,'13AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(14,1,'','',NULL,4,4,0,1,'2004-04-02 00:00:00','',1,'2012-09-28 17:43:51',1,NULL,NULL,'14AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(15,1,'','',NULL,4,4,0,1,'2004-04-02 00:00:00','',1,'2005-02-18 01:44:05',1,NULL,NULL,'15AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(16,1,'','',NULL,4,4,0,1,'2004-01-01 00:00:00','',1,'2007-10-14 07:33:14',1,NULL,NULL,'16AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(17,0,'','',NULL,4,3,0,1,'2004-01-01 00:00:00','',1,'2016-08-10 15:05:01',1,NULL,NULL,'17AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(18,1,'','',NULL,4,3,0,1,'2004-01-01 00:00:00','',1,'2005-02-18 00:21:24',1,NULL,NULL,'18AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(19,1,'','',NULL,4,3,0,1,'2004-01-01 00:00:00','',1,'2005-02-18 00:21:35',1,NULL,NULL,'19AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(20,1,'','',NULL,4,3,0,1,'2004-01-01 00:00:00','',1,'2005-02-18 00:21:52',1,NULL,NULL,'20AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(21,0,'HGB','',NULL,1,1,0,1,'2004-01-01 00:00:00','0.1',1,'2019-02-23 16:59:06',1,NULL,NULL,'21AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(22,0,'HEPA','',NULL,4,3,0,1,'2004-01-01 00:00:00','',1,'2016-08-10 15:19:54',1,NULL,NULL,'22AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(23,1,'','',NULL,4,3,0,1,'2004-01-01 00:00:00','',1,'2005-02-12 12:00:45',1,NULL,NULL,'23AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(24,1,'','',NULL,4,3,0,1,'2004-01-01 00:00:00','',1,'2005-02-12 12:01:12',1,NULL,NULL,'24AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(25,1,'','',NULL,4,3,0,1,'2004-01-01 00:00:00','',1,'2005-02-12 12:01:27',1,NULL,NULL,'25AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(26,1,'','',NULL,4,4,0,1,'2004-01-01 00:00:00','',1,'2007-10-14 07:33:14',1,NULL,NULL,'26AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'),(27,1,'','',NULL,4,
```
--------------------------------
### Sample Appointment Service Definitions CSV
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/appointmentservices.md
Provides a sample CSV structure for defining appointment services, including details like name, duration, and location.
```csv
Uuid,Void/Retire,Name,Description,Duration,Start time,End time,Max load,Speciality,Location,Label colour
fc46dedf-5e96-44d4-bd99-bec1d80d15d5,,Radiology,Service offered by the diagnostic imaging department. Both in-patients and out-patients are serviced,,9:00,17:00,,X-Ray,OPD1,#8FBC8F
```
--------------------------------
### OCL Dictionary Package Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/ocl.md
This is the expected file structure for OCL dictionary packages within the /ocl configuration folder. Ensure your .zip files are placed here.
```bash
ocl/
└── test.zip
```
--------------------------------
### Directory Structure for Procedure Types
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/proceduretypes.md
Illustrates the typical file system layout for the proceduretypes domain configuration.
```bash
proceduretypes/
└── proceduretypes.csv
```
--------------------------------
### Provider Roles Directory Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/providerroles.md
Illustrates the expected directory structure for provider roles CSV imports.
```bash
providerroles/
├──providerroles.csv
└── ...
```
--------------------------------
### Encounter Types Configuration Directory Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/et.md
Illustrates the expected directory structure for encounter type CSV configuration files.
```bash
encountertypes/
└── encountertypes.csv
```
--------------------------------
### Drug Mappings - Option 2 (Type and Source)
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/drugs.md
Example of specifying drug mappings where column headers define both mapping type and source, and values are codes.
```markdown
| ... | Mappings\|SAME-AS\|CIEL | Mappings\|SAME-AS\|SNOMED CT | Mappings\|SAME-AS\|PIH\|Code | Mappings\|SAME-AS\|PIH\|Name |
| - | - | - | - | - |
| ... | 5089 | 27113001 | 5089 | WEIGHT (KG) |
```
--------------------------------
### Drug Mappings - Option 1 (Type Only)
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/drugs.md
Example of specifying drug mappings where the column header defines the mapping type and values are source:code pairs.
```markdown
| ... | Mappings\|SAME-AS | Mappings\|NARROWER-THAN |
| - | - | - |
| ... | CIEL:5089; SNOMED CT:27113001 | LOINC:3141-9 |
```
--------------------------------
### Location CSV File Structure
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/loc.md
This is an example of the directory structure for location CSV import files. It includes the main CSV file and potentially other related files.
```bash
locations/
├──locations.csv
└── ...
```
--------------------------------
### FHIR Concept Mapping Example
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/fhir.md
Represents a concept mapping in FHIR, including the system URL and the code. This structure is used when defining concept sources in OpenMRS.
```json
{
"system": "http://snomed.info/sct",
"code": "1234"
}
```
--------------------------------
### Patient Identifier Type CSV Headers
Source: https://github.com/mekomsolutions/openmrs-module-initializer/blob/main/readme/pit.md
Lists the possible headers for a patient identifier type CSV import file. Headers starting with an underscore are metadata.
```markdown
| Uuid | Void/Retire | Name | Description | Required | Format | Format description | Validator | Location behavior | Uniqueness behavior | _order:1000 |
| - | - | - | - | - | - | - | - | - | - |
```