Looking for detailed documentation

Support - Assistance technique
1

Hi there,

We are trying to build a custom data entry form for case-based data (for a single-event without registration program).

We encounter some issues, we tried to look for the answers in the existing DHIS2.org documentation but the information we found is not detailed enough.

We are trying to find documentation that explains the behavior in the custom data entry form depending on the data element’s data type selected.

Yes only (will this be a checkbox in the form?); text with set option (should this display a select box?)

Looking forward to any documentation that can help us!

Thanks,

Liliana and Johannes

2

Hi,

In fact, as far as I know, all the existent documentation is here

http://www.dhis2.org/documentation

“We are trying to find documentation that explains the behavior in the custom data entry form depending on the data element’s data type selected.”

“text with set option (should this display a select box?)”

Depends on the domain type of your data element, there is a feature request for next version.

https://blueprints.launchpad.net/dhis2/+spec/option-set-aggregate

Kind regards,

Paulo Grácio
Technical Manager
(+258) 822 544 603

Critical Software Mozambique
Dependable Technologies for Critical Systems

Critical Software Mozambique is a subsidiary of Critical Software, a CMMI® Level 5 rated Company
CMMI® is registered in the USPTO by CMU

Rua Pereira Marinho, 179
Bairro de Sommerchield
Maputo
Moçambique
Phone: (+258) 214 951 45
Fax: (+258) 214 951 46

DISCLAIMER: This message is confidential and may contain privileged information. It is for use only by the people or entities to whom it is addressed. If you are not an intended recipient, you should not disclose, distribute, copy, print, rely on or otherwise make use of this message. If an addressing or transmission error has misdirected it to you we would be grateful if you would please notify the sender by return, before deleting it from your system.

···

From my experience the best way is to play around with the different data types, not that many, and see how it works.

From: Dhis2-users [mailto:dhis2-users-bounces+pgracio=criticalsoftware.com@lists.launchpad.net] On Behalf Of PIEVAROLI, Liliana Marcela
Sent: terça-feira, 16 de Abril de 2013 17:38
To: dhis2-users@lists.launchpad.net
Cc: SCHNITZLER, Johannes Christof
Subject: [Dhis2-users] Looking for detailed documentation

Hi there,

We are trying to build a custom data entry form for case-based data (for a single-event without registration program).

We encounter some issues, we tried to look for the answers in the existing DHIS2.org documentation but the information we found is not detailed enough.

We are trying to find documentation that explains the behavior in the custom data entry form depending on the data element’s data type selected.

Yes only (will this be a checkbox in the form?); text with set option (should this display a select box?)

Looking forward to any documentation that can help us!

Thanks,

Liliana and Johannes

3

Hi Liliana. In the current version (2.11) ‘Yes only’ doesn’t render as a checkbox.
There is a blueprint to include this on the next release, 2.12

https://blueprints.launchpad.net/dhis2/+spec/data-entry-yes-only

R

···

On Tue, Apr 16, 2013 at 4:37 PM, PIEVAROLI, Liliana Marcela pievarolil@who.int wrote:

Hi there,

We are trying to build a custom data entry form for case-based data (for a single-event without registration program).

We encounter some issues, we tried to look for the answers in the existing DHIS2.org documentation but the information we found is not detailed enough.

We are trying to find documentation that explains the behavior in the custom data entry form depending on the data element’s data type selected.

Yes only (will this be a checkbox in the form?); text with set option (should this display a select box?)

Looking forward to any documentation that can help us!

Thanks,

Liliana and Johannes

Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

–
Rodolfo Meliá

Principal

rmelia@knowming.com

www.knowming.com

+1 708 872 7636

+44 777 576 4090

Skype: rod.melia

Twitter: @RodolfoMelia

Note: Please note my new email address, which I will be using for PSI related work: rmelia@knowming.com

4

Dear all,

Tracker module support all types of data elements

  • Number and Date data elements are displayed as a text field.

  • For Text data element, we have two sub-type for it. First type is a Text. Data elements with this type will display as a text field in entry form. For Text data elements with sub-type as Long-text, it will displayed as a textarea.

  • Yes/No data elements are displayed as a combobox with 3 options : null value ( please select ), yes and no value.

  • Yes Only data elements are displayed as a checkbox and just save yes( true ) value if it’s checked. No have false value.

  • Username data elements are displayed as an autocompleted field. End-users can search / list all usernames of user who available in system and select an username they want.

  • Option set data elements are display as an autocompleted field. And users can search and select and option-value into option-set which are defined.

Please find out a attachment file to get the snapshot.

…

For aggregate module, in data set, we just support Date, Number, Text and Yes/No. They will be displayed like I presented above. For data elements with other types, they will displayed as text fields, no checkbox ( yes-only ), no auto-completed field ( username and optionset ). And we have a plan to support Yes Only data element for 2.12.

image

···

Best regards,

Châu Thu Trân
HISP Viet Nam
Email: tran.hispvietnam@gmail.com

On Wed, Apr 17, 2013 at 3:00 AM, Rodolfo Melia rmelia@knowming.com wrote:

Hi Liliana. In the current version (2.11) ‘Yes only’ doesn’t render as a checkbox.
There is a blueprint to include this on the next release, 2.12

https://blueprints.launchpad.net/dhis2/+spec/data-entry-yes-only

R

Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

On Tue, Apr 16, 2013 at 4:37 PM, PIEVAROLI, Liliana Marcela pievarolil@who.int wrote:

Hi there,

We are trying to build a custom data entry form for case-based data (for a single-event without registration program).

We encounter some issues, we tried to look for the answers in the existing DHIS2.org documentation but the information we found is not detailed enough.

