Conectar AEM Forms con Adobe LiveCycle

El conector de Adobe Experience Manager (AEM) LiveCycle permite la invocación fluida de los servicios de documentos de Adobe LiveCycle ES4 desde aplicaciones web y flujos de trabajo de AEM. LiveCycle proporciona un SDK de cliente enriquecido, que permite a las aplicaciones cliente iniciar servicios de LiveCycle mediante API de Java. El conector de AEM LiveCycle simplifica el uso de estas API dentro del entorno OSGi.

Conectar el servidor de AEM a Adobe LiveCycle

El conector de AEM LiveCycle forma parte del paquete de complementos de AEM Forms. Después de instalar el paquete de complementos de AEM Forms, realice los siguientes pasos para agregar detalles del servidor de LiveCycle a la consola web de AEM.

  1. En el administrador de configuración de la consola web de AEM, busque el componente de configuración del SDK del cliente de Adobe LiveCycle.
  2. Haga clic en el componente para editar la URL, el nombre de usuario y la contraseña del servidor de configuración.
  3. Revise la configuración y haga clic en Guardar.

Aunque las propiedades se explican por sí solas, las importantes son las siguientes:

  • URL del servidor: especifica la dirección URL del servidor de LiveCycle. Si desea que LiveCycle y AEM se comuniquen a través de https, inicie AEM con la siguiente opción de

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

    JVM.

  • Nombre de usuario: especifica el nombre de usuario de la cuenta que se utiliza para establecer la comunicación entre AEM y LiveCycle. La cuenta es una cuenta de usuario de LiveCycle que tiene los permisos para iniciar los servicios de documentos.

  • Contraseña: especifica la contraseña.

  • Nombre del servicio: especifica los servicios que se inician al utilizar las credenciales de usuario proporcionadas en los campos Nombre de usuario y Contraseña. De forma predeterminada, no se transfieren credenciales al iniciar los servicios de LiveCycle.

Iniciar los servicios de documentos

Las aplicaciones cliente pueden iniciar servicios de LiveCycle mediante programación al utilizar una API de Java, Servicios Web, Remoting y REST. Para clientes Java, la aplicación puede utilizar el SDK de LiveCycle. El SDK de LiveCycle proporciona una API de Java para iniciar estos servicios de forma remota. Por ejemplo, para convertir un documento de Microsoft Word en PDF, el cliente inicia GeneratePDFService. El flujo de invocación consta de los siguientes pasos:

  1. Crear una instancia de ServiceClientFactory.
  2. Cada servicio proporciona una clase cliente. Para iniciar un servicio, cree una instancia de cliente del servicio.
  3. Inicie el servicio y procese el resultado.

El conector de AEM LiveCycle simplifica el flujo al exponer estas instancias de cliente como servicios OSGi a los que se puede acceder mediante OSGi estándar. El conector de LiveCycle ofrece las siguientes características:

  • Instancias de cliente como el servicio OSGi: Los clientes empaquetados como paquetes OSGI se enumeran en la sección lista de servicios de documentos. Cada cliente jar registra la instancia del cliente como servicio OSGi con el registro de servicios OSGi.
  • Propagación de la credencial de usuario: los detalles de conexión necesarios para conectarse al servidor de LiveCycle se administran en un lugar central.
  • Servicio ServiceClientFactory: para iniciar los procesos, la aplicación cliente puede acceder a la instancia de ServiceClientFactory.

Iniciar mediante referencias de servicio desde el registro de servicios OSGi

Para iniciar un servicio expuesto desde AEM, realice los siguientes pasos:

  1. Determine las dependencias Maven. Agregue dependencia al cliente jar requerido en su archivo Maven pom.xml. Como mínimo, agregue dependencia a las jars adobe-livecycle-client y adobe-usermanager-client.

    <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>

    Para iniciar un servicio, agregue la dependencia Maven correspondiente al servicio. Para ver la lista de dependencias, consulte Lista de servicios de documentos. Por ejemplo, para el servicio Generar PDF agregue la siguiente dependencia:

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

  2. Obtenga la referencia del servicio. Obtenga un identificador para la instancia del servicio. Si está escribiendo una clase Java, puede utilizar las anotaciones de los servicios declarativos.

    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
            );

    El fragmento de código anterior inicia la API createPDF de GeneratePdfServiceClient para convertir un documento a PDF. Puede realizar una invocación similar en un JSP con el siguiente código. La diferencia principal es que el siguiente código utiliza Sling ScriptHelper para acceder a 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
            );

