Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder. Adobe Workflow, Form Manager, PDF Generator, assembler, forms, PRINT

Document

Appel de LiveCycle Assembler à l'aide de

LiveCycle Workflow et de Watched Folder

Cette annexe explique comment appeler LiveCycle Assembler par le biais de LiveCycle Workflow, à l'aide des QPAC LiveCycle Assembler et de Watched Folder.

Elle suppose que vous avez installé, configuré et déployé LiveCycle Assembler, LiveCycle Workflow et

Watched Folder.

Remarque :

vous pouvez implémenter les dossiers de contrôle à utiliser avec LiveCycle PDF Generator mais vous devez les configurer séparément. Le contenu de ce chapitre traite uniquement le service Watched Folder intégrant LiveCycle Workflow et LiveCycle Assembler. Pour plus d'informations sur la configuration des dossiers de contrôle de LiveCycle PDF Generator, reportez-vous à l'aide sur l'administration de LiveCycle PDF Generator, disponible depuis l'interface Web de LiveCycle PDF Generator.

Liste des tâches

A l'aide de Watched Folder ou d'une application cliente que vous avez développée, vous pouvez indiquer

à LiveCycle Workflow d'initier un flux de production activant un QPAC LiveCycle Assembler.

Cette section présente les tâches requises pour configurer un flux de production permettant l'achèvement d'un processus LiveCycle Assembler appelé par Watched Folder. La procédure détaillée nécessaire à la réalisation des tâches figure dans la section ou le document indiqué. Vous devez exécuter les tâches suivant leur ordre d'apparition dans le tableau.

Remarque :

n'exécutez pas Configuration Manager tant que vous n'avez pas terminé d'installer les fichiers pour chacun des produits.

Etape

Tâche

Déployez les QPAC LiveCycle Assembler sur

LiveCycle Workflow Designer.

Créez et déployez un flux de production comprenant un QPAC LiveCycle Assembler.

Créez un dossier de contrôle sur le système de fichiers.

Connectez-vous à Administrator, puis créez un dossier de contrôle et configurez-le.

Créez un fichier JobConfig.xml.

Voir

Using LiveCycle Assembler QPACs (disponible sur le DVD d'installation de

LiveCycle Assembler ou sur le site Web de

LiveCycle Workflow SDK)

« Déploiement de QPAC et création d'un processus de flux de production », page 106

LiveCycle Workflow Création de flux de

production

Aide de LiveCycle Workflow Designer

« Création et configuration d'un dossier de contrôle », page 109

Aide sur l'administration de Watched Folder

« Création d'un fichier JobConfig.xml », page 110

Aide sur l'administration de Watched Folder

105

Adobe LiveCycle

Installation et configuration de LiveCycle pour JBoss

Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder

Déploiement de QPAC et création d'un processus de flux de production 106

Etape Tâche

Préparez les éléments connexes au test ou à la production, parmi lesquels les fichiers PDF d'entrée et un fichier DDX.

Soumettez le travail LiveCycle Assembler pour traitement.

Voir

« Préparation des fichiers PDF et DDX », page 112

Developing Applications for LiveCycle

Assembler

Document Description XML Reference

« Soumission du travail LiveCycle Assembler pour traitement », page 113

Developing Custom Applications for

LiveCycle Workflow

Déploiement de QPAC et création d'un processus de flux de production

Deux QPAC permettent de créer des flux de production pour LiveCycle Assembler : le QPAC Assembler et le QPAC CreateDocumentList. Le QPAC Assembler est utilisé pour tous les flux de production

LiveCycle Assembler, que vous utilisiez Watched Folder ou une autre méthode pour initier le processus

(par exemple, des applications clientes ou des services Web).

Cette section explique comment créer un processus de flux de production utilisant le QPAC Assembler, ainsi que les variables requises et les propriétés des actions dans LiveCycle Workflow Designer. Pour plus d'informations sur la création d'un processus de flux de production utilisant le QPAC CreateDocumentList, reportez-vous au guide Using LiveCycle Assembler QPACs.

Les étapes de création d'un processus de flux de production comprenant un QPAC Assembler sont similaires aux étapes de création d'un processus de flux de production à l'aide de

