There is much XML involved with AEM Forms on JEE Process Management workflows, for instance: XML information may be built in a process and sent to a Flex application in AEM Forms on JEE Workspace, used for systems settings, or passing information to and from forms. There are many instances where a AEM Forms on JEE developer needs to manage XML, and many times this requires that the XML be managed via a AEM Forms on JEE process.
When dealing with simple XML settings, one may use the Set Value
service, which is a default AEM Forms on JEE service. This service sets the value of one or more data items in the process data model. For simple conditional logic “if this, then that” scenarios, this service can suit the purpose.
However, in more complex situations, the Set Value service isn’t as effective. In these situations, one must rely on a more robust set of programming commands, such as those provided by a programming language like Java™. Using Java™ to build complex XML can be much easier and more clear than building an XML document from simple text within the Set Value service. In addition, it is easier to include conditional programming in Java™ than within a Set Value service.
Within the set of the standard AEM Forms on JEE services available in AEM Forms on JEE Workbench, is the Execute Script
service. This service lets you execute scripts in processes and provides the executeScript
operation to do so.
Overall application and process creation is out-of-scope for this tutorial, but for the sake of this instruction, an application named “DemoApplication02” has been created. Assuming that an application has already been created, you need to create a process in this application to call the executeScript service. To add a process to the application that includes the Execute Script
service:
executeScriptDemoProcess
.Foundation
set of services. The Services name lists the object as Execute Script – 1.0
with the Operation name executeScript
. Click to select this item.Once the process has been created with the “Execute Script” Service activity defined, one can then add a script to this process. To add a script to this process:
Navigate to the Process Properties palette. Within this palette, expand the Input section and click the “…” icon.
In the text box that appears write your script. When the script has been written, press OK (see Figure below).
Once a process has been created with the Execute Script service included, one can then use this script to create XML. One would write the scripts described below in the text box described in the Add a Script to the Process with the Execute Script
Service section above.
About the Execute Script Service’s Technology
To know what the abilities and limitations of the Execute Script service are, one must know the technological underpinnings of the service. AEM Forms on JEE uses the Apache Xerces Document Object Model (DOM) parser to create and store XML variables within processes. Xerces is a Java™ implementation of W3C’s Document Object Model specification; defined here. The DOM specification is a standard way of manipulating XML that has been around since 1998. The Java™ implementation of Xerces, Xerces-J, supports DOM Level 2 version 1.0.
The Java™ classes used to store XML variables are:
org.apache.xerces.dom.NodeImpl and
org.apache.xerces.dom.DocumentImpl
DocumentImpl is a subclass of NodeImpl, so it can be supposed that any XML process variable is a NodeImpl derivation. You can find the documentation for NodeImpl here.
A Sample XML Creation Using the Execute Script Service
Here is the example of creating XML, within an Execute Script service. The process has a variable node that is of type XML. The result of this activity is an XML document. What that document does, or how it applies to the overall process is out-of-scope for this tutorial; ultimately it comes down to what the XML is required to do in the overall application. As was mentioned in the introduction, XML can be used for many purposes in AEM Forms on JEE forms and processes, this is simply an explanation of how to code the Execute Script activity to output a simple XML document.
A simple JavaScript to output XML would looks something like this:
import org.apache.xerces.dom.DocumentImpl;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
Document document = new DocumentImpl();
Element topLevelResources = document.createElement("resources");
Element resource = document.createElement("resource");
resource.setAttribute("id", "first item id");
resource.setAttribute("value", "first item value");
topLevelResources.appendChild(resource);
document.appendChild(topLevelResources);
patExecContext.setProcessDataValue("/process_data/node", document);
The previously mentioned DOM objects must be imported into the script.
The result of this simple script is a new XML document with a variable node that is set to:
<resources>
<resource id="first item id" value="first item value"/>
</resources>
Using an Iterative loop to Add Nodes to the XML
Nodes can be added to an existing XML variable within the process, too. The variable, node, contains the XML object that was created.
Document document = patExecContext.getProcessDataValue("/process_data/node");
NodeList childNodes = document.getChildNodes();
int numChildren = childNodes.getLength();
for (int i = 0; i < numChildren; i++)
{
Node currentChild = childNodes.item(i);
if (currentChild.getNodeType() == Node.ELEMENT_NODE)
{
// found the top-level node
Element newResource = document.createElement("resource");
newResource.setAttribute("id", "second item id");
newResource.setAttribute("value", "second item value");
currentChild.appendChild(newResource);
break;
}
}
patExecContext.setProcessDataValue("/process_data/node", document);
The variable node in the XML is now set to:
<resources>
<resource id="first item id" value="first item value"/>
<resource id="second item id" value="second item value"/>
</resources>