APEX und Apache FOP Freie PDF-Erstellung mit APEX 3.0.1

Transkript

1 APEX und Apache FOP Freie PDF-Erstellung mit APEX Dr. Gudrun Pabst Basel Baden Bern Lausanne Zürich Düsseldorf Frankfurt/M. Freiburg i. Br. Hamburg München Stuttgart

2 Agenda Kürzel: XML, XSL, XSLT, XSL-FO, FOP Einrichten von Apache FOP unter APEX Daten sind immer im Spiel. Regionseinstellungen für PDF-Druck Generische Templates Templates mit benannten Spalten Links APEX und Apache FOP

3 Kürzel: XML, XSL, XSLT, XSL-FO XML : Extensible Markup Language Standard zum Strukturieren eines Dokuments durch Tags XPath : Sprache, um auf Teile eines XML-Dokuments zuzugreifen XSL : XSLT : Extensible Stylesheet Language besteht aus zwei Teilen: XSL Transformations eine Sprache zum Transformieren von XML- Dokumenten XSL-FO : XSL Formatting Objects XML-Tags zur Definition von Formatierungsobjekten (Seite, Absätze, Tabellen... ) APEX und Apache FOP

4 Kürzel: Apache FOP : FOP : Formatting Objects Processor Apache FOP Java-Applikation erzeugt aus einem XML-Dokument mit XSL-FO Steuerbefehlen eine Datei mit Druckformatierung (z.b. PDF) Formatierung ist unabhängig vom gewünschten Ausgabe-Format mögliche Ausgabe-Formate aktuell z.b. PDF, PS, RTF und weitere primäres Ausgabe-Ziel ist PDF aktuelle Version : 0.94 (implementiert einen Großteil des XSL-FO Version 1.0 W3C Standard und der XSL-FO Version 1.1 W3C Empfehlung) mit APEX mitgelieferte Version : (letzte Version vor größerer Überarbeitung) APEX und Apache FOP

5 Verarbeitungsablauf XML-Dokument XSL-Stylesheet XSLT-Prozessor PDF-Dokument XSL-FO-Datei Renderer z.b. Apache FOP... PS-Dokument APEX und Apache FOP

6 Agenda Kürzel: XML, XSL, XSLT, XSL-FO, FOP Einrichten von Apache FOP unter APEX Daten sind immer im Spiel. Regionseinstellungen für PDF-Druck Generische Templates Templates mit benannten Spalten Links APEX und Apache FOP

7 Einrichten von Apache FOP unter APEX Einrichten in folgenden Schritten: OC4J (Oracle Containers for J2EE) in einer Version ab installieren ZIP-Datei des OC4J auspacken Umgebungsvariablen ORACLE_HOME (Pfad des OC4J!) und JAVA_HOME setzen, z.b. in Batch-Datei OC4J-Server starten Beim ersten Start Administratorpasswort des OC4J-Servers setzen Enterprise Manager Console des OC4J starten APEX und Apache FOP

8 Einrichten von Apache FOP unter APEX Datei fop.war (bei APEX 3.01 mitgeliefert) deployen APEX und Apache FOP

9 Einrichten von Apache FOP unter APEX Zugriff auf Apache FOP in APEX einrichten: Workspace internal Manage Services Instance Settings Report Printing APEX und Apache FOP

10 Agenda Kürzel: XML, XSL, XSLT, XSL-FO, FOP Einrichten von Apache FOP unter APEX Daten sind immer im Spiel. Regionseinstellungen für PDF-Druck Generische Templates Templates mit benannten Spalten Links APEX und Apache FOP

11 Regionseinstellungen für PDF-Druck Eigenschaften-Seite eines Reports: Print Attributes APEX und Apache FOP