LiveCycle Workflow Designer. La procédure présentée ici fournit des détails propres au QPAC Assembler.

Pour plus d'informations sur la création des flux de production, la configuration des variables et la définition des propriétés des actions dans un QPAC, reportez-vous à la section Création de flux de

production et aux guides Using LiveCycle Assembler QPACs.

Utilisation de fichiers DDX dynamiques ou statiques

Lorsque vous soumettez des travaux à Watched Folder en vue de leur traitement par LiveCycle Workflow et LiveCycle Assembler, vous pouvez utiliser un fichier DDX dynamique ou statique. Lorsque vous créez ou utilisez une application pour soumettre des travaux à LiveCycle Assembler, ce dernier n'utilisant que le flux de production QPAC (sans Watched Folder), vous devez utiliser un fichier DDX statique.

Un flux de production qui utilise un fichier DDX dynamique traite le fichier DDX présent dans le dossier d'entrée d'un dossier de contrôle. Pour utiliser un fichier DDX dynamique dans votre processus de flux de production, vous devez créer une variable

<inputddx> et la spécifier dans les propriétés des actions du QPAC.

Un flux de production qui utilise un fichier DDX statique traite un fichier DDX particulier situé dans le QPAC et utilisé chaque fois que le processus est appelé par le fichier JobConfig.xml. Pour utiliser un fichier DDX statique dans le processus de flux de production, vous devez accéder au fichier DDX et le charger dans le

QPAC lorsque vous configurez les propriétés des actions du flux de production. Vous pouvez utiliser un fichier DDX statique si vous utilisez un dossier de contrôle ou si vous exécutez le processus à l'aide des

QPAC uniquement.

Adobe LiveCycle

Installation et configuration de LiveCycle pour JBoss

Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder

Configuration d'un QPAC Assembler dans un processus de flux de production 107

Configuration d'un QPAC Assembler dans un processus de flux de production

Lorsque vous créez un nouveau processus de flux de production dans LiveCycle Workflow Designer, vous devez créer des variables que ce dernier utilisera. Lorsque vous ajoutez le QPAC Assembler au flux de production, vous devez définir les propriétés des actions du QPAC. Les propriétés des actions utilisent les variables que vous avez créées.

Vos sélections dans la boîte de dialogue Propriétés des actions varient suivant que vous utilisez un fichier

DDX dynamique ou statique.

Remarque :

les noms de variable utilisés dans ce chapitre, comme

, sont définies par l'utilisateur dans LiveCycle Workflow Designer ; vous pouvez nommer la variable comme bon vous semble à sa création.

Variables pour le QPAC Assembler

Variable

(requise pour le fichier

DDX dynamique uniquement)

