As an Adaptive Form is routed to different users in AEM Workflow, there will be requirements to hide or disable certain fields or panels based on the person reviewing the form. To satisfy these use cases we typically set a value of a hidden field. Based on this hidden field's value business rules can be authored to hide/disable appropriate panels or fields.
Capture

In AEM Forms OSGI- we will have to write a custom OSGi bundle to set JSON data element's value. The bundle is provided as part of this tutorial.

We use Process Step in AEM workflow. We associate the "Set Value of Element in Json" OSGi bundle with this process step. 

We need to pass two arguments to the set value bundle. The first argument is the path to the element whose value needs to be set. The second argument is the value that needs to be set.

For example, in the above screenshot, we are setting the value of the intialStep element to "N"

afData.afUnboundData.data.initialStep,N

In our example, we have a simple Time Off Request Form. The initiator of this form fills in his/her name and the time off dates. On submission, this form goes to "manager" for review. When the manager opens the form, fields on the first panel are disabled. This because we have set the value of the initial step element in the JSON data to N.  

Based on the initial step fields value we show the approver panel where the "manager" can approve or reject the request.

Please take a look at the rules set against "Initial Step". Based on the value of the initialStep field we fetch the user details using Form Data Model and populate the appropriate fields and hide/disable appropriate panels.

To deploy the assets on your local system

Download and extract the content of the zip file

Point your browser to Felix console

Deploy the SetValueApp.core-1.0-SNAPSHOT.jar bundle and start the bundle

Point your browser to package manager

Import and install the TimeOffRequestJsonData.zip. This has the sample workflow model,Form Data Model and sample user used in this workflow.

Point your browser to Forms and Documents to upload the sample form. This form was built using AEM Forms 6.4. Please make sure you are on AEM Forms 6.4

Click Create | File Upload

Upload the TimeOffRequestForm.zip

Open the form

Fill in the Start and End Dates and submit the form.

Logout of AEM.

Login as 'manager/password" in to AEM

Go to "Inbox"

Open the "Manager Approves" form.

Notice the fields in the first panel are disabled.

Notice the panel for approving or declining the request.

 

Download

Note:

Since we are pre-populating form using user profile, make sure the admin user profile information is set.

You can enable debug logging by enabling logger for

com.aemforms.setvalue.core.SetValueInJson

by pointing your browser to http://localhost:4502/system/console/slinglog

Note:

The OSGi bundle for setting value of data elements in JSON Data currently supports the ability to set one element value at one time. If you want to set multiple element values, you will need to use process step multiple times.

 

Make sure the Data File path in the Adaptive Form's submission options is set to "Data.xml". This is because the process step looks for a file called Data.xml under the payload folder

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy