bbc Services LiveCycle ES Adobe LiveCycle ES Octobre 2008 Update 1
2008 Adobe Systems Incorporated. Tous droits réservés. Services Adobe LiveCycle ES Update 1 (8.2) LiveCycle ES pour Microsoft Windows, Linux, UNIX Edition 2.2, octobre 2008 Si ce guide accompagne un logiciel assorti d un contrat de licence, le guide et le logiciel dont il traite sont concédés sous licence et ne peuvent être copiés ou utilisés que conformément à cette licence. Sauf autorisation spécifiée dans la licence, aucune partie de ce guide ne peut être reproduite, enregistrée ou transmise par un moyen électronique, mécanique ou autre, sans l autorisation écrite préalable d Adobe Systems Incorporated. Sachez que le contenu de ce manuel est protégé par des droits d auteur même s il n est pas distribué avec un logiciel contenant un contrat de licence de l utilisateur final. Les informations contenues dans ce guide sont données à titre purement indicatif. Elles peuvent être modifiées sans préavis et ne constituent pas un engagement de la part d Adobe Systems Incorporated. Adobe Systems Incorporated ne peut être tenu pour responsable des erreurs ou des inexactitudes apparaissant dans les informations fournies par ce guide. Nous attirons votre attention sur le fait que les illustrations et images que vous pouvez être amené à incorporer à vos projets peuvent être protégées par des droits d auteur, auquel cas leur exploitation sans l autorisation de l auteur constituerait une violation de ces droits. Assurez-vous que toutes les autorisations requises ont été accordées par les auteurs. Toute référence à des noms de sociétés, à des logos de société et à des noms d utilisateurs dans les exemples ou les exemples de formulaires inclus dans cette documentation et/ou ce logiciel est utilisée à titre d exemple uniquement et ne doit faire référence à aucune société ou personne réelle. Adobe, le logo Adobe, Acrobat, Distiller, Flash, Flex Builder, LiveCycle, PostScript et Reader sont des marques ou des marques déposées d'adobe Systems Incorporated aux Etats-Unis et/ou dans d'autres pays. EMC et Documentum sont des marques déposées d'emc Corporation aux Etats-Unis et dans le monde entier. Copyright 1994 2007 EMC Corporation, tous droits réservés. IBM est une marque d'international Business Machines Corporation aux Etats-Unis et/ou dans d'autres pays. JBoss est une marque ou une marque déposée de Red Hat, Inc. aux Etats-Unis et dans d'autres pays. Linux est la marque déposée de Linus Torvalds aux Etats-Unis et dans d autres pays. Mac OS est une marque d'apple Inc., déposée aux Etats-Unis et dans d'autres pays. Microsoft et Windows sont des marques déposées ou des marques de Microsoft Corporation aux Etats-Unis et/ou dans d'autres pays. Sun et Java sont des marques ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d autres pays. UNIX est une marque déposée de Open Group aux Etats-Unis et dans d'autres pays. Toutes les autres marques citées sont la propriété de leurs détenteurs respectifs. Ce produit inclut des logiciels BSAFE et/ou TIPEM de RSA Security, Inc. Ce produit inclut des logiciels développés par Apache Software Foundation (http://www.apache.org/). Ce produit inclut des logiciels développés par The IronSmith Project (http://www.ironsmith.org/). Ce produit inclut des logiciels développés par The OpenSymphony Group (http://www.opensymphony.com/). Ce produit intègre des logiciels développés par l Indiana University Extreme! Lab (http://www.extreme.indiana.edu/). Ce produit intègre des logiciels sous licence de droit d auteur développés par E. Wray Johnson, pour une utilisation et une distribution par le consortium Object Data Management Group (http://www.odmg.org/). Certaines parties de la société Eastman Kodak Company, 199-, sont concédées sous licence. Tous droits réservés. Kodak est une marque déposée et Photo CD est une marque d Eastman Kodak Company. Développé par Celequest. Copyright 2005 2008 Adobe Systems Incorporated. Tous droits réservés. Intègre la technologie distribuée sous licence par Celequest Corporation. Copyright 2005 Celequest Corporation. Tous droits réservés. Single sign-on, extension d'active Directory vers Adobe LiveCycle ES fourni par Quest Software www.quest.comlidentity-management dans une version mineure ultérieure sans correctifs (c'est-à-dire la version 1.1 à 1.2, mais pas 1.1.1 à 1.1.2) du produit du licencié incorporant le produit sous licence. La partie relevant de l orthographe de ce produit repose sur la technologie linguistique de Proximity. Copyright 1989, 2004. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Copyright1990 Merriam-Webster Inc. Copyright 1990. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Copyright 2003 Franklin Electronic Publishers, Inc. Copyright 2003. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis.
Copyright 2004 Franklin Electronic Publishers, Inc. Copyright 2004. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Copyright 1991 Dr.Lluis de Yzaguirre I Maura Copyright 1991. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Copyright 1990 Munksgaard International Publishers Ltd. Copyright 1990. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Copyright 1995. Van Dale Lexicografie bv Copyright 1996. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Copyright 1990 IDE a.s. Copyright 1990. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Copyright 2004 Franklin Electronic Publishers, Inc. Copyright 2004. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Copyright 1992 Hachette / Franklin Electronic Publishers, Inc. Copyright 2004. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Copyright 2004 Bertelsmann Lexikon Verlag Copyright 2004. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Copyright 2004 MorphoLogic Inc. Copyright 2004. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Copyright 1990 Williams Collins Sons & Co. Ltd. Copyright 1990. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Copyright 1993 à 95 Russicon Company Ltd. Copyright 1995. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Copyright 2004 IDE a.s. Copyright 2004. Tous droits réservés. Proximity Technology, une division de Franklin Electronic Publishers, Inc. Burlington, New Jersey, Etats-Unis. Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, Etats-Unis. Mention destinée aux utilisateurs finals du gouvernement américain. Le Logiciel et la Documentation sont des «Articles commerciaux», visés à l'article 48 C.F.R. alinéa 2.101, composés d'un «Logiciel commercial» et d'une «Documentation relative au logiciel commercial», visés à l'article 48 C.F.R. alinéa 12.212 ou alinéa 227.7202, selon le cas. Conformément à l article 48 C.F.R. alinéa 12.212 ou alinéas 227.7202-1 à 227.7202-4, selon le cas, le Logiciel commercial et la Documentation relative au logiciel commercial sont concédés sous licence aux utilisateurs finals du gouvernement américain (a) en tant qu articles commerciaux uniquement et (b) avec les seuls droits conférés àtout autre utilisateur final tenu par les termes et conditions stipulés ici. Droits non publiés réservés en vertu de la législation américaine sur les droits d auteur. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110, Etats-Unis. Pour les utilisateurs finals du gouvernement des Etats-Unis, Adobe s engage à respecter toutes les lois sur l égalité des chances, y compris, si approprié, les dispositions de l Executive Order 11246, comme modifié, la section 402 de l Acte d assistance à la réhabilitation des vétérans du Vietnam (Vietnam Era Veterans Readjustment Assistance Act) de 1974 (38 USC 4212) et la section 503 de l Acte de réhabilitation (Rehabilitation Act) de 1973, comme modifié, ainsi que les règlements de l article 41 C.F.R., sections 60-1 à 60-60, 60-250 et 60-741. La clause d action positive et la réglementation décrites dans la phrase précédente sont incluses par référence.
Table des matières A propos de ce document...9 Contenu de ce document... 9 A qui est destiné ce document?... 9 Informations complémentaires... 9 1 Présentation des services LiveCycle ES... 10 Définition des services faisant partie d'un composant de la solution...10 Mode d utilisation des services par les développeurs...10 Mode d utilisation des services par les administrateurs...10 2 Service Assembler... 11 A propos de DDX...11 Utilisation du service Assembler...12 Assemblage de documents PDF...12 Assemblage de documents chiffrés...13 Assemblage de documents à l'aide de la numérotation Bates...13 Aplatissement et assemblage de documents...13 Désassemblage de documents PDF...14 Vérification de la compatibilité PDF/A des documents...15 Validation de documents DDX...15 Remarques sur le service Assembler...16 3 Service Barcoded Forms... 17 A propos des formulaires à codes-barres...17 A propos des données de codes-barres...17 Utilisation du service Barcoded Forms...20 Codage et décodage des formats...20 Jeux de caractères définis par l utilisateur...20 Symbologies prises en charge...21 4 Services de connecteur pour ECM... 22 Utilisation des services de connecteur ECM...23 5 Service Convert PDF... 25 Utilisation du service Convert PDF...25 6 Service Decision Point... 26 Utilisation du service Decision Point...26 7 Service Distiller... 27 Utilisation du service Distiller...27 8 Service DocConverter... 28 Utilisation du service DocConverter...28 Vérification de la compatibilité PDF/A des documents PDF...28 Conversion de documents PDF en documents PDF/A...28 4
Adobe Adobe LiveCycle ES Services LiveCycle ES 5 9 Service Document Management... 30 Utilisation du service Document Management...30 Utilisation de contenus et d'espaces...30 Utilisation des associations...31 Utilisation des attributs de contenu...31 Remarques sur LiveCycle Contentspace ES...31 10 Service Email... 32 Utilisation du service Email...32 11 Service Encryption... 33 Utilisation du service Encryption...33 Chiffrement de documents PDF avec un mot de passe...33 Suppression d'un chiffrement avec mot de passe...34 Chiffrement des documents PDF avec certificat...34 Suppression du chiffrement avec certificat...35 Déverrouillage des documents PDF chiffrés...35 Détermination du type de chiffrement...35 Remarques sur le service Encryption...35 12 Service Execute Script... 37 Utilisation du service Execute Script...37 13 Service FTP... 38 Utilisation du service FTP...38 Remarques sur le service FTP...39 14 Service File Utilities... 40 Utilisation du service File Utilities...40 Remarques concernant le service File Utilities...40 15 Service Form Augmenter... 41 Utilisation du service Form Augmenter...41 16 Service Form Data Integration...42 Utilisation du service Form Data Integration...43 17 Service Forms... 45 A propos des types de formulaires...46 Comment le service Forms traite-il les demandes?...48 Demande de formulaire...48 Utilisation des boutons de conception de formulaire...50 Bouton d'envoi...51 Bouton de calcul...54 Utilisation du service Forms...55 Rendu de formulaires PDF interactifs...56 Utilisation d'un guide de formulaire...57 Rendu de formulaires au format HTML...57 Options du service Forms...58 Rendu de formulaires reposant sur des fragments...58 Rendu de formulaires dont les droits sont activés...59 Gestion des formulaires envoyés...60 Préremplissage des formulaires...63
Adobe Adobe LiveCycle ES Services LiveCycle ES 6 Calcul des données de formulaire...69 Optimisation d'une application...71 Remarques sur le service Forms...71 Planification de votre conception de formulaire...72 Création de conceptions de formulaire pour le service Forms...73 Rendu des formulaires contenant des images...74 Rendu d'un formulaire PDF intégrant une image sécurisée...74 Changements non retenus apportés à des champs image utilisant un script...74 Activation des options de débogage...74 18 Service Generate PDF... 75 Utilisation du service Generate PDF...75 Conversion de différents types de fichiers en documents PDF...76 Conversion de fichiers HTML en documents PDF...76 Conversion de fichiers PDF en types de documents différents...77 19 Service Generate 3D PDF... 78 Utilisation du service Generate 3D PDF...79 Création d'un PDF 3D à l'aide des paramètres du serveur...79 Création d'un PDF 3D à l'aide des paramètres d'un fichier XML...79 20 Service JDBC... 80 Utilisation du service JDBC...80 Remarques sur le service JDBC...80 21 Service JMS... 81 Utilisation du service JMS...81 Remarques sur le service JMS...81 22 Service LDAP... 82 Utilisation du service LDAP...82 Remarques sur le service LDAP...82 23 Service Output... 83 Utilisation du service Output...83 Création de documents PDF...84 Création de documents PDF/A...84 Envoi de flux d'impression vers des imprimantes...85 Traitement de données par lots pour créer plusieurs documents...88 Création de règles de recherche...91 Aplatissement de documents PDF interactifs...92 Remarques sur le service Output...93 Données de formulaire...93 Types de documents pris en charge...95 Champs de signature...95 Aplatissement d'un document PDF signé numériquement...95 Prise en charge de la messagerie électronique...96 Optimisation du débit...96 Zones imprimables...97 Scripts...97 Utilisation de polices...97 Mappage des polices...98 Coordination des polices entre Designer ES et le service Output...99 Utilisation des profils de périphérique (fichier XDC)...99
Adobe Adobe LiveCycle ES Services LiveCycle ES 7 Configuration d'imprimantes Zebra pour imprimer des étiquettes RFID... 100 Sélection du bac de l'imprimante... 100 Gestion du papier... 102 Utilisation du fichier de configuration XCI... 102 Définition des options du fichier de configuration XCI... 103 Incorporation des polices... 105 Prise en charge de l'impression CIFS... 105 Amélioration des performances du service Output... 106 24 Service PDF Utilities...107 Utilisation du service PDF Utilities... 107 25 Service Reader Extensions...109 Utilisation du service Reader Extensions... 110 Application de droits d utilisation aux documents PDF... 110 Suppression de droits d utilisation des documents PDF... 111 Récupération des informations d'identification... 111 Remarques sur le service Reader Extensions... 112 Configuration des informations d identification... 112 Ordre des opérations... 112 Ajout de droits d utilisation aux formulaires interactifs... 112 Ajout de droits d'utilisation à des formulaires afin d'en remplir les champs... 113 Ouverture de documents PDF dotés de droits d utilisation... 113 26 Service Repository...114 Utilisation du service Repository... 114 27 Service Rights Management...115 A propos des stratégies... 116 A propos des jeux de stratégies... 116 Méthodes et technologie liées à la sécurité... 117 Authentification... 117 Méthodes d authentification... 117 Assertions d authentification SAML... 118 Contrôle d'accès basé sur les rôles... 118 Confidentialité des documents... 119 Accès aux documents protégés par une stratégie pour une utilisation en ligne... 119 Accès à des documents protégés par une stratégie en ligne... 120 Accès aux documents protégés par une stratégie pour une utilisation hors ligne... 121 Normes et technologie liées à la sécurité... 122 Utilisation du service Rights Management... 122 Création de stratégies... 123 Modification de stratégies... 124 Suppression de stratégies... 124 Application de stratégies à des documents... 125 Suppression de stratégies de documents... 125 Modification de la stratégie appliquée à un document... 125 Révocation de l'accès à un document protégé par une stratégie... 126 Contrôle des événements... 127 28 Service Set Value...128 Utilisation du service Set Value... 128
Adobe Adobe LiveCycle ES Services LiveCycle ES 8 29 Service Signature...129 A propos des signatures numériques... 129 A propos des champs de signature... 130 A propos du service Signature et des types de formulaires... 131 A propos de la technologie des signatures numériques... 132 Intégration à une infrastructure de sécurité... 133 Technologies et normes prises en charge... 134 Utilisation du service Signature... 135 Signature et certification de documents... 135 Vérification de l'intégrité et de l'authenticité d'un document... 136 Suppression de signatures... 136 Récupération de signatures et de champs de signature... 137 Ajout, modification et suppression de champs de signature... 137 Meilleures pratiques... 137 Vérification de l'absence de rendu après la signature... 138 Conversion en formulaire non interactif... 139 Contrôle du type de formulaire... 139 Configuration requise pour la conception de formulaires et Workspace ES... 139 Ordre des opérations... 140 30 Service Stall...141 Utilisation du service Stall... 141 31 Service User...142 Utilisation du service User... 142 Affectation des tâches... 142 Configuration des fonctions de tâche... 143 Configuration des notifications par courrier électronique... 143 Enregistrement des informations de tâches terminées... 144 Interaction avec les tâches... 144 Réponse aux événements de tâches... 144 Récupération des informations de tâche... 145 Intervention dans l'état des tâches... 145 32 Service Variable Logger...146 Utilisation du service Variable Logger... 146 33 Service Wait Point...147 Utilisation du service Wait Point... 147 34 Service Service Web...148 Utilisation du service Service Web... 148 35 Service XMP Utilities...149 A propos des métadonnées XMP... 149 A propos des métadonnées des documents PDF... 149 Utilisation du service XMP Utilities... 150 36 Service XSLT Transformation...151 Utilisation du service XSLT Transformation... 151
Apropos dece document Ce document décrit les services qui permettent aux développeurs de créer des applications Adobe LiveCycle ES (Enterprise Suite) Update 1. Contenu de ce document Ce document propose des informations d introduction sur les services de LiveCycle ES et explique comment les utiliser pour exécuter différentes tâches dans le cadre d un processus d entreprise. Il contient également des informations sur la gestion des services et des applications. A qui est destiné ce document? Ce document est principalement destiné aux personnes chargées de concevoir des processus dansv Adobe LiveCycle Workbench ES ou aux développeurs qui souhaitent créer des applications clientes qui interagissent avec les services par programmation. Il contient également des informations intéressantes pour les administrateurs qui gèrent les serveurs et les applications LiveCycle ES. Informations complémentaires Vous trouverez également d autres informations sur les services dans les ressources répertoriées dans ce tableau. Pour plus de détails sur Composants de la solution LiveCycle ES Services utilisables sous licence avec chacun des composants de la solution LiveCycle ES Interfaces de programmation utilisables sous licence avec chacun des composants de la solution LiveCycle ES Utilisation d un service dans une cartographie des processus Utilisation de l API d un service Administration d un service Voir LiveCycle ES Présentation Services pour les composants de la solution LiveCycle ES Interfaces de programmation pour les composants de la solution LiveCycle ES Aide de LiveCycle Workbench ES Programmation avec LiveCycle ES Administration de LiveCycle ES 9
1 Présentation des services LiveCycle ES Chaque composant de la solution LiveCycle ES utilise plusieurs services pour exécuter différentes tâches dans le cadre d un processus d entreprise. Ce document décrit les services que les développeurs et les programmeurs peuvent utiliser pour créer des applications LiveCycle ES. Définition des services faisant partie d'un composant de la solution Chaque service est concédé sous licence pour être utilisé avec un ou plusieurs composants de la solution LiveCycle ES dans un environnement de production. Les services LiveCycle Foundation sont concédés sous licence pour être utilisés avec tous les composants de la solution LiveCycle ES. Pour plus de détails sur les services fournis avec chaque composant de la solution, reportez-vous à la section Services des composants de solution LiveCycle ES. Mode d utilisation des services par les développeurs Lorsqu un service ou une application sont déployés dans LiveCycle ES, ils peuvent être appelés par une application cliente à l aide de différents mécanismes. Dans LiveCycle Administration Console, un service peut être configuré pour être accessible par un ou plusieurs de ces mécanismes. Vous pouvez interagir avec un service d une des façons suivantes : Développement d un processus dans LiveCycle Workbench ES utilisant le service. Développement d une application cliente utilisant l API du service dans Java ou dans un environnement qui vous permet d utiliser son langage WSDL exposé, tel que Microsoft Visual Studio.NET (la plupart des services fournissent des API publiques). Développement d une application cliente dans Adobe Flex Builder utilisant LiveCycle Remoting pour interagir avec le service. La plupart des services peuvent être appelés à l aide de LiveCycle Remoting. Un service peut aussi être appelé en utilisant une messagerie électronique et des dossiers de contrôle. Pour plus de détails sur les différentes manières d'appeler les services, reportez-vous à la section «Appel de LiveCycle ES» dans le document Programmation avec LiveCycle ES. Mode d utilisation des services par les administrateurs L utilisation de LiveCycle Administration Console vous permet d effectuer les tâches suivantes : Configuration et gestion d utilisateurs, de groupes et de paramètres d authentification de serveur au moyen de User Management. Création et gestion des points de fin d appel et déploiement des fichiers d archives (LCA) de LiveCycle ES. Configuration de dossiers de contrôle et de fournisseurs de messagerie pour les appels de processus sans programme. Administration des propriétés de composant de la solution et des paramètres de serveur, comme les numéros de port et les fichiers journaux. 10
2 Service Assembler Le service Assembler permet de combiner plusieurs documents PDF en un seul, ou de diviser un document PDF en plusieurs documents PDF. Le service Assembler peut manipuler les documents de différentes façons, par exemple en redimensionnant les pages ou en faisant pivoter le contenu. Il peut insérer du contenu additionnel : en-têtes, pieds de page, table des matières. Vous pouvez également conserver, importer ou exporter du contenu existant, tel que des annotations, des pièces jointes et des signets. Chacun des travaux envoyés au service Assembler inclut un document DDX (Document Description XML) ainsi qu un ensemble de documents source. Le document DDX décrit comment utiliser les documents source pour générer un ensemble de documents cible. Cette section contient les rubriques suivantes : «A propos de DDX», page 11 «Utilisation du service Assembler», page 12 «Remarques sur le service Assembler», page 16 Apropos deddx Le service Assembler utilise un langage de type XML, appelé Document Description XML (DDX), avec lequel vous pouvez décrire la sortie que vous souhaitez obtenir. DDX est un langage de marquage déclaratif dont les éléments représentent des blocs de création de documents. Ces blocs de création comportent des pages PDF ainsi que d autres éléments tels que des commentaires, des signets et du texte avec style. Outre les documents PDF proprement dits, DDX peut décrire les formats de sortie représentant les données extraites des documents PDF (telles que commentaires, texte, données de formulaire, pièces jointes et signets) ou fournir des informations sur les propriétés d un document PDF. Vous pouvez utiliser DDX pour manipuler un document en même temps que vous utilisez les fonctions d'assemblage ou de désassemblage Vous pouvez combiner des effets parmi les suivants : ajout ou suppression de filigranes ou d arrière-plans sur les pages sélectionnées ; insertion ou suppression d en-têtes et de pieds de page sur les pages sélectionnées ; création ou aplatissement d un assemblage PDF ; renumérotation des intitulés de page (ces derniers sont généralement utilisés pour la numérotation des pages) ; importation de métadonnées à partir d un autre document source ; ajout ou suppression de pièces jointes, de signets, de liens et de commentaires ; définition des caractéristiques d affichage initiales et optimisation de l affichage sur le Web ; définition de droits pour les PDF chiffrés ; rotation de pages ou rotation et déplacement du contenu des pages. Pour plus de détails sur DDX, reportez-vous à la Référence DDX. 11
Service Assembler Services LiveCycle ES Utilisation du service Assembler 12 Utilisation du service Assembler Vous pouvez exécuter les tâches ci-dessous à l aide de ce service : «Assemblage de documents PDF», page 12 «Désassemblage de documents PDF», page 14 «Vérification de la compatibilité PDF/A des documents», page 15 «Validation de documents DDX», page 15 Pour plus d'informations sur le développement de processus utilisant ce service, reportez-vous àl Aide de LiveCycle Workbench ES. Pour plus de détails sur le développement d'applications clientes qui interagissent par programmation avec ce service, reportez-vous à la section Programmation avec LiveCycle ES. Assemblage de documents PDF Vous pouvez utiliser le service Assembler pour assembler deux documents PDF ou plus en un seul. L'illustration suivante présente la fusion de trois documents source en un seul. L'exemple suivant est une expression DDX simple utilisée pour assembler ce document. Il spécifie les noms des documents source à utiliser pour produire le document cible, ainsi que le nom de ce document cible : <PDF result="doc4"> <PDF source="doc1"/> <PDF source="doc2"/> <PDF source="doc3"/> </PDF> L assemblage de documents génère un document cible contenant les éléments suivants : totalité ou partie de chacun des documents source ; totalité ou partie des signets de chacun des documents source, normalisés pour le document cible assemblé ;
Service Assembler Services LiveCycle ES Assemblage de documents PDF 13 autres caractéristiques adoptées à partir du document de base (Doc1), telles que les métadonnées, les intitulés de page et la taille des pages ; en option, table des matières conçue à partir des signets du document cible. Assemblage de documents chiffrés Lors de l'assemblage d'un document, vous pouvez également chiffrer le document PDF avec un mot de passe. Après le chiffrement d'un document PDF avec un mot de passe, l'utilisateur doit spécifier un mot de passe pour l'afficher dans Adobe Reader, Adobe Acrobat Professional ou Acrobat Standard. Pour chiffrer un document PDF avec un mot de passe, le document DDX doit contenir les valeurs de chiffrement requises. Il n'est pas nécessaire que le service Encryption fasse partie de votre installation de LiveCycle ES pour chiffrer un document PDF avec un mot de passe. Si un ou plusieurs des documents d'entrée sont chiffrés, vous devez fournir un mot de passe pour ouvrir le(s) document(s) dans le DDX. Assemblage de documents à l'aide de la numérotation Bates Lors de l'assemblage d'un document, vous pouvez utiliser la numérotation Bates pour affecter un identifiant de page unique à chaque page. Avec la numérotation Bates, à chaque page du document (ou de l'ensemble de documents) correspond un numéro qui identifie la page de manière unique. Par exemple, des documents d'entreprise contenant une nomenclature et liés à la production d'un assemblage peuvent contenir un identifiant. Un numéro Bates contient une valeur numérique incrémentée séquentiellement, et optionnellement un préfixe et un suffixe. L'ensemble préfixe + valeur numérique + suffixe est dénommé modèle Bates L'illustration suivante présente un document PDF contenant un identifiant unique, situé dans l'en-tête du document. Aplatissement et assemblage de documents Vous pouvez utiliser le service Assembler pour assembler et transformer des documents PDF interactifs (par exemple, des formulaires) en document PDF non interactif. Un document PDF interactif permet aux utilisateurs de saisir ou de modifier des données contenues dans les champs de ce document. Le processus de transformation d'un document PDF interactif en document PDF non interactif est appelé aplatissement. Lors de l'aplatissement, les champs des formulaires gardent leur apparence graphique mais ne sont plus interactifs. S'assurer que les données ne peuvent être modifiées est l'une des raisons de l'aplatissement d'un document PDF. de plus, les scripts associés aux champs ne fonctionnent plus. Remarque : si le service Output ne fait pas partie de votre installation LiveCycle ES, le service Assembler peut assembler des documents PDF non interactifs si le document PDF d'entrée est basé sur un formulaire Acrobat ou un formulaire XFA statique. Cependant, si le document PDF
Service Assembler Services LiveCycle ES Désassemblage de documents PDF 14 d'entrée est un formulaire XFA dynamique, le service Output doit faire partie de votre installation LiveCycle ES. Si le service Output ne fait pas partie de votre installation LiveCycle ES lorsqu'un formulaire XFA dynamique est assemblé, une exception est générée. Désassemblage de documents PDF Vous pouvez utiliser le service Assembler pour désassembler un document PDF par l'extraction de certaines pages du document source ou en morcelant un document source à partir des signets. Cette tâche est particulièrement utile lorsque le document PDF d'origine a été créé à partir de plusieurs documents séparés, par exemple un ensemble d'articles. Extraction de pages d un document source Dans la figure ci-après, les pages 1 à 3 sont extraites du document source, puis insérées dans un nouveau document cible. Source documents Doc2 Pages 1-100 Result document Doc4 Pages 1-3 L'exemple suivant est une expression DDX utilisée pour assembler ce document. <PDF result="doc4"> <PDF source="doc2" pages="1-3"/> </PDF>
Service Assembler Services LiveCycle ES Vérification de la compatibilité PDF/A des documents 15 Morcellement d un document source à partir des signets Dans l'illustration ci-après, DocA est scindé en plusieurs documents cible où le premier signet de niveau 1 d une page identifie le début d un nouveau document cible. Source documents DocA Result document A.000001.Bkmk1.pdf A.000002.Bkmk2.pdf A.000003.Bkmk3.pdf L'exemple suivant est une expression DDX qui utilise des signets pour désassembler un document source. <PDFsFromBookmarks prefix="a"> <PDF source="doca"/> </PDFsFromBookmarks> Vérification de la compatibilité PDF/A des documents Vous pouvez utiliser le service Assembler pour déterminer si un document est compatible PDF/A. PDF/A est un format d'archivage, prévu pour la préservation sur le long terme du contenu d'un document. Les polices sont incluses dans le document, et le fichier est décompressé. Par conséquent, un document PDF/A est généralement plus lourd qu'un document PDF standard. de plus, un document PDF/A ne contient pas de contenu audio et vidéo. La spécification PDF/A-1 possède deux niveaux de conformité : A et B. La principale différence entre les deux concerne la prise en charge (accessibilité) de la structure logique qui n'est pas requise pour le niveau de conformité B. Pour le moment, seul le PDF/A-1b est pris en charge (validation et conversion). Validation de documents DDX Vous pouvez utiliser le service Assembler pour déterminer si un document DDX est valide. Par exemple, si vous avez fait une mise à jour depuis une version précédente de LiveCycle, et que vous voulez vérifier que votre document DDX est valide, vous pouvez le valider avec le service Assembler.
Service Assembler Services LiveCycle ES Remarques sur le service Assembler 16 Remarques sur le service Assembler Si vous ajoutez des en-têtes et des pieds de pages lors de l'assemblage de documents volumineux, une erreur OutOfMemory risque d'être générée, et que les fichiers ne sont alors pas assemblés. Pour réduire ce risque, ajoutez un élément <DDXProcessorSetting> à votre DDX. Par exemple : <DDXProcessorSetting name="checkpoint" value="2000" /> Vous pouvez rajouter cet élément en tant qu'élément enfant de l'élément <DDX> ou en tant qu'élément enfant d'un élément <PDF result>. La valeur par défaut pour ce paramètre est 0 (zéro), ce qui désactive les points de contrôle, et le DDX se comporte alors comme s'il n'y a pas d'élément <DDXProcessorSetting>. Si une erreur OutOfMemory a été générée, vous pouvez définir une valeur : un nombre entier, en général entre 500 et 5 000. Plus la valeur est petite, plus les points de contrôle sont fréquents, ce qui réduit la consommation de mémoire, mais diminue aussi la rapidité de l'assemblage. Pour plus de détails sur DDX, lisez la Référence DDX.
3 Service Barcoded Forms Le service Barcoded Forms extrait des données depuis des images électroniques de codes-barres. Il accepte en entrée des fichiers PDF et TIFF qui contiennent un ou plusieurs codes-barres et extrait les données de codes-barres. Les données de codes-barres peuvent être formatées d une multitude de façons, telles que les formats XML, chaîne délimitée ou tout format personnalisé créé avec JavaScript. Cette section fournit des informations sur les formulaires à codes-barres et présente brièvement comment les utiliser : «A propos des formulaires à codes-barres», page 17 «A propos des données de codes-barres», page 17 «Utilisation du service Barcoded Forms», page 20 «Codage et décodage des formats», page 20 «Jeux de caractères définis par l utilisateur», page 20 «Symbologies prises en charge», page 21 A propos des formulaires à codes-barres Les auteurs de formulaires créent des formulaires à codes-barres interactifs à l aide d'adobe LiveCycle Designer ES (8.2) (reportez-vous à l'aide de LiveCycle Designer ES). Lorsqu un utilisateur remplit un formulaire à codes-barres à l'aide d'adobe Reader ou d'acrobat, le code-barres est automatiquement mis à jour afin de coder les données de formulaire fournies par l utilisateur. Le service Barcoded Forms permet de transférer dans un format électronique des données qui existent sur papier. Par exemple, quand un formulaire à codes-barres est rempli et imprimé, la copie imprimée peut être numérisée et utilisée comme fichier d'entrée pour le service Barcoded Forms. Des dossiers de contrôle peuvent être utilisés pour lancer des applications qui utilisent le service Barcoded Forms. Par exemple, les scanners de documents peuvent enregistrer les images TIFF ou PDF de formulaires à codes-barres dans un dossier de contrôle. Le point de fin du dossier de contrôle transmet ces images au service LiveCycle ES pour le décodage. Remarque : les codes-barres ne doivent pas nécessairement provenir de formulaires. Le service Barcoded Forms peut décoder n'importe quel code-barres qui utilise une symbologie prise en charge. A propos des données de codes-barres Le service Barcoded Forms recherche les codes-barres d'une image, les décode et en extrait les données. Le service renvoie les données de codes-barres (à l aide d un codage d entité lorsqu il y a lieu) dans un 17
Service Barcoded Forms Services LiveCycle ES A propos des données de codes-barres 18 élément content d un document XML. Par exemple, l'image TIFF numérisée suivante d'un formulaire contient deux codes-barres :
Service Barcoded Forms Services LiveCycle ES A propos des données de codes-barres 19 Après le décodage des codes-barres, le service Barcoded Forms renvoie le document XML suivant : <?xml version="1.0" encoding="utf-8"?> <xb:scanned_image xmlns:xb="http://decoder.barcodedforms.adobe.com/xmlbeans" path="tiff" version="1.0"> <xb:decode> <xb:date>2007-05-11t15:07:49.965-04:00</xb:date> <xb:host_name>myhost.adobe.com</xb:host_name> <xb:status type="success"> <xb:message /> </xb:status> </xb:decode> <xb:barcode id="1"> <xb:header symbology="pdf417"> <xb:location page_no="1"> <xb:coordinates> <xb:point x="0.119526625" y="0.60945123" /> <xb:point x="0.44457594" y="0.60945123" /> <xb:point x="0.44457594" y="0.78445125" /> <xb:point x="0.119526625" y="0.78445125" /> </xb:coordinates> </xb:location> </xb:header> <xb:body> <xb:content encoding="utf-8">t_sid t_firstname t_middlename t_lastname t_nfirstname t_nmiddlename t_nlastname 90210 Patti Y Penne Patti P Prosciutto</xb:content> </xb:body> </xb:barcode> <xb:barcode id="2"> <xb:header symbology="pdf417"> <xb:location page_no="1"> <xb:coordinates> <xb:point x="0.119526625" y="0.825" /> <xb:point x="0.44457594" y="0.825" /> <xb:point x="0.44457594" y="0.9167683" /> <xb:point x="0.119526625" y="0.9167683" /> </xb:coordinates> </xb:location> </xb:header> <xb:body> <xb:content encoding="utf-8">t_formtype t_formversion ChangeName 20061128</xb:content> </xb:body> </xb:barcode> </xb:scanned_image>
Service Barcoded Forms Services LiveCycle ES Utilisation du service Barcoded Forms 20 Utilisation du service Barcoded Forms Vous pouvez exécuter les tâches ci-dessous à l aide de ce service : Extraire des données de codes-barres depuis des images de codes-barres (TIFF ou PDF). Les données sont stockées dans un format de texte délimité. Convertir des données dans un format de texte délimité en données XML (XDP ou XFDF). Les données XML sont plus faciles à analyser que le texte délimité. de plus, les données au format XDP ou XFDF peuvent être utilisées comme entrée pour d'autres services LiveCycle ES. Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous àl Aide de LiveCycle Workbench ES. Pour plus de détails sur le développement d'applications clientes qui interagissent par programmation avec ce service, reportez-vous à la section Programmation avec LiveCycle ES. Utilisez les pages Applications and Services de LiveCycle Administration Console pour configurer les propriétés par défaut de ce service (reportez-vous à l Aide à l administration du module Applications and Services). Codage et décodage des formats Les auteurs de formulaires à codes-barres sont invités à utiliser un format délimité simple (par exemple le format délimité par des tabulations) pour le codage des données dans des codes-barres, et à éviter l'utilisation du retour chariot comme délimiteur de champ. Designer ES propose des options de codage délimité qui génèrent automatiquement un script JavaScript pour coder les codes-barres. Les données décodées présentent les noms de champ sur la première ligne et leurs valeurs sur la seconde ligne avec des tabulations entre chacun des champs. Lors du décodage de codes-barres, vous devez indiquer le caractère utilisé pour délimiter les champs. Le caractère spécifié pour le décodage du code-barres doit être identique à celui utilisé pour son codage. Par exemple, lorsque les auteurs de formulaires utilisent un format délimité par des tabulations, l'opération Extraction vers XML dans les processus doit utiliser la valeur par défaut de Tab comme délimiteur de fichier. Jeux de caractères définis par l utilisateur Lorsque les auteurs de formulaires ajoutent des objets codes-barres à leurs formulaires à l aide de Designer ES, ils peuvent spécifier un codage de caractères. Les codages reconnus sont les suivants : UTF-8, ISO-8859-1, ISO-8859-2, ISO-8859-7, Shift-JIS, KSC-5601, Big-Five, GB-2312, UTF-16. Par défaut, toutes les données sont codées dans les codes-barres en UTF-8. Lors du décodage de codes-barres, vous pouvez spécifier le jeu de caractères à utiliser. Pour garantir le décodage correct de toutes les données, spécifiez le jeu de caractères indiqué par l auteur du formulaire lors de sa conception.
Service Barcoded Forms Services LiveCycle ES Symbologies prises en charge 21 Symbologies prises en charge Le service Barcoded Forms prend en charge les symbologies bidimensionnelles suivantes : PDF417 Data Matrix QR Code Ce service prend également en charge les symbologies unidimensionnelles suivantes : Codabar Code128 Code 3 sur 9 EAN13 EAN8
4 Services de connecteur pour ECM Adobe LiveCycle ES 8.2 Connector pour EMC Documentum, Adobe LiveCycle ES 8.2 Connector pour IBM Content Manager, et Adobe LiveCycle ES 8.2 Connector pour IBM FileNet fournissent lesservicessuivants: Un service de fournisseur de référentiels : le service Repository Provider pour EMC Documentum et le service Repository Provider pour IBM FileNet fournissent des capacités de stockage et de récupération via l'api Repository Service. Ces deux services permettent chacun aux développeurs d'accéder aux actifs stockés dans le référentiel de contenu ECM et de les gérer au moment de la conception. Lorsqu'un développeur conçoit un formulaire et crée une application dans LiveCycle Workbench ES ou à l'aide de l'api Repository Service, il peut utiliser les actifs du référentiel de contenu ECM au lieu du référentiel fourni avec LiveCycle ES. Ces actifs peuvent inclure des formulaires, des fichiers PDF, des fragments, des images, des schémas XML et des données de test. Les développeurs peuvent créer une application permettant aux services de LiveCycle ES d'accéder à ces actifs via l'api Repository Service, les variables de processus et les feuilles de propriétés. Les concepteurs de formulaires peuvent accéder à ces actifs et les stocker directement dans le référentiel de contenu ECM depuis Workbench ES. Un service de connecteur de référentiel de contenu : Le service Content Repository Connector pour EMC Documentum, le service Content Repository Connector pour IBM Content Manager et le service Content Repository Connector pour IBM FileNet sont tous indépendants et utilisables comme des opérations dans un processus LiveCycle ES. Les développeurs de Workbench ES peuvent utiliser ces services dans un processus pour stocker et récupérer des contenus dans des modèles de contenu personnalisés d'un référentiel de contenu ECM. Chaque service de connecteur fournit un accès à des objets de contenu et à leurs métadonnées stockées dans le référentiel de contenu ECM. Prenons l'exemple d'une institution financière qui automatise un processus d'ouverture de compte. Le processus doit permettre aux demandeurs de signer numériquement des formulaires d'application, d'archiver les formulaires complétés dans le référentiel ECM, de récupérer la déclaration finale et d'autres documents appropriés, d'assembler ces documents dans un fichier PDF unique et d'envoyer par courrier électronique ou postal le fichier PDF aux demandeurs. L'application LiveCycle ES que l'institution financière développe pour ce processus inclut des opérations de service de connecteur de référentiel de contenu pour stocker les formulaires complétés dans un type d'objet de contenu défini par le client dans le référentiel ECM et pour récupérer la documentation, qui peut être générée depuis d'autres applications ECM, à des fins d'assemblage à partir du référentiel ECM. Process Engine Connector pour le service IBM FileNet : les développeurs Workbench ES peuvent aussi utiliser le service Process Engine Connector pour IBM FileNet pour créer des processus qui positionnent et récupèrent les paramètres de IBM FileNet Workflow Step et qui distribuent les étapes du flux de production. (Reportez-vous à l'aide de LiveCycle Workbench ES.) Au moment de l'exécution, les actifs peuvent être récupérés depuis le référentiel de contenu ECM pour terminer ainsi un processus d'entreprise. Par exemple, des utilisateurs finaux peuvent accéder à des formulaires et envoyer des données de formulaire depuis Adobe LiveCycle Workspace ES (8.2), EMC Documentum Webtop, IBM Content Manager client, ou IBM FileNet P8 Workplace. de même, une application cliente peut récupérer et stocker des contenus dans le cadre d'un processus d'entreprise automatisé. 22
Services de connecteur pour ECM Services LiveCycle ES Utilisation des services de connecteur ECM 23 Utilisation des services de connecteur ECM Pour accéder à une ressource ECM depuis la vue de Ressources dans Workbench ES, ou pour appeler par programme l'api Repository Service, les administrateurs doivent sélectionner le fournisseur de service de référentiel ECM adéquat dans LiveCycle Administration Console au lieu du fournisseur de service de référentiel par défaut fourni avec LiveCycle ES. Pour plus de détails sur la configuration des services de connecteurs ECM, reportez-vous aux guides d'installation de LiveCycle ES, comme Installation et déploiement de LiveCycle ES pour JBoss. Vous pouvez accéder à un référentiel de contenu ECM en utilisant la vue LiveCycle Form Design dans Workbench ES. Vous serez connecté au référentiel Documentum par défaut ou à la banque d'objets FileNet. Vous pouvez également spécifier un référentiel Documentum ou FileNet lorsque vous vous connectez à Workbench ES. Vous devez disposer des informations d'identification appropriées pour accéder au référentiel de contenu. A chaque fois que vous utilisez Workbench ES, une connexion est établie au référentiel de contenu sélectionné. Le référentiel de contenu se présente sous la forme d'une structure de répertoires hiérarchiques (sous un répertoire docbase ou objectstore) dans la vue Ressources de Workbench ES. Vous pouvez partager avec d'autres développeurs le référentiel de contenu depuis Workbench ES. Lorsque vous développez un processus qui utilise un service de fournisseur de référentiels, vous pouvez spécifier l'url ressource vers le référentiel de contenu ECM dans les propriétés associées à un service, tel que le service Forms. Vous pouvez également spécifier l'url ressource à l'aide de l'api Forms Service. Remarque : Connector pour IBM Content Manager ne prend pour l'instant pas en charge le service de fournisseur de référentiels. Vous pouvez également accéder à un référentiel de contenu ECM à l'aide de l'api Repository Service pour stocker et récupérer automatiquement des informations. Par exemple, vous pouvez obtenir une liste de fichiers ou récupérer des fichiers spécifiques stockés dans un référentiel de contenu ECM lorsqu'un fichier est nécessaire dans le cadre du traitement d'une application. Vous pouvez utiliser un service de connecteur de référentiel de contenu dans un processus pour interagir avec des objets de contenu dans un référentiel de contenu ECM. Lorsque vous utilisez ce service dans un processus, vous pouvez accomplir les tâches suivantes, notamment : Accéder à un référentiel de contenu défini par l'utilisateur (un référentiel autre que celui utilisé par le fournisseur de référentiels) Récupérer un contenu et ses attributs depuis le référentiel de contenu qu'un autre service peut utiliser lors d'une étape ultérieure du processus Stocker un contenu et ses attributs dans le référentiel de contenu qu'un autre service a produit lors d'une étape antérieure du processus Obtenir la liste des modèles de données personnalisés disponibles dans le référentiel de contenu et faire correspondre des variables du processus à des attributs de contenu dans le référentiel de contenu Pour plus de détails sur le développement de processus utilisant ces services, reportez-vous àl Aide de LiveCycle Workbench ES. Pour plus de détails sur le développement d'applications clientes qui interagissent par programmation avec ce service, reportez-vous à la section Programmation avec LiveCycle ES.
Services de connecteur pour ECM Services LiveCycle ES Utilisation des services de connecteur ECM 24 Vous configurez la connexion par défaut au référentiel de contenu ECM, modifiez le fournisseur de services de référentiel et définissez d'autres paramètres par défaut spécifiques à ECM via LiveCycle Administration Console. (Reportez-vous à l'aide à l'administration du module Applications and Services, àl'aide à l'administration de Documentum, à l'aide à l'administration de IBM Content Manager, et à l'aide à l'administration de FileNet.)
5 Service Convert PDF Le service Convert PDF convertit des documents PDF en fichiers PostScript ou en images (au format JPEG, JPEG 2000, PNG et TIFF). La conversion d un document PDF en PostScript est utile pour les impressions sans assistance reposant sur un serveur exécutées sur n importe quelle imprimante PostScript. La conversion d un document PDF en fichier TIFF comportant plusieurs pages est pratique lors de l archivage de documents dans des systèmes de gestion de contenu qui ne prennent pas en charge les documents PDF. Utilisation du service Convert PDF Vous pouvez exécuter les tâches ci-dessous à l aide de ce service : Convertir des documents PDF en PostScript. Lors d'une conversion en PostScript, l'opération de conversion vous permet d'indiquer le document source et de choisir entre une conversion vers PostScript niveau 2 ou niveau 3. Le document PDF à convertir en PostScript doit être un document PDF non interactif. Convertir des documents PDF aux formats d image JPEG, JPEG 2000, PNG et TIFF. Lors de cette conversion, vous pouvez préciser le document source ainsi que des options d image définissant diverses préférences, comme le format d'image vers lequel convertir, la résolution de l'image et les paramètres de conversion de couleur. Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous àl Aide de LiveCycle Workbench ES. Pour plus de détails sur le développement d'applications clientes qui interagissent par programmation avec ce service, reportez-vous à la section Programmation avec LiveCycle ES. Utilisez les pages Applications and Services de LiveCycle Administration Console pour configurer les propriétés par défaut de ce service. (Reportez-vous à l Aide à l administration du module Applications and Services.) 25