Add a form to UI using Manage Form under configure metadata

Ask OpenMRS
, , , ,
1

Hi all, When I add a form to UI using configure metadata>manage form there are several options including for example Icon style, Order, etc.

see picture below

addform.png1331×995 44.5 KB

My question is related to SHOW IF.

I need to show specific forms for a
1- Given location 2- Given Gender (Male/Female) 3- Given Age (for example patient age > 16 ) 4- Given patient ID : for example ID starts with a given character or number 5- Given patient name

I tried so many times to play around it but I could not figure out how to do this. The result that I keep getting is the disappearance of the form completely. If anybody can help me with this I will much appreciate it

Thanks in advance

1 Like
2

@yadamz I had the same challenge which was resolved here by adding the data to my from metadata How to add/remove fragments from dashboard & link forms

The forms are added to the patient dashboard when you are viewing a specific patient so checks #4 and #5 are not relevant

The additional checks on the UI could be added as follows:

location.id = 4 && patient.person.gender==‘M’ && patient.person.age > 16

Note the use of HTML entities for special characters & for & and > for > which

3

Stephan
 you are Amazing
 Thanks very much

One question: where do I find a list of these codes: patient.person.gender==’’ patient.person.age > xx

Is there a place where I learn them


For example: If I need a special form for a given diagnosis
 How do I learn to develop a code for it.

4

Not me, the OpenMRS community is :grinning:

My understanding is that those are attributes of a person, so you can leverage the scheme for visits, encounters etc. I am not sure if there is a single place to learn them, they are based on what you need.

For forms, I would go to the HTML form entry module https://wiki.openmrs.org/display/docs/HTML+Form+Entry+Module+Getting+Started and base on sample forms like https://github.com/openmrs/openmrs-module-referenceapplication/tree/master/omod/src/main/webapp/resources/htmlforms in the reference application

5

Thanks 
 This is great

6

The overall feature is documented on the Configure Metadata: Manage Forms wiki page.

Documentation (of low quality) on what variables are available in the show if expression are described on the Conditionally displaying Apps and Extensions wiki page.

7

Thanks @darius I could not figure out how t use that document to find out the expression for

1- show if: user role == Organizational: Doctor, for example

I appreciate this your help

8

For that specific use case, you should not actually be using “show if”. Rather you should create a Privilege like “Application: Enters Xyz Form” and then assign this privilege to the appropriate roles.

The Manage Form UI lets you specify a required privilege (and this is applied before even doing the Show If test).

9

Hi @ssmusoke, @darius I am trying to configure an ANC Form to be displayed on the Patient Dashboard - Current Visit Actions only if the selected visit type is ANC.

So far I have tried setting the Show If configuration as follows but no luck in all these cases. Could you please help shed some light here?

visit.type=='0f8ed9ac-f40c-476c-a120-17e8113b2744'
visit.uuid:0f8ed9ac-f40c-476c-a120-17e8113b2744
visit.uuid=='0f8ed9ac-f40c-476c-a120-17e8113b2744'

Thanks.

10

I do not think VisitType is supported within the configurations, I am only aware of locations at this point which is what we use.

See this thread Displaying HTML entry forms based on login session in reference application

11

Okay that sheds some light, I think we can create some child login locations for the different visit areas for example Maternity Ward and then display only Maternity and delivery forms for people logging in to the location. Would that work, you think?

12

The UgandaEMR ANC form display is https://github.com/METS-Programme/openmrs-module-aijar/blob/master/omod/src/main/webapp/resources/htmlforms/071-IntegratedAntenatalRegister.xml#L10

The location e9bc61b5-69ff-414b-9cf0-0c22d6dfca2b is the MCH Clinic

You can look at the demo:

13

OK. Am sure this helps. Thanks a lot.