Collegamento di AEM Forms con Adobe LiveCycle

Il connettore di LiveCycle Adobe Experience Manager (AEM) consente di invocare facilmente i servizi Acrobat del LiveCycle Adobe ES4 dall’interno delle app web e dei flussi di lavoro dell’AEM. LiveCycle fornisce un SDK avanzato per client, che consente alle applicazioni client di avviare i servizi di LiveCycle utilizzando le API Java™. Il connettore di LiveCycle AEM semplifica l’utilizzo di queste API nell’ambiente OSGi.

Connessione del server AEM all'LiveCycle Adobe

Il connettore di LiveCycle AEM fa parte del Pacchetto del componente aggiuntivo AEM Forms. Dopo aver installato il pacchetto del componente aggiuntivo AEM Forms, effettuare le seguenti operazioni per aggiungere i dettagli del server di LiveCycle alla console Web AEM.

1. Nel gestore di configurazione della console web AEM, individua il componente di configurazione Adobe LiveCycle Client SDK.
2. Fai clic sul componente per modificare l’URL, il nome utente e la password del server di configurazione.
3. Rivedi le impostazioni e fai clic su Salva.

Anche se le proprietà sono auto-esplicative, quelle importanti sono le seguenti:

• URL server - Specifica l'URL del server di LiveCycle. Se desideri che il LiveCycle e l’AEM comunichino con https, inizia AEM con la seguente JVM

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

  opzione.

• Nome utente- Specifica il nome utente dell'account utilizzato per stabilire la comunicazione tra AEM e LiveCycle. L’account è un account utente di LiveCycle che dispone delle autorizzazioni per avviare Acrobat Services.

• Password- Specifica la password.

• Nome servizio - Specifica i servizi avviati utilizzando le credenziali utente fornite nei campi Nome utente e Password. Per impostazione predefinita, non vengono passate credenziali durante l'avvio dei servizi di LiveCycle.

Avvio dei servizi documentali

Le applicazioni client possono avviare in modo programmatico i servizi di LiveCycle utilizzando un'API Java™, i servizi Web, il Remoting e il REST. Per i client Java™, l’applicazione può utilizzare l’SDK di LiveCycle. L’SDK di LiveCycle fornisce un’API Java™ per avviare questi servizi in remoto. Ad esempio, per convertire un documento di Microsoft® Word in PDF, il client avvia GeneratePDFService. Il flusso di chiamata è costituito dai seguenti passaggi:

1. Creare un'istanza ServiceClientFactory.
2. Ogni servizio fornisce una classe client. Per avviare un servizio, crea un’istanza client del servizio.
3. Avvia il servizio ed elabora il risultato.

Il connettore di LiveCycle AEM semplifica il flusso esponendo queste istanze client come servizi OSGi a cui è possibile accedere utilizzando gli strumenti OSGi standard. Il connettore di LiveCycle offre le seguenti caratteristiche:

• Istanze client come servizio OSGi: i client inseriti come bundle OSGI sono elencati in Elenco servizi Acrobat sezione. Ogni file jar del client registra l’istanza client come servizio OSGi con il registro del servizio OSGi.
• Propagazione credenziali utente: i dettagli di connessione necessari per connettersi al server di LiveCycle vengono gestiti da una posizione centrale.
• ServiceClientFactory: per avviare i processi, l'applicazione client può accedere all'istanza ServiceClientFactory.

Avvio tramite riferimenti al servizio dal registro del servizio OSGi

Per avviare un servizio esposto dall’AEM, effettua le seguenti operazioni:

1. Determina le dipendenze Maven. Aggiungi la dipendenza al file jar client richiesto nel file pom.xml maven. Come minimo, aggiungi la dipendenza ai file jar adobe-livecycle-client e 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>
   

   Per avviare un servizio, aggiungi una dipendenza Maven corrispondente al servizio. Per l'elenco delle dipendenze, vedere Elenco servizi Acrobat. Ad esempio, per il servizio Genera PDF, aggiungi la seguente dipendenza:

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

