呈现器的文档详细信息 document-details-for-renderer

CAUTION
AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

简介 introduction

在AEM Forms工作区中,可以无缝支持多种表单类型。 其中包括:

  • PDF forms(XDP / Acroform /平面PDF)
  • 新HTML表单
  • 图像
  • 第三方应用程序(例如,通信管理)

本文档从语义自定义/组件重用的角度介绍了这些渲染器的工作,以便在不破坏任何呈现的情况下满足客户要求。 虽然AEM Forms工作区允许任何用户界面/语义更改,但建议不要更改不同表单类型的渲染逻辑,否则结果可能无法预测。 本文档旨在提供指导/知识,以支持渲染同一表单,在不同的门户中使用相同的工作区组件,而不是用于修改渲染逻辑本身。

PDF forms pdf-forms

PDF forms由 PdfTaskForm View.

当XDP表单呈现为PDF时, FormBridge JavaScript™由FormsAugmenter服务添加。 此JavaScript™(在PDF表单内)有助于执行表单提交、表单保存或离线表单等操作。

在AEM Forms工作区中,PDFTaskForm视图与 FormBridgejavascript,通过在 /lc/libs/ws/libs/ws/pdf.html. 流程是:

PDFTaskForm视图 — pdf.html

使用进行通信 window.postMessage / window.attachEvent('message')

此方法是父帧与iframe之间的标准通信方式。 在添加新事件侦听器之前,将删除先前打开的PDF forms中的现有事件侦听器。 此清除还考虑在任务详细信息视图的表单选项卡和历史记录选项卡之间进行切换。

pdf.html - FormBridge呈现的PDF内的javascript

使用进行通信 pdfObject.postMessage / pdfObject.messageHandler

此方法是从HTML与PDFjavascript进行通信的标准方式。 PdfTaskForm视图还可处理平面PDF,并清晰呈现。

NOTE
不建议修改PdfTaskForm视图的pdf.html/内容。

新HTMLForms new-html-forms

新的HTML表单由NewHTMLTaskForm视图呈现。

当使用在CRX上部署的移动设备表单包将XDP表单呈现为HTML时,它还会添加其他 FormBridge javascript转换到表单,这会公开不同的表单数据保存和提交方法。

此Javascript与上述PDF forms中引用的JavaScript不同,但其用途类似。

NOTE
不建议修改NewHTMLTaskForm视图的内容。

Flex Forms和指南 flex-forms-and-guides

Flex Forms由SwfTaskForm呈现,而参考线则由HtmlTaskForm视图呈现。

在AEM Forms工作区中,这些视图与构成Flex表单/指南的实际SWF通信,该SWF使用 /lc/libs/ws/libs/ws/WSNextAdapter.swf

通信使用 swfObject.postMessage / window.flexMessageHandler.

此协议由 WsNextAdapter.swf. 现有 flexMessageHandlers在窗口对象上,从之前打开的SWF表单中删除,然后再添加新表单。 该逻辑还考虑在任务详细信息视图中表单选项卡和历史记录选项卡之间进行切换。 WsNextAdapter.swf 用于执行保存或提交等各种表单操作。

NOTE
不建议修改 WSNextAdapter.swf 或SwfTaskForm / HtmlTaskForm视图的内容。

第三方应用程序(例如,通信管理) third-party-applications-for-example-correspondence-management

第三方应用程序使用ExtAppTaskForm视图呈现。

第三方应用程序在AEM Forms工作区通信中的应用

AEM Forms工作区侦听 window.global.postMessage([Message],[Payload])

[消息] 可以是指定为 SubmitMessage| CancelMessage| ErrorMessage| actionEnabledMessageruntimeMap. 第三方应用程序必须使用此界面来根据需要通知AEM Forms工作区。 必须使用此界面,因为AEM Forms工作区必须知道在提交任务时,该任务才能清理任务窗口。

AEM Forms工作区到第三方应用程序通信

如果AEM Forms工作区的直接操作按钮可见,则会调用 window.[External-App-Name].getMessage([Action]),其中 [Action]routeActionMap. 第三方应用程序必须监听此界面,然后通过 postMessage () API。

例如,Flex应用程序可以定义 ExternalInterface.addCallback('getMessage', listener) 支持此通信。 如果第三方应用程序希望通过其自己的按钮处理表单提交,则应指定 hideDirectActions = true() in the runtimeMap 你可以跳过这个监听器。 因此,此结构是可选的。

有关第三方应用程序集成与通信管理的更多信息,请访问 在AEM Forms工作区中集成通信管理.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da