Modifications de LiveCycle ES en

bc
Modifications de LiveCycle® en fonction
de la mise à niveau vers LiveCycle ES 8.2
Adobe® LiveCycle® ES
Juillet 2008
Mise à jour 1
© 2008 Adobe Systems Incorporated. All rights reserved.
Adobe® LiveCycle® ES Update 1 Modifications de LiveCycle en fonction de la mise à niveau vers LiveCycle ES 8.2 pour Microsoft® Windows®
Edition 1.0, juillet 2008
If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished
under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part
of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording,
or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note that the content in this guide is protected
under copyright law even if it is not distributed with software that includes an end user license agreement.
The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as
a commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or
inaccuracies that may appear in the informational content contained in this guide.
Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law.
The unauthorized incorporation of such material into your new work could be a violation of the rights of the copyright owner. Please be sure
to obtain any permission required from the copyright owner.
Any references to company names, company logos and user names in sample material or sample forms included in this documentation
and/or software are for demonstration purposes only and are not intended to refer to any actual organization or persons.
Adobe, le logo Adobe et LiveCycle sont des marques ou des marques déposées d'Adobe Systems Incorporated aux Etats-Unis et/ou dans
d'autres pays.
Java est une marque ou une marque déposée de Sun Microsystems, Inc. aux Etats-Unis et dans d’autres pays.
Microsoft et Windows sont des marques déposées ou des marques de Microsoft Corporation aux Etats-Unis et/ou dans d'autres pays.
All other trademarks are the property of their respective owners.
This product contains either BSAFE and/or TIPEM software by RSA Security, Inc.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
This product includes software developed by the IronSmith Project (http://www.ironsmith.org/).
This product includes software developed by the OpenSymphony Group (http://www.opensymphony.com/).
This product includes software developed by the Indiana University Extreme! Lab (http://www.extreme.indiana.edu/).
This product includes copyrighted software developed by E. Wray Johnson for use and distribution by the Object Data Management Group
(http://www.odmg.org/).
Portions © Eastman Kodak Company, 199- and used under license. All rights reserved. Kodak is a registered trademark and Photo CD is
a trademark of Eastman Kodak Company.
Powered by Celequest. Copyright 2005-2008 Adobe Systems Incorporated. All rights reserved. Contains technology distributed under license
from Celequest Corporation. Copyright 2005 Celequest Corporation. All rights reserved.
Single sign-on, extending Active Directory to Adobe LiveCycle ES provided by Quest Software “www.quest.comlidentity-management”
in a subsequent minor release that is not a bug fix (i.e., version 1.1 to 1.2 but not 1.1.1 to 1.1.2) of the Licensee Product that incorporates the
Licensed Product.
The Spelling portion of this product is based on Proximity Linguistic Technology.
© Copyright 1989, 2004 All Rights Reserved Proximity Technology A Division of Franklin Electronic Publishers, Inc. Burlington,
New Jersey USA.
© Copyright 1990 Merriam-Webster Inc. © Copyright 1990 All Rights Reserved Proximity Technology A Division of Franklin Electronic
Publishers, Inc. Burlington, New Jersey USA.
© Copyright 2003 Franklin Electronic Publishers Inc. © Copyright 2003 All Rights Reserved Proximity Technology A Division of Franklin
Electronic Publishers, Inc. Burlington, New Jersey USA.
© Copyright 2004 Franklin Electronic Publishers, Inc. © Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin
Electronic Publishers, Inc. Burlington, New Jersey USA.
© Copyright 1991 Dr.Lluis de Yzaguirre I Maura © Copyright 1991 All Rights Reserved Proximity Technology A Division of Franklin Electronic
Publishers, Inc. Burlington, New Jersey USA.
© Copyright 1990 Munksgaard International Publishers Ltd. © Copyright 1990 All Rights Reserved Proximity Technology A Division of
Franklin Electronic Publishers, Inc. Burlington, New Jersey USA.
© Copyright 1995 Van Dale Lexicografie bv © Copyright 1996 All Rights Reserved Proximity Technology A Division of Franklin Electronic
Publishers, Inc. Burlington, New Jersey USA.
© Copyright 1990 IDE a.s. © Copyright 1990 All Rights Reserved Proximity Technology A Division of Franklin Electronic Publishers, Inc.
Burlington, New Jersey USA.
© Copyright 2004 Franklin Electronics Publishers, Inc. © Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin
Electronic Publishers, Inc. Burlington, New Jersey USA.
© Copyright 1992 Hachette/Franklin Electronic Publishers, Inc. © Copyright 2004 All Rights Reserved Proximity Technology A Division of
Franklin Electronic Publishers, Inc. Burlington, New Jersey USA.
© Copyright 2004 Bertelsmann Lexikon Verlag © Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin Electronic
Publishers, Inc. Burlington, New Jersey USA.
© Copyright 2004 MorphoLogic Inc. © Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin Electronic
Publishers, Inc. Burlington, New Jersey USA.
© Copyright 1990 Williams Collins Sons & Co. Ltd. © Copyright 1990 All Rights Reserved Proximity Technology A Division of Franklin
Electronic Publishers, Inc. Burlington, New Jersey USA. © Copyright 1993-95 Russicon Company Ltd.
© Copyright 1995 All Rights Reserved Proximity Technology A Division of Franklin Electronic Publishers, Inc. Burlington, New Jersey USA.
© Copyright 2004 IDE a.s. © Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin Electronic Publishers, Inc.
Burlington, New Jersey USA.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
Notice to U.S. Government End Users. The Software and Documentation are “Commercial Items,” as that term is defined at 48 C.F.R. §2.101,
consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48 C.F.R.
§12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable,
the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users
(a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein.
Unpublished-rights reserved under the copyright laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA
95110-2704, USA. For U.S. Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate,
the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974
(38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60,
60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.
1
Mise à niveau de LiveCycle 7.x vers LiveCycle ES 8.2
Cette section répertorie certaines des modifications apportées à votre implémentation Adobe® LiveCycle®
ES (Enterprise Suite) Update 1 à la suite de la mise à niveau de LiveCycle 7.x vers LiveCycle ES 8.2.
Utilisation par LiveCycle ES de Java 5 au lieu de Java 1.4
Java™ 5 diffère de Java 1.4 en termes de code écrit. Java 1.4 risque de ne plus fonctionner s'il est exécuté
dans un environnement Java 5. Java 5 comprend des types de données supplémentaires et certaines
bibliothèques ont été modifiées. Cette modification peut affecter les applications personnalisées, les QPAC
(Quick Process Action Components) personnalisés ou tout autre élément associé écrit en Java 1.4.
Différences concernant les API entre LiveCycle 7.x et LiveCycle ES
Plusieurs API de LiveCycle 7.x ne sont plus prises en charge dans LiveCycle ES et d'autres ont été
légèrement modifiés. Il est possible que les applications personnalisées écrites à l'aide d'une API
de LiveCycle 7.x doivent être mises à jour une fois la mise à niveau terminée. Le document Mise à niveau
des applications vers LiveCycle ES à l'aide d'API répertorie les API rejetées et associe les méthodes
des API de LiveCycle 7.x aux méthodes de LiveCycle ES.
Réassemblage des applications personnalisées à l'aide des nouveaux fichiers JAR clients
En fonction de votre serveur d'applications, il est possible que les applications clientes développées
avec LiveCycle 7.x doivent être réassemblées à l’aide des nouveaux fichiers JAR clients. Reportez-vous
à la section « Mise à niveau des applications clientes » du document Préparation à la mise à niveau
vers LiveCycle ES à partir de la version 7.x.
Mise à jour requise des QPAC personnalisés
Pour continuer à fonctionner correctement, les QPAC personnalisés fournis par Avoka doivent
peut-être être remplacés dans LiveCycle ES par les versions mises à jour. Une fois la mise à niveau
vers LiveCycle ES 8.2 effectuée, déployez les QPAC mis à jour sur le serveur LiveCycle ES. Contactez
votre fournisseur tiers ou vos développeurs avant la mise à niveau, afin de savoir si ces mises à jour
sont nécessaires ou non.
Modifications au niveau des types de variable
Adobe LiveCycle Workflow 7.x prenait en charge une série de types de variable utilisables lors des
définitions des processus. Le type de variable de formulaire est renommé lc7form lors de la mise à niveau
vers LiveCycle ES. La mise à niveau met automatiquement à jour vos processus pour utiliser le nouveau
nom de type de variable. La modification est donc, la plupart du temps, transparente. Toutefois, si vous
utilisez un QPAC personnalisé provenant d'un tiers ou créé en interne et si celui-ci fait explicitement
référence au type de variable de formulaire, il doit être mis à jour pour reconnaître le nouveau nom
lc7form. Le nouveau QPAC doit ensuite être déployé sur le serveur à l'aide d'Adobe LiveCycle
Workbench ES.
4
Adobe LiveCycle ES
Mise à niveau de LiveCycle 7.x vers LiveCycle ES 8.2
Modifications de LiveCycle en fonction de la mise à niveau vers LiveCycle ES 8.2
5
Modifications au niveau des expressions XPath
LiveCycle ES est plus strict que LiveCycle Workflow 7.x concernant le bon formatage des expressions
XPath. Souvent, dans LiveCycle Workflow 7.x, le nombre de parenthèses dans les expressions XPath
n'est pas correct. Cela arrive le plus souvent lorsqu'une fonction concat est utilisée pour des expressions
d'attribution de variables dans une cartographie de processus. Si l'une de vos instances ne comprend
pas le bon nombre de parenthèses ou est incorrecte pour une autre raison, vous devez mettre à jour
manuellement l'expression XPath pour que l'instance fonctionne dans LiveCycle ES.
Non-prise en charge possible des couleurs de police dans Workspace ES
Dans LiveCycle Workflow 7.x, vous pouvez indiquer différentes couleurs de police pour les messages
utilisateur affichés par LiveCycle Form Manager. Cette fonctionnalité existe également dans Adobe
LiveCycle Process Management ES car Adobe LiveCycle Workspace ES peut afficher différentes couleurs
de police. Toutefois, puisque Workspace ES est basé sur Adobe Flex® et LiveCycle Form Manager 7.x
sur HTML, vous devez vous assurer que les couleurs de police sont conformes au format pris en charge
par Flex. Si vous utilisiez le nom réel d'une couleur (bleu, rouge, vert, etc.), vous devez convertir
la référence sous forme hexadécimale afin que Workspace ES puisse afficher la couleur correctement.
Par exemple, vous devez remplacer le bleu par #0000ff, le rouge par #ff0000 et le vert par #00ff00.
Pour les autres couleurs, recherchez la correspondance hexadécimale.
Non-prise en charge des formulaires indépendants dans LiveCycle ES
Les formulaires indépendants ne sont pas pris en charge dans LiveCycle ES et n'apparaissent pas dans
Workspace ES à la suite de la mise à niveau. Seuls Process Management ES et Workspace ES prennent
en charge les formulaires auxquels un processus est associé. Si vous utilisez des formulaires indépendants,
vous devez créer manuellement un flux de production qui permet d'afficher le formulaire
dans Workspace ES. Si, dans LiveCycle Form Manager, vous utilisez des formulaires existant
uniquement sur disque et si aucun processus ne leur est associé, vous devez créer des processus
dans Process Management ES afin que les formulaires apparaissent dans Workspace ES.
Génération de code XHTML, et non CSS2HTML, à la suite d'une mise à niveau
Lorsqu’un flux de production LiveCycle 7.x qui génère du code CSS2HTML est mis à niveau
vers un processus LiveCycle ES à l’aide de l’outil de mise à niveau de processus dans LiveCycle
Workbench ES, le processus mis à niveau génère du code XHTML et non du code CSS2HTML.
Validité par message des paramètres du courrier électronique concernant la notification
des affectations de tâches, des rappels ou des échéances
Dans LiveCycle 7.x, les messages de notification secondaires peuvent être configurés et stockés en tant
que paramètres de serveur LiveCycle Workflow, en ce qui concerne les affectations de tâches avec des
pièces jointes de données de formulaire. Dans LiveCycle ES 8.2, un seul message de notification est stocké
pour chaque type de notification. Lorsque vous mettez à niveau de LiveCycle 7.x vers LiveCycle ES 8.2, seul
le message principal défini pour l'affectation des tâches est déplacé vers les paramètres du courrier
électronique Affectation de tâche, Rappel et Délai. Les messages et paramètres des données de formulaire
ne sont pas déplacés.
Dans LiveCycle ES 8.2, vous pouvez modifier le message de notification des affectations de tâches,
des rappels ou des échéances dans la zone de message principale de la page Process Management ES >
Paramètres du serveur > Notification de tâche de LiveCycle Administration Console. Cette tâche peut être
effectuée après activation ou désactivation de la prise en charge des données dans la notification.
Adobe LiveCycle ES
Mise à niveau de LiveCycle 7.x vers LiveCycle ES 8.2
Modifications de LiveCycle en fonction de la mise à niveau vers LiveCycle ES 8.2
Non-création de nouveau rendu de formulaire par le service PDFMM en cas de modification
mineure
Dans LiveCycle 7.x, le service PDFMM génère un nouveau rendu du formulaire, même s'il s'agit
de modifications mineures. Par exemple, la simple modification des métadonnées XMP du formulaire
déclenche la création d'un nouveau rendu.
Cette activité a pour effet secondaire non documenté de publier les valeurs des données XFA dans le
tableau Champs sous Dictionnaire AcroForm. Dans certains cas, des utilisateurs de LiveCycle 7.x ont
exploité cet effet secondaire en aplatissant tous les formulaires et données avant de les imprimer en tant
que fichiers PDF.
Dans LiveCycle ES 8.2, cet effet secondaire du service PDFMM n'existe plus. Les données XFA ne sont pas
écrites dans le dictionnaire AcroForm à chaque modification. Toutefois, toute application LiveCycle 7.x
basée sur ce comportement non documenté risque de s'arrêter de fonctionner ou de générer une sortie
inattendue.
Pour générer un nouveau rendu du formulaire avant de l'aplatir, utilisez les méthodes
generatePDFOutput ou transformPDF d'Adobe LiveCycle Output ES. Toutefois, si vous devez
générer un nouveau rendu du formulaire afin de déplacer les valeurs des données XFA vers AcroForm,
il n'existe actuellement aucune solution.
6
2
Mise à niveau de LiveCycle ES 8.0.x
vers LiveCycle ES 8.2
Cette section répertorie certaines des modifications apportées à votre implémentation LiveCycle ES
à la suite de la mise à niveau de LiveCycle ES 8.0.x vers LiveCycle ES 8.2.
Validation des processus directement dans l'affichage Résumé de Workspace ES
Dans LiveCycle ES, les utilisateurs finals peuvent valider les étapes d'un processus directement
dans l'affichage Résumé. Cela leur évite de devoir ouvrir le formulaire dans LiveCycle Workspace ES
pour le valider. Si cette fonctionnalité n'est pas appropriée aux processus de votre entreprise, vous pouvez
la désactiver dans LiveCycle Workbench ES.
➤ Pour activer la validation dans l'affichage Résumé :
1. Ouvrez une session sur Workbench ES.
2. Sélectionnez l'opération Attribuer une tâche dans votre schéma de processus.
3. Dans l'affichage Propriétés, développez le groupe de propriétés Mappages des données
de formulaire.
4. Sélectionnez Formulaire à enregistrer.
Modifications apportées à l'utilisation d'une API Repository Service dans les composants
personnalisés
Dans LiveCycle ES 8.0.x, les classes clientes du Référentiel LiveCycle ES étaient disponibles de manière
globale dans le chargeur de classes EAR racine. Les clients Java côté serveur (composants personnalisés)
n'avaient pas besoin de déclarer une dépendance explicite aux classes clientes. Cette conception a été
améliorée dans LiveCycle ES 8.2. Les clients Java côté serveur doivent à présent importer explicitement
les classes clientes de Référentiel LiveCycle ES à partir du service Repository. Lorsqu'il s'agit d'un
composant personnalisé, il suffit d'ajouter plusieurs directives <package...> au fichier component.xml
du composant.
Un composant personnalisé développé pour LiveCycle ES 8.0.x est associé s'il dépend des classes du client
Référentiel LiveCycle ES disponible de manière globale. Cela signifie que le composant a réussi à appeler
le service Repository et que les deux conditions suivantes sont réunies :
●
Le fichier component.xml du composant ne contient pas les directives <import-package>
ci-dessous.
●
Le composant ne contient pas le fichier adobe-repository-client.jar et déclare ce fichier JAR dans sa
directive <class-path> du fichier component.xml.
Avec LiveCycle ES 8.2, tout composant personnalisé qui appelle le service Repository doit inclure
les directives <import-package> dans son fichier component.xml.
➤ Pour mettre à jour les composants personnalisés LiveCycle ES 8.0.x :
1. Localisez le fichier jar du composant.
2. Extrayez le contenu du composant vers un dossier temporaire.
7
Adobe LiveCycle ES
Mise à niveau de LiveCycle ES 8.0.x vers LiveCycle ES 8.2
Modifications de LiveCycle en fonction de la mise à niveau vers LiveCycle ES 8.2
3. Ouvrez le fichier [DossierTemporaire]/component.xml dans un éditeur de texte :
●
Ajoutez la directive <import-packages> si elle n'existe pas déjà.
●
Ajoutez le code suivant à la directive <import-packages> :
<package version="1.0">org.apache.commons.codec</package>
<package version="1.0">org.apache.commons.codec.binary</package>
<package version="1.0">com.adobe.uuid</package>
<package version="1.0">com.adobe.repository.logging</package>
<package version="1.0">com.adobe.repository.io</package>
<package version="1.0">com.adobe.repository.infomodel</package>
<package version="1.0">com.adobe.repository.infomodel.bean</package>
<package version="1.0">com.adobe.repository.query</package>
<package version="1.0">com.adobe.repository.query.sort</package>
<package version="1.0">com.adobe.repository.bindings</package>
<package version="1.0">com.adobe.repository.bindings.dsc</package>
<package
version="1.0">com.adobe.repository.bindings.dsc.client</package>
<package version="1.0">com.adobe.repository</package>
●
Localisez la directive <class-path> et supprimez la référence
à adobe-repository-client.jar.
●
Enregistrez et fermez le fichier component.xml.
4. Supprimez le fichier adobe-repository-client.jar de [DossierTemporaire].
5. Réassemblez et redéployez le composant.
➤ Pour créer des composants personnalisés pour LiveCycle ES 8.2 :
1. Ouvrez le fichier component.xml dans un éditeur de texte.
2. Ajoutez la directive <import-packages> si elle n'existe pas déjà.
3. Ajoutez le code suivant à la directive <import-packages> :
<package version="1.0">org.apache.commons.codec</package>
<package version="1.0">org.apache.commons.codec.binary</package>
<package version="1.0">com.adobe.uuid</package>
<package version="1.0">com.adobe.repository.logging</package>
<package version="1.0">com.adobe.repository.io</package>
<package version="1.0">com.adobe.repository.infomodel</package>
<package version="1.0">com.adobe.repository.infomodel.bean</package>
<package version="1.0">com.adobe.repository.query</package>
<package version="1.0">com.adobe.repository.query.sort</package>
<package version="1.0">com.adobe.repository.bindings</package>
<package version="1.0">com.adobe.repository.bindings.dsc</package>
<package
version="1.0">com.adobe.repository.bindings.dsc.client</package>
<package version="1.0">com.adobe.repository</package>
4. Assurez-vous que la directive <class-path> ne fait pas référence au fichier
adobe-repository-client.jar.
8
Adobe LiveCycle ES
Mise à niveau de LiveCycle ES 8.0.x vers LiveCycle ES 8.2
Modifications de LiveCycle en fonction de la mise à niveau vers LiveCycle ES 8.2
5. Enregistrez et fermez le fichier component.xml.
6. Développez et déployez votre composant comme à votre habitude.
Remarque : n'ajoutez aucune référence au fichier adobe-repository-client.jar dans votre CLASS PATH.
Non-nécessité du symbole * pour les données de la variable xfaForm
Il existait un problème connu dans LiveCycle ES 8.0.1 qui causait des erreurs d'exécution lors du transfert
de données d'un processus parent à un sous-service. La solution recommandée était d'ajouter une
astérisque (*) lors de la réattribution des données de la variable xfaForm.
Par exemple, dans SetValue, saisissez cette instruction :
/process_data/secondForm/object/data/xdp/datasets/data=/process_data/
firstForm/object/data/xdp/datasets/data/*,
où firstForm et secondForm sont des variables xfaForm.
Ce problème est résolu dans LiveCycle ES 8.0.1 SP1 . La solution précédente n'est plus nécessaire.
Elle ne fonctionne d'ailleurs plus. Vous devez donc supprimer l'astérisque. La bonne instruction est
la suivante :
/process_data/secondForm/object/data/xdp/datasets/data=/process_data/
firstForm/object/data/xdp/datasets/data
9