Connecter AEM Forms à Adobe LiveCycle connecting-aem-forms-with-adobe-livecycle

Adobe Experience Manager (AEM) LiveCycle Connector permet un appel transparent d’Adobe LiveCycle ES4 Document Services à partir des applications web et des workflows d’AEM. LiveCycle fournit un SDK client enrichi, qui permet aux applications clientes de démarrer les services LiveCycle à l’aide d’API Java. AEM LiveCycle Connector simplifie l’utilisation de ces API dans l’environnement OSGi.

Connexion du serveur AEM à Adobe LiveCycle connecting-aem-server-to-adobe-livecycle

AEM LiveCycle Connector fait partie du package de module complémentaire AEM Forms. Après avoir installé le package de module complémentaire AEM Forms, procédez comme suit pour ajouter des détails du serveur LiveCycle à la console Web AEM.

Bien que les propriétés soient explicites, les plus importantes sont les suivantes :

Démarrage de Document Services starting-document-services

Les applications clientes peuvent démarrer des services LiveCycle par programmation en utilisant une API Java, des services Web, Remoting et REST. Pour les clients Java, l’application peut utiliser le SDK LiveCycle. Le SDK LiveCycle fournit une API Java pour démarrer ces services à distance. Par exemple, pour convertir un document Word Microsoft en PDF, le client lance GeneratePDFService. Le flux d’appel se compose des étapes suivantes :

AEM LiveCycle Connector simplifie le flux en exposant ces instances client en tant que services OSGi accessibles par des moyens OSGi standard. Le connecteur LiveCycle offre les fonctionnalités suivantes :

Démarrage via les références de service du registre de services OSGi starting-via-service-references-from-osgi-service-registry

Pour démarrer un service exposé depuis AEM, procédez comme suit :

Démarrage via ServiceClientFactory starting-via-serviceclientfactory

La classe ServiceClientFactory est requise dans certains cas. pour appeler des processus, par exemple.

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

@Reference
ServiceClientFactoryProvider scfProvider;

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

Prise en charge de RunAs runas-support

La plupart des services de document en LiveCycle nécessitent une authentification. Vous pouvez utiliser l’une des options suivantes pour démarrer ces services sans fournir d’informations d’identification explicites dans le code :

Configuration de la Liste autorisée allowlist-configuration

La configuration du SDK client LiveCycle contient un paramètre sur les noms de service. Il s’agit d’une liste de services pour lesquels la logique d’appel utilise des informations d’identification prêtes à l’emploi. Par exemple, si vous ajoutez des services DirectoryManager (qui font partie de l’API User Management) à cette liste, tout code client peut utiliser directement le service et la couche d’appel transmet automatiquement les informations d’identification configurées dans le cadre de la demande envoyée au serveur de LiveCycle.

RunAsManager runasmanager

Dans le cadre de l’intégration, un nouveau service RunAsManager est fourni. Il vous permet de contrôler par programmation les informations d’identification à utiliser lors d’un appel au serveur 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 vous souhaitez transmettre d’autres informations d’identification, vous pouvez utiliser la méthode surchargée qui prend une instance PasswordCredential.

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

Propriété InvocationRequest invocationrequest-property

Si vous appelez un processus ou utilisez directement la classe ServiceClientFactory et créez une InvocationRequest, vous pouvez spécifier une propriété pour indiquer que la couche d’appel doit utiliser des informations d’identification configurées.

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

Liste de Services de document document-services-list

Groupe d’API du SDK client Adobe LiveCycle adobe-livecycle-client-sdk-api-bundle

Les services suivants sont disponibles :

Dépendances Maven maven-dependencies

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

Groupe de SDK client Adobe LiveCycle adobe-livecycle-client-sdk-bundle

Les services suivants sont disponibles :

Dépendances Maven maven-dependencies-1

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

Groupe du client TaskManager Adobe LiveCycle adobe-livecycle-taskmanager-client-bundle

Les services suivants sont disponibles :

Dépendances Maven maven-dependencies-2

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

Groupe client Adobe LiveCycle Workflow adobe-livecycle-workflow-client-bundle

Le service suivant est disponible :

Dépendances Maven maven-dependencies-3

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

Groupe du client Adobe LiveCycle PDF Generator adobe-livecycle-pdf-generator-client-bundle

Le service suivant est disponible :

Dépendances Maven maven-dependencies-4

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

Groupe du client Adobe LiveCycle Application Manager adobe-livecycle-application-manager-client-bundle

Les services suivants sont disponibles :

Dépendances Maven maven-dependencies-5

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

Groupe du client Assembler Adobe LiveCycle adobe-livecycle-assembler-client-bundle

Le service suivant est disponible :

Dépendances Maven maven-dependencies-6

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

Groupe du client d’intégration de données de LiveCycle d’Adobe adobe-livecycle-form-data-integration-client-bundle

Le service suivant est disponible :

Dépendances Maven maven-dependencies-7

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

Groupe du client Adobe LiveCycle Forms adobe-livecycle-forms-client-bundle

Le service suivant est disponible :

Dépendances Maven maven-dependencies-8

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

Groupe du client Adobe LiveCycle Output adobe-livecycle-output-client-bundle

Le service suivant est disponible :

Dépendances Maven maven-dependencies-9

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

Groupe du client Adobe LiveCycle Reader Extensions adobe-livecycle-reader-extensions-client-bundle

Le service suivant est disponible :

Dépendances Maven maven-dependencies-10

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

Groupe du client Adobe LiveCycle Rights Manager adobe-livecycle-rights-manager-client-bundle

Les services suivants sont disponibles :

Dépendances Maven maven-dependencies-11

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

Groupe du client Adobe LiveCycle Signatures adobe-livecycle-signatures-client-bundle

Le service suivant est disponible :

Dépendances Maven maven-dependencies-12

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

Groupe du client Adobe LiveCycle Truststore adobe-livecycle-truststore-client-bundle

Les services suivants sont disponibles :

Dépendances Maven maven-dependencies-13

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

Groupe client du référentiel de LiveCycle Adobe adobe-livecycle-repository-client-bundle

Les services suivants sont disponibles :

Dépendances Maven maven-dependencies-14

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