Activity Plan

- Activity Plan - - INF5750 Open source software development - Version 0.1 - -

- Technical Documentation - Get it running - - Download and install, Java SDK 6,Bazaar and Maven. - Get a copy of the source code by invoking bzr branch lp:~dhis-academy/dhis2-academy/activity-plan in the terminal. - Install PostgresSQL: - Create a postgres user called dhis. - Create a postgres database called dhis. - Download database from dhis2.org - Unzip the database demo. - Invoke run psql -Udhis dhis /"path to demo". - Create "hibernate.properties"-file in the dhis-web directory. - Copy the following into the file: hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect hibernate.connection.driver_class = org.postgresql.Driver hibernate.connection.url = jdbc:postgresql:dhis2 hibernate.connection.username = dhisshibernate.connection.password = dhis hibernate.hbm2ddl.auto = update - Set DHIS2_HOME enviroment variable to the path to /dhis-2/dhis-web. - - Navigate to the dhis-2 directory in the terminal and invoke "mvn install". Then navigate to the dhis-2/dhis-web directory and invoke "mvn install" again. - Navigate to the direcory dhis-2/dhis-web/dhis-web-portal and invoke "mvn jetty:run-war" and the application can be accessed at "http://localhost:8080". - - The applicationWe have developed an expanding application of the DHIS2-project called Activity plan. After you have logged in to DHIS2, you can choose the option activity plan (which is our implementation). Here you will have the possibility to search for patients and follow their program stage by stage. You can do a specific search or an unspecific search as you like. You choose a registering unit (area) and a program. From there you can choose a specific date (todays date is set as standard), and from this date you can search the database for the patients that has been or going to be in this program with multiplies alternatives like 1 day before/after, 1 week before/after to all patients that has been or will be in this program. There is also a possibility to filter out stages for a patient by specifying a stage interval via FromStage, ToStage fields. - Functionality - - Specific search for patients in a program (for example Child health program) - from a specific status (like "overdue", "incomplete", "complete") - choose a specific date (current date as default) - how events/patient list from specific timelines (like 1 day, 3 days, 1 week, 2 weeks, 1 month, all before/after the specific date. For example in the timeline 3 days before to 1 month after the specific date) - for patients in specific stages (like "6 weeks after birth" to "10 weeks after birth" and so on. - - Tracking patients from stage to stage - As mentioned above for example as a timeline for stages, or all stages for the patient. - The user will get a nice overview of the stages lined up next to the patients name and a option of other program at the end. - - Information from the patientlist (pop-up windows) - Information about the patient (can also be downloaded as pdf or excel) - Information for each specific stage - Other programs the patient has been involved in - - Edit - stages (for example; if the stage is complete/incomplete, register the weight of the child and so on) - - - -

- User Documentation - Using the activity plan is simple, once you have navigated to the activity plan site, you simply enter your desired values. You have to pick a unit from the left tree view of the organizational units and a program from the drop-down box. You can also select status, date, event since and stage. There are two ways of specifying a date interval either using the “Use calendar” check box or “Date” field and “Show events since/up to” drop-down menus. Options are automatically filtered out based on a selection in one of drop-down From/To stage fields. When you press “Show” button the patient list is displayed on the lower part of the screen. - - As you can see below the matching selection shows the patient name, his stages and optionally a button to show his other programs. The color scheme makes it easy to know the status of the different stages. - - - - The user can push the name to display additional information. Here, it is also possible to “show detail” witch creates a popup with even more information. - - The enrolled programs panel shows the programs the patient has been enrolled and gives the possibility to show all stages belong to a program. - - The dialog on the right side of the snapshot shows basic stage information. The dialog window appears after the user clicks on a stage. - - The popup for a stage is displayed bellow, here you can also edit information. - -