将AEM Forms与AdobeLiveCycle

Adobe Experience Manager(AEM)LiveCycle连接器允许从AEM web应用程序和工作流中无缝调用AdobeLiveCycleES4 Document Services。 LiveCycle提供了富客户端SDK，该SDK允许客户端应用程序使用Java API启动LiveCycle服务。 AEMLiveCycle连接器在OSGi环境中使用这些API简化了操作。

将AEM服务器连接到AdobeLiveCycle

AEMLiveCycle连接器是AEM Forms附加组件包的一部分。 安装AEM Forms附加组件包后，请执行以下步骤，将LiveCycle服务器的详细信息添加到AEM Web Console。

1. 在AEM Web控制台配置管理器中，找到AdobeLiveCycle客户端SDK配置组件。
2. 单击组件可编辑配置服务器URL、用户名和密码。
3. 查看设置并单击​Save。

尽管这些属性不言自明，但重要属性如下：

• 服务器URL — 指定指向LiveCycle服务器的URL。如果希望LiveCycle和AEM通过https进行通信，请使用以下JVM启动AEM

  argument
   -Djavax.net.ssl.trustStore=<<em>path to LC keystore</em>>
  

  选项。

• 用户名 — 指定用于在AEM和LiveCycle之间建立通信的帐户的用户名。该帐户是具有启动Document Services权限的LiveCycle用户帐户。

• 密码 — 指定密码。

• 服务名称 — 指定使用“用户名”和“密码”字段中提供的用户凭据开始的服务。默认情况下，启动LiveCycle服务时不会传递凭据。

启动文档服务

客户端应用程序可以使用Java API、Web服务、远程处理和REST以编程方式启动LiveCycle服务。 对于Java客户端，应用程序可以使用LiveCycleSDK。 LiveCycleSDK提供了用于远程启动这些服务的Java API。 例如，要将Microsoft Word文档转换为PDF，客户端将启动GeneratePDFService。 调用流程包含以下步骤：

1. 创建ServiceClientFactory实例。
2. 每个服务都提供一个客户端类。 要启动服务，请创建服务的客户端实例。
3. 启动服务并处理结果。

AEMLiveCycle连接器将这些客户端实例公开为OSGi服务（可使用标准OSGi方式访问），从而简化了流程。 LiveCycle连接器提供以下功能：

• 作为OSGi服务的客户端实例：打包为OSGI包的客户端列在文档服务列表部分。 每个客户端jar在OSGi服务注册表中将客户端实例注册为OSGi服务。
• 用户凭据传播：连接到LiveCycle服务器所需的连接详细信息在中央位置进行管理。
• ServiceClientFactory服务：要启动进程，客户端应用程序可以访问ServiceClientFactory实例。

从OSGi服务注册表通过服务引用启动

要从AEM中启动公开的服务，请执行以下步骤：

1. 确定Maven依赖关系。 在maven pom.xml文件中，向所需的客户端jar添加依赖项。 至少应将依赖项添加到adobe-livecycle-client和adobe-usermanager-client Jar中。

   <dependency>
     <groupId>com.adobe.livecycle</groupId>
     <artifactId>adobe-livecycle-client</artifactId>
     <version>11.0.0</version>
   </dependency>
   <dependency>
     <groupId>com.adobe.livecycle</groupId>
     <artifactId>adobe-usermanager-client</artifactId>
     <version>11.0.0</version>
   </dependency>
   <dependency>
     <groupId>com.adobe.livecycle</groupId>
     <artifactId>adobe-cq-integration-api</artifactId>
     <version>11.0.0</version>
   </dependency>
   

   要启动服务，请为服务添加相应的Maven依赖项。 有关依赖项列表，请参阅文档服务列表。 例如，对于“生成PDF”服务，添加以下依赖项：

   <dependency>
     <groupId>com.adobe.livecycle</groupId>
     <artifactId>adobe-generatepdf-client</artifactId>
     <version>11.0.0</version>
   </dependency>
   

