In the AEM Forms workspace, multiple form types are supported seamlessly. These include:
This document explains the working of these renderers from the perspective of semantic customization / component reuse, so that customer requirements are met without breaking any rendition. While AEM Forms workspace allows for any user interface / semantic changes, it is recommended that the rendering logic of different form types not be changed, otherwise the results can be unpredictable. This document is for guidance / knowledge to support rendering the same form, using the same workspace components in different portals, and not for modifying the rendering logic itself.
PDF forms are rendered by PdfTaskForm View
.
When an XDP form is rendered as PDF, a FormBridge
JavaScript™ is added by FormsAugmenter service. This JavaScript™ (inside the PDF form) helps in performing actions like form submit, form save, or taking form offline.
In AEM Forms workspace, PDFTaskForm view communicates with the FormBridge
JavaScript, by way of an intermediary HTML present at /lc/libs/ws/libs/ws/pdf.html
. The flow is:
PDFTaskForm view - pdf.html
Communicates using window.postMessage
/ window.attachEvent('message')
This method is the standard way of communication between a parent frame and an iframe. The existing event listeners from previously opened PDF forms are removed before adding a new one. This purging also considers the switching between form tab and history tab in the task details view.
pdf.html - FormBridge
JavaScript inside the rendered PDF
Communicates using pdfObject.postMessage
/ pdfObject.messageHandler
This method is the standard way of communication with a PDFJavaScript from an HTML. PdfTaskForm view also takes care of a flat PDF and renders it plain.
It is not recommended to edit the pdf.html / contents of the PdfTaskForm view.
New HTML forms are rendered by NewHTMLTaskForm View.
When an XDP Form is rendered as HTML using the mobile forms package deployed on CRX, it also adds additional FormBridge
JavaScript to the form, which exposes different methods for saving and submitting form data.
This JavaScript is different from the one referred to in PDF Forms above, but serves a similar purpose.
Adobe does not recommend editing the contents of the NewHTMLTaskForm view.
Flex Forms are rendered by SwfTaskForm and guides are rendered by HtmlTaskForm Views respectively.
In AEM Forms workspace, these views communicate with the actual SWF which makes up the Flex® form/guide using an intermediary SWF present at /lc/libs/ws/libs/ws/WSNextAdapter.swf
The communication happens using swfObject.postMessage
/ window.flexMessageHandler
.
This protocol is defined by the WsNextAdapter.swf
. The existing flexMessageHandlers
on window object, from previously opened SWF forms are removed before adding a new one. The logic also considers the switching between form tab and history tab in the task details view. The WsNextAdapter.swf
is used to perform various form actions like save or submit.
It is not recommended to modify WSNextAdapter.swf
or the contents of SwfTaskForm / HtmlTaskForm view.
Third-party applications are rendered using the ExtAppTaskForm view.
Third-party application to AEM Forms workspace communication
AEM Forms workspace listens on window.global.postMessage([Message],[Payload])
[Message] can be a string specified as SubmitMessage
| CancelMessage
| ErrorMessage
| actionEnabledMessage
in the runtimeMap
. Third-party applications must use this interface to notify the AEM Forms workspace as needed. Using this interface is mandatory, because the AEM Forms workspace must know that when the task is submitted so that it can clean up the task window.
AEM Forms workspace to third-party application communication
If AEM Forms workspace’s direct action buttons are visible, it calls window.[External-App-Name].getMessage([Action])
, where [Action]
is read from the routeActionMap
. The third-party application must listen on this interface, and then notify AEM Forms workspace via the postMessage ()
API.
For example, a Flex application can define ExternalInterface.addCallback('getMessage', listener)
to support this communication. If the third-party application wants to handle form submission via its own buttons, then you should specify hideDirectActions = true() in the runtimeMap
and you may skip this listener. Hence, this construct is optional.
You can read more about third-party application integration regarding Correspondence Management at Integrating Correspondence Management in the AEM Forms workspace.