Adobe 2.5 Manuel utilisateur

bc
Services LiveCycle® ES2.5
Adobe® LiveCycle® ES2.5
24 septembre 2010
Version 9.5
© 2010 Adobe Systems Incorporated and its licensors. Tous droits réservés.
Services Adobe® LiveCycle® ES2.5
24 septembre 2010
This reference document is licensed for use under the terms of the Creative Commons Attribution Non-Commercial 3.0 License. This
License allows users to copy, distribute, and transmit the document for noncommercial purposes only so long as (1) proper attribution to
Adobe is given as the owner of the document; and (2) any reuse or distribution of the document contains a notice that use of the document
is governed by these terms. The best way to provide notice is to include the following link. To view a copy of this license, visit
http://creativecommons.org/licenses/by-nc-sa/3.0/.
Adobe, the Adobe logo, Adobe Reader, Acrobat, Distiller, Flash, Flex Builder, FrameMaker, LiveCycle, PageMaker, Photoshop, and
PostScript are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. EMC
and Documentum are registered trademarks of EMC Corporation in the United States and around the world. Copyright 1994-2007 EMC
Corporation, all rights reserved. IBM and AIX are trademarks of International Business Machines Corporation in the United States, other
countries, or both. Red Hat is a trademark or registered trademark of Red Hat, Inc. in the United States and other countries. Linux is the
registered trademark of Linus Torvalds in the U.S. and other countries. Mac OS is a trademark of Apple Inc., registered in the United States
and other countries. Microsoft, OpenType, SharePoint, Windows, and Windows Server are either registered trademarks or trademarks of
Microsoft Corporation in the United States and/or other countries. Oracle, Sun, Solaris, and Java are trademarks or registered trademarks
of Oracle and/or its affiliates. UNIX is a registered trademark of The Open Group in the US and other countries. All other trademarks are
the property of their respective owners.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
3
Sommaire
A propos de ce document
Contenu de ce document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
A qui est destiné ce document ?
...............................................................................................................7
Informations complémentaires
................................................................................................................7
1. Présentation des services LiveCycle ES2.5
Définition des services faisant partie d'un module
..............................................................................................8
Mode d'utilisation des services par les développeurs
Mode d’utilisation des services par les administrateurs
...........................................................................................8
.........................................................................................8
2. Service Assembler
A propos de DDX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Utilisation du service Assembler
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Remarques sur le service Assembler
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
3. Service Barcoded Forms
Utilisation du service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Remarques sur le service
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4. Services Connector pour ECM
Utilisation des services de connecteur ECM
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
5. Service Central Migration Bridge
Utilisation du service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Remarques sur le service
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
6. Service Convert PDF
Utilisation du service Convert PDF
7. Service Decision Point
Utilisation du service Decision Point
8. Service Distiller
Utilisation du service Distiller
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Utilisation de l'imprimante réseau PDFG pour appeler Distiller
9. Service DocConverter
Utilisation du service DocConverter
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
10. Service Document Management
Utilisation du service Document Management
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Remarques sur LiveCycle Contentspace ES2.5
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
4
11. Service Email
Utilisation du service Email
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
12. Service Encryption
Utilisation du service Encryption
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Remarques sur le service Encryption
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
13. Service Execute Script
Utilisation du service Execute Script
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
14. Service FTP
Utilisation du service FTP
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Remarques sur le service FTP
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
15. Service File Utilities
Utilisation du service File Utilities
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
Remarques sur le service File Utilities
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
16. Service Form Augmenter
Utilisation du service Form Augmenter
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
17. Service Form Data Integration
Utilisation du service Form Data Integration
18. Service Forms
A propos des types de formulaires
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Comment le service Forms traite-il les demandes ?
Utilisation du service Forms
Options du service Forms
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Remarques sur le service Forms
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
19. Service Generate PDF
Utilisation du service Generate PDF
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Envoi de travaux de conversion au service Generate PDF
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Vérification du fonctionnement du système du service Generate PDF
20. Service Generate 3D PDF
Utilisation du service Generate 3D PDF
Appel du service Generate 3D PDF
21. Service JDBC
Utilisation du service JDBC
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Remarques sur le service JDBC
22. Service JMS
Utilisation du service JMS
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Remarques sur le service JMS
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
5
23. Service LCCPLM
Utilisation du service
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Remarques sur le service
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
24. Service LDAP
Utilisation du service LDAP
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Remarques sur le service LDAP
25. Service Output
Utilisation du service Output
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Remarques sur le service Output
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
26. Service PDF Utilities
Utilisation du service PDF Utilities
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110
27. Service Reader Extensions
Utilisation du service Reader Extensions
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
Remarques sur le service Reader Extensions
28. Service Repository
Utilisation du service Repository
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
29. Service Rights Management
A propos des stratégies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
A propos des jeux de stratégies
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
Méthodes et technologie liées à la sécurité
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120
Utilisation du service Rights Management
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125
Remarques sur le service Rights Management
30. Service Set Value
Utilisation du service Set Value
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130
31. Service Signature
A propos des signatures numériques
A propos des champs de signature
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
A propos du service Signature et des types de formulaires
A propos de la technologie des signatures numériques
Intégration à une infrastructure de sécurité
Technologies et normes prises en charge
Utilisation du service Signature
Meilleures pratiques
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139
32. Service Stall
Utilisation du service Stall
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141
33. Service Utilisateur
Utilisation du service Utilisateur
Interaction avec les tâches
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .142
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144
6
34. Service Variable Logger
Utilisation du service Variable Logger
35. Service Wait Point
Utilisation du service Wait Point
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146
36. Service Service Web
Utilisation du service Service Web
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147
37. Service XMP Utilities
A propos des métadonnées XMP
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148
A propos des métadonnées des documents PDF
Utilisation du service XMP Utilities
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149
38. \Service XSLT Transformation
Utilisation du service XSLT Transformation
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .150
7
A propos de ce document
Ce document décrit les services que les développeurs peuvent utiliser pour créer des applications Adobe® LiveCycle® ES2.5.
Contenu de ce document
Ce document propose des informations d’introduction sur les services de LiveCycle ES2.5 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 utilisateurs chargés de concevoir des processus dans Adobe LiveCycle Workbench. Il a pour
but d'aider les développeurs souhaitant générer des applications clientes qui interagissent par programmation avec des services. Il contient
également des informations intéressantes pour les administrateurs qui gèrent les serveurs et les applications LiveCycle ES2.5.
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
Voir
Modules LiveCycle ES2.5
LiveCycle ES2.5 Présentation
Interfaces de programmation utilisables sous licence avec chaque
module LiveCycle ES2.5
Interfaces de programmation pour les modules LiveCycle ES2.5
Utilisation d’un service dans une cartographie des processus
Aide LiveCycle Workbench 9.5
Utilisation de l’API d’un service
Programmation avec LiveCycle ES2.5
Administration d’un service
LiveCycle ES2.5 Aide sur l’administration
8
1. Présentation des services LiveCycle ES2.5
Chaque module LiveCycle ES2.5 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 ES2.5.
Définition des services faisant partie d'un module
Chaque service est concédé sous licence pour être utilisé avec un ou plusieurs modules LiveCycle ES2.5 dans un environnement de
production. Les services LiveCycle Foundation sont concédés sous licence pour être utilisés avec tous les modules LiveCycle ES2.5
(consultez la section Présentation de LiveCycle ES2.5.)
Mode d'utilisation des services par les développeurs
Lorsqu’un service ou une application sont déployés dans LiveCycle ES2.5, 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 de l’une des façons suivantes :
•
•
Développement d’un processus dans LiveCycle Workbench utilisant le service.
•
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.
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).
Un service peut aussi être appelé en utilisant une messagerie électronique et des dossiers de contrôle. De plus, certains services peuvent
appeler d'autres services automatiquement. Le service Assembler peut appeler d'autres services spécifiés dans le fichier DDX en cours de
traitement. Le service Generate PDF peut appeler d'autres services spécifiés par la fonction de l'imprimante Internet PDFG.
Pour plus de détails sur les différentes manières d'appeler les services par programmes, reportez-vous à la section Appel de LiveCycle ES2.5
dans Programmation avec LiveCycle ES2.5.
Mode d’utilisation des services par les administrateurs
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 ES2.5.
Configuration de dossiers de contrôle et de fournisseurs de messagerie pour les appels de processus sans programme.
Administration des propriétés des modules et des paramètres de serveur, comme les numéros de port et les fichiers journaux.
9
2. Service Assembler
Le service Assembler vous permet de combiner, d'organiser et d'étendre vos documents aux formats PDF et XDP. Grâce à lui, vous pouvez
également obtenir des informations sur les documents PDF. Chacun des travaux envoyés au service Assembler inclut un document DDX
(Document Description XML), ainsi qu’un ensemble de documents source et de ressources externes (chaînes et graphiques). Le document
DDX explique comment utiliser les documents source pour générer un ensemble de documents cible.
A propos de DDX
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 documents PDF et XDP, des fragments de formulaire XDP, ainsi que d’autres éléments tels que des
commentaires, des signets et du texte avec style.
Un document DDX peut spécifier des documents résultants présentant les caractéristiques suivantes :
•
•
•
•
•
•
•
Un document PDF assemblé à partir de documents PDF multiples.
Divers documents PDF issus d'un document PDF unique.
Un portfolio PDF incluant une interface utilisateur autonome et plusieurs documents, PDF et non PDF.
Un document XDP assemblé à partir de plusieurs documents XDP.
Un document XDP contenant des fragments XML insérés de manière dynamique dans un document XDP.
Un document PDF contenant un document XDP.
Des fichiers XML fournissant des informations sur les caractéristiques d'un document PDF. Les caractéristiques présentées incluent du
texte, des commentaires, des données de formulaire, des pièces jointes, des fichiers utilisés dans des portfolios PDF, des signets et des
propriétés PDF. Ces propriétés PDF indiquent les propriétés du formulaire, la rotation des pages et l'auteur du document.
Vous pouvez utiliser DDX pour étendre les documents PDF dans le cadre de l'assemblage et du désassemblage de documents. 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 ;
suppression de la structure et des capacités de navigation dans un package PDF ou un portfolio PDF (le résultat est un fichier PDF
unique) ;
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, de commentaires et de tout élément JavaScript ;
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 ;
modification de la taille des pages sélectionnées ;
fusion des données avec un PDF basé sur XFA.
ADOBE LIVECYCLE ES2.5
Service Assembler
10
Services LiveCycle ES2.5
Vous pouvez utiliser une simple mise en correspondance des entrées pour indiquer l'emplacement des documents source et cible. Il est
également possible d'utiliser les types d'URL suivants pour les données externes :
• Application
• Contentspace
• Fichier
• FTP
• HTTP/HTTPS
• Mise en correspondance des entrées
• Processus
• Référentiel (déconseillé pour toute utilisation dans le service Assembler)
Pour plus d'informations sur DDX, lisez les Références du service Assembler et du DDX (Document Description XML).
Utilisation du service Assembler
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à LiveCycle Workbench 9.5. Pour plus
d'informations sur le développement d'applications clientes qui interagissent par programmation avec ce service, reportez-vous à la section
Programmation avec LiveCycle ES2.5.
Assemblage de documents PDF
Vous pouvez utiliser le service Assembler pour assembler deux documents PDF ou plus en un seul document PDF ou portfolio PDF. Vous
pouvez également appliquer différentes fonctions au document PDF, afin de faciliter la navigation ou d'optimiser la sécurité. Vous pouvez
assembler des documents PDF de différentes manières, dont voici quelques exemples :
•
•
•
•
•
« Assemblage dans un document PDF unique », page 11
« Création d'un portfolio PDF », page 11
« Assemblage de documents chiffrés », page 12
« Assemblage de documents à l'aide de la numérotation Bates », page 12
« Aplatissement et assemblage de documents », page 12
ADOBE LIVECYCLE ES2.5
Service Assembler
11
Services LiveCycle ES2.5
Assemblage dans un document PDF unique
L'illustration suivante présente la fusion de trois documents source en un seul.
L'exemple suivant représente un document DDX utilisé 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 présentant certaines caractéristiques et 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é ;
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 ;
Le document produit peut inclure une table des matières générée à partir des signets présents dans les documents source (facultatif).
Création d'un portfolio PDF
Le service Assembler peut créer des portfolios PDF contenant un ensemble de documents et une interface utilisateur autonome. Cette
interface est appelée Interface de portfolio PDF ou Navigateur de portfolio PDF (navigateur). Les portfolios PDF élargissent les capacités des
paquets PDF en ajoutant un navigateur, des dossiers et des pages d'accueil. L'interface améliore l'expérience de l'utilisateur, qui peut profiter
des chaînes de texte localisées, des schémas de couleurs et des ressources graphiques personnalisées. Le portfolio PDF peut également
contenir des dossiers pour organiser les fichiers du portfolio.
Lorsque le service Assembler interprète le document DDX suivant, il assemble un portfolio PDF qui inclut un navigateur de portfolio PDF
et un paquet contenant deux fichiers. Le service récupère le navigateur à l'emplacement indiqué par la source myNavigator. Il change le
schéma de couleur par défaut du navigateur, le remplaçant par pinkScheme.
ADOBE LIVECYCLE ES2.5
Service Assembler
12
Services LiveCycle ES2.5
<DDX xmlns="http://ns.adobe.com/DDX/1.0/">
<PDF result="Untitled 1">
<Portfolio>
<Navigator source="myNavigator"/>
<ColorScheme scheme="pinkScheme"/>
</Portfolio>
<PackageFiles>
<PDF source="sourcePDF1"/>
<PDF source="sourcePDF2"/>
</PackageFiles>
</PDF>
</DDX>
Assemblage de documents chiffrés
Lors de l'assemblage d'un document, vous pouvez également chiffrer le document PDF avec un mot de passe. Lorsqu'un document PDF est
chiffré avec un mot de passe, l'utilisateur doit spécifier un mot de passe pour pouvoir l'afficher dans Adobe Reader ou Acrobat. 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 LiveCycle ES2 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 ce ou ces documents 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 appelé 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 transformer un document PDF interactif (par exemple, un formulaire) 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.
Lorsque vous créez un document PDF assemblé à partir de documents PDF interactifs, le service Assembler aplatit les formulaires avant de
les assembler en un même document.
Remarque : le service Assembler utilise Output pour aplatir les formulaires XFA dynamiques. Si le service Assembler traite un DDX ayant besoin
qu'il aplatisse un formulaire XFA dynamique et que le service Output n'est pas disponible, une exception est générée. Le service Assembler peut
aplatir un formulaire Acrobat ou un formulaire XFA statique sans utiliser le service Output.
ADOBE LIVECYCLE ES2.5
Service Assembler
13
Services LiveCycle ES2.5
Assemblage de documents PDF
Vous pouvez utiliser le service Assembler pour assembler un ou plusieurs documents XDP en un document PDF ou XDP unique. Pour les
fichiers XDP source incluant des points d'insertion, vous pouvez indiquer les fragments à insérer. Vous pouvez assembler des documents
XDP de différentes manières, dont voici quelques exemples :
•
•
•
« Assemblage d'un document XDP unique », page 13
« Insertion dynamique de fragments de formulaire dans un formulaire XFA », page 13
« Conversion d’un document XDP en document PDF », page 14
Assemblage d'un document XDP unique
L'illustration suivante présente la fusion de trois documents XDP source en un seul. Le document XDP produit contient les trois documents
XDP source, ainsi que les données connexes. Le document produit récupère les attributs de base du document d'origine (premier document
XDP source).
Voici le document DDX produisant la sortie illustrée ci-dessus.
<DDX xmlns="http://ns.adobe.com/DDX/1.0/">
<XDP result="MyXDPResult">
<XDP source="sourceXDP1"/>
<XDP source="sourceXDP2"/>
<XDP source="sourceXDP3"/>
</XDP>
</DDX>
Insertion dynamique de fragments de formulaire dans un formulaire XFA
Vous pouvez utiliser le service Assembler pour créer un formulaire XFA à partir d'un autre formulaire XFA, dans lequel des fragments ont
été insérés. Cette fonction vous permet d'utiliser des fragments pour créer plusieurs formulaires.
L'insertion dynamique des fragments de formulaire étant prise en charge, le contrôle du code source unique est possible. Il vous suffit de
disposer d'une source unique pour les composants les plus couramment utilisés. Par exemple, vous pouvez créer un fragment pour la
bannière de votre entreprise. Si cette dernière change, vous n'aurez qu'à modifier le fragment. Les autres formulaires incluant ce fragment
ne seront pas altérés.
ADOBE LIVECYCLE ES2.5
Service Assembler
14
Services LiveCycle ES2.5
Les concepteurs de formulaires utilisent Designer ES2.5 pour créer des fragments de formulaire. Ces fragments sont appelés formulaires
secondaires dans un formulaire XFA. Via Designer ES2.5, les concepteurs de formulaires peuvent également créer des formulaires XFA
présentant des points d'insertion dont le nom est unique. En tant que programmeur, vous pouvez rédiger des documents DDX définissant
le mode d'insertion des fragments dans le formulaire XFA.
L'illustration suivante représente deux formulaires XML (modèles XFA). Le formulaire placé à gauche contient un point d'insertion appelé
myInsertionPoint. Celui de droite inclut un fragment appelé myFragment.
Lorsque le service Assembler interprète le document DDX suivant, il crée un formulaire XML contenant un autre formulaire XML. Le
formulaire secondaire appelé myFragment du document myFragmentSource est inséré au niveau du point d'insertion myInsertionPoint
du document myFormSource.
<DDX xmlns="http://ns.adobe.com/DDX/1.0/">
<XDP result="myFormResult">
<XDP source="myFormSource">
<XDPContent fragment="myFragment" insertionPoint="myInsertionPoint" source="myFragmentSource"/>
</XDP>
</XDP>
</DDX>
Conversion d’un document XDP en document PDF
Vous pouvez utiliser le service Assembler pour convertir un document XDP en document PDF, comme le montre ce document DDX.
<DDX xmlns="http://ns.adobe.com/DDX/1.0/">
<PDF result="Untitled 1" encryption="passEncProfile1">
<XDP>
<XDP source="sourceXDP3"/>
<XDP source="sourceXDP4"/>
</XDP>
</PDF>
</DDX>
ADOBE LIVECYCLE ES2.5
Service Assembler
15
Services LiveCycle ES2.5
Désassemblage de documents PDF
Vous pouvez utiliser le service Assembler pour désassembler un document PDF. Ce service peut extraire des pages du document source ou
diviser un document source en fonction de 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 l'illustration ci-après, les pages 1 à 3 sont extraites du document source, puis insérées dans un nouveau document cible.
Documents source
Doc2
Pages 1-100
Document cible
Doc4
Pages 1-3
L'exemple suivant représente un document DDX utilisé pour désassembler ce document.
<PDF result="Doc4">
<PDF source="Doc2" pages="1-3"/>
</PDF>
ADOBE LIVECYCLE ES2.5
Service Assembler
16
Services LiveCycle ES2.5
Division d’un document source en fonction de signets
Dans l'illustration suivante, le document DocA est divisé en plusieurs documents cible. Le signet de niveau 1 d'une page identifie le début
du nouveau document cible.
Documents source
DocA
Document cible
A.000001.Bkmk1.pdf
A.000002.Bkmk2.pdf
A.000003.Bkmk3.pdf
L'exemple suivant représente un document 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 PDF est compatible PDF/A. PDF/A est un format d'archivage,
prévu pour la conservation 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 volumineux qu'un document PDF standard. De plus, un
document PDF/A ne contient aucune donnée 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).
Obtention d'informations supplémentaires sur un document PDF
Vous pouvez utiliser le service Assembler pour obtenir les informations suivantes concernant un document PDF :
•
•
Informations sur le texte.
• Nombre de mots sur chaque page du document.
• Emplacement de chaque mot sur chaque page du document.
• Nombre de phrases dans chaque paragraphe, sur chaque page du document.
Nombre de signets (incluant le numéro de la page, son titre, sa destination et son apparence). Vous pouvez exporter ces données depuis
un document PDF, puis les importer dans un autre document au même format.
ADOBE LIVECYCLE ES2.5
Service Assembler
17
Services LiveCycle ES2.5
•
Les pièces jointes, y compris les informations sur les fichiers. Pour les pièces jointes au niveau des pages, l'emplacement de l'annotation
de pièce jointe est également fourni. Vous pouvez exporter ces données depuis un document PDF, puis les importer dans un autre
document au même format.
•
Les fichiers de paquet, y compris les informations sur les fichiers, dossiers, paquets, schémas et données de champ. Vous pouvez exporter
ces données depuis un document PDF, puis les importer dans un autre document au même format.
Validation de documents DDX
Vous pouvez utiliser le service Assembler pour déterminer si un document DDX est valide. Par exemple, si vous avez effectué une mise à
niveau depuis une version précédente de LiveCycle, vous pouvez vérifier la validité du document DDX par ce biais.
Appel d'autres services LiveCycle ES2.5
Vous pouvez utiliser des documents DDX pour que le service Assembler appelle les services LiveCycle ES2.5 suivants. Le service Assembler
peut uniquement appeler les services installés via LiveCycle.
Service Reader Extensions : permet aux utilisateurs Adobe Reader de signer numériquement le document PDF cible.
Service Forms : fusionne un fichier XDP et un fichier de données XML pour créer un document PDF contenant le formulaire interactif
rempli.
Service Output : convertit un formulaire XML dynamique en document PDF contenant un formulaire non interactif (aplatit le formulaire).
Remarque : le service Assembler aplatit les formulaires XML statiques et les formulaires Acrobat sans appeler le service Output.
Service DocConverter : convertit un document PDF en document PDF/A.
Service Generate PDF : convertit des formats de fichier natifs en PDF. Exemples de formats de fichier natifs : Microsoft Word, Microsoft
Excel et HTML.
Service Generate 3D PDF : convertit des formats de fichier CAO en PDF.
Service Distiller : convertit un document PostScript en document PDF.
Les documents DDX décrivent les caractéristiques des documents PDF obtenus. Ils ne fournissent pas d'appels explicites aux services
LiveCycle ES2.5. Lorsque le service Assembler interprète certains éléments DDX, il détermine s'il doit appeler d'autres services LiveCycle
ES2.5 pour atteindre le résultat indiqué dans le document DDX. Par exemple, lorsque le service Assembler interprète un fichier source PDF
définissant un fichier non PDF, il appelle le service Generate PDF pour convertir ce fichier en PDF. De même, lorsque le service Assembler
interprète un fichier PDF source contenant un formulaire XML (formulaire XFA) et des données de formulaires XML séparées, il appelle le
service Forms pour fusionner les données dans le formulaire XML.
Les exemples DDX suivants combinent deux documents PDF et permettent aux utilisateurs d'Adobe Reader de signer numériquement le
document PDF obtenu. L'élément ReaderRights dans l'élément PDF obtenu active les droits d'utilisation d'Adobe Reader.
<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="http://ns.adobe.com/DDX/1.0/">
<PDF result=”outDoc”>
<PDF source=”doc1”/>
<PDF source=”doc2”/>
<ReaderRights
credentialAlias="LCESCred"
digitalSignatures=”true”/>
</PDF>
</DDX>
L'utilisation de DDX et du service Assembler pour appeler d'autres services LiveCycle ES2.5 peut simplifier votre schéma de processus. Il se
peut même que cela réduise l'effort de personnalisation de vos flux de production (reportez-vous également au document Références du
service Assembler et du DDX ).
ADOBE LIVECYCLE ES2.5
Service Assembler
18
Services LiveCycle ES2.5
Utilisation d'Assembler IVS pour vérifier les documents DDX
Assembler IVS (Assembler Installation and Verification Sample) est une application exemple destinée à vérifier des documents DDX sans
avoir à modifier de processus LiveCycle Workbench. Il fournit un éditeur pour la création et la modification des documents DDX (au format
XML) et pour la création d'un aperçu du résultat représenté par le document DDX. Assembler IVS inclut également les exemples suivants
illustrant différents concepts DDX :
• Assemblage d'un document
• Désassemblage d'un document à l'aide de signets et de pages
• Conversion d'un document PDF en un document PDF/A
• Création d'un lot PDF
• Obtention des métadonnées et du contenu à partir d'un document PDF
Assembler IVS utilise le service Invoke DDX du service Assembler.
Remarque : la fonction Document Builder de Workbench est le meilleur moyen de créer et de tester des documents DDX. Document Builder
fournit une interface utilisateur intuitive pour la création de documents DDX. Il vous permet de créer et de vérifier des documents DDX sans
avoir à travailler directement au format XML.
Vous devez déployer Assembler IVS avant de pouvoir l'utiliser. Les administrateurs peuvent utiliser LiveCycle Configuration Manager pour
déployer Assembler IVS. Ils peuvent également le déployer manuellement Reportez-vous aux guides d'installation LiveCycle ES2, tels que
Installation et déploiement de LiveCycle ES2 pour JBoss.
Pour démarrer l'application Assembler IVS, accédez à l'adresse http://[nom_serveur:numéro_port]/Assembler.
Voici un exemple de l'interface utilisateur d'Assembler IVS.
ADOBE LIVECYCLE ES2.5
Service Assembler
19
Services LiveCycle ES2.5
Voici la procédure à suivre pour tester un document DDX :
1
Définissez le DDX en copiant votre document DDX dans la grande fenêtre. Vous pouvez également utiliser un des documents DDX
disponibles en cliquant sur DDX ou sur Démos, en haut de la fenêtre.
2
Indiquez les fichiers d'entrée en cliquant sur le bouton plus (+) à côté du panneau Collatéral. Cette interface possède un champ qui vous
permet de naviguer jusqu'au fichier. Cliquez sur ce bouton pour chaque fichier utilisé comme élément collatéral.
3
Indiquez les fichiers d'entrée en cliquant sur le bouton plus (+) à côté du panneau de mise en correspondance des entrées. Si besoin,
modifiez le nom des entrées de la mise en correspondance pour faire correspondre les noms source dans votre document DDX. Cliquez
sur ce bouton pour chaque entrée dans le mappage de document.
4
Associez les fichiers d'entrée aux entrées de mise en correspondance en faisant glisser chaque fichier dans l'une des entrées de mise en
correspondance. Vous pouvez utiliser le même fichier plusieurs fois avec des entrées de mise en correspondance différentes. Vous
pouvez également placer plusieurs fichiers d'entrée dans la même entrée de mise en correspondance.
5
Appelez Assembler IVS en cliquant sur Appeler.
Si Assembler IVS crée le document PDF sans erreur, il affiche le résultat dans une nouvelle fenêtre du navigateur. En cas d'échec, il fournit
des détails sur l'erreur.
Remarques sur le service Assembler
L'assemblage et l'application de contenu dans des documents PDF volumineux peuvent monopoliser une grande quantité de mémoire,
occasionnant l'arrêt brutal du service Assembler, accompagné d'une exception signalant une quantité de mémoire insuffisante. Pour éviter
de déclencher ce type d'exception, utilisez les points de contrôle d'opération. Pour en savoir plus, consultez le document Références du
service Assembler et du DDX.
20
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.
Le service Barcoded Forms prend en charge les symbologies bidimensionnelles (2D) ci-après, fournies sous la forme de documents TIFF ou PDF :
• PDF417
• Data Matrix
• QR Code
Ce service prend également en charge les symbologies unidimensionnelles fournies sous la forme de documents TIFF ou PDF numérisés :
•
•
•
•
•
Codabar
Code128
Code 3 sur 9
EAN13
EAN8
Attention : Vous pouvez prendre en considération les restrictions ci-dessous lorsque vous utilisez le service Barcoded Forms :
•
Le service prend entièrement en charge AcroForm et les formulaires statiques contenant des codes-barres 2D qui sont simplement
enregistrés avec Adobe Reader ou Acrobat. Toutefois, pour les codes-barres 1D, vous devez aplatir le formulaire ou le fournir sous
forme de document PDF ou TIFF numérisé.
•
Les formulaires XFA dynamiques ne sont pas entièrement pris en charge. Pour que le service puisse décoder correctement les codesbarres 1D et 2D dans un formulaire dynamique, vous devez aplatir le formulaire ou le fournir sous forme de document PDF ou TIFF
numérisé.
En outre, il n’est pas nécessaire que les codes-barres soient issus de formulaires. Le service peut décoder n'importe quel code-barres qui
utilise une symbologie prise en charge. Il faut cependant que les restrictions indiquées ci-dessus soient respectées.
Pour plus d’informations sur la création de formulaires à codes-barres interactifs, voir l’Aide de LiveCycle Designer ES2.5.
Utilisation du service
Vous pouvez exécuter les tâches ci-dessous à l’aide du service Barcoded Forms :
•
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
ES2.5.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. Pour plus de
détails sur le développement des applications clientes qui interagissent par programmation avec ce service, reportez-vous à la section
Programmation avec LiveCycle ES2.5.
Vous pouvez utiliser les pages Applications and Services de LiveCycle Administration Console pour configurer les propriétés par défaut de
ce service (reportez-vous à la section Paramètres du service Barcoded Forms dans l'Aide à l'administration de LiveCycle ES2.5.)
ADOBE LIVECYCLE ES2.5
Service Barcoded Forms
Services LiveCycle ES2.5
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 élément content d’un document XML. Par exemple, l'image TIFF
numérisée suivante d'un formulaire contient deux codes-barres :
21
ADOBE LIVECYCLE ES2.5
Service Barcoded Forms
Services LiveCycle ES2.5
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>
Remarques sur le service
A propos des flux de production utilisant des formulaires à code-barres
Les auteurs de formulaires utilisent LiveCycle Designer ES2.5 pour créer des formulaires à codes-barres interactifs (reportez-vous à l'Aide
de LiveCycle Designer ES2.5 .) Lorsqu’un utilisateur remplit un formulaire à codes-barres à l'aide d'Adobe Reader ou d'Acrobat, le codebarres est automatiquement mis à jour afin de coder les données de formulaire fournies par l’utilisateur.
Le service Barcoded Forms permet de convertir 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.
22
ADOBE LIVECYCLE ES2.5
Service Barcoded Forms
23
Services LiveCycle ES2.5
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, à des fins de décodage.
Codage et décodage recommandés pour les 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 ES2.5 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 ES2.5, 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 au format 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.
24
4. Services Connector pour ECM
Adobe LiveCycle ES2 Connector pour EMC Documentum, Adobe LiveCycle ES2 Connector pour IBM Content Manager, Adobe
LiveCycle ES2 Connector pour IBM FileNet et Adobe LiveCycle ES2.5 Connector pour Microsoft SharePoint fournissent les services
suivants :
Un service de connecteur de référentiel de contenu : Il s'agit de services indépendants pouvant être utilisés en tant qu'opérations dans un
processus créé via LiveCycle ES2.5 :
• Content Repository Connector pour EMC Documentum
• Content Repository Connector pour IBM Content Manager
• Content Repository Connector pour IBM FileNet
• Content Repository Connector pour Microsoft SharePoint
Les développeurs LiveCycle Workbench peuvent utiliser ces services dans un processus, afin de stocker ou de récupérer un contenu
provenant de modèles de contenu personnalisés dans 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.
Si vous avez installé Adobe LiveCycle ES2.5 Connector pour Microsoft SharePoint, vous pouvez autoriser les utilisateurs du site SharePoint
à appeler des processus LiveCycle, tels que la conversion de documents dans le référentiel SharePoint au format Adobe PDF, l’application des
droits d’utilisation supplémentaires aux documents Adobe PDF et la protection de documents à l’aide de la stratégie Adobe. En outre, les
utilisateurs SharePoint peuvent créer et amorcer des flux de production qui utilisent les services disponibles sur le serveur LiveCycle
connecté.
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 ce
fichier aux demandeurs, par courrier électronique. L'application LiveCycle ES2.5 développée par l'institution financière pour ce processus
inclut les opérations d'un service de connecteur pour le référentiel de contenu. Ces opérations sont utilisées afin de répondre aux objectifs
suivants :
•
•
Stockage des formulaires remplis dans un type d'objet de contenu défini par le client, au sein du référentiel ECM.
Extraction du contenu, qui peut être généré à partir d'autres applications ECM ou assemblé depuis le référentiel ECM.
Process Engine Connector pour IBM FileNet pour le service IBM FileNet : Le service Process Engine Connector pour IBM FileNet
permet aux développeurs Workbench d'effectuer les opérations suivantes :
• Création de processus capables de définir et d'extraire les paramètres des étapes du flux de production IBM FileNet.
• Distribution d'une étape de flux de production dans IBM FileNet.
Au moment de l'exécution, les actifs peuvent être récupérés depuis le référentiel de contenu ECM afin de terminer 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 ES2.5, EMC Documentum Webtop, le client IBM Content Manager 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é.
Pour plus d'informations sur les services de connecteurs de référentiel de contenu et sur Process Engine Connector pour IBM FileNet,
consultez l'Aide de LiveCycle Workbench 9.5.
Remarque : dans les versions précédentes de LiveCycle, il était possible de stocker des éléments dans un référentiel ECM. Dans LiveCycle ES2.5,
les éléments peuvent être stockés dans le référentiel LiveCycle ES2.5 natif ; les services de fournisseur de référentiel sont désormais déconseillés.
La migration d'éléments d'un référentiel ECM vers le référentiel LiveCycle ES2.5 s'effectue lors de la mise à jour vers LiveCycle ES2.5. Pour plus
de détails, consultez le document relatif à la mise à niveau de LiveCycle ES2.5 pour votre serveur d’applications.
ADOBE LIVECYCLE ES2.5
Services Connector pour ECM
25
Services LiveCycle ES2.5
Utilisation des services de connecteur ECM
Pour accéder à une ressource ECM depuis la vue de Ressources dans Workbench, 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, en sélectionnant le fournisseur indiqué dans
LiveCycle Administration Console et non le fournisseur fourni par défaut avec LiveCycle ES2.5. Pour plus de détails sur la configuration des
services de connecteurs ECM, reportez-vous aux guides d'installation de LiveCycle ES2, comme Installation et déploiement de LiveCycle
ES2 pour JBoss.
Vous pouvez accéder à un référentiel de contenu ECM en utilisant la vue Conception de formulaire dans Workbench. Vous êtes alors
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. 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, 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. Vous pouvez partager avec d'autres développeurs le référentiel de contenu depuis
Workbench.
Remarque : vous ne pouvez pas utiliser Connector pour EMC Documentum pour créer des documents à la racine de Docbase. Préférez un fichier
CAB Docbase pour la création de vos documents. Ces restrictions sont dues à une limitation Documentum.
Lorsque vous développez un processus utilisant un service de fournisseur de référentiel, vous pouvez spécifier l'URL ressource vers le
référentiel de contenu ECM. Cette URL est indiquée dans les propriétés du service approprié (comme Forms). Vous pouvez également
spécifier l'URL ressource à l'aide de l'API Forms Service.
Remarque : pour l'instant, Connector pour IBM Content Manager ne prend pas en charge le service de fournisseur de référentiel.
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ès à un référentiel de contenu défini par l'utilisateur (autre que celui qu'utilise le fournisseur de référentiel).
•
Stockage d'un contenu et de ses attributs dans le référentiel de contenu, qu'un autre service a produit lors d'une étape antérieure du
processus.
•
Obtention de la liste des modèles de données personnalisés disponibles dans le référentiel de contenu et mise en correspondance des
variables du processus avec des attributs de contenu dans le référentiel de contenu.
•
Adobe LiveCycle ES2 Connector pour Microsoft SharePoint uniquement) Crée et amorce des flux de production SharePoint qui
utilisent les services de LiveCycle ES2.5
•
(LiveCycle ES2 Connector pour Microsoft SharePoint uniquement) Convertit des documents au format Adobe PDF, applique des droits
d'utilisation et active des fonctionnalités supplémentaires dans Adobe Reader
Récupération d'un contenu et de ses attributs depuis le référentiel de contenu, qu'un autre service peut utiliser lors d'une étape ultérieure
du processus.
La solution LiveCycle ES2 Connector pour Microsoft SharePoint offre les fonctions suivantes :
•
•
Permet aux utilisateurs d’appeler les processus LiveCycle ES2.5, tels qu'un processus d’approbation depuis SharePoint
•
•
•
Permet de créer et d’amorcer des flux de production SharePoint qui utilisent les services de LiveCycle ES2.5
Permet aux utilisateurs de convertir des documents au format Adobe PDF et de gérer les droits d’utilisation d’un fichier au format PDF
ou au format natif.
Permet aux utilisateurs d’appliquer les droits d’utilisation aux fichiers PDF pour activer les fonctions dans Adobe Reader
Permet l’automatisation de l’exécution des processus LiveCycle ES2.5 dans des flux de production SharePoint
ADOBE LIVECYCLE ES2.5
Services Connector pour ECM
•
•
26
Services LiveCycle ES2.5
Permet aux utilisateurs de gérer les tâches LiveCycle assignées et de demander de nouvelles tâches dans SharePoint 2010
Permet d’intégrer des formulaires LiveCycle avec SharePoint Server 2010 et d’utiliser SharePoint comme référentiel pour les données de
formulaire
Pour plus de détails sur le développement de processus utilisant ces services, reportez-vous à l’Aide de LiveCycle Workbench 9.5. 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 ES2.5. Pour plus de détails sur la configuration des sites SharePoint afin d'appeler des processus LiveCycle
ES2.5 et d'effectuer des opérations LiveCycle ES2.5, reportez-vous aux guides d'installation de LiveCycle ES2, comme Installation et
déploiement de LiveCycle ES2 pour JBoss.
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 à la section Connexion à un système de
gestion de contenu dans l'Aide à l'administration de LiveCycle ES2.5).
27
5. Service Central Migration Bridge
Le service Central Migration Bridge est fourni aux clients existants d'Adobe Output Server afin de les assister dans la migration vers
Adobe LiveCycle Output ES2.5. La gamme Adobe Output Server (Central) inclut les produits suivants :
• Adobe Output Designer
• Adobe Central Output Server
• Adobe Central Pro Output Server
• Adobe Web Output Pak
Ces produits proposent des fonctions similaires à celles de LiveCycle Output ES2.5. Ils reposent toutefois sur une technologie Adobe plus
mature.
Le service Central Migration Bridge vous permet d'utiliser un ensemble de fonctions Central Server dans un environnement LiveCycle
ES2.5. Il vous permet de continuer à utiliser vos éléments existants (tels que les modèles de sortie MDF et les fichiers TDF) avec LiveCycle
ES2.5.
Le service Central Migration Bridge n'est pas destiné à une utilisation générale pour les clients d'Output ES2.5. Il est destiné à ceux qui
possèdent déjà une installation d'Adobe Central Output Server et souhaitent migrer vers LiveCycle ES2.5. Pour pouvoir utiliser le service
Central Migration Bridge, vous devez disposer d'une licence valide d'Adobe Central Pro Output Server 5.7 ou d'un accord de migration
Adobe Central Pro Output Server 5.7 effectif. Pour en savoir plus sur les accords de migration, contactez votre représentant Adobe.
Utilisation du service
Le service Central Migration Bridge utilise un sous-ensemble de fonctionnalités d'Adobe Central Pro Output Server. Ce sous-ensemble
duplique les fonctionnalités fournies par Central Print Agent (agent d'impression Central), Central Transformation Agent (agent de
transformation Central) et Central XML Import Agent (agent d'importation XML Central). Il vous permet également de continuer à utiliser
les éléments Central suivants :
• Style de modèle (*.ifd)
• Modèles de sortie (*.mdf)
• Fichiers de données (fichiers *.dat), y compris le format de données Central aux champs désignés
• Fichiers de préface (fichiers *.pre)
• Fichiers de définition de transformation de données (*.tdf)
Pour pouvoir utiliser le service Central Migration Bridge, vous devez disposer de droits d'accès adéquats au répertoire d'installation de
Central.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. Pour plus
d'informations sur le développement d'applications clientes qui interagissent par programmation avec ce service, reportez-vous à la section
Programmation avec LiveCycle ES2.5.
ADOBE LIVECYCLE ES2.5
Service Central Migration Bridge
28
Services LiveCycle ES2.5
Opération de fusion Central
L'opération de fusion Central fusionne des données dans des modèles de sortie. Le résultat est renvoyé dans un format pris en charge par
Central, tel que IPL, ZPL, PDF, PS ou PCL. Cette opération peut recourir à un fichier de préface externe.
Par exemple, vous disposez d'un fichier de données aux champs désignés, contenant des informations sur le client (nom, adresse et numéro
de facture). Votre application peut utiliser l'opération de fusion Central pour fusionner le fichier de données avec un style de modèle de
sortie de facture. Les services LiveCycle ES2.5 suivants permettent à votre application d'envoyer des courriers électroniques, d'effectuer des
sauvegardes sur votre disque ou d'imprimer le fichier de sortie :
• Service Email
• Service File Utilities
• Opération sendToPrinter du service Output
En plus des paramètres d'entrée principaux (fichier de données et modèle), cette opération accepte une chaîne de caractères représentant les
options de ligne de commande passées à la commande Central JFMERGE. Ces options vous permettent d'indiquer toutes les options
standard que vous utilisez dans votre base de données de gestion de travaux (JMD) Central actuelle.
L'opération de fusion Central peut créer un fichier de trace. Pour activer cette fonction, indiquez l'option de fichier de trace. Vous pouvez
utiliser le fichier de trace pour atteindre une page 1 sur n dans le schéma de numérotation des documents créés, en effectuant les tâches
suivantes :
1
Exécutez la fusion Central une fois, afin d'obtenir un fichier de trace.
2
Effectuez une deuxième opération de fusion Central sur ce fichier de trace, afin de mettre en forme la numérotation des pages.
Cette fusion exécute la commande Central JFMERGE (agent d'impression Central). Le fichier jfmerge.ini est utilisé de la même façon
qu'avec Central Pro.
Opération de transformation Central
Cette opération permet de convertir un texte structuré ou superposé en données formatées acceptables. Les données obtenues peuvent être
utilisées avec l'opération de fusion Central. L'opération de transformation Central permet de convertir des données créées au format ASCII,
y compris les formats de données de longueur fixe, les formats délimités par des caractères, les formats superposés, XML et le format
propriétaire Central aux champs désignés. Cette opération convertit ces données au format XML ou dans un format aux champs désignés.
Elle fournit également une fonction de script que vous pouvez utiliser pour modifier un fichier de données existant. Voici quelques
applications de la fonction de script :
• Modification de données dans un format que vous pouvez fusionner avec une conception de formulaire.
• Transformation de données existantes, telles que les dates, du format MM-JJ-AAAA au format JJ-MM-AAAA.
En plus des paramètres d'entrée principaux (fichier de données et fichier TDF), cette opération accepte une chaîne de caractères représentant
les options de ligne de commande passées à la commande Central JFTRANS.
L'opération de transformation Central exécute la commande Central JFTRANS (agent de transformation Central). Le fichier jfmerge.ini est
utilisé de la même façon qu'avec Central Pro.
Opération d'importation XML Central
Cette opération permet de transformer des données XML bien formées en un format aux champs désignés.
En plus des paramètres d'entrée principaux (fichier XML), cette opération accepte une chaîne de caractères représentant les options de ligne
de commande passées à la commande Central XMLIMPORT.
L'opération d'importation XML Central exécute la commande Central XMLIMPORT. Le fichier xmlimport.ini est utilisé de la même façon
qu'avec Central Pro.
ADOBE LIVECYCLE ES2.5
Service Central Migration Bridge
29
Services LiveCycle ES2.5
Opération d'accès aux données Central
Cette opération permet d'accéder à certains éléments d'un fichier de données aux champs désignés (fichier DAT) au sein d'un processus
LiveCycle ES2.5. Elle extrait les commandes ^field, ^global, ^form et ^job du fichier de données et les transforme de manière à obtenir un
document XML intermédiaire. Votre processus peut utiliser des expressions XPath pour accéder aux valeurs de certaines entrées spécifiques
au sein du fichier de données XML. Il peut avoir recours aux valeurs ainsi atteintes pour la prise de décisions ou transmettre le fichier XML
intermédiaire à d'autres services LiveCycle ES2.5.
LiveCycle Workbench fournit une boîte de dialogue XPath Builder qui simplifie la création d'expressions XPath.
Remarque : l'opération d'accès aux données Central ne convertit pas les fichiers de données aux champs désignés en une représentation XML
totalement équivalente. Au lieu de cela, certains éléments spécifiques sont convertis en une représentation XML intermédiaire.
Grâce à l'opération d'accès aux données Central, l'intégration d'applications Central Pro existantes dans LiveCycle ES2.5 est simplifiée.
L'exemple suivant tire parti de cette opération pour identifier les valeurs de commandes aux champs désignés spécifiques dans le fichier de
données :
1
Appel de l'opération d'accès aux données Central pour obtenir une représentation XML intermédiaire des commandes du fichier de
données.
2
Utilisation d'une expression XPath pour obtenir la valeur de la commande ^job aux champs désignés (valeur du travail).
3
Utilisation de la valeur du travail pour déterminer quel modèle utiliser avec les données.
4
Appel de l'opération de fusion Central pour la fusion du modèle sélectionné avec le fichier de données original, afin de produire un
document PDF.
5
Utilisation d'une expression XPath pour obtenir la valeur de la commande ^field EMAILADDRESS, indiquée par la représentation XML
intermédiaire.
6
Appel du service Email pour l'envoi du fichier PDF à l'expéditeur du travail, par courrier électronique.
L'opération d'accès aux données Central n'exécute aucune commande Central.
Remarques sur le service
Vous pouvez utiliser le service Central Migration Bridge pour migrer progressivement les aspects de vos éléments et votre version d'Adobe
Output Server. LiveCycle ES2.5 et Central Migration Bridge ne traitent pas les résultats de fichiers journaux de la même manière qu'Adobe
Central Pro Output Server.
Migration
La migration des bibliothèques de modèles et la modification des sources de données associées peuvent représenter la partie la plus
importante de l'opération de migration. Grâce au service Central Migration Bridge, vous pouvez migrer une application de Central
vers Output ES2.5, en procédant par étapes.
Etape initiale : déplacez les aspects d'appel et d'exécution depuis un environnement Central vers un environnement LiveCycle ES2.5. Vous
pouvez continuer à utiliser les éléments de modèles et de données Central existants. Si vous utilisez une base de données de gestion de
travaux (JMD) Central, remplacez-la par des processus LiveCycle ES2.5. Output ES2.5 ne prend pas cette base de données en charge et ne
fournit aucun outil pour sa conversion.
Si vos modèles Central existants ont été enregistrés avec une version d'Output Designer antérieure à 5.7, ils peuvent fonctionner tels quels.
Cependant, dans certaines instances (en particulier avec les modèles antérieurs à la version 5.4), il est possible que vous deviez migrer vos
modèles Central existants à l'aide d'Output Designer 5.7. Si vous utilisez cette application pour ouvrir et enregistrer des modèles, ceux-ci
sont automatiquement migrés. Utilisez Output Designer 5.7 pour tester les modèles migrés et vérifier qu'ils fonctionnent comme prévu.
ADOBE LIVECYCLE ES2.5
Service Central Migration Bridge
30
Services LiveCycle ES2.5
Etapes suivantes : convertissez ensuite différents modèles et éléments de données non XML de façon à pouvoir les utiliser avec Output
ES2.5. Vous pouvez utiliser simultanément des processus nouveaux ou convertis sur le même serveur LiveCycle ES2.5. Vous pouvez
convertir tous vos éléments au fur et à mesure, afin de ne plus avoir besoin de recourir au service Central Migration Bridge.
Vous pouvez utiliser LiveCycle Designer ES2.5 pour importer des modèles Output Designer. Pour activer cette fonction, installez Output
Designer avec LiveCycle Designer ES2.5. Ensuite, pour utiliser cette fonction, ouvrez un fichier de type modèle Adobe Output Designer
(*.ifd). Designer ES2.5 effectuera une conversion basique. Le degré de complétude de la conversion dépend de la complexité du formulaire
d'entrée. Utilisez Designer ES2.5 pour compléter le processus de conversion. (Pour en savoir plus, voir l'Aide de LiveCycle Designer ES2.5
et la section Conception de formulaires pour LiveCycle Output ES2.)
Résultats de journal
Les fichiers journaux produits par Central et Central Migration Bridge ne sont pas accessibles via la même méthode. Central crée un fichier
centralisé, tandis que le service Central Migration Bridge renvoie le fichier journal à l'application ou au processus à l'origine de l'opération.
Pour enregistrer le journal renvoyé par le service Central Migration Bridge, envoyez-le dans un système de fichiers. L'enregistrement du
journal est particulièrement utile pour le débogage.
Pour ajuster la quantité de contenu du fichier journal, définissez les valeurs dans les fichiers .ini standard.
Exigences
Le service Central Migration Bridge requiert que vous installiez Adobe Central Pro Output Server 5.7 sur le même ordinateur que celui qui
héberge LiveCycle ES2.5. Le service Central Migration Bridge ne prend pas en charge les versions antérieures
d'Adobe Central Pro Output Server. Reportez-vous aux guides d'installation LiveCycle ES2, tels que Installation et déploiement de
LiveCycle ES2 pour JBoss.
Central Migration Bridge prend en charge les mêmes plates-formes que LiveCycle ES2.5.
Exemples
LiveCycle ES2.5 fournit des exemples montrant comment utiliser le service Central Migration Bridge. (Consultez la section Exemples
LiveCycle ES2.)
31
6. Service Convert PDF
Le service Convert PDF convertit des documents PDF en fichiers PostScript ou en images (aux formats 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 du service Convert PDF :
•
Convertir des documents PDF en PostScript. Lors d'une conversion au format PostScript, vous pouvez indiquer le document source et
choisir entre une conversion vers PostScript niveau 2 ou 3. Le document PDF à convertir en fichier PostScript ne doit pas être 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 et fournir une spécification portant sur les options d’image. Cette spécification contient différentes préférences,
définissant notamment le format de conversion d’image, la résolution d’image et la conversion de couleur.
•
(Déconseillé) Décompressez les fichiers d'une archive dans un répertoire quelconque.
Remarque : cette opération est déconseillée depuis LiveCycle ES 8.2. Cependant, LiveCycle ES2.5 vous permet toujours de l'effectuer.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. Pour plus
d'informations sur le développement d'applications clientes qui interagissent par programmation avec ce service, reportez-vous à la section
Programmation avec LiveCycle ES2.5.
Utilisez les pages Applications and Services de LiveCycle Administration Console pour configurer les propriétés par défaut de ce service
(reportez-vous à la section Paramètres du service Convert PDF dans l'Aide à l'administration de LiveCycle ES2.5.)
32
7. Service Decision Point
Le service Decision Point est utilisé dans les processus Workbench pour la création de branches de décisions.
Voici quelques exemples de situations qui requièrent l'utilisation du service Decision Point :
•
Plusieurs itinéraires doivent être évalués pour déterminer la première opération à exécuter au cours d’un processus.
Cette situation se produit lorsqu'un processus est initié par un envoi de formulaire et que les données de ce formulaire déterminent la
première action à exécuter dans le cadre du processus Workbench. Par exemple, un client peut remplir un formulaire de contestation de
facture depuis le site Web d’une entreprise. Le montant requis par la facture détermine si le formulaire doit être acheminé vers un
responsable de premier niveau pour approbation ou vers un représentant du crédit, à des fins de traitement.
•
Plusieurs itinéraires d'un processus convergent en un point où un ensemble de règles sont évaluées.
Cette situation peut se produire lorsque le processus fait une boucle passant par une étape où un ensemble de règles sont réévaluées. Par
exemple dans un processus d'assurance qualité, un problème doit faire l'objet d'un nouveau processus de test jusqu'à ce qu'il soit résolu
et que le processus puisse se poursuivre.
Cette situation peut aussi se produire si plusieurs branches convergent après avoir été parallèles. Par exemple, dans un processus de
recrutement de nouveaux employés, au moment de l'embauche d'un candidat, plusieurs sous-processus du processus du recrutement
sont initiés. Lorsque chacun de ces sous-processus se termine, plusieurs règles utilisant les données de tous les sous-processus sont
évaluées pour déterminer l'étape suivante.
Utilisation du service Decision Point
Vous pouvez utiliser ce service dans un processus si vous avez besoin que plusieurs itinéraires proviennent d'une opération, tant que la
création de branche ne fait pas partie d'une autre opération du processus. Le service Decision Point fait office de nœud dans le processus,
qui sert d'origine à de nombreux itinéraires mais n'a aucune fonction exécutable en soi.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
33
8. Service Distiller
Le service Distiller® convertit les fichiers PostScript, Encapsulated PostScript (EPS) et PRN en fichiers PDF. Le service Distiller est
généralement utilisé pour convertir en documents électroniques d’importants volumes de documents papier, tels que des factures et des
déclarations. La conversion de documents en PDF permet également aux entreprises d’envoyer à leurs clients un document à la fois dans sa
version papier et dans sa version électronique.
Remarque : afin de convertir des fichiers PostScript en documents PDF, Acrobat 9 ou le package redistribuable de Microsoft Visual C++ 2005
doit être installé sur le serveur hébergeant LiveCycle.
Utilisation du service Distiller
Lors de la conversion d’un fichier PostScript, Encapsulated PostScript ou PRN en fichier PDF, vous pouvez spécifier plusieurs options à
appliquer au document PDF obtenu. Voici les paramètres que vous pouvez utiliser pour définir ces options :
•
Paramètres PDF : cette option indique le nom des paramètres PDF d’Adobe à utiliser pour la conversion. Les paramètres indiqués sont
définis dans LiveCycle Administration Console. Par défaut, certains paramètres PDF Adobe sont préconfigurés sur la console. Le nom
de ces paramètres dépend des paramètres régionaux. Sur un système disposant d'une version du logiciel en anglais, ces noms sont les
suivants : High Quality Print, PDFA1b 2005 CMYK et Press Quality.
Si le paramètre Document de paramètres d'entrée fournit une valeur, il est ignoré. Si ce paramètre et le paramètre Document de
paramètres d'entrée ont tous les deux une valeur nulle, l'instance des paramètres du type de fichier définie par défaut sur le serveur
LiveCycle ES2.5 est utilisée.
•
Paramètres de sécurité : cette option indique le nom des paramètres de protection à utiliser pour la conversion. Les paramètres indiqués
sont définis dans LiveCycle Administration Console. Sur un système disposant d'une version du logiciel en anglais, seuls les paramètres
de sécurité No Security sont préconfigurés sur la console.
Si le paramètre Document de paramètres d'entrée fournit une valeur, il est ignoré. Si ce paramètre et le paramètre Document de
paramètres d'entrée ont tous les deux une valeur nulle, l'instance des paramètres du type de fichier définie par défaut sur le serveur
LiveCycle ES2.5 est utilisée.
•
Document de paramètres d'entrée : fichier XML contenant des paramètres de conversion, incluant les paramètres PDF et les paramètres
de sécurité Adobe PDF. Le document de paramètres d'entrée peut inclure différents jeux de paramètres. Cette opération a uniquement
recours aux jeux par défaut (reportez-vous à la section Références deparamètres de conversion LiveCycle ES2.5 Generate PDF.)
•
Métadonnées à appliquer au document PDF généré. Seules les métadonnées Adobe Extensible Metadata Platform (XMP) codées en
UTF-8 sont prises en charge. Pour connaître les spécifications et obtenir pour plus de détails sur ce format, rendez-vous sur la page
d'accueil XMP, sur le site Web d'Adobe.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. 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 ES2.5.
Vous pouvez utiliser les pages Applications and Services de LiveCycle Administration Console pour configurer les propriétés par défaut de
ce service. (Reportez-vous à la section Paramètres du service Distiller dans l'Aide à l'administration de LiveCycle ES2.5.) Vous pouvez aussi
utiliser la page de LiveCycle PDF Generator ES2.5 pour spécifier les options par défaut PDF et de protection à appliquer lors de la conversion
au format PDF (Reportez-vous à la section Configuration de PDF Generator ES2.5 et PDF Generator 3D ES2.5 dans l'Aide à l'administration
de LiveCycle ES2.5).
ADOBE LIVECYCLE ES2.5
Service Distiller
34
Services LiveCycle ES2.5
Utilisation de l'imprimante réseau PDFG pour appeler Distiller
Vous pouvez appeler l'opération CreatePFD2 du service Distiller en utilisant une des techniques décrites dans la section « Mode d'utilisation
des services par les développeurs », page 8. Vous pouvez également envoyer des travaux de conversion vers cette opération en utilisant
l'imprimante réseau PDFG (imprimante IPP).
Le pilote de l'imprimante réseau PDFG est installé sur l'ordinateur de bureau, à l'instar de tout autre pilote d'impression. Les utilisateurs
profitent alors de la centralisation de la génération des PDF proposée par le module PDF Generator ES2.5 depuis n'importe quelle
application sur leur ordinateur de bureau.
L'utilisation de l'imprimante réseau PDFG implique les étapes suivantes :
1
Les utilisateurs impriment les documents vers l'imprimante réseau PDFG.
2
L'imprimante réseau PDFG convertit les fichiers envoyés dans un flux PostScript et utilise un protocole d'impression Internet (IPP) pour
envoyer le flux au service Distiller.
3
Le service Distiller convertit le flux en PDF. La conversion utilise les paramètres Adobe PDF spécifiés dans la configuration de
l'imprimante réseau PDFG.
4
Le service Distiller renvoie les résultats de la conversion au demandeur, par courrier électronique. Il peut également envoyer les résultats
de la conversion vers un autre service ou processus LiveCycle ES2.5. Cette fonction fait de l'imprimante réseau PDFG un autre point de
fin LiveCycle ES2.5.
Pour qu'un utilisateur puisse imprimer un document sur une imprimante réseau PDFG, l'administrateur doit configurer le système de
l'utilisateur avec l'interface client pour l'imprimante réseau PDFG. Pour plus d'informations sur l'installation du pilote d'impression,
consultez le guide Installation et déploiement de LiveCycle ES2. Pour plus d'informations sur la configuration de cette fonction, reportez-vous
à la section Configuration d'une imprimante réseau PDFG Network Printer dans l'Aide à l'Administration de LiveCycle ES2.5.
35
9. Service DocConverter
Le service DocConverter transforme des documents PDF signés ou non signés, des formulaires XML (notamment ceux créés avec
LiveCycle Designer ES2.5), et des formulaires Acrobat en documents compatibles PDF/A. Vous pouvez également utiliser ce service pour
valider si des documents PDF sont compatibles avec le format PDF/A, qui est utilisé principalement pour l'archivage.
Le service DocConverter est fourni avec les modules LiveCycle ES2.5 suivants :
• Adobe LiveCycle PDF Generator ES2.5
• Adobe LiveCycle PDF Generator 3D ES2.5
• Adobe LiveCycle Output ES2.5
Pour utiliser le service DocConverter avec des formulaires XML, vous devez disposer du service Output ES2.5. Pour utiliser le service
DocConverter avec des documents qui contiennent des champs de signature signés ou non signés, vous devez disposer de LiveCycle Digital
Signatures ES2.5.
Utilisation du service DocConverter
Vous pouvez exécuter les tâches ci-dessous à l’aide du service DocConverter :
• « Vérification de la compatibilité PDF/A des documents PDF », page 35
• « Conversion de documents PDF en documents PDF/A », page 35
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. Pour plus de
détails sur le développement des applications clientes qui interagissent par programmation avec ce service, reportez-vous à la section
Programmation avec LiveCycle ES2.5.
Vérification de la compatibilité PDF/A des documents PDF
Vous pouvez utiliser le service DocConverter pour vérifier la compatibilité d'un document PDF avec la norme PDF/A-1b (ISO 19005-1b).
Conversion de documents PDF en documents PDF/A
Vous pouvez utiliser le service DocConverter pour transformer les fichiers de types suivants en documents PDF compatibles avec PDF/A-1b :
• Documents PDF signés ou non
• Formulaires XML (habituellement créés dans Designer ES2.5)
• Formulaires Acrobat
PDF/A-1b est la norme ISO pour l'archivage à long terme de documents reposant sur PDF. La conservation à long terme étant l'objectif
poursuivi, le document ne contient que les informations nécessaires à une compréhension adaptée et à un bon rendu du contenu. Les
éléments suivants sont inclus :
•
•
•
Métadonnées associées, afin de faciliter la compréhension du contenu.
Schéma des métadonnées personnalisées éventuelles.
Polices. Toutes les polices sont incorporées. Par conséquent, un document PDF/A est généralement plus volumineux qu'un document
PDF standard.
ADOBE LIVECYCLE ES2.5
Service DocConverter
36
Services LiveCycle ES2.5
Les documents PDF/A ne peuvent contenir ni utiliser aucun des éléments suivants :
• Scripts et contenus audio et vidéo
• Encryption
• Scripts
La norme PDF/A-1 possède des restrictions qui ont une incidence sur la conversion des signatures et des formulaires. Lorsque le service
DocConverter convertit des fichiers en PDF/A-1b, il les modifie de sorte qu'ils soient compatibles avec les normes PDF/A-1b. (Reportezvous aux sections « Signatures », page 36, « Formulaires Adobe XML », page 36 et « Formulaires Acrobat », page 36.)
Si le service DocConverter ne peut pas effectuer de conversion complète d'un fichier au format PDF/A, il le convertit partiellement. En plus
du fichier converti, le service DocConverter crée également un rapport de conversion. Le rapport indique si des correctifs ont été appliqués
au fichier et si certains problèmes n'ont pas pu être résolus.
Bien que PDF/A soit la norme pour l'archivage de documents PDF, il ne vous est pas demandé de l'utiliser pour effectuer votre archivage.
Un document PDF standard peut répondre aux exigences de votre entreprise. L'objectif de la norme PDF/A est d'établir un fichier PDF
conçu pour répondre aux besoins d'archivage et de conservation des documents sur le long terme (reportez-vous également à la section
Adobe PDF, norme d'archivage et Traitement de documents PDF/A.)
Signatures
Par défaut, le service DocConverter supprime toutes les signatures d'un fichier PDF à l'exception de la dernière. Le service capture les
informations à propos des signatures supprimées dans les métadonnées. Il enregistre également l'apparence des signatures supprimées en
ajoutant une image équivalente dans le fichier PDF. Il est impossible de vérifier les signatures supprimées.
Les utilisateurs peuvent signer un document PDF/A.
Formulaires Adobe XML
Un fichier PDF/A ne peut pas contenir de modèle de formulaire XML (formulaires XFA).
Le service DocConverter aplatit les modèles de formulaire XML qui apparaissent dans le fichier PDF, y compris les signatures XML. Le
service capture les informations à propos des signatures supprimées dans les métadonnées. Il enregistre également l'apparence des
signatures supprimées dans le document en ajoutant une image équivalente dans le fichier PDF. Il est impossible de vérifier les signatures
aplaties.
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. De même, les données du
formulaire ne peuvent pas être extraites à l'aide d'outils standard, bien qu'elles soient toujours présentes dans le document PDF/A.
Formulaires Acrobat
Un fichier PDF/A peut contenir tout type de champ de formulaire interactif Acrobat, à condition que ces champs soient visibles. Les champs
peuvent contenir des données, mais pas des scripts.
37
10. Service Document Management
Le service Document Management permet aux processus d'utiliser la fonctionnalité de gestion de contenu fournie par
Adobe LiveCycle Content Services ES2.5. Pour plus de détails concernant LiveCycle Content Services ES2.5, reportez-vous à la section
Présentation de LiveCycle ES2.5.
Utilisation du service Document Management
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. Pour plus de
détails sur le développement des applications clientes qui interagissent par programmation avec ce service, reportez-vous à la section
Programmation avec LiveCycle ES2.5.
Vous pouvez utiliser 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 de LiveCycle ES2.5.)
Utilisation de contenus et d'espaces
Un contenu est un fichier ou un document constitué de deux éléments principaux : le contenu proprement dit d'une part et les informations
sur le contenu (les métadonnées) d'autre part. Par exemple, les fichiers peuvent être des documents, des films, des sons, des images, des
données XML ou HTML, etc. Les contenus peuvent être ajoutés ou créés dans des espaces du référentiel Content Services ES2.5 et peuvent
être classés et organisés en catégories.
Un espace sert à sauvegarder et organiser des éléments de contenu et d'autres espaces. Un espace peut contenir n'importe quel type de
contenu.
Vous pouvez utiliser les opérations de service de Document Management pour exécuter les opérations suivantes :
Créer un espace : crée un espace dans Content Services ES2.5.
Créer un espace depuis un espace ou un modèle existant : crée un espace dans Content Services ES2.5, à partir d'un espace ou d'un
modèle existant. L'ensemble des règles, des contenus et des utilisateurs sont copiés dans le nouvel espace depuis l'espace ou le modèle existant.
Afficher le contenu d'un espace spécifié : récupère une liste de fichiers et d'espaces présents dans l'espace spécifié.
Effacer un contenu ou un espace : efface le contenu ou l'espace indiqué et les métadonnées qui lui sont associées. Lorsque vous effacez un
espace, tous ses contenus sont également effacés. Lorsque vous effacez un contenu, toutes les versions de ce contenu sont effacées.
Copier un élément de contenu ou un espace : copie un élément de contenu ou un espace et ses métadonnées associées d'un espace à un
autre. Lorsque vous copiez un espace, tous ses contenus sont également copiés.
Si l'emplacement choisi contient déjà un espace associé au même nom, le nouvel espace est appelé Copie de [nom de l'espace].
Stocker un contenu : stocke ou met à jour un contenu et ses métadonnées dans le référentiel Content Services ES2.5.
Déplacer un élément de contenu ou un espace : déplace un contenu ou un espace et ses métadonnées associées d'un emplacement
(espace) à un autre. Lorsque vous déplacez un espace, tous ses contenus sont également déplacés.
Récupérer un contenu : récupère un contenu et ses métadonnées associées.
Importer du contenu : ajoute le contenu stocké dans un fichier ZIP ou ACP dans le référentiel. La création des fichiers ACP intervient lors
de l'exportation d'un contenu depuis Adobe LiveCycle Contentspace ES2.5. L'arborescence d'origine du contenu est préservée lors de cette
exportation.
ADOBE LIVECYCLE ES2.5
Service Document Management
38
Services LiveCycle ES2.5
Utilisation des associations
Une association est une manière de lier ensemble deux éléments de contenu ou plus dans le référentiel. Les types d'associations suivants sont
disponibles dans LiveCycle Workbench :
• Association entre un fichier de données XML et un attachement
• Association liant un fichier de données XML et un formulaire PDF
• Association liant deux documents PDF
Vous pouvez aussi créer vos propres associations. Vous pouvez utiliser les opérations de service de Document Management pour exécuter
les opérations suivantes :
Créer des associations entre des éléments de contenu : crée une association entre deux éléments de contenu ou répertoires dans le
référentiel.
S'associer : récupère une liste d'identifiants d'éléments de contenu associés au contenu spécifié à l'aide d'un certain type d'association.
Utilisation des attributs de contenu
Les attributs de contenu sont les métadonnées d'un élément de contenu. Les métadonnées sont stockées dans une base de données, séparées
du contenu auquel elles correspondent. Cette structure permet une recherche plus rapide parmi les métadonnées.
Vous pouvez utiliser les opérations de service de Document Management pour exécuter les opérations suivantes :
Récupérer les attributs de contenu : récupère les attributs associés au contenu spécifié.
Définir les attributs de contenu : définit les attributs de métadonnées du contenu sans modifier le contenu. La version du contenu n'est
pas affectée par cette opération.
Supprimer les aspects du contenu : supprime des aspects spécifiques du contenu. Les aspects sont des collections d'attributs appliquées à
un contenu.
Gérer les droits d'accès à un contenu : gère une liste d'utilisateurs et de groupes autorisés à accéder au contenu.
Vérifier les droits d'accès à un contenu : permet d'obtenir une liste des droits d'accès octroyés pour le contenu spécifié. Cette liste indique
le type de droit d'accès accordé à chaque utilisateur et à chaque groupe, ainsi que l'état de cet accès.
Remarques sur LiveCycle Contentspace ES2.5
Pour ouvrir et remplir des formulaires via LiveCycle Contentspace ES2.5,procédez comme suit :
1
Accédez à l'espace hébergeant le formulaire.
2
Affichez les détails du fichier.
3
Cliquez sur l'option de renseignement des formulaires.
Lorsque l'utilisateur envoie le formulaire, les données sont extraites et enregistrées dans un fichier XML. Lors de l'utilisation de LiveCycle
Designer ES2.5 pour concevoir un formulaire XDP auquel on accédera de cette manière, n'incluez pas d'URL d'envoi dans le formulaire. En
effet, le cas échéant, les données du formulaire soumis ne seront pas accessibles depuis Contentspace ES2.5, car l'URL d'envoi n'aura pas été
remplacée.
39
11. Service Email
Le service Email est généralement utilisé pour diffuser du contenu ou fournir des informations d’état dans le cadre d’un processus
automatisé. Le service Email permet aux processus de recevoir des courriers électroniques d’un serveur POP3 ou IMAP et d’en envoyer à un
serveur SMTP.
Par exemple, un processus utilise le service Email pour envoyer un courrier électronique pourvu d’un formulaire PDF joint. Le service Email
se connecte à un serveur SMTP pour envoyer le courrier électronique avec la pièce jointe. Le formulaire au format PDF est conçu pour
permettre au destinataire d'appuyer sur le bouton d'envoi lorsqu'il l'a rempli. Le formulaire est alors renvoyé sous forme de pièce jointe au
serveur de messagerie indiqué. Le service Email récupère le courrier électronique renvoyé, puis stocke le formulaire complété dans une
variable de formulaire des données de processus.
Lorsque le service Email se connecte à un serveur POP3 ou IMAP pour récupérer un courrier électronique, il doit être en mesure d'identifier
ce dernier avec précision dans la boîte de réception. En général, cette identification est effectuée via l'intégration d'un identifiant unique dans
la ligne d’objet (par exemple l’identifiant de processus) ou via la recherche d'un expéditeur particulier. Le service Email permet de
personnaliser le texte les champs De, A, Objet et Corps de texte d’un courrier électronique. Les développeurs peuvent spécifier des critères
de recherche pour un courrier électronique correspondant, tel que l’expéditeur ou l’objet du courrier.
Utilisation du service Email
Vous pouvez interagir avec le service Email en développant un processus dans LiveCycle ES2.5 qui utilise ce service. Vous pouvez exécuter
les tâches ci-dessous à l’aide du service Email :
•
Configuration des propriétés par défaut du service Email pour la connexion à un serveur SMTP, afin de pouvoir envoyer des courriers
électroniques. Il est alors nécessaire de définir la connexion à un serveur POP3 ou IMAP, afin de pouvoir en recevoir.
•
Réception des courriers électroniques et des pièces jointes à partir d’un serveur de messagerie POP3 ou IMAP. Vous pouvez enregistrer
aussi bien les métadonnées sur le message que le contenu du message. Vous pouvez également définir des filtres pour les courriers
électroniques ainsi que des propriétés relatives au serveur de messagerie et au compte utilisateur à utiliser.
• Envoi d'un courrier électronique comportant une ou plusieurs pièces jointes à un serveur SMTP.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
Vous pouvez aussi utiliser les pages Applications and Services de LiveCycle Administration Console pour configurer les propriétés par
défaut de ce service. (Reportez-vous à la section Paramètres du service Email dans l'Aide à l'administration de LiveCycle ES2.5).
40
12. Service Encryption
Le service Encryption permet de chiffrer et de déchiffrer des documents. Lorsqu'un document est chiffré, son contenu devient illisible. Vous
pouvez chiffrer l'intégralité d'un document PDF (contenu, métadonnées et pièces jointes), tous les éléments autres que ses métadonnées ou
uniquement les pièces jointes. Un utilisateur autorisé peut déchiffrer le document pour pouvoir accéder à son contenu. Si un document PDF
est chiffré avec un mot de passe, l'utilisateur doit alors spécifier le mot de passe d'ouverture pour pouvoir visualiser le document dans Adobe
Reader ou Acrobat. Si un document PDF est chiffré avec un certificat, l'utilisateur doit déchiffrer ce document avec la clé publique
(certificat) qu'il possède, qui doit correspondre à la clé publique, utilisée pour le chiffrement.
Utilisation du service Encryption
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. 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 ES2.5.
Vous pouvez utiliser les pages Applications and Services de LiveCycle Administration Console pour configurer les propriétés par défaut de
ce service (reportez-vous à la section Paramètres du service Encryption dans l'Aide à l'administration de LiveCycle ES2.5.)
Chiffrement de documents PDF avec un mot de passe
Utilisez le service Encryption pour chiffrer des documents PDF avec un mot de passe. Si vous chiffrez un document PDF avec un mot de
passe, les utilisateurs devront indiquer ce même mot de passe pour pouvoir ouvrir le document PDF dans Adobe Reader ou Acrobat. Vous
pouvez choisir de chiffrer tout le document PDF (contenu, métadonnées et pièces jointes), tous les éléments autres que ses métadonnées ou
uniquement les pièces jointes. Si vous chiffrez uniquement les pièces jointes du document, les utilisateurs devront fournir un mot de passe
uniquement lorsqu'ils tenteront d'accéder aux pièces jointes du fichier.
Lorsque vous chiffrez un document PDF avec un mot de passe, vous devez indiquer deux mots de passe différents. Le premier sert à chiffrer
et à déchiffrer le document PDF. Le deuxième sert à supprimer le chiffrement du document PDF ou à modifier les autorisations.
Si vous utilisez un mot de passe pour chiffrer un document PDF, vous pouvez ajouter des autorisations qui indiquent ce que les utilisateurs
recevant le document peuvent en faire (le signer et le remplir, le modifier ou l'imprimer, par exemple).
Un document PDF chiffré via un mot de passe doit être déverrouillé pour qu'il soit possible de lui appliquer une autre opération LiveCycle
ES2.5, par exemple une signature numérique. (reportez-vous à la section « Déverrouillage des documents PDF chiffrés », page 41).
Remarque : nous vous recommandons de ne pas chiffrer un document avant de le télécharger dans le référentiel. Si vous téléchargez un document
PDF chiffré dans le référentiel, celui-ci ne pourra pas le déchiffrer ni extraire le contenu XDP.
Suppression d'un chiffrement avec mot de passe
Le service Encryption permet de supprimer le chiffrement par mot de passe appliqué à un document PDF. Les utilisateurs ont la possibilité
d'ouvrir le document PDF dans Adobe Reader ou Acrobat sans avoir besoin d'indiquer un mot de passe. Une fois le chiffrement avec mot
de passe supprimé du document PDF, celui-ci n'est plus sécurisé.
ADOBE LIVECYCLE ES2.5
Service Encryption
41
Services LiveCycle ES2.5
Chiffrement des documents PDF avec certificat
Utilisez le service Encryption pour chiffrer des documents PDF au moyen de certificats. Le chiffrement avec certificat vous permet d'utiliser
des clés publiques pour chiffrer des documents adressés à des destinataires particuliers. Le chiffrement à base de clés publiques utilise deux
types de clés :
•
Une clé publique, stockée à l'intérieur du certificat et qu'il est possible de partager avec d'autres utilisateurs. Le certificat de clé publique
est au format X.509. Il contient la clé publique d'un utilisateur et ses données d'identification.
• Une clé privée, qu'il n'est pas possible de partager avec les autres utilisateurs.
Les documents sont chiffrés au moyen des clés publiques (certificats) des utilisateurs qui recevront le document. A la réception d'un
document chiffré, les utilisateurs se servent de leurs clés privées pour le déchiffrer.
Les certificats sont généralement émis et signés numériquement par des autorités de certification. Une autorité de certification est une entité
reconnue qui garantit la validité du certificat. Les certificats comportent une date d'expiration ; après cette date, ils ne sont plus valides. En
outre, les listes de révocation des certificats (CRL) fournissent des informations sur les certificats révoqués avant leur date d'expiration. Les
autorités de certification mettent ces listes à jour régulièrement. Vous pouvez également récupérer l'état de révocation d'un certificat par
l'intermédiaire du protocole OCSP (Online Certificate Status Protocol, protocole d'état de certificat en ligne) sur le réseau.
Si vous utilisez des certificats pour chiffrer un document PDF, vous pouvez ajouter des autorisations qui indiquent ce que chacun des
utilisateurs recevant le document peut en faire. Par exemple, libre à vous d'indiquer s'ils sont autorisés à signer et à renseigner, à modifier
ou à imprimer le document PDF.
Avant de chiffrer un document PDF avec un certificat, vous devez utiliser LiveCycle Administration Console pour ajouter ce certificat à
LiveCycle ES2.5.
Remarque : nous vous recommandons de ne pas chiffrer un document avant de le télécharger dans le référentiel. Si vous téléchargez un document
PDF chiffré dans le référentiel, celui-ci ne pourra pas le déchiffrer ni extraire le contenu XDP.
Un document PDF chiffré via un mot de passe doit être déverrouillé pour qu'il soit possible de lui appliquer une autre opération LiveCycle
ES2.5, par exemple une signature numérique. (reportez-vous à la section « Déverrouillage des documents PDF chiffrés », page 41).
Suppression du chiffrement avec certificat
Le service Encryption permet de supprimer le chiffrement par certificat appliqué à un document PDF. Les utilisateurs ont alors la possibilité
d'ouvrir le document PDF dans Adobe Reader ou Acrobat. Pour supprimer le chiffrement d'un document PDF chiffré avec certificat, vous
devez référencer une clé publique. Une fois le chiffrement du document PDF supprimé, celui-ci n'est plus sécurisé.
Déverrouillage des documents PDF chiffrés
Utilisez le service Encryption pour déverrouiller les documents PDF chiffrés avec mot de passe ou certificat. Si vous tentez d'effectuer une
opération LiveCycle ES2.5 sur un document PDF chiffré, une exception sera générée. Après avoir déverrouillé un document PDF chiffré,
utilisez le service Signature pour effectuer une ou plusieurs opérations sur celui-ci (par exemple une signature numérique).
Détermination du type de chiffrement
Utilisez le service Encryption pour déterminer le type de chiffrement entrant dans la protection d'un document PDF. Il est parfois nécessaire
de déterminer de manière dynamique si un document PDF est chiffré, et s'il l'est, le type de chiffrement utilisé. Par exemple, vous pouvez
déterminer si un document PDF est protégé par un chiffrement avec mot de passe ou au moyen d'une stratégie Rights Management.
(reportez-vous à la section « Service Rights Management », page 118).
ADOBE LIVECYCLE ES2.5
Service Encryption
42
Services LiveCycle ES2.5
Un document PDF peut être protégé par les types de chiffrement suivants :
•
•
•
•
Chiffrement avec mot de passe
Chiffrement avec certificat
Stratégie mise en place par le service Rights Management
Autre mécanisme de chiffrement
Remarques sur le service Encryption
Toute combinaison de chiffrement, certification et application des droits d'utilisation sur un même document doit se dérouler dans l'ordre
suivant. Ces services doivent être appelés au court d'un processus de courte durée :
1
Appliquez un chiffrement (service Encryption) ou une stratégie (service Rights Management) à un document avant de le signer
numériquement (service Signature). Une signature numérique enregistre l’état du fichier au moment de la signature. Si vous chiffrez le
document ou appliquez une stratégie après avoir appliqué une signature sur ce dernier, les octets du fichier sont modifiés, la signature
apparaissant alors comme étant incorrecte.
2
Certifiez un document PDF (service Signature) avant de définir ses droits d’utilisation (service Reader Extensions). Si vous certifiez un
document après avoir appliqué ses droits d’utilisation, la signature des droits d’utilisation est invalidée, ce qui provoque la suppression
des droits d’utilisation du document.
3
Signez numériquement un document PDF (service Signature) après avoir défini les droits d’utilisation. La signature d’un document PDF
après l’application des droits d’utilisation n’invalide pas la signature des droits d’utilisation.
Par ailleurs, vous ne pouvez pas chiffrer un document PDF et lui appliquer une stratégie. De la même façon, vous ne pouvez pas appliquer
une stratégie à un document PDF chiffré.
43
13. Service Execute Script
Le service Execute Script permet d’exécuter des scripts dans des processus.
Utilisation du service Execute Script
Vous pouvez interagir avec le service Execute Script en développant un processus dans LiveCycle Workbench utilisant ce service.
Le service Execute Script prend en charge BeanShell 1.3.0, un langage de script compatible avec la syntaxe Java pour la plate-forme Java. Les
objets implicites sont disponibles dans le script. Ces objets exécutent les tâches suivantes :
•
Accès au Gestionnaire d’objets, au Gestionnaire de processus, aux propriétés de déploiement, au contexte JNDI initial et au contexte de
l’application JNDI.
• Stockage des informations collectées à la suite de l’exécution d’un script et transfert des données vers le serveur LiveCycle ES2.5.
• Insertion de toutes les données contextuelles à utiliser pendant l’exécution d’un script.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
Vous pouvez utiliser 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 de LiveCycle ES2.5.)
44
14. Service FTP
Grâce au service FTP, les processus peuvent interagir avec un serveur FTP. Les opérations du service FTP permettent de récupérer des
fichiers du serveur FTP, de placer des fichiers sur le serveur FTP et de supprimer des fichiers du serveur FTP. Par exemple, vous pouvez
stocker des documents, tels que des rapports générés à partir d’un processus, sur un serveur FTP, en vue de les distribuer. Un système externe
peut également générer des fichiers en fonction des étapes précédentes d’un processus. Dans une étape suivante du processus, les fichiers
peuvent être transférés à un emplacement distant.
Utilisation du service FTP
Vous pouvez interagir avec le service FTP en développant un processus dans LiveCycle Workbench utilisant ce service. Vous pouvez
exécuter les tâches ci-dessous à l’aide du service FTP :
• Spécification de l’hôte, du port et des informations d’identification d’utilisateur par défaut pour la connexion au serveur FTP.
• Récupération d’une liste de fichiers résidant dans un répertoire d’un serveur FTP.
• Récupération de plusieurs fichiers du serveur FTP basés sur un modèle de nom de fichier.
• Récupération d’un fichier à partir du serveur FTP et enregistrement de ce fichier sur le système de fichiers du serveur LiveCycle ES2.5.
• Récupération du contenu d’un fichier à partir du serveur FTP et enregistrement du contenu sous la forme de données de processus.
• Téléchargement de données de processus vers un répertoire du serveur FTP et enregistrement des données en tant que fichier.
• Téléchargement d’une ou de plusieurs valeurs de document sur le serveur FTP.
• Téléchargement d’un fichier du système de fichiers du serveur LiveCycle ES2.5 vers un répertoire du serveur FTP.
• Suppression d’un fichier du serveur FTP.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
Vous pouvez utiliser les pages Applications and Services de LiveCycle Administration Console pour configurer les propriétés par défaut de
ce service (reportez-vous à la section Paramètres du service FTP dans l'Aide à l'administration de LiveCycle ES2.5.)
Remarques sur le service FTP
Vous devez tenir compte des facteurs ci-dessous lors du développement des processus utilisant ce service :
•
Si vous spécifiez des chemins locaux aux fichiers ou aux répertoires dans les propriétés des opérations, ces chemins sont interprétés
comme étant sur le système de fichiers du serveur LiveCycle ES2.5.
•
Le compte utilisateur utilisé pour l’exécution du serveur LiveCycle ES2.5 doit posséder les autorisations requises pour interagir avec les
fichiers et les emplacements des fichiers ciblés par les opérations du service.
45
15. Service File Utilities
Le service File Utilities permet aux processus d’interagir avec le système de fichiers du serveur LiveCycle ES2.5 ou d'autres systèmes de
fichiers auxquels le serveur peut accéder.
Les fichiers sont généralement utilisés pour être intégrés à différents systèmes. Le service File Utilities peut permettre à un processus de lire
ou d'écrire des fichiers en utilisant différents formats (XML, texte délimité par des virgules et PDF). Grâce à ce service, le processus a la
possibilité de créer un fichier dans un répertoire spécifié et de définir des autorisations sur ce fichier.
Le service File Utilities peut également faire partie d’un processus qui génère des documents de façon dynamique. Par exemple, un processus
est programmé pour s’exécuter toutes les nuits. Ce processus génère de façon dynamique des rapports de ventes au format PDF et les insère
dans un répertoire. Ce répertoire est défini en fonction du mois et de l’année.
Utilisation du service File Utilities
Vous pouvez interagir avec le service File Utilities en développant un processus dans LiveCycle Workbench utilisant ce service. Vous pouvez
exécuter les tâches ci-dessous à l’aide du service File Utilities :
•
•
•
•
•
•
•
•
•
Supprimer un fichier.
Déterminer l'existence d'un fichier.
Rechercher des fichiers et des répertoires dans le système de fichiers.
Déterminer si un chemin est absolu.
Vérifier si un chemin correspond à un répertoire ou à un fichier.
Déterminer si un chemin correspond à un fichier masqué.
Créer un répertoire ou une arborescence.
Enregistrer des données en tant que fichiers sur le système de fichiers.
Lire des informations à partir de fichiers et les enregistrer en choisissant l'un des formats de données de processus suivants :
• Document
• Chaîne
• Document XML
• Ecrire des informations converties aux formats de données de processus ci-après dans des fichiers :
• Document
• Chaîne
• Document XML
• Manipuler des répertoires et des fichiers du système de fichiers.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
ADOBE LIVECYCLE ES2.5
Service File Utilities
Services LiveCycle ES2.5
Remarques sur le service File Utilities
Vous devez tenir compte des facteurs ci-dessous lors du développement des processus utilisant ce service :
•
Si vous spécifiez des chemins locaux aux fichiers ou aux répertoires dans les propriétés des opérations, ces chemins sont interprétés
comme étant sur le système de fichiers du serveur LiveCycle ES2.5.
•
Le compte utilisateur servant à l’exécution du serveur LiveCycle ES2.5 doit posséder les autorisations requises pour pouvoir interagir
avec les fichiers et emplacements des fichiers ciblés par les opérations du service.
46
47
16. Service Form Augmenter
Le service Form Augmenter permet à un formulaire PDF ou à un formulaire Acrobat de fonctionner dans LiveCycle Workspace ES2.5. Vous
pouvez par exemple utiliser les opérations du service Form Augmenter lorsque vous créez vos services personnalisés de rendu et d’envoi
pour les variables Form, Document Form ou xfaForm.
Un formulaire activé pour Workspace ES2.5 possède les caractéristiques suivantes :
•
Lorsqu'ils sont affichés dans Workspace ES2.5, les boutons sont masqués. La soumission est alors appelée par le bouton d’envoi masqué,
ajouté à la conception du formulaire en tant que partie de l’objet formulaire Champs de processus.
•
•
Les requêtes d’envoi sont traitées par Workspace ES2.5 qui sert d’intermédiaire entre le serveur LiveCycle ES2.5 et le formulaire.
Les formulaires peuvent être utilisés à la fois en mode hors ligne et en ligne.
Utilisation du service Form Augmenter
Vous pouvez utiliser les opérations du service Form Augmenter lorsque vous créez vos services personnalisés de rendu et d’envoi pour les
variables Form, Document Form ou xfaForm.
Les opérations du service Form Augmenter vous permettent notamment d’effectuer les opérations suivantes :
•
Activation d’un formulaire PDF pour une utilisation en ligne dans Workspace ES2.5. Le formulaire PDF doit être créé dans Designer
ES2.5 ou Acrobat 7.0.5 ou une version ultérieure.
•
Activation d’un formulaire PDF pour une utilisation en mode déconnecté dans Workspace ES2.5. Le formulaire PDF doit être créé dans
Designer ES2.5. Vous ne pouvez pas spécifier de formulaire Acrobat.
•
Ajout de champs de données aux données de formulaire, ce qui permet à un formulaire PDF créé dans Designer ES2.5 d’être utilisé en
mode déconnecté dans Workspace ES2.5. Vous ne pouvez pas spécifier de formulaire Acrobat.
•
Récupération de la valeur d'un champ de formulaire. Le formulaire PDF doit être créé dans Designer ES2.5 ou Acrobat 7.0.5 ou une
version ultérieure.
• Suppression d’un ensemble de champs de données des données de formulaire.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
48
17. Service Form Data Integration
Le service Form Data Integration peut importer des données de formulaire dans un formulaire PDF et en exporter à partir d’un formulaire
PDF. Les opérations d’importation et d’exportation prennent en charge deux types de formulaires PDF :
•
•
Un formulaire Acrobat (créé dans Acrobat) est un document PDF qui contient des champs de formulaire.
Un formulaire XML (créé dans LiveCycle Designer ES2.5) est un document PDF conforme à l’architecture de formulaires XML Adobe
(XFA).
Selon le type de formulaire PDF, les données de formulaire peuvent exister dans l’un des formats ci-après :
•
•
Un fichier XFDF, qui constitue une version XML du format de données de formulaire Acrobat.
Un fichier XDP, qui correspond à un fichier XML contenant des définitions de champ de formulaire. Ce fichier peut également inclure
des données de champ de formulaire, ainsi qu’un fichier PDF incorporé. Un fichier XDP généré par Designer ES2.5 n’est utilisable que
s’il incorpore un document PDF codé en base 64.
Utilisation du service Form Data Integration
Vous pouvez importer et exporter des données en utilisant XFDF (formulaires Acrobat uniquement) ou XDP (formulaires XML
uniquement). Par exemple, pour importer des données dans un formulaire créé dans Designer ES2.5, vous devez créer une source de
données XML XDP valide. Examinez l’exemple de formulaire d’application de prêts immobiliers ci-après.
ADOBE LIVECYCLE ES2.5
Service Form Data Integration
49
Services LiveCycle ES2.5
Pour importer des valeurs de données dans ce formulaire, vous devez créer une source de données XML XDP correspondant au formulaire.
Vous ne pouvez pas utiliser une source de données XML arbitraire pour importer des données dans un formulaire à l’aide du service Form
Data Integration. La différence entre une source de données XML arbitraire et une source de données XDP réside dans le fait que la seconde
source est conforme à l’architecture de formulaires XML (XFA). Le code XML ci-après représente une source de données XDP
correspondant à l’exemple de formulaire d’application de prêts immobiliers.
<?xml version="1.0" encoding="UTF-8"?>
<xfa:datasets xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/">
<xfa:data>
<data>
<Layer>
<closeDate>1/26/2007</closeDate>
<lastName>Johnson</lastName>
<firstName>Jerry</firstName>
<mailingAddress>[email protected]</mailingAddress>
<city>New York</city>
<zipCode>00501</zipCode>
<state>NY</state>
<dateBirth>26/08/1973</dateBirth>
<middleInitials>D</middleInitials>
<socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
<phoneNumber>5555550000</phoneNumber>
</Layer>
<Mortgage>
<mortgageAmount>295000.00</mortgageAmount>
<monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
<purchasePrice>300000</purchasePrice>
<downPayment>5000</downPayment>
<term>25</term>
<interestRate>5.00</interestRate>
</Mortgage>
</data>
</xfa:data>
</xfa:datasets>
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. 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 ES2.5.
Vous pouvez utiliser 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 de LiveCycle ES2.5.)
50
18. Service Forms
Le service Forms vous permet de créer des applications clientes interactives de capture de données assurant la validation, le traitement, la
transformation et la transmission de formulaires généralement créés dans LiveCycle Designer ES2.5. Les auteurs de formulaires
développent une conception de formulaire simple que le service Forms rend sous la forme de documents PDF, HTML ou de Guides dans
une multitude d’environnements de navigateur prenant en charge Adobe Flash Player.
Le service Forms assure le rendu des formulaires PDF interactifs. Un formulaire interactif contient un ou plusieurs champs pour la collecte
d'informations interactive auprès d'un utilisateur. Une conception de formulaire interactif produit un formulaire pouvant être rempli en
ligne ou hors connexion, dans le cas de formulaires PDF. Les utilisateurs peuvent ouvrir le formulaire dans un navigateur HTML, Acrobat
ou Adobe Reader, puis saisir des informations dans les différents champs. Un formulaire interactif peut inclure des boutons ou des
commandes permettant d'exécuter des tâches courantes, telles que l'enregistrement de données dans un fichier ou l'impression. Il peut
également contenir des listes déroulantes, des calculs et des validations.
Lorsqu'un utilisateur final demande un formulaire, une application cliente, telle qu'un servlet Java, envoie cette demande au service Forms.
Ce service renvoie alors à l'utilisateur le formulaire au format approprié. Lorsque Forms reçoit une demande portant sur un formulaire, il
utilise un jeu de transformations pour fusionner les données avec une conception de formulaire. Il applique ensuite au formulaire le format
le plus adapté aux capacités de remplissage de formulaire et de présentation du navigateur cible. Par exemple, si l'utilisateur final demande
un formulaire PDF, le service Forms effectue le rendu d'un formulaire PDF interactif.
Le service Forms effectue les opérations suivantes :
•
Exécution côté serveur des fonctions intelligentes définies dans la conception de formulaire. Le service Forms effectue les validations et
les calculs inclus dans la conception de formulaire, puis renvoie les données résultantes au navigateur.
•
Vérification visant à déterminer si les scripts de la conception de formulaire doivent s'exécuter sur le client ou sur le serveur. Pour les clients
prenant en charge l'exécution de scripts côté client, tels qu'Internet Explorer 5.0 et les versions ultérieures, un modèle de script approprié
est chargé dans le périphérique pour que les scripts puissent s'exécuter directement sur l'ordinateur client. Pour plus de détails sur les
propriétés et les méthodes prises en charge dans chacune des transformations, reportez-vous au document TransformationReference.
•
Génération dynamique de contenu PDF, SWF ou HTML reposant sur les préférences de l'utilisateur concernant une conception de
formulaire avec ou sans données. Un formulaire HTML peut transmettre des formulaires de plusieurs pages une page après l'autre. Par
contre, un formulaire PDF transmet toutes les pages simultanément. Dans Designer ES2.5, l'auteur de formulaires peut inclure le script
du nombre de pages en cours dans la conception de formulaire. Le service Forms peut fusionner une page de données à la fois ou ne
fusionner qu'une seule page dans la conception de formulaire.
•
Prise en charge de formulaires secondaires créés dans Designer ES2.5. Le service Forms ajoute des champs supplémentaires ainsi que
du texte prédéfini suite à la fusion de la conception de formulaire avec les données ou à l'exécution des scripts. Dans le cas du format
HTML, les formulaires secondaires ajoutés peuvent comporter des longueurs de page illimitées. Pour le format PDF, les formulaires
secondaires ajoutés sont paginés en fonction des longueurs de page spécifiées dans la conception de formulaire.
•
Rendu des formulaires reposant sur des fragments. Les fragments vous permettent de partager des objets formulaires et scripts externes
aux conceptions de formulaire. Vous pouvez concevoir certaines parties d'un formulaire, puis les réutiliser pour la conception
d'ensembles de formulaires associés. Lorsque vous créez l'un des formulaires de cet ensemble, il vous suffit alors d'insérer une référence
au fragment. Lorsqu'un auteur de formulaires met à jour un fragment, tous les formulaires contenant une référence à ce fragment
reflètent les modifications correspondantes (lorsque le formulaire est de nouveau rendu).
•
Validation de l'entrée de données par l'exécution de calculs, l'accès à des bases de données ou l'application de règles métier aux données
de niveau champ.
•
•
Rendu de formulaires avec des pièces jointes. De même, le service Forms peut traiter les envois de formulaires contenant des pièces jointes.
Affichage des erreurs de validation sous différentes formes (cadre à gauche, en haut, à droite ou en bas ; aucun cadre à gauche, en haut,
à droite ou en bas ; aucune interface utilisateur). Toutes ces opérations sont effectuées sans qu'aucun état soit conservé sur le serveur.
Les erreurs de validation sont également accessibles dans le document d'erreurs de validation XML.
ADOBE LIVECYCLE ES2.5
Service Forms
51
Services LiveCycle ES2.5
•
Maintien de l'état de toute donnée ponctuelle transmise par l'application. Les données ponctuelles sont des données auxquelles ne
correspond aucun champ de la conception de formulaire en cours de traitement. Ces données sont retransmises à l'application appelante
une fois que le périphérique cible a envoyé les données.
•
Autorisation d'un utilisateur non technique à modifier une conception de formulaire à l'aide de Designer ES2.5 pour répondre aux
besoins en cours de l'entreprise. Par contraste, une application Web affichant des pages HTML peut nécessiter qu'un utilisateur modifie
du code source HTML ou XML pour apporter des changements à une page Web.
Pour plus de détails sur la configuration initiale de ce service, reportez-vous à la section Configuration de LiveCycle Forms ES2.5 dans l'Aide
à l'administration de LiveCycle ES2.5.
A propos des types de formulaires
Avant d'utiliser le service Forms, nous vous recommandons de bien connaître les différents types de formulaire utilisés par le service Forms.
Cette section décrit ces types de formulaires.
Formulaires présentant une mise en page modulable
Un formulaire de ce type évolue en fonction du préremplissage de données ou des actions de l'utilisateur. Il s'agit d'une conception de
formulaire qui définit un ensemble de règles de mise en page, de présentation et de capture de données. Ce type de conception inclut une
fonction de calcul des valeurs à partir des données entrées par l'utilisateur. Ces règles sont appliquées lorsqu'un utilisateur saisit des données
dans le formulaire ou qu'un serveur fusionne des données dans un formulaire.
Les formulaires présentant une mise en page modulable se révèlent particulièrement utiles en cas de présentation d'un volume de données
indéterminé aux utilisateurs. Vous n'êtes pas obligé de prédéterminer une mise en page ou un nombre de pages fixes pour le formulaire. En
cas de rendu du formulaire/de la conception de formulaire présentant une mise en page modulable sous la forme d'un formulaire PDF, des
sauts de page intelligents sont générés.
Formulaires présentant une mise en page fixe
Ce type de formulaire ne change pas en fonction du volume de données entrées dans les champs. Tous les champs non remplis apparaissent
vides dans le formulaire. A l'inverse, si le formulaire inclut un trop grand nombre de données, il ne peut pas évoluer pour s'adapter à ce surplus.
Formulaires côté serveur
Ce type de formulaire peut être un formulaire induit par les données (le formulaire est rempli avec des données pendant le rendu). Le volume
de données détermine la mise en page du formulaire. Vous pouvez indiquer plusieurs instances de valeurs de données pour un champ
donné. Le champ est alors répliqué de manière dynamique, de sorte que toutes les valeurs de données s'affichent dans le formulaire.
Les champs dynamiquement ajoutés à un formulaire sont inclus dans des structures appelées formulaires secondaires, qui figurent dans la
conception de formulaire. Un exemple de formulaire côté serveur est un formulaire appartenant à une application personnalisée qui
interroge une base de données et récupère un nombre d'enregistrements inconnu. Après avoir récupéré des enregistrements de la base de
données, l'application fusionne les données dans le formulaire. Une fois les données fusionnées dans le formulaire, l'application rend le
formulaire à l'intention d'un utilisateur.
Formulaires côté client
Ce type de formulaire est généralement utilisé pour collecter des données auprès d'utilisateurs finals, en permettant à ces derniers de cliquer
sur un bouton (ou sur un autre contrôle) qui génère un nouveau champ dans lequel les données sont entrées. Ce nouveau champ apparaît
immédiatement sur le formulaire et ne nécessite aucun aller-retour avec le serveur. De ce fait, le formulaire n'est pas envoyé à LiveCycle
ES2.5. Un exemple de formulaire côté client est un formulaire contenant des champs qui permettent à un utilisateur de commander des
articles, ainsi qu'un bouton grâce auquel il peut ajouter de nouveaux champs. Chaque fois que l'utilisateur clique sur ce bouton, un nouveau
formulaire secondaire est ajouté au formulaire (un formulaire secondaire peut contenir un ensemble de champs associés).
ADOBE LIVECYCLE ES2.5
Service Forms
52
Services LiveCycle ES2.5
Comment le service Forms traite-il les demandes ?
Cette section décrit la façon dont le service Forms traite les différentes demandes (telles que les demandes de formulaire) et précise l'ordre
d'exécution des événements et des scripts.
Demande de formulaire
Lorsqu'un utilisateur demande un formulaire provenant du service Forms (par exemple, en cliquant sur un bouton figurant sur une page
HTML), cette demande amorce une opération du service Forms. Le tableau ci-après récapitule les interactions entre un périphérique client
(tel qu'un navigateur Web), une application cliente et le service Forms lorsqu'un utilisateur demande un formulaire.
Actions de l'utilisateur
Actions de l'application cliente
Actions du service Forms
Un utilisateur demande un formulaire à partir d'une page Web. Aucune action
Aucune action
Aucune action
Aucune action
Invoque une opération du type
renderPDFForm.
Aucune action
Aucune action
Récupère la conception de formulaire spécifiée.
Aucune action
Aucune action
En cas de transmission de données au service Forms,
préremplit le formulaire avec ces données.
Aucune action
Aucune action
Exécute tous les événements d'initialisation de
champ dans l'ensemble du formulaire.
Aucune action
Aucune action
Exécute tous les événements d'initialisation de page
dans l'ensemble du formulaire.
Aucune action
Aucune action
Exécute tous les événements de calcul de champ dans
l'ensemble du formulaire.
Aucune action
Aucune action
Exécute tous les événements de calcul de page dans
l'ensemble du formulaire.
Aucune action
Aucune action
Exécute un événement d'ouverture de page.
Aucune action
Aucune action
Exécute un événement de disponibilité du formulaire.
Aucune action
Aucune action
Exécute un événement d'ouverture ou de fermeture
de page.
Aucune action
Aucune action
Transforme la conception de formulaire au format
spécifié.
Aucune action
Aucune action
Renvoie le formulaire à l'application cliente.
Aucune action
Vérifie qu'aucune erreur n'a été renvoyée.
Aucune action
Aucune action
Crée un flux binaire et l'envoie au navigateur
Web client.
Aucune action
ADOBE LIVECYCLE ES2.5
Service Forms
Actions de l'utilisateur
Actions de l'application cliente
Actions du service Forms
Les navigateurs Internet Explorer, Mozilla, Netscape Navigator
et Opera effectuent les opérations suivantes :
Aucune action
Aucune action
Aucune action
Aucune action
•
Exécutent chacun des scripts d'initialisation de champ
marqués comme étant à exécuter sur le client.
•
Exécutent chacun des scripts d'initialisation de page
marqués comme étant à exécuter sur le client.
•
Exécutent chacun des scripts de calcul de champ
marqués comme étant à exécuter sur le client.
•
Exécutent chacun des scripts de calcul de page marqués
comme étant à exécuter sur le client.
53
Services LiveCycle ES2.5
Remarque : ces actions ne sont effectuées que si le formulaire
est rendu au format HTML.
Visualise le formulaire au format PDF ou HTML.
Utilisation des boutons de conception de formulaire
Pour que le service Forms récupère des données de formulaire, effectue des calculs ou valide des données de champ, le formulaire doit
fournir le mécanisme permettant de lancer la demande correspondante. Cette initiation s'effectue généralement par l'intermédiaire de
boutons situés sur le formulaire. La légende affichée sur un bouton de commande indique la fonction de ce bouton à l'utilisateur final.
Lorsqu'un utilisateur clique sur un bouton, le traitement du formulaire est demandé par le script associé au bouton. Dans la plupart des cas,
un bouton déclenche une opération d'envoi ou de calcul.
Les boutons constituent la méthode la plus courante d'amorcer la logique contenue dans les scripts des conceptions de formulaire.
L'insertion d'un bouton sur une conception de formulaire dans Designer ES2.5 et la configuration de son option d'envoi impliquent une
opération d'envoi. La fonction d'un bouton d'envoi consiste à remplir le formulaire et à envoyer les données au service Forms. Toutefois,
certaines opérations valides peuvent interrompre ce processus. Par exemple, si un utilisateur entre une valeur incorrecte dans un champ, il
peut être contraint de corriger cette valeur pour permettre l'envoi des données. Un formulaire peut également inclure un bouton de calcul.
Ce bouton permet d'effectuer des calculs sur des données et de mettre à jour le formulaire.
Bouton d'envoi
Un bouton peut permettre d'envoyer des données de formulaire au service Forms, sous la forme de données XML, PDF ou codées URL (pour
les envois HTML). Imaginons par exemple qu'un utilisateur remplisse un formulaire interactif, puis clique sur un bouton d'envoi. Cette
opération entraîne la transmission des données de formulaire au service Forms. Une application cliente, telle qu'un servlet Java créé à l'aide
de l'API Forms Service peut récupérer ces données.
Un formulaire PDF permet d'envoyer quatre types de données (données XDP, XML, PDF et codées URL). Un formulaire HTML n'envoie
que des paires nom-valeur codées URL. Lorsque les données sont envoyées au format PDF par défaut, le service Forms capture les données
PDF, puis les renvoie sans effectuer de calculs. Vous définissez le type d'envoi dans Designer ES2.5.
Le type de contenu des données PDF envoyées est application/pdf. Par contraste, le type de contenu des données XML envoyées est
text/xml. Pour les envois XDP, il s'agit de application/vnd.adobe.xdp+xml.
ADOBE LIVECYCLE ES2.5
Service Forms
Services LiveCycle ES2.5
Le tableau ci-après récapitule les interactions entre un périphérique client (tel qu'un navigateur Web), une application cliente et le service
Forms lorsqu'un utilisateur clique sur un bouton déclenchant une opération d'envoi.
Actions de l'utilisateur
Actions de l'application cliente
Actions du service Forms
Un utilisateur entre des données dans les champs
d'un formulaire, puis clique sur un bouton d'envoi.
Cette action amorce une opération d'envoi.
Aucune action
Aucune action
Le navigateur effectue une commande HTTP sur l'URL Aucune action
cible (cette valeur est définie dans Designer ES2.5 ou
par le paramètre targetURL utilisé lors de l'appel
de rendu au service Forms).
Aucune action
Aucune action
Crée un objet FormServiceClient, appelle la méthode
processFormSubmission et transmet la demande HTTP et
les en-têtes.
Aucune action
Aucune action
Aucune action
Le service Forms fusionne les données publiées
dans le formulaire (le cas échéant).
Aucune action
Aucune action
Exécute l'événement de clic sur le champ.
Aucune action
Aucune action
Exécute les événements de calcul de champ dans
l'ensemble du formulaire.
Aucune action
Aucune action
Exécute les événements de calcul de page dans
l'ensemble du formulaire.
Aucune action
Aucune action
Exécute les événements de validation de champ
dans l'ensemble du formulaire.
Aucune action
Aucune action
Exécute les événements de validation de page
(incluant les paramètres validate,
formatTest et nullTest).
Aucune action
Aucune action
Exécute l'événement Close du formulaire.
Aucune action
Aucune action
Si ce processus de validation échoue, il existe au
moins une erreur. La valeur d'état du traitement
renvoyée est Validate.
Aucune action
Vérifie que le service Forms a renvoyé la valeur d'état du
Aucune action
traitement Validate. Dans ce cas, le résultat est renvoyé
au navigateur client pour que l'utilisateur corrige l'erreur.
Dans le cas d'un formulaire affiché au format HTML,
l'utilisateur final voit le formulaire contenant les
mêmes données, des calculs, ainsi qu'une liste
d'erreurs à corriger avant le renvoi du formulaire.
Aucune action
Les validations du client marquées comme étant à
exécuter sur le client sont lancées.
Dans le cas des Guides, l'utilisateur final voit le
formulaire contenant les mêmes données, des
calculs, ainsi qu'une liste d'erreurs à corriger avant le
renvoi du formulaire.
Dans le cas d'un formulaire affiché au format PDF,
aucune interface utilisateur n'est définie. Il est
possible de récupérer les erreurs de validation à l'aide
de la méthode getValidationErrorsList
de l'objet FormsResult.
Aucune action
54
ADOBE LIVECYCLE ES2.5
Service Forms
55
Services LiveCycle ES2.5
Actions de l'utilisateur
Actions de l'application cliente
Actions du service Forms
Aucune action
Aucune action
Si le processus de validation réussit, l'état du
traitement prend la valeur Submit.
Aucune action
Vérifie que le service Forms renvoie la valeur d'état du
traitement Submit.
Aucune action
Confirme que le traitement du formulaire est intégralement
achevé.
Les traitements supplémentaires relèvent des applications.
Par exemple, une application de type Assistant peut
demander le panneau de formulaire suivant, effectuer des
recherches de données complémentaires, mettre à jour la
base de données ou amorcer un nouveau processus de flux
de production.
La vue obtenue est propre à l'application. Par
exemple, un nouveau formulaire peut s'afficher.
Aucune action
Aucune action
Bouton de calcul
Il est possible d'utiliser un bouton pour effectuer une opération de calcul. Lorsqu'un utilisateur clique sur un bouton, le service Forms
exécute un script de calcul se trouvant dans la conception de formulaire. Le résultat est renvoyé au navigateur Web avec les résultats du calcul,
affichés dans le formulaire (reportez-vous à la section « Calcul des données de formulaire », page 66).
Le tableau ci-après récapitule les interactions entre une application cliente et le service Forms lorsqu'un utilisateur lance une opération de
calcul.
Actions de l'utilisateur
Actions de l'application cliente
Actions du service Forms
Un utilisateur clique sur un bouton du formulaire.
Aucune action
Aucune action
Si l'événement Click du bouton est marqué comme étant
à exécuter sur le client, le formulaire n'est pas envoyé au
service Forms. Le script est exécuté dans un navigateur
Web, dans Acrobat ou dans Adobe Reader.
Un Guide implémente un XFASubset dans ActionScript, qui
s’exécute dans Adobe Flash® Player.
Si l'événement Click du bouton est marqué comme étant
à exécuter sur le serveur, le formulaire est envoyé au service
Forms.
Aucune action
Crée un objet FormsServiceClient et appelle Aucune action
la méthode processFormSubmission.
Aucune action
Aucune action
Le service Forms fusionne les nouvelles données
dans la conception de formulaire (le cas échéant).
Aucune action
Aucune action
Exécute l'événement de clic sur le champ.
Aucune action
Aucune action
Exécute les événements de calcul de champ dans
l'ensemble du formulaire.
Aucune action
Aucune action
Exécute les événements de calcul de page dans
l'ensemble du formulaire.
Aucune action
Aucune action
Exécute un événement d'ouverture ou de fermeture
de page.
Aucune action
Aucune action
Exécute les événements de validation de champ
dans l'ensemble du formulaire.
ADOBE LIVECYCLE ES2.5
Service Forms
56
Services LiveCycle ES2.5
Actions de l'utilisateur
Actions de l'application cliente
Actions du service Forms
Aucune action
Aucune action
Exécute l'événement de validation de page.
Aucune action
Aucune action
Exécute l'événement de fermeture de page.
Aucune action
Aucune action
Renvoie le formulaire à l'application cliente ayant
appelé le service Forms. Le format du formulaire ne
change pas. Si le formulaire est envoyé au format
PDF, il est renvoyé au navigateur client au format
PDF.
Aucune action
Vérifie que le service Forms ne renvoie aucune
erreur.
Aucune action
Aucune action
Crée un flux binaire et l'envoie au navigateur Web
client.
Aucune action
Voit les résultats du calcul affichés dans le formulaire.
Aucune action
Aucune action
Utilisation du service Forms
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. 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 ES2.5.
Rendu de formulaires PDF interactifs
Le service Forms rend des formulaires PDF ou des fichiers XDP interactifs sur des périphériques clients, comme par exemple un navigateur
Web. Lorsque le rendu du formulaire interactif est effectué, l'utilisateur peut entrer des données dans des champs du formulaire et cliquer
sur le bouton d'envoi pour renvoyer les informations au service Forms. Pour que le formulaire PDF interactif puisse être affiché, le logiciel
Adobe Reader® ou Acrobat doit être installé sur l'ordinateur hébergeant le navigateur Web client.
1
ADOBE LIVECYCLE ES2.5
Service Forms
57
Services LiveCycle ES2.5
Avant de pouvoir rendre un formulaire à l'aide du service Forms, vous devez créer une conception de formulaire. En général, une conception
de formulaire est créée dans Designer ES2.5 et enregistrée en tant que fichier XDP.
Remarque : dans les versions LiveCycle 7.x, le service Forms créait des fichiers PDF non balisés par défaut. Dans LiveCycle ES2.5, le service
Forms crée des fichiers PDF balisés par défaut.
Rendu de formulaires au client
Utilisez la fonctionnalité de rendu côté client du logiciel Acrobat ou Adobe Reader pour optimiser la livraison de contenu PDF et améliorer
la capacité du service Forms à gérer la charge réseau. Ce processus est désigné sous le nom de rendu d'un formulaire au client. Pour rendre
un formulaire au client, le périphérique client (un navigateur Web, en général) doit utiliser Acrobat 7.0 ou Adobe Reader 7.0 ou versions
ultérieures.
Utilisez la fonctionnalité de rendu côté client du logiciel Acrobat ou Adobe Reader pour optimiser la livraison de contenu PDF et améliorer
la capacité du service Forms à gérer la charge réseau.
Utilisation d'un Guide
Les guides sont basés sur la technologie Adobe Flash® et fournissent une méthode de capture de données par l'utilisateur visiblement
optimisée et rationalisée. Ces guides réduisent les erreurs de saisie de données via une utilisation améliorée en groupant et simplifiant
logiquement les informations présentées à un utilisateur à un moment donné.
Dans LiveCycle ES2.5, le service Forms permet uniquement d'effectuer un rendu des conceptions de formulaire existantes créées dans
LiveCycle Designer ES (version 8.x) en guides de formulaire. Le service Forms service n'est pas utilisé pour effectuer un rendu des guides
LiveCycle ES2.5, créés dans Workbench à l'aide de Guide Builder. Pour plus de détails sur la création et le rendu de guides LiveCycle ES2.5,
consultez la rubrique Mise en route avec les guides.
ADOBE LIVECYCLE ES2.5
Service Forms
58
Services LiveCycle ES2.5
Rendu de formulaires au format HTML
Le service Forms rend des formulaires au format HTML en récupérant le formulaire spécifié et en le transformant en formulaire au format
HTML. Vous pouvez sélectionner le type de transformation HTML. Le rendu d'un formulaire au format HTML présente de nombreux
avantages. En effet, l'ordinateur hébergeant le navigateur Web client ne nécessite ni Adobe Reader, ni Acrobat, ni Flash Player (pour les Guides).
Pour rendre un formulaire au format HTML, la conception de formulaire doit être enregistrée en tant que fichier XDP. Une conception de
formulaire enregistrée en tant que fichier PDF ne peut pas être rendue au format HTML.
Pour une conception de formulaire, il est conseillé de suivre les remarques en matière de mise en page pour les formulaires HTML, afin de
résoudre les problèmes de décalage du texte dans un formulaire rendu au format HTML. (Reportez-vous à la section Utilisation de LiveCycle
Designer ES2.5 > Création de formulaires pour LiveCycle Forms ES2.5 > Création de formulaires HTML > Remarques concernant la mise
en page pour les formulaires HTML dans l'Aide LiveCycle Designer ES2.5.)
Utilisation de Forms IVS pour tester les formulaires et leurs ensembles de données
Forms IVS (Forms Installation and Verification Sample) est une application exemple vous permettant de tester vos formulaires et leurs
ensembles de données. Cette application utilise les opérations renderPDFForm, renderHTMLForm et processFormSubmission qu’expose
le service Forms.
Vous devez déployer Forms IVS avant de l'utiliser. Les administrateurs peuvent utiliser LiveCycle Configuration Manager pour déployer
Forms IVS. Ils peuvent également le déployer manuellement Reportez-vous aux guides d'installation LiveCycle ES2, tels que Installation et
déploiement de LiveCycle ES2 pour JBoss.
Pour ouvrir l'application Forms IVS, accédez à http://[nom_serveur:numéro_port]/FormsIVS.
Pour définir les caractéristiques de votre travail et l'envoyer, cliquez sur le lien Tester Forms sur la bannière d'Adobe LiveCycle Forms ES2.5.
Voici quelques-uns des paramètres que vous pouvez définir depuis la fenêtre Tester Forms :
• Formulaire à tester
• Fichier de données à fusionner avec le formulaire
• Format de sorties
• Sélection du test de performances
Pour changer les paramètres utilisés par Forms IVS, cliquez sur le lien Préférences de la bannière d' Adobe LiveCycle Forms ES2.5. Voici
quelques-uns des paramètres que vous pouvez définir depuis la fenêtre Préférences :
•
•
Options transmises au service Forms ES2.5
Emplacements à partir desquels Forms IVS a obtenu les fichiers de formulaires, de données, XDC et d'accompagnement. Il peut s'agir
d'URL, d'un emplacement de référentiel ou d'une référence absolue de dossier sur l'ordinateur hébergeant LiveCycle ES2.5. Les
emplacements des répertoires peuvent être définis par référentiel:/ ou référentiel:///.
• Racine et points de fin de l'application
• Informations d'identification de l'administrateur
• Options pour le rendu du formulaire
Pour visualiser ou supprimer les fichiers dans le répertoire racine, cliquez sur le lien Maintenance de la bannière d' Adobe LiveCycle Forms
ES2.5. Vous pouvez supprimer uniquement les fichiers que vous avez ajoutés à Forms IVS. Vous ne pouvez pas supprimer ceux qui ont été
installés avec ce logiciel.
Pour consulter l'aide complète de Forms IVS, cliquez sur le lien Aide de la bannière d' Adobe LiveCycle Forms ES2.5.
ADOBE LIVECYCLE ES2.5
Service Forms
59
Services LiveCycle ES2.5
Options du service Forms
Rendu de formulaires reposant sur des fragments
Le service Forms peut rendre des formulaires reposant sur des fragments que vous créez à l'aide de Designer ES2.5. Un fragment est une
partie réutilisable d'un formulaire et est enregistré sous la forme d'un fichier XDP distinct pouvant être inséré dans différentes conceptions
de formulaire. Un fragment peut par exemple inclure un bloc d'adresses ou un texte juridique.
L'utilisation de fragments simplifie et accélère la création et la gestion d'un grand nombre de formulaires. Lorsque vous créez un formulaire,
insérez une référence au fragment requis ; ce dernier apparaît alors dans le formulaire. La référence au fragment contient un formulaire
secondaire pointant vers le fichier XDP physique. Pour plus de détails sur la création de fragments, reportez-vous à l'Aide LiveCycle
Designer ES2.5.
Un fragment peut inclure plusieurs formulaires secondaires qui sont compris dans un jeu de formulaires secondaires choisi. Les jeux de
formulaires secondaires choisis contrôlent l'affichage des formulaires secondaires en fonction du flux de données provenant d'une connexion
de données. Utilisez des instructions conditionnelles pour déterminer le formulaire secondaire du jeu qui va apparaître dans le formulaire
fourni. Par exemple, chaque formulaire secondaire d'un jeu peut inclure des informations portant sur un emplacement géographique
spécifique. De plus, le formulaire secondaire qui s'affiche peut être défini en fonction de l'emplacement de l'utilisateur.
Un fragment de script contient des fonctions ou valeurs JavaScript réutilisables qui sont stockées séparément de tout objet particulier, comme
un parseur de dates ou un appel de service Web. Ces fragments incluent un objet de script unique, qui apparaît en tant qu'enfant de variables
dans la palette Hiérarchie de Designer ES2.5. Les fragments ne peuvent pas être créés à partir de scripts appartenant à d'autres objets, tels
que des scripts d'événements comme la validation, le calcul ou l'initialisation.
L'utilisation de fragments offre les avantages suivants :
Réutilisation de contenu : vous pouvez utiliser des fragments pour réutiliser du contenu dans plusieurs conceptions de formulaire. Pour
utiliser un même contenu dans plusieurs formulaires, l'emploi d'un fragment se révèle plus rapide et plus simple que la copie ou la recréation
du contenu. L'utilisation de fragments offre également la garantie que les parties fréquemment utilisées d'une conception de formulaire
présentent un contenu et un aspect homogènes dans tous les formulaires faisant référence à ces fragments.
Mises à jour globales : vous pouvez utiliser des fragments pour apporter des changements globaux à plusieurs formulaires simultanément
en effectuant cette opération dans un même fichier. Lorsque vous modifiez le contenu, les objets de script, les liaisons de données, la mise
en page ou les styles d'un fragment, tous les formulaires XDP faisant référence à ce fragment sont modifiés en conséquence.
Par exemple, un élément commun dans plusieurs formulaires peut être un bloc d'adresses incluant un objet de liste déroulante pour le pays.
Pour mettre à jour les valeurs de l'objet de liste déroulante, vous devez ouvrir plusieurs formulaires, afin d'effectuer des modifications. Si
vous incluez le bloc d'adresses dans un fragment, vous ne devez ouvrir qu'un fichier de fragment pour effectuer les modifications.
Pour mettre à jour un fragment dans un formulaire PDF, enregistrez à nouveau ce dernier dans Designer ES2.5.
Partage de la création de formulaires : vous pouvez utiliser les fragments pour partager la création de formulaires entre plusieurs
ressources. Les développeurs de formulaires familiarisés avec l'utilisation de scripts ou d'autres fonctions avancées de Designer ES2.5
peuvent développer et partager des fragments tirant avantage des fonctions de script et des propriétés dynamiques. Les auteurs de
formulaires peuvent alors utiliser des fragments pour créer des conceptions de formulaire et garantir le fait que tous les éléments des
formulaires conçus par différents utilisateurs présentent un aspect et un fonctionnement cohérents.
ADOBE LIVECYCLE ES2.5
Service Forms
60
Services LiveCycle ES2.5
Rendu de formulaires dont les droits sont activés
Le service Forms peut rendre des formulaires ayant des droits d'utilisation qui leur sont appliqués. Les droits d'utilisation appartiennent à la
fonctionnalité disponible par défaut dans Acrobat mais non dans Adobe Reader, comme la capacité à ajouter des commentaires à un
formulaire ou à remplir des champs de formulaire et à enregistrer ce dernier. Les formulaires ayant des droits d'utilisation qui leur sont
appliqués sont appelés des formulaires dont les droits sont activés. Un utilisateur qui ouvre un formulaire dont les droits sont activés dans
Adobe Reader peut effectuer les opérations qui sont autorisées pour ce formulaire.
Pour que vous puissiez appliquer des droits d'utilisation à un formulaire, le service Reader Extensions doit faire partie de votre installation
LiveCycle. De plus, vous devez disposer d'informations d'identification valides pour pouvoir appliquer des droits d'utilisation à des
documents PDF. Autrement dit, vous devez configurer correctement le service Reader Extensions avant de pouvoir rendre un formulaire
dont les droits sont activés. (reportez-vous à la section « Service Reader Extensions », page 112).
Remarque : pour rendre un formulaire contenant des droits d'utilisation, utilisez un fichier XDP en entrée, et non un fichier PDF. Si vous utilisez
un fichier PDF en entrée, le formulaire sera rendu mais il ne s'agira pas d'un formulaire dont les droits sont activés.
Remarque : vous ne pouvez pas préremplir un formulaire avec des données XML lorsque vous spécifiez les droits d’utilisation suivants : autoriser
l’insertion de commentaires, autoriser les commentaires en ligne, autoriser les pièces jointes incorporées ou autoriser les signatures numériques.
Gestion des formulaires envoyés
Les applications Web qui permettent à un utilisateur de remplir des formulaires interactifs requièrent le renvoi des données au serveur. A
l'aide du service Forms, vous pouvez récupérer les données entrées par un utilisateur dans un formulaire interactif. Une fois les données
récupérées, vous pouvez traiter ces dernières pour répondre aux besoins de votre entreprise. Par exemple, vous pouvez effectuer les tâches
suivantes :
• Stockage des données dans une base de données.
• Envoi des données à une autre application.
• Envoi des données à un autre service.
• Fusion des données dans une conception de formulaire.
• Affichage des données dans un navigateur Web.
Les données de formulaire sont envoyées au service Forms en tant que données XML ou PDF. Cette option est définie dans Designer ES2.5.
Un formulaire qui est envoyé au format XML vous permet d'extraire les valeurs des données de champs distincts. Autrement dit, vous pouvez
extraire la valeur de chaque champ de formulaire qu'un utilisateur a rempli. Un formulaire qui est envoyé au format PDF dispose de données
binaires, et non de données XML. Par conséquent, vous ne pouvez pas extraire les valeurs des champs. Cependant, vous pouvez enregistrer
le formulaire en tant que fichier PDF ou l'envoyer vers un autre service.
ADOBE LIVECYCLE ES2.5
Service Forms
61
Services LiveCycle ES2.5
Gestion des données XML envoyées
En envoyant les données du formulaire au format XML, vous pouvez récupérer les données XML représentant les données envoyées. Tous
les champs du formulaire s'affichent sous forme de nœuds dans un schéma XML. Les valeurs des nœuds correspondent aux valeurs que
l'utilisateur renseigne. Prenez par exemple un formulaire de prêt dont chaque champ apparaît comme un nœud au sein des données XML.
La valeur de chaque nœud correspond à la valeur renseignée par un utilisateur. Partons à présent du principe qu'un utilisateur renseigne le
formulaire de prêt avec les données indiquées dans le formulaire ci-joint.
ADOBE LIVECYCLE ES2.5
Service Forms
62
Services LiveCycle ES2.5
L'illustration fournie montre les données XML correspondantes récupérées à l'aide du service Forms.
Pour que les données puissent être envoyées sous forme de données XML, la conception du formulaire doit être correctement configurée
dans Designer ES2.5. Pour configurer le logiciel comme il se doit afin qu'il envoie les données XML, assurez-vous que le bouton Envoyer
situé sur la conception du formulaire est défini pour l'envoi de données XML (reportez-vous à l'Aide de LiveCycle Designer ES2.5).
De même, vous devez définir le type de contenu adéquat pour gérer les données XML. Par exemple, indiquez
application/vnd.adobe.xdp+xml. Le type de contenu doit correspondre aux données de formulaire envoyées. Vous pouvez également
définir plusieurs valeurs de type de contenu, telle que celle qui suit, pour veiller à ce que plusieurs envois de formulaire puissent être utilisés :
CONTENT_TYPE=application/pdf&CONTENT_TYPE=application/vnd.adobe.xdp+xml
Gestion des données PDF envoyées
Considérons une application Web qui appelle le service Forms. Lorsque le service Forms a effectué le rendu d'un formulaire PDF interactif
sur un navigateur client, l'utilisateur renseigne ce formulaire interactif et le renvoie sous forme de données PDF. Lorsqu'il reçoit les données
PDF, le service Forms peut les envoyer à un autre service ou les enregistrer sous forme de fichier PDF. Pour gérer un formulaire PDF envoyé,
assurez-vous de définir CONTENT_TYPE=application/pdf comme type de contenu.
Préremplissage des formulaires
Le préremplissage des formulaires permet d'afficher des données pour les utilisateurs dans un formulaire rendu. Imaginons, par exemple,
qu'un utilisateur se connecte à un site Web avec un nom d'utilisateur et un mot de passe. Si l'authentification réussit, l'application
personnalisée interroge une base de données pour obtenir les informations utilisateur. Les données sont fusionnées dans le formulaire, puis
ce dernier est rendu à l'utilisateur. Par conséquent, l'utilisateur peut afficher des données personnalisées dans le formulaire.
Le préremplissage d'un formulaire offre les avantages suivants :
•
•
•
Permet à l'utilisateur d'afficher les données personnalisées dans un formulaire
Réduit la quantité d'éléments que l'utilisateur doit saisir pour remplir un formulaire
Garantit l'intégrité des données grâce au contrôle de l'emplacement dans lequel les données sont placées
ADOBE LIVECYCLE ES2.5
Service Forms
63
Services LiveCycle ES2.5
Les deux sources de données XML suivantes peuvent préremplir un formulaire :
•
Source de données XDP, correspondant à une source de données XML conforme à la syntaxe XFA (ou des données XFDF pour
préremplir un formulaire créé à l'aide d'Acrobat).
•
Source de données XML arbitraire contenant des paires nom/valeur correspondant aux noms des champs du formulaire.
Un élément XML doit être inclus pour chacun des champs de formulaire que vous souhaitez préremplir. Le nom de l’élément XML doit
correspondre au nom du champ. Un élément XML est ignoré s’il ne correspond pas à un champ du formulaire ou si son nom ne concorde
pas avec le nom du champ. Il n’est pas nécessaire de respecter l’ordre d’affichage des éléments XML si tous les éléments XML sont spécifiés.
Lorsque vous préremplissez un formulaire qui contient déjà des données, spécifiez les données qui sont déjà affichées dans la source de
données XML. Imaginons qu'un formulaire composé de 10 champs contienne des données dans 4 champs. Imaginons ensuite que vous
souhaitiez préremplir les 6 autres champs. Vous devez alors spécifier 10 éléments XML dans la source de données XML utilisée pour
préremplir le formulaire. Si vous n'indiquez que 6 éléments, les 4 champs d'origine seront vides.
Par exemple, pour préremplir un formulaire de confirmation, vous devez créer une source de données XML contenant trois éléments XML
qui correspondent aux trois champs du formulaire. Ce formulaire contient les trois champs suivants : FirstName, LastName et Amount. La
première étape consiste à créer une source de données XML contenant des éléments XML qui correspondent aux champs figurant dans la
conception de formulaire, comme indiqué dans le code XML suivant.
<Untitled>
<FirstName>
<LastName>
<Amount>
</Untitled>
L'étape suivante consiste à attribuer des valeurs de données aux éléments XML, comme indiqué dans le code XML suivant :
<Untitled>
<FirstName>Jerry</FirstName>
<LastName>Johnson</LastName>
<Amount>250000</Amount>
</Untitled>
Une fois le formulaire de confirmation prérempli avec cette source de données XML et le formulaire rendu, les valeurs des données que vous
avez attribuées aux éléments XML sont affichées, comme indiqué dans l'illustration ci-dessous.
ADOBE LIVECYCLE ES2.5
Service Forms
64
Services LiveCycle ES2.5
Préremplissage de formulaires présentant une mise en page modulable
Ces formulaires se révèlent utiles en cas de présentation d'un volume de données indéterminé aux utilisateurs. La mise en page du formulaire
s'adapte automatiquement à la quantité de données fusionnées. Vous n'avez donc pas besoin de définir à l'avance un nombre de pages,
comme dans le cas des formulaires présentant une mise en page fixe.
Un formulaire présentant une mise en page modulable est généralement rempli avec des données obtenues pendant l'exécution. Par
conséquent, vous pouvez préremplir un formulaire en créant une source de données XML en mémoire et en y plaçant directement les
données.
L'illustration ci-dessous montre un exemple de formulaire de bon de commande présentant une mise en page modulable.
A. Représente la partie dynamique du formulaire B. Représente les données d'en-tête du formulaire
Remarque : les formulaires peuvent être préremplis avec des données provenant d'autres sources, comme une base de données d'entreprise ou
des applications externes.
ADOBE LIVECYCLE ES2.5
Service Forms
65
Services LiveCycle ES2.5
Description des sous-groupes de données
Une source de données XML est utilisée pour préremplir des formulaires. Une source de données XML utilisée pour préremplir un
formulaire présentant une mise en page modulable contient des sous-groupes de données répétitifs. Le code XML suivant illustre la source
de données XML utilisée pour préremplir le formulaire de bon de commande.
<header>
<!-- Eléments XML utilisés pour préremplir les champs non répétitifs tels que l'adresse
<!et la ville
<txtPONum>8745236985</txtPONum>
<dtmDate>2004-02-08</dtmDate>
<txtOrderedByCompanyName>Any Company Name</txtOrderedByCompanyName>
<txtOrderedByAddress>555, Any Blvd.</txtOrderedByAddress>
<txtOrderedByCity>Any City</txtOrderedByCity>
<txtOrderedByStateProv>ST</txtOrderedByStateProv>
<txtOrderedByZipCode>12345</txtOrderedByZipCode>
<txtOrderedByCountry>Any Country</txtOrderedByCountry>
<txtOrderedByPhone>(123) 456-7890</txtOrderedByPhone>
<txtOrderedByFax>(123) 456-7899</txtOrderedByFax>
<txtOrderedByContactName>Contact Name</txtOrderedByContactName>
<txtDeliverToCompanyName>Any Company Name</txtDeliverToCompanyName>
<txtDeliverToAddress>7895, Any Street</txtDeliverToAddress>
<txtDeliverToCity>Any City</txtDeliverToCity>
<txtDeliverToStateProv>ST</txtDeliverToStateProv>
<txtDeliverToZipCode>12346</txtDeliverToZipCode>
<txtDeliverToCountry>Any Country</txtDeliverToCountry>
<txtDeliverToPhone>(123) 456-7891</txtDeliverToPhone>
<txtDeliverToFax>(123) 456-7899</txtDeliverToFax>
<txtDeliverToContactName>Contact Name</txtDeliverToContactName>
</header>
<detail>
<!-- Un sous-groupe de données qui contient des informations sur le moniteur>
<txtPartNum>00010-100</txtPartNum>
<txtDescription>Monitor</txtDescription>
<numQty>1</numQty>
<numUnitPrice>350.00</numUnitPrice>
</detail>
<detail>
<!-- Un sous-groupe de données qui contient des informations sur la lampe de bureau>
<txtPartNum>00010-200</txtPartNum>
<txtDescription>Desk lamps</txtDescription>
<numQty>3</numQty>
<numUnitPrice>55,00</numUnitPrice>
</detail>
<detail>
<!-- Un sous-groupe de données qui contient des informations sur le téléphone>
<txtPartNum>00025-275</txtPartNum>
<txtDescription>Phone</txtDescription>
<numQty>5</numQty>
<numUnitPrice>85,00</numUnitPrice>
</detail>
<detail>
<!-- Un sous-groupe de données qui contient des informations sur le carnet d'adresses>
<txtPartNum>00300-896</txtPartNum>
<txtDescription>Address book</txtDescription>
<numQty>2</numQty>
<numUnitPrice>15.00</numUnitPrice>
</detail>
ADOBE LIVECYCLE ES2.5
Service Forms
66
Services LiveCycle ES2.5
Notez que chaque sous-groupe de données contient quatre éléments XML qui correspondent aux informations suivantes :
• Numéro des articles
• Description des articles
• Nombre d'articles
• Prix à l'unité
Le nom d'un élément XML parent du sous-groupe de données doit correspondre au nom du formulaire secondaire figurant dans la
conception de formulaire. Par exemple, dans l'illustration ci-dessus, vous pouvez voir que le nom de l'élément XML parent du sous-groupe
de données est detail. Il correspond au nom du formulaire secondaire figurant dans la conception de formulaire sur laquelle le formulaire
de bon de commande est basé. Si le nom de l'élément XML parent du sous-groupe de données et celui du formulaire secondaire ne
correspondent pas, un formulaire côté serveur ne sera pas prérempli.
Chaque sous-groupe de données doit contenir des éléments XML qui correspondent aux noms des champs du formulaire secondaire. Le
formulaire secondaire detail figurant dans la conception de formulaire contient les champs suivants :
•
•
•
•
txtPartNum
txtDescription
numQty
numUnitPrice
Calcul des données de formulaire
Le service Forms peut calculer les valeurs qu'un utilisateur saisit dans un formulaire et afficher les résultats. Pour calculer des données de
formulaire, commencez par créer un script de conception de formulaire qui effectue cette opération. Une conception de formulaire prend
en charge trois types de scripts. Un des scripts s'exécute sur le client, le deuxième sur le serveur et le troisième sur le serveur et sur le client.
Le type de script traité dans cette section s'exécute sur le serveur. Les calculs côté serveur sont pris en charge pour les transformations
HTML, PDF et de Guide.
Dans le cadre du processus de conception de formulaire, vous pouvez utiliser les calculs et les scripts pour offrir une expérience plus riche
à l'utilisateur. Les calculs et les scripts peuvent être ajoutés à la plupart des champs et des objets de formulaire.
L'utilisateur entre des valeurs dans le formulaire et clique sur le bouton de calcul pour afficher les résultats. Le processus suivant décrit un
exemple d'application qui permet à un utilisateur de calculer des données :
•
L'utilisateur accède à une page HTML nommée StartLoan, qui agit comme la page de démarrage de l'application Web. Cette page appelle
un servlet Java appelé GetLoanForm.
•
Le servlet GetLoanForm rend un formulaire de prêt. Ce formulaire contient un script, des champs interactifs, un bouton de calcul et un
bouton d'envoi.
•
L'utilisateur saisit des valeurs dans les champs du formulaire et clique sur le bouton de calcul. Le formulaire est envoyé au servlet Java
CalculateData dans lequel le script est exécuté. Le formulaire est renvoyé à l'utilisateur. Il inclut les résultats du calcul.
•
L'utilisateur continue à saisir et calculer des valeurs jusqu'à ce qu'un résultat satisfaisant soit affiché. Lorsqu'il est satisfait, l'utilisateur
clique sur le bouton d'envoi pour traiter le formulaire. Le formulaire est envoyé à un autre servlet Java nommé ProcessForm qui est
responsable de la récupération des données envoyées. (reportez-vous à la section « Gestion des formulaires envoyés », page 60).
ADOBE LIVECYCLE ES2.5
Service Forms
67
Services LiveCycle ES2.5
L'illustration suivante illustre le flux logique de l'application.
Etapes représentées dans le schéma :
1
Le servlet Java™ GetLoanForm est appelé à partir de la page de démarrage HTML.
2
Le servlet Java GetLoanForm utilise l'API cliente du service Forms pour rendre le formulaire de prêt au navigateur Web client. Le rendu
d'un formulaire contenant un script configuré pour s'exécuter sur le serveur ne sera pas identique à celui d'un formulaire ne contenant
aucun script. En effet, dans un cas, vous devez indiquer l'emplacement cible utilisé pour l'exécution du script. Si un emplacement cible
n'est pas spécifié, un script configuré pour s'exécuter sur le serveur ne sera pas exécuté. Par exemple, examinons l'application introduite
dans cette section. Le servlet Java CalculateData représente l'emplacement cible dans lequel le script est exécuté.
3
L'utilisateur saisit des données dans les champs interactifs, puis clique sur le bouton de calcul. Le formulaire est envoyé au servlet Java
CalculateData dans lequel le script est exécuté.
4
Le formulaire est renvoyé au navigateur Web avec les résultats du calcul affichés dans le formulaire.
5
L'utilisateur clique sur le bouton d'envoi lorsque les valeurs sont satisfaisantes. Le formulaire est envoyé à un autre servlet Java nommé
ProcessForm.
En général, un formulaire envoyé au format PDF contient des scripts qui sont exécutés sur le client. Cependant, des calculs côté serveur
peuvent également être effectués. Un bouton d'envoi ne peut pas être utilisé pour calculer des scripts. Dans ce cas, les calculs ne sont pas
effectués parce que le service Forms considère que l'interaction est complète.
ADOBE LIVECYCLE ES2.5
Service Forms
68
Services LiveCycle ES2.5
Pour illustrer l'utilisation d'un script de conception de formulaire, cette section examine un formulaire interactif simple qui contient un
script configuré pour s'exécuter sur le serveur. L'illustration suivante représente une conception de formulaire contenant un script. Ce script
ajoute des valeurs entrées par un utilisateur dans les deux premiers champs et affiche le résultat dans le troisième champ.
A. Un champ appelé NumericField1 B. Un champ appelé NumericField2 C. Un champ appelé NumericField3
La syntaxe du script contenue dans cette conception de formulaire est la suivante :
NumericField3 = NumericField2 + NumericField1
Dans cette conception de formulaire, le bouton de calcul est un bouton de commande et le script se trouve dans l'événement Click du
bouton. Lorsque l'utilisateur saisit des valeurs dans les deux premiers champs du formulaire et clique sur le bouton de calcul, le script est
exécuté. Le service Forms renvoie le formulaire au périphérique client avec les résultats du calcul affichés dans le champ NumericField3.
Pour plus de détails sur la création d'un script de conception de formulaire, reportez-vous à l'Aide LiveCycle Designer ES2.5.
Remarques sur le service Forms
Plusieurs remarques sont à prendre en compte lorsque vous utilisez le service Forms. Elles concernent les rubriques suivantes :
•
•
•
•
•
•
Planification de votre conception de formulaire
Création de conceptions de formulaire pour le service Forms
Rendu des formulaires contenant des images
Rendu des formulaires intégrant des images sécurisées
Changements non retenus apportés à des champs image utilisant un script
Vérification de la disponibilité des polices pour LiveCycle ES2.5.
ADOBE LIVECYCLE ES2.5
Service Forms
69
Services LiveCycle ES2.5
Planification de votre conception de formulaire
La création d'une logique applicative à l'aide du service Forms ne représente que l'un des aspects de la création d'une application cliente. Le
service Forms requiert des conceptions de formulaire généralement créées à l'aide de Designer ES2.5 (les formulaires peuvent également
être créés dans Acrobat). Les conceptions de formulaire sont des modèles XML enregistrés sous forme de fichiers XDP ou PDF. En fonction
du type d'entrée, le service Forms génère des formulaires affichées au format PDF ou HTML. L'illustration ci-après illustre les entrées et
sorties valides du service Forms.
Utilisation d'une conception de formulaire enregistrée sous forme de fichier .xdp
Sortie
Formulaire affiché
au format HTML
Entrées
PDF
Conception de formulaire enregistrée
sous forme de fichier .xdp
Sortie
Formulaire affiché
au format PDF
Service des formulaires
Utilisation d'une conception de formulaire enregistrée sous forme de fichier .pdf
PDF
PDF
Sortie
Entrées
Conception de formulaire enregistrée
sous forme de fichier .pdf
Formulaire affiché au format PDF
Service des formulaires
La première étape de la planification de votre application consiste à déterminer le format de sortie des formulaires. Enregistrez la conception
de formulaire de l'une des façons suivantes :
•
•
sous forme d'un fichier XDP pour que le service Forms génère un formulaire au format PDF ou HTML ;
sous forme d'un fichier PDF ou XDP pour que le service Forms génère un format PDF uniquement.
Création de conceptions de formulaire pour le service Forms
Certaines différences de fonctionnement existent entre les conceptions de formulaire utilisées pour rendre des formulaires PDF et celles
conçues pour le rendu de formulaires HTML. Pour afficher des conceptions de formulaires rendues au format PDF, utilisez le logiciel
Acrobat ou Adobe Reader.
Si vous rendez un formulaire au format HTML, certains périphériques clients (par exemple, d'anciens navigateurs Web) n'offriront pas le
même niveau de prise en charge concernant les différentes propriétés d'objet. Pour créer une conception de formulaire réduisant ces
limitations, suivez la procédure ci-après.
ADOBE LIVECYCLE ES2.5
Service Forms
70
Services LiveCycle ES2.5
1
Consultez la section Transformation Reference pour déterminer le fonctionnement des objets dans un périphérique client spécifique.
2
Si vous concevez un formulaire présentant une mise en page fixe et souhaitez générer le formulaire au format HTML, vous devez activer
la mise en cache des transformations (reportez-vous à l'Aide de LiveCycle Designer ES2.5).
3
Lorsque vous créez une conception de formulaire, tentez de contourner les limitations en recherchant des moyens d'implémenter le
formulaire sans vous appuyer sur des propriétés d'objet non prises en charge.
4
Si nécessaire, intégrez une mise en page fonctionnant à la fois pour les formats PDF et HTML.
5
Lisez la section de l'Aide de LiveCycle Designer ES2.5 décrivant la création de formulaires accessibles, puis suivez ses instructions pour
définir l’accessibilité dans votre conception de formulaire.
6
Demandez à votre développeur de formulaires de vous indiquer l'emplacement d'exécution des scripts. Par défaut, les scripts s'exécutent
sur le client. Si les scripts que vous incluez dans une conception de formulaire doivent s'exécuter sur le serveur, ou à la fois sur le client
et sur le serveur, vous pouvez avoir besoin de changer la configuration par défaut. Par exemple, une conception de formulaire peut
contenir un script extrayant les données d'une base de données d'entreprise uniquement disponible sur le serveur. Dans cette situation,
il est nécessaire de modifier le paramétrage par défaut pour permettre au script de s'exécuter sur le serveur.
7
Visualisez régulièrement l'aperçu du formulaire à l'aide de Designer ES2.5 ou du périphérique client (tel qu'un navigateur Web) pour
résoudre les problèmes dès les premières phases du processus de conception.
8
Si le service Forms doit préremplir les formulaires avec des données, utilisez des données de test pour tester intégralement votre
conception de formulaire.
Pour que le service Forms récupère des données de formulaire, effectue des calculs ou valide des données de champ, le formulaire doit
fournir le mécanisme permettant de lancer la demande correspondante. Cette opération s'effectue généralement par l'intermédiaire de
boutons situés sur la conception de formulaire. La légende affichée sur un bouton de commande indique la fonction de ce bouton à
l'utilisateur final. Lorsqu'un utilisateur clique sur un bouton, le traitement du formulaire est demandé par le script associé au bouton. Dans
la plupart des cas, un bouton déclenche une opération d'envoi ou de calcul.
Les boutons constituent la méthode la plus courante pour amorcer la logique contenue dans les scripts des conceptions de formulaire.
L'insertion d'un bouton sur une conception de formulaire dans Designer ES2.5 et la configuration de son option d'envoi impliquent une
opération d'envoi. La fonction d'un bouton d'envoi consiste à remplir le formulaire et à envoyer les données au service Forms. Toutefois,
certaines opérations valides peuvent interrompre ce processus. Par exemple, si un utilisateur entre une valeur incorrecte dans un champ, il
peut être contraint de corriger cette valeur pour permettre l'envoi des données de formulaire. L'insertion d'autres types de boutons sur le
formulaire implique une opération de calcul. L'objectif d'une opération de calcul consiste à effectuer des calculs et à mettre à jour le
formulaire avant une opération d'envoi.
Rendu des formulaires contenant des images
Lorsque vous effectuez le rendu de formulaires dont les données contiennent des références à des images, celles-ci ne s'affichent pas toujours
correctement dans le formulaire rendu. Pour réussir le rendu des images au moment du rendu du formulaire côté client, définissez les
options d'exécution suivantes :
• PDFVersion=1.6 (ou supérieur)
• CacheEnabled=0
• renderAtClient=Auto
Pour le rendu du formulaire et des données côté serveur, définissez l'option d'exécution suivante : CacheEnabled=0.
ADOBE LIVECYCLE ES2.5
Service Forms
71
Services LiveCycle ES2.5
Rendu d'un formulaire PDF intégrant une image sécurisée
Il n'est pas rare de rencontrer une exception au moment d'effectuer le rendu d'un formulaire HTML contenant une image sécurisée par un
certificat. Par exemple, une exception peut survenir si vous utilisez l'application Forms IVS pour effectuer le rendu d'un formulaire
contenant une image sécurisée.
Pour résoudre ce problème, veillez à ce que le serveur d'applications J2EE démarre avec les mêmes valeurs de nom d'utilisateur et de mot de
passe que celles utilisées pour l'ajout côté client. Une fois cette tâche effectuée, le service Forms peut accéder aux informations
d'identification requises pour obtenir l'image.
Changements non retenus apportés à des champs image utilisant un script
Les modifications apportées à un champ image situé sur une conception de formulaire à l'aide d'un script côté client, tel que JavaScript, ne
sont pas envoyées et ne peuvent pas être obtenues par une application cliente. Prenons par exemple le cas de modifications apportées à un
champ image par un script, suivies d'une action de page suivante ou de page précédente. Les modifications effectuées par le script ne sont
alors pas retenues. Cela s'applique aux formulaires dont le rendu est effectué sous forme de documents HTML.
Activation des options de débogage
Vous pouvez activer les options de débogage au moment d'effectuer le rendu d'un formulaire PDF, d'un formulaire PDF dont les droits sont
activés ou d'un Guide. En activant l'option de débogage, vous obtenez des informations supplémentaires, comme par exemple les valeurs
d'exécution. Pour définir les options de débogage des opérations renderPDFForm, renderPDFFormWithUsageRights au sein d'un
processus généré dans Workbench, créez une variable du type PDFFormRenderSpec. Ensuite, au moyen de l'opération setValue, définissez
/process_data/pdfFormRenderSpecVar/object/@debugEnabled sur true. De même, pour l'opération renderHTMLForm, utilisez une
variable du type HTMLRenderSpec.
Vérification de la disponibilité des polices pour LiveCycle ES2.5
Vérifiez que les polices disponibles au sein d'un formulaire peuvent être utilisées sur le serveur hébergeant LiveCycle ES2.5. Prenons
l'exemple suivant. Un auteur de formulaire ajoute une police dans le répertoire de polices utilisé par le logiciel Designer ES2.5 et crée un
formulaire sur un autre ordinateur. Pour que le service Forms puisse utiliser cette police, vous devez vérifier qu'elle est correctement
déployée sur le serveur d'applications J2EE hébergeant LiveCycle. Si ce n'est pas le cas, la police ne pourra pas être utilisée. Vous pouvez
utiliser LiveCycle Administration Console pour déployer des polices.
Remarque : pour plus de détails sur la configuration des polices du service Output, reportez-vous à la section Définition des polices à incorporer
dans l'Aide à l'administration de LiveCycle ES2.5.
72
19. Service Generate PDF
Le service Generate PDF peut convertir de nombreux formats de fichier natifs en PDF. Il convertit également des fichiers PDF en d'autres
formats et optimise la taille des documents PDF.
Le service Generate PDF utilise des applications natives pour convertir les formats de fichiers suivants en PDF. Sauf précision contraire,
seules les versions allemande, anglaise, français et japonaise de ces applications sont prises en charge. L'expression Windows uniquement
indique la prise en charge de Windows Server® 2003 et Windows Server 2008 uniquement.
•
Microsoft Office2003 et 2007 pour convertir les formats DOC, DOCX, RTF, TXT, XLS, XLSX, PPT, PPTX, VSD, MPP, MPPX, XPS et
PUB (Windows uniquement)
Remarque : Acrobat® 9.2 ou version ultérieure est requis pour convertir le format Microsoft XPS en PDF.
•
•
•
Autodesk AutoCAD 2005, 2006, 2007, 2008, et 2009 pour convertir les formats DWF, DWG, et DXW (version anglaise uniquement)
Corel WordPerfect 12 et X4 pour convertir les formats WPD, QPW, SHW (anglais uniquement)
OpenOffice 2.0, 2.4, 3.0.1, et 3.1 pour convertir les formats ODT, ODS, ODP, ODG, ODF, SXW, SXI, SXC, SXD, DOC, DOCX, RTF,
TXT, XLS, XLSX, PPT, PPTX, VSD, MPP, MPPX et PUB
Remarque : le service Generate PDF ne prend pas en charge les versions 64 bits d'OpenOffice.
•
Adobe Photoshop® CS2 pour convertir les données PSD (Windows uniquement)
Remarque : Photoshop CS3 et CS4 ne sont pas pris en charge, car ils ne prennent pas en charge Windows Server 2003 et
Windows Server 2008.
•
•
•
Adobe FrameMaker® 7.2 et 8 pour convertir le format FM (Windows uniquement)
Adobe PageMaker® 7.0 pour convertir les formats PMD, PM6, P65 et PM (Windows uniquement)
Formats natifs pris en charge par les applications tierces (requiert le développement de fichiers d'installation spécifiques à l'application)
(Windows uniquement)
Le service Generate PDF peut convertir les formats standard suivants en PDF.
• Formats vidéo : SWF, FLV (Windows uniquement)
• Formats image : JPEG, JPG, JP2, J2Kì, JPC, J2C, GIF, BMP, TIFF, TIF, PNG, JPF
• HTML (Windows, Sun™ Solaris™ et Linux®)
Le service Generate PDF peut convertir des PDF aux formats de fichiers suivants (Windows uniquement) :
•
•
•
•
•
•
•
•
•
•
PostScript encapsulé (EPS)
HTML 3.2
HTML 4.01 avec CSS 1.0
DOC (format Microsoft Word)
RTF
Texte (à la fois accessible et brut)
XML
PDF/A-1a utilisant uniquement l'espace colorimétrique DeviceRGB
PDF/A-1b utilisant uniquement l'espace colorimétrique DeviceRGB
PDF/E-1 utilisant uniquement l'espace colorimétrique DeviceRGB
ADOBE LIVECYCLE ES2.5
Service Generate PDF
73
Services LiveCycle ES2.5
Le service Generate PDF requiert que vous réalisiez les tâches administratives suivantes :
• Installez les applications natives requises sur l'ordinateur hébergeant LiveCycle ES2.5.
• Installez Adobe Acrobat Professional ou Acrobat Pro Extended 9.2 sur l'ordinateur hébergeant LiveCycle ES2.5.
• Réalisez les tâches consécutives à l’installation.
Ces tâches sont décrites dans Installation et déploiement de LiveCycle ES2 à l'aide de la procédure clé en main JBoss.
Utilisation du service Generate PDF
Lors de la conversion au format PDF et autres types de fichiers, vous pouvez définir les paramètres à appliquer au document obtenu. Voici
les paramètres que vous pouvez utiliser pour définir ces options :
•
Paramètres PDF : cette option indique le nom des paramètres PDF d’Adobe à utiliser pour la conversion. Les paramètres indiqués sont
définis dans LiveCycle Administration Console. Par défaut, certains paramètres PDF Adobe sont préconfigurés sur la console. Le nom
de ces paramètres dépend des paramètres régionaux. Sur un système disposant d'une version du logiciel en anglais, ces noms sont les
suivants : High Quality Print, PDFA1b 2005 CMYK et Press Quality.
Si le paramètre Document de paramètres d'entrée fournit une valeur, il est ignoré. Si ce paramètre et le paramètre Document de
paramètres d'entrée ont tous les deux une valeur nulle, l'instance des paramètres du type de fichier définie par défaut sur le serveur
LiveCycle ES2.5 est utilisée.
•
Paramètres de sécurité : cette option indique le nom des paramètres de protection à utiliser pour la conversion. Les paramètres indiqués
sont définis dans LiveCycle Administration Console. Sur un système disposant d'une version du logiciel en anglais, seuls les paramètres
de sécurité No Security sont préconfigurés sur la console.
Si le paramètre Document de paramètres d'entrée fournit une valeur, il est ignoré. Si ce paramètre et le paramètre Document de paramètres
d'entrée ont tous les deux une valeur nulle, l'instance des paramètres de sécurité définie par défaut sur le serveur LiveCycle ES2.5 est utilisée.
•
Paramètres de type de fichier : cette option indique le nom de l'instance des paramètres de type de fichier indiquant le mode de
conversion de types de formats de fichier spécifiques. Vous pouvez créer des versions personnalisées de ces paramètres à l'aide de
LiveCycle Administration Console.
Si le paramètre Document de paramètres d'entrée fournit une valeur, il est ignoré. Si ce paramètre et le paramètre Document de
paramètres d'entrée ont tous les deux une valeur nulle, l'instance des paramètres du type de fichier définie par défaut sur le serveur
LiveCycle ES2.5 est utilisée.
•
Document de paramètres d'entrée : fichier XML contenant des paramètres de conversion, incluant les paramètres PDF et les paramètres
de sécurité Adobe PDF. Le document de paramètres d'entrée peut inclure différents jeux de paramètres. Cette opération a uniquement
recours aux jeux par défaut (reportez-vous à la section Références deparamètres de conversion LiveCycle ES2.5 Generate PDF.)
•
Métadonnées à incorporer au document PDF généré. Les métadonnées contiennent des informations telles que l'auteur et le sujet du
document, ainsi que tout mot-clé à associer au document. Seules les métadonnées Adobe Extensible Metadata Platform (XMP) codées
en UTF-8 sont prises en charge. Pour plus de détails sur le format et les spécifications, reportez-vous à la page Extensible Metadata
Platform (XMP) du site Web d'Adobe.
Sur les pages Web de PDF Generator ES2.5 dans la LiveCycle Administration Console, vous pouvez désigner une instance par défaut pour
chaque type de paramètre. (reportez-vous à l’Aide à l’administration de LiveCycle ES2.5).
Le service Generate PDF prend en charge les conversions de fichiers à plusieurs threads à l'aide de Microsoft Office ou d'OpenOffice. Pour
configurer votre système afin qu'il utilise cette fonction, cliquez sur le lien Comptes utilisateur et saisissez les informations d'identification
d'utilisateur pour ces applications. (Reportez-vous à la section Activation des conversions de fichiers à plusieurs threads OpenOffice, Word
et PowerPoint dans l'Aide à l'administration de LiveCycle ES2.5.)
ADOBE LIVECYCLE ES2.5
Service Generate PDF
74
Services LiveCycle ES2.5
Pour plus de détails sur le développement de processus utilisant le service Generate PDF, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
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 ES2.5.
Remarque : l'imprimante réseau PDFG (IPP) est une fonction du service Distiller. Vous pouvez l'utiliser pour envoyer les travaux de conversion
PostScript, EPS ou PRN au service Distiller (reportez-vous à la section « Service Distiller », page 33). Vous ne pouvez pas utiliser d'imprimante
réseau PDFG pour envoyer des travaux de conversion aux services Generate PDF.
Conversion de formats de fichier natifs en PDF
L'opération CreatePDF2 du service Generate PDF utilise des applications pour convertir les formats de fichiers natifs en PDF :
•
•
•
•
« Utilisation de Microsoft Office pour convertir des formats de fichiers en PDF », page 74
« Utilisation d'OpenOffice pour convertir des formats de fichiers en PDF », page 75
« Utilisation d'autres applications pour convertir des formats de fichiers en PDF », page 75
« Ajout de prise en charge d'autres applications pour convertir des formats de fichiers natifs en PDF », page 75
Utilisation de Microsoft Office pour convertir des formats de fichiers en PDF
L'opération CreatePDF2 du service Generate PDF peut utiliser les applications Microsoft Office suivantes pour convertir des fichiers de
format Microsoft Office en PDF :
• Microsoft Office Word (DOC, DOCX, RTF, TXT)
• Microsoft Office Excel (XLS, XLSX)
• Microsoft Office PowerPoint (PPT, PPTX)
• Microsoft Visio (VSD)
• Microsoft Project (MPP, MPPX)
• Microsoft Office Publisher (PUB)
• Office Document Writer (XPS)
Les paramètres de type de fichier définissent comment chaque type de format de fichier Microsoft Office est converti au format PDF. Voici
quelques exemples de paramètres :
•
•
Les paramètres de Microsoft Excel incluent l'ajustement des feuilles de calcul à une page et l'exécution automatique de macros.
Les paramètres de Microsoft PowerPoint incluent la conversion des liens de notes de fin et de bas de page ainsi que la conversion des
commentaires affichés en notes dans les documents PDF.
• Les paramètres d'AutoCAD incluent l'aplatissement des calques dans les documents PDF et la création d'une compatibilité PDF/E-1.
Voici quelques exemples de paramètres qui s'appliquent aux applications Microsoft Office :
•
Option d'utilisation d'OpenOffice comme convertisseur de secours. Si le service Generate PDF ne réussit pas à convertir les fichiers à
l'aide de l'application Microsoft Office correspondante, il peut le faire à l'aide d'OpenOffice.
• Compatibilité de la conversion vers PDF/A-1a.
Le service Generate PDF peut utiliser plusieurs instances de Microsoft Office pour convertir les fichiers Microsoft Office. Cette
fonctionnalité est appelée conversion à plusieurs threads. La conversion à plusieurs threads peut considérablement augmenter le taux de
conversion de fichiers Microsoft du service par rapport à l'utilisation d'une instance unique d'applications Microsoft Office. La prise en
charge de la conversion à plusieurs threads à l'aide de Microsoft Office requiert l'exécution de tâches consécutives à l'installation. Ces tâches
sont décrites dans le document Installation et déploiement de LiveCycle ES2 à l'aide de la procédure clé en main.
Remarque : le service Generate PDF ne prend pas en charge la conversion à plusieurs threads avec Microsoft Excel, Microsoft Publisher,
Microsoft Visio et Microsoft Project. Cette contrainte est due à des limitations liées à Microsoft Office et Microsoft Project.
ADOBE LIVECYCLE ES2.5
Service Generate PDF
75
Services LiveCycle ES2.5
La prise en charge des conversions de secours est disponible même si la conversion à plusieurs threads est activée. Si la conversion de secours
est activée, le service Generate PDF utilise OpenOffice pour convertir des fichiers Microsoft Office. Si OpenOffice échoue, le service
Generate PDF utilisera PDFMaker pour convertir les fichiers.
Remarque : lorsque le service Generate PDF utilise Microsoft Office 2003 sur un système d'exploitation 64 bits pour convertir des fichiers natifs,
il ne peut pas utiliser PDFMaker avec succès pour la conversion de secours.
Utilisation d'OpenOffice pour convertir des formats de fichiers en PDF
L'opération CreatePDF2 du service Generate PDF peut utiliser OpenOffice pour convertir de nombreux types de formats de fichiers natifs en
PDF. Il prend en charge les formats de fichiers OpenOffice suivants : ODT, ODS, ODP, ODG, ODF, SXW, SXI, SXC, SXD. Pour prendre en charge
la conversion de secours à l'aide des formats de fichiers Microsoft Office, ce service peut également convertir les types de fichiers suivants : BMP,
GIF, JPEG, JPG, TIF, TIFF, PNG, JPF, JPX, JP2, J2K, J2C, JPC, HTML, HTM, XLS, XLSX, PPT, PPTX, DOC, DOCX, RTF, TXT, WPD, PSD.
Les paramètres de type de fichier définissent comment chaque format de fichier pris en charge est converti au format PDF. Les paramètres
de conversion utilisés pour OpenOffice ne sont pas aussi spécifiques que ceux utilisés pour Microsoft Office. Voici quelques exemples de
paramètres OpenOffice :
• Compression sans perte
• PDF balisés
• Utilisation d'effets de transition
Les paramètres de type de fichier peuvent également déterminer que PDFMaker pour Microsoft Word doit être utilisé comme convertisseur
de secours. Si le service Generate PDF ne réussit pas à convertir les fichiers à l'aide d'OpenOffice, il peut le faire à l'aide de PDFMaker pour
Microsoft Word.
Le service Generate PDF peut utiliser plusieurs instances d'OpenOffice pour convertir les fichiers. Cette fonctionnalité est appelée
conversion à plusieurs threads. La conversion à plusieurs threads peut considérablement augmenter le taux de conversion de fichiers
OpenOffice du service par rapport à l'utilisation d'une instance unique d'OpenOffice. La prise en charge de la conversion à plusieurs threads
à l'aide d'OpenOffice requiert l'exécution de tâches consécutives à l'installation. Ces tâches sont décrites dans Installation et déploiement de
LiveCycle ES2 à l'aide de la procédure clé en main.
La prise en charge des conversions de secours est disponible même si la conversion à plusieurs threads est activée.
Utilisation d'autres applications pour convertir des formats de fichiers en PDF
L'opération CreatePDF2 du service Generate PDF peut utiliser les applications suivantes pour convertir d'autres formats de fichiers natifs
pris en charge en PDF :
•
•
•
•
•
Autodesk AutoCAD (DWF, DWG, DXW)
Corel WordPerfect (WPD, QPW, SHW)
Adobe Photoshop (PSD)
Adobe FrameMaker (FM)
Adobe PageMaker (PMD, PM6, P65, PM)
Ajout de prise en charge d'autres applications pour convertir des formats de fichiers natifs en PDF
Vous pouvez étendre la prise en charge à d'autres formats de fichiers natifs non pris en charge actuellement. L'extension de la prise en charge
implique les étapes suivantes :
•
•
•
Identification d'une application qui prend en charge le format natif
Installation de cette application sur l'ordinateur hébergeant LiveCycle
Création de fichiers d'exécution et de variables d'environnement qui spécifient comment le service Generate PDF interagit avec
l'application pour imprimer les fichiers de formats natifs.
ADOBE LIVECYCLE ES2.5
Service Generate PDF
76
Services LiveCycle ES2.5
Pour plus d'informations à propos de l'extension de la prise en charge à d'autres formats de fichiers natifs, reportez-vous à la section
Programmation avec LiveCycle ES2.5.
Conversion de formats de fichiers vidéo, image et HTML au format PDF
L'opération CreatePDF2 du service Generate PDF permet de convertir des formats de fichiers vidéo, image et HTML au format PDF.
Conversion de formats de fichiers vidéo au format PDF
L'opération CreatePDF2 du service Generate PDF permet de convertir des fichiers SWF et FLV en fichiers PDF. Ces types de fichiers sont
des vidéos créées avec Adobe Flash ou des applications créées avec Adobe Flex Builder. Le résultat de cette opération est un document PDF
contenant une annotation média qui contient la vidéo. Si vous ouvrez le fichier obtenu avec Acrobat 8 ou version ultérieure, vous pouvez
lire la vidéo.
Cette fonction ne peut pas être utilisée pour créer des interfaces de portfolios PDF. Un tel affichage inclut une interface utilisateur
ActionScript® personnalisable pour parcourir les fichiers d'un portfolio PDF (paquet PDF). Pour en savoir plus sur les portfolios PDF,
reportez-vous à la section The PDF Developer Junkie Blog du site Web d'Adobe.
Conversion de formats de fichiers image au format PDF
L'opération CreatePDF2 du service Generate PDF peut convertir de nombreux types de formats de fichiers image au format PDF. Reportezvous à la section « Service Generate PDF », page 72 pour obtenir la liste des formats d'image pris en charge.
Conversion de données HTML en PDF
Le service Generate PDF propose deux opérations pour convertir des fichiers HTML en documents PDF :
• L'opération HtmlToPDF2 permet de convertir un fichier HTML situé sur une URL donnée.
• L'opération HtmlFileToPDF permet de convertir un fichier HTML ou ZIP contenant des fichiers et des images HTML.
Vous pouvez définir comment le fichier HTML doit être converti au format PDF à l'aide des caractéristiques suivantes :
•
•
Paramètres d'indexation spécifiant l'inclusion du contenu d'un autre HTML référencé par le fichier HTML d'origine.
•
Options d'affichage de document spécifiant les caractéristiques d'affichage lorsque le document PDF est ouvert dans une application
d'affichage telle que Acrobat.
Paramètres de conversion de pages spécifiant la taille et les marges de la page, son orientation, le contenu des en-têtes et pieds de page
et l'affichage initial.
Remarque : la fonctionnalité de conversion de HTML en PDF requiert la spécification post-déploiement des dossiers de polices système. En
particulier, le dossier de polices système doit contenir toutes les polices utilisées pour de telles conversions. Votre administrateur système peut
également utiliser LiveCycle Configuration Manager pour spécifier les emplacements des dossiers de polices (reportez-vous à la section
Installation et déploiement de LiveCycle ES2 à l'aide de la procédure clé en main).
Conversion de PDF vers d’autres formats de fichiers (Windows uniquement)
L'opération ExportPDF2 du service Generate PDF permet de convertir les PDF vers de nombreux formats de fichiers. Reportez-vous à la
section « Service Generate PDF », page 72 pour obtenir la liste des formats de fichier d'exportation pris en charge.
Pour plus d'informations à propos des types de documents d'archives, reportez-vous à la spécification ISO 19005-1:2005, Gestion de
documents -- Format de fichier des documents électroniques pour une conservation à long terme, au Acrobat Developer Center, et au
didacticiel Adobe Acrobat Dusting Off Archives.
Remarque : les services Generate PDF et DocConverter convertissent des PDF en PDF/A-1B. Pour plus de détails sur le service DocConverter,
reportez-vous à la section « Service DocConverter », page 35.
ADOBE LIVECYCLE ES2.5
Service Generate PDF
77
Services LiveCycle ES2.5
Optimisation de fichiers PDF
L'opération OptimizePDF du service Generate PDF permet d'optimiser les fichiers PDF en réduisant leur taille. Le résultat de cette
conversion est un fichier PDF moins volumineux que sa version d'origine. Cette opération permet également de convertir des
documents PDF vers la version PDF spécifiée dans les paramètres d'optimisation.
Les paramètres d'optimisation spécifient comment les fichiers sont optimisés. Les paramètres sont les suivants :
• Version PDF cible
• Ignorer les objets tels que les actions JavaScript et les vignettes incorporées
• Ignorer les données des utilisateurs tels que les commentaires et les fichiers joints
• Ignorer les paramètres invalides ou inutilisés
• Compresser des données non compressées ou utiliser des algorithmes de compression plus efficaces
L'optimisation n'utilise pas les paramètres d'Adobe PDF.
Envoi de travaux de conversion au service Generate PDF
Vous pouvez envoyer les travaux de conversion au service Generate PDF en utilisant une des techniques décrites dans la section« Mode
d'utilisation des services par les développeurs », page 8. Vous pouvez également envoyer des travaux de conversion en cliquant sur l'un des
liens suivants de la page Web de LiveCycle PDF Generator ES2.5 dans LiveCycle Administration Console :
• Créer un fichier PDF
• HTML en PDF
• Optimiser un PDF
Vous pouvez utiliser cette page Web pour envoyer des travaux de conversion même si vous ne disposez pas des droits administrateur sur
LiveCycle ES2.5. Les utilisateurs non administrateurs peuvent accéder aux pages Web PDF Generator ES2.5 sur http://server:port/pdfgui.
Ces pages Web autorisent uniquement l'envoi de travaux de conversion. (reportez-vous à l’Aide à l’administration de LiveCycle ES2.5).
Vérification du fonctionnement du système du service Generate
PDF
Le service Generate PDF fournit des outils autonomes de vérification du système, qui permettent de garantir que le service est correctement
configuré. Vous pouvez utiliser cet outil à tout moment après avoir configuré ce service.
Le service Generate PDF exploite d'autres applications dont certaines peuvent requérir des noms d'utilisateurs et des mots de passe. En
résumé, la configuration du service Generate PDF est plus complexe que celle des autres services LiveCycle ES2.5 (reportez-vous à la section
Installation et déploiement de LiveCycle ES2 à l'aide de la procédure clé en main).
78
20. Service Generate 3D PDF
Le service Generate 3D PDF permet de convertir de nombreux formats de fichiers 3D en PDF 3D. Il peut également convertir ces mêmes
formats de fichiers 3D en d'autres formats de fichiers 3D et 2D. De plus, ce service peut réutiliser les résultats de conversions précédentes,
car il prend en charge les systèmes de gestion du cycle de vie du produit (PLM) et utilise les résultats de conversion mis en cache.
Remarque : le service Generate 3D PDF fonctionne uniquement avec des systèmes d'exploitation Microsoft Windows®. Cependant, Acrobat Pro
Extended version 9.1 doit être installé sur le serveur hébergeant LiveCycle ES2.5. Aucune application de CAO n'est requise pour prendre en
charge la conversion.
Le service Generate 3D PDF prend en charge les fichiers 3D créés par les applications de CAO suivantes. Il peut convertir les types de
fichiers pris en charge en PDF 3D ou en format de fichier d'export. Les extensions de noms des fichiers pris en charge sont indiquées entre
parenthèses.
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
3DXML (3DXML)
ACIS (SAT, SAB)
Acrobat 3D PDF (PDF)
Autodesk 3D Studio (3DS)
Autodesk Inventor jusqu'à la version 12.x, 2009 (IPT, IAM)
CADDS (PD, _PD, CADDS)
CGR (CGR)
COLLADA (DAE)
Hewlett-Packard Graphics Library (HP, HGL, HPL, HPGL, PLT)
Industry Foundation Classes (IFC)
Initial Graphics Exchange Specification (IGES, IGES)
JTOpen jusqu'à la version JT 9.1 (JT)
KMZ (KMZ)
Lattice XVL (XV3, XV0)
OneSpace Designer V3 JUSQU'A LA VERSION V2008 (PKG, SDP, SDPC, SDW, SDWC, SDA, SDAC, SDS,SDSC, SES, BDL)
Parasolid jusqu'à la version 19 (X_T, X_B)
Pro/ENGINEER (PRT, XPR, ASM, XAS, NEU)
Siemens I-deas (MF1, ARC, UNV, PKG)
Siemens NX jusqu'à la version NX 6, 2D (PRT)
Solid Edge V19, V20, ST (ASM, PAR, PWD, PSM)
SolidWorks jusqu'à la version 2009 (SLDASM, SLDPRT)
STEP Exchange AP 203, AP 214 (STP, STEP)
Stereo Lithography (STL)
TTF PRC (PRC, PRD)
UG NX
UG NX drawings
Universal 3D ECMA 1, ECMA 3 (U3)
Virtual Reality Modeling Language (VRML) Worlds V1.0, V2.0 (WRL, VRML)
Wavefront Object (OBJ)
ADOBE LIVECYCLE ES2.5
Service Generate 3D PDF
79
Services LiveCycle ES2.5
Le service Generate 3D PDF peut également convertir des PDF 3D et des fichiers CAO 3D aux formats 3D suivants : il peut par exemple
convertir un fichier Wavefront Object en VRML.
• PDF 3D
• PDF/E-1
• IGES
• Parasolid
• STEP
• STL
• Universal 3D
• VRML
Le service Generate 3D PDF peut convertir des fichiers PDF 3D et des fichiers CAO 3D aux formats 2D suivants :
• DXF
• EMF
Le service Generate 3D PDF permet également de convertir un fichier CAO 2D aux formats suivants :
•
•
PostScript
EMF
Utilisation du service Generate 3D PDF
Vous pouvez utiliser les opérations de ce service pour indiquer le fichier CAO à convertir dans l'un des formats suivants :
•
•
Fichier CAO unique.
•
Fichier XML représentant l'assemblage et faisant référence aux fichiers des éléments utilisés dans l'objet 3D. Le format des fichiers
désignés peut être natif, ou il peut s'agir de fichiers PDF. Le format PDF est parfait pour la mise en cache des formulaires. Les opérations
du service Generate 3D PDF prenant en charge les fichiers de structure d'assemblage XML peuvent permettre de récupérer les éléments
désignés se trouvant à l'un des emplacements suivants :
Fichier d'assemblage CAO faisant référence à d'autres fichiers qui contiennent les sous-assemblages et éléments utilisés dans l'objet 3D.
Fournissez ces autres fichiers (dans leur format natif) dans un ensemble de fichiers de support.
• Ensemble de fichiers de support, fourni en tant qu'argument.
• Emplacement des fichiers.
Lors de la conversion au format PDF et autres types de fichiers, vous pouvez définir les paramètres à appliquer au document obtenu. Voici
comment vous pouvez définir les paramètres à utiliser pour une conversion :
•
Saisissez le nom des paramètres prédéfinis dans LiveCycle Administration Console, sur la page Web de LiveCycle PDF Generator 3D
ES2.5.
•
Fournissez le fichier XML représentant les paramètres. Ce fichier représente chaque paramètre présenté par LiveCycle Administration
Console, sur la page Web de PDF Generator 3D ES2.5.
Une des propriétés de ces paramètres est l'emplacement d'un document de modèle PDF contenant une ou plusieurs annotations 3D. Lors
de la conversion des fichiers 3D en fichiers PDF 3D, le service Generate 3D PDF utilise une copie du fichier de modèle PDF comme fichier
de destination pour les résultats de la conversion. Le service convertit l'objet 3D au format PRC et place ensuite l'objet PRC dans l'une des
annotations 3D dans le fichier PDF de destination.
ADOBE LIVECYCLE ES2.5
Service Generate 3D PDF
80
Services LiveCycle ES2.5
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. Pour plus de
détails sur le développement des applications clientes qui interagissent par programmation avec ce service, reportez-vous à la section
Programmation avec LiveCycle ES2.5.
Création d'un PDF 3D à l'aide des paramètres de conversion 3D du serveur
L'opération Create3dPDF du service Generate 3D PDF permet de convertir un fichier CAO en un document PDF 3D à partir des
paramètres de conversion 3D configurés sur le serveur LiveCycle ES2.5. Pour plus de détails sur la configuration des paramètres de
conversion 3D, reportez-vous à la section Configuration des paramètres Adobe PDF 3D dans l'Aide à l'Administration de LiveCycle ES2.5.
Création d'un PDF 3D à l'aide des paramètres de conversion à partir d'un fichier XML.
L'opération Create3dPDFCustom du service Generate 3D PDF permet de convertir un fichier CAO en un document PDF 3D à partir des
paramètres de conversion 3D personnalisés et définis dans un fichier XML. Le fichier XML doit se conformer au schéma
pdfg3d_per_jobsettings.xsd pour les paramètres de conversion 3D. (Reportez-vous à la section Références de paramètres de conversion
Generate 3D PDF pour LiveCycle ES2.5). Si vous ne spécifiez pas de fichier XML, le paramétrage de conversion par défaut indiqué sur le
serveur LiveCycle ES2.5 est utilisé.
Conversion d'un fichier PDF 3D en PDF/E-1
Vous pouvez utiliser le service Generate 3D PDF pour convertir un document PDF 3D au format PDF/E-1 ou pour vérifier qu'il est
compatible avec le format PDF/E-1.
Conversion d'un fichier CAO vers le format PDF 3D ou vers d'autres formats de fichiers 3D ou 2D
L'opération Convert3d du service Generate 3D PDF permet de convertir un fichier CAO en un document PDF 3D ou autre fichier 3D ou
2D utilisant un autre format. Vous pouvez spécifier les paramètres de conversion 3D définis sur le serveur ou fournir un fichier XML
contenant ces paramètres.
Utilisation d'un contenu 3D mis en cache pour convertir un fichier CAO
Pour faciliter la conversion de fichiers 3D au format PDF ou autre, vous pouvez utiliser les résultats de conversion mis en cache. Le cache
est constitué de fichiers PDF 3D créés pour les parties qui forment l'assemblage 3D. Cette conversion est similaire à l'opération décrite à la
section « Conversion d'un fichier CAO vers le format PDF 3D ou vers d'autres formats de fichiers 3D ou 2D », page 80, à l'exception du fait
qu'elle utilise du contenu 3D mis en cache à partir de fichiers PDF 3D.
Pour que vous puissiez recourir à un contenu 3D mis en cache pour la conversion d'un fichier CAO, votre application doit suivre la
procédure générale suivante :
1
Utiliser l'opération Explore3D du service Generate 3D PDF pour explorer un objet 3D particulier. Le résultat est un fichier XML qui
décrit la structure d'un assemblage CAO. Le fichier XML est conforme aux exigences du document Références des structures
d’assemblage LiveCycle Generate3D PDF. Cette vérification ne génère pas de résultat converti.
2
Déterminer si les fichiers répertoriés dans le fichier XML ont déjà été convertis en PDF 3D. Si c'est le cas, ajoutez les chemins vers ces
fichiers PDF 3D dans le fichier XML.
3
Utiliser l'opération Convert3dWithCache du service Generate 3D PDF pour convertir un objet 3D au format PDF 3D ou autre. L'entrée
principale de cette opération est le fichier XML.
ADOBE LIVECYCLE ES2.5
Service Generate 3D PDF
81
Services LiveCycle ES2.5
Utilisation d'une structure d'assemblage XML pour convertir un fichier CAO
L'opération Convert3dFromXML du service Generate 3D PDF est semblable à celle que décrit la section« Conversion d'un fichier CAO vers
le format PDF 3D ou vers d'autres formats de fichiers 3D ou 2D », page 80. La seule différence est le fait que la procédure de conversion
utilise un fichier XML contenant une structure d'assemblage pour identifier les fichiers à convertir. Les systèmes de gestion du cycle de vie
du produit sont généralement utilisés pour créer des fichiers XML de ce type. Ces systèmes mettent à jour le fichier XML de façon qu'il fasse
référence à des éléments déjà convertis au format de sortie 3D. Le fichier XML est conforme aux exigences du document Références des
structures d’assemblage LiveCycle Generate3D PDF.
Utilisation d'un contenu 3D mis en cache et d'une structure d'assemblage pour la conversion d'un
fichier CAO
L'opération Convert3dWithPlm du service Generate 3D PDF permet de convertir un fichier CAO représenté par un fichier XML pour une
structure d'assemblage et un contenu 3D mis en cache. Cette fonctionnalité est une combinaison de « Utilisation d'un contenu 3D mis en cache
pour convertir un fichier CAO », page 80 et de« Utilisation d'une structure d'assemblage XML pour convertir un fichier CAO », page 81.
Utilisation de fonctionnalités personnalisées avec la conversion 3D
Lorsque vous utilisez le service Generate 3D PDF pour convertir des fichiers CAO, vous pouvez fournir un fichier XML qui sera utilisé par
le moteur de conversion 3D pour interagir avec un plug-in personnalisé (module complémentaire). Le fichier XML identifie le plug-in à
utiliser et fournit des paramètres personnalisés qui seront exploités par le plug-in.
Voici quelques exemples de fonctionnalités qu'un tel module plug-in peut ajouter :
• Prise en charge de nouveaux formats de fichiers 3D.
• Informations spéciales pour les objets qui constituent le fichier 3D.
Pour plus d'informations sur les plug-ins du moteur de conversion 3D, contactez votre représentant Adobe.
Appel du service Generate 3D PDF
Vous pouvez appeler les opérations de ce service en utilisant une des techniques décrites dans la section « Mode d'utilisation des services
par les développeurs », page 8. Si vous utilisez les dossiers de contrôle pour appeler ce service pour un document 3D constitué d'une
hiérarchie de fichiers (une structure d'assemblage), envoyez ces fichiers sous forme de dossier. Le dossier peut inclure des sous-dossiers pour
représenter la structure de l'assemblage.
Vous pouvez également appeler certaines des opérations de ce service à l'aide des pages Web de LiveCycle PDF Generator ES2.5 dans
LiveCycle Administration Console. L'utilisation des pages Web est destinée à des fins de démonstration et de test. En effet, l'utilisation des
pages Web PDF Generator ES2.5 pour les tâches de conversion en 3D nécessite des droits d'administrateur (reportez-vous à l’Aide à
l’administration de LiveCycle ES2.5).
82
21. Service JDBC
Le service JDBC permet aux processus d’interagir avec des bases de données. Par exemple, un processus peut demander que les données
envoyées à partir d’un formulaire renseignent une base de données interne ou que les données d’une base de données préremplissent un
formulaire. Le processus peut contenir une logique applicative qui lie les données des champs de formulaire à la base de données sousjacente. Les champs peuvent être associés aux colonnes de la base de données. Des éléments de ligne distincts d’un formulaire rempli peuvent
également créer plusieurs lignes dans la base de données. S’il existe déjà une procédure enregistrée qui renseigne la base de données, un
processus peut l’utiliser pour mettre à jour les données.
Un processus peut également exécuter une règle commerciale qui dépend des données stockées dans une base de données. Par exemple, si
un client est en retard sur un paiement, la commande n’est pas expédiée et un rappel lui est envoyé par messagerie électronique. Un processus
peut interroger la base de données et rechercher l’état en fonction de l'identifiant du client, puis créer une règle en fonction de cette valeur.
Utilisation du service JDBC
Vous pouvez interagir avec le service JDBC en développant un processus dans LiveCycle Workbench utilisant ce service. Vous pouvez
exécuter les tâches ci-dessous à l’aide de ce service :
• Spécification de la source de données à utiliser pour la connexion au serveur de base de données.
• Exécution d’une procédure enregistrée dans la base de données.
• Exécution d’une instruction SQL sur un serveur de base de données et renvoi du nombre de lignes affectées.
• Interrogation de la base de données à l’aide d’une instruction SQL et renvoi de l’ensemble de résultats en tant que données XML.
• Interrogation de la base de données à l’aide d’une instruction SQL et enregistrement de la première ligne de l’ensemble de résultats.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
Vous pouvez utiliser les pages Applications and Services de LiveCycle Administration Console pour configurer les propriétés par défaut de
ce service (reportez-vous à la section Paramètres du service JDBC dans l'Aide à l'administration de LiveCycle ES2.5.)
Remarques sur le service JDBC
La source de données utilisée pour se connecter au serveur de données doit être définie sur le serveur d’applications qui héberge le serveur
LiveCycle ES2.5. La valeur par défaut correspond au nom JNDI de la source de données de la base de données LiveCycle ES2.5.
Pour appeler des procédures enregistrées ou exécuter des instructions SQL, le compte utilisateur de la base de données qui est utilisé pour
accéder à la base de données doit disposer des autorisations requises sur celle-ci.
83
22. Service JMS
Le service JMS permet l’interaction avec les fournisseurs JMS (Java Messaging System), qui implémentent la messagerie point à point et la
messagerie de type publish-subscribe.
Le service JMS permet de recevoir un message d’une file d’attente de messages désignée. Par exemple, un processus peut être amorcé en
fonction d’un message en file d’attente lors de la création d’une commande. Dans cet exemple, ce service est utilisé comme première étape
du processus pour rechercher le message et amorcer le processus.
Le service JMS permet également d’envoyer un message vers une file d’attente de messages désignée ou d’en publier un dans une rubrique.
Par exemple, il peut être nécessaire d’envoyer un message vers une file d’attente demandant aux autres systèmes de « créer un profil client »
et de transmettre les informations sur le client. Un processus peut tirer parti du service JMS pour envoyer le message et transmettre les détails
du client sous la forme d’un document XML à partir d’une variable de processus.
Utilisation du service JMS
Vous pouvez interagir avec le service JMS en développant un processus dans LiveCycle Workbench utilisant ce service. Vous pouvez
exécuter les tâches ci-dessous à l’aide de ce service :
• Publication d’un message dans une rubrique du fournisseur JMS.
• Récupération d’un message stocké dans une file d’attente du fournisseur JMS.
• Envoi d’un message vers une file d'attente du fournisseur JMS.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
Vous pouvez utiliser les pages Applications and Services de LiveCycle Administration Console pour configurer les propriétés par défaut de
ce service (reportez-vous à la section Paramètres du service JMS dans l'Aide à l'administration de LiveCycle ES2.5.)
Remarques sur le service JMS
Vous devez tenir compte des facteurs ci-dessous lors du développement des processus utilisant ce service :
•
Les files d’attente et les rubriques doivent être configurées sur le fournisseur JMS (par un administrateur) pour que vous puissiez les
utiliser. En général, les applications JMS utilisent les services JNDI (Java Naming and Directory Interface) pour rechercher les noms des
rubriques et des files d’attente configurées. Une fois le nom trouvé, le client JMS se connecte au service JMS pour interagir avec les files
d’attente et les rubriques.
•
Vous devez configurer le service JMS avec les propriétés par défaut pour que ses opérations puissent se connecter et interagir avec un
fournisseur JMS et un service JNDI associé. Les propriétés du service sont définies sur les valeurs par défaut basées sur le serveur
d’applications JBoss. Modifiez ces valeurs si vous utilisez un autre serveur d’applications pour héberger LiveCycle ES2.5.
84
23. Service LCCPLM
Le service LiveCycle Connector pour PLM (LCCPLM) permet de faire interagir des processus et des applications avec un système de gestion
du cycle de vie du produit (PLM). Les systèmes PLM ont été conçus pour permettre la gestion d'un produit à travers son cycle de vie, ainsi
que l'intégration de personnes, données, processus et systèmes métier. Un objet PLM inclut toutes les données d'un projet d'ingénierie,
documents Microsoft Word, images, dessins 2D et conceptions 3D inclus.
Le service LCCPLM appelle les méthodes correspondantes dans un composant PLM, fourni comme un conteneur de services. Installez un
composant PLM qui interagit avec votre système PLM :
Composant PLM installé avec LiveCycle ES2.5 : par défaut, le service LCCPLM interagit avec un composant PLM de remplacement.
Exemple de composant PLM : Adobe fournit un exemple d'implémentation d'un composant PLM utilisant le système de fichiers en tant
que système PLM. Cet exemple n'est pas installé avec les exemples LiveCycle ES2.5. Pour plus d'informations, contactez votre représentant
Adobe :
Composants PLM tiers : pour plus d'informations, contactez votre représentant Adobe.
Utilisation du service
Obtenir un descripteur de données et métadonnées
Cette opération permet de récupérer les données et métadonnées d'un objet PLM spécifique, à partir de son identifiant. Les métadonnées
peuvent inclure tout champ pour l'objet PLM qui peut être extrait du système PLM. Les métadonnées ne sont pas liées aux métadonnées
provenant d'autres sources. Elles ne contiennent donc pas de métadonnées PDF ou Word.
Enregistrer les commentaires d'un document
Cette opération permet d'enregistrer les données et commentaires associés à un objet PLM. Elle utilise les données et commentaires en tant
que document XDP. L'implémentation du client PLM permet de stocker les données et commentaires dans le système PLM, via un objet du
même type.
XDP est une grammaire XML fournissant un mécanisme pour la mise en forme des composants XFA au sein d'un conteneur XML. Les
composants XFA en question peuvent inclure un document PDF, des commentaires et des données de formulaire XFA.
Par exemple, les concepteurs de formulaire peuvent créer des formulaires XML générant automatiquement un document XDP lorsque
l'utilisateur clique sur le bouton d'envoi du formulaire (reportez-vous à la section « Envoi depuis un document XDP ou depuis un document
PDF basé sur XFA », page 85).
Enregistrer les commentaires d'une chaîne
Cette opération permet d'enregistrer les commentaires associés à un objet PLM. Elle utilise les données et commentaires en tant que chaîne
XFDF. L'implémentation du client PLM permet de stocker les données et commentaires dans le système PLM, via un objet du même type.
XFDF (XML Forms Data Format) est une grammaire XML destinée à la représentation des données et commentaires de formulaires extraits
d'un document PDF.
Les concepteurs de formulaires peuvent appliquer des boutons d'envoi à des documents PDF qui génèrent automatiquement un flux XFDF
(reportez-vous à la section « Soumission depuis un document PDF », page 86).
ADOBE LIVECYCLE ES2.5
Service LCCPLM
85
Services LiveCycle ES2.5
Stocker un PDF
Cette opération vérifie dans le système PLM que le PDF a été généré à l'aide d'un objet PLM.
Remarques sur le service
Scénarios
Voici un exemple de flux de travail LiveCycle ES2.5 que vous pouvez développer en utilisant votre système PLM avec un processus LiveCycle
ES2.5 :
1
Obtenir les fichiers d'un objet PLM.
2
Créer un document PDF pour un objet PLM entier.
3
Protéger le document PDF par une stratégie pour restreindre sa diffusion.
4
Enregistrer le document PDF avec un objet PLM.
5
Obtenir un PDF à partir d'un objet PLM.
6
Remplir le PDF en utilisant les métadonnées extraites de l'objet PLM.
7
Soumettre le document PDF à des individus définis. Ces réviseurs peuvent alors ajouter leurs commentaires dans le fichier PDF.
Les réviseurs peuvent utiliser des outils de tels que Acrobat Pro Extended pour comparer les documents et analyser les sections des données.
Vous pouvez utiliser Acrobat Pro Extended pour mesurer, croiser et calculer les propriétés physiques de documents PDF trois-dimensions
(3D).
8
Enregistrer les commentaires avec un objet PLM.
Envoi de données et commentaires
Le format du document de révision affecte le mode de soumission des données et des commentaires. Pour votre révision, vous pouvez
utiliser les formats suivants :
•
•
•
XDP contenant un formulaire XML (modèle XFA). Ce format prend en charge les champs de formulaire XFA.
PDF basé sur XFA. Ce format prend en charge les champs de formulaire XFA.
PDF. Ce format prend en charge les champs de formulaire Acrobat uniquement.
Envoi depuis un document XDP ou depuis un document PDF basé sur XFA
LiveCycle Designer ES2 permet aux concepteurs de formulaires de créer des formulaires XFA qui produisent automatiquement un
document XDP, que cette méthode peut utiliser. Ces formulaires présentent les caractéristiques suivantes :
•
Bouton qui permet d'envoyer un flux XDP à une destination spécifiée. Par défaut, le flux contient un paquet de jeux de données. Pour
inclure le paquet XFDF également dans le flux envoyé, un développeur de formulaire indique que les commentaires sont inclus dans le
flux XDP.
•
Les champs peuvent être remplis au moyen de données fournies par une autre source. Par exemple, les applications peuvent remplir les
champs en utilisant les données obtenues suite à l'opération getDataAndMetaData.
ADOBE LIVECYCLE ES2.5
Service LCCPLM
Services LiveCycle ES2.5
Voici un exemple de données XDP créées lorsque l'utilisateur clique sur le bouton destiné à envoyer le document XDP.
<?xml version="1.0" encoding="UTF-8"?>
<xdp:xdp xmlns:xdp="http://ns.adobe.com/xdp/" timeStamp="2009-01-22T16:39:34Z"
uuid="361e12df-196c-4ec2-b57a-08156b2f6393">
<xfa:datasets xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/">
<xfa:data>
<lccplmsubmitform>
<lccplmsubmitpage>
<livecycleService>http://mylcserver:8080/SubmitPdfServlet</livecycleService>
<objectId>1898.21382.38578.43955</objectId>
<myplmhost>http://myserver:7001/myplm</myplmhost>
<myplmpassword/>
<lclogin>administrator</lclogin>
<lcpassword>password</lcpassword>
<fileName>myFile.pdf</fileName>
</lccplmsubmitpage>
</lccplmsubmitform>
</xfa:data>
</xfa:datasets>
<pdf xmlns="http://ns.adobe.com/xdp/pdf/"
href="http://myreposserver:7001/LCCPLMViewer/ViewPfServlet"/>
<xfdf xmlns="http://ns.adobe.com/xfdf/" xml:space="preserve">
<annots>
<text color="#FFFF00" creationdate="D:20090427183422+02'00'" date="D:20090427185514+02'00'"
flags="print,nozoom,norotate" icon="Comment"
name="017b34e3-d1a3-4a32-8907-b4cdd1a4879b" page="1"
rect="49.698502,32.301498,69.698502,50.301498" subject="Sticky Note" title="myUserName">
<contents-richtext>
<body xmlns="http://www.w3.org/1999/xhtml"
xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/"
xfa:APIVersion="Acrobat:9.1.0" xfa:spec="2.0.2">
<p dir="ltr">
<span dir="ltr" style="font-size:10.0pt;text-align:left;color:#000000;fontweight:normal;font-style:normal">modified again</span>
</p>
</body>
</contents-richtext>
<popup flags="print,nozoom,norotate" open="yes" page="1"
rect="100.10701,-16.941605,280.106995,102.839996"/>
</text>
</annots>
</xfdf>
</xdp:xdp>
Pour de plus amples informations, reportez-vous à l'Aide de LiveCycle Designer ES2 et à la spécification de XDP dans la spécification de
l'architecture XFA (XML Forms Architecture)
Soumission depuis un document PDF
Les développeurs de formulaires peuvent utiliser Acrobat pour ajouter un bouton normal dans un document PDF. Ce bouton peut être
associé à un script déclenché par l'événement de clic. Le script appelle la méthode exportAsXFDFStr pour extraire les données et
commentaires du fichier. Il peut également utiliser les services SOAP et Web pour envoyer la chaîne à une URL.
Lorsque l'utilisateur clique sur le bouton, la méthode génère une chaîne XFDF et appelle le serveur au moyen de cette chaîne.
86
ADOBE LIVECYCLE ES2.5
Service LCCPLM
Services LiveCycle ES2.5
Voici un exemple de chaîne décodée pour un flux XFDF. La chaîne XFDF est codée en base 64. Ce flux est créé lorsque l'utilisateur clique
sur le bouton d'envoi.
<?xml version="1.0" encoding="UTF-8"?>
<xfdf xmlns="http://ns.adobe.com/xfdf/" xml:space="preserve" >
<annots >
<text color="#FFFF00" creationdate="D:20090326165627+01'00'" flags="print,nozoom,norotate"
date="D:20090326165715+01'00'" name="3e792ddf-43a3-4194-b610-50b4486e3a64" icon="Comment"
page="1" rect="395.789001,172.511002,415.789001,190.511002" subject="Sticky Note"
title="myUserName" >
<contents-richtext >
<body xmlns="http://www.w3.org/1999/xhtml"
xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/"
xfa:APIVersion="Acrobat:9.1.0" xfa:spec="2.0.2" >
<p dir="ltr" >
<span dir="ltr" style="font-size:10.0pt;text-align:left;color:#000000;fontweight:normal;font-style:normal" >ffddsd

dffd
sd

dd
</span >
</p >
</body >
</contents-richtext >
<popup flags="print,nozoom,norotate" open="yes" page="1" rect="792,70.510803,972,190.511002" />
</text >
</annots >
<f href="http://myreposserver:7001/LCCPLMViewer/ViewPfServlet" />
<champs >
<field name="lccplmsubmitform[0]" >
<field name="lccplmsubmitpage[0]" >
<field name="fileName[0]" >
<value >mycadfile.CATProduct</value >
</field >
<field name="lclogin[0]" >
<value >administrator</value >
</field >
<field name="lcpassword[0]" >
<value >password</value >
</field >
<field name="livecycleService[0]" >
<value >http://mylcserver:8080/SubmitPdfServlet</value >
</field >
<field name="myplmhost[0]" >
<value >http://myserver:7001/myplm</value >
</field >
<field name="myplmuser[0]" >
<value >myUserName</value >
</field >
<field name="objectId[0]" >
<value >1898.21382.59476.64247</value >
</field >
</field >
</field >
</fields >
<ids original="1D9C55A458905E42A88ECB572F7E8C0C" modified="210B8FF4CE1B8AFFCD2E91DC39D884FF" />
</xfdf >
Pour de plus amples informations, reportez-vous à la spécification XFDF (XML Forms Data Format) et au Développement d'applications
Acrobat via JavaScript
87
88
24. Service LDAP
Le service LDAP fournit des opérations permettant d’interroger les répertoires LDAP. Les répertoires LDAP sont généralement utilisés pour
stocker des informations sur les personnes, les groupes et les services d’une entreprise.
Par exemple, les répertoires LDAP stockent généralement des informations sur la division d’entreprise à laquelle une personne appartient,
des informations qui identifient cette personne ainsi que des informations sur la façon de la contacter, notamment ses numéros de téléphone
et ses adresses électroniques. Un processus peut utiliser le service LDAP pour demander des détails en fonction de l'identifiant de
l’utilisateur, puis les associer à une variable du processus afin de remplir un formulaire.
Utilisation du service LDAP
Vous pouvez interagir avec le service LDAP en développant un processus dans LiveCycle Workbench utilisant ce service. Vous pouvez
exécuter les tâches ci-dessous à l’aide de ce service :
•
•
Exécution d’une recherche sur le serveur LDAP et renvoi des résultats, que vous pouvez enregistrer en tant que données de processus.
Exécution d’une recherche sur le serveur LDAP et renvoi des résultats dans un document XML que vous pouvez enregistrer en tant que
données de processus.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
Vous pouvez utiliser les pages Applications and Services de LiveCycle Administration Console pour configurer les propriétés par défaut de
ce service (reportez-vous à la section Paramètres du service LDAP dans l'Aide à l'administration de LiveCycle ES2.5.)
Remarques sur le service LDAP
Vous devez tenir compte des facteurs ci-dessous lors du développement des processus utilisant ce service :
•
Vous devez configurer les propriétés utilisées pour la connexion au serveur LDAP pour pouvoir recourir aux opérations du service
LDAP.
•
Les répertoires LDAP utilisent une arborescence comme modèle de données. Différents types de bases de données, comme Sun ONE
ou Microsoft Active Directory, utilisent des arborescences différentes. En règle générale, les administrateurs LDAP personnalisent la
structure du répertoire en fonction des besoins de leur entreprise. Pour en savoir plus sur le répertoire que vous interrogez, consultez
votre administrateur LDAP.
89
25. Service Output
Le service Output vous permet de créer des documents dans différents formats, y compris PDF et PDF/A et les formats d'imprimantes laser
et d'imprimantes d'étiquettes. Les formats d'imprimantes laser sont les suivants : PostScript et PCL (Printer Control Language). La liste cidessous répertorie les formats d'imprimantes d'étiquettes :
• ZPL (Zebra Programming Language)
• IPL (Intermec)
• DPL (Datamax)
• TPCL (TecToshiba)
Vous pouvez envoyer un document à une imprimante réseau, une imprimante locale ou un fichier situé sur le système de fichiers. Le service
Output fusionne les données du formulaire XML avec une conception de formulaire pour générer un document. Il peut générer un
document sans fusionner les données du formulaire XML dans le document. Toutefois, le flux de production principal fusionne les données
dans le document (reportez-vous à la section « Données de formulaire », page 99).
Remarque : la création d'une conception de formulaire se fait généralement à l'aide de LiveCycle Designer ES2.5. Pour plus de détails sur la
création de conceptions de formulaires destinées au service Output, reportez-vous à la section Conception de formulaires pour LiveCycle Output
ES2.
Lorsque vous utilisez le service Output pour fusionner des données XML avec une conception de formulaire, il en résulte la création d'un
document PDF non interactif. Dans ce type de document, les utilisateurs n'ont pas la possibilité de saisir des données dans les champs. A
l'inverse, vous pouvez utiliser le service Forms pour créer un formulaire PDF interactif leur permettant de saisir des données (reportez-vous
à la section « Service Forms », page 50).
Les quatre opérations du service Output mentionnées ci-dessous sont disponibles pour LiveCycle Workbench :
generatePDFOuput2 : fusionne une conception de formulaire avec des données pour générer un document PDF.
generatePrintedOutput : fusionne une conception de formulaire avec des données pour générer un document à envoyer à une imprimante
laser ou une imprimante d'étiquettes réseau.
sendToPrinter : imprime un document sur l'imprimante spécifiée.
transformPDF : convertit un formulaire PDF interactif en document PDF non interactif.
Remarque : par défaut, les méthodes déconseillées ne s'affichent pas dans Workbench. Activez les options correspondantes pour visualiser les
méthodes déconseillées.
En plus d'utiliser Workbench, vous pouvez interagir par programmation avec le service Output grâce à l'utilisation de l'API Output Service
(reportez-vous à la section Programmation avec LiveCycle ES2.5).
ADOBE LIVECYCLE ES2.5
Service Output
90
Services LiveCycle ES2.5
Utilisation du service Output
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l'Aide de LiveCycle Workbench. Pour en savoir
plus sur les méthodes d'appel de ce service à l'aide des dossiers de contrôle ou d'une messagerie électronique, reportez-vous à la section
Présentation de LiveCycle ES2.5.
Pour plus de détails sur la configuration initiale de ce service, reportez-vous à l'Aide à l’administration de LiveCycle ES2.5.
Création de documents PDF
Vous pouvez utiliser le service Output pour créer un document PDF reposant sur une conception de formulaire et des données de formulaire
XML. Ce document est un document PDF non interactif. Les utilisateurs ne peuvent donc pas saisir ou modifier des données du formulaire.
Un flux de production de base d'Output permet de fusionner des données de formulaire XML avec une conception de formulaire pour
générer un document PDF. Le schéma suivant illustre le service Output fusionnant une conception de formulaire avec des données de
formulaire XML pour générer un document PDF.
Création de documents PDF/A
Vous pouvez utiliser le service Output pour créer un document PDF/A. Etant donné que le format PDF/A est un format d'archivage pour
une conservation à long terme du contenu d'un document, toutes les polices sont intégrées et le fichier n'est pas compressé. Par conséquent,
un document PDF/A est généralement plus volumineux qu'un document PDF standard. De plus, un document PDF/A ne peut pas contenir
de données audio et vidéo. Comme pour les autres tâches du service Output, vous fournissez à la fois une conception de formulaire et des
données à fusionner avec cette conception afin de créer un document PDF/A.
La spécification PDF/A-1 possède deux niveaux de conformité : A et B. La différence entre les deux concerne la prise en charge (accessibilité)
de la structure logique (requise pour le niveau A, mais non pour le niveau B). Quel que soit le niveau de conformité, PDF/A-1 impose que
toutes les polices soient incorporées dans le document PDF/A généré.
Bien que PDF/A soit la norme pour l'archivage de documents PDF, vous pouvez stocker un document PDF s'il répond à vos besoins.
Toutefois, un document PDF peut contenir du contenu devenu obsolète. Par exemple, une URL qui fait référence un site Web peut cesser
d'être utilisée. La norme PDF/A vise à établir un fichier PDF utilisable à long terme.
ADOBE LIVECYCLE ES2.5
Service Output
91
Services LiveCycle ES2.5
Le schéma suivant illustre le service Output fusionnant une conception de formulaire avec des données de formulaire XML pour générer un
document PDF/A.
Remarque : le site Web AIIM contient une section FAQ sur le format PDF/A, disponible à l'adresse :
http://www.aiim.org/documents/standards/19005-1_FAQ.pdf.
Envoi de documents à des imprimantes
Vous pouvez utiliser le service Output pour envoyer des formats d'imprimante laser et des formats d'imprimante d'étiquettes à une
imprimante. Pour obtenir la liste des formats pris en charge, reportez-vous à la section « Service Output », page 89.
Remarque : les fabricants d'imprimantes d'étiquettes conçoivent des imprimantes prenant en charge plusieurs langages d'impression. Les
imprimantes Zebra n'utilisent pas toutes le langage ZPL. Assurez-vous que votre imprimante prend en charge ce langage d'impression.
Le schéma suivant illustre l'envoi de documents vers des imprimantes réseau par le service Output.
ADOBE LIVECYCLE ES2.5
Service Output
92
Services LiveCycle ES2.5
Le service Output prend en charge les systèmes d'accès aux imprimantes suivants :
Imprimante accessible directement : une imprimante installée sur l'ordinateur utilisé est appelée imprimante accessible directement et
l'ordinateur est appelé hôte de l'imprimante. Il peut s'agir d'une imprimante locale directement reliée à l'ordinateur.
Imprimante accessible indirectement : les technologies de type CUPS (Common Unix® Printing System) et le protocole LPD (Line
Printer Daemon) sont disponibles. L'imprimante installée sur un serveur d'impression est accessible depuis d'autres ordinateurs. Pour
accéder à une imprimante accessible indirectement, vous devez indiquer l'adresse IP ou le nom d'hôte du serveur d'impression. Ainsi, vous
pouvez envoyer un document vers un URI LPD lorsqu'un protocole LDP s'exécute sur le réseau. Ce système vous permet d'acheminer le
document vers n'importe quelle imprimante connectée au réseau qui exécute un protocole LDP.
Lorsque vous utilisez cette méthode pour envoyer un document à une imprimante, indiquez l'un des protocoles d'impression suivants :
CUPS : protocole d'impression intitulé Common Unix Printing System. Ce protocole est utilisé par les systèmes d'exploitation UNIX et
permet à un ordinateur de fonctionner comme un serveur d'impression et d'accepter les requêtes d'impression provenant d'applications
clientes, de les traiter, puis de les envoyer aux imprimantes configurées. L'utilisation du protocole CUPS n'est pas recommandée pour le
système d'exploitation IBM AIX®.
DirectIP : protocole standard pour l'impression à distance et pour la gestion des tâches d'impression. Ce protocole peut être utilisé
localement ou à distance. Les files d'attente d'impression sont facultatives.
LPD : protocole d'impression intitulé Line Printer Daemon ou Line Printer Remote (LPR), qui fournit une fonctionnalité d'impression en
réseau pour les systèmes UNIX.
SharedPrinter : protocole d'impression qui permet à un ordinateur d'utiliser une imprimante configurée pour cet ordinateur. Ce protocole
ne fonctionne pas si le service Generate PDF est installé et si LiveCycle ES2.5 est installé sur le système d'exploitation Windows Server® 2008.
Ce problème ne porte que sur le système d'exploitation Windows Server® 2008. Dans ce cas, utilisez un protocole d'impression différent.
CIFS : le service Output prend en charge le protocole d'impression CIFS (Common Internet File System) (reportez-vous à la section
« Amélioration des performances du service Output », page 109).
Le tableau suivant répertorie les différentes valeurs d'entrée et les systèmes d'accès à l'impression, ainsi que les résultats escomptés.
Système d'accès
URI de serveur
d'impression
Nom de
l'imprimante
Résultat
SharedPrinter
Valeur nulle ou non
nulle
Valeur nulle
Exception : l'argument requis sPrinterName ne peut pas être nul.
SharedPrinter
Valeur nulle ou non
nulle
Invalid
Le service Output génère une exception indiquant que l'imprimante est introuvable.
SharedPrinter
Valeur nulle ou non
nulle
Valeur valide
Tâche d'impression réussie.
LPD
Valeur nulle
Valeur nulle ou
non nulle
sPrintServerUri ne peut pas être nul.
Le service Output génère une exception indiquant que l'argument requis
LPD
Invalid
Valeur nulle
Le service Output génère une exception indiquant que l'argument requis
sPrinterName ne peut pas être nul.
LPD
Invalid
Valeur non nulle
Le service Output génère une exception indiquant que sPrintServerUri est
introuvable.
LPD
Valeur valide
Invalid
Le service Output génère une exception indiquant que l'imprimante est introuvable.
LPD
Valeur valide
Valeur valide
Tâche d'impression réussie.
CUPS
Valeur nulle
Valeur nulle ou
non nulle
sPrintServerUri ne peut pas être nul.
Le service Output génère une exception indiquant que l'argument requis
ADOBE LIVECYCLE ES2.5
Service Output
93
Services LiveCycle ES2.5
Système d'accès
URI de serveur
d'impression
Nom de
l'imprimante
Résultat
CUPS
Invalid
Valeur nulle ou
non nulle
Le service Output génère une exception indiquant que l'imprimante est introuvable.
CUPS
Valeur valide
Valeur nulle ou
non nulle
Tâche d'impression réussie.
DirectIP
Valeur nulle
Valeur nulle ou
non nulle
Le service Output génère une exception indiquant que l'argument requis
sPrintServerUri ne peut pas être nul.
DirectIP
Invalid
Valeur nulle ou
non nulle
Le service Output génère une exception indiquant que l'imprimante est introuvable.
DirectIP
Valeur valide
Valeur nulle ou
non nulle
Tâche d'impression réussie.
CIFS
Valeur valide
Valeur nulle
Tâche d'impression réussie.
CIFS
Invalid
Valeur nulle ou
non nulle
Le service Output génère une erreur inconnue lors de l'impression à l'aide de CIFS.
CIFS
Valeur nulle
Valeur nulle ou
non nulle
Le service Output génère une exception indiquant que l'argument requis
sPrintServerUri ne peut pas être nul.
Remarque : pour lancer des impressions sur des imprimantes de réseau à distance Windows, il est préférable d'utiliser le protocole CIFS plutôt
qu'une imprimante partagée. Le protocole CIFS peut être utilisé avec des serveurs d'impression Windows distants (reportez-vous à la section
« Amélioration des performances du service Output », page 109).
Exécution d’un service sous Windows
Si vous installez LiveCycle ES2 en utilisant l'installation JBoss Clé en main sous Windows, le service JBoss s'exécute dans le contexte du
compte système local. Les services exécutés dans ce contexte n'ont pas accès aux ressources réseau telles que les imprimantes, car ils ne sont
pas authentifiés sur le réseau. Si vous utilisez Output IVS (Installation Verification Sample) pour envoyer un document vers une imprimante
réseau, le message d'erreur suivant s'affiche :
Printer \\server\queue not found
Pour résoudre ce problème, autorisez JBoss à s'exécuter dans le contexte d'un utilisateur valide. Pour ce faire, modifiez les propriétés du
service JBoss en cliquant sur l'onglet Ouvrir une session en tant que et en sélectionnant l'option Ce compte. Indiquez un nom d’utilisateur
et un mot de passe valides.
Remarque : cela vaut uniquement si le système d'accès SharedPrinter est utilisé.
Envoi du document à une imprimante réseau
Vous pouvez envoyer un document vers un URI LPD (Line Printer Daemon, démon d’imprimante en ligne) lorsque le réseau intègre un
démon LPD en cours d’exécution. Vous pouvez acheminer le document vers n'importe quelle imprimante connectée au réseau. Cette
imprimante peut se trouver sur un ordinateur différent.
Après le référencement des données de formulaires XML et la configuration des options d'exécution, vous pouvez appeler le service Output.
Le service Output envoie le document à une imprimante réseau. Il est recommandé d'utiliser le protocole CIFS lorsque cela est possible. Une
imprimante partagée peut être utilisée lorsqu'une imprimante est installée localement.
Un fichier PostScript créé à partir d'une conception de formulaire qui contient une taille de page personnalisée ne s'imprime pas
correctement. Pour résoudre ce problème, configurez l'imprimante de façon qu'elle gère les tailles personnalisées. Chaque imprimante gère
les tailles personnalisées de manière autonome. Certaines imprimantes peuvent vous permettre de configurer la taille des pages, le type de
support, les bacs d'alimentation, etc. Reportez-vous à la documentation de votre imprimante pour savoir comment la configurer afin qu'elle
gère les tailles personnalisées.
ADOBE LIVECYCLE ES2.5
Service Output
94
Services LiveCycle ES2.5
Lorsque vous envoyez un document vers une imprimante, prenez en considération les facteurs suivants :
•
Définissez PrinterProtocol sur SharedPrinter, ServerURI sur une valeur vierge et PrinterName sur une valeur qui indique le
chemin d'accès à l'imprimante (par exemple \\server12r-nt\HP LaserJet 8150 PCL 6 Tower II Level 5).
•
Vous pouvez récupérer la valeur de PrinterName au moyen du chemin correspondant à l'emplacement d'installation de l'imprimante.
Imaginons que l'imprimante se trouve sur le serveur server12r-nt. Pour obtenir le nom de l'imprimante, sélectionner Démarrer,
Imprimantes et télécopieurs, cliquez avec le bouton droit de la souris sur l'imprimante concernée, et sélectionnez Propriétés. La zone de
texte affiche le nom de l'imprimante sur l'onglet Général.
•
Une erreur peut se produire au cours d'une tâche d'impression avec un protocole SharedPrinter du fait d'un identifiant de connexion
incorrect (reportez-vous à la section « Exécution d’un service sous Windows », page 93).
Traitement de données par lots pour créer plusieurs documents
Le service Output peut créer des documents distincts pour chaque enregistrement dans une source de données XML. Output peut également
créer un fichier unique contenant tous les enregistrements (fonctionnalité par défaut). Imaginons qu'une source de données XML contienne
dix enregistrements et que vous demandiez au service Output de créer un document distinct pour chaque enregistrement (des documents
PDF, par exemple) : le service Output génère dix documents PDF.
L'illustration suivante montre le service Output, qui traite un fichier de données XML contenant plusieurs enregistrements. Cependant, si
vous demandez au service Output de créer un document PDF unique contenant tous les enregistrements de données, le service Output
génère un document contenant tous les enregistrements.
L'illustration suivante présente le traitement par le service Output d'un fichier de données XML contenant plusieurs enregistrements.
Imaginons que vous demandiez au service Output de créer un document PDF distinct pour chaque enregistrement de données. Dans ce cas,
le service Output crée un document PDF distinct pour chaque enregistrement de données.
Les données XML suivantes illustrent l'exemple d'un fichier de données contenant trois enregistrements de données.
ADOBE LIVECYCLE ES2.5
Service Output
Services LiveCycle ES2.5
<?xml version="1.0" encoding="UTF-8"?>
<batch>
<LoanRecord>
<mortgageAmount>500000</mortgageAmount>
<lastName>Blue</lastName>
<firstName>Tony</firstName>
<SSN>555666777</SSN>
<PositionTitle>Product Manager</PositionTitle>
<Address>555 No Where Dr</Address>
<City>New York</City>
<StateProv>New York</StateProv>
<ZipCode>51256</ZipCode>
<Email>[email protected]</Email>
<PhoneNum>555-7418</PhoneNum>
<FaxNum>555-9981</FaxNum>
<Description>Buy a home</Description>
</LoanRecord>
<LoanRecord>
<mortgageAmount>300000</mortgageAmount>
<lastName>White</lastName>
<firstName>Sam</firstName>
<SSN>555666222</SSN>
<PositionTitle>Program Manager</PositionTitle>
<Address>557 No Where Dr</Address>
<City>New York</City>
<StateProv>New York</StateProv>
<ZipCode>51256</ZipCode>
<Email>[email protected]</Email>
<PhoneNum>555-7445</PhoneNum>
<FaxNum>555-9986</FaxNum>
<Description>Buy a home</Description>
</LoanRecord>
<LoanRecord>
<mortgageAmount>700000</mortgageAmount>
<lastName>Green</lastName>
<firstName>Steve</firstName>
<SSN>55566688</SSN>
<PositionTitle>Project Manager</PositionTitle>
<Address>445 No Where Dr</Address>
<City>New York</City>
<StateProv>New York</StateProv>
<ZipCode>51256</ZipCode>
<Email>[email protected]</Email>
<PhoneNum>555-2211</PhoneNum>
<FaxNum>555-2221</FaxNum>
<Description>Buy a home</Description>
</LoanRecord>
</batch>
Remarque : notez que l'élément XML qui débute et termine chaque enregistrement de données est appelé LoanRecord.
95
ADOBE LIVECYCLE ES2.5
Service Output
96
Services LiveCycle ES2.5
Définition des options d'exécution PDF
Définissez les options d'exécution suivantes pour que le service Output traite correctement les données par lot et crée plusieurs fichiers à
partir d'une source de données XML :
Plusieurs fichiers: indique si le service Output crée un document unique ou plusieurs documents. Vous pouvez indiquer les valeurs True
ou False. Pour créer un document distinct pour chaque enregistrement de données dans la source de données XML, indiquez la valeur
True.
URI de fichier: spécifie l'emplacement des fichiers générés par le service Output. Vous pouvez indiquer par exemple
C:\\Adobe\\forms\\Loan.pdf. Dans ce cas, le service Output crée alors un fichier intitulé Loan.pdf et le place dans le dossier
C:\\Adobe\\forms. Lorsqu'il y a plusieurs fichiers, ces derniers se nomment Loan0001.pdf, Loan0002.pdf, Loan0003.pdf, etc. Les documents
sont placés sur le serveur hébergeant LiveCycle ES2.5 et non sur l'ordinateur client.
Nom de l'enregistrement : indique le nom de l'élément XML dans la source de données qui sépare les enregistrements de données. Ainsi,
dans l'exemple de source de données XML présenté, l'élément XML qui sépare les enregistrements de données s'appelle LoanRecord. Au
lieu de définir l'option d'exécution du nom de l'enregistrement, vous pouvez définir le niveau d'enregistrement en lui attribuant une valeur
numérique qui indique le niveau d'élément comportant les enregistrements de données. Toutefois, vous pouvez définir uniquement le nom
ou le niveau d'enregistrement et non les deux. Dans le fichier XML ci-dessus, le niveau de l'enregistrement requis pour créer plusieurs
documents est 2.
Chargement incrémentiel
Lorsque le service Output traite les enregistrements par lots, il lit les données comportant plusieurs enregistrements de manière
incrémentielle. Ainsi, le service Output lit les données dans la mémoire et libère les données tout au long du traitement du lot
d'enregistrements. Le service Output charge les données de manière incrémentielle lorsque l'une des deux options d'exécution est définie.
Si vous définissez l'option d'exécution du nom de l'enregistrement, le service Output lit les données de manière incrémentielle. De même,
si vous définissez l'option d'exécution du niveau de l'enregistrement sur 2 ou plus, le service Output lit les données de manière incrémentielle
(reportez-vous à la section « Traitement de données par lots pour créer plusieurs documents », page 94).
Vous pouvez décider si le service Output doit effectuer le chargement incrémentiel via l'option PDFOutputOptionsSpec ou l'option
setLazyLoading de l'objet PrintedOutputOptionSpec. Vous pouvez spécifier la valeur false, ce qui désactive le chargement
incrémentiel.
Si le service Output ne peut pas effectuer de chargement incrémentiel des données, il écrit le message d'avertissement suivant dans le fichier
journal du serveur d'applications J2EE hébergeant LiveCycle ES2.5 :
* 2007-11-01 11:51:23,215 WARN [com.adobe.document.XMLFormService]
$$$/com/adobe/document/xmlform/msg.XFA=Unable to perform an incremental data load. Performing a full data
load.
Remarque : si le service Output ne lit pas les données de manière incrémentielle, le fichier de données par lots tout entier est lu dans la mémoire.
Ce comportement peut nuire aux performances du service Output (reportez-vous à la section « Amélioration des performances du service
Output », page 109).
ADOBE LIVECYCLE ES2.5
Service Output
97
Services LiveCycle ES2.5
Création de règles de recherche
Vous pouvez créer des règles de correspondance au modèle, permettant ainsi au service Output d'examiner les données d'entrée et d'utiliser
des conceptions de formulaire différentes, basées sur le contenu des données. Par exemple, si le texte mortgage se trouve dans les données
d'entrée, le service Output peut utiliser une conception de formulaire appelée Mortgage.xdp. De même, si le texte automobile se trouve dans
les données d'entrée, le service Output peut utiliser une conception de formulaire enregistrée en tant que AutomobileLoan.xdp. Le schéma
suivant illustre la génération d'un fichier PDF par le service Output, via le traitement d'un fichier de données XML et l'une des conceptions
de formulaires existantes.
Le service Output peut générer des assemblages de documents, dans lesquels plusieurs enregistrements sont fournis dans l'ensemble de
données et chaque enregistrement correspond à une conception de formulaire. Le service Output génère un document unique, constitué de
plusieurs conceptions de formulaire.
Pour définir des règles de correspondance au modèle, vous devez définir un ou plusieurs modèles de texte que le service Output recherche
dans les données d'entrée. Pour chaque modèle de texte que vous définissez, spécifiez une conception de formulaire correspondante, qui
sera utilisée si le modèle de texte se trouve dans les données. Si un modèle de texte est trouvé, le service Output utilise la conception de
formulaire correspondante pour générer la sortie. mortgage est un exemple de modèle de texte.
ADOBE LIVECYCLE ES2.5
Service Output
98
Services LiveCycle ES2.5
Aplatissement de documents PDF interactifs
Vous pouvez utiliser le service Output pour transformer un document PDF interactif (par exemple, un formulaire) 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. Une
fois le document PDF aplati, un utilisateur ne peut pas modifier les données contenues dans les champs de ce document. S'assurer que les
données ne peuvent être modifiées est l'une des raisons de l'aplatissement d'un document PDF.
Vous pouvez aplatir les types de documents PDF suivants :
• Documents PDF interactifs créés avec LiveCycle Designer ES2.5 (qui contiennent des flux XFA).
• Formulaires PDF Acrobat.
Si vous tentez d'aplatir un document PDF non interactif, vous générerez une exception.
Assemblage de conceptions de formulaire personnalisées pour le service Output
Vous pouvez utiliser conjointement les services Output et Assembler pour créer un document hautement personnalisé. Le service Assembler
assemble un document XDP (une conception de formulaire), constitué de plusieurs formulaires XDP et de fragments contenus dans
plusieurs fichiers XDP. Le document XDP assemblé est transmis au service Output, qui crée ensuite un document PDF. Le schéma suivant
illustre ce flux de production.
Pour plus de détails sur la création d'une conception de formulaire à partir de fragments, reportez-vous aux Recommandations en matière
d’assemblage dynamique de formulaires et de documents personnalisés.
Utilisation d'Output IVS pour vérifier votre fichier de description d'imprimante (PDL)
Output IVS est une application exemple permettant de tester le service Output. Grâce à cette application, vous pouvez générer des
documents et tester des conceptions de formulaire et des ensembles de données. Vous pouvez également imprimer des documents à l'aide
d'imprimantes laser et d'imprimantes d'étiquettes.
Les administrateurs peuvent utiliser LiveCycle Configuration Manager pour déployer Output IVS. Ils peuvent également le déployer
manuellement Reportez-vous aux guides d'installation LiveCycle ES2, tels que Installation et déploiement de LiveCycle ES2 pour JBoss.
Pour ouvrir l'application Output IVS, accédez à http://[nom_serveur:numéro_port]/OutputIVS.
ADOBE LIVECYCLE ES2.5
Service Output
99
Services LiveCycle ES2.5
Pour changer les paramètres utilisés par Output IVS, cliquez sur le lien Préférences de la bannière d'Adobe LiveCycle Output ES2.5. Voici
quelques-uns des paramètres que vous pouvez définir depuis la fenêtre Préférences :
•
Emplacements à partir desquels Output IVS a obtenu les fichiers de formulaires, de données, XDC et d'accompagnement. Il peut s'agir
d'URL, d'un référentiel ou d'une référence absolue de dossier sur l'ordinateur hébergeant LiveCycle ES2.5. Les emplacements des
répertoires peuvent être définis par référentiel:/ ou référentiel:///.
• Format et options communs selon que le service Output IVS crée un flux de données de sortie unique ou inclut les métadonnées.
• Options d'impression, telles que les versions recto-verso et le nombre de copies.
• Informations d'identification de l'administrateur.
Pour définir les caractéristiques de votre travail et l'envoyer, cliquez sur le lien Tester Output sur la bannière d'Adobe LiveCycle Output
ES2.5. Voici quelques-uns des paramètres que vous pouvez définir depuis la fenêtre Tester Output :
•
•
Format de sortie, tel que PDF, PDFA-1/a et ZPL 300 DPI
Sélection de fichiers précisant les fichiers de formulaire, de données, XDC et d'accompagnement à utiliser lors du test. Utiliser le fichier
d'accompagnement pour les paramètres suivants :
• Règles de correspondance au modèle pour associer des éléments de données à différents modèles
• Paramètres de lots pour l'initialisation du mode de chargement différé
• Un grand nombre d'autres paramètres définis dans la fenêtre Préférences
• Informations sur l'emplacement de sortie telles que le fichier de serveur ou le nom de l'imprimante
• Requête émise et envoyée au service Output
Pour visualiser ou supprimer les fichiers utilisés par Output IVS, cliquez sur le lien Maintenance de la bannière d'Adobe LiveCycle Output
ES2.5. Vous pouvez supprimer uniquement les fichiers que vous avez ajoutés à Output IVS. Vous ne pouvez pas supprimer ceux qui ont été
installés avec Output IVS. La fenêtre Maintenance répertorie les fichiers de formulaires, de données, XDC et d'accompagnement dans les
emplacements définis dans la fenêtre Préférences. Vous pouvez également utiliser les boutons Parcourir pour charger les fichiers depuis
votre ordinateur.
Pour consulter l'aide complète relative à Output IVS, cliquez sur le lien Aide de la bannière d'Adobe LiveCycle Output ES2.5.
Remarques sur le service Output
Données de formulaire
Le service Output accepte en entrée à la fois une conception de formulaire généralement créée dans Designer ES2.5 et des données de
formulaire XML. Pour qu’un document soit rempli avec des données, les données de formulaire XML doivent inclure un élément XML pour
chacun des champs de formulaire à renseigner. Le nom de l’élément XML doit correspondre au nom du champ. Un élément XML est ignoré
s’il ne correspond pas à un champ du formulaire ou si son nom ne concorde pas avec le nom du champ. Il n'est pas nécessaire de respecter
l'ordre d'affichage des éléments XML. Il importe avant tout que les éléments XML soient spécifiés avec les valeurs correspondantes.
ADOBE LIVECYCLE ES2.5
Service Output
100
Services LiveCycle ES2.5
Examinez l’exemple de formulaire de demande de prêt ci-après.
Pour fusionner des données dans cette conception de formulaire, créez une source de données XML correspondant au formulaire. Le code
XML ci-après représente une source de données XML correspondant à l’exemple de formulaire d’application de prêts immobiliers.
<?xml version="1.0" encoding="UTF-8"?>
- <xfa:datasets xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/">
- <xfa:data>
- <data>
- <Layer>
<closeDate>1/26/2007</closeDate>
<lastName>Johnson</lastName>
<firstName>Jerry</firstName>
<mailingAddress>[email protected]</mailingAddress>
<city>New York</city>
<zipCode>00501</zipCode>
<state>NY</state>
<dateBirth>26/08/1973</dateBirth>
<middleInitials>D</middleInitials>
<socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
<phoneNumber>5555550000</phoneNumber>
</Layer>
- <Mortgage>
<mortgageAmount>295000.00</mortgageAmount>
<monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
<purchasePrice>300000</purchasePrice>
<downPayment>5000</downPayment>
<term>25</term>
<interestRate>5.00</interestRate>
ADOBE LIVECYCLE ES2.5
Service Output
101
Services LiveCycle ES2.5
</Mortgage>
</data>
</xfa:data>
</xfa:datasets>
Types de documents pris en charge
Pour bénéficier d'un accès complet aux fonctions de rendu du service Output, il est recommandé d'utiliser un fichier XDP en entrée. Dans
certains cas, il est possible d'utiliser un fichier PDF. Toutefois, l’utilisation d’un fichier PDF en entrée est soumise aux restrictions suivantes :
•
Un document PDF qui ne contient pas de flux XFA ne peut pas être rendu au format PostScript, PCL ou ZPL. Le service Output peut
rendre des documents PDF avec des flux XFA (c'est-à-dire des formulaires créés dans Designer ES2.5) aux formats d'impression laser et
d'étiquettes. Si le document PDF est signé, certifié ou qu'il contient des droits d'utilisation (appliqués à l'aide du service Reader
Extensions), il ne peut pas être rendu dans ces formats d'impression.
•
Les options d’exécution, telles que la version PDF et le PDF balisé, ne sont pas prises en charge pour les formulaires Acrobat. Elles sont
valides pour les formulaires PDF qui contiennent des flux XFA. Cependant, ces formulaires ne peuvent être ni signés, ni certifiés.
Champs de signature
Si une conception de formulaire contient un champ de signature et que vous définissez l'option d'exécution renderAtClient sur true,
aucun champ de signature non signé n'est conservé dans le document PDF obtenu. Cependant, si cette option d'exécution est définie sur
false, tout champ de signature non signé est conservé dans le document PDF obtenu.
Aplatissement d'un document PDF signé numériquement
Si vous essayez d'aplatir un document PDF XFA interactif qui contient un champ de signature signé et que vous définissez l'option
d'exécution renderAtClient sur true, le document PDF obtenu n'est pas aplati. Autrement dit, le document reste interactif et les
utilisateurs ont la possibilité de saisir et de modifier les données des champs de ce document. Ce comportement survient lorsque l'option
d'exécution renderAtClient doit être utilisée quand l'entrée d'une opération du service Output correspond à une conception de formulaire
(un fichier XDP), et non à un fichier PDF. Pour aplatir correctement un document PDF signé numériquement, définissez l'option de
configuration renderAtClient sur false.
Prise en charge de la messagerie électronique
Pour la fonctionnalité de messagerie électronique, vous pouvez créer un processus dans Workbench qui utilise le service Email. Un processus
représente un processus d’entreprise que vous automatisez (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
Optimisation du débit
LiveCycle Output ES2.5 peut traiter des fichiers de données XML volumineux contenant plusieurs enregistrements. Vous pouvez demander
au service Output de créer un fichier de sortie pour chaque enregistrement ou de créer un fichier de sortie unique qui contient tous les
enregistrements (reportez-vous à la section « Traitement de données par lots pour créer plusieurs documents », page 94).
Les limites de débit ne sont pas figées, mais varient en fonction de la complexité de la conception du formulaire, de la mémoire disponible,
des options choisies et des autres activités. Les erreurs générées lorsqu'une limite de ce type est atteinte peuvent signaler un manque de
mémoire comme étant le problème. Gardez cette limite à l'esprit et utilisez le service Output en conséquence lors de la génération de pages.
ADOBE LIVECYCLE ES2.5
Service Output
102
Services LiveCycle ES2.5
Pour un formulaire de complexité moyenne sur un serveur professionnel d’entrée de gamme, les recommandations de génération de page
constatées correspondent approximativement aux nombres suivants :
Format
Enregistrements par lots/
nombreux petits documents
Enregistrement volumineux/
un gros document
PDF (non balisé) et PDF/a-1b
10 000 pages
500 pages
PDF (balisé) et PDF/a-1a
2 500 pages
250 pages
PostScript
10 000 pages
500 pages
PCL (avec polices True Type ou polices résidentes de
l’imprimante)
10 000 pages
500 pages
Sélectionnez le balisage PDF uniquement s'il est indispensable. Les fichiers balisés sont sensiblement plus volumineux que les fichiers non
balisés, et leur rendu prend plus de temps. PDF/A-1a est toujours balisé et PDF/A-1b n'est pas balisé. Pour l'impression PCL, l'utilisation de
polices Microsoft OpenType® dans les conceptions de formulaires permet d'obtenir une mise en page irréprochable, mais réduit le débit,
génère un fichier de sortie plus gros et ne permet pas d'obtenir des performances optimales. Pour accroître les performances, utilisez ou
associez des polices TrueType dont vous avez la licence ou les polices résidentes de votre imprimante.
En cas de traitement de fichiers de données volumineux ou d'exploitation d'un serveur fortement sollicité, augmentez le délai d'expiration
du service Output, qui est fixé par défaut à 180 secondes. Pour modifier la valeur du délai, assurez-vous que les serveurs matériels disposent
de la quantité de mémoire appropriée et que celle-ci est disponible pour le tas du serveur d'applications Java. Pour plus de détails sur la
modification du délai d'expiration, reportez-vous à la section Aide à l’administration de LiveCycle ES2.5.
Lors du traitement d'un enregistrement/document volumineux, le débit est optimisé si les données XML sont structurées pour permettre
l'utilisation d'une option d'exécution recordLevel égale à 2. Par exemple, au lieu de structurer votre fichier de données comme suit :
<datafile>
<field>123</field>…
</datafile>
Structurez-le comme suit, en ajoutant un autre niveau :
<datafile>
<record>
<field>123</field>
…
</record>
</datafile>
ADOBE LIVECYCLE ES2.5
Service Output
103
Services LiveCycle ES2.5
Zones imprimables
La marge non imprimable par défaut de 0,25 pouce (0,6 cm) n’est pas adaptée aux imprimantes d’étiquettes et varie selon les imprimantes et
selon les tailles d’étiquette. Il est conseillé de conserver cette marge de 0,25 pouce ou de la réduire. En revanche, il est déconseillé de
l’augmenter. Si vous le faites, les informations de la zone imprimable ne s’impriment pas convenablement.
Veillez à toujours utiliser le fichier XDC correct pour l’imprimante. Par exemple, évitez de choisir un fichier XDC pour une imprimante
300 ppp, puis d'envoyer le document vers une imprimante 200 ppp.
Scripts
Une conception de formulaire utilisée avec le service Output peut contenir des scripts qui s’exécutent sur le serveur. Vérifiez qu’une
conception de formulaire ne contient pas de scripts s’exécutant sur le client. Pour plus de détails sur la création de scripts de conception de
formulaire, reportez-vous à l'Aide de LiveCycle Designer ES2.5.
Utilisation de polices
Les rubriques suivantes décrivent la gestion des polices par le service Output au sein d'un document généré :
•
•
•
Vérification de la disponibilité des polices pour LiveCycle ES2.5
Utilisation des polices résidentes de l'imprimante
Mappages des polices
Vérification de la disponibilité des polices pour LiveCycle ES2.5
Assurez-vous qu'une police utilisée dans un formulaire est bien disponible sur le serveur d'applications J2EE hébergeant LiveCycle ES2.5.
Prenons l'exemple suivant. Un concepteur de formulaire ajoute une police dans le répertoire de polices utilisé par le logiciel Designer ES2.5
et crée un formulaire utilisant cette police sur un autre ordinateur.
Placez cette police dans le répertoire des polices du client pour que le service Output puisse l'utiliser. Spécifiez l'emplacement du répertoire
des polices du client via LiveCycle Administration Console. Si ce répertoire n'existe pas, créez-en un sur le serveur d'applications J2EE
hébergeant LiveCycle ES2.5. Placez la police dans ce nouveau répertoire.
Spécification de l'emplacement du répertoire des polices du client
1
Dans LiveCycle Administration Console, cliquez sur Paramètres > Paramètres de Core System.
2
Dans la vue Core System, cliquez sur Configurations.
3
Spécifiez l'emplacement du répertoire des polices du client dans la zone de texte Emplacement du répertoire des polices personnalisées.
4
Cliquez sur OK.
5
Redémarrez le serveur d'applications J2EE sur lequel LiveCycle ES2.5 est installé.
Utilisation des polices résidentes de l'imprimante
Le service Output peut générer des documents contenant des polices résidentes. Les fichiers XDC qui sont disponibles avec le service Output
possèdent une liste commune de polices résidentes d'imprimantes. Vous n'avez pas besoin de modifier un fichier XDC pour utiliser ces
polices. Cependant, vous pouvez modifier un fichier XDC à l'aide de LiveCycle ES2.5 XDC Editor (reportez-vous à l'Aide de l'Editeur
XDCLiveCycle ES2.5).
Les polices résidentes de l'imprimante sont stockées au sein d'une imprimante, dans une cartouche matérielle spécifique, ou sont intégrées
à la mémoire de l'imprimante. Pour les imprimantes PostScript, seul le nom de la police est requis. Pour les imprimantes PLC, vous devez
définir une séquence de caractères d'échappement. Vous pouvez obtenir le nom des polices résidentes de l'imprimante depuis le panneau
avant de l'imprimante ou en utilisant le service Web intégré de l'imprimante (le cas échéant).
ADOBE LIVECYCLE ES2.5
Service Output
104
Services LiveCycle ES2.5
Pour pouvoir utiliser les polices résidentes d'imprimantes, procédez comme suit :
1
Identifiez le nom de la police résidente d'imprimante à utiliser.
2
Indiquez le nom de la police résidente d'imprimante dans la conception de formulaire.
3
Recherchez l'emplacement du fichier XDC le mieux adapté pour votre imprimante en fonction du type de sortie rendue (PostScript ou
PCL) et effectuez les changements appropriés dans le fichier XDC.
4
Testez la sortie.
Remarque : pour plus de détails sur ces opérations, reportez-vous à l'Aide de l'Editeur XDC LiveCycle ES2.5.
Mappage des polices
Si une police est installée sur un ordinateur client, elle est disponible dans la liste déroulante de Designer ES2.5. Si la police n'est pas installée,
il est nécessaire d'indiquer le nom de la police manuellement. L'option Remplacer définitivement les polices non disponibles de Designer
ES2.5 peut être désactivée. Sinon, lorsque le fichier XDP est enregistré dans Designer ES2.5, le nom de la police de substitution est écrit dans
le fichier XDP. Ceci signifie que la police résidente d'imprimante n'est pas utilisée.
Pour concevoir un formulaire utilisant les polices résidentes de l'imprimante, choisissez dans Designer ES2.5 un nom de type de caractère
qui correspond aux polices disponibles sur l'imprimante. Une liste des polices prises en charge pour PCL ou le PostScript se trouve dans les
profils de périphériques correspondants (fichiers XDC). Le mappage des polices peut aussi être destiné à mapper des polices non résidentes
de l'imprimante à des polices résidentes de l'imprimante et portant un nom de type de caractère différent. Par exemple, dans un scénario
PostScript, des références à Arial peuvent être associées au type de caractère Helvetica résident de l'imprimante.
Il existe deux types de polices OpenType : une police OpenType TrueType prise en charge par PCL et une police CFF OpenType. Les sorties
PDF et PostScript prennent en charge les polices incorporées Type-1, TrueType et OpenType. La sortie PCL prend en charge les polices
incorporées TrueType.
Les polices Type-1 et OpenType ne sont pas incorporées dans la sortie PCL. Le contenu formaté avec les polices Type-1 et OpenType est
pixellisé et généré sous la forme d'une image bitmap qui peut être volumineuse et lente à générer.
Les polices téléchargées ou incorporées sont automatiquement remplacées lors de la génération de sortie PostScript, PCL ou PDF. Cela
signifie que seul le sous-ensemble de glyphes de polices requises pour rendre correctement le document généré est compris dans la sortie
générée.
Pour plus de détails sur la création de conceptions de formulaires destinées au service Output, y compris la gestion des polices, reportezvous à la section Conception de formulaires pour LiveCycle Output ES2.
Prise en charge de l'impression CIFS
Le service Output prend en charge l'impression CIFS (Common Internet File System). Un administrateur d'imprimante doit rendre une
imprimante accessible au protocole CIFS. Sous Windows, cette étape s'effectue via le partage de l'imprimante ou via la commande net share.
Sur les systèmes de type UNIX, cette étape s'effectue en utilisant le serveur Samba.
Si l'imprimante est verrouillée, l'administrateur de l'imprimante peut fournir à l'administrateur LiveCycle ES2.5 le nom d'utilisateur et le
mot de passe nécessaires pour imprimer la file d'attente de l'imprimante. Pour accéder à l'imprimante en utilisant le nom d'utilisateur et le
mot de passe, l'administrateur LiveCycle ES2.5 doit enregistrer ces derniers en utilisant LiveCycle ES2.5 Trust Store. Le service Output
recherche le nom d'utilisateur et le mot de passe pour un chemin UNC donné en utilisant le chemin et ses composants parents comme nom
de profil.
ADOBE LIVECYCLE ES2.5
Service Output
105
Services LiveCycle ES2.5
Supposons que l'administrateur de LiveCycle ES2.5 inscrive \\print-server.domain.name.com\printercomme profil dans LiveCycle
ES2.5 Trust Store. Dans ce cas, le service Output recherche les informations d'identification d'une imprimante en examinant les alias dans
Trust Store dans l'ordre suivant :
\\print-server.domain.name.com\printer
\\print-server.domain.name.com
\\domain.name.com
\\name.com
\\com
\\
Le service Output envoie la tâche d'impression à la première entrée correspondante.
Remarque : LiveCycle ES2.5 prend en charge NTLM v2 dans l'impression CIFS. Kerberos5 n'est pas pris en charge.
Supposons qu'un utilisateur LiveCycle ES2.5 appelle l'opération sendToPrinter, indique le chemin de l'imprimante en tant que paramètre
du nom de serveur, puis laisse le paramètre du nom de l'imprimante vierge. Le nom d'utilisateur et le mot de passe requis sont résolus en
utilisant les profils LiveCycle ES2.5 Trust Store.
Avec le protocole CIFS, la file d'attente de l'imprimante est partagée en tant que ressource par un serveur. Pour imprimer un fichier, procédez
comme suit :
•
•
Le client s'authentifie sur le serveur pour la ressource indiquée (par exemple, la file d'attente de l'imprimante partagée sur le serveur).
Après authentification, les travaux d'impression sont envoyés à l'imprimante.
Utilisation des profils de périphérique (fichier XDC)
Un profil de périphérique (fichier XDC) est un fichier de description d'imprimante au format XML permettant au service Output de
produire des documents aux formats d'impression laser et aux formats d'impression d'étiquettes. Le service Output utilise des fichiers XDC,
parmi lesquels :
• hppcl5c.xdc
• hppcl5e.xdc
• ps_plain_level3.xdc
• ps_plain_mt.xdc
• ps_plain.xdc
• zpl203.xdc
• zpl300.xdc
• zpl600.xdc
Il n’est pas nécessaire de modifier ces fichiers pour que le service Output crée des documents. Toutefois, vous pouvez les modifier pour les
adapter à vos besoins (reportez-vous à l'Aide de l'Editeur XDC LiveCycle ES2.5).
Remarque : reportez-vous à l'Aide de l'Editeur XDC pour obtenir une liste complète des fichiers XDC.
Par ailleurs, les fichiers suivants sont des exemples de fichiers XDC prenant en charge les fonctions d'imprimantes spécifiques, comme les
polices résidentes, les bacs papier et les agrafeuses. L'objectif de ces exemples est de vous aider à comprendre comment configurer vos
propres imprimantes en utilisant des profils de périphérique. Ces exemples peuvent également être utilisés comme points de départ pour
des imprimantes semblables dans la même ligne de produits.
ADOBE LIVECYCLE ES2.5
Service Output
106
Services LiveCycle ES2.5
Sélection du bac de l'imprimante
Lors de l'envoi d'un document à une imprimante par le biais du service Output, vous pouvez indiquer le bac de l'imprimante utilisé. Designer
ES2.5 fait la distinction entre la taille du papier (page) et le bac d'alimentation de l'imprimante fournissant le papier requis. Cette fonction
peut s'adapter à des scénarios selon lesquels plusieurs tailles de papier peuvent être chargées dans les différents bacs d'alimentation de
l'imprimante. Un document peut donc sélectionner du papier à partir de bacs individuels, page par page.
Designer ES2.5 ne présente pas la taille du papier et la sélection du bac d'imprimante comme deux propriétés distinctes. Au lieu de cela, une
page type Designer ES2.5 peut être associée à un bac papier sélectionné à partir d'un ensemble de types de papier pris en charge et définis
dans le profil de périphérique Designer.xdc. Dans le profil de périphérique, chaque type de papier peut être configuré pour sélectionner à
partir d'un bac d'alimentation spécifique (reportez-vous à la section « Utilisation des profils de périphérique (fichier XDC) », page 105).
Designer ES2.5 fournit des exemplaires de types de papier doublons pour les formats Letter et Legal, afin de permettre la sélection du bloc
de papier. L'éditeur XDC de Workbench permet d'associer ou d'attribuer un bac d'alimentation physique à un type de papier. Les noms
fournis dans Designer ES2.5 couvrent la plupart des besoins de sélection du bac d'alimentation. Le profil de périphérique déployé peut être
modifié de sorte que le type de papier Letter Color amène l'imprimante à sélectionner le papier chargé dans un bac d'alimentation
secondaire.
Le service Output fait correspondre les types de papier utilisés dans le formulaire par nom et les types de papier définis dans le profil de
périphérique déployé sur le serveur. Par conséquent, seul le profil de périphérique déployé doit être modifié pour garantir la sélection du
bac d'alimentation approprié.
Bien que les types de papier fournis soient suffisants, il est possible d'en créer d'autres. Ces derniers peuvent être utilisés dans l'Editeur XDC
via la création d'un nom de type de papier. Ce type de papier doit cependant exister dans Designer ES2.5 pour pouvoir être utilisé. Pour
ajouter des types de papier, vous devez modifier manuellement le fichier Designer.xdc, en copiant une entrée existante de la bonne taille de
papier, puis en modifiant le nom comme souhaité.
Le concept des bacs d'imprimante ne s'applique pas aux PDF. Autrement dit, vous ne pouvez pas indiquer un bac d'imprimante spécifique
lorsque vous imprimez un document PDF. La sélection effectuée au niveau de l'imprimante repose sur la taille des pages : le premier bac non
sécurisé qui correspond à la taille de page requise est utilisé. Si aucune taille ne correspond, il faut passer à l'alimentation manuelle.
Pour les documents PCL, chaque page type dans le fichier XDP (le formulaire créé dans Designer ES2.5) est associée à un type de papier. Ce
type de papier est à son tour associé à une entrée du fichier XDC. Procédez avec soin, car le littéral qui s'affiche dans la liste de types de
papier peut être légèrement modifié par Designer ES2.5. Vérifiez la source XML pour obtenir le littéral exact du fichier XDC.
Dans le fichier XDC, le type de papier apparaît dans la colonne de stock. Vous pouvez modifier l'entrée afin d'afficher le numéro de bac
comportant le type de papier à utiliser. Toutefois, le numéro de bac indiqué sur l'imprimante (par exemple, bac 1, bac 2, etc.) peut différer
du numéro de périphérique compris par l'imprimante. Consultez le manuel de référence de l'imprimante afin de vous assurer que le numéro
de bac indiqué est correct.
Si le numéro de bac indiqué n'est pas valide ou présente une taille de page différente de la taille de page requise, l'imprimante revient au
premier bac non sécurisé qui représente la bonne taille de papier.
Pour les documents PostScript, le processus de sélection du bac de l'imprimante est le même que pour les documents PCL. Pour sélectionner
le bac par type de support, laissez la colonne Nombre de bacs d'alimentation vierge dans le fichier XDC, puis indiquez le type de support
dans la colonne Type de bac d'alimentation. Le système suppose que l'imprimante est configurée pour reconnaître le type de support.
Remarque : un fichier PostScript créé à partir d'une conception de formulaire contenant une page personnalisée risque de ne pas s'imprimer.
Dans ce cas, configurez l'imprimante de façon qu'elle gère les tailles personnalisées. Chaque imprimante gère les tailles personnalisées de manière
autonome. Certaines imprimantes peuvent vous permettre de configurer la taille des pages, le type de support, les bacs d'alimentation, etc.
Reportez-vous à la documentation de votre imprimante pour savoir comment la configurer afin qu'elle gère les tailles personnalisées.
ADOBE LIVECYCLE ES2.5
Service Output
107
Services LiveCycle ES2.5
Gestion du papier
Designer ES2.5 propose de contrôler l'impression recto-verso de deux manières différentes, selon que le formulaire est destiné à être généré
sous la forme d'un document PDF, puis imprimé depuis Adobe Reader ou Acrobat, ou imprimé directement sur un périphérique PCL ou
PostScript.
Lorsque le formulaire est destiné à la génération d'un document PDF, les paramètres d'impression du document PDF peuvent être configurés
à partir de la boîte de dialogue Propriétés de formulaire dans Designer ES2.5. Ces paramètres incluent le nombre de copies à imprimer et le
paramètre recto-verso. Les impressions suivantes de documents PDF depuis Adobe Reader ou Acrobat utilisent ces paramètres.
L'impression recto-verso peut également être indiquée par le biais de la propriété de pagination des opérations de service Output disponibles
dans Workbench, mais aussi depuis l'API Java et l'API du service Web du service Output. D'autres fonctionnalités sont disponibles dans
Designer ES2.5 pour la conception de formulaires correspondant aux scénarios d'impression recto ou recto-verso.
Les pages type peuvent être attribuées à des pages imprimées impaires (recto) ou paires (verso). Différentes pages type peuvent être conçues
pour les pages recto et verso. Le service Output sélectionne automatiquement la page type appropriée, selon que l'impression s'effectue au
recto ou au verso de la page. Souvent, des pages type sont créées pour placer le numéro de la page à gauche ou à droite de la page. Attribuez
un numéro pair ou impair aux pages type pour vérifier que le numéro de page se trouve toujours à l'intérieur ou à l'extérieur du document
recto-verso.
Utilisation du fichier de configuration XCI
Le service Output utilise un fichier de configuration XCI lors de l'exécution de tâches, par exemple pour l'incorporation d'une police dans
un document. Bien que ce fichier contienne des paramètres pouvant être définis, il est rare que cette valeur soit modifiée. Le fichier
default.xci se trouve dans le dossier svcdata\XMLFormService.
Par exemple, si LiveCycle ES2.5 est installé sur JBoss, le chemin complet est le suivant :
[emplacement de l'installation]\Adobe\LiveCycle ES2\jboss\server\lc_turnkey\svcdata\XMLFormService
Vous pouvez transmettre un fichier XCI modifié tout en exécutant une opération du service Output. Dans ce cas, créez une copie du fichier
par défaut, modifiez uniquement les valeurs requises en les adaptant à vos besoins et utilisez le fichier XCI modifié.
Le service Output commence par le fichier XCI par défaut (ou le fichier modifié). Il applique ensuite les valeurs spécifiées dans les feuilles
de propriétés de Workbench ou indiquées à l'aide de l'API Output Service. Ces valeurs remplacent les paramètres XCI. Par exemple, les
valeurs spécifiées dans une feuille de propriétés Workbench remplacent les valeurs XCI.
ADOBE LIVECYCLE ES2.5
Service Output
Services LiveCycle ES2.5
Les options XCI sont définies dans le tableau suivant.
Option XCI
Description
config/present/pdf/creator
Identifie le créateur du document à l'aide de l'entrée Créateur dans le dictionnaire d'informations du document.
Pour plus d'informations sur ce dictionnaire, reportez-vous au guide Référence PDF.
config/present/pdf/producer
Identifie le producteur du document à l'aide de l'entrée Producteur dans le dictionnaire d'informations du
document. Pour plus d'informations sur ce dictionnaire, reportez-vous au guide Référence PDF.
config/present/layout
Contrôle le type de sortie (panneau simple ou paginé).
config/present/pdf/compression/level
Indique le degré de compression à utiliser lors de la génération d'un document PDF.
config/present/pdf/fontInfo/embed
Contrôle l'incorporation des polices dans le document de sortie (reportez-vous à la section « Incorporation des
polices », page 109).
config/present/pdf/scriptModel
Contrôle si des informations spécifiques à XFA sont incluses dans le document PDF de sortie.
config/present/common/data/adjustData
Contrôle si l'application XFA ajuste les données après la fusion.
config/present/pdf/renderPolicy
Contrôle si la génération de contenu de page est effectuée sur le serveur ou reportée au client.
config/present/common/locale
Indique les paramètres régionaux utilisés dans le document de sortie.
config/present/destination
Dans un élément present, indique le format de sortie. Dans un élément openAction, indique l'action à
effectuer lors de l'ouverture d'un document dans un client interactif.
config/present/output/type
Indique le type de compression à appliquer à un fichier ou le type de sortie à fournir.
config/present/common/temp/uri
Spécifie l'URI du formulaire.
config/present/common/template/base
Fournit un emplacement de base pour les URI de la conception de formulaire. Lorsque cet élément est absent
ou vide, l'emplacement de la conception de formulaire est utilisé comme emplacement de base.
config/present/common/log/to
Contrôle l'emplacement d'écriture des données de journal ou de sortie.
config/present/output/to
Contrôle l'emplacement d'écriture des données de journal ou de sortie.
config/present/script/currentPage
Indique la page initiale à l'ouverture du document.
config/present/script/exclude
Indique à LiveCycle ES2.5 quels événements sont à ignorer.
config/present/pdf/linearized
Contrôle si le document PDF de sortie est linéarisé.
config/present/script/runScripts
Contrôle l'ensemble de scripts exécutés par LiveCycle ES2.5.
config/present/pdf/tagged
Contrôle les balises à inclure dans le document PDF de sortie. Dans un fichier PDF, les balises désignent des
informations supplémentaires incluses dans un document pour présenter sa structure logique. Les balises sont
utiles pour les aides à l'accessibilité et pour la mise en forme. Par exemple, un numéro de page peut être balisé
comme un artefact pour qu'un lecteur de texte ne l'énonce pas au milieu d'un texte. Bien que les balises
facilitent l'utilisation d'un document, elles augmentent par ailleurs la taille du document ainsi que son temps de
création.
config/present/pdf/fontInfo/alwaysEmbed
Indique une police incorporée dans le document de sortie.
config/present/pdf/fontInfo/neverEmbed
Indique une police qui ne doit jamais être incorporée dans le document de sortie.
config/present/pdf/pdfa/part
Indique le numéro de version de la spécification PDF/A à laquelle le document se conforme.
config/present/pdf/pdfa/amd
Indique le niveau de modification de la spécification PDF/A.
config/present/pdf/pdfa/conformance
Indique le niveau de conformité avec la spécification PDF/A.
config/present/pdf/version
Indique la version de document PDF à générer.
108
ADOBE LIVECYCLE ES2.5
Service Output
109
Services LiveCycle ES2.5
Incorporation des polices
Pour expliquer comment manipuler un fichier XCI, un fichier de ce type est utilisé pour incorporer une police dans un document PDF
généré par le service Output. L'incorporation d'une police est uniquement adaptée à la sortie PDF. Pour les sorties PCL et PostScript, la
police est automatiquement incorporée si elle n'est pas résidente de l'imprimante. Ce paramètre vise à réduire la taille du fichier PDF en
désactivant le paramètre d'incorporation global, mais aussi à fournir un moyen d'incorporer des polices particulières dans un document.
Pour incorporer une police dans le document cible, procédez comme suit :
1
Placez la police dans le dossier windows\fonts de l'ordinateur sur lequel LiveCycle ES2.5 est déployé.
2
Copiez le fichier XCI situé dans le répertoire indiqué dans cette section, collez-le dans un nouvel emplacement et renommez-le
custom.xci. Par exemple, utilisez l'emplacement C:\XCI\custom.xci.
3
Modifiez le fichier custom.xci en créant un élément XML appelé fontInfo (placez-le sous l'élément pdf ). Dans l'élément fontInfo,
ajoutez les données XML suivantes :
<alwaysEmbed>[nom de la police]</alwaysembed>
4
Modifiez l'option XCI URI dans Workbench ou en utilisant l'API Output Service.
Amélioration des performances du service Output
La liste suivante indique les facteurs de performance à prendre en compte lorsque vous travaillez avec le service Output :
•
Lors de l'invocation du service Output à l'intérieur d'un processus, vous pouvez améliorer les performances à l'aide d'un processus de
courte durée. Un processus de longue durée conserve des données dans la base de données LiveCycle ES2.5, ce qui cause une perte de
performance.
•
A partir de LiveCycle 8.2, vous pouvez désactiver la sécurité du service Output. Si vous désactivez la sécurité, le service Output
n'authentifie pas un utilisateur lorsqu'il effectue une opération, ce qui améliore la performance de l'opération.
•
Le fait de modifier l'option de cache du référentiel LiveCycle ES2.5 pour passer en mode manuel optimise les performances, alors que
le paramètre par défaut engendre des performances médiocres, car le service Output suppose qu'un formulaire (ou des fragments de
formulaire) a changé depuis sa dernière utilisation.
•
•
Les formulaires contenant des champs justifiés diminuent les performances : la justification nuit aux performances.
L'utilisation de liaison de données non explicite dans les conceptions de formulaire pour le traitement par lots entraîne une baisse des
performances (reportez-vous à la section « Traitement de données par lots pour créer plusieurs documents », page 94).
•
Lorsque vous effectuez un traitement par lots, dans la mesure du possible, utilisez un chargement incrémentiel (reportez-vous à la
section « Chargement incrémentiel », page 96).
•
Lors de la conception d'un formulaire, utilisez les polices qui prennent en charge un langage particulier pour améliorer les performances.
Remarque : pour plus de détails sur le traitement de fichiers de données XML volumineux contenant un grand nombre d'enregistrements,
reportez-vous à la section « Optimisation du débit », page 101.
110
26. Service PDF Utilities
Le service PDF Utilities permet de convertir des documents entre les formats de fichier PDF et XDP, de définir et de récupérer le mode
d'enregistrement de documents PDF et de rechercher des informations sur un document PDF. Il est possible, par exemple, de vérifier si un
document PDF contient des commentaires ou des pièces jointes.
Utilisation du service PDF Utilities
Vous pouvez exécuter les tâches ci-dessous à l’aide de ce service :
Clonage de PDF : cette fonction n'est disponible que dans LiveCycle Workbench. Elle permet de répliquer un document PDF. Il est possible
de manipuler le document PDF obtenu indépendamment du document PDF d'entrée. Si un document PDF est transmis à plusieurs services
sans clonage préalable, il sera difficile d'utiliser le fichier obtenu efficacement.
Imaginons par exemple qu'un document PDF est transmis à deux services consécutivement. Lorsque le premier service modifie et renvoie
le document PDF sous forme de valeur de document, le service qui utilise ensuite cette valeur de document détecte les modifications
effectuées par le premier service.
Après l'opération de clonage de PDF, la valeur de document d'entrée et la valeur de document obtenue sont identiques, mais distinctes. Qui
plus est, les modifications apportées ensuite à l'une ou l'autre des valeurs n'affectent pas l'autre objet.
Clonage multiple de PDF : cette fonction n'est disponible que dans Workbench. Elle permet de cloner un document PDF un nombre de
fois défini. Il est possible de manipuler les documents PDF obtenus indépendamment du document PDF d'entrée.
Conversion de documents PDF en documents XDP : permet de convertir un document PDF en fichier XDP. Pour réussir la conversion
d'un document PDF en fichier XDP, le document PDF doit contenir un flux XFA dans le dictionnaire.
Conversion de documents XDP en documents PDF : permet de convertir un fichier XDP en fichier PDF. Pour réussir la conversion d'un
fichier XDP en fichier PDF, le fichier XDP doit contenir un paquet PDF codé.
Récupération des propriétés de documents PDF : exécute des requêtes dans le document PDF sélectionné et renvoie les résultats sous
forme de valeur PDFPropertiesResult. Vous pouvez exécuter les requêtes suivantes :
•
•
•
•
•
•
•
•
•
•
•
Est un document PDF
Est un paquet PDF
Obtenir la version PDF
Vérifier les pièces jointes
Vérifier les commentaires
Version Acrobat recommandée
Type de formulaire
Vérifier AcroForm
Contient un formulaire à remplir
Est un document XFA
Obtenir la version XFA
ADOBE LIVECYCLE ES2.5
Service PDF Utilities
111
Services LiveCycle ES2.5
Récupération du mode d'enregistrement d'un PDF : permet de récupérer le mode d'enregistrement d'un document PDF. Le mode
d'enregistrement correspond au mode dans lequel le document PDF est enregistré. Il détermine si la requête est considérée comme
obligatoire ou comme une simple suggestion. Le contenu du document PDF n'a aucune incidence sur les valeurs de mode d'enregistrement.
Ci-dessous figurent quelques valeurs possibles de mode d'enregistrement PDF :
•
•
•
FAST_WEB_VIEW, utilisée pour l'affichage du document PDF en ligne.
INCREMENTAL, qui exécute l'enregistrement en un temps minimum.
FULL, qui enregistre le document en effectuant moins d'optimisations.
Définition du mode d'enregistrement d'un PDF : permet de définir le mode d'enregistrement d'un document PDF. Le mode
d'enregistrement correspond au mode dans lequel le document PDF est enregistré. Il détermine si la requête est considérée comme
obligatoire ou comme une simple suggestion. Le contenu du document PDF n'a aucune incidence sur les valeurs de mode d'enregistrement.
Ci-dessous figurent quelques valeurs possibles de mode d'enregistrement PDF :
• FAST_WEB_VIEW, utilisée pour l'affichage du document PDF en ligne.
• INCREMENTAL, qui exécute l'enregistrement en un temps minimum.
• FULL, qui enregistre le document en effectuant moins d'optimisations.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. Pour plus de
détails sur le développement des applications clientes qui interagissent par programmation avec ce service, reportez-vous à la section
Programmation avec LiveCycle ES2.5.
112
27. Service Reader Extensions
Le service Reader Extensions permet à votre entreprise de partager facilement des documents PDF interactifs en étendant la fonctionnalité
d'Adobe Reader avec des droits d'utilisation supplémentaires. Le service Reader Extensions fonctionne avec Adobe Reader 7.0 et versions
ultérieures. Ce service ajoute des droits d’utilisation dans un document PDF. Cela active des fonctionnalités généralement indisponibles à
l’ouverture d’un document PDF dans Adobe Reader, comme l'ajout de commentaires dans un document, le remplissage de formulaires et
l'enregistrement du document. Les utilisateurs tiers n’ont pas besoin de disposer d’un logiciel supplémentaire ni de modules externes pour
utiliser les documents définis avec des droits d'utilisation.
Lorsque les droits d'utilisation appropriés sont ajoutés aux documents PDF, les destinataires peuvent effectuer les activités suivantes depuis
Adobe Reader :
•
Remplissage de documents et de formulaires PDF en ligne ou hors connexion, offrant ainsi aux destinataires la possibilité d’enregistrer
des copies de ces documents en local dans leurs archives tout en préservant les informations ajoutées
•
Enregistrement de documents PDF sur un disque dur local pour conserver le document d’origine ainsi que tous les commentaires,
données ou pièces jointes associés
•
•
Association de fichiers et de clips multimédia aux documents PDF
•
•
Envoi électronique de documents PDF complétés ou annotés
•
Partage de documents PDF pour que les réviseurs puissent ajouter des commentaires à l'aide d'outils intuitifs d'insertion de
commentaires et d'annotations, tels que notes autocollantes, tampons, texte surligné et texte barré. Ces fonctions sont également
disponibles dans Acrobat.
Signature, certification et authentification de documents PDF par l’application de signatures numériques à l’aide de technologies PKI
(Public Key Infrastructure, infrastructure à clé publique) standard
Utilisation de documents et de formulaires PDF comme interface de développement intuitive pour les bases de données internes et les
services Web
• Prise en charge du décodage de formulaires à codes-barres.
Ces fonctions d’utilisateur spéciales sont automatiquement activées lorsqu’un utilisateur ouvre un document PDF défini avec les droits
d’utilisation appropriés dans Adobe Reader. Dès que l’utilisateur a fini de travailler sur un document défini avec ces droits d’utilisation, ces
fonctions sont de nouveau désactivées dans Adobe Reader, jusqu’à ce que l’utilisateur reçoive un autre document PDF doté des mêmes
droits.
Les rubriques suivantes vous informent sur les tâches que vous pouvez exécuter et sur la marche à suivre pour obtenir de meilleurs résultats :
•
•
« Utilisation du service Reader Extensions », page 113
« Remarques sur le service Reader Extensions », page 114
ADOBE LIVECYCLE ES2.5
Service Reader Extensions
113
Services LiveCycle ES2.5
Utilisation du service Reader Extensions
Application de droits d’utilisation aux documents PDF
Le service Reader Extensions permet d'appliquer des droits d'utilisation aux documents PDF. Les droits d'utilisation correspondent à une
fonctionnalité disponible dans Acrobat Professional et Acrobat Standard, mais non dans Adobe Reader. Une telle fonctionnalité inclut la
possibilité d'ajouter des commentaires à un document, de remplir des formulaires et d'enregistrer ce document. Les documents PDF dotés
de droits d'utilisation sont appelés des documents dont les droits sont activés. Un utilisateur qui ouvre un document PDF dont les droits sont
activés dans Adobe Reader peut effectuer les opérations qui sont autorisées pour ce document.
Le tableau ci-après répertorie les droits d’utilisation et indique les opérations que les utilisateurs peuvent effectuer dans Adobe Reader
lorsque chacun de ces droits est activé :
Remplissage d'un formulaire de base : permet aux utilisateurs de remplir les champs de formulaire et d'enregistrer les fichiers localement.
Remarque : un message destiné aux utilisateurs de Adobe Reader 7 s'affiche, les invitant à remplir le formulaire. Ce message ne s'affiche pas
dans Adobe Reader 8.
Importation et exportation des données de formulaire : permet aux utilisateurs d'importer et d'exporter des données de formulaire aux
formats FDF, XFDF, XML et XDP. Si vous sélectionnez cette fonction, la fonction Remplissage d'un formulaire de base l'est également
automatiquement. Si vous sélectionnez ce droit d'utilisation, vous devez également activer le droit d'utilisation Connectivité base de données
et services Web ou le droit d'utilisation Pièces jointes incorporées (en fonction des droits d'utilisation requis).
Envoi en dehors du navigateur Web : permet aux utilisateurs d'envoyer des données de formulaire par messagerie électronique ou hors
connexion. Si vous sélectionnez cette fonction, la fonction Remplissage d'un formulaire de base l'est également automatiquement.
Connectivité base de données et services Web : permet aux utilisateurs d'accéder à la base de données ou d'appeler le service Web défini
dans le formulaire. Si vous sélectionnez cette fonction, la fonction Remplissage d'un formulaire de base l'est également automatiquement.
Ajout, suppression et modification de champs de formulaire : permet aux utilisateurs d'ajouter, de supprimer ou de modifier les champs
du formulaire. Si vous sélectionnez cette fonction, la fonction Remplissage d'un formulaire de base l'est également automatiquement.
Création de pages à partir de modèles : permet aux utilisateurs de créer des pages à partir du modèle de formulaire, destinées aux
formulaires créés dans Acrobat. Les utilisateurs créent des pages à partir des pages de modèle du même formulaire. (Ce droit d'utilisation
est disponible dans les documents XFA, mais lorsqu'il est sélectionné, il ne s'applique pas au document enregistré final.) Si vous sélectionnez
cette fonction, la fonction Remplissage d'un formulaire de base l'est également automatiquement.
Décodage de codes-barres 2D : permet aux utilisateurs d'utiliser des codes-barres 2D avec des solutions de décodage tierces. Si vous
sélectionnez cette fonction, la fonction Remplissage d'un formulaire de base l'est également automatiquement.
Signatures numériques : permet aux utilisateurs de signer numériquement et d'enregistrer le document PDF. Si cette option n'est pas
sélectionnée, les utilisateurs peuvent toujours valider, afficher et imprimer le document doté d'une signature numérique.
Commentaires : permet aux utilisateurs de créer, de modifier, d'importer et d'exporter des commentaires. Les commentaires sont stockés
et transmis avec tout le fichier. Si cette option n'est pas sélectionnée, les utilisateurs peuvent uniquement passer en revue les commentaires
du document PDF.
Commentaires en ligne : permet aux utilisateurs de télécharger des commentaires de documents depuis un serveur. Si vous sélectionnez
cette fonction, le droit d'utilisation Commentaires l'est aussi automatiquement.
Pièces jointes incorporées : permet aux utilisateurs d'ajouter, de modifier ou d'exporter des pièces jointes et des fichiers dans un paquet
PDF (anciennement appelé portfolio PDF).
ADOBE LIVECYCLE ES2.5
Service Reader Extensions
114
Services LiveCycle ES2.5
Méthodes d'application des droits d'utilisation
•
•
•
Utilisation de l'application Web LiveCycle Reader Extensions ES2.5 (reportez-vous à l'Aide de LiveCycle Reader Extensions ES2.5.)
Utilisation des processus que vous développez à l'aide de LiveCycle Workbench (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
Utilisation de l'API Reader Extensions Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
Suppression de droits d’utilisation des documents PDF
Le service Reader Extensions permet de supprimer les droits d'utilisation des documents PDF dont les droits sont activés. La suppression
des droits d'utilisation d'un document PDF est également requise pour l'exécution d'autres opérations LiveCycle ES2.5 sur ce document.
Vous devez par exemple signer numériquement (ou certifier) un document PDF avant de définir ses droits d'utilisation. Pour effectuer des
opérations sur un document défini avec des droits d'utilisation, vous devez donc exécuter les opérations suivantes :
•
•
•
Suppression des droits d’utilisation du document PDF.
Exécution des autres opérations, comme la signature numérique du document.
Réapplication des droits d’utilisation au document.
Méthodes de suppression des droits d'utilisation
•
•
Utilisation des processus que vous développez à l'aide de Workbench (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
Utilisation de l'API Reader Extensions Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
Récupération des informations d'identification
Vous pouvez utiliser le service Reader Extensions afin de récupérer les informations d'identification utilisées pour appliquer des droits à un
document PDF défini avec des droits d'utilisation. En récupérant ces informations d'identification, vous pouvez par exemple connaître la
date d'expiration du certificat.
Méthodes d'obtention des droits d'informations d'identification
•
•
Utilisation de l'API Reader Extensions Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
Utilisation des processus que vous développez à l'aide de Workbench (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
Remarques sur le service Reader Extensions
Voici les facteurs à prendre en compte lors du développement d’une application utilisant le service Reader Extensions :
Configuration des informations d’identification
Pour appliquer des droits d’utilisation aux documents PDF, vous devez disposer d’informations d’identification valides. Ces informations
d’identification ont éventuellement été configurées pendant l’installation de LiveCycle ES2.5. Pour plus de détails sur la configuration des
informations d’identification, reportez-vous à la section Configuration des informations d'identification à utiliser avec Reader Extensions
ES2.5 de l'Aide à l'administration LiveCycle ES2.5, ou consultez votre administrateur de serveur d’applications.
ADOBE LIVECYCLE ES2.5
Service Reader Extensions
115
Services LiveCycle ES2.5
Ordre des opérations
Toute combinaison de chiffrement, certification et application des droits d'utilisation sur un même document doit se dérouler dans l'ordre
suivant. Ces services doivent être appelés au court d'un processus de courte durée :
1
Appliquez un chiffrement (service Encryption) ou une stratégie (service Rights Management) à un document avant de le signer
numériquement (service Signature). Une signature numérique enregistre l’état du fichier au moment de la signature. Si vous chiffrez le
document ou appliquez une stratégie après avoir appliqué une signature sur ce dernier, les octets du fichier sont modifiés, la signature
apparaissant alors comme étant incorrecte.
2
Certifiez un document PDF (service Signature) avant de définir ses droits d’utilisation (service Reader Extensions). Si vous certifiez un
document après avoir appliqué ses droits d’utilisation, la signature des droits d’utilisation est invalidée, ce qui provoque la suppression
des droits d’utilisation du document.
3
Signez numériquement un document PDF (service Signature) après avoir défini les droits d’utilisation. La signature d’un document PDF
après l’application des droits d’utilisation n’invalide pas la signature des droits d’utilisation.
Par ailleurs, vous ne pouvez pas chiffrer un document PDF et lui appliquer une stratégie. Vous ne pouvez pas non plus appliquer une
stratégie à un document PDF chiffré.
Ajout de droits d’utilisation aux formulaires interactifs
Il est parfois nécessaire de doter un document PDF de droits d’utilisation lors de l’utilisation de formulaires interactifs créés dans
LiveCycle Designer ES2.5. Par exemple, supposons que vous avez créé un formulaire interactif avec Designer ES2.5 et que vous souhaitiez
utiliser un script de formulaire pour faire référence au point de fin SOAP d’une connexion de données au niveau duquel les données de
formulaire sont récupérées. Imaginons ensuite que vous souhaitiez afficher le formulaire dans Adobe Reader 8.0.
En l’absence de droits d’utilisation, Adobe Reader ne parvient pas à définir le point de fin SOAP de connexion de données, entraînant ainsi
l’utilisation du point de fin prédéfini (spécifié dans Designer ES2.5). Pour définir le point de fin SOAP de connexion de données à l’aide d’un
script de formulaire, vous devez ajouter le droit d’utilisation enableFormsOnline au formulaire interactif.
Ajout de droits d'utilisation à des formulaires afin d'en remplir les champs
Lorsque vous concevez un formulaire à utiliser avec Adobe Reader 7.0 et que ce formulaire utilise des services Web ou des bases de données
pour remplir les champs avec des données, appliquez des droits d'utilisation supplémentaires à votre formulaire.
Lorsque vous concevez des formulaires à utiliser avec Adobe Reader 8.0, appliquez les droits d'utilisation suivants :
• Remplissage d'un formulaire de base
• Connectivité base de données et services Web
• Ajout, suppression et modification de champs de formulaire
Lorsque vous concevez des formulaires à utiliser avec Adobe Reader 7.0, appliquez les droits d'utilisation suivants :
• Remplissage d'un formulaire de base
• Importation et exportation des données de formulaire
• Connectivité base de données et services Web
• Ajout, suppression et modification de champs de formulaire
Sans le droit d'utilisation Importation et exportation des données de formulaire, les appels passés aux services Web ou à une base de données
ne fonctionnent pas dans Adobe Reader 7.0.
ADOBE LIVECYCLE ES2.5
Service Reader Extensions
116
Services LiveCycle ES2.5
Ouverture de documents PDF dotés de droits d’utilisation
Les utilisateurs qui tentent d’ouvrir un document PDF défini avec des droits d’utilisation dans des versions d’Adobe Reader antérieures à la
version 7.0 peuvent ne pas avoir accès à certaines fonctions. Ces versions d’Adobe Reader affichent un message invitant les utilisateurs à
mettre à niveau leur application vers la toute dernière version. Par exemple, si un utilisateur applique des droits d’utilisation à un document
PDF compatible Acrobat 5.0, ce document PDF n’est plus compatible avec cette version d’Acrobat (ou d’Adobe Reader). Le document PDF
n’est plus compatible qu’avec Adobe Reader 7.0 et ses versions ultérieures.
117
28. Service Repository
Le service Repository fournit des fonctionnalités de stockage. Lorsque des développeurs créent des applications, ils peuvent déployer les
éléments dans le référentiel plutôt que dans un système de fichiers. Ce référentiel peut contenir les éléments suivants :
• Formulaires XML
• Formulaires PDF (y compris les formulaires Acrobat)
• Fragments de formulaires
• Images
• Processus
• Profils
• Stratégies
• Fichiers SWF
• Fichiers DDX
• Schémas XML
• Fichiers WSDL
• Données de test
Le référentiel assure le suivi de la version de chaque élément d’une application LiveCycle ES2.5. Lors de l’exécution, les services peuvent
récupérer les éléments à partir du référentiel dans le cadre de la réalisation d’un processus d’entreprise automatisé.
Utilisation du service Repository
Vous pouvez utiliser le service Repository dans un processus pour récupérer les ressources du référentiel. L'API Repository Service fournit
plusieurs autres opérations qui vous permettent de stocker et de récupérer des informations du référentiel. Par exemple, vous pouvez obtenir
une liste de fichiers ou récupérer des fichiers spécifiques stockés dans le référentiel lorsqu’un fichier est nécessaire dans le cadre du
traitement d’une application. Vous pouvez également déployer par programmation des fichiers d’application à l’aide de l'API Repository
Service.
Pour plus de détails sur le développement d'un processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. 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 ES2.5.
Vous pouvez utiliser 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 de LiveCycle ES2.5).
118
29. Service Rights Management
Le service Rights Management vous permet de créer des stratégies et de les appliquer à des documents. Une stratégie est un groupe
d'informations comprenant des paramètres de confidentialité et une liste d'utilisateurs autorisés. Vous pouvez spécifier les personnes
autorisées à ouvrir un document, limiter leur champ d’action sur ce document et contrôler ce dernier après sa diffusion. Vous pouvez
également contrôler, voire révoquer dynamiquement l’accès à un document.
Le service Rights Management protège les fichiers PDF, ainsi que d'autres types de fichiers, tels que :
• FLV et F4V
• Microsoft Word, Excel et PowerPoint
• PTC (Parametric Technology Corporation) Pro/ENGINEER Wildfire 4.0
Les stratégies peuvent être appliquées aux documents PDF par programmation, via l'API Rights Management Service, ou dans le cadre d'un
processus. Les stratégies peuvent également être appliquées aux documents à l'aide d'une application cliente. Les modalités d'application des
stratégies aux documents PDF sont décrites en détail dans l'Aide d'Acrobat. L'application de stratégies à l'aide d'autres applications, telles que
Microsoft Office, est décrite dans l'Aide de l'extension LiveCycle Rights Management ES2.5 relative à l'application. Vous pouvez télécharger
l'extension LiveCycle Rights Management ES2.5 Extension pour Microsoft Office sur le site Web d'Adobe.
Remarque : Rights Management ES2.5 requiert une authentification via des connexions SSL (reportez-vous à la section Configuration de SSL
dans l'Aide à l'administration de LiveCycle ES2.5).
Les administrateurs utilisent les pages Web Rights Management ES2.5 pour effectuer les actions suivantes (consultez l'Aide à
l'administration de LiveCycle ES2.5) :
• Configurer divers paramètres du service Rights Management
• Gérer les documents protégés par une stratégie
• Créer et gérer des jeux de stratégies ainsi que les stratégies qu'ils contiennent
• Contrôler les événements enregistrés par Rights Management ES2.5
• Gérer les utilisateurs invités et locaux
LiveCycle Workbench vous permet de développer des processus exécutant les actions suivantes (reportez-vous à l'Aide de LiveCycle
Workbench 9.5) :
• Créer des stratégies à partir de modèles ou mettre à jour les stratégies existantes
• Appliquer des stratégies à des documents, changer de stratégie ou mettre fin à la protection des stratégies
• Obtenir des identifiants de licence, révoquer des licences ou annuler leur révocation
• Obtenir tous les noms des jeux de stratégies ou tous les noms des stratégies d'un jeu
• Obtenir une stratégie à l'aide d'un identifiant de stratégie
• Contrôler un document protégé
• Déverrouiller des documents PDF protégés par une stratégie
Grâce à l'API Rights Management Service, les utilisateurs peuvent développer des applications clientes exécutant les actions suivantes
(reportez-vous à la section Programmation avec LiveCycle ES2.5) :
•
•
•
•
•
Créer, modifier ou supprimer des stratégies
Appliquer des stratégies à des documents PDF ou bien les supprimer
Révoquer ou rétablir l'accès à des documents PDF
Créer des filigranes
Rechercher des événements
ADOBE LIVECYCLE ES2.5
Service Rights Management
•
•
119
Services LiveCycle ES2.5
Ouvrir des documents protégés par une stratégie par lots
Récupérer des informations sur les documents protégés par une stratégie
A propos des stratégies
Une stratégie contient des informations sur les utilisateurs autorisés et les paramètres de confidentialité à appliquer aux documents.
N'importe quel utilisateur de votre entreprise peut être concerné. Il peut également s'agir d'une personne extérieure qui s'est enregistrée
auprès de Rights Management ES2.5 ou d'une personne pour laquelle l'administrateur a créé un compte. Si l'administrateur active la fonction
d'invitation d'utilisateur, il est possible d'ajouter de nouveaux utilisateurs invités aux stratégies. Lorsque vous ajoutez un nouvel utilisateur
invité, le service Rights Management envoie un courrier électronique invitant l'utilisateur à s'enregistrer.
Les options de confidentialité que vous spécifiez dans une stratégie déterminent dans quelle mesure les destinataires peuvent utiliser le
document. Par exemple, vous pouvez spécifier si les destinataires sont autorisés à imprimer ou copier du texte, effectuer des modifications
ou ajouter des signatures et des commentaires dans des documents protégés. Une même stratégie peut également spécifier différentes
options de confidentialité pour différents utilisateurs.
Vous pouvez créer et enregistrer un nombre illimité de stratégies en utilisant des options de protection adaptées à différents utilisateurs et
situations.
L'application Rights Management ES2.5 vous permet de modifier dynamiquement les autorisations d'un document. Elle permet à la
personne qui sécurise le document de modifier les paramètres de confidentialité, de révoquer l'accès au document ou de changer de
stratégie. Après la diffusion du document, celui qui l'a sécurisé peut contrôler la manière dont ce document est utilisé et par qui.
Les stratégies sont décrites à l'aide du langage PDRL (Portable Document Rights Language)
A propos des jeux de stratégies
Les jeux de stratégies regroupent plusieurs stratégies ayant une finalité commune. Les jeux de stratégies sont généralement rendus accessibles
à un nombre limité d'utilisateurs, par la spécification des utilisateurs ou groupes d'un domaine autorisés à se servir des stratégies du jeu de
stratégies défini pour protéger des documents.
Chaque jeu de stratégies est associé à un coordinateur au moins. Le coordinateur de jeux de stratégies est un administrateur ou un utilisateur
possédant des autorisations supplémentaires. Au sein de l'organisation, le coordinateur est généralement la personne la plus à même de créer
des stratégies dans un jeu donné. En fonction des autorisations qui lui sont attribuées, le coordinateur de jeux de stratégies a la possibilité
d'effectuer les actions suivantes :
• Afficher des événements relatifs au jeu de stratégies.
• Gérer des documents.
• Gérer d'autres coordinateurs de jeux de stratégies.
Les jeux de stratégies sont créés et supprimés dans les pages Web d'administration de Rights Management ES2.5 par des administrateurs de
jeux de stratégies bénéficiant des autorisations requises.
L'installation de Rights Management ES2.5 crée un jeu de stratégies par défaut appelé Jeu de stratégies global. Les administrateurs de jeux de
stratégies sont autorisés à administrer ce jeu de stratégies.
ADOBE LIVECYCLE ES2.5
Service Rights Management
120
Services LiveCycle ES2.5
Méthodes et technologie liées à la sécurité
Pour garantir la confidentialité des documents protégés par des stratégies, Rights Management ES2.5 implémente trois couches de sécurité :
Authentification
Tous les utilisateurs doivent se connecter pour pouvoir interagir avec Rights Management ES2.5. Les utilisateurs doivent se connecter avant
d’exécuter les tâches suivantes :
• ouverture de l’application Web Rights Management ES2.5 dans un navigateur Web ;
• Sécurisation des documents à l’aide de stratégies dans une application cliente prise en charge
• Ouverture des documents protégés par une stratégie
Au moment de la création d'une stratégie, vous pouvez autoriser des utilisateurs anonymes à ouvrir des documents protégés par une stratégie
si ce paramètre est activé dans la configuration de Rights Management ES2.5. En autorisant l'accès aux utilisateurs anonymes, les utilisateurs
qui ne possèdent pas de compte peuvent accéder au document, mais ils ne peuvent pas ouvrir de session Rights Management ES2.5 ni utiliser
d'autres documents protégés par une stratégie.
Méthodes d’authentification
Rights Management ES2.5 prend en charge les méthodes d’authentification suivantes :
Nom d’utilisateur/mot de passe : Les utilisateurs sont invités à indiquer leur nom d’utilisateur et leur mot de passe.
Kerberos (uniquement à partir d’Acrobat sous Microsoft® Windows®) : permet aux utilisateurs d’Acrobat ou d’Adobe Reader sur une
plate-forme Windows d’être authentifiés en toute transparence.
Carte à puce (uniquement à partir d'Acrobat sous Microsoft Windows) : permet aux utilisateurs d’Acrobat ou d’Adobe Reader sur une
plate-forme Windows d’être authentifiés à l'aide d'une carte à puce.
Votre répertoire d'utilisateurs d'entreprise contient les enregistrements des utilisateurs internes. Ces enregistrements sont synchronisés avec
la base de données User Management. Rights Management ES2.5 authentifie les utilisateurs internes par rapport à cette base de données
User Management. Par ailleurs, Rights Management ES2.5 stocke les comptes des utilisateurs externes dans la base de données et les utilise
pour authentifier des utilisateurs externes. Pour plus de détails concernant la gestion des utilisateurs, reportez-vous à la section Ajout et
configuration d'utilisateurs de l'Aide à l'administration de LiveCycle ES2.5.
Assertions d’authentification SAML
Une fois les utilisateurs authentifiés, lorsque le composant Rights Management ES2.5 reçoit des messages en provenance des clients, Rights
Management ES2.5 utilise les assertions d’authentification SAML (Security Assertion Markup Language, langage de balisage d’assertions de
sécurité) pour vérifier l’identité de l’expéditeur des messages. Les assertions d’authentification SAML sont utilisées pour l’authentification
jusqu’à leur expiration ou lorsque les utilisateurs mettent fin à leur session.
Lorsque les utilisateurs ont été authentifiés à l’aide de leur nom d’utilisateur et de leur mot de passe, Rights Management ES2.5 génère une
assertion d’authentification SAML. Les assertions d'authentification SAML sont intégrées à l’en-tête SOAP et renvoyées au client.
L’en-tête des messages suivants qui sont envoyés à Rights Management ES2.5 possède l’assertion SAML conforme à la norme WS-Security.
Remarque : bien que les assertions SAML soient utilisées en interne pour permettre la gestion des sessions, Rights Management ES2.5 ne prend
pas en charge les assertions SAML tierces.
ADOBE LIVECYCLE ES2.5
Service Rights Management
121
Services LiveCycle ES2.5
Connexion via Acrobat et d'autres applications clientes
Lorsque Rights Management ES2.5 authentifie un utilisateur via Acrobat ou une autre application cliente telle que Microsoft Office, le
serveur renvoie l'assertion d'authentification SAML à l'application cliente.
Une fois la connexion établie via l'application cliente, une assertion SAML fournit la fonction SSO (Single Sign-On, authentification unique)
pour accéder à l’application Web. Si l'application cliente ouvre l’application Web, les utilisateurs sont authentifiés grâce à cette assertion et
n’ont pas à indiquer leur nom d’utilisateur ni leur mot de passe.
Contrôle d'accès basé sur les rôles
Rights Management ES2.5 utilise un modèle reposant sur des rôles pour contrôler l’accès aux fonctions de l’application Web. Les rôles
déterminent également si les utilisateurs peuvent protéger les documents à l’aide de stratégies par l’intermédiaire d'une application cliente
prise en charge. Des rôles sont attribués aux utilisateurs et aux groupes grâce aux pages Web User Management. Les informations sur ces
rôles sont stockées dans la base de données User Management. Pour plus de détails concernant les rôles utilisés par Rights Management
ES2.5, reportez-vous à la section A propos des utilisateurs de LiveCycle Rights Management ES2.5 dans l'Aide à l'administration de LiveCycle
ES2.5. Pour plus de détails concernant l'attribution des rôles, reportez-vous à la section Gestion des rôles de l'Aide à l'administration de
LiveCycle ES2.5.
Confidentialité des documents
Rights Management ES2.5 exploite plusieurs technologies pour protéger et rendre accessibles les documents. Généralement, Rights
Management ES2.5 utilise un système de clé cryptographique symétrique pour le chiffrement. Les applications clientes, telles qu’Acrobat,
assurent le chiffrement des documents. Les documents ne sont jamais envoyés à Rights Management ES2.5 lorsqu'ils sont protégés avec des
applications clientes. En revanche, ils sont envoyés au serveur lorsqu'ils sont protégés avec l'API Rights Management Service.
La méthode utilisée pour protéger les documents varie selon que la stratégie exige l’accès aux documents en ligne ou autorise les utilisations
hors connexion (reportez-vous aux sections « Accès aux documents protégés par une stratégie pour une utilisation en ligne », page 122 et
« Accès aux documents protégés par une stratégie pour une utilisation hors ligne », page 124.)
Lorsque vous appliquez une stratégie à un document PDF, les informations contenues dans le document (y compris les fichiers enregistrés
dans le document) sont protégées par les paramètres de confidentialité spécifiés dans la stratégie.
Remarque : les options de confidentialité de document qui sont appliquées par l'intermédiaire d'une stratégie remplacent celles appliquées au
document PDF dans Acrobat via les options de mot de passe ou de certificat (reportez-vous à l'Aide d'Acrobat).
ADOBE LIVECYCLE ES2.5
Service Rights Management
122
Services LiveCycle ES2.5
Accès aux documents protégés par une stratégie pour une utilisation en ligne
Il est possible de concevoir des stratégies exigeant que les utilisateurs se connectent à LiveCycle Rights Management ES2.5 pour ouvrir les
documents protégés. La protection des documents pour leur utilisation en ligne utilise un processus simple assurant le chiffrement du
document ainsi que l’attribution d’un accès exclusif aux utilisateurs authentifiés et autorisés.
Etapes représentées dans le schéma :
1
Le propriétaire du document ou l'administrateur sécurise le document à partir d'une application cliente prise en charge avec une
stratégie qui autorise l'utilisation en ligne. Les utilisateurs peuvent appliquer des stratégies à des documents à l'aide de toutes les
applications clientes prises en charge. Les développeurs peuvent également protéger le document à l’aide d’une stratégie par le biais du
service Rights Management dans un processus ou par programmation au moyen de l'API Rights Management Service.
2
Rights Management ES2.5 crée une licence de document ainsi que des clés de document, et chiffre la stratégie. La licence de document,
la clé du document et la stratégie chiffrée sont renvoyées à l'application cliente.
La licence de document est un document XML identifiant le document protégé, la stratégie, ainsi que l’identité du serveur. Le serveur
signe numériquement la licence pour garantir l’intégrité des données.
La clé de document est une clé symétrique destinée à chiffrer le document. Chacun des documents protégés est associé à une clé de
document.
3
L’application cliente utilise la clé de document pour chiffrer le document, rejette la clé de document et intègre la licence ainsi que la
stratégie de document. Ces tâches sont effectuées dans une page Web ou dans l’application cliente prise en charge.
Si la stratégie indique que les événements du document doivent être consignés, lorsque l’utilisateur ouvre le document, le logiciel client
envoie immédiatement les informations d’événement au serveur pour leur consignation. Pour plus de détails sur le journal d'audit, reportezvous à la section Contrôle des événements dans l'Aide à l'administration de LiveCycle ES2.5.
ADOBE LIVECYCLE ES2.5
Service Rights Management
123
Services LiveCycle ES2.5
Accès à des documents protégés par une stratégie en ligne
Pour que des documents protégés par une stratégie puissent être ouverts et utilisés, la stratégie doit autoriser l'utilisateur à accéder au
document. Cet utilisateur doit également disposer d’un compte Rights Management ES2.5 valide ainsi que d'une application cliente adaptée.
Pour les documents PDF, l'utilisateur doit disposer d'Acrobat ou d'Adobe Reader. Pour les autres types de fichiers, il doit disposer de
l'application adaptée au fichier et l'extension Rights Management ES2.5 doit être installée.
Lorsqu'un utilisateur tente d’ouvrir un document protégé par une stratégie, Acrobat, Adobe Reader ou l'extension deRights Management
ES2.5 se connectent à Rights Management ES2.5 pour authentifier l’utilisateur. Ce dernier peut ensuite se connecter. Si l'utilisation du
document est contrôlée, un message de notification apparaît. Lorsque Rights Management ES2.5 a déterminé les autorisations à attribuer, il
procède au déchiffrement du document. L’utilisateur peut ensuite utiliser le document conformément aux options de confidentialité de la
stratégie.
Etapes représentées dans le schéma :
1
L'utilisateur du document ouvre le document dans une application cliente prise en charge et s'authentifie auprès du serveur. Cette
opération est effectuée dans l’application cliente prise en charge. L'identificateur du document est envoyé au service Rights Management.
2
Le service Rights Management authentifie les utilisateurs, vérifie les autorisations de la stratégie et crée un coupon. Ce coupon,
contenant la clé et les autorisations du document, est renvoyé à l'application cliente.
3
Le document est déchiffré avec la clé du document et celle-ci est rejetée. Le document peut ensuite être utilisé conformément aux
paramètres de confidentialité spécifiés dans la stratégie. Ces opérations sont effectuées dans l’application cliente prise en charge.
Si la stratégie indique que les événements du document doivent être consignés, lorsque l’utilisateur ouvre le document, le logiciel client
envoie immédiatement les informations d’événement au serveur pour leur consignation. Pour plus de détails sur le journal d'audit, reportezvous à la section Contrôle des événements dans l'Aide à l'administration de LiveCycle ES2.5.
Si l’utilisateur enregistre une copie d’un document protégé par une stratégie, celle-ci est automatiquement appliquée au nouveau document.
Les événements tels que les tentatives d’ouverture du nouveau document sont également contrôlés et enregistrés pour le document original.
ADOBE LIVECYCLE ES2.5
Service Rights Management
124
Services LiveCycle ES2.5
L’utilisateur peut continuer à utiliser un document dans les limites de temps suivantes :
•
•
Indéfiniment ou pendant la période de validité spécifiée dans la stratégie
Jusqu’à ce que l’administrateur ou la personne ayant appliqué la stratégie révoque le droit d’ouvrir le document ou change de stratégie.
Accès aux documents protégés par une stratégie pour une utilisation hors ligne
Il est possible de concevoir des stratégies permettant aux utilisateurs d’ouvrir des documents lorsqu’ils ne disposent pas d’une connexion
réseau à Rights Management ES2.5.
Remarque : les documents protégés par des stratégies n’autorisant que l’utilisation en ligne sont généralement plus sécurisés que ceux qui sont
protégés par des stratégies autorisant l’utilisation hors connexion.
A leur premier accès à un document hors ligne, les utilisateurs sont invités à activer l'accès hors ligne. Cette invitation n'est pas réitérée à
l'ouverture d'autres documents hors ligne à moins que les utilisateurs utilisent un autre ordinateur.
Lorsqu'un utilisateur active l'accès hors ligne, le serveur LiveCycle ES2.5 synchronise les données avec le client adapté à l'ouverture des
documents hors ligne. Ces données contiennent des clés cryptographiques et des mises à jour de stratégies pertinentes, des licences, des
informations de révocation, etc. Elles sont stockées dans une base de données cliente protégée, appelée MicroSafe. Cette base de données est
chiffrée et protégée grâce à une API de protection des données spécifique à la plate-forme, tel que la DPAPI pour Windows et KeyChain
pour Mac OS®.
A chaque fois qu'un utilisateur ouvre un document protégé tout en étant connecté, un processus de synchronisation s'exécute en arrièreplan et met à jour la base de données MicroSafe en ajoutant toutes les informations d'incrémentation ultérieures à la dernière
synchronisation. La période d'ouverture hors ligne de la stratégie détermine le moment auquel l'utilisateur a dû effectuer une
synchronisation pour ouvrir des documents hors ligne (reportez-vous à la section Configuration de la sécurité hors connexion dans l'Aide
à l'administration de LiveCycle ES2.5).
Normes et technologie liées à la sécurité
Le tableau suivant fournit des détails sur les méthodes utilisées par Rights Management ES2.5 pour implémenter la sécurité :
Action
Technologie ou méthode utilisées
Création de clés de document
Algorithme PRNG (Pseudo Random Number Generator) généré conformément à la norme ANSI X9.61.
Création de vecteurs d’initialisation (IV) pour le
chiffrement AES-128 ou 256-bits en mode CBC (Cipher
Block Chaining)
Implémentation utilisée : kits d’outils RSA BSafe Crypto-C (dans Acrobat) ou Crypto-J (dans Rights
Management ES2.5).
Chiffrement de documents PDF
Algorithme AES-128 (ou AES-256 avec Acrobat 9.0) conformément à FIPS Publication 197.
Création de résumés de message
Algorithme SHA-1 (Secure Hash Algorithm-1) et SHA-2 (Secure Hash Algorithm-2) conformément à FIPS Pub
180-2.
Vérification de l’identité des expéditeurs des messages
Les assertions d’authentification SAML sont liées aux messages SOAP.
Les assertions SAML sont hachées à l’aide de l’algorithme SHA-1. Un code d’authentification de message
HMAC-SHA-1 est utilisé pour signer l’assertion SAML.
ADOBE LIVECYCLE ES2.5
Service Rights Management
125
Services LiveCycle ES2.5
Utilisation du service Rights Management
Création de stratégies
Vous pouvez créer et enregistrer un nombre illimité de stratégies en utilisant des options de protection adaptées à différents utilisateurs et
situations.
Attributs de stratégie
Lors de la création d'une stratégie, vous définissez différents attributs de stratégie, comme le nom de cette dernière. Si vous utilisez la section
LiveCycle ES2.5 SDK ou les pages Web de Rights Management ES2.5 pour créer la stratégie, vous pouvez également définir une période de
validité pour la stratégie. Une période de validité représente la période pendant laquelle le document protégé par une stratégie est accessible
aux destinataires autorisés. Si vous ne définissez pas cet attribut, la stratégie est alors valable en permanence.
Une période de validité peut être définie sur l'une des options suivantes :
• Un nombre de jours défini pendant lesquels le document est accessible à partir du moment où il est publié
• Une date de fin après laquelle le document n'est plus accessible
• Une plage de dates spécifique pendant laquelle le document est accessible
• Toujours valable
Vous pouvez ne spécifier qu'une date de début. La stratégie est alors valide après la date de début. Si vous spécifiez simplement une date de
fin, la stratégie est alors valide jusqu'à cette date.
Vous pouvez également créer une stratégie qui applique un filigrane aux documents PDF. Les filigranes contribuent à garantir la protection
d’un document PDF en identifiant ce dernier de façon unique et en contrôlant toute violation du copyright. Le libellé de ce filigrane peut
être l'un des suivants :
•
Nom d’utilisateur : nom de la personne ayant ouvert le document.
•
User ID : identifiant de la personne ayant ouvert le document.
•
Nom de la stratégie : nom de la stratégie qui s'applique au document.
•
Date actuelle : date à laquelle le document a été ouvert.
•
Texte personnalisé : texte, tel que le mot Confidentiel.
Une fois un filigrane créé, vous pouvez l'inclure comme faisant partie d'une stratégie. Une fois qu'une stratégie contenant un filigrane est
appliquée à un document PDF, le filigrane apparaît sur chaque page du document protégé par une stratégie.
Entrée de stratégie
Une entrée de stratégie permet de joindre des entités (des groupes et des utilisateurs) et des autorisations à une stratégie. Une stratégie doit
avoir au moins une entrée de stratégie. Imaginons, par exemple, que vous réalisiez ces tâches :
•
Créer une entrée de stratégie qui permet à un groupe de voir un document uniquement en ligne et qui interdit aux destinataires de le
copier.
• Joindre l'entrée de stratégie à la stratégie.
• Utiliser la stratégie pour protéger un document.
Suite à ces actions, les destinataires ne peuvent voir le document qu'en ligne et ils ne peuvent pas le copier. Le document reste sécurisé jusqu'à
ce que la protection soit supprimée.
ADOBE LIVECYCLE ES2.5
Service Rights Management
126
Services LiveCycle ES2.5
Méthodes possibles pour la création de stratégies
•
Les utilisateurs et les administrateurs peuvent utiliser les pages Web de Rights Management ES2.5 (reportez-vous à la section Création
et modification de stratégies de l'Aide de LiveCycle Rights Management ES2.5 ou dans l'Aide à l'administration de LiveCycle ES2.5).
•
Utilisez Workbench pour créer une stratégie à partir d'une stratégie existante. Lorsque vous créez une stratégie dans Workbench, il y a
moins de propriétés à configurer (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
•
Utilisation de l'API Rights Management Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
Modification de stratégies
Vous pouvez modifier une stratégie lorsque les exigences d'une entreprise changent et que la stratégie ne reflète plus ces dernières. Au lieu
de créer une stratégie, vous pouvez tout simplement mettre à jour une stratégie existante.
Pour modifier une stratégie, vous devez modifier la valeur des attributs de la stratégie. Les seuls attributs de stratégie qui ne peuvent être
modifiés sont les attributs de la section Paramètres avancés non modifiables. Dans Workbench, vous ne pouvez pas non plus modifier le
nom de la stratégie, ni sa durée de validité. Par exemple, pour modifier la période d'ouverture hors ligne de la stratégie, vous pouvez modifier
la valeur de l'attribut de la période d'ouverture hors ligne.
Les modifications apportées à des stratégies protégeant des documents sont mises à jour lorsque le document protégé par une stratégie est
synchronisé avec le service Rights Management.
Méthodes possibles pour la modification de stratégies
•
Les utilisateurs et les administrateurs peuvent utiliser les pages Web de Rights Management ES2.5 (reportez-vous à la section Création
et modification de stratégies de l'Aide de LiveCycle Rights Management ES2.5 ou dans l'Aide à l'administration de LiveCycle ES2.5).
•
•
Utilisation de Workbench (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
Utilisation de l'API Rights Management Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
Suppression de stratégies
Vous pouvez supprimer une stratégie existante ci celle-ci n'est plus nécessaire. Une fois supprimée, une stratégie n’est plus utilisable pour la
protection de documents. Toutefois, les documents existants protégés par cette stratégie restent sécurisés.
Pour supprimer une stratégie, vous devez spécifier la stratégie à supprimer et le jeu de stratégies auquel cette dernière appartient. L'utilisateur
dont les paramètres sont utilisés pour appeler LiveCycle ES2.5 doit disposer d'une autorisation pour supprimer la stratégie. Dans le cas
contraire, une exception se produit. Si vous essayez de supprimer une stratégie qui n'existe pas, une exception se produit également.
Méthodes possibles pour la suppression de stratégies
•
Les utilisateurs et les administrateurs peuvent utiliser les pages Web de Rights Management ES2.5 (reportez-vous à la section
Suppression de stratégies de l'Aide de LiveCycle Rights Management ES2.5 ou dans l'Aide à l'administration de LiveCycle ES2.5).
•
Utilisation de l'API Rights Management Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
Application de stratégies à des documents
Vous pouvez appliquer une stratégie à un document pour protéger ce dernier. Cette opération vous permet de limiter l’accès au document
et d'y appliquer des paramètres de confidentialité.
Pour appliquer une stratégie à un document PDF avec LiveCycle ES2.5 SDK, vous devez faire référence à une stratégie existante et spécifier
à quel jeu de stratégies cette dernière appartient. Le compte utilisateur utilisé pour se connecter à Rights Management ES2.5 nécessite un
accès à la stratégie. Dans le cas contraire, une exception se produit.
Une seule stratégie à la fois peut être appliquée à un document.
ADOBE LIVECYCLE ES2.5
Service Rights Management
127
Services LiveCycle ES2.5
Méthodes possibles pour l'application de stratégies
•
Acrobat Professional et Acrobat Pro Extended vous permettent d'appliquer des stratégies à des documents PDF (reportez-vous à l’Aide
d'Acrobat).
•
L'extension de LiveCycle Rights Management ES2.5 Extension pour Microsoft Office vous permet d'appliquer des stratégies à des
documents Microsoft Office (reportez-vous à l'Aide de LiveCycle Rights Management ES2 Extension pour Microsoft Office 2003 ou à
l'Aide de LiveCycle Rights Management ES2 Extension pour Microsoft Office 2007).
•
•
Utilisation de Workbench (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
Utilisation de l'API Rights Management Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
Suppression de stratégies de documents
Vous pouvez supprimer une stratégie d'un document protégé par une stratégie pour mettre fin à la protection du document. Si vous voulez
mettre à jour un document protégé par une stratégie avec une nouvelle stratégie, il est plus efficace de changer de stratégie plutôt que de
supprimer la stratégie et d'ajouter celle qui a été mise à jour.
Méthodes possibles pour la suppression de stratégies
•
Acrobat® Professional et Acrobat Pro Extended vous permettent de supprimer des stratégies de documents PDF (reportez-vous à l’Aide
d'Acrobat).
•
L'extension de LiveCycle Rights Management ES2.5 Extension pour Microsoft Office vous permet de supprimer des stratégies dans des
documents Microsoft Office (reportez-vous à l'Aide de LiveCycle Rights Management ES2 Extension pour Microsoft Office 2003 ou à
l'Aide de LiveCycle Rights Management ES2 Extension pour Microsoft Office 2007).
•
•
Utilisation de Workbench (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
Utilisation de l'API Rights Management Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
Modification de la stratégie appliquée à un document
Si vous voulez mettre à jour un document protégé par une stratégie avec une nouvelle stratégie, il est plus efficace de changer de stratégie
plutôt que de supprimer la stratégie et d'ajouter celle qui a été mise à jour.
Lorsque vous changez une stratégie, la nouvelle est appliquée comme suit :
•
Si le document est en ligne et fermé, la modification est appliquée lorsque le destinataire se synchronise avec Rights Management ES2.5
en ouvrant un document en ligne protégé par une stratégie.
•
•
Si le document est en ligne et ouvert, la modification prend effet lorsque l'utilisateur ferme le document.
Si le document est hors ligne, la modification est appliquée lorsque l'utilisateur se synchronise avec Rights Management ES2.5 en
ouvrant en ligne un document protégé par une stratégie.
Remarque : si vous souhaitez autoriser un accès anonyme à un document protégé par une stratégie qui ne permet pas ce type d'accès, vous devez
supprimer la stratégie existante dans l'application cliente, puis en appliquer une qui autorise l'accès anonyme. Si vous changez de stratégie, les
utilisateurs doivent ouvrir une session pour accéder au document.
Méthodes possibles pour la modification de stratégies
•
Les utilisateurs et les administrateurs peuvent utiliser les pages Web de Rights Management ES2.5 (reportez-vous à la section Changer
la stratégie appliquée à un document de l'Aide de LiveCycle Rights Management ES2.5 ou de l'Aide à l'administration de LiveCycle ES2.5).
•
•
Utilisation de Workbench (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
Utilisation de l'API Rights Management Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
ADOBE LIVECYCLE ES2.5
Service Rights Management
128
Services LiveCycle ES2.5
Révocation de l'accès à un document protégé par une stratégie
Vous pouvez révoquer l'accès à un document protégé par une stratégie. Cette opération rend toutes les copies du document inaccessibles
aux utilisateurs. Lorsqu’un utilisateur tente d’ouvrir un document révoqué, il peut être redirigé vers une URL définie permettant de visualiser
un document révisé. Lorsque vous révoquez l'accès à un document, la modification est appliquée lorsque l'utilisateur ouvre le document
protégé par une stratégie en ligne.
La capacité à révoquer l'accès à un document offre une protection supplémentaire. Imaginons, par exemple, qu'une nouvelle version d'un
document soit disponible et que vous ne souhaitiez plus que l'ancienne version puisse être vue. Dans ce cas, l'accès à l'ancien document peut
être révoqué et aucun individu ne peut y accéder à moins que l'accès ne soit rétabli.
Rétablissement de l'accès aux documents
Vous pouvez rétablir (annuler la révocation) l'accès à un document révoqué. Cette opération rend toutes les copies du document révoqué
accessibles aux utilisateurs.
Méthodes possibles pour révoquer l'accès à des documents
•
Les utilisateurs et les administrateurs peuvent utiliser les pages Web de Rights Management ES2.5 (reportez-vous à la section Révocation
et rétablissement de l'accès aux documents de l'Aide de LiveCycle Rights Management ES2.5 ou de l'Aide à l’administration de LiveCycle
ES2.5).
•
•
Utilisation de Workbench (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
Utilisation de l'API Rights Management Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
Contrôle des événements
Le service Rights Management permet de suivre toutes les actions relatives aux documents protégés par une stratégie lorsqu'ils se produisent.
Ce suivi est activé lorsque la fonctionnalité de contrôle est activée et que la stratégie utilisée pour protéger un document bénéficie de cette
fonctionnalité. Ces événements incluent des activités telles que l'application d'une stratégie à un document et l'ouverture d'un document
protégé par une stratégie.
Les événements peuvent faire partie de l'une des catégories suivantes :
• Les événements d'administrateur sont des actions liées à un administrateur, comme la création d'un compte administrateur.
• Les événements de document sont des actions liées à un document, comme la fermeture d'un document protégé par une stratégie.
• Les événements de stratégie sont des actions liées à une stratégie, comme la création d'une stratégie.
• Les événements de service sont des actions liées au service Rights Management, comme la synchronisation avec l'annuaire d'utilisateur.
Vous pouvez rechercher des événements précis à l'aide de l'API Rights Management Service. Vous pouvez également utiliser les pages Web
de Rights Management ES2.5 pour rechercher et afficher les événements contrôlés. Les utilisateurs peuvent afficher les événements contrôlés
sur leurs documents protégés par une stratégie, ainsi que sur les documents protégés qu'ils reçoivent et utilisent. Les administrateurs peuvent
afficher les événements contrôlés concernant tous les utilisateurs et tous les documents protégés par une stratégie. Les administrateurs
peuvent également suivre d'autres types d'événements, tels que les événements d'utilisateur, de document, de stratégie et de système.
Les événements qui surviennent sur une copie d'un document protégé par une stratégie sont également consignés comme des événements
concernant le document d'origine protégé.
Un événement d'échec est enregistré si un utilisateur non autorisé tente d'afficher un document ou d'ouvrir une session avec un nom
d'utilisateur ou un mot de passe incorrect.
Les stratégies peuvent autoriser l'accès d'utilisateurs anonymes. Si l'administrateur désactive par la suite l'accès anonyme, cet accès échoue
pour les documents protégés par la stratégie et l'événement n'est pas consigné.
ADOBE LIVECYCLE ES2.5
Service Rights Management
129
Services LiveCycle ES2.5
Méthodes de contrôle des événements
•
Les utilisateurs et les administrateurs peuvent utiliser les pages Web de Rights Management ES2.5 (reportez-vous à la section Contrôle
des événements de l'Aide de LiveCycle Rights Management ES2.5 ou de l'Aide à l'administration de LiveCycle ES2.5).
•
Utilisation de l'API Rights Management Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
Remarques sur le service Rights Management
Ordre des opérations
Toute combinaison de chiffrement, certification et application des droits d'utilisation sur un même document doit se dérouler dans l'ordre
suivant. Ces services doivent être appelés au court d'un processus de courte durée :
1
Appliquez un chiffrement (service Encryption) ou une stratégie (service Rights Management) à un document avant de le signer
numériquement (service Signature). Une signature numérique enregistre l’état du fichier au moment de la signature. Si vous chiffrez le
document ou appliquez une stratégie après avoir appliqué une signature sur ce dernier, les octets du fichier sont modifiés, la signature
apparaissant alors comme étant incorrecte.
2
Certifiez un document PDF (service Signature) avant de définir ses droits d’utilisation (service Reader Extensions). Si vous certifiez un
document après avoir appliqué ses droits d’utilisation, la signature des droits d’utilisation est invalidée, ce qui provoque la suppression
des droits d’utilisation du document.
3
Signez numériquement un document PDF (service Signature) après avoir défini les droits d’utilisation. La signature d’un document PDF
après l’application des droits d’utilisation n’invalide pas la signature des droits d’utilisation.
Par ailleurs, vous ne pouvez pas chiffrer un document PDF et lui appliquer une stratégie. De la même façon, vous ne pouvez pas appliquer
une stratégie à un document PDF chiffré.
130
30. Service Set Value
Le service Set Value définit la valeur d’une ou plusieurs données dans le modèle de données de processus. Par exemple, vous pouvez définir
la valeur d’une variable de processus ou bien la valeur d’un champ de formulaire.
Utilisation du service Set Value
Vous pouvez interagir avec le service Set Value en développant un processus dans LiveCycle Workbench utilisant ce service.
Les expressions XPath vous permettent de spécifier la donnée et la valeur à lui attribuer. Vous créez une association pour toutes les données
dont vous souhaitez définir la valeur. Les données variables sont enregistrées et disponibles tout au long du processus. Pour plus de détails
sur XPath, reportez-vous à la spécification XML Path Language (XPath).
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
131
31. Service Signature
Le service Signature vous permet de manipuler des signatures et des documents numériques sur le serveur LiveCycle ES2.5. Vous pouvez
utiliser ce service à partir de processus créés dans LiveCycle Workbench, ou de clients Java et services Web créés avec LiveCycle ES2.5 SDK.
Par exemple, le service Signature est généralement utilisé dans les situations suivantes :
•
Le serveur LiveCycle ES2.5 certifie un formulaire avant que ce dernier ne soit envoyé à un utilisateur et ouvert avec Acrobat ou Adobe
Reader.
• Le serveur LiveCycle ES2.5 valide la signature apposée dans un formulaire via Acrobat ou Adobe Reader.
• Le serveur LiveCycle ES2.5 signe un formulaire en nom et place d'un notaire.
Le service Signature accède aux certificats et aux informations d'identification stockées dans le trust store (reportez-vous à la section Gestion
des certificats et des informations d'identification dans l'Aide à l'administration de LiveCycle ES2.5).
Cette section contient les rubriques suivantes, qui fournissent des informations sur les signatures numériques et sur le service Signature :
• « A propos des signatures numériques », page 131
• « A propos des champs de signature », page 132
• « A propos du service Signature et des types de formulaires », page 132
• « A propos de la technologie des signatures numériques », page 133
• « Intégration à une infrastructure de sécurité », page 135
• « Technologies et normes prises en charge », page 135
Les rubriques suivantes vous informent sur les tâches que vous pouvez exécuter et sur la marche à suivre pour obtenir de meilleurs résultats :
•
•
« Utilisation du service Signature », page 136
« Meilleures pratiques », page 139
A propos des signatures numériques
Les signatures numériques sont des blocs d'informations ajoutés aux documents électroniques. Ils vous permettent d'authentifier l'identité
du signataire et de vérifier l'intégrité du document ou d'une partie du document :
•
Les signatures contiennent des informations qui vous permettent de déterminer qui est le propriétaire de chaque signature. Ces
informations servent à vérifier l'identité de l'expéditeur du document.
•
Lorsqu'un document est signé numériquement, la signature peut servir à déterminer si le document a subi des modifications depuis sa
signature.
Les informations d'identification servent à créer des signatures numériques. Les certificats servent à valider les signatures numériques et
l'identité de leurs propriétaires.
Signatures numériques et service Signature
Le service Signature prend en charge les signatures PDF et XML :
•
Le service Signature peut créer des signatures PDF pour tous les documents PDF, tels que des documents créés avec LiveCycle Designer
ES2.5 ou Acrobat.
•
Le service Signature peut valider des signatures XML pour des documents PDF basés sur XFA, tels que des documents créés avec
Designer ES2.5 ou Forms.
ADOBE LIVECYCLE ES2.5
Service Signature
132
Services LiveCycle ES2.5
Les signatures PDF ont d'autres applications que la simple authentification de l'identité du signataire et que la validation de l'intégrité d'un
document :
Signatures d'approbation : servent à approuver le contenu d'un document. Par exemple, un utilisateur remplit un formulaire puis le signe
pour approuver les données entrées dans ce dernier.
Signatures de certification : servent à attester le contenu des documents et à déterminer les types de modifications autorisées pour que le
document garde sa certification. Une agence gouvernementale par exemple, crée un formulaire avec des champs de signature. L'agence
certifie le document, permettant ainsi aux utilisateurs de ne modifier que les champs du formulaire et de signer le document. Les utilisateurs
peuvent remplir le formulaire et signer le document, mais s'ils en suppriment des pages ou y ajoutent des commentaires, le document ne
garde pas son statut certifié.
Les signatures de certification sont également appelées signatures MDP (Modify Detection Prevention).
A propos des champs de signature
Lorsqu'un formulaire est signé numériquement, la signature est apposée dans un champ de signature. Les formulaires doivent comprendre
un champ de signature avant de pouvoir être signés.
Plusieurs champs de signature peuvent être ajoutés sur le même formulaire. Chaque champ de signature peut être associé à un ensemble de
champs sur le formulaire. Après l'ajout de la signature, les champs associés se verrouillent. Ces types de signatures s'appellent des signatures
MDP+. Pour utiliser cette fonction avec des formulaires PDF et des formulaires XML, les utilisateurs doivent se servir d'Acrobat ou d'Adobe
Reader version 8 et ultérieures pour ouvrir les formulaires.
Les dictionnaires de valeurs de départ peuvent être ajoutés aux champs de signature pour configurer l'utilisation du champ une fois le
document signé. Par exemple, il est possible de fournir une liste de motifs de signatures ou d'indiquer les algorithmes de hachage permettant
de créer un résumé de document.
Vous pouvez ajouter des champs de signature au moment de la conception ou de l'exécution :
•
Utilisez Designer ES2.5 pour ajouter des champs de signature au moment de la conception (reportez-vous à l'Aide de LiveCycle Designer
ES2.5.)
•
Pour ajouter des champs de signature au moment de l'exécution, utilisez le service Signature (reportez-vous à la section « Ajout,
modification et suppression de champs de signature », page 138).
A propos du service Signature et des types de formulaires
LiveCycle ES2.5 prend en charge différents types de formulaires PDF. Bien que les utilisateurs d'Acrobat ou d'Adobe Reader ne distinguent
pas les types variés de formulaires PDF, la conception de ces derniers peut s'avérer différente. Par exemple, les formulaires peuvent être
rendus au format PDF avec le service Forms sur le serveur LiveCycle ES2.5 ou avec Acrobat ou Adobe Reader.
Les formulaires PDF n'exigeant pas de rendu particulier peuvent être utilisés avec le service Signature en toute situation. En revanche, les
formulaires PDF exigeant un certain rendu peuvent rencontrer des problèmes au niveau des signatures numériques, selon l'utilisation qui
en est faite.
Lorsqu'un formulaire PDF signé numériquement est rendu, la signature de ce formulaire est invalidée. A titre d'exemple, un utilisateur ouvre
un formulaire PDF dynamique avec Acrobat, le signe numériquement et l'enregistre. L'utilisateur envoie ensuite le fichier à un collègue par
courrier électronique. Lorsque le collègue ouvre le formulaire, Acrobat le rend sous forme de formulaire PDF, ce qui invalide la signature
numérique.
ADOBE LIVECYCLE ES2.5
Service Signature
133
Services LiveCycle ES2.5
Pour utiliser le service Signature, identifiez le type de formulaire que vous utilisez.
Acrobat Formulaire PDF : les formulaires PDF créés avec Acrobat (ou un outil similaire). Ces formulaires n'ont pas besoin d'être rendus
après leur création.
Adobe Formulaire PDF : formulaires PDF créés avec Designer ES2.5. Ces fichiers sont enregistrés sous forme de formulaires PDF statiques
ou dynamiques :
•
Le contenu des formulaires PDF statiques ne change pas, à l'exception des valeurs de champs. A l'ouverture d'un fichier, Acrobat ou
Adobe Reader utilisent les informations contenues dans ce dernier pour le rendre sous forme de formulaire PDF. Au premier
enregistrement du fichier, le formulaire PDF est stocké dans le fichier. A l'ouverture suivante du formulaire, il n'est pas rendu de
nouveau.
•
Le contenu des formulaires PDF dynamiques peut être modifié en fonction des données entrées par l'utilisateur. L'utilisateur peut par
exemple, ajouter des lignes à un tableau ou des formulaires secondaires s'il le souhaite. Le formulaire PDF est toujours rendu lorsqu'il
est ouvert avec Acrobat ou Adobe Reader.
Pour plus de détails sur les formulaires PDF Adobe statiques et dynamiques, reportez-vous à la section Utilisation de Designer ES2.5 >
Utilisation des conceptions de formulaire > Instructions pour la création de formulaires PDF dans l'Aide de LiveCycle Designer ES2.5.
Adobe Formulaire XML : les fichiers XDP créés avec Designer ES2.5. Les formulaires XML Adobe sont conçus pour être ouverts dans
Acrobat ou Adobe Reader avec le service Forms. Le service Forms peut être configuré pour que le formulaire PDF soit rendu par l'un de ces
agents :
•
•
•
service Forms (sur le serveur LiveCycle ES2.5) avant envoi au client ;
Acrobat
Adobe Reader.
Formulaires PDF non interactifs : formulaires PDF que les utilisateurs peuvent visualiser électroniquement ou imprimer. A titre
d'exemple, les fichiers convertis en PDF depuis un format de fichier différent sont non interactifs. Ces formulaires n'ont pas besoin d'être
rendus après leur création.
Pour plus de détails concernant les conditions à respecter pour concevoir des formulaires utilisés dans LiveCycle Workspace ES2.5, reportezvous à la section « Configuration requise pour la conception de formulaires et Workspace ES2.5 », page 140.
A propos de la technologie des signatures numériques
Cryptographie à clé publique
Les signatures numériques sont basées sur la cryptographie à clé publique (ou cryptographie asymétrique), qui utilise des paires de clés
publique/privée pour le chiffrement et le déchiffrement de texte :
•
•
La clé privée sert à chiffrer du texte et des documents. Les clés privées sont protégées.
La clé publique correspondante sert à déchiffrer le texte précédemment chiffré grâce à la clé privée. La clé publique ne peut déchiffrer
que le texte précédemment chiffré grâce à la clé privée qui lui est associée. Les clés publiques sont diffusées, parfois très largement.
Tony Blue utilise par exemple sa clé publique pour chiffrer ses messages avant de les envoyer à leurs destinataires. Les destinataires ont alors
besoin de la clé publique pour déchiffrer les messages et les lire. Tony doit fournir aux destinataires la clé publique afin qu'ils soient en
mesure de lire ses messages électroniques.
ADOBE LIVECYCLE ES2.5
Service Signature
134
Services LiveCycle ES2.5
Certificats numériques
Les certificats numériques servent à vérifier l'authenticité des signatures numériques. Les certificats numériques associent une clé publique
à l'identité d'un individu :
•
Les certificats peuvent être émis par les autorités de certification, des tiers de confiance. Les autorités de certification vérifient l'identité
des individus à qui elles fournissent ces certificats. Si vous faites confiance à l'autorité de certification, vous faites confiance aux certificats
qu'elle émet.
•
Les certificats peuvent également être autosignés. Les certificats autosignés sont généralement créés par le propriétaire du certificat luimême. Ils s'avèrent utiles lorsque vous savez que vous pouvez faire confiance à ce dernier.
Les autorités de certification publient des listes de révocation des certificats (CRL) qui contiennent les numéros de série des certificats non
valides. Les listes CRL possèdent des dates d'expiration et sont en règle générale mises à jour régulièrement.
De fonctionnement identique aux listes CRL, le protocole OCSP (Online Certificate Status Protocol) sert à obtenir le statut des certificats
X.509. Le protocole OCSP permet de mettre à jour et d'obtenir le statut des certificats plus rapidement qu'avec les systèmes CRL.
Les autorités de certification peuvent déléguer l'émission des certificats à des autorités de certification de niveau inférieur. Il en résulte une
hiérarchie d'autorités de certification. La chaîne de certificats indique le chemin parcouru dans la hiérarchie, d'une autorité de certification
de niveau inférieur à l'autorité racine. Les certificats émis par les autorités de niveau inférieur contiennent la chaîne de certificats.
L'authenticité de chaque autorité de certification de la chaîne peut être vérifiée.
Informations d'identification numériques
Les informations d'identification servent à signer des documents numériquement. Les informations d'identification d'un utilisateur
comprennent sa clé privée et d'autres informations, telles qu'un alias. Un mot de passe permet d'accéder au contenu des informations
d'identification. Le contenu et le format des informations d'identification sont définis selon différentes normes. En voici deux exemples :
•
La norme de syntaxe d'échange d'informations personnelles (PKCS #12) définit un format de fichier pour le stockage d'une clé privée
et du certificat numérique correspondant.
•
L'interface de jeton cryptographique (PKCS #11) définit une interface pour la récupération des informations d'identification stockées
dans le matériel.
Signatures numériques
Les signatures numériques sont un résumé chiffré du document signé. Le résumé et le certificat du signataire servent à valider l'intégrité du
document.
Lorsque vous signez un document numériquement, un résumé du contenu du document est créé à l’aide d’un algorithme de hachage. Il
n'existe qu'un résumé par document ; ce document ne peut pas être recréé à partir du résumé. Le résumé est chiffré avec la clé privée du
signataire pour créer la signature.
La signature et le certificat correspondant à la clé privée utilisée pour créer la signature sont généralement intégrés au document.
Les signatures peuvent contenir des jetons d'horodatage. Le protocole TSP (Time Stamp Protocol, protocole d'horodatage) sert à déterminer
la date et l'heure à laquelle une signature numérique a été créée. Ces informations servent à vérifier qu'une signature numérique a bien été
créée avant que le certificat associé ne soit révoqué. Une autorité d'horodatage (TSA, Time Stamp Authority) propose des services
permettant d'obtenir et de vérifier les informations d'horodatage.
Vérification de l'intégrité d'un document
Pour valider la signature, la clé publique contenue dans le certificat est utilisée pour déchiffrer le résumé. Le résumé est alors recalculé et
comparé au résumé déchiffré. Si les résumés sont identiques, le document n'a pas subi de modifications.
ADOBE LIVECYCLE ES2.5
Service Signature
135
Services LiveCycle ES2.5
Intégration à une infrastructure de sécurité
Le service Signature accède aux certificats, aux informations d'identification et aux listes de révocation stockés dans Trust Store
Management. Il peut également se servir de Trust Store Management pour accéder aux informations d'identification stockées dans les
périphériques HSM (Hardware Security Module, module de sécurité matérielle) (reportez-vous à la section Gestion des informations
d'identification HSM dans l'Aide à l'administration de LiveCycle ES2.5).
Le service Signature peut également communiquer avec des ressources externes afin de récupérer des certificats et valider des signatures :
•
•
•
Requêtes LDAP/LDAPs et HTTP/HTTPs pour la récupération des certificats en vue de la validation de la chaîne.
•
•
Connexion aux serveurs OCSP.
Connexion aux autorités d'horodatage via HTTP et HTTPs.
Récupération des listes CRL via HTTP/HTTPs et LDAP/LDAPs. Le service Signature prend également en charge les listes CRL hors
ligne stockées à l'aide de Trust Store Management.
Intégration à des fournisseurs de services externes pour la récupération des informations d'identification et la vérification des certificats.
Technologies et normes prises en charge
Le tableau suivant récapitule les technologies et les normes prises en charge par LiveCycle Digital Signatures ES2.5.
Elément
Technologie ou standards pris en charge
Hachage unidirectionnel (pour la création de résumés SHA-1, SHA-256, SHA-384 et SHA-512
de documents)
MD5
RIPEMD160
Signatures numériques
PKCS #1 et #7
RSA (jusqu’à 4 096 bits)
DSA (jusqu’à 4 096 bits)
Signatures XML
Valeurs initiales (mise en œuvre des critères d’utilisation des certificats)
Horodatage (par l'intermédiaire d'un fournisseur de service d'horodatage)
Validité des certificats
Liste de révocation des certificats (CRL)
Protocole OCSP (Online Certificate Status Protocol)
Validation du chemin conforme à la RFC 3280
Le service Signature applique la norme FIPS (Federal Information Processing Standard) et utilise les bibliothèques RSA BSAFE.
ADOBE LIVECYCLE ES2.5
Service Signature
136
Services LiveCycle ES2.5
Utilisation du service Signature
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. 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 ES2.5.
Vous pouvez utiliser les pages Applications and Services de LiveCycle Administration Console pour configurer les propriétés par défaut de
ce service (reportez-vous à la section Paramètres du service Signature dans l'Aide à l'administration de LiveCycle ES2.5.)
Signature et certification de documents
Vous pouvez utiliser le service Signature pour signer et certifier des documents PDF avec toutes les informations d'identification auxquelles
le service peut accéder. Au moment de la signature ou de la certification, vous devez définir le champ de signature à utiliser.
Les restrictions suivantes s'appliquent aux formulaires PDF dynamiques Adobe lorsqu'ils sont utilisés avec le service Signature :
•
•
•
Vous ne pouvez pas signer un champ de signature visible.
Vous pouvez certifier des champs de signature invisibles.
Vous ne pouvez certifier des champs de signature visibles que si le service Signature est configuré pour traiter les documents compatibles
avec Acrobat 9. Le formulaire ne peut s'afficher qu'avec Acrobat ou Adobe Reader 9.
Remarque : les utilisateurs d'Acrobat ou d'Adobe Reader peuvent supprimer les signatures apposées par le service Signature dans tous les types
de formulaires.
Au moment de la signature ou de la certification des formulaires, les informations suivantes peuvent être précisées :
Informations d’identification : les informations d'identification qui contiennent la clé privée ayant servi à créer la signature numérique.
Autorisations des MDP d'un document : les modifications que les utilisateurs peuvent effectuer sur un document sans en invalider la
certification au moment de cette dernière.
Informations de révocation : intégration ou non des informations de révocation dans la signature à utiliser pour la validation du certificat
du signataire. Ces informations activent les contrôles OCSP et CRL.
Informations d'horodatage : création ou non d'un jeton d'horodatage à intégrer à la signature et informations requises pour effectuer la
transaction d'horodatage avec le fournisseur d'horodatage.
Apparence : propriétés qui modifient l'apparence de la signature lorsqu'elle s'affiche avec Acrobat ou Adobe Reader. Ces propriétés peuvent
être le motif de la signature, les informations de contact du signataire, une attestation légale et les icônes à utiliser.
Vérification de l'intégrité et de l'authenticité d'un document
Vous pouvez utiliser le service Signature pour valider les signatures apposées dans les formulaires PDF. Pour valider les signatures, la
révocation du certificat et l'horodatage de la signature peuvent être contrôlés ; le résumé du document est vérifié. Cela vous permet de valider
une ou plusieurs signatures à la fois dans un document PDF.
Les restrictions suivantes s'appliquent à la validation des signatures numériques avec le service Signature :
•
•
Le service Signature ne peut pas valider correctement les signatures des formulaires PDF dynamiques Adobe.
Le service Signature ne permet pas de s'assurer que les règles de verrouillage des champs de signature (règles MDP+) sont appliquées
sur les formulaires PDF et XML Adobe.
Au moment de la validation des signatures, les informations suivantes peuvent être précisées :
Champ de signature : le nom du champ de signature qui contient la signature à vérifier.
ADOBE LIVECYCLE ES2.5
Service Signature
137
Services LiveCycle ES2.5
Contrôle des informations de révocation : indique s'il faut vérifier ou non si le certificat du signataire est révoqué. Vous pouvez préciser
ces informations pour activer les contrôles de types OCSP et CRL.
Contrôle des informations d'horodatage : mode de vérification de l'horodatage de la signature.
Validation du chemin : informations permettant la vérification des certificats de la chaîne, elle-même contenue dans le certificat du
signataire.
Les messages d'état de validité varient selon que l'option Traiter des documents avec la compatibilité Acrobat 9 est sélectionnée pour le
service Signature (reportez-vous à la section Paramètres du service Signature dans l'Aide à l'administration de LiveCycle ES2.5).
Le tableau suivant décrit les causes des modifications des états de validité des signatures lorsque l'option est sélectionnée.
Valeurs
Etat de la signature
DynamicFormSignatureUnknown
Etat inconnu
DocumentSignatureUnknown
L'intégrité du document ou du formulaire PDF dynamique n'a pas été vérifiée.
CertifiedDynamicFormSignatureTamper
Altération
SignedDynamicFormSignatureTamper
Le document ou le formulaire dynamique a été altéré ou corrompu depuis l'application de la signature.
CertifiedDocumentSignatureTamper
SignedDocumentSignatureTamper
SignatureFormatError
Invalid
La signature est invalide car son formatage ou ses informations contiennent des erreurs.
DynamicFormSigNoChanges
Signé sans modification
DocumentSigNoChanges
Le document ou le formulaire dynamique n'a pas été modifié depuis l'application de la signature.
DynamicFormCertificationSigNoChanges
Certifié sans modification
DocumentCertificationSigNoChanges
Le document ou le formulaire dynamique n'a pas été modifié depuis sa certification.
DocSigWithChanges
Signé avec modifications
La révision du document couvert par la signature n'a pas été modifiée, mais le document a subi des modifications
ultérieures.
CertifiedDocSigWithChanges
Signé avec modifications autorisées
Le document a été modifié depuis l'application de la signature. Cependant, les modifications sont autorisées par l'autorité
de certification du document et n'invalident pas la signature.
CertificationSignWithChanges
Certifié avec modifications
Le document a été modifié depuis sa certification. Cependant, les modifications sont autorisées par l'autorité de
certification du document et n'invalident pas la signature.
ADOBE LIVECYCLE ES2.5
Service Signature
138
Services LiveCycle ES2.5
Le tableau suivant décrit les causes des modifications des états de validité des signatures lorsque l'option n'est pas sélectionnée.
Valeur
Etat de la signature
Invalid
Signature non valide
La révision du document couvert par la signature a été modifiée.
Unknown
Etat inconnu
La validation de la signature du contenu signé n'a pas été effectuée.
ValidAndModified
Signature valide mais document modifié
La révision du document couvert par la signature n'a pas été modifiée, mais le document a subi des modifications ultérieures.
ValidUnmodified
Signature valide et document non modifié
La révision du document couvert par la signature n'a pas été modifiée. Aucune modification ultérieure n'a été apportée au document.
Au moment de la validation des signatures, vous devez savoir si vous validez une signature PDF ou XML.
Suppression de signatures
Vous pouvez utiliser le service Signature pour supprimer les signatures des champs de signature.
Récupération de signatures et de champs de signature
Vous pouvez utiliser le service Signature pour récupérer les éléments de formulaire suivants :
•
•
•
Informations sur les champs de signature et certification de ces champs
Signatures numériques et informations sur ces signatures
La révision du formulaire PDF tel qu'il se présentait au moment de la signature d'un champ
Attention : Vous ne pouvez pas récupérer le champ de certification d'une signature depuis les formulaires rendus sur le client.
Ajout, modification et suppression de champs de signature
Vous pouvez utiliser le service Signature pour ajouter, modifier et supprimer les champs de signature visibles et invisibles des formulaires.
Lorsque vous ajoutez et que vous modifiez des champs de signature, vous pouvez configurer les propriétés suivantes :
•
•
•
•
Le nom du champ et son emplacement pour les champs de signature visibles.
•
Le champ peut ou non ne servir qu'à certifier le document.
Les champs à verrouiller au moment où la signature est apposée.
Le gestionnaire de signatures qui valide les signatures.
Les informations concernant la signature : inclure ou non les informations de révocation, une liste de motifs de signature parmi lesquels
les utilisateurs peuvent faire leur choix et les URL des serveurs pour la validation des signatures.
Attention : le service Signature ne peut pas ajouter ou modifier les champs de signature d'un formulaire PDF dynamique Adobe.
ADOBE LIVECYCLE ES2.5
Service Signature
139
Services LiveCycle ES2.5
Meilleures pratiques
Les caractéristiques suivantes de LiveCycle ES2.5 et du service Signature entraînent des restrictions concernant la manière d'utiliser les
formulaires PDF dynamiques Adobe :
•
•
Les signatures numériques sont invalidées lorsqu'un formulaire signé est rendu au format PDF.
Le service Signature ne permet pas de s'assurer que les règles de verrouillage des signatures (règles MDP+) sont appliquées sur les
formulaires PDF et XML Adobe.
En règle générale, déterminez ce que vous considérez comme le plus important pour vous : l'utilisation de formulaires PDF dynamiques ou
l'utilisation de signatures numériques sur le serveur :
•
Si vous utilisez des fonctionnalités du service Signature qui ne prennent pas en charge les formulaires PDF dynamiques Adobe, utilisez
un type de formulaire différent et assurez-vous qu'aucun rendu ne se produit dans Acrobat ou Adobe Reader (reportez-vous à la section
« Vérification de l'absence de rendu après la signature », page 139).
•
Si vous devez utiliser des formulaires PDF dynamiques, vous pouvez convertir ces derniers en formulaires non interactifs avant d'utiliser
les fonctionnalités du service Signature sur ceux-ci (reportez-vous à la section « Conversion en formulaire non interactif », page 140).
•
Avant d'utiliser le formulaire avec le service Signature, vous devez vous assurer que ce dernier n'est pas un formulaire PDF dynamique
Adobe (reportez-vous à la section « Contrôle du type de formulaire », page 140).
De plus, pour utiliser des signatures numériques dans des formulaires que les utilisateurs ouvrent dans Workspace ES2.5, votre formulaire
doit se conformer à des critères de conception précis (reportez-vous à la section XREF).
Ordre des opérations
Toute combinaison de chiffrement, certification et application des droits d'utilisation sur un même document doit se dérouler dans l'ordre
suivant. Ces services doivent être appelés au court d'un processus de courte durée :
1
Appliquez un chiffrement (service Encryption) ou une stratégie (service Rights Management) à un document avant de le signer
numériquement (service Signature). Une signature numérique enregistre l’état du fichier au moment de la signature. Si vous chiffrez le
document ou appliquez une stratégie après avoir appliqué une signature sur ce dernier, les octets du fichier sont modifiés, la signature
apparaissant alors comme étant incorrecte.
2
Certifiez un document PDF (service Signature) avant de définir ses droits d’utilisation (service Reader Extensions). Si vous certifiez un
document après avoir appliqué ses droits d’utilisation, la signature des droits d’utilisation est invalidée, ce qui provoque la suppression
des droits d’utilisation du document.
3
Signez numériquement un document PDF (service Signature) après avoir défini les droits d’utilisation. La signature d’un document PDF
après l’application des droits d’utilisation n’invalide pas la signature des droits d’utilisation.
Vérification de l'absence de rendu après la signature
Lorsqu'un formulaire est rendu au format PDF, toutes les signatures numériques qu'il contient sont invalidées. Vous devez vous assurer que
les formulaires PDF ne sont pas rendus après les avoir signés numériquement. Vous pouvez empêcher le rendu de s'effectuer en utilisant les
formulaires PDF ou XML Adobe statiques Adobe.
Formulaires Adobe PDF statiques
Utilisez Designer ES2.5 pour créer des formulaires PDF statiques Adobe, afin que le rendu ne se produise que lors de la première ouverture
dans Acrobat ou Adobe Reader.
Si vous utilisez le service Forms pour fusionner des données avec un formulaire, empêchez le service de convertir ce dernier en formulaire
PDF dynamique. Utilisez Designer ES2.5 pour configurer les propriétés de formulaires suivantes :
Version cible : définissez Acrobat et Adobe Reader 8.0 ou versions ultérieures
ADOBE LIVECYCLE ES2.5
Service Signature
140
Services LiveCycle ES2.5
Format de rendu PDF : définissez les formulaires PDF statiques
Pour plus de détails concernant la configuration des propriétés de formulaires, reportez-vous à l'Aide de LiveCycle Designer ES2.5.
Si vous utilisez le formulaire avec le service Utilisateur dans un processus, utilisez une variable Document Form pour stocker les données
du formulaire. Configurez la variable Document Form afin que le service de rendu ne soit utilisé qu'une fois (reportez-vous à l'Aide de
LiveCycle Workbench 9.5.)
Formulaires XML Adobe
Adobe Les formulaires XML (fichiers XDP) peuvent être rendus au format PDF grâce au service Forms. Pour utiliser le service Signature
avec des formulaires XML Adobe, le service Forms doit être configuré pour que le rendu se produise sur le serveur et pas sur le client.
Lorsqu'un rendu est effectué sur le serveur, le formulaire PDF qui en résulte est intégré au fichier XDP et n'est plus jamais rendu.
Conversion en formulaire non interactif
Pour utiliser des formulaires PDF dynamiques Adobe avec le service Signature, vous devez convertir les formulaires en formulaires PDF non
interactifs.
Ceci implique généralement l'utilisation de formulaires PDF dynamiques Adobe permettant de collecter les données. Une fois les opérations
de collecte de données effectuées, le formulaire est converti en formulaire PDF non interactif, utilisé avec le service Signature :
•
•
•
Les champs de signature sont ajoutés au formulaire non interactif.
Le service Signature peut apposer une signature dans le formulaire.
Ce formulaire peut être envoyé aux utilisateurs pour qu'ils les signent numériquement, le service Signature peut ensuite valider les
signatures.
Vous ne pouvez pas afficher les formulaires non interactifs destinés aux utilisateurs dans Workspace ES2.5. En revanche, vous pouvez
associer des formulaires non interactifs aux tâches de Workspace ES2.5 avec le service Utilisateur. Vous pouvez également diffuser les
formulaires par courrier électronique.
Utilisez le service Output pour convertir les formulaires dynamiques PDF en formulaires PDF non interactifs.
Remarque : lorsque les formulaires contenant des signatures numériques sont convertis en formulaires PDF non interactifs, les signatures
numériques disparaissent. Seule l'apparence de la signature numérique subsiste.
Contrôle du type de formulaire
Avant d'utiliser le formulaire avec le service Signature, vous pouvez vous assurer que ce dernier n'est pas un formulaire PDF dynamique
Adobe. Le service PDF Utilities permet la récupération des propriétés d'un document PDF. Les résultats comprennent le type de formulaire,
qui ne doit pas être égal à la valeur Dynamic-XFA.
Configuration requise pour la conception de formulaires et Workspace ES2.5
Si vous utilisez des signatures numériques dans un formulaire PDF que les utilisateurs ouvrent dans Workspace ES2.5, ajoutez au formulaire
un bouton d'envoi invisible plutôt qu'un objet Champs de processus. Ce bouton d'envoi invisible permet de s'assurer que les signatures
numériques du formulaire demeurent valides si le formulaire est envoyé avec Workspace ES2.5.
Lorsque l'objet Champs de processus est intégré à un formulaire, le serveur LiveCycle ES2.5 modifie l'apparence du bouton d'envoi contenu
dans l'objet. Les signatures numériques apposées avant l'envoi du formulaire indiquent qu'une modification a été effectuée. Un triangle jaune
prévient l'utilisateur de cette modification.
Un bouton d'envoi est un objet Bouton dont la propriété Type de commande est paramétrée sur Envoyer. Vous n'êtes pas obligé de définir
d'URL cible. Après avoir ajouté le bouton d'envoi, paramétrez la propriété Présence sur Invisible.
Pour ajouter des boutons d'envoi au moment de la conception, utilisez Designer ES2.5 (reportez-vous à l'Aide de LiveCycleDesigner ES2.5 ).
141
32. Service Stall
Le service Stall permet d’empêcher les erreurs situationnelles de se produire en les anticipant. Ce service offre la possibilité de bloquer la
branche dont l'erreur fait partie.
Par exemple, des processus peuvent utiliser les données fournies par une ressource externe, comme la base de données d’un partenaire. Une
action Execute Script peut être utilisée pour vérifier la validité des données. Si les données ne sont pas valides, une action Stall bloquant
l’instance du processus peut être exécutée alors que les données de la base de données sont corrigées.
Utilisation du service Stall
Vous pouvez interagir avec le service Stall en développant un processus dans LiveCycle Workbench utilisant ce service.
Si vous connaissez une éventuelle erreur situationnelle dans votre processus, vous pouvez ajouter un itinéraire menant au service Stall. Dans
cet itinéraire, vous pouvez ajouter une condition qui vérifie si l’erreur situationnelle s’est produite. Lorsque la situation survient, la branche
est bloquée pour que vous puissiez corriger l’erreur et redémarrer le processus à l’aide de LiveCycle Administration Console.
Remarque : lorsqu'elle est utilisée dans les branches de transaction ou les processus de courte durée, l'opération d'exécution génère une exception
plutôt que de bloquer la branche.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
142
33. Service Utilisateur
Le service Utilisateur permet aux processus de créer et d'affecter des tâches aux utilisateurs de LiveCycle Workspace ES2.5, ou d'en envoyer
aux utilisateurs par courrier électronique. Vous pouvez également affecter des tâches par programmation à l’aide de l'API Task Manager
Service. Après la création d'une tâche, vous pouvez interagir avec cette dernière avec des processus, l'API Task Manager Service, et LiveCycle
Administration Console.
Cette section contient les rubriques suivantes :
•
•
« Utilisation du service Utilisateur », page 142
« Interaction avec les tâches », page 144
Utilisation du service Utilisateur
Le service Utilisateur permet d'exécuter l'opération d'affectation des tâches que les processus utilisent pour créer des tâches et les affecter
aux utilisateurs soit dans Workspace ES2.5 soit par courrier électronique. L'opération d'affectation des tâches vous permet également de
configurer les fonctions des tâches transmises aux utilisateurs de Workspace ES2.5.
Affectation des tâches
Affecter des tâches aux utilisateurs ou groupes afin de les ajouter à leur liste Tâche dans Workspace ES2.5. Vous pouvez affecter des tâches
à tous les utilisateurs ou groupes présents dans User Management :
•
Vous pouvez affecter une tâche au même utilisateur ou groupe pour chaque instance du processus créé. Cette stratégie permet de
simplifier les tests au cours du développement. Par exemple, si vous affectez toutes les tâches à une seule personne, vous ne devez vous
connecter qu'une fois à Workspace ES2.5 pour vérifier la création de la tâche.
•
Vous pouvez affecter des tâches à l'identification d'un utilisateur ou groupe stockée dans une variable de processus. Cette méthode
s'avère plus adaptée aux environnements de production car l'utilisateur ou le groupe peuvent changer en fonction de l'instance de
processus. Avant l'affectation d'une tâche, l'identification de l'utilisateur ou groupe est obtenue et stockée.
Méthodes d'affectation des tâches
•
•
Utilisation de LiveCycle Workbench (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
Utilisation de l'API Task Manager Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
Configuration des fonctions de tâche
A la création de tâches, vous pouvez configurer des fonctions qui modifieront l'expérience des utilisateurs :
Formulaires et données de formulaires : précisez quel formulaire est à transmettre aux utilisateurs de Workspace ES2.5 et quelles données
de formulaires sont à inclure dans ce dernier. précisez également l'emplacement d'enregistrement des données de formulaires envoyées
lorsque la tâche est terminée.
Instructions : fournir des instructions aux utilisateurs de Workspace ES2.5 décrivant la marche à suivre pour réaliser une tâche.
Délégation des tâches et consultation : préciser si les utilisateurs peuvent déléguer des tâches à d'autres ou les consulter à propos de ces
tâches.
ADOBE LIVECYCLE ES2.5
Service Utilisateur
143
Services LiveCycle ES2.5
Pièces jointes et notes : préciser si les utilisateurs peuvent ajouter des pièces jointes et des notes aux tâches. Vous pouvez également ajouter
des pièces jointes aux tâches si elles sont pertinentes par rapport au travail à effectuer.
Rappels, délais et transmissions : configurer ces mécanismes pour garantir que la progression du processus s'effectue avec des contraintes
de temps.
Méthodes possibles de configuration des fonctions de tâche
•
Utilisation de Workbench (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
Configuration des notifications par courrier électronique
Les utilisateurs de Workspace ES2.5 peuvent recevoir des notifications électroniques si les événements suivants surviennent :
• Une tâche est affectée aux utilisateurs.
• Un rappel concernant une tâche qui leur est affectée survient ou cette dernière arrive à échéance.
• Une transmission concernant une de leurs tâches a lieu.
Il est possible de configurer le sujet ainsi que le corps du message. Le texte peut contenir des paramètres concernant les propriétés des tâches
mises à jour au moment de l'exécution. Grâce à ces paramètres les messages peuvent contenir des données différentes pour chaque tâche,
comme l'identification de la tâche.
Les courriers électroniques par défaut peuvent être écrits avec LiveCycle Administration Console. Ces derniers s'appliquent à toutes les
tâches créées pour tous les processus. Vous pouvez configurer l'opération d'affectation des tâches avec LiveCycle Workbench pour remplacer
les messages par défaut associés à une tâche, ou bien désactiver les notifications de cette dernière.
Les messages configurés via Workbench peuvent également contenir des expressions XPath vous permettant d'inclure toutes les données de
processus au format texte dans le message.
Méthodes de configuration des notifications par courrier électronique
•
Utilisation de LiveCycle Administration Console (reportez-vous à la section Configuration des notifications destinées aux utilisateurs
et aux groupes dans l'Aide à l'administration de LiveCycle ES2.5.)
•
Utilisation de Workbench (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
Enregistrement des informations de tâches terminées
Lorsqu'une tâche est terminée, vous pouvez enregistrer les informations la concernant. Configurez l'opération d'affectation des tâches pour
stocker les informations suivantes dans les variables de processus :
Identification de la tâche : l'identification unique de la tâche créée.
Identification de l'utilisateur : l'identification unique de l'utilisateur ayant réalisé la tâche.
Ces informations peuvent être utilisées plus tard dans le processus si nécessaire. A titre d'exemple, vous pouvez enregistrer l'identification
de l'utilisateur pour lui affecter d'autres tâches dans le processus.
Méthodes d'enregistrement des informations de tâche
•
Utilisation de Workbench (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
ADOBE LIVECYCLE ES2.5
Service Utilisateur
144
Services LiveCycle ES2.5
Interaction avec les tâches
Cette section décrit la marche à suivre pour interagir avec les tâches après leur création. Workbench, LiveCycle Administration Console et
LiveCycle ES2.5 SDK proposent des outils permettant d'interagir avec des tâches.
Remarque : Pour plus de détails sur la manière d'interagir avec les tâches avec Workspace ES2.5, consultez l'Aide de LiveCycle Workbench 9.5.
Réponse aux événements de tâches
LiveCycle Process Management ES2.5 propose plusieurs types d'événements asynchrones à utiliser dans les processus. Vous pouvez ajouter
les reçus ou les points de départ d'événements à vos processus pour répondre aux événements lorsqu'ils surviennent.
Plus de 20 types d'événements sont définis par rapport aux modifications d'état des tâches, comme lorsqu'une tâche est terminée, ou par
rapport à d'autres modifications, comme lorsqu'un fichier est associé à une tâche. Par exemple, lorsqu'une tâche arrive à échéance, le type
d'événement TaskDeadlined est généré. Si un processus utilise l'événement TaskDeadlined comme point de départ, ce processus peut être
appelé au moment où l'événement est généré.
Méthodes de réponse aux événements
•
Utilisation de Workbench (reportez-vous à l'Aide de LiveCycle Workbench 9.5.)
Récupération des informations de tâche
Vous pouvez récupérer les tâches affectées à des utilisateurs spécifiques, puis en récupérer les informations : identification de la tâche, état
et nom du processus auquel elle appartient. Vous pouvez également récupérer un historique de la tâche.
Méthodes de récupération des informations de tâche
•
Utilisation des pages de Process Management ES2.5 dans LiveCycle Administration Console (reportez-vous à l'Aide à l'administration
de LiveCycle ES2.5.)
•
Utilisation de l'API Task Manager Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
Intervention dans l'état des tâches
Vous pouvez intervenir dans la progression normale d'un processus pour corriger les problèmes causés par des circonstances imprévisibles :
•
Affecter des tâches à plusieurs utilisateurs selon vos besoins. Vous pouvez par exemple réaffecter une tâche préalablement affectée à un
utilisateur dont la position a changé dans l'entreprise.
•
Recommencer les tâches bloquées lorsque le problème ayant causé le blocage est corrigé. Au cours d'une opération d'affectation des
tâches, par exemple, l'expression XPath chargée d'affecter la tâche à un utilisateur contenait une erreur de syntaxe. L'erreur a bloqué
toutes les tâches. L'erreur est corrigée puis les tâches sont relancées.
•
Mettre fin à des tâches qui ne sont plus utiles.
Méthodes d'intervention dans l'état des tâches
•
Utilisation des pages de Process Management ES2.5 dans LiveCycle Administration Console (reportez-vous à l’Aide à l’administration
de LiveCycle ES2.5).
•
Utilisation de l'API Task Manager Service (reportez-vous à la section Programmation avec LiveCycle ES2.5).
145
34. Service Variable Logger
Le service Variable Logger permet aux processus d’envoyer des messages sur les valeurs de variable au journal système ou aux fichiers
journaux du système de fichiers du serveur LiveCycle ES2.5. Lorsqu’un processus bloque et ne fonctionne pas comme prévu, cela peut être
dû aux variables de processus qui ne sont pas définies correctement. Le service Variable Logger permet d’assurer le suivi des variables de
processus et d’isoler l’origine du problème.
Utilisation du service Variable Logger
Vous pouvez interagir avec le service Variable Logger en développant un processus dans LiveCycle Workbench utilisant ce service. Lors de
l’utilisation de ce service dans un processus, vous pouvez préciser les options suivantes :
•
•
•
La sortie des messages enregistrés sur les variables de processus vers des ressources système ou bien leur enregistrement dans un fichier.
Le type d’informations consignées dans le cas de la journalisation système.
Le nom et le chemin du fichier journal ou bien une expression XPath pour une variable de processus contenant le nom du fichier et le
chemin en cas de journalisation dans un fichier. Vous pouvez choisir de remplacer le fichier journal s’il existe déjà, de créer un fichier
journal ou de modifier un fichier journal existant.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
146
35. Service Wait Point
Le service Wait Point permet de retarder la progression d’un processus à une étape de ce processus.
Utilisation du service Wait Point
Vous pouvez interagir avec le service Wait Point en développant un processus dans LiveCycle Workbench utilisant ce service. Lorsque vous
utilisez ce service dans un processus afin de retarder l’exécution de la prochaine opération du processus, indiquez la durée d’attente en
choisissant d'utiliser soit un calendrier civil soit un calendrier professionnel :
Calendrier civil : lorsque vous utilisez le calendrier civil, saisissez les valeurs pour le nombre de jours, d'heures, de minutes et de secondes
d'attente.
Calendrier professionnel : lorsque vous utilisez un calendrier professionnel, définissez le nom du calendrier professionnel à utiliser, ainsi
que le nombre de jours ouvrés à attendre. Les calendriers professionnels définissent les jours ouvrés et non ouvrés de votre entreprise (par
exemple, jours fériés, week-ends et jours de fermeture de la société). Lorsque vous utilisez des calendriers professionnels, LiveCycle ES2.5
ignore les jours non ouvrés lors des calculs de la durée d'attente.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
147
36. Service Service Web
Le service Service Web permet aux processus d’appeler les opérations correspondantes. Par exemple, une entreprise peut souhaiter intégrer
un processus pour stocker et récupérer des informations, telles que les détails de contact et de compte, en appelant les services Web exposés
d’un fournisseur de services. Le service Service Web appelle un service Web spécifié et transmet les valeurs de chacun de ses paramètres,
puis enregistre les valeurs de renvoi de l’opération dans une variable désignée d'un processus.
Le service Service Web interagit avec les services Web en envoyant et en recevant des messages SOAP. Il prend également en charge l’envoi
de pièces jointes MIME, MTOM et SwaRef avec des messages SOAP à l’aide du protocole WS-Attachment. Les interactions du service
Service Web sont compatibles avec les systèmes SAP et les services Web .NET.
Utilisation du service Service Web
Vous pouvez interagir avec le service Service Web en développant un processus dans LiveCycle Workbench utilisant ce service. Vous pouvez
exécuter les tâches ci-dessous à l’aide de ce service :
•
Création du message SOAP à envoyer au service Web afin d’appeler une opération de service Web. Après avoir fourni l’URL à la
définition de service Web, vous pouvez sélectionner l’opération de service Web à appeler. En fonction de l’opération sélectionnée, un
modèle du message de requête SOAP est généré. Vous pouvez ensuite insérer des valeurs dans le message comme requis. Le service
Service Web prend en charge le type de données Table, qui peut être nécessaire aux services Web SAP. Une table SAP est semblable à
une table de base de données : elle se compose de colonnes et à chaque ligne correspond un enregistrement.
• Test de la requête d’appel par l'envoi d'un message test et l'affichage du message de réponse envoyé par le service Web.
• Appel d’une opération de service Web et enregistrement de la réponse comme données de processus, y compris des pièces jointes.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
148
37. Service XMP Utilities
Les documents PDF contiennent des métadonnées, qui constituent des informations relatives au document (par opposition au contenu du
document, tel que du texte ou des graphiques). La plate-forme Adobe XMP (eXtensible Metadata Platform) est une norme de gestion des
métadonnées de document.
Le service XMP Utilities permet de récupérer et d’enregistrer les métadonnées XMP des documents PDF et d’importer des métadonnées
XMP dans des documents PDF.
A propos des métadonnées XMP
XMP offre un format standard de création, de traitement et d’échange de métadonnées pour une multitude d’applications. XMP fournit un
modèle représentant les métadonnées. Les métadonnées XMP sont codées sous forme de texte au format XML utilisant le langage RDF
(Resource Description Language, langage de description de ressources) W3C standard.
Dans XMP, les métadonnées désignent un ensemble de propriétés associées à un document. Les métadonnées regroupent des propriétés
telles que l’auteur, le titre et la date de modification d’un document.
Bien que ces propriétés soient parfois associées à des éléments d’un document, le service XMP Utilities ne vous permet pas de manipuler les
métadonnées de ces éléments.
Les propriétés comportent des noms et des valeurs :
•
•
Les noms doivent correspondre à des noms XML valides.
Les valeurs peuvent être des valeurs simples, telles que des nombres et des chaînes, ou des tableaux (également appelés conteneurs).
Toutes les valeurs sont en réalité représentées sous forme de chaînes Unicode.
Pour plus de détails concernant XMP, reportez-vous à la page XMP principalesur le site Web d'Adobe.
A propos des métadonnées des documents PDF
Dans un fichier PDF, les métadonnées peuvent apparaître à deux emplacements :
•
Dans le dictionnaire d’informations du dictionnaire de codes de fin de fichier. Ce dictionnaire contient des informations concernant le
fichier, telles que son titre, son auteur et sa date de création. Ces informations sont stockées sous la forme d’objets PDF tels que des
chaînes et des dates, et non au format XML.
Les utilisateurs Acrobat et Adobe Reader peuvent visualiser les informations de ce dictionnaire par l’intermédiaire des propriétés de
document. Ils peuvent définir certaines de ces propriétés, telles que le titre, l’auteur, le sujet et les mots-clés. En outre, les utilisateurs ont
la possibilité d’ajouter des propriétés personnalisées présentant un nom et une valeur uniques.
•
Dans le dictionnaire de métadonnées du catalogue de documents. Ce dictionnaire contient les métadonnées associées à la totalité d’un
document. Ces informations sont représentées sous forme de métadonnées XMP.
Remarque : les flux individuels d’un document, tels que les images, peuvent également comporter des entrées de métadonnées contenant les
métadonnées XMP associées. Toutefois, le service XMP Utilities ne permet pas de manipuler les métadonnées de ces éléments.
Toutes les métadonnées du dictionnaire d’informations sont également représentées dans le dictionnaire de métadonnées sous la forme de
propriétés de métadonnées XMP. Les propriétés standard, telles que le titre et l’auteur, sont représentées dans XMP par des propriétés
provenant du schéma PDF.
ADOBE LIVECYCLE ES2.5
Service XMP Utilities
149
Services LiveCycle ES2.5
Lorsque le service XMP Utilities lit les métadonnées d’un fichier PDF, il résout les incohérences entre les valeurs du dictionnaire
d’informations et celles des métadonnées XMP :
•
•
•
Si le dictionnaire d’informations est plus récent, ses propriétés sont utilisées pour mettre à jour les métadonnées XMP.
Si les métadonnées XMP sont plus récentes, les propriétés XMP sont utilisées pour mettre à jour le dictionnaire d’informations.
Les propriétés du dictionnaire d’informations qui ne sont pas répertoriées dans la section « Dictionnaire d'informations du document »
de Référence PDF sont associées à l’espace de nom pdfx (« http://ns.adobe.com/pdfx/1.3/ »). Cette association est utilisée lors de la copie
des propriétés entre les référentiels, dans les situations décrites dans les deux premiers points.
Si un document PDF est enregistré, certaines propriétés de métadonnées sont automatiquement mises à jour, notamment xmp:ModifyDate,
xmp:MetadataDate, xapMM:InstanceID et xapMM:DocumentID si cette dernière est manquante. Si vous tentez de modifier ces propriétés,
les valeurs que vous spécifiez seront écrasées.
Utilisation du service XMP Utilities
Vous pouvez exécuter les tâches ci-dessous à l’aide de ce service :
Exportation de métadonnées : exporte les métadonnées depuis un document PDF spécifique que vous pouvez enregistrer sous forme de
données de processus. Le document PDF spécifié peut être stocké sous forme de données de processus ou défini directement comme un
fichier du système de fichiers.
Importation de métadonnées : importe les métadonnées depuis les données de processus et remplace les métadonnées existantes d'un
document PDF spécifié.
Exportation des XMP : disponible dans LiveCycle Workbench uniquement. Exporte les métadonnées sous forme de données XMP depuis
un document PDF spécifié. Vous pouvez enregistrer les métadonnées dans un document PDF sous forme de données de processus ou de
fichier à réutiliser.
Importation des XMP : disponible dans Workbench uniquement. Importe les métadonnées depuis une valeur de document et remplace les
métadonnées existantes d'un document PDF spécifié.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5. Pour plus de
détails sur le développement des applications clientes qui interagissent par programmation avec ce service, reportez-vous à la section
Programmation avec LiveCycle ES2.5.
150
38. \Service XSLT Transformation
Le service XSLT Transformation permet aux processus d’appliquer des transformations XSLT (eXtensible Stylesheet Language
Transformations) aux documents XML.
Utilisation du service XSLT Transformation
Vous pouvez interagir avec le service XSLT Transformation en développant un processus dans LiveCycle Workbench utilisant ce service.
Vous pouvez exécuter les tâches ci-dessous à l’aide de ce service :
•
Configuration du service à l’aide de la classe Java par défaut à utiliser pour exécuter la transformation XSLT. Les propriétés des
opérations du service peuvent remplacer la valeur que vous avez insérée lors de la configuration du service.
•
Transformation d’un document XML à l’aide d’un script XSLT stocké sous forme de données de processus. Le document XML est
également stocké sous forme de données de processus.
•
Transformation d’un document XML à l’aide d’un script XSLT référencé à l’aide d’une URL. Le document XML transformé est stocké
sous forme de données de processus.
• Test de la transformation et affichage des résultats.
• Enregistrement du document XML obtenu sous forme de données de processus.
Pour plus de détails sur le développement de processus utilisant ce service, reportez-vous à l’Aide de LiveCycle Workbench 9.5.
Vous pouvez utiliser les pages Applications and Services de LiveCycle Administration Console pour configurer les propriétés par défaut de
ce service (reportez-vous à la section Paramètres du service XSLT Transformation dans l'Aide à l'administration de LiveCycle ES2.5).
">