Difference between revisions of "2016"

From mn/ifi/inf5750
Jump to: navigation, search
(Milestones)
(Things to add to the project wiki)
Line 22: Line 22:
 
*Written exam: December 6
 
*Written exam: December 6
 
*Presentation:  December 7-9
 
*Presentation:  December 7-9
 +
 +
= Resources =
 +
[http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet Editing a wiki]
 +
 +
[https://www.dhis2.org/appstore https://www.dhis2.org/appstore]
  
 
= Tips and tricks =
 
= Tips and tricks =
Line 27: Line 32:
 
Feel free to add things here as you discover them.
 
Feel free to add things here as you discover them.
  
The easiest way to run DHIS2 on your own computer is to download with DHIS2 Live. Download [[here]].
+
The easiest way to run DHIS2 on your own computer is to download with DHIS2 Live. Download [https://www.dhis2.org/download/live/dhis2-live.zip here].
  
Here are slides for Windows, things work similarly on Linux or OSX, though you would then start from the command line like this: ./startup.sh
+
[https://drive.google.com/open?id=0B7h7JFGWnBi7cXpKN2dHaGtaUE0 Here] are slides for Windows, things work similarly on Linux or OSX, though you would then start from the command line like this: ./startup.sh
  
 
Each project should create a shared Git repository, e.g. on [[Bitbucket]].
 
Each project should create a shared Git repository, e.g. on [[Bitbucket]].
  
*You can run DHIS. Then follow this guide to s[https://www.dhis2.org/doc/snapshot/en/implementer/html/ch08s03.html etup DHIS2]
+
*You can also use [[play.dhis2.org]], but remember that the database is reset every night (so you lose any changes you have made)
*You can also use [[play.dhis2.org]], but remember that the databse is reset every night.
 
 
*How to [[webstorm_deploy|deploy your project files easily from Webstorm]], so you can edit files in Webstorm, but test on a remote server. (Requires local installation of DHIS2)
 
*How to [[webstorm_deploy|deploy your project files easily from Webstorm]], so you can edit files in Webstorm, but test on a remote server. (Requires local installation of DHIS2)
 
*It is not possible to upload the same app twice to DHIS2. If you want to update the app, you either have to edit the files directly on the server (log in using ssh) or delete it and reinstall it via the web. You delete the app via the web by going tp App management -> Settings and the clicking the name of the app, and pressing 'Delete'. 
 
*It is not possible to upload the same app twice to DHIS2. If you want to update the app, you either have to edit the files directly on the server (log in using ssh) or delete it and reinstall it via the web. You delete the app via the web by going tp App management -> Settings and the clicking the name of the app, and pressing 'Delete'. 
 
*When you zip your app files, make sure you zip then so that the AppManifest and other files are in the root of the zip-file. If you select the folder and zip, the files won't be zipped correctly. You need to go into your folder and then select all files and zip. 
 
*When you zip your app files, make sure you zip then so that the AppManifest and other files are in the root of the zip-file. If you select the folder and zip, the files won't be zipped correctly. You need to go into your folder and then select all files and zip. 
*[[App settings on dev and demo servers]] (sometimes the settings change to the wrong value, read here to know how to fix).
 
 
*[[Using the single event API on DHIS2]] (Useful for embedding-apps-in-tracker also)
 
*[[Using the single event API on DHIS2]] (Useful for embedding-apps-in-tracker also)
*This is [http://git.uio.no/git/?p=inf5750/roland/Example.git;a=blob_plain;f=example.zip;hb=HEAD Mobilars' example app], fixed with a bug that made it not who the Leaflet map properly. Based on Angular. Does a few DHIS2 WEB Api calls. Now also with an update where it finds the correct DHIS2 API url by downloading its own manifest-file (the manifest file is edited by DHIS2 on app installation)
 
 
*If you're using Single event, and are having problems with events not appearing in the analytics API, try reading [http://apps.dhis2.org/demo/api/resourceTables/analytics this]. You must have permission ALL or F_DATA_MART_ADMIN on your user to run these commands. On the demo db, only the system user has this. Not admin. To avoid running this from the Geo-location app (where you want to see recently uploaded events), you may want to keep a cache of the last uploaded events.
 
*If you're using Single event, and are having problems with events not appearing in the analytics API, try reading [http://apps.dhis2.org/demo/api/resourceTables/analytics this]. You must have permission ALL or F_DATA_MART_ADMIN on your user to run these commands. On the demo db, only the system user has this. Not admin. To avoid running this from the Geo-location app (where you want to see recently uploaded events), you may want to keep a cache of the last uploaded events.
 +
*How to [[Edit dhis2 web pages]] (Relevant for Social & App-embedding)
 
*For those who are doing changes of DHIS2 source code, you may want to read up a bit on Struts. [http://www.uio.no/studier/emner/matnat/ifi/INF5750/h12/undervisningsmateriale/mvc-and-struts2.pdf here] is a presentation from the 2012-version of INF5750. Struts has been removed from this year's course.
 
*For those who are doing changes of DHIS2 source code, you may want to read up a bit on Struts. [http://www.uio.no/studier/emner/matnat/ifi/INF5750/h12/undervisningsmateriale/mvc-and-struts2.pdf here] is a presentation from the 2012-version of INF5750. Struts has been removed from this year's course.
*[http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet Editing a wiki]
 
*How to [[Edit dhis2 web pages]] (Relevant for Social & App-embedding)
 
*How to install [http://jeffmcmahan.info/blog/installing-cordova-on-linux/ Cordova] because there's a lot of hidden problems with python if not installed when you're installing nodejs. You have to remember when you run the android command(which is the same as the android sdk manager) you need to add api x(x depending on which version you're going to test on) or else you might get problems when running 'cordova platform add android'. It may also be mentioned if you have problems running the 'cordova emulate android', you could try and make your own custom avd with the command 'android avd' instead, this will make a default image so that you can skip to the 'cordova run android'.
 
  
 
== Installing DHIS2 sample data ==
 
== Installing DHIS2 sample data ==
Line 51: Line 51:
 
*[https://wiki.uio.no/mn/ifi/inf5750/index.php/InstallSampleData Tutorial for installing DHIS2 sample data]
 
*[https://wiki.uio.no/mn/ifi/inf5750/index.php/InstallSampleData Tutorial for installing DHIS2 sample data]
  
= Things to add to the project wiki =
+
= Project groups =
 +
 
 +
=== Things to add to your group page ===
  
 
*List of group members
 
*List of group members
Line 63: Line 65:
 
*Download link to sample web app
 
*Download link to sample web app
  
= Group pages =
+
=== Group pages ===
  
 
Add a link to your own group's main page here. 
 
Add a link to your own group's main page here. 
  
 
*Groupname (link) [[2014_Groups]]
 
*Groupname (link) [[2014_Groups]]
 
Resources
 
 
[https://www.dhis2.org/doc/snapshot/en/developer/html/ch01.html https://www.dhis2.org/doc/snapshot/en/developer/html/ch01.html]
 
 
[https://www.dhis2.org/appstore https://www.dhis2.org/appstore]
 

Revision as of 10:51, 12 October 2016

INF5750 2016

This Wiki is used for documenting the group projects for INF5750 2016. 

The 2015 page is available here

The overview of group project tasks

Milestones

Each group should follow these milestones:

  • Milestone 1: October 28

Document features and architecture on Wiki

Show understanding of your project task

During the project period, make sure your group Wiki page reflects the status of your project and be aware that the group teachers will monitor activity in your Git repo.

  • Final delivery: November 27
  • Written exam: December 6
  • Presentation: December 7-9

Resources

Editing a wiki

https://www.dhis2.org/appstore

Tips and tricks

Feel free to add things here as you discover them.

The easiest way to run DHIS2 on your own computer is to download with DHIS2 Live. Download here.

Here are slides for Windows, things work similarly on Linux or OSX, though you would then start from the command line like this: ./startup.sh

Each project should create a shared Git repository, e.g. on Bitbucket.

  • You can also use play.dhis2.org, but remember that the database is reset every night (so you lose any changes you have made)
  • How to deploy your project files easily from Webstorm, so you can edit files in Webstorm, but test on a remote server. (Requires local installation of DHIS2)
  • It is not possible to upload the same app twice to DHIS2. If you want to update the app, you either have to edit the files directly on the server (log in using ssh) or delete it and reinstall it via the web. You delete the app via the web by going tp App management -> Settings and the clicking the name of the app, and pressing 'Delete'. 
  • When you zip your app files, make sure you zip then so that the AppManifest and other files are in the root of the zip-file. If you select the folder and zip, the files won't be zipped correctly. You need to go into your folder and then select all files and zip. 
  • Using the single event API on DHIS2 (Useful for embedding-apps-in-tracker also)
  • If you're using Single event, and are having problems with events not appearing in the analytics API, try reading this. You must have permission ALL or F_DATA_MART_ADMIN on your user to run these commands. On the demo db, only the system user has this. Not admin. To avoid running this from the Geo-location app (where you want to see recently uploaded events), you may want to keep a cache of the last uploaded events.
  • How to Edit dhis2 web pages (Relevant for Social & App-embedding)
  • For those who are doing changes of DHIS2 source code, you may want to read up a bit on Struts. here is a presentation from the 2012-version of INF5750. Struts has been removed from this year's course.

Installing DHIS2 sample data

Project groups

Things to add to your group page

  • List of group members
  • Summary of requirements
  • Time schedule
  • How you are dividing tasks within the group
  • Screenshots and screen flows
  • Documented learning during project
  • Suggested improvements to APIs etc
  • Link to repository
  • Download link to sample web app

Group pages

Add a link to your own group's main page here.