Document details for renderer

In HTML Workspace, multiple form types are supported seamlessly. These include:

• PDF forms (XDP / Acroform / Flat PDFs)
• New HTML forms
• Flex® forms (old)
• Flex Guides (Adobe® LiveCycle® Guides is deprecated)
  
• Images
• Third-party applications (for example, Correspondence Management)

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 HTML 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 same workspace components in different portals, and not for modifying the rendering logic itself.

PDF Forms

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 HTML Workspace, PDFTaskForm view communicates with the FormBridge javascript, via 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 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 PDF javascript from an HTML. PdfTaskForm view also takes care of flat PDF and renders it plainly.

New HTML Forms

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 in PDF Forms above, but serves a similar purpose.

Flex Forms and Guides

Flex Forms are rendered by SwfTaskForm and guides are rendered by HtmlTaskForm Views respectively.

In HTML 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 task details view. WsNextAdapter.swf is used for performing various form actions like save or submit.

Third-party applications (for example, Correspondence Management)

Third-party applications are rendered using ExtAppTaskForm view.

Third-party application to HTML Workspace communication

HTML 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 HTML Workspace as needed. Using this interface is mandatory, because the HTML Workspace must know that when the task is submitted so that it can clean up the task window.

HTML Workspace to third-party application communication

If HTML 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 HTML 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 on third-party application integration with respect to Correspondence Management at Integrating Correspondence Management in HTML Workspace.