bbc Änderungen in LiveCycle nach der Aktualisierung auf LiveCycle ES 8.2 Adobe LiveCycle ES Juli 2008 Update 1

Transkript

1 bbc Änderungen in LiveCycle nach der Aktualisierung auf LiveCycle ES 8.2 Adobe LiveCycle ES Juli 2008 Update 1

2 2008 Adobe Systems Incorporated. All rights reserved. Adobe LiveCycle ES Update 1 Änderungen in LiveCycle nach der Aktualisierung auf LiveCycle ES 8.2 für Microsoft Windows Ausgabe 1.0, Juli 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, the Adobe logo, and LiveCycle are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Java is a trademark or registered trademark of Sun Microsystems, Inc. in the United States and other countries. Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. 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 ( This product includes software developed by the IronSmith Project ( This product includes software developed by the OpenSymphony Group ( This product includes software developed by the Indiana University Extreme! Lab ( This product includes copyrighted software developed by E. Wray Johnson for use and distribution by the Object Data Management Group ( 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 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 in a subsequent minor release that is not a bug fix (i.e., version 1.1 to 1.2 but not 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 Copyright 2003 Franklin Electronic Publishers Inc. Copyright 2003 All Rights Reserved Proximity Technology A Division of Franklin Electronic Copyright 2004 Franklin Electronic Publishers, Inc. Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin Electronic Copyright 1991 Dr.Lluis de Yzaguirre I Maura Copyright 1991 All Rights Reserved Proximity Technology A Division of Franklin Electronic Copyright 1990 Munksgaard International Publishers Ltd. Copyright 1990 All Rights Reserved Proximity Technology A Division of Franklin Electronic Copyright 1995 Van Dale Lexicografie bv Copyright 1996 All Rights Reserved Proximity Technology A Division of Franklin Electronic

3 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 Copyright 1992 Hachette/Franklin Electronic Publishers, Inc. Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin Electronic Copyright 2004 Bertelsmann Lexikon Verlag Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin Electronic Copyright 2004 MorphoLogic Inc. Copyright 2004 All Rights Reserved Proximity Technology A Division of Franklin Electronic Copyright 1990 Williams Collins Sons & Co. Ltd. Copyright 1990 All Rights Reserved Proximity Technology A Division of Franklin Electronic Copyright Russicon Company Ltd. Copyright 1995 All Rights Reserved Proximity Technology A Division of Franklin Electronic 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 , consisting of Commercial Computer Software and Commercial Computer Software Documentation, as such terms are used in 48 C.F.R or 48 C.F.R , as applicable. Consistent with 48 C.F.R or 48 C.F.R through , 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 , 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, , and The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.

4 1 Aktualisieren von LiveCycle 7.x auf LiveCycle ES 8.2 In diesem Abschnitt werden einige der Änderungen aufgeführt, die Sie in Ihrer Adobe LiveCycle ES (Enterprise Suite) Update 1-Implementierung feststellen werden, nachdem Sie von LiveCycle 7.x auf LiveCycle ES 8.2 aktualisiert haben. LiveCycle ES verwendet Java 5 anstelle von Java 1.4. Java 5 unterscheidet sich von Java 1.4 in einem Maß, dass in Java 1.4 geschriebener Code bei Ausführung in einer Java 5-Umgebung nicht mehr funktioniert. Java 5 enthält einige zusätzliche Datentypen und einige Bibliotheken wurden geändert. Diese Änderung kann sich auf benutzerdefinierte Anwendungen, benutzerdefinierte QPACs (Quick Process Action Components) sowie andere in Java 1.4 geschriebene Zusätze auswirken. API-Unterschiede zwischen LiveCycle 7.x und LiveCycle ES Einige LiveCycle 7.x-APIs werden in LiveCycle ES nicht mehr unterstützt und andere wurden leicht geändert. Benutzerdefinierte Anwendungen, die mithilfe der LiveCycle 7.x-API geschrieben wurden, müssen eventuell im Anschluss an den Aktualisierungsprozess aktualisiert werden. In dem Dokument Aktualisieren von Anwendungen auf LiveCycle ES mithilfe von APIs werden nicht mehr unterstützte APIs aufgeführt und LiveCycle 7.x-API-Methoden den LiveCycle ES-Methoden zugeordnet. Neupacken von benutzerdefinierten Anwendungen mit neuen JAR-Clientdateien Mit LiveCycle 7.x entwickelte Clientanwendungen müssen eventuell in Abhängigkeit vom Anwendungsserver mit neuen JAR-Clientdateien gepackt werden. Siehe Aktualisieren von Clientanwendungen in Vorbereiten der Aktualisierung auf LiveCycle ES von 7.x. Benutzerdefinierte QPACs erfordern Aktualisierung Von Avoka bereitgestellte benutzerdefinierte QPACs müssen in LiveCycle ES eventuell durch aktualisierte Versionen ersetzt werden, damit sie weiterhin ordnungsgemäß funktionieren. Im Anschluss an die Aktualisierung auf LiveCycle ES 8.2 stellen Sie die aktualisierten QPACs auf dem LiveCycle ES-Server bereit. Überprüfen Sie vor der Aktualisierung bei Ihrem Drittanbieter oder mit Ihren Entwicklern, ob solche Aktualisierungen erforderlich sind. Änderungen bei Variablentypen Adobe LiveCycle Workflow 7.x hat eine Reihe von Variablentypen unterstützt, die in Prozessdefinitionen verwendet werden können. Der Variablentyp form wird bei einer Aktualisierung auf LiveCycle ES in lc7form umbenannt. Durch die Aktualisierung werden Ihre Prozesse automatisch so aktualisiert, dass der neue Variablentypname verwendet wird, weshalb die Änderung in den meisten Fällen transparent ist. Wenn Sie aber eine benutzerdefinierte QPAC eines Drittanbieters verwenden oder eine intern erstellt haben, die explizit auf den Variablentyp form verweist, muss die QPAC aktualisiert werden, damit stattdessen der Variablentypname lc7form erkannt wird. Die neue QPAC muss dann von Adobe LiveCycle Workbench ES aus auf dem Server bereitgestellt werden. 4

5 Adobe LiveCycle ES Aktualisieren von LiveCycle 7.x auf LiveCycle ES 8.2 Änderungen in LiveCycle nach der Aktualisierung auf LiveCycle ES Änderungen bei XPath-Ausdrücken Die Anforderungen von LiveCycle ES an die korrekte Bildung von XPath-Ausdrücken ist strikter als in LiveCycle Workflow 7.x. In vielen Fällen verfügen XPath-Ausdrücke in LiveCycle Workflow 7.x nicht über die richtige Anzahl von Klammern. Der häufigste Fall ist, wenn die Funktion concat innerhalb eines Variablenzuweisungsausdrucks innerhalb einer Prozesszuordnung verwendet wird. Bei einer Instanz, die nicht die richtige Anzahl von Klammern besitzt oder anderweitig nicht ordnungsgemäß ist, müssen Sie den XPath-Ausdruck manuell aktualisieren, damit er in LiveCycle ES funktioniert. Möglicherweise in Workspace ES nicht unterstützte Schriftfarben In LiveCycle Workflow 7.x konnten in den von LiveCycle Form Manager angezeigten Benutzernachrichten verschiedene Schriftfarben angegeben werden. Diese Feature ist auch in Adobe LiveCycle Process Management ES vorhanden, weil Adobe LiveCycle Workspace ES unterschiedliche Schriftfarben anzeigen kann. Da aber Workspace ES auf Adobe Flex basiert und LiveCycle Form Manager 7.x auf HTML basiert, müssen Sie sicherstellen, dass Schriftfarben dem von Flex unterstützten Format entsprechen. Wenn bisher der echte Name einer Farbe verwendet wurde, wie z. B. Blau, Rot oder Grün, müssen diese Farbverweise nun in die Hexadezimaldarstellung konvertiert werden, damit Workspace ES die Farbe richtig darstellen kann. So wird beispielsweise Blau zu #0000ff, Rot zu #ff0000 und Grün zu #00ff00. Für andere Farben müssen Sie zuerst deren Hexadezimaldarstellung ermitteln. Freie Formulare werden in LiveCycle ES nicht unterstützt. Freie Formulare werden in LiveCycle ES nicht unterstützt und werden nach der Aktualisierung auch nicht in Workspace ES angezeigt. Process Management ES und Workspace ES unterstützen nur Formulare, denen ein Prozess zugeordnet ist. Wenn bisher freie Formulare verwendet wurden, müssen Sie einen Workflow erstellten, der die Anzeige des Formulars in Workspace ES ermöglicht. Wenn Sie Formulare in LiveCycle Form Manager verwenden, die nur auf dem Datenträger vorhanden sind, ohne dass ihnen ein Prozess zugeordnet ist, müssen Sie in Process Management ES Prozesse erstellen, damit die Formulare in Workspace ES angezeigt werden. Aktualisierte Prozesse geben XHTML anstelle von CSS2HTML aus Wenn ein LiveCycle 7.x-Workflow, der CSS2HTML erzeugt, mit dem Prozessaktualisierungs-Tool in LiveCycle Workbench ES in einen LiveCycle ES-Prozess aktualisiert wird, gibt der aktualisierte Prozess XHTML anstatt CSS2HTML aus. -Einstellungen für die Benachrichtigung bei Aufgabenzuweisung, Erinnerung oder Termin behalten nur eine Nachricht In LiveCycle 7.x konnten sekundäre Benachrichtigungen konfiguriert und unter LiveCycle Workflow-Servereinstellungen für Aufgabenzuweisungen mit Formulardatenanlagen gespeichert werden. In LiveCycle ES 8.2 wird nur eine einzige Benachrichtigung für jeden Benachrichtigungstyp gespeichert. Wenn Sie von LiveCycle 7.x auf LiveCycle ES 8.2 aktualisieren, wird nur die Hauptnachrichtengruppe für Aufgabenzuweisungen für die -Einstellungen Aufgabenzuweisung, Erinnerung und Termin migriert. Nachrichten und Einstellungen für Formulardaten werden nicht migriert. In LiveCycle ES 8.2 können Sie die Nachricht für Benachrichtigungen bei Aufgabenzuweisung, Erinnerung und Termin im Hauptnachrichtenfeld auf der Seite Process Management ES > Servereinstellungen > Aufgabenbenachrichtigung der LiveCycle Administration Console ändern. Diese Aufgabe kann durchgeführt werden, nachdem die Datenunterstützung in der Benachrichtigung aktiviert oder deaktiviert wurde.

6 Adobe LiveCycle ES Aktualisieren von LiveCycle 7.x auf LiveCycle ES 8.2 Änderungen in LiveCycle nach der Aktualisierung auf LiveCycle ES Der PDFMM-Dienst gibt Formulare bei kleineren Änderungen nicht neu wieder In LiveCycle 7.x gab der PDFMM-Dienst auch bei kleinen Änderungen ein Formular neu wieder. Beispielsweise löste das bloße Ändern der XMP-Metadaten des Formulars eine erneute Wiedergabe aus. Diese Aktivität hatte den nicht dokumentierten Nebeneffekt, dass Datenwerte aus XFA-Daten in das Fields-Array unter dem AcroForm-Lexikon übertragen wurden. In wenigen Fällen haben LiveCycle 7.x-Benutzer diesen Nebeneffekt ausgenutzt, um alle Formulare und Daten vor dem Senden zum Ausdrucken als PDF-Dateien zu reduzieren. In LiveCycle ES 8.2 tritt dieser Seiteneffekt des PDFMM-Dienstes nicht mehr auf. Die XFA-Daten werden nicht für jede Änderung in das AcroForm-Lexikon geschrieben. Daher funktionieren LiveCycle 7.x-Anwendungen, die dieses undokumentierte Feature nutzen, möglicherweise nicht mehr oder erzeugen unerwartete Ausgaben. Um das Formular vor der Reduzierung einfach neu auszugeben, verwenden Sie die Methode generatepdfoutput oder transformpdf aus Adobe LiveCycle Output ES. Wenn Sie aber das Formular speziell zum Übertragen von Datenwerten aus XFA in AcroForms neu wiedergeben möchten, gibt es hierfür zurzeit keine Methode.

7 2 Aktualisieren von LiveCycle ES 8.0.x auf LiveCycle ES 8.2 In diesem Abschnitt werden einige der Änderungen aufgeführt, die Sie in Ihrer LiveCycle ES- Implementierung feststellen werden, nachdem Sie von LiveCycle ES 8.0.x auf LiveCycle ES 8.2 aktualisiert haben. Prozesse können direkt in der Ansicht Zusammenfassung von Workspace ES genehmigt werden In LiveCycle ES können Endbenutzer Schritte in einem Prozess direkt in der Ansicht Zusammenfassung genehmigen, weshalb das Formular nicht mehr in LiveCycle Workspace ES geöffnet werden muss, um es zu genehmigen. Wenn dieses Feature für die Geschäftsprozesse Ihrer Organisation ungeeignet ist, kann es in LiveCycle Workbench ES deaktiviert werden. So aktivieren Sie die Genehmigung in der Ansicht Zusammenfassung : 1. Melden Sie sich an der Workbench ES an. 2. Wählen Sie den Vorgang Aufgabe zuweisen im Prozessdiagramm. 3. Erweitern Sie in der Ansicht Eigenschaften die Eigenschaftengruppe Form Data Mappings. 4. Aktivieren Sie Form Must Be Saved. Änderungen an der Art der Verwendung der Repository-Dienst-API in benutzerdefinierten Komponenten In LiveCycle ES 8.0.x waren die LiveCycle ES Repository-Clientklassen global im Stamm-EAR-Classloader verfügbar. Serverseitige Java-Clients (benutzerdefinierte Komponenten) mussten keine explizite Abhängigkeit von den Clientklassen deklarieren. Dieses Design wurde in LiveCycle ES 8.2 verbessert, da serverseitige Java-Clients die LiveCycle ES Repository-Clientklassen jetzt explizit aus dem Repository-Dienst importieren müssen. Für eine benutzerdefinierte Komponente werden hierzu der Datei component.xml der Komponente mehrere <package...>-anweisungen hinzugefügt. Eine für LiveCycle ES 8.0.x entwickelte benutzerdefinierte Komponente ist betroffen, wenn sie von den global verfügbaren LiveCycle ES Repository-Clientklassen abhängig ist Das heißt, dass die Komponente den Repository-Dienst erfolgreich aufruft und beide der folgenden Bedingungen erfüllt sind: Die Datei component.xml der Komponente enthält nicht die unten beschriebenen <import-package>-anweisungen. Die Komponente umfasst nicht die Datei adobe-repository-client.jar und deklariert diese JAR-Datei auch nicht in der <class-path>-anweisung in ihrer Datei component.xml. In LiveCycle ES 8.2 muss jede benutzerdefinierte Komponente, die den Repository-Dienst aufruft, die <import-packages>-anweisungen in ihrer jeweiligen Datei component.xml enthalten. So aktualisieren Sie benutzerdefinierte LiveCycle ES 8.0.x-Komponenten: 1. Suchen Sie die JAR-Datei der Komponente. 2. Extrahieren Sie den Inhalt der Komponente in einen temporären Ordner. 7

8 Adobe LiveCycle ES Aktualisieren von LiveCycle ES 8.0.x auf LiveCycle ES 8.2 Änderungen in LiveCycle nach der Aktualisierung auf LiveCycle ES Öffnen Sie [temporärerordner]/component.xml in einem Editor: Fügen Sie die <import-packages>-anweisung hinzu, wenn sie noch nicht vorhanden ist. Fügen Sie der <import-packages>-anweisung den folgenden Code hinzu: <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> Suchen Sie die <class-path>-anweisung und entfernen Sie den Verweis auf adobe-repository-client.jar. Speichern und schließen Sie die Datei component.xml. 4. Löschen Sie adobe-repository-client.jar im Verzeichnis [temporärerordner]. 5. Packen Sie die Komponente neu und stellen Sie sie erneut bereit. So erstellen Sie benutzerdefinierte Komponenten für LiveCycle ES 8.2: 1. Öffnen Sie component.xml in einem Editor. 2. Fügen Sie die <import-packages>-anweisung hinzu, wenn sie noch nicht vorhanden ist. 3. Fügen Sie der <import-packages>-anweisung den folgenden Code hinzu: <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. Stellen Sie sicher, dass die <class-path>-anweisung nicht auf adobe-repository-client.jar verweist.

9 Adobe LiveCycle ES Aktualisieren von LiveCycle ES 8.0.x auf LiveCycle ES 8.2 Änderungen in LiveCycle nach der Aktualisierung auf LiveCycle ES Speichern und schließen Sie die Datei component.xml. 6. Entwickeln Sie die Komponenten wie gewohnt und stellen Sie sie ebenso bereit. Hinweis: Fügen Sie Ihrem CLASSPATH keinen Verweis auf die Datei adobe-repository-client.jar hinzu. xfaform-variablendaten erfordern kein * mehr In LiveCycle ES bestand ein bekanntes Problem, das zu Laufzeitfehlern führte, wenn Daten von einem übergeordneten Prozess an einen Unterdienst übergeben wurden. Zur Behebung wurde empfohlen, bei der Neuzuweisung der xfaform-variablendaten ein Sternchen (*) zuzuweisen. Verwenden Sie beispielsweise in SetValue folgende Anweisung: /process_data/secondform/object/data/xdp/datasets/data=/process_data/ firstform/object/data/xdp/datasets/data/*, wobei firstform und secondform xfaform-variablen sind. Das Problem wurde in LiveCycle ES SP1 behoben und die vorläufige Lösung ist nicht mehr erforderlich, bzw. sie funktioniert nicht mehr, sodass das Sternchen gelöscht werden muss. Die richtige Anweisung lautet wie folgt: /process_data/secondform/object/data/xdp/datasets/data=/process_data/ firstform/object/data/xdp/datasets/data