Projet exemple
Le Projet exemple peut être utilisé dans les cas suivants :
• Dans un but éducatif
• Pour vérifier que LiveCycle Production Print ES2 a été correctement installé et configuré
Le Projet exemple illustre également l'intégration des processus LiveCycle ES2 et LiveCycle Production Print ES2. Les exemples d'intégration fournis peuvent servir de modèles lors de la mise en oeuvre.
Le Projet exemple
SampleProject.dcpackage
est disponible dans le dossier
Extras\sampleproject
sur le support d'installation. Il est également installé par défaut dans le répertoire
C:<répertoire installation StreamServe>\Services\XFA\1.3.0\Tool
Prérequis
Pour exécuter le Projet exemple, les Processus et ressources du Projet doivent être installés.
Si vous utilisez un serveur LiveCycle (c'est-à-dire si vous appelez des applications StreamServer à partir de LiveCycle ES)2, le composant DSC doit
être installé.
Voir le manuel d'installation de LiveCycle Production Print ES2.
Dans ce chapitre :
•
Exécution du Projet exemple
à la page 58
•
Vérification de l'installation de base
à la page 59
•
Configurations du Projet exemple
à la page 60
57
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
58
Exécution du Projet exemple
Projet exemple
Exécution du Projet exemple
Vous devez décompresser le Projet exemple avant de pouvoir l'exporter et le déployer.
Pour décompresser le fichier du Projet exemple
1
Ouvrez Design Center.
2
Sélectionnez
Fichier > Décompresser le Projet
.
3
Recherchez et ouvrez le fichier de package. La boîte de dialogue
Décompression du projet s'ouvre.
4
Spécifiez l'emplacement où vous souhaitez décompresser les fichiers du projet et cliquez sur
OK.
Pour exporter et déployer le Projet exemple
Dans Design Center, exportez le Projet. Voir la documentation sur StreamServe
Design Center.
Pour déployer le Projet exemple
Dans Control Center :
1
Créez l'application StreamServer vers laquelle vous voulez déployer le
Projet exemple.
2
Déployez le Projet exemple vers l'application StreamServer.
Voir la documentation sur StreamServe Control Center.
Pour démarrer l'application StreamServer
Lancez l'application StreamServer dans Control Center en cliquant avec le bouton droit de la souris sur le noeud de l'application StreamServer et sélectionnez
Démarrer
.
De même, vous arrêtez et redéployez des applications StreamServer à partir de
Control Center. Voir la documentation sur StreamServe Control Center.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Vérification de l'installation de base
Projet exemple
59
Vérification de l'installation de base
Pour vérifier les fonctionnalités de base de l'installation
1
Décompressez, exportez et déployez le Projet. Suivez les instructions de la
section
Exécution du Projet exemple
à la page 58.
2
Créez un dossier input
dans le répertoire
C:\ManagementGateway\1.0\root\applications\<nom application>
\Dev
3
Copiez le fichier
Purchase Order.xml
du répertoire
C:\ManagementGateway\1.0\root\applications\<nom application>
\data\samples dans le dossier input
.
4
Lisez le fichier journal dans Control Center pour vérifier que le fichier a été traité.
5
Vérifiez que le fichier purchaseorder.pdf
est copié dans le répertoire
C:\ManagementGateway\1.0\root\applications\<nom application>
\Dev\output
Pour vérifier le Projet exemple de conversion AFP en PDF
1
Créez un dossier input2
dans le répertoire
C:\ManagementGateway\1.0\root\applications\<nom
application>\Dev
2
Copiez le fichier purchaseorder.afp
du répertoire
C:\ManagementGateway\1.0\root\applications\<nom
application>\data\samples dans le dossier input2
.
3
Lisez le fichier journal dans Control Center pour vérifier que le fichier a été traité.
4
Vérifiez que cinq fichiers nommés nnnnnnnnn.pdf
figurent dans le répertoire
C:\ManagementGateway\1.0\root\applications\<nom
application>\Dev\output où nnnnnnn
correspond au numéro du bon de commande dans les données d'entrée.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
60
Configurations du Projet exemple
Projet exemple
Configurations du Projet exemple
Configuration Exemple 1
La configuration Exemple 1 correspond à un cas d'utilisation de base avec un post-traitement synchrone, incluant le tri des documents et le marquage OMR.
Vous pouvez connecter le Processus au connecteur de sortie
PDF encrypt
, installer le package LCA exemple et configurer le filtre du connecteur pour qu'il pointe vers l'ordinateur sur lequel le package LCA est installé. Ceci illustre la façon dont LiveCycle Production Print ES2 peut se connecter à un serveur
LiveCycle, traiter un PDF et renvoyer le PDF à LiveCycle Production Print ES2.
Configuration Exemple 2
La configuration Exemple 2 illustre comment relier des données ASCII à un modèle de formulaire.
1
Copiez le fichier
Invocie.grb
du répertoire samples dans le répertoire input.
2
Vérifiez que le fichier output.pdf
a été créé dans le répertoire de sortie.
Configuration Processus de relance
Les configurations Exemple 1 et Processus de relance peuvent être utilisées conjointement pour illustrer l'appel distant de LiveCycle Production Print ES2 à partir de LiveCycle ES2.
1
Installez et déployez le package LCA sur un serveur LiveCycle ES2.
2
Appelez le service
DunningNoticeStage
avec le fichier
DunningNotice.xml
comme entrée (disponible dans les ressources). Le fichier XML et le fichier
DunningNotice.xdp
sont envoyés à LiveCycle
Production Print ES2.
Le fichier de données et le modèle seront fusionnés et stockés dans le référentiel pour post-processeur LiveCycle Production Print ES2.
3
Appelez le service
DunningNoticePrint
avec le fichier lcpp.ppq
(fichier de requête du post-processeur) comme entrée. Le fichier PPQ est envoyé à
LiveCycle Production Print ES2, qui récupérera la lettre de relance dans le référentiel pour post-processeur, la formatera en tant que fichier PDF et la copiera dans le dossier de sortie sous le nom output.pdf
.
Configuration Génération d'une lettre de relance
La configuration Génération d'une lettre de relance illustre la façon dont
LiveCycle Production Print ES2 peut être appelé avec des données et un modèle.
LiveCycle Production Print ES2 fusionnera les données et le modèle et renverra les résultats sous la forme d'un fichier AFP à LiveCycle ES2.
1
Appelez le service
DunningNoticeGenerate
avec le fichier
Dunning
Notice.xml
comme entrée. Le fichier AFP obtenu sera copié dans un fichier sur le serveur LiveCycle (par défaut, c:\result.afp
).
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Configurations du Projet exemple
Projet exemple
61
Configuration Exemple 5 Conversion AFP en PDF
La configuration Exemple 5 illustre la façon dont des fichiers AFP peuvent être convertis en fichiers PDF via l'outil PreformatIN et des fonds de page dynamiques dans le Processus PageOUT.
L'Evénement PreformatIN lira le fichier
PurchaseOrder.afp
au moyen d'un filtre AFP2LXF et mettra les identifiants en correspondance afin d'identifier le type de document. Le Processus PageOUT appliquera les pages LXF générées dynamiquement à une page logique. Le résultat sera un fichier PDF généré via un pilote sur le connecteur de sortie.
1
Appelez la configuration Conversion AFP en PDF en copiant le fichier purchaseorder.afp
dans le répertoire d'entrée
Watchfolder2
. Cinq fichiers PDF seront alors générés dans le répertoire de sortie, un pour chaque document dans le fichier AFP.
Configuration de la Plate-forme
La Plate-forme du Projet exemple contient des connecteurs d'entrée et de sortie dans le couche physique nommée
Dev
.
Connecteurs d'entrée
input
Connecteur d'analyse de répertoires. Le dossier analysé est
\input
(son chemin d'accès est relatif au répertoire de travail d'un Projet déployé).
DunningNoticeStage
DunningNoticePrint
DunningNoticeGenerate
Connecteurs Service Request. Exposent les configurations de Message en tant que services via la passerelle de services StreamServe.
WatchFolder2
Connecteur d'analyse de répertoires.
Le répertoire analysé est
.\input2
(chemin relatif au répertoire de travail). Le type du fichier analysé est
*.afp
. Le filtre AFP2LXF est appliqué dans le pipeline d'entrée du connecteur.
Pour afficher les paramètres de connecteur
1
Activez la vue Plate-forme.
2
Cliquez avec le bouton droit de la souris sur le connecteur et sélectionnez
Paramètres
.
3
Cliquez sur la couche logique et la couche physique dans la boîte de dialogue Paramètres pour afficher tous les paramètres du connecteur.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
62
Configurations du Projet exemple
Projet exemple
Connecteurs de sortie
PDF
PDF encrypt
PostProcessing
PPRepository
LC Response
PDF Bypass
Connecteur de type fichier.
Le fichier de sortie est défini sur
.\output\purchaseorder.pdf
(chemin d'accès relatif au répertoire de travail d'un Projet déployé). Le pilote de périphérique est paramétré sur
PDF
avec les options par défaut. Le mode de sortie est paramétré sur
Job
afin de conserver toutes les données de sortie dans un seul fichier de sortie.
Connecteur de type fichier avec les mêmes paramètres que le connecteur
PDF
. Toutefois, le connecteur
PDF encrypt
dispose d'une configuration de filtre qui permet d'appeler à distance un service LiveCycle, pour crypter et protéger par mot de passe les données de sortie avant leur
écriture dans un fichier.
Connecteur de type fichier.
Le fichier de sortie est défini sur
.\output\output.pdf
(chemin d'accès relatif au répertoire de travail d'un Projet déployé). Le pilote de périphérique est paramétré sur
PDF avec les options par défaut. Le mode de sortie est paramétré sur
Job
afin de conserver toutes les données de sortie dans un seul fichier de sortie.
Connecteur Post-Processor Repository (Référentiel pour
Postprocesseur).
Enregistre la sortie dans le référentiel de post-traitement incorporé à l'aide de l'alias lcpp
. Le pilote de périphérique est défini sur
SDR
.
Connecteur Null pour lequel l'option
Inclure le résultat dans la réponse de service
est définie. Le pilote de périphérique est défini sur
AFP
.
Similaire au connecteur PDF, mais le mode de sortie est paramétré sur Processus.
Jeu de ressources
Le jeu de ressources par défaut dans le Projet exemple contient trois dossiers, un pour chaque type de Message :
•
Invoice
•
Purchase Order
•
Dunning Notice
Il existe des ressources exemples pour la configuration des Messages :
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Configurations du Projet exemple
Projet exemple
63
•
/Invoice/invoice.grb
est un fichier d'impression texte qui sert d'entrée au Message Exemple 2 – Données d'entrée ASCII.
•
/Invoice/invoice.xdp
est le modèle utilisé par le Message Exemple 2 –
Données d'entrée ASCII.
•
/Purchase Order/Purchase Order.xml
sert d'entrée au Message Exemple
1 – Données d'entrée XML.
•
/Purchase Order/Purchase Order.xdp
est un modèle de formulaire prédéfini à utiliser avec le Message Exemple 1 – Données d'entrée XML.
•
/Dunning Notice/Dunning notice.xml
sert d'entrée au Message Exemple
3 – Appel par LiveCycle et Exemple 4 – Génération d'une lettre de relance.
•
/AFP2PDF/AFP2PDF
est un pipeline de filtre avec le filtre AFP2LXF configuré.
•
/AFP2PDF/purchaseorder.afp
est un fichier exemple d'entrée au format
AFP pour la configuration Exemple 5 Conversion AFP en PDF.
Messages
Exemple 1 – Données d'entrée XML (modèle de formulaire existant)
Ce Message utilise un modèle statique ( purchase order.xdp
) qui accepte un fichier de données XML comme entrée.
Un Evénement et un Processus sont configurés pour le Message. L'Evénement utilise un identifiant pour reconnaître le type de fichier de données pour le
Message. L'identifiant est paramétré sur
/batch
pour qu'il corresponde au nœud racine du fichier de données
Purchase Order.xml
. Le Processus crée une liaison sur un modèle de formulaire lorsque les données d'entrée correspondent à l'identifiant de l'Evénement. Le modèle de formulaire
Purchase Order.xdp
du jeu de ressources défini est chargé dans le Processus.
Paramètres :
• Le mode d'enregistrement est utilisé avec le déclencheur d'enregistrement transaction
.
• Le mappage des variables StreamServe est utilisé pour mettre en correspondance l'expression SOM
$record.header.txtPONum
avec la variable StreamServe
$ponum
. La variable est utilisée dans les paramètres
Runtime pour trier les formulaires dans le fichier d'entrée batch.
Exemple 2 – Données d'entrée ASCII (modèle créé entièrement par l'utilisateur dans Design Center)
Les données d'entrée pour le modèle de formulaire sont contenues dans un fichier texte. L'Evénement utilise l'outil PageIN pour reconnaître le type du fichier de données et extraire son contenu dans un Message StreamServe.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
64
Configurations du Projet exemple
Projet exemple
Le fichier exemple invoice.grb (
du jeu de ressources) est utilisé pour configurer l'Evénement. Un identifiant est utilisé pour détecter la chaîne
INVOICE dans un jeu de coordonnées sur la page. L'outil Champ dans PageIN a été utilisé pour extraire des données à partir des coordonnées sur la page et les insérer dans le Message.
Le Processus utilise le paramètre
Ajouter le Message sous la forme d'une connexion de données dans la Vue des données
(voir
Boîte de dialogue
Paramètres
à la page 84) pour présenter le contenu du Message dans la vue des
données LiveCycle Designer. Le contenu de la vue des données a été utilisé pour créer des liaisons vers les champs du modèle de formulaire.
Exemple 3 – Appel par LiveCycle (appel distant de LiveCycle
Production Print ES2)
Les données d'entrée de l'Evénement XMLIN sont enregistrées dans le fichier
XML
Dunning Notice.xml
. L'identifiant est défini de manière à détecter l'élément
<transaction>
. Le Processus est configuré pour charger un modèle de façon dynamique. La variable
$template
sera automatiquement attribuée à un modèle à partir du connecteur d'entrée.
Exemple 4 – Génération d'une lettre de relance (appel distant de
LiveCycle Production Print ES2)
La configuration de ce Message est identique à l'exemple 3. La différence réside dans son utilisation dans la configuration de Runtime.
Exemple 5 - Conversion AFP en PDF
Le configuration de ce Message utilise PreformatIN et PageOUT pour convertir les fichiers AFP en fichiers PDF au moyen du filtre AFP2LXF dans la Plateforme.
Configurations de Runtime
Job Purchase Order (Bon de commande)
Cette configuration de job utilise le Message Exemple 1. L'Evénement est relié au connecteur d'entrée
WatchFolder
.
La sélection du connecteur de sortie est définie en mode statique et le connecteur de sortie
PostProcessing
est utilisé. Les paramètres du connecteur de sortie
PostProcessing
se basent sur les éléments suivants :
• Marquage OMR dans l'onglet Début du Processus.
• Tri de documents en fonction de la variable
$ponum
. Le tri est défini dans l'ordre décroissant.
Job Invoice (Facture)
Cette configuration de job utilise le Message Exemple 2. L'Evénement est relié au connecteur d'entrée
WatchFolder
.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
Configurations du Projet exemple
Projet exemple
65
La sélection du connecteur de sortie est définie en mode statique et le connecteur de sortie
PDF
est utilisé.
Job Dunning notice Stage (Phase de relance)
Cette configuration de job utilise le Message Exemple 3. L'Evénement est relié au connecteur d'entrée
DunningNoticeStage
.
La sélection du connecteur de sortie est définie en mode statique et le connecteur de sortie
PPRepository
est utilisé.
Job Dunning notice Process (Processus de relance)
Il s'agit d'une configuration de type référentiel pour postprocesseur. Le job est relié au connecteur d'entrée
DunningNoticePrint
.
La sélection du connecteur de sortie est définie en mode statique et le connecteur de sortie
PDF
est utilisé.
Job Dunning notice Generate (Génération d'une lettre de relance)
Cette configuration de job utilise le Message Exemple 4. L'Evénement est relié au connecteur d'entrée
DunningNoticeGenerate
.
La sélection du connecteur de sortie est définie en mode statique et le connecteur de sortie
LC Response
est utilisé.
Job AFP2LXF
Ce job définit les paramètres de connecteur de Runtime pour le connecteur PDF
Bypass de manière à utiliser une variable pour la génération de noms uniques pour les fichiers PDF.
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
66
Configurations du Projet exemple
Projet exemple
Adobe LiveCycle Production Print ES2 - Manuel utilisateur Rév. B