Iniciar mediante ServiceClientFactory

La clase ServiceClientFactory es necesaria en algunos casos. Por ejemplo, requiere ServiceClientFactory para llamar a procesos.

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

@Reference
ServiceClientFactoryProvider scfProvider;

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

Compatibilidad con RunAs

Casi todos los servicios de documentos de LiveCycle requieren autenticación. Puede utilizar cualquiera de las siguientes opciones para iniciar estos servicios sin proporcionar credenciales explícitas en el código:

Configuración de lista de permitidos

La configuración del SDK del cliente de LiveCycle contiene una configuración sobre los nombres del servicio. Esta configuración es una lista de servicios para los que la lógica de invocación utiliza credenciales de administrador listas para usar. Por ejemplo, si agrega los servicios de DirectoryManager (parte de la API de administración de usuarios) a esta lista, cualquier código de cliente puede utilizar directamente el servicio y la capa de invocación pasa automáticamente las credenciales configuradas como parte de la solicitud enviada al servidor de LiveCycle

RunAsManager

Como parte de la integración, se proporciona un servicio RunAsManager nuevo. Permite controlar mediante programación las credenciales que se utilizarán al realizar llamadas al servidor de 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);

Si desea aprobar credenciales diferentes, puede utilizar el método de sobrecarga que toma una instancia de PasswordCredential.

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

Propiedad InvocationRequest

Si llama a un proceso o utiliza directamente la clase ServiceClientFactory y crea una InvocationRequest, puede especificar una propiedad para indicar que la capa de invocación debe utilizar credenciales configuradas.

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);

Lista de servicios de documentos

Paquete de API del SDK del cliente de Adobe LiveCycle

Los siguientes servicios están disponibles:

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

Dependencias 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>

Paquete de SDK de cliente de Adobe LiveCycle

Los siguientes servicios están disponibles:

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

Dependencias Maven

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

Paquete de cliente de Adobe LiveCycle TaskManager

Los siguientes servicios están disponibles:

  • 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

Dependencias Maven

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

Paquete de cliente del flujo de trabajo de AdobeLiveCycle

El siguiente servicio está disponible:

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

Dependencias Maven

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

Paquete de cliente del Adobe LiveCycle PDF Generator

El siguiente servicio está disponible:

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

Dependencias Maven

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

Paquete de cliente de administrador de aplicaciones de Adobe LiveCycle

Los siguientes servicios están disponibles:

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

Dependencias Maven

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

Paquete de cliente de Adobe LiveCycle Assembler

El siguiente servicio está disponible:

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

Dependencias Maven

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

Paquete de cliente de integración de datos de formulario de Adobe LiveCycle

El siguiente servicio está disponible:

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

Dependencias Maven

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

Paquete de cliente de Forms de Adobe LiveCycle

El siguiente servicio está disponible:

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

Dependencias Maven

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

Paquete de cliente de Output de Adobe LiveCycle

El siguiente servicio está disponible:

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

Dependencias Maven

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

Paquete de cliente de Adobe LiveCycle Reader Extensions

El siguiente servicio está disponible:

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

Dependencias Maven

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

Paquete de cliente de administrador de derechos de Adobe LiveCycle

Los siguientes servicios están disponibles:

  • 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

Dependencias Maven

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

Paquete de cliente de firmas de Adobe LiveCycle

El siguiente servicio está disponible:

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

Dependencias Maven

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

Paquete de cliente de Truststore de Adobe LiveCycle

Los siguientes servicios están disponibles:

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

Dependencias Maven

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

Paquete de cliente del repositorio de Adobe LiveCycle

Los siguientes servicios están disponibles:

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

Dependencias Maven

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

En esta página