Please can anyone kindly clarify what a ProgramInstance is? I see that it is different from instances of Program or TEI which are quite well described.
I've missed where ProgramInstance is described in the manual.
For example, a new test database we've been using has 333 ProgramInstance instances and 233 TrackedEntityInstances.
Since TEIs have a set of ProgramInstances, I am guessing that it is the number of enrollments by a TEI to a program or programstageinstance?
Also, I've tried to look at the javadoc and the code, but I noticed there's less comments these days for base domain/POJOs like these.
I know it can be confusing as we are exposing the internals with different names, but its a bigger task of renaming it internally (sql tables etc) then externally.
For sure everyone on the team know we are not the best at code documentation, but we will try and improve.
Please can anyone kindly clarify what a ProgramInstance is? I see that it is different from instances of Program or TEI which are quite well described.
I’ve missed where ProgramInstance is described in the manual.
For example, a new test database we’ve been using has 333 ProgramInstance instances and 233 TrackedEntityInstances.
Since TEIs have a set of ProgramInstances, I am guessing that it is the number of enrollments by a TEI to a program or programstageinstance?
Also, I’ve tried to look at the javadoc and the code, but I noticed there’s less comments these days for base domain/POJOs like these.
you are right to assume that ProgramInstance is an enrollment.
My way of looking at the Program/ProgramStage/TrackedEntity and their instances is like this:
Assume we have a TrackedEntity “Person”, a Program “Life” and two ProgramStages “Birth” and “Death”. All these objects tells us how we describe them. A Person has a name, age and more.
When creating an actual Person, we use to TrackedEntity Person to know how to desribe this new Person. The result is a TEI, which is the actual description on the Person. Similary, when this TEI is enrolled in the Life program we create a new ProgramInstance for the TEI. This ProgramInstance is the description of the TEI’s enrollment in the Life Program. And finally, when the Person is born, we add the Birth ProgramStage to the Program, giving us a ProgramStageInstance (Also described as an event in the UI). This is then a description of the actual birth event for the TEI. The same goes for the Death ProgramStage.
I hope this clears it up somewhat. If you still have questions let me know.
Please can anyone kindly clarify what a ProgramInstance is? I see that it is different from instances of Program or TEI which are quite well described.
I’ve missed where ProgramInstance is described in the manual.
For example, a new test database we’ve been using has 333 ProgramInstance instances and 233 TrackedEntityInstances.
Since TEIs have a set of ProgramInstances, I am guessing that it is the number of enrollments by a TEI to a program or programstageinstance?
Also, I’ve tried to look at the javadoc and the code, but I noticed there’s less comments these days for base domain/POJOs like these.