Intégration LiveCycle Production Print ES2 et LiveCycle ES2. Adobe LiveCycle Production Print ES2
Intégration LiveCycle Production
Print ES2 et LiveCycle ES2
Accès de StreamServe Design Center au référentiel LiveCycle ES2
Il est possible de connecter StreamServe Design Center à un référentiel LiveCycle
ES2, ce qui permet d'utiliser des modèles et d'autres ressources associées avec
LiveCycle Production Print ES2 sans avoir à les importer via le système de fichiers. Les modèles et les fichiers associés sont importés du référentiel
LiveCycle ES2 vers un jeu de ressources dans le Projet Design Center.
Appel des applications LiveCycle Production Print ES2 par
LiveCycle ES2
LiveCycle ES2 peut appeler des applications StreamServer qui sont exposées via des services Web. Ces services Web peuvent être utilisés pour intégrer des applications StreamServer à des processus LiveCycle ES2 lors du traitement de documents.
Appel des processus LiveCycle par LiveCycle Production Print ES2
StreamServer peut appeler des processus LiveCycle qui sont déployés dans
LiveCycle ES2 et exposés par le biais de services Web. Ces services Web peuvent
être utilisés pour intégrer les processus LiveCycle dans le pipeline StreamServer lors du traitement de documents.
Dans ce chapitre :
•
Accès au référentiel Adobe LiveCycle ES2
•
Appel de LiveCycle Production Print ES2 à partir de LiveCycle ES2
•
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print
31
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
32
Accès au référentiel Adobe LiveCycle ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
Accès au référentiel Adobe LiveCycle ES2
Il est possible d'importer des modèles et les fichiers associés du référentiel
LiveCycle ES2 vers Design Center et de les stocker en tant que jeux de ressources.
Lorsque vous accédez au référentiel LiveCycle ES2 à partir de Design Center, vous pouvez effectuer les opérations suivantes :
• Naviguer dans le référentiel LiveCycle. Le navigateur affiche les informations suivantes :
– Si la ressource existe déjà en local dans le jeu de ressources Design
Center.
– Si elle a été mise à jour dans le référentiel et si elle doit l'être en local dans le jeu de ressources Design Center.
– Si elle a été mise à jour en local dans le jeu de ressources Design
Center.
– Si elle a été retirée du référentiel.
Icônes utilisées dans le référentiel LiveCycle ES2
• Importer des ressources et leurs dépendances à partir du référentiel
LiveCycle ES2.
• Mettre à jour des ressources déjà importées à partir du référentiel LiveCycle
ES2.
Vous ne pouvez modifier aucune donnée dans le référentiel LiveCycle ES2 lorsque vous y accédez à partir de Design Center. Vous ne disposez que d'un accès en lecture seule.
Note :
Vous pouvez définir des connexions à plusieurs référentiels, mais vous ne pouvez créer et mettre à jour des ressources qu'à partir d'un seul référentiel
à la fois.
Connexion aux référentiels LiveCycle
Vous pouvez définir et activer les connexions à un référentiel LiveCycle ES2 à partir de Design Center. Vous ne pouvez activer qu'une seule connexion à la fois.
Celle-ci ne sera active que pendant la communication (pendant l'importation et la mise à jour).
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Accès au référentiel Adobe LiveCycle ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
33
Sélectionnez
Outils > Sélectionner une connexion au référentiel Adobe
LiveCycle
. La boîte de dialogue Sélection d'une connexion active au référentiel
Adobe LiveCycle s'ouvre (voir
Boîte de dialogue Sélection d'une connexion active au référentiel Adobe LiveCycle
Figure 1 Boîte de dialogue Sélection d'une connexion active au référentiel
Adobe LiveCycle
Pour activer une connexion
Cochez la case requise pour activer la connexion. La connexion sélectionnée sera activée lorsque ce sera nécessaire (c'est-à-dire pendant l'importation et la mise à jour à partir du référentiel).
Pour ajouter/modifier une connexion
1
Cliquez sur
Ajouter
ou
Editer
. La boîte de dialogue Edition de la connexion au référentiel Adobe LiveCycle s'ouvre.
2
Définissez les paramètres.
–
Nom de la connexion
– Choisissez un nom approprié pour la connexion.
–
Hôte
– Nom d'hôte ou adresse IP du serveur sur lequel le référentiel est installé.
–
Port
– Port utilisé pour communiquer avec l'hôte.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
34
Accès au référentiel Adobe LiveCycle ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
3
Cliquez sur
OK
. La connexion doit exister et être disponible ; lorsque la connexion est ajoutée, elle est établie et identifiée. Si elle n'existe pas, un message d'erreur s'affiche.
Pour supprimer une connexion
1
Sélectionnez la connexion (en surbrillance) à supprimer.
2
Cliquez sur
Supprimer
.
Pour tester une connexion
Vous pouvez tester une connexion à un référentiel Adobe LiveCycle pour vérifier si elle fonctionne.
1
Sélectionnez la connexion (en surbrillance) à tester.
2
Cliquez sur
Test
. Vous êtes invité à saisir vos identifiants de connexion.
3
Entrez vos identifiants et cliquez sur
OK
.
Importation d'une ressource à partir du référentiel
Adobe LiveCycle ES2
Lorsque vous importez une ressource du référentiel LiveCycle ES2, le système crée une copie locale de la ressource dans le jeu de ressources Design Center.
La ressource est ajoutée dans une structure de chemins et de fichiers qui reflète la structure dans le référentiel LiveCycle ES2.
Note :
Ne modifiez pas la structure dans le jeu de ressources Design Center. Les références aux fragments et aux images peuvent être endommagées en cas de modification des positions relatives internes.
Vous pouvez choisir d'importer une ressource avec ou sans dépendances.
Pour importer une ressource
1
Sélectionnez
Ressources > Importer du référentiel Adobe LiveCycle
. La boîte de dialogue Sélectionner une ressource s'ouvre.
2
Accédez à la ressource à importez et double-cliquez dessus. La boîte de dialogue Importation d'une ressource du référentiel Adobe LiveCycle s'ouvre (voir
Boîte de dialogue Importation d'une ressource du référentiel
L'option
Toujours extraire la version principale de toutes les ressources
est activée par défaut. Cela signifie que la dernière version de la ressource et ses dépendances seront importées.
3
Si vous voulez importer une autre version que la version principale, décochez la case et sélectionnez une version dans la liste déroulante.
4
Sélectionnez la ressource et les dépendances à importer et cliquez sur
OK
.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Accès au référentiel Adobe LiveCycle ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
35
Mise à jour des ressources à partir du référentiel Adobe
LiveCycle ES2
Pour mettre à jour une ressource et ses dépendances
Si la ressource d'origine (dans le référentiel LiveCycle ES2) a été modifiée, vous pouvez mettre à jour la copie locale dans le jeu de ressources Design Center.
1
Cliquez avec le bouton droit de la souris sur la ressource dans la vue Jeu de ressources et sélectionnez
Mettre à jour selon la source
. La boîte de dialogue Mise à jour de toutes les ressources du référentiel Adobe
Boîte de dialogue Mise à jour de toutes les ressources du référentiel Adobe LiveCycle
ressource locale et de ses dépendances par rapport à la ressource du
Icônes utilisées dans le référentiel LiveCycle ES2
2
Sélectionnez la ressource et les dépendances à importer.
3
Cliquez sur
OK
. La ressource et les dépendances sélectionnées seront enregistrées dans la même structure de chemins et de fichiers que dans le référentiel Adobe LiveCycle.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
36
Accès au référentiel Adobe LiveCycle ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
Pour mettre à jour plusieurs ressources
Lorsqu'un grand nombre de ressources ont été modifiées dans le référentiel
LiveCycle ES2, vous pouvez mettre à jour plusieurs ressources en une seule fois.
1
Sélectionnez
Ressources > Mettre à jour toutes les ressources Adobe
LiveCycle
. La boîte de dialogue Mise à jour de toutes les ressources du référentiel Adobe LiveCycle s'ouvre (voir
Boîte de dialogue Mise à jour de toutes les ressources du référentiel Adobe LiveCycle
) et affiche la ressource importée ainsi que son état par rapport aux ressources du référentiel. Voir
Icônes utilisées dans le référentiel LiveCycle ES2
Note :
Les dépendances ne sont pas mises à jour lorsque vous utilisez la commande
Mettre à jour toutes les ressources Adobe LiveCycle
.
2
Sélectionnez les ressources à mettre à jour en cochant les cases correspondantes ou en cochant
Sélectionner tout.
3
Cliquez sur
OK
. Les ressources sélectionnées seront enregistrées dans la même structure de chemins et de fichiers que dans le référentiel LiveCycle
ES2.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Appel de LiveCycle Production Print ES2 à partir de LiveCycle ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
37
Appel de LiveCycle Production Print ES2 à partir de LiveCycle ES2
LiveCycle ES2 peut appeler des applications StreamServer qui sont exposées via des services Web. Ces services Web peuvent être utilisés pour intégrer des applications StreamServer à des processus LiveCycle ES2 lors du traitement de documents.
Données d'entrée et de sortie
Le service StreamServer est entièrement générique. Il est possible d'envoyer n'importe quel type de données à StreamServer, par exemple, un fichier de données XML à fusionner avec un modèle de formulaire.
Le résultat obtenu par StreamServer est également générique. Il peut s'agir aussi bien d'un fichier d'impression que d'un message d'état, selon la configuration
StreamServer.
Composant DSC (Document Service Component) utilisé pour l'intégration
Le composant DSC (Document Service Component) appelé LiveCycle
Production Print DSC est développé dans ce but. Il peut être utilisé dans n'importe quel processus LiveCycle ES2 pour le transfert de données vers et depuis
StreamServer.
LiveCycle Production Print DSC est fourni sous la forme d'un fichier .jar
( lcppdsc.jar
) sur le support d'installation. Il peut être déployé dans LiveCycle
ES2 par le biais de l'outil Workbench.
Connecteurs StreamServer utilisés pour l'intégration
Les services Web sont exposés par StreamServer via des connecteurs d'entrée
Service Request. StreamServer reçoit le job de LiveCycle ES2 via le connecteur
Service Request et peut renvoyer les données de sortie traitées à LiveCycle ES2 via n'importe quel connecteur de sortie.
Passerelle de services
Une passerelle de services doit être active. Elle gère les appels de service Web entre LiveCycle ES2 et StreamServer.
Projet exemple
Un Projet Design Center, sampleproject.dcpackage
, est fourni sur le support d'installation. Ce Projet donne un exemple d'utilisation de ce type : il comprend le processus LiveCycle ES2 ainsi que LiveCycle Production Print. Il est recommandé d'étudier et de tester ce Projet exemple. Nous vous conseillons
également de prendre modèle sur ce Projet exemple pour développer vos propres
à la page 57 pour plus d'informations sur
le Projet exemple.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
38
Appel de LiveCycle Production Print ES2 à partir de LiveCycle ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
Caractéristiques de LiveCycle Production Print DSC
Le service LiveCycle Production Print ES2 Workbench a trois fonctions :
•
– Envoi d'un job de LiveCycle ES2 à StreamServer. Aucune information d'état n'est renvoyée.
•
– Envoi d'un job de LiveCycle ES2 à StreamServer. Des informations
d'état sont renvoyées lorsque le job de sortie de StreamServer est terminé.
•
– Envoi d'un job de LiveCycle ES2 à StreamServer pour traitement et réception du job traité et des informations d'état sous forme de réponse émanant de StreamServer.
Post
Utilisez cette fonction si vous voulez seulement que LiveCycle ES2 envoie un job
à StreamServer pour traitement ultérieur et dans le cas où aucune information d'état n'est requise une fois le job de sortie de StreamServer terminé.
Paramètres
Les paramètres ci-dessous s'appliquent à cette fonction.
Paramètre
Remote
Endpoint
Type et sous-type
Type
: chaîne
Description
Adresse de la passerelle de services. Par exemple : http://localhost:2718
Remote Service
Name
Connection
Timeout
Type
: chaîne
Type
: nombre entier
Nom (sensible à la casse) du service
StreamServer à appeler. Il doit être absolument identique au
Nom de service
du connecteur d'entrée Service Request utilisé par StreamServer
Création d'un connecteur d'entrée Service Request
Délai maximum (en secondes) d'attente de
StreamServer pour la récupération du job. Un délai <=0 signifie pas de temporisation.
Input Data
Template
Type
Type
: document
: document
Additional Input
Parameters
Type
: liste
Sous-type
: paramètre d'entrée
Job (document, cycle de traitement par lot, etc.) et type de contenu du job que StreamServer doit traiter.
Modèle XDP que StreamServer doit utiliser lorsqu'il traite le job.
Variables à communiquer à StreamServer.
StreamServer doit utiliser la fonction de script
GetConnectorValue
pour accéder à ces variables.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Appel de LiveCycle Production Print ES2 à partir de LiveCycle ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
39
Run
Utilisez cette fonction si vous voulez seulement que LiveCycle ES2 envoie un job
à StreamServer pour traitement ultérieur et si vous voulez que StreamServer renvoie les informations d'état une fois le job de sortie terminé.
Paramètres
Les paramètres ci-dessous s'appliquent à cette fonction.
Paramètre
Remote
Endpoint
Type et sous-type
Type
: chaîne
Description
Adresse de la passerelle de services. Par exemple : http://localhost:2718
Remote Service
Name
Type
: chaîne Nom (sensible à la casse) du service
StreamServer à appeler. Il doit être absolument identique au
Nom de service
du connecteur d'entrée Service Request utilisé par StreamServer
Création d'un connecteur d'entrée Service Request
Connection
Timeout
Input Data
Type
Type
: nombre entier
: document
Délai maximum (en secondes) d'attente d'une réponse de StreamServer. Si le délai de temporisation est écoulé lorsque StreamServer traite le job, ce dernier n'est pas supprimé de la base de données File d'attente. Un délai <=0 signifie pas de temporisation.
Job (document, cycle de traitement par lot, etc.) et type de contenu du job que StreamServer doit traiter.
Template
Type
: document Modèle XDP que StreamServer doit utiliser lorsqu'il traite le job.
Additional Input
Parameters
Type
: liste
Sous-type
: paramètre d'entrée
Variables à communiquer à StreamServer.
StreamServer doit utiliser la fonction de script
GetConnectorValue
pour accéder à ces variables.
Returned Status and Documents
Type
: état du résultat et document(s)
Etat et documents renvoyés par StreamServer.
Paramètres secondaires relatifs à l'état et aux documents renvoyés statusCode
Type
: nombre entier Code d'état renvoyé par StreamServer.
0 : OK
1 : Avertissement
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
40
Appel de LiveCycle Production Print ES2 à partir de LiveCycle ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
Paramètre Type et sous-type statusMessage
Type
: chaîne
Description
Informations complémentaires relatives à l'état.
Contient des informations détaillées sur le code d'état renvoyé par StreamServer.
Generate
Utilisez cette fonction si vous voulez que LiveCycle ES2 envoie un job à
StreamServer pour traitement et récupère ensuite le job traité sous forme de réponse de StreamServer.
Paramètres
Les paramètres ci-dessous s'appliquent à cette fonction.
Paramètre
Remote
Endpoint
Type et sous-type
Type
: chaîne
Description
Adresse de la passerelle de services. Par exemple : http://localhost:2718
Remote Service
Name
Connection
Timeout
Input Data
Template
Type
: chaîne
Type
Type
Type
: nombre entier
: document
: document
Nom (sensible à la casse) du service
StreamServer à appeler. Il doit être absolument identique au
Nom de service
du connecteur d'entrée Service Request utilisé par StreamServer
Création d'un connecteur d'entrée Service Request
Délai maximum (en secondes) d'attente d'une réponse de StreamServer. Si le délai de temporisation est écoulé lorsque StreamServer traite le job, ce dernier n'est pas supprimé de la base de données File d'attente. Un délai <=0 signifie pas de temporisation.
Job (document, cycle de traitement par lot, etc.) et type de contenu du job que StreamServer doit traiter.
Modèle XDP que StreamServer doit utiliser lorsqu'il traite le job.
Additional Input
Parameters
Type
: liste
Sous-type
: paramètre d'entrée
Variables à communiquer à StreamServer.
StreamServer doit utiliser la fonction de script
GetConnectorValue
pour accéder à ces variables.
Returned Status and Documents
Type
: état du résultat et document(s)
Etat et documents renvoyés par StreamServer.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Appel de LiveCycle Production Print ES2 à partir de LiveCycle ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
41
Paramètre Type et sous-type Description
Paramètres secondaires relatifs à l'état et aux documents renvoyés statusCode
Type
: nombre entier Code d'état renvoyé par StreamServer.
0 : OK
1 : Avertissement
statusMessage
Type
: chaîne
documents
Type
: liste
Sous-type
: document
Informations complémentaires relatives à l'état.
Contient des informations détaillées sur le code d'état renvoyé par StreamServer.
Job, et type de contenu du job, renvoyé par
StreamServer.
Gestion des erreurs
En cas d'erreur, l'exception
ProductionPrintException
est déclenchée. Les codes d'erreur sont décrits dans le tableau ci-dessous.
Code Description
-1
Erreur du serveur de service.
Il s'agit d'une erreur qui ne peut pas être corrigée sur le client simplement en effectuant une nouvelle tentative. Par exemple : mémoire ou espace disque insuffisant sur le serveur.
-2
-3
-4
-5
Erreur du client.
Il s'agit d'une erreur qui peut être corrigée sur le client. Par exemple : nom de service non valable ou temporisation trop courte.
Erreur d'appel.
Une enveloppe SOAP non valable a été envoyée au service Web.
Erreur d'un périphérique distant.
Par exemple : panne de réseau ou terminal spécifié non valable.
Erreur de données de sortie.
Le client n'a pas pu recevoir les données de sortie du serveur.
-6
-7
Erreur d'adressage.
Un terminal non valable a été spécifié pour le service Web.
Erreur d'entrée/sortie locale.
Erreur d'entrée/sortie du composant DSC. Par exemple : espace disque insuffisant sur l'hôte DSC.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
42
Appel de LiveCycle Production Print ES2 à partir de LiveCycle ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
Code Description
-8 Erreur DSC générique.
Le message d'erreur de l'exception contient de plus amples détails.
Configuration StreamServer
La configuration StreamServer inclut un connecteur d'entrée Service Request et l'Evénement, le Processus, le connecteur de sortie et les files d'attente appropriés.
Connecteur d'entrée Service Request
Ce connecteur expose le service Web dans LiveCycle ES2 et y récupère le job.
Evénement et Processus
L'Evénement et les Processus sont configurés selon les procédures Design Center standard.
Connecteur de sortie
Dans un scénario dans lequel StreamServer génère la sortie finale, le connecteur de sortie est configuré selon les procédures Design Center standard.
Dans un scénario dans lequel LiveCycle ES2 génère la sortie finale, le connecteur de sortie doit également être configuré pour renvoyer le job dans la réponse du service Web.
Files d'attente
Les connecteurs d'entrée et de sortie doivent être connectés à des files d'attente.
Création d'un connecteur d'entrée Service Request
Vous créez un connecteur d'entrée Service Request de la même façon que vous créez d'autres connecteurs d'entrée dans Design Center.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Appel de LiveCycle Production Print ES2 à partir de LiveCycle ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
43
Paramètres du connecteur
Paramètre
Type de requête
Nom du service
Description
Sélectionnez
Générique
.
Nom du service Web à exposer dans
LiveCycle ES2.
Activation d'une réponse de service
Dans un scénario dans lequel LiveCycle ES2 génère la sortie finale, StreamServer doit être configuré pour renvoyer sa sortie à LiveCycle ES2 dans la réponse du service Web. Cette opération s'effectue dans la configuration du connecteur de sortie. Il est possible d'utiliser n'importe quel type de connecteur de sortie, par exemple un connecteur Null.
Note :
Le connecteur de sortie doit être connecté à une file d'attente de sortie.
Pour activer la réponse de service
1
Dans Design Center, activez la couche de Plate-forme générique.
2
Double-cliquez sur le connecteur de sortie. La boîte de dialogue Paramètres de connecteur de sortie s'ouvre.
3
Cliquez sur l'icône
Général
, sélectionnez
Inclure le résultat dans la réponse de service
, puis cliquez sur
OK
.
Récupération des variables
S'il existe des variables dans la requête de service de LiveCycle ES2,
StreamServer doit utiliser la fonction de script
GetConnectorValue
pour récupérer ces variables. Voir le manuel StreamServe Scripting reference pour plus d'informations sur cette fonction de script.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
44
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
StreamServer peut appeler des processus LiveCycle qui sont déployés dans
LiveCycle ES2 et exposés par le biais de services Web. Ces services Web peuvent
être utilisés pour intégrer les processus LiveCycle dans le pipeline StreamServer lors du traitement de documents.
Vous pouvez appeler les processus créés et activés via LiveCycle Workbench
ES2 en envoyant la requête d'appel appropriée (requête SOAP) à LiveCycle ES2.
Filtre LiveCycle et connecteur de sortie LiveCycle
Il existe deux façons d'appeler des requêtes de StreamServer vers LiveCycle ES2 :
• Connecteur de sortie LiveCycle – utilisé lorsque LiveCycle ES2 génère la sortie finale. Voir
Connecteur de sortie LiveCycle
• Filtre LiveCycle – utilisé lorsque StreamServer génère la sortie finale. Voir
Projet exemple
Un Projet Design Center, sampleproject.dcpackage
, est fourni sur le support d'installation. Ce Projet donne un exemple d'utilisation de ce type : il comprend le processus LiveCycle ES2 ainsi que LiveCycle Production Print. Il est recommandé d'étudier et de tester ce Projet exemple. Nous vous conseillons
également de prendre modèle sur ce Projet exemple pour développer vos propres
à la page 57 pour plus d'informations sur
le Projet exemple.
Connecteur de sortie LiveCycle
Le connecteur de sortie LiveCycle est utilisé lorsque LiveCycle ES2 génère la sortie finale.
Exemple – Utilisation du connecteur de sortie LiveCycle
1
StreamServer reçoit les données d'entrée via un connecteur d'entrée.
2
StreamServer utilise la configuration Evénement/Processus appropriée pour créer des documents.
3
Le connecteur de sortie LiveCycle appelle le processus LiveCycle ES2 approprié et envoie les documents dans la requête.
4
Le processus LiveCycle ES2 traite les documents et génère la sortie finale.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
45
Création d'un processus LiveCycle ES2 activé par un connecteur de sortie
Vous créez et activez le processus selon la procédure décrite dans la documentation de LiveCycle Workbench ES2. Pour activer le connecteur de sortie LiveCycle afin d'appeler le service déployé, vous devez ajouter les variables d'entrée suivantes au processus LiveCycle.
Nom de la variable
inputDoc optionsMap
Type Commentaire
document map
Obligatoire
Facultatif. Est utilisée si des clés personnalisées sont spécifiées dans les paramètres du filtre LiveCycle.
Seuls les processus LiveCycle qui suivent cette interface peuvent être appelés par un connecteur de sortie LiveCycle.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
46
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
Création d'un connecteur de sortie LiveCycle
Vous créez un connecteur de sortie LiveCycle de la même façon que vous créez d'autres connecteurs de sortie dans Design Center.
Paramètres du connecteur
Paramètre
Hôte
Port
Nom du service Web
Nom d'utilisateur
Description
Nom d'hôte ou adresse IP du serveur qui héberge LiveCycle ES2. Par exemple : localhost
Port utilisé par le serveur LiveCycle ES2. Par exemple :
8080
Nom (sensible à la casse) du service à appeler.
Ce nom doit être identique au nom du processus correspondant créé dans LiveCycle
Workbench ES2.
Nom d'utilisateur permettant de se connecter au serveur hébergeant LiveCycle ES2.
Ce paramètre est utilisé dans le cas de l'authentification HTTP de base.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
47
Paramètre
Mot de passe
Activer la communication asynchrone
Intervalle d'interrogation asynchrone
Certificat racine pour la communication SSL
Options personnalisées
Description
Mot de passe permettant de se connecter au serveur hébergeant LiveCycle ES2.
Ce paramètre est utilisé dans le cas de l'authentification HTTP de base.
Oui
Effectue des appels asynchrones au service.
Cette option est utilisée lorsque vous appelez des services LiveCycle sur une longue durée.
Non
Effectue des appels synchrones au service.
Cette option est utilisée lorsque vous appelez des services LiveCycle sur une courte durée.
Ce paramètre n'est utilisé qu'avec les appels asynchrones. Il s'agit de l'intervalle (en millisecondes) utilisé pour vérifier la réponse
à la requête d'appel.
Certificat racine employé lorsque le protocole
HTTPS est utilisé comme protocole de service
Web (communication sécurisée). Ce certificat doit être disponible à partir d'un jeu de ressources connecté à la Plate-forme.
Liste de clés personnalisées (paires valeurs/ clés) à ajouter dans la requête d'appel.
Pour pouvoir gérer les clés personnalisées, le service doit disposer d'une variable nommée optionsMap
du type map
. Toutes les clés personnalisées définies ici seront ajoutées à la variable optionsMap
dans le service appelé.
Les valeurs générées peuvent être extraites dans le processus LiveCycle destinataire à l'aide d'une expression XPath dans le processus LiveCycle.
Les mots de passe requis pour créer des fichiers PDF protégés par mot de passe sont des exemples de clés personnalisées. Par exemple :
Clé :
pdfpassword
Valeur :
encrypted
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
48
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
Exemple d'utilisation
Besoin
Un processus de gestion nécessite qu'un fichier AFP de factures soit converti au format PDF, puis envoyé à LiveCycle ES2 pour être enregistré dans LiveCycle
Content Services ES2.
Actions
StreamServer est ajouté au pipeline. StreamServer récupère les données d'entrée
AFP via un connecteur d'entrée, un filtre AFPIN et un Evénement PreformatIN.
Les données AFP sont ensuite converties en données PDF via un Processus
PageOUT et un pilote PDF. La sortie PDF est finalement envoyée à un processus
LiveCycle via un connecteur de sortie LiveCycle.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
49
Filtre LiveCycle
Le filtre LiveCycle est utilisé lorsque StreamServer génère la sortie finale.
Exemple – Utilisation du filtre LiveCycle
1
StreamServer reçoit les données d'entrée via un connecteur d'entrée.
2
StreamServer utilise la configuration Evénement/Processus appropriée pour créer des documents.
3
Le filtre LiveCycle appelle le processus LiveCycle ES2 approprié et envoie les documents dans la requête.
4
Le processus LiveCycle ES2 traite les documents et envoie les documents traités dans la réponse à StreamServer.
5
StreamServer génère la sortie finale via un connecteur de sortie.
Si le service Web tombe en panne avant que les documents ne soient envoyés dans la réponse de service Web, aucune sortie n'est générée. Dans ce cas, un message d'erreur est enregistré dans le journal.
Création d'un processus LiveCycle ES2 activé par un filtre
Vous créez et activez le processus selon la procédure décrite dans la documentation de LiveCycle Workbench ES2. Pour activer le filtre LiveCycle afin d'appeler le service déployé, vous devez ajouter les variables d'entrée et de sortie suivantes au processus LiveCycle.
Type Commentaire Entrée/Sortie Nom de la variable
inputDoc Entrée
Entrée optionsMap
Sortie outputDoc document map document
Obligatoire
Facultatif. Est utilisée si des clés personnalisées sont spécifiées dans les paramètres du filtre LiveCycle.
Obligatoire
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
50
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
Seuls les processus LiveCycle qui suivent cette interface peuvent être appelés par un filtre LiveCycle.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
51
Création d'un filtre LiveCycle
Vous créez un filtre LiveCycle de la même façon que vous créez d'autres filtres de sortie dans Design Center. Vous devez pour cela créer une ressource de chaîne de filtres, créer et configurer le filtre LiveCycle dans la chaîne de filtres et connecter cette dernière au connecteur de sortie approprié.
Pour créer et appliquer un filtre LiveCycle
1
Créez une ressource de chaîne de filtres dans un jeu de ressources connecté
à la Plate-forme.
2
Ajoutez un filtre LiveCycle à la chaîne de filtres.
3
Configurez le filtre (voir les paramètres de filtre ci-dessous) et enregistrez la ressource de chaîne de filtres.
4
Ajoutez la chaîne de filtres au connecteur de sortie approprié.
Paramètres de filtre
Paramètre
Nom d'hôte
Port
Nom du service Web
Description
Nom d'hôte ou adresse IP du serveur qui héberge LiveCycle ES2. Par exemple : localhost
Port utilisé par le serveur LiveCycle ES2. Par exemple :
8080
Nom (sensible à la casse) du service à appeler.
Ce nom doit être identique au nom du processus correspondant créé dans LiveCycle
Workbench ES2.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
52
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
Paramètre
Nom d'utilisateur
Mot de passe
Activer la communication asynchrone
Intervalle d'interrogation asynchrone
Certificat racine pour la communication SSL
Description
Nom d'utilisateur permettant de se connecter au serveur hébergeant LiveCycle ES2.
Ce paramètre est utilisé dans le cas de l'authentification HTTP de base.
Mot de passe permettant de se connecter au serveur hébergeant LiveCycle ES2.
Ce paramètre est utilisé dans le cas de l'authentification HTTP de base.
Oui
Effectue des appels asynchrones au service.
Cette option est utilisée lorsque vous appelez des services LiveCycle sur une longue durée.
Non
Effectue des appels synchrones au service.
Cette option est utilisée lorsque vous appelez des services LiveCycle sur une courte durée.
Ce paramètre n'est utilisé qu'avec les appels asynchrones. Il s'agit de l'intervalle (en millisecondes) utilisé pour vérifier la réponse
à la requête d'appel.
Certificat racine employé lorsque le protocole
HTTPS est utilisé comme protocole de service
Web (communication sécurisée). Ce certificat doit être disponible à partir d'un jeu de ressources connecté à la Plate-forme.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
53
Paramètre
Options personnalisées
Description
Liste de clés personnalisées (paires valeurs/ clés) à ajouter dans la requête d'appel.
Pour pouvoir gérer les clés personnalisées, le service doit disposer d'une variable nommée optionsMap
du type map
. Toutes les clés personnalisées définies ici seront ajoutées à la variable optionsMap
dans le service appelé.
Les valeurs générées peuvent être extraites dans le processus LiveCycle destinataire à l'aide d'une expression XPath dans le processus LiveCycle.
Les mots de passe requis pour créer des fichiers PDF protégés par mot de passe sont des exemples de clés personnalisées. Par exemple :
Clé :
pdfpassword
Valeur :
encrypted
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
54
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
Exemple d'utilisation
Besoin
Un utilisateur StreamServer doit crypter des documents PDF, mais le cryptage ne peut pas être effectué à l'aide d'une fonctionnalité StreamServer. Vous pouvez dans ce cas appeler un processus LiveCycle pour crypter les documents PDF.
Figure 2 Avant le filtre LiveCycle
Actions
Un filtre LiveCycle est ajouté après le pilote PDF. Le filtre envoie les documents
PDF formatés à un processus LiveCycle. Le processus crypte les documents et les renvoie à StreamServer via le filtre LiveCycle.
Figure 3 Après le filtre LiveCycle
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
55
Paramètres généraux du connecteur et du filtre
LiveCycle
En plus des paramètres définis pour le filtre LiveCycle et le connecteur de sortie
LiveCycle, vous pouvez avoir besoin de modifier certains paramètres généraux dans le fichier de configuration strslcfilter.config.xml
. Ce fichier se trouve
à l'emplacement suivant :
<installation_StreamServe>\Services\XFA\1.3.0\Service
<?xml version="1.0" encoding="utf-8"?>
<lcfilter>
<setting key="maxinlinesize">65536</setting>
<setting key="timeout">120</setting>
<setting key="retries">5</setting>
</lcfilter>
Figure 4 strslcfilter.config.xml – exemple.
Ces paramètres s'appliquent à tous les filtres et connecteurs de sortie LiveCycle.
Clé
maxinlinesize timeout retries
Description
Taille maximale (en octets) autorisée d'un document pour pouvoir l'incorporer avec un codage base64. Si la taille maximale est dépassée, le document est alors enregistré comme attachement DIME.
Délai (en secondes) d'attente d'une réponse à la requête.
Si ce délai est dépassé, la connexion est arrêtée.
Nombre de tentatives en cas d'erreur de communication.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
56
Appel de processus LiveCycle ES2 à partir de LiveCycle Production Print ES2
Intégration LiveCycle Production Print ES2 et LiveCycle ES2
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Public link updated
The public link to your chat has been updated.