Bah 2765

.github/workflows/build_and_upload.yml

@@ -0,0 +1,58 @@
+# This workflow will build a Java project with Maven
+# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-maven
+
+name: Java CI with Maven
+
+on:
+ push:
+    branches:
+     - master
+ workflow_dispatch:
+env:
+  ORG_NAME: BahmniIndiaDistro
+  EVENT_TYPE: hip-module-trigger
+
+jobs:
+  build:
+    name: build and upload hip omod
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up JDK 1.8
+      uses: actions/setup-java@v1
+      with:
+        java-version: 1.8
+    - name: Cache Maven packages
+      uses: actions/cache@v2
+      with:
+        path: ~/.m2
+        key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
+        restore-keys: ${{ runner.os }}-m2- 
+    - name: Build with Maven
+      run: mvn clean install
+    - run: mkdir staging && cp omod/target/*.omod staging
+    - uses: actions/upload-artifact@v2
+      with:
+        name: Package
+        path: staging
+
+  trigger-dependent-repos:
+    name: Trigger Workflows
+    needs: build
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        dependent-repos: [ 'bahmni-india-package' ]
+    steps:
+      - name: Create repository_dispatch
+        env:
+          REPOSITORY_NAME: ${{ matrix.dependent-repos }}
+        run: |
+          trigger_result=$(curl -s -o trigger_response.txt -w "%{http_code}" -X POST -H "Accept: application/vnd.github.v3+json" -H 'authorization: Bearer ${{ secrets.BAHMNI_PAT }}' https://api.github.com/repos/${ORG_NAME}/${REPOSITORY_NAME}/dispatches -d '{"event_type":"'"${EVENT_TYPE}"'"}')
+          if [ $trigger_result == 204 ];then
+            echo "Trigger to $ORG_NAME/$REPOSITORY_NAME Success"
+          else
+            echo "Trigger to $ORG_NAME/$REPOSITORY_NAME Failed"
+            cat trigger_response.txt
+            exit 1
+          fi

.gitignore

@@ -3,8 +3,10 @@
 .project
 .classpath
 target
-
+.idea
+*.DS_Store
 # Package Files #
 *.jar
 *.war
 *.ear
+*.iml

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Thoughtworks Technologies India Private limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,25 +1,18 @@
-openmrs-module-basicmodule
+openmrs-module-hipmodule
 ==========================
 
-A demonstration module for new OpenMRS module developers
+HIP module for exposing HIP specific features from OpenMRS.
 
 Description
 -----------
-This is a very basic module which can be used as a starting point in creating a new module.
+This module is supporting the HIP service with all necessary endpoints exposed that are required by the HIP service.
 
 Building from Source
 --------------------
-You will need to have Java 1.6+ and Maven 2.x+ installed.  Use the command 'mvn package' to 
-compile and package the module.  The .omod file will be in the omod/target folder.
+You will need to have Java 1.6+ and Maven 2.x+ installed. 
+You need to install the OpenMrs module SDK from https://github.com/openmrs/openmrs-sdk (see Readme for installation instructions)
 
-Alternatively you can add the snippet provided in the [Creating Modules](https://wiki.openmrs.org/x/cAEr) page to your 
-omod/pom.xml and use the mvn command:
-
-    mvn package -P deploy-web -D deploy.path="../../openmrs-1.8.x/webapp/src/main/webapp"
-
-It will allow you to deploy any changes to your web 
-resources such as jsp or js files without re-installing the module. The deploy path says 
-where OpenMRS is deployed.
+Use the command `mvn clean install` to build the module, the .omod file will be in the omod/target folder.
 
 Installation
 ------------
@@ -30,3 +23,32 @@ If uploads are not allowed from the web (changable via a runtime property), you
 into the ~/.OpenMRS/modules folder.  (Where ~/.OpenMRS is assumed to be the Application 
 Data Directory that the running openmrs is currently using.)  After putting the file in there 
 simply restart OpenMRS/tomcat and the module will be loaded and started.
+
+Configure values 
+------------
+## Vagrant setup
+
+You can configure values like, say location, concept and attribute names. you can check **api/src/main/java/org/bahmni/module/hip/Config.java** to know what are the values you can configure and default values.
+
+### One time setup
+
+1. create a file. For example, created `env_file` in `/etc/openmrs/` directory. 
+2. To create conf file for openmrs service,`systemctl edit openmrs`. It will open blank file. paste the following lines in it
+```
+[Service]
+EnvironmentFile=/etc/openmrs/env_file
+```
+Note: You need to specify your created file path from 1st step in `EnvironmentFile` variable
+
+### To configure values
+
+You need to add values to the `env_file`. For example, if you need to specify custom values for Location and Phone Number attribute.
+```
+LOCATION=your_location
+PHONE_NUMBER=your_phoneNumber_attribute_name
+```
+Note: Attribute Name should be exactly same as enum keys from **api/src/main/java/org/bahmni/module/hip/Config.java**
+
+## Docker setup
+
+You can add values to the openmrs Environment variables, specifying same attribute name.