在AEM Forms工作区中集成第三方应用程序 integrating-third-party-applications-in-aem-forms-workspace

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

管理员
用户
开发人员

AEM Forms工作区支持管理表单和文档的任务分配和完成活动。这些表单和文档可以是以XDP、PDF、HTML或Flex格式呈现的XDP Forms、Flex®表单或指南（已弃用）。

这些功能得到了进一步增强。 AEM Forms现在支持与第三方应用程序协作，这些应用程序支持类似于AEM Forms工作区的功能。此功能的共同部分是任务分配和后续审批的工作流。 AEM Forms为AEM Forms企业用户提供单一的统一体验，因此可通过AEM Forms工作区处理所支持应用程序的所有此类任务分配或批准。

例如，让我们将通信管理视为与AEM Forms工作区集成的示例候选项。通信管理具有“信件”的概念，可以渲染信件并允许执行操作。

创建相应的管理资源 create-correspondence-management-assets

首先，创建一个在AEM Forms工作区中呈现的示例通信管理模板。有关更多详细信息，请参阅创建书信模板。

访问其URL处的通信管理模板，以验证是否可以成功呈现通信管理模板。 URL具有类似于https://'[server]:[port]'/lc/content/cm/createcorrespondence.html?cmLetterId=encodedLetterId&cmUseTestData=1&cmPreview=0;的模式

其中encodedLetterId是URL编码的书信ID。在Workbench中为工作区任务定义渲染进程时，请指定相同的书信ID。

创建任务以在AEM Workspace中呈现和提交书信 create-a-task-to-render-and-submit-a-letter-in-aem-workspace

在执行这些步骤之前，请确保您是以下组的成员：

cm-agent-users
Workspace用户

有关详细信息，请参阅添加和配置用户。

使用以下步骤可创建任务以在AEM Workspace中呈现和提交书信：

启动Workbench 以管理员身份登录到localhost。
单击“文件”>“新建”>“应用程序”。在“应用程序名称”字段中，输入CMDemoSample，然后单击“完成”。
选择CMDemoSample/1.0并右键单击NewProcess。在名称字段中，输入CMRenderer，然后单击“完成”。
拖动起点活动选取器并对其进行配置：
1. 在演示文稿数据中，选择使用CRX资源。
2. 浏览资产。在选择表单资产对话框中，字母选项卡列出服务器上的所有字母。
3. 选择相应的书信，然后单击确定。
单击管理操作配置文件。此时将显示“管理操作配置文件”对话框。确保正确选择呈现进程和提交进程。
要打开带有数据XML文件的信件，请在“准备数据流程”中浏览并选择适当的数据文件。
单击“确定”。
定义起点输出和任务附件的变量。定义的变量包含“起始点输出”和“任务附件”数据。

（可选）要在工作流中添加其他用户，请拖动活动选取器并对其进行配置，然后将其分配给用户。编写自定义包装器（下面给出一个示例）或下载并安装DSC（下面给出一个示例）以提取信件模板、起点输出和任务附件。

下面列出了一个自定义包装器示例：

code language-javascript

code language-javascript
public LetterInstanceInfo getLetterInstanceInfo(Document dataXML) throws Exception { try { if(dataXML == null) throw new Exception("dataXML is missing"); CoreService coreService = getRemoteCoreService(); if (coreService == null) throw new Exception("Unable to retrive service. Please verify connection details."); Map<String, Object> result = coreService.getLetterInstanceInfo(IOUtils.toString(dataXML.getInputStream(), "UTF-8")); LetterInstanceInfo letterInstanceInfo = new LetterInstanceInfo(); List<Document> attachmentDocs = new ArrayList<Document>(); List<byte[]> attachments = (List<byte[]>)result.get(CoreService.ATTACHMENT_KEY); if (attachments != null){ for (byte[] attachment : attachments) { attachmentDocs.add(new Document(attachment)); } } letterInstanceInfo.setLetterAttachments(attachmentDocs); byte[] updateLayout = (byte[])result.get(CoreService.LAYOUT_TEMPLATE_KEY); if (updateLayout != null) { letterInstanceInfo.setLetterTemplate(new Document(updateLayout)); } else { throw new Exception("template bytes missing while getting Letter instance Info."); } return letterInstanceInfo; } catch (Exception e) { throw new Exception(e); } }

public LetterInstanceInfo getLetterInstanceInfo(Document dataXML) throws Exception {
try {
if(dataXML == null)
throw new Exception("dataXML is missing");

CoreService coreService = getRemoteCoreService();
if (coreService == null)
throw new Exception("Unable to retrive service. Please verify connection details.");
Map<String, Object> result = coreService.getLetterInstanceInfo(IOUtils.toString(dataXML.getInputStream(), "UTF-8"));
LetterInstanceInfo letterInstanceInfo = new LetterInstanceInfo();

List<Document> attachmentDocs = new ArrayList<Document>();
List<byte[]> attachments = (List<byte[]>)result.get(CoreService.ATTACHMENT_KEY);
if (attachments != null){
for (byte[] attachment : attachments)
{ attachmentDocs.add(new Document(attachment)); }

}
letterInstanceInfo.setLetterAttachments(attachmentDocs);

byte[] updateLayout = (byte[])result.get(CoreService.LAYOUT_TEMPLATE_KEY);
if (updateLayout != null)
{ letterInstanceInfo.setLetterTemplate(new Document(updateLayout)); }

else
{ throw new Exception("template bytes missing while getting Letter instance Info."); }

return letterInstanceInfo;
} catch (Exception e)
{ throw new Exception(e); }

}

获取文件
下载DSC：上面附加的DSCSample.zip文件中提供了示例DSC。下载并解压缩DSCSample.zip文件。在使用DSC服务之前，必须对其进行配置。请参阅配置DSC服务。

在“定义活动”对话框中，选择相应的活动（如getLetterInstanceInfo），然后单击确定。

部署应用程序。如果出现提示，请签入并保存资产。
登录到https://'[server]：[port]'/lc/content/ws上的AEM表单工作区。
打开您已添加的任务CMRenderer。此时将出现“通信管理”信件。

填写所需数据并提交信件。窗口关闭。在此流程中，任务被分配到步骤9的工作流中指定的用户。

note note
NOTE
在填写信件中的所有必需变量之前，不会启用提交按钮。

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2