2. 获取服务引用。 获取服务实例的句柄。 如果您正在编写Java类，则可以使用声明性服务批注。

   import com.adobe.livecycle.generatepdf.client.GeneratePdfServiceClient;
   import com.adobe.livecycle.generatepdf.client.CreatePDFResult;
   import com.adobe.idp.Document;
   
   @Reference
   GeneratePdfServiceClient generatePDF;
   ...
   
   Resource r = resourceResolver.getResource("/path/tp/docx");
   Document sourceDoc = new Document(r.adaptTo(InputStream.class));
   CreatePDFResult result = generatePDF.createPDF2(
                       sourceDoc,
                       extension, //inputFileExtension
                       null, //fileTypeSettings
                       null, //pdfSettings
                       null, //securitySettings
                       settingsDoc, //settingsDoc
                       null //xmpDoc
               );
   

   以上代码片段将启动GeneratePdfServiceClient的createPDF API，以将文档转换为PDF。 您可以使用以下代码在JSP中执行类似的调用。 主要区别在于以下代码使用Sling ScriptHelper访问GeneratePdfServiceClient。

   <%@ page import="com.adobe.livecycle.generatepdf.client.GeneratePdfServiceClient" %>
   <%@ page import="com.adobe.livecycle.generatepdf.client.CreatePDFResult" %>
   <%@ page import="com.adobe.idp.Document" %>
   
   GeneratePdfServiceClient generatePDF = sling.getService(GeneratePdfServiceClient.class);
   Document sourceDoc = ...
   CreatePDFResult result = generatePDF.createPDF2(
                       sourceDoc,
                       extension, //inputFileExtension
                       null, //fileTypeSettings
                       null, //pdfSettings
                       null, //securitySettings
                       settingsDoc, //settingsDoc
                       null //xmpDoc
               );
   

通过ServiceClientFactory启动

在某些情况下， ServiceClientFactory类是必需的。 例如，您需要ServiceClientFactory才能调用进程。

import com.adobe.livecycle.dsc.clientsdk.ServiceClientFactoryProvider;
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory;

@Reference
ServiceClientFactoryProvider scfProvider;

...
ServiceClientFactory scf = scfProvider.getDefaultServiceClientFactory();
...

运行方式支持

LiveCycle中几乎每个文档服务都需要身份验证。 您可以使用以下任意选项来启动这些服务，而无需在代码中提供明确的凭据：

允许列表配置

LiveCycle客户端SDK配置包含有关服务名称的设置。 此配置是一个服务列表，调用逻辑会开箱即用地使用管理员凭据。 例如，如果将DirectoryManager服务（用户管理API的一部分）添加到此列表，则任何客户端代码都可以直接使用该服务，而调用层会自动将配置的凭据作为发送到LiveCycle服务器的请求的一部分传递

RunAsManager

作为集成的一部分，提供了新服务RunAsManager 。 它允许您以编程方式控制在调用LiveCycle服务器时使用的凭据。

import com.adobe.livecycle.dsc.clientsdk.security.PasswordCredential;
import com.adobe.livecycle.dsc.clientsdk.security.PrivilegedAction;
import com.adobe.livecycle.dsc.clientsdk.security.RunAsManager;
import com.adobe.idp.dsc.registry.component.ComponentRegistry;

@Reference
private RunAsManager runAsManager;

List<Component> components = runAsManager.doPrivileged(new PrivilegedAction<List<Component>>() {
            public List<Component> run() {
                return componentRegistry.getComponents();
            }
        });
assertNotNull(components);

如果要传递不同的凭据，可以使用采用PasswordCredential实例的重载方法。

PasswordCredential credential = new PasswordCredential("administrator","password");
List<Component> components = runAsManager.doPrivileged(new PrivilegedAction<List<Component>>() {
    public List<Component> run() {
        return componentRegistry.getComponents();
    }
},credential);

InvocationRequest属性

如果调用进程或直接使用ServiceClientFactory类并创建InvocationRequest，则可以指定一个属性以指示调用层应使用配置的凭据。

import com.adobe.idp.dsc.InvocationResponse
import com.adobe.idp.dsc.InvocationRequest
import com.adobe.livecycle.dsc.clientsdk.ServiceClientFactoryProvider
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory
import com.adobe.livecycle.dsc.clientsdk.InvocationProperties

ServiceClientFactoryProvider scfp = sling.getService(ServiceClientFactoryProvider.class)
ServiceClientFactory serviceClientFactory = scfp.getDefaultServiceClientFactory()
InvocationRequest ir = serviceClientFactory.createInvocationRequest("sample/LetterSubmissionProcess", "invoke", new HashMap(), true);

//Here we are invoking the request with system user
ir.setProperty(InvocationProperties.INVOKER_TYPE,InvocationProperties.INVOKER_TYPE_SYSTEM)

InvocationResponse response = serviceClientFactory.getServiceClient().invoke(ir);

文档服务列表

AdobeLiveCycle客户端SDK API包

提供以下服务：

• com.adobe.idp.um.api.AuthenticationManager
• com.adobe.idp.um.api.DirectoryManager
• com.adobe.idp.um.api.AuthorizationManager
• com.adobe.idp.dsc.registry.service.ServiceRegistry
• com.adobe.idp.dsc.registry.component.ComponentRegistry

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-livecycle-client</artifactId>
  <version>11.0.0</version>
</dependency>
<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-usermanager-client</artifactId>
  <version>11.0.0</version>