We are trying to find documentation that explains the behavior in the custom data entry form depending on the data element’s data type selected.

Yes only (will this be a checkbox in the form?); text with set option (should this display a select box?)

Looking forward to any documentation that can help us!

Thanks,

Liliana and Johannes

Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

Rodolfo Meliá

Principal

rmelia@knowming.com

www.knowming.com

+1 708 872 7636

+44 777 576 4090

Skype: rod.melia

Twitter: @RodolfoMelia

Note: Please note my new email address, which I will be using for PSI related work: rmelia@knowming.com

–

5

Dear Châu Thu Trân,

Thank you for your nice notes.

How do I know whether I am using the tracker module or the aggregate module?

· We do not get a checkbox when we use the yes-only type.

We have installed Version: 2.11; Build revision: 10429; Build date: 2013-04-02 15:51

Custom form.

· How can the users see the options before typing? Is there a key combination to see the options or to get a search thing?

Is there a validation when someone enters a value that does not exist?

· We saw that we can create check boxes, select boxes. Are those unbound fields? How would you use them? How can you bind one of those fields with a dataelement?

Thanks for everyone’s answers!!!

Liliana

···

Dear all,

Tracker module support all types of data elements

  • Number and Date data elements are displayed as a text field.

  • For Text data element, we have two sub-type for it. First type is a Text. Data elements with this type will display as a text field in entry form. For Text data elements with sub-type as Long-text, it will displayed as a textarea.

  • Yes/No data elements are displayed as a combobox with 3 options : null value ( please select ), yes and no value.

  • Yes Only data elements are displayed as a checkbox and just save yes( true ) value if it’s checked. No have false value.

  • Username data elements are displayed as an autocompleted field. End-users can search / list all usernames of user who available in system and select an username they want.

  • Option set data elements are display as an autocompleted field. And users can search and select and option-value into option-set which are defined.

Please find out a attachment file to get the snapshot.

…

For aggregate module, in data set, we just support Date, Number, Text and Yes/No . They will be displayed like I presented above. For data elements with other types, they will displayed as text fields, no checkbox ( yes-only ), no auto-completed field ( username and optionset ). And we have a plan to support Yes Only data element for 2.12.

Best regards,

Châu Thu Trân

HISP Viet Nam

Email: tran.hispvietnam@gmail.com

On Wed, Apr 17, 2013 at 3:00 AM, Rodolfo Melia rmelia@knowming.com wrote:

Hi Liliana. In the current version (2.11) ‘Yes only’ doesn’t render as a checkbox.

There is a blueprint to include this on the next release, 2.12

https://blueprints.launchpad.net/dhis2/+spec/data-entry-yes-only

R

On Tue, Apr 16, 2013 at 4:37 PM, PIEVAROLI, Liliana Marcela pievarolil@who.int wrote:

Hi there,

We are trying to build a custom data entry form for case-based data (for a single-event without registration program).

We encounter some issues, we tried to look for the answers in the existing DHIS2.org documentation but the information we found is not detailed enough.

We are trying to find documentation that explains the behavior in the custom data entry form depending on the data element’s data type selected.

Yes only (will this be a checkbox in the form?); text with set option (should this display a select box?)

Looking forward to any documentation that can help us!

Thanks,

Liliana and Johannes

**

Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

–

Rodolfo Meliá

Principal

rmelia@knowming.com

www.knowming.com

+1 708 872 7636

+44 777 576 4090

Skype: rod.melia

Twitter:
@RodolfoMelia

Note: Please note my new email address, which I will be using for PSI related work: rmelia@knowming.com

Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

6

Dear PIEVAROLI,

···

Please see my comments below.

On Fri, Apr 19, 2013 at 9:26 PM, PIEVAROLI, Liliana Marcela pievarolil@who.int wrote:

Dear Châu Thu Trân,

Thank you for your nice notes.

How do I know whether I am using the tracker module or the aggregate module?

When to create a data element, if we select Domain type as Aggregate, then this data element is used for aggregate module. And we can add it into a certain data set, aggregate reports, charts, …

If we select Domain type as Patient, then this data element is used for tracker module. We can add it into a program-stage of a certain program to collect individual data.

· We do not get a checkbox when we use the yes-only type.

We have installed Version: 2.11; Build revision: 10429; Build date: 2013-04-02 15:51

Custom form.

Yes-only data elements are only supported for tracker module. So, if you createg a data element with domain as Aggregate and add it into dataset, then this data element is not displayed as checkbox in data entry form.

· How can the users see the options before typing? Is there a key combination to see the options or to get a search thing?

When to click on Show All Items button next to the option-set data element field, a option-value list are displayed. To search a option-value, let type the key you want to search in field, the result will be displayed below.

Is there a validation when someone enters a value that does not exist?

If you’re talking about the compulsory data element, the for aggregate module, let open Data set management form, find data set which you added this data element, click on the Edit compulsory data elements icon. For tracker module, in Add/Update program-stage form, check Compulsory column of data elements you want.

Let find which is corresponding to data set included the data element

· We saw that we can create check boxes, select boxes. Are those unbound fields? How would you use them? How can you bind one of those fields with a dataelement?

For aggregate module, we just supportDate, Number, Text ( Text fields) and Yes/No (select boxes).

For tracker module, you only need to declare the exactly value type for data elements with domain Patient. And add them into a certain program-stage, then in case entry form, you can see them like the snapshot which I shared in previous mail.

Thanks for everyone’s answers!!!

Liliana

Best regards,

Châu Thu Trân

HISP Viet Nam
Email: tran.hispvietnam@gmail.com