(non requise lorsque le niveau d'informations consignées est désactivé)

Valeur de la propriété

Type : mappe

de document entrée : sélectionnée sortie : non sélectionnée obligatoire : non sélectionnée

Type : document entrée : sélectionnée sortie : non sélectionnée obligatoire : non sélectionnée

Type : mappe

et document entrée : non sélectionnée sortie : sélectionnée obligatoire : non sélectionnée

Type : document entrée : non sélectionnée sortie : sélectionnée obligatoire : non sélectionnée

Propriétés des actions du QPAC Assembler

Type de flux de production Sélection dans l'onglet Input

Utilisation de Watched Folder avec un fichier DDX dynamique

Use a Document Variable to load the

DDX file : cliquez sur le bouton portant les points de suspension, puis sélectionnez la variable

Sélection dans l'onglet Output

Output Document Map : cliquez sur le bouton portant les points de suspension et sélectionnez la variable

Input Document Map Variable :

Sélectionnez la variable

Adobe LiveCycle

Installation et configuration de LiveCycle pour JBoss

Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder

Configuration d'un QPAC Assembler dans un processus de flux de production 108

Type de flux de production Sélection dans l'onglet Input

Utilisation de Watched Folder avec un fichier DDX statique

Use the Browse button to locate the

DDX file : recherchez le fichier DDX à utiliser.

Utilisation de QPAC uniquement (avec un fichier

DDX statique)

Input Document Map Variable :

Sélectionnez la variable

Input Document Map : ne pas sélectionner

Use the Browse button to locate the

DDX file : recherchez le fichier DDX à utiliser.

Sélection dans l'onglet Output

Output Document Map : cliquez sur le bouton portant les points de suspension et sélectionnez la variable

Output Document Map : cliquez sur le bouton portant les points de suspension et sélectionnez la variable

Remarque :

pour plus d'informations sur la sélection des options de l'onglet Configuration, consultez la

section suivante : Consignation des erreurs et modes d'échec dans les flux de production du

QPAC Assembler

Consignation des erreurs et modes d'échec dans les flux de production du QPAC Assembler

Lorsque vous configurez un flux de production à l'aide du QPAC Assembler, vous pouvez sélectionner le niveau de consignation des erreurs et le mode d'échec que LiveCycle Workflow utilise lorsque des exceptions se produisent.

Vous pouvez définir le niveau de consignation sur Off (aucune consignation), Normal (messages courts) ou

Debug (descriptions détaillées des erreurs). Vous pouvez associer une variable de processus (par exemple,

) de type

Document au champ Output Log Document pour enregistrer les messages de consignation.

Vous pouvez définir le mode d'échec sur Stall Process ou Terminate Process pour indiquer au QPAC Assembler de bloquer ou de terminer le processus lorsqu'une exception se produit dans LiveCycle Assembler.

En cas d'échec d'un travail lorsque Stall Process est sélectionné, le processus de flux de production est bloqué mais pas terminé. Si la consignation est configurée sur Normal ou Debug, les informations concernant l'exception apparaissent sur la page Stalled Action de LiveCycle Workflow dans Administrator.

Les administrateurs du composant doivent rechercher le processus et le terminer, puis revenir à

Administrator et supprimer l'action bloquée, le cas échéant. Les messages consignés s'affichent sur la page de l'action bloquée mais pas sur la page du processus.

En cas d'échec d'un travail lorsque Terminate Process est sélectionné, le processus de flux de production s'achève lorsqu'une exception est générée. Si la consignation est configurée sur Normal ou Debug, les informations relatives à l'exception sont inscrites dans le fichier journal du composant pour lequel l'exception a été générée. Pour Watched Folder, le fichier journal correspond au fichier activity.log figurant dans le sous-répertoire /failure du dossier de contrôle configuré.

Si vous configurez un QPAC Assembler afin de l'utiliser avec Watched Folder, vous devez définir le mode d'échec sur Terminate Process. Les utilisateurs de Watched Folder peuvent ne pas avoir accès à

Administrator. Par conséquent, si les processus sont bloqués sans être terminés, les utilisateurs ne reçoivent pas de message sur l'exception tant que le processus n'est pas terminé. Configurer le mode d'échec sur Terminate Process garantit que les messages d'erreur sont consignés dans le fichier activity.log, disponible dans le répertoire [dossier de contrôle]/failure (lorsque le niveau de consignation est défini sur Normal ou Debug).

Adobe LiveCycle

Installation et configuration de LiveCycle pour JBoss

Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder

Création et configuration d'un dossier de contrôle 109

Pour plus d'informations sur la configuration de la consignation des erreurs et les modes d'échec, voir

Using LiveCycle Assembler QPACs.

Pour créer un flux de production comprenant un QPAC Assembler :

1. Déployez le QPAC sur LiveCycle Workflow Designer. Reportez-vous à la section Using LiveCycle

Assembler QPACs.

2. Dans LiveCycle Workflow Designer, sélectionnez File > New > Process Category.

3. Sélectionnez la nouvelle catégorie de processus, puis cliquez sur File > New > Process Type.

4. Cliquez avec le bouton droit de la souris sur le nouveau type de processus, puis sélectionnez New

Workflow.

5. Donnez un nom au flux de production, puis utilisez les valeurs par défaut pour les options restantes

(seule l'option synchronous

est sélectionnée).

6. Créez les variables du flux de production, comme indiqué dans le tableau

« Variables pour le QPAC

Assembler », page 107 , en cliquant sur le bouton plus (+) de la palette Variables. Pour plus

d'informations sur la création de variables, consultez l'aide de LiveCycle Workflow Designer.

7. Créez une nouvelle catégorie de composants. (Voir Création de flux de production.)

8. Ajoutez le QPAC Assembler QPAC (déployez le composant) à la nouvelle catégorie de composants, puis définissez les propriétés de l'action du flux de production, comme indiqué dans le tableau de

« Propriétés des actions du QPAC Assembler », page 107

9. Enregistrez le processus de flux de production et déployez-le.

Création et configuration d'un dossier de contrôle

Sur votre système de fichiers, créez un répertoire que vous pouvez configurer en tant que dossier de contrôle. Une fois le dossier configuré à l'aide de l'interface de configuration de Watched Folder, il contient les sous-répertoires suivants :

/[dossier de contrôle]

/input

/stage

/failure

/result

/preserve

Pour plus d'informations sur les sous-répertoires, voir Aide sur l'administration de Watched Folder.

Pour soumettre les fichiers à traiter, placez-les dans le répertoire /

[dossier de contrôle]/input

Lorsque plusieurs fichiers doivent être intégrés au processus LiveCycle Assembler, ne transférez pas les fichiers de façon individuelle ; créez un répertoire de collecte distinct, placez-y tous les fichiers requis (les fichiers PDF d'entrée et, le cas échéant, le fichier DDX), puis placez le répertoire de collecte dans le répertoire d'entrée du dossier de contrôle.

Adobe LiveCycle

Installation et configuration de LiveCycle pour JBoss

Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder

Création d'un fichier JobConfig.xml 110

Pour créer un dossier de contrôle et le configurer :

1. Créez un répertoire qui servira de dossier de contrôle sur le système de fichiers de votre serveur.

2. Connectez-vous à Administrator.

3. Cliquez sur Services, Watched Folder, puis sur Gestion et état de Watched Folder.

4. Cliquez sur Nouveau dossier de contrôle.

5. Dans le champ Nom du dossier de contrôle, attribuez un nom au dossier de contrôle. (Ce dernier ne doit pas nécessairement correspondre au nom du répertoire créé sur le système de fichiers à l'étape

1 .

Nous vous conseillons malgré tout d'utiliser le même nom pour garantir un meilleur suivi.)

6. Dans le champ Chemin du dossier de contrôle, saisissez le chemin complet d'accès au répertoire créé sur le système de fichiers.

7. Dans le champ Modèles de fichier inclus, saisissez le nom du répertoire créé pour contenir les fichiers

PDF d'entrée (que vous placerez dans le répertoire d'entrée du dossier de contrôle). Vous pouvez spécifier plusieurs fichiers ou noms si vous essayez de placer plusieurs fichiers et dossiers dans le dossier de contrôle.

8. Définissez les autres options suivant vos besoins. Pour plus d'informations sur les options disponibles, voir Aide sur l'administration de Watched Folder.

9. Cliquez sur OK.

Conseil :

si vous transférez une grande quantité de fichiers source vers un dossier de contrôle, cette opération peut prendre plusieurs minutes, voire plus. Il est possible que Watched Folder analyse le dossier de contrôle, reconnaisse un nouveau répertoire de collecte et lance un processus de flux de production avant la fin de la copie de tous les fichiers du répertoire. Pour éviter cette situation, vous devez attribuer au répertoire un autre nom que celui analysé par Watched Folder pendant la copie du répertoire dans le répertoire d'entrée. Une fois tous les fichiers d'entrée copiés, vous devez renommer le répertoire de collecte comme indiqué dans la configuration de

Watched Folder (valeur Modèles de fichier inclus).

Création d'un fichier JobConfig.xml

Il est possible de placer le fichier JobConfig.xml à la racine du répertoire d'entrée ou à l'intérieur du répertoire de collecte avec les autres fichiers connexes.

Si vous prévoyez de placer plusieurs travaux (répertoires de collecte) dans le dossier de contrôle de différents flux de production utilisant les fichiers DDX dynamiques, vous devez placer le fichier JobConfig.xml dans les répertoires de collecte individuels soumis au répertoire d'entrée dans le dossier de contrôle.

Si vous prévoyez de soumettre plusieurs travaux au même flux de production utilisant un fichier DDX statique, vous pouvez placer le fichier JobConfig.xml à la racine du répertoire d'entrée. De ce fait, les travaux entrants suivants utilisent ce même fichier JobConfig.xml.

Pour créer un fichier JobConfig.xml, créez un fichier XML similaire aux exemples suivants.

Exemple C.1

Fichier JobConfig.xml pour un fichier DDX dynamique

<?xml version="1.0" encoding="UTF-8"?>

Adobe LiveCycle

Installation et configuration de LiveCycle pour JBoss

Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder

Création d'un fichier JobConfig.xml 111

<process-config xmlns="http://adobe.com/watchedfolder" xmlns:xsi="http://www.w3.org/2001/ XMLSchema-instance" xsi:schemaLocation="http://adobe.com/watchedfolder

C:\WatchedFolder\schemas\JobConfiguration.xsd">

<process-type>myworkflow</process-type>

<process-variables>

<process-variable>

<filter-pattern>*.pdf</filter-pattern>

<process-variable-type>mappe</process-variable-type>

<process-variable-name>inputdocmap</process-variable-name>

<process-variable-datatype>document</process-variable-datatype>

<process-input>true</process-input>

</process-variable>

<process-variable>

<filter-pattern>*.ddx</filter-pattern>

<process-variable-type>unique</process-variable-type>

<process-variable-name>inputddx</process-variable-name>

<process-variable-datatype>document</process-variable-datatype>

<process-input>true</process-input>

</process-variable>

</process-variables>

</process-config>

Exemple C.2

Fichier JobConfig.xml pour un fichier DDX statique

Utilisez le même fichier JobConfig.xml décrit précédemment, mais omettez la variable de processus

<?xml version="1.0" encoding="UTF-8"?>

<process-config xmlns="http://adobe.com/watchedfolder" xmlns:xsi="http://www.w3.org/2001/ XMLSchema-instance" xsi:schemaLocation="http://adobe.com/watchedfolder

C:\WatchedFolder\schemas\JobConfiguration.xsd">

<process-type>myworkflow</process-type>

<process-variables>

<process-variable>

<filter-pattern>*.pdf</filter-pattern>

<process-variable-type>mappe</process-variable-type>

<process-variable-name>inputdocmap</process-variable-name>

<process-variable-datatype>document</process-variable-datatype>

<process-input>true</process-input>

</process-variable>

</process-variables>

</process-config>

Le contenu du fichier JobConfig.xml est associé aux variables et aux actions définies dans le processus de

flux de production décrit dans la section « Configuration d'un QPAC Assembler dans un processus de flux de production », page 107 .

Noeud

process-config process-type

Description

Racine du fichier de configuration du travail.

Nom du type de processus de flux de production. Cette valeur doit correspondre à la valeur spécifiée dans le processus de flux de travail de LiveCycle Workflow Designer.

Adobe LiveCycle

Installation et configuration de LiveCycle pour JBoss

Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder

Préparation des fichiers PDF et DDX 112

Noeud

process-variables process-variable filter-pattern process-variable-type process-variable-name process-variable-datatype process-input

Description

Contient plusieurs nœuds de variable de processus.

Chaque nœud process-variable est associé à une variable intégrée au processus de flux de production. Ses sous-éléments spécifient les valeurs de propriété de chaque variable du processus.

Modèle utilisé pour filtrer tous les fichiers à partir de l'ensemble des fichiers entrants définis pour la variable de processus. Ce modèle correspond au type de fichiers à traiter en rapport avec la variable.

Type de variable d'entrée : unique, liste ou mappe.

Dans l'exemple ci-dessus, la variable

possède le type liste

car elle spécifie un ensemble de documents (tous les fichiers qui seront placés dans le dossier de contrôle). Le type unique

est utilisé pour la variable

car un seul fichier est intégré.

Nom de la variable de flux de production telle que définie dans le flux de production. Dans l'exemple ci-dessus, les noms de variable

correspondent aux noms créés à la section « Configuration d'un

QPAC Assembler dans un processus de flux de production », page 107

: inputdocmap

et inputddx

Type de flux de production. Deux types de variables sont pris en charge : document et xml. Ceci correspond à l'attribut containedtype

de la variable (et non à l'attribut collectiontype

Watched Folder n'utilise pas ce paramètre pour le moment. Laissez cette valeur définie sur true.

Pour plus d'informations sur la création du fichier JobConfig.xml, voir Aide sur l'administration de Watched

Folder.

Préparation des fichiers PDF et DDX

Les fichiers PDF fournis dans le répertoire d'entrée ou défini par le QPAC Assembler doivent correspondre à la valeur du modèle de fichier de l'élément source

du fichier DDX.

Si vous utilisez Watched Folder avec LiveCycle Assembler, vous devez indiquer la variable Input Document

Map (reportez-vous à la section « Configuration d'un QPAC Assembler dans un processus de flux de production », page 107 ). Utilisez l'attribut

sourceMatch

pour définir le modèle de fichier avec l'élément source. Pour plus d'informations sur la configuration du modèle d'expression rationnelle pour l'attribut sourceMatch

, voir Document Description XML Reference.

Par exemple, dans le fichier DDX, il est possible de spécifier la source PDF de plusieurs façons :

Modèle correspondant à des noms de fichier spécifiques :

Modèle correspondant à une valeur générique :

Adobe LiveCycle

Installation et configuration de LiveCycle pour JBoss

Appel de LiveCycle Assembler à l'aide de LiveCycle Workflow et de Watched Folder

Soumission du travail LiveCycle Assembler pour traitement 113

Dans les exemples ci-dessus, le modèle correspond à n'importe quel fichier PDF d'entrée commençant par les caractères appendix

suivis d'un chiffre, puis de l'extension .pdf. La valeur générique correspond au moins à un fichier PDF d'entrée comprenant n'importe quel caractère incluant des chiffres et se terminant par .pdf.

Pour plus d'informations sur la configuration de l'élément source dans le fichier DDX, reportez-vous à la section sur la spécification de plusieurs flux d'entrée du guide Developing Applications for LiveCycle

Assembler et de Document Description XML Reference.

Soumission du travail LiveCycle Assembler pour traitement

Vous pouvez soumettre un travail LiveCycle Assembler à Watched Folder par le biais d'un programme utilisant un fichier de commandes qui transfère le produit contenant les fichiers requis au dossier de contrôle configuré. (Les instructions de création d'un fichier ou d'un script de commandes pour effectuer cette action ne sont pas abordées dans ce guide.) Vous pouvez également soumettre un travail manuellement en déplaçant ou en copiant l'ensemble des fichiers dans Watched Folder.

Si vous avez créé un flux de production LiveCycle Assembler dans LiveCycle Workflow Designer qui n'utilise pas Watched Folder, vous pouvez soumettre le travail pour traitement à l'aide d'une application cliente créée au moyen de l'API Java de LiveCycle Workflow. Pour plus d'informations sur le développement d'applications clientes personnalisées pour LiveCycle Workflow, consultez le guide

Developing Custom Applications for LiveCycle Workflow, disponible sur le kit de développement logiciel de

LiveCycle Workflow.

Vous pouvez également soumettre des travaux pour traitement à l'aide de nombreux mécanismes disponibles avec LiveCycle Workflow, comme les services Web, la messagerie électronique et les files d'attente de messages ou des formulaires en ligne. Pour plus d'informations, consultez les guides

Developing Custom Applications for LiveCycle Workflow et Developing Custom QPACs.

Remarque :

lorsque le partage NFS est configuré pour Watched Folder, les fichiers temporaires et les répertoires liés aux travaux Watched Folder sont placés dans le répertoire de stockage global, mais ils ne sont pas automatiquement supprimés une fois le traitement des travaux terminé.

Pour éviter tout problème de performances, vous devez régulièrement supprimer les fichiers portant le nom Session

[NNNN]

, où NNNN correspond à l'identifiant du processus de flux de production du répertoire de stockage global.

L'emplacement par défaut du répertoire de stockage global est le suivant :

{RepTemp]/AdobeDocumentStorage/global. Si [RepTemp] n'est pas spécifié par l'utilisateur dans Configuration Manager, l'emplacement par défaut est java.io.tmpdir.