</dependency>

AdobeLiveCycle客户端SDK包

提供以下服务：

• com.adobe.livecycle.dsc.clientsdk.security.RunAsManager
• com.adobe.livecycle.dsc.clientsdk.ServiceClientFactoryProvider

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-livecycle-cq-integration-api</artifactId>
  <version>1.1.10</version>
</dependency>

AdobeLiveCycleTaskManager客户端包

提供以下服务：

• com.adobe.idp.taskmanager.dsc.client.task.TaskManager
• com.adobe.idp.taskmanager.dsc.client.TaskManagerQueryService
• com.adobe.idp.taskmanager.dsc.client.queuemanager.QueueManager
• com.adobe.idp.taskmanager.dsc.client.emailsettings.EmailSettingService
• com.adobe.idp.taskmanager.dsc.client.endpoint.TaskManagerEndpointClient
• com.adobe.idp.taskmanager.dsc.client.userlist.UserlistService

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-taskmanager-client</artifactId>
  <version>11.0.0</version>
</dependency>

AdobeLiveCycle Workflow客户端包

提供以下服务：

• com.adobe.idp.workflow.client.WorkflowServiceClient

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-workflow-client-sdk</artifactId>
  <version>11.0.0</version>
</dependency>

Adobe LiveCycle PDF Generator客户端包

提供以下服务：

• com.adobe.livecycle.generatepdf.client.GeneratePdfServiceClient

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-generatepdf-client</artifactId>
  <version>11.0.0</version>
</dependency>

AdobeLiveCycle应用程序管理器客户端包

提供以下服务：

• com.adobe.idp.applicationmanager.service.ApplicationManager
• com.adobe.livecycle.applicationmanager.client.ApplicationManager
• com.adobe.livecycle.design.service.DesigntimeService

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-applicationmanager-client-sdk</artifactId>
  <version>11.0.0</version>
</dependency>

AdobeLiveCycle汇编程序客户端包

提供以下服务：

• com.adobe.livecycle.assembler.client.AssemblerServiceClient

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-assembler-client</artifactId>
  <version>11.0.0</version>
</dependency>

AdobeLiveCycle表单数据集成客户端包

提供以下服务：

• com.adobe.livecycle.formdataintegration.client.FormDataIntegrationClient

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-formdataintegration-client</artifactId>
  <version>11.0.0</version>
</dependency>

Adobe LiveCycle Forms客户端包

提供以下服务：

• com.adobe.livecycle.formsservice.client.FormsServiceClient

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-forms-client</artifactId>
  <version>11.0.0</version>
</dependency>

Adobe LiveCycle Output客户端包

提供以下服务：

• com.adobe.livecycle.output.client.OutputClient

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-output-client</artifactId>
  <version>11.0.0</version>
</dependency>

Adobe LiveCycle Reader Extensions客户端包

提供以下服务：

• com.adobe.livecycle.readerextensions.client.ReaderExtensionsServiceClient

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-reader-extensions-client</artifactId>
  <version>11.0.0</version>
</dependency>

AdobeLiveCycle权限管理器客户端包

提供以下服务：

• com.adobe.livecycle.rightsmanagement.client.DocumentManager
• com.adobe.livecycle.rightsmanagement.client.EventManager
• com.adobe.livecycle.rightsmanagement.client.ExternalUserManager
• com.adobe.livecycle.rightsmanagement.client.LicenseManager
• com.adobe.livecycle.rightsmanagement.client.WatermarkManager
• com.adobe.livecycle.rightsmanagement.client.PolicyManager
• com.adobe.livecycle.rightsmanagement.client.AbstractPolicyManager

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-rightsmanagement-client</artifactId>
  <version>11.0.0</version>
</dependency>

AdobeLiveCycle签名客户端包

提供以下服务：

• com.adobe.livecycle.signatures.client.SignatureServiceClientInterface

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-signatures-client</artifactId>
  <version>11.0.0</version>
</dependency>

AdobeLiveCycleTruststore客户端包

提供以下服务：

• com.adobe.truststore.dsc.TrustConfigurationService
• com.adobe.truststore.dsc.CRLService
• com.adobe.truststore.dsc.CredentialService
• com.adobe.truststore.dsc.CertificateService

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-truststore-client</artifactId>
  <version>11.0.0</version>
</dependency>

AdobeLiveCycle存储库客户端包

提供以下服务：

• com.adobe.repository.bindings.ResourceRepository
• com.adobe.repository.bindings.ResourceSynchronizer

Maven依赖关系

<dependency>
  <groupId>com.adobe.livecycle</groupId>
  <artifactId>adobe-repository-client</artifactId>
  <version>11.0.0</version>
</dependency>