J2ME Tracker 2.15

**BACKGROUND**

The "patient" tables were replaced with "trackedentity" tables to make the tracker more flexible, i.e. able to track not only patients, but also commodity, buildings, etc. The changes in the table names caused the basic functionalities of the J2ME tracker to fail. Thus there is a need to re-align the J2ME tracker’s model to the core model’s changes.

**USE CASE**

In the Tracking Main Menu user will have the ff options:
- Find Tracked Entity
- Add Tracked Entity
- History
- Pending Registration

BASIC FUNCTIONALITY #1: FIND TRACKED ENTITY
Upon choosing the “Find Tracked Entity” option in the main menu, user would be brought to the “Search Tracked Entity” Screen. Use will have the option to enter values for “Search for: *” textbox, “Tracked Entity Name” combo box, and “Org Unit” combo box. Selecting the “Enter” button will bring the user to the “Select Tracked Entity” Screen which contains the list of search results. Clicking one of the tracked entities would bring the user to the tracked entity’s “Dashboard” containing all the details of the tracked entity and the program it is enrolled to.

BASIC FUNCTIONALITY #2 ADD TRACKED ENTITY
Choosing the “Add Tracked Entity” option would show the “Select Program” screen where the Programs assigned to the user is listed. Upon selecting a program, the “Tracked Entity Registration” page will be displayed where user can input the tracked entity’s attributes. Once done, the user would have the option to “Save”, “Send” or “Cancel” the registration. Selecting “Save” will save the tracked entity’s detail in the device. Selecting “Send” will send the tracked entity’s details to the server and at the same time saved it in the device. After this, a successful registration confirmation will be shown where the user can opt to go “Back “ to the main menu or go “Next” to the “Data Entry View”

BASIC FUNCTIONALITY #3 HISTORY
Choosing the “History” option would show the “History” screen with a list of tracked entities from the device database. Clicking on a tracked entity would show it’s “Dashboard”

BASIC FUNCTIONALITY #4 PENDING REGISTRATION
Choosing the “Pending Registration” option would show the “Unregistered Tracked Entity List”. This is a list of the registered tracked entity that were only saved (and not sent) to the server. User will have the option to “Send All” to send all the pending registration to the server.

**TECHNICAL IMPLEMENTATION:**

USER INTERFACE:
On the UI side, all instances of “Person” or “Patient” text will be replaced with “Tracked Entity”

BACKEND:
On the backend, the client will use the new “TrackedEntity” APIs instead of the “Patient” APIs. This would mean changes on all the “Patient”-related models.

The changes in the table are as follows:

Renamed tables:
Trackedentity
Trackedentityaggregatereport
Trackedentityaggregatereport_dimension
Trackedentityaggregatereport_filters
Trackedentityaggregatereportusergroupaccesses
Trackedentityattribute
Trackedentityattributegroup
Trackedentityattributevalue
Trackedentityaudit
Trackedentitycomment
Trackedentitydatavalue
Trackedentitymobilesetting
Trackedentityform
Trackedentityinstancereminder
Trackedentitytabularreport
Trackedentitytabularreport_dimensions
Trackedentitytabularreport_filters
trackedentitytabularreportusergroupaccesses

New Tables:
Trackedentityaggregatereportmembers
Trackedentityinstance
Trackedentitytabularreportmembers

Deleted tables:
Patientattributeoption
Patientidentifiertype
Patientregistrationform_attributes
Patientregistrationform_fixedattributes
Patientregistrationform_identifiertypes

Priority: High
Difficulty: Hard-Moderate
Estimate: (Rough-Most Likely) 8-10 days