2. Ottenere il riferimento del servizio. Ottieni un handle per l’istanza del servizio. Se si scrive una classe Java™, è possibile utilizzare le annotazioni Declarative Services.

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

   Lo snippet di codice riportato sopra avvia l’API createPDF di GeneratePdfServiceClient per convertire un documento in PDF. È possibile eseguire una chiamata simile in una JSP utilizzando il codice seguente. La differenza principale consiste nel fatto che il codice seguente utilizza Sling ScriptHelper per accedere 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
               );
   

Avvio tramite ServiceClientFactory

La classe ServiceClientFactory è a volte obbligatoria. Ad esempio, è necessario ServiceClientFactory per chiamare i processi.

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

@Reference
ServiceClientFactoryProvider scfProvider;

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

Supporto RunAs

Quasi tutti i servizi Acrobat nel LiveCycle richiedono l’autenticazione. Per avviare questi servizi senza fornire credenziali esplicite nel codice, puoi utilizzare una delle seguenti opzioni:

Configurazione del Inserisco nell'elenco Consentiti di

La configurazione dell’SDK del client di LiveCycle contiene un’impostazione relativa ai nomi dei servizi. Questa configurazione è un elenco di servizi per i quali la logica di chiamata utilizza credenziali di amministratore predefinite. Ad esempio, se si aggiungono i servizi DirectoryManager (parte dell'API User Management) a questo elenco, qualsiasi codice client può utilizzare direttamente il servizio. Inoltre, il livello di chiamata trasmette automaticamente le credenziali configurate come parte della richiesta inviata al server di LiveCycle.

RunAsManager

Come parte dell’integrazione, viene fornito un nuovo servizio RunAsManager. Consente di controllare a livello di programmazione una credenziale da utilizzare quando si chiama il server di 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);

Se si desidera passare una credenziale diversa, è possibile utilizzare il metodo di overload che accetta un'istanza 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, proprietà

Se si chiama un processo o si utilizza direttamente la classe ServiceClientFactory e si crea un oggetto InvocationRequest, è possibile specificare una proprietà per indicare che il livello di chiamata deve utilizzare credenziali configurate.

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

Elenco servizi Acrobat

Adobe bundle API Client SDK di LiveCycle

Sono disponibili i seguenti servizi:

• 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

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

Bundle SDK client Adobe LiveCycle

Sono disponibili i seguenti servizi:

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

Dipendenze Maven

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

Adobe LiveCycle TaskManager Pacchetto client

Sono disponibili i seguenti servizi:

• 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

Dipendenze Maven

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

Bundle client LiveCycle Workflow Adobe

È disponibile il seguente servizio:

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

Dipendenze Maven

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

Pacchetto client Adobe LiveCycle PDF Generator

È disponibile il seguente servizio:

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

Dipendenze Maven

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

Adobe LiveCycle di bundle client di Application Manager

Sono disponibili i seguenti servizi:

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

Dipendenze Maven

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

Adobe Assemblatore di LiveCycli Pacchetto client

È disponibile il seguente servizio:

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

Dipendenze Maven

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

Adobe di bundle client per l'integrazione dei dati di LiveCycle Form

È disponibile il seguente servizio:

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

Dipendenze Maven

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

Bundle client Adobe LiveCycle Forms

È disponibile il seguente servizio:

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

Dipendenze Maven

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

Bundle client Adobe LiveCycle Output

È disponibile il seguente servizio:

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

Dipendenze Maven

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

Pacchetto client Adobe LiveCycle Reader Extensions

È disponibile il seguente servizio:

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

Dipendenze Maven

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

Adobe bundle client di LiveCycle Rights Manager

Sono disponibili i seguenti servizi:

• 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

Dipendenze Maven

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

Adobe LiveCycle di firme bundle client

È disponibile il seguente servizio:

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

Dipendenze Maven

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

Adobe LiveCycle di pacchetti client Truststore

Sono disponibili i seguenti servizi:

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

Dipendenze Maven

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

Adobe LiveCycle Archivio Pacchetto client

Sono disponibili i seguenti servizi:

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

Dipendenze Maven

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