12 Layout-Templates Report Layout : gesteuert über Layout-Templates Zwei Varianten für Layout-Templates: Generic Columns Named Columns Named Columns : auf Spalteninhalte wird über die Namen der Spalten zugegriffen die Ausgabe jeder einzelnen Spalte kann detailliert gesteuert werden das Template wird als Datei hochgeladen Generic Columns jede Spalte wird bis auf die Spaltenbreite gleich ausgeben diese Templates können direkt in APEX bearbeitet werden APEX und Apache FOP

13 Agenda Kürzel: XML, XSL, XSLT, XSL-FO, FOP Einrichten von Apache FOP unter APEX Daten sind immer im Spiel. Regionseinstellungen für PDF-Druck Generische Templates Templates mit benannten Spalten Links APEX und Apache FOP

14 Generische Templates Mitarbeiter-Report im Querformat mit Default-Template: APEX und Apache FOP

15 Generische Templates Mitarbeiter-Report im Hochformat mit Default-Template: APEX und Apache FOP

16 Generische Templates Daher neues Template vom Typ Generic Columns : Tabellenbreite aus Seitenbreite und Rändern errechnen APEX und Apache FOP

17 Agenda Kürzel: XML, XSL, XSLT, XSL-FO, FOP Einrichten von Apache FOP unter APEX Daten sind immer im Spiel. Regionseinstellungen für PDF-Druck Generische Templates Templates mit benannten Spalten Links APEX und Apache FOP

18 Templates mit benannten Spalten Mit generischen Templates nicht möglich: Ausgabe von Master-Detail-Reports Master-Informationen sind aber im übergebenen XML enthalten: <?xml version="1.0" encoding="utf-8"?> <DOCUMENT>... <TITLE>Jobs und Mitarbeiter</TITLE> <P5_JOB_ID>SH_CLERK</P5_JOB_ID> <P5_JOB_TITLE>Sales Representative</P5_JOB_TITLE> <REGION ID=" "> <ROWSET> <ROW> Ausgabe von Bildern Verwendung von Named Columns Templates Zugriff auf Spalten über ihre Namen Wiederverwendbarkeit dadurch nur begrenzt möglich Ausgabe wird für jede Spalte getrennt definiert APEX und Apache FOP

19 Templates mit benannten Spalten Beispiel: Ausgabe von Bildern HTML: PDF (Default-Template): APEX und Apache FOP

20 Templates mit benannten Spalten Named Columns Templates müssen als Datei hochgeladen werden können nicht geändert, nur umbenannt werden müssen bei Änderungen gelöscht und neu angelegt werden ACHTUNG: Bei allen betroffenen Seiten muss das Template wieder eingetragen werden! Anlegen eines Named Columns - Template APEX und Apache FOP

21 Templates mit benannten Spalten Zugehörige XSL-Datei: Zugriff auf die Spalten über ihre Namen <fo:table-cell xsl:use-attribute-sets="cell border"> <fo:block xsl:use-attribute-sets="text align-center"> <xsl:call-template name="bild_einbinden"> <xsl:with-param name="p_url"> <xsl:value-of select=".//flagge"/> </xsl:with-param> </xsl:call-template> </fo:block> </fo:table-cell> <fo:table-cell xsl:use-attribute-sets="cell border"> <fo:block xsl:use-attribute-sets="text align-left"> <fo:inline xsl:use-attribute-sets="body-font"> <xsl:value-of select=".//kuerzel"/> </fo:inline> </fo:block> </fo:table-cell> APEX und Apache FOP

22 Agenda Kürzel: XML, XSL, XSLT, XSL-FO, FOP Einrichten von Apache FOP unter APEX Daten sind immer im Spiel. Regionseinstellungen für PDF-Druck Generische Templates Templates mit benannten Spalten Links APEX und Apache FOP

23 Links W3C-Seiten: XML : XSL : XSL-FO : XSLT : Apache FOP: PDF-Druck in APEX: application_express/html/configure_printing.html APEX und Apache FOP

24 Fragen?? Basel Baden Bern Lausanne Zürich Düsseldorf Frankfurt/M. Freiburg i. Br. Hamburg München Stuttgart