Stand: Februar 2014
Impressum ab-data GmbH & Co. KG Kommunale Systemlösungen Friedrichstraße 55 42551 Velbert Telefon 02051 944-0 Telefax 02051 944-288 e-mail info@ab-data.de Internet www.ab-data.de Alle Rechte vorbehalten. Diese Dokumentation und die darin enthaltenen Programme sind urheberrechtlich geschützte Erzeugnisse der ab-data GmbH & Co. KG, Velbert. Die teilweise oder vollständige Vervielfältigung ist nur mit schriftlicher Genehmigung der ab-data GmbH & Co. KG zulässig. Copyright ab-data GmbH & Co. KG Änderungen vorbehalten. Stand 25.02.2014 Datei Installation_Blockdruck_WEB.docx Kontakt Unsere regulären Hotline-Zeiten sind: Montag bis Donnerstag jeweils von 8 Uhr bis 12 Uhr und von 13 Uhr bis 16 Uhr sowie Freitag von 8 Uhr bis 12 Uhr und von 13 Uhr bis 14 Uhr. Unsere Mitarbeiter erreichen Sie unter folgenden Rufnummern: Haushalts-/Kassen-/Rechnungswesen 02051/944-561 Steuern und Abgaben 02051/944-562 Einwohnermeldewesen 02051/944-563 Doppik 02051/944-564 Kostenrechnung / Anlagenbuchhaltung 02051/944-565 Technik 02051/944-566 Discoverer 02051/944-567 Zusätzlich steht Ihnen unser geschützter Kunden-Login Bereich auf unserer Internetseite zur Verfügung. Seite 2 von 11
Inhaltsverzeichnis 1 Voraussetzungen... 4 2 Ordnerinformationen des ab-data Verzeichnisses... 4 2.1 Ordner JAVA... 4 2.2 Ordner Blockdruck... 4 3 Umgebungsvariablen für Blockdruck... 5 3.1 Windows IAS 10... 5 3.2 Windows Web 11... 5 3.3 Unix 10... 6 3.4 Linux 10... 6 3.5 Linux 11... 6 4 Betrieb in einem Rechenzentrum... 7 4.1 Einrichtung für den IAS-Server... 7 4.2 Anpassung des Schlüsseleintrages... 8 5 Fehlerhafte Darstellung von Dokumenten im Querformat... 9 5.1 Fehlerbeschreibung... 9 5.2 Fehlerbehebung... 10 Seite 3 von 11
1 Voraussetzungen Für das Ausführen des Blockdruck muss am WEB-Server JAVA Runtime Environment ab Version 1.6 installiert sein. Wir empfehlen für weitere Funktionalitäten die Verwendung einer aktuellen Version 1.6. oder 1.7. 2 Ordnerinformationen des ab-data Verzeichnisses 2.1 Ordner JAVA In dem Ordner JAVA im ab-data-verzeichnis liegen folgende Dateien: - abdata.jar (Datei für das Zusammenführen der einzelnen PDF-Dateien) - ABD_PrintPDF (Datei für den Direktdruck) 2.2 Ordner Blockdruck Bei dem Ordner Blockdruck handelt es sich um den Standardordner zum Erzeugen der PDF-Datei aus dem Verfahren. Hier werden die einzelnen PDF-Dateien erzeugt und anschließend zusammengeführt. Für den Blockdruck des Haushaltsplans muss im Ordner Blockdruck ein Unterverzeichnis ANLAGEN erstellt werden, das für einen vom Kunden erstellten Vorbericht sowie Anlagen vorgesehen ist. Einzelheiten entnehmen Sie bitte der fachlichen Dokumentation. Die Dateinamen in diesem Ordner müssen (bei Verwendung) dem folgenden Muster entsprechen: [MAN_NR]_[ANW_NR]_VORBERICHT_[XYZ].pdf (Beispiel: 301_00_VORBERICHT_HPR.pdf) [MAN_NR]_[ANW_NR]_ANLAGEN_[XYZ].pdf (Beispiel: 301_00_ANLAGEN_JRR.pdf) Für [XYZ] setzen Sie bitte das Kürzel für den entsprechenden Blockdruck ein. Mögliche Werte sind: JRR... Jahresrechnung HPR... Haushaltsplan PBR... Doppischer Blockdruck Es ist kein Vorbericht bzw. keine Anlage für den Tagesabschluss vorgesehen. Seite 4 von 11
3 Umgebungsvariablen für Blockdruck Je nach eingesetztem Betriebssystem müssen folgende Änderungen durchgeführt werden. 3.1 Windows IAS 10 Der Blockdruck benötigt eine Umgebungsvariable für die Erstellung der Dateien. Es handelt sich um einen Eintrag in der Datei..\oracle\ias\fr\forms\server\abdata.env. Bitte ergänzen Sie die Variable ABD_JRE und verweisen Sie auf den Bin-Ordner der lokal am Server installierten JRE_Installation Beispiel: ABD_JRE=C:\Programme\Java\jre6\bin In der Datei..\oracle\ias\fr\forms\server\forms.conf muss folgender Eintrag angepasst werden: Aliasmatch ^/blockdruck/(..*) c:\abdata10\blockdruck/$1 Bitte kontrollieren Sie, ob der angegebene Pfad auf Ihr abdata10-verzeichnis in den Ordner Blockdruck verweist. 3.2 Windows Web 11 Der Blockdruck benötigt eine Umgebungsvariable für die Erstellung der Dateien. Es handelt sich dabei um Einträge in den Dateien abdata.env und forms.conf. Öffnen Sie für die Anpassungen bitte den ABD_WebAdmin und wählen anschließend den Punkt 2 Schnellzugriffe aus. Geben Sie nun eine eins für den Punkt abdata.env ein und es öffnet sich der Notepad++ Editor. Anschließend tragen Sie in Zeile 18 unter ABD_JRE den Pfad des Bin-Ordners der lokal am Web-Server installierten JRE-Installation ein. Beispiel: ABD_JRE=C:\Programme\Java\jre6\bin Jetzt muss die Datei gespeichert und der Editor geschlossen werden, sodass Sie sich wieder in der Schnellübersicht befinden. Nun wählen Sie Punkt 2 forms.conf aus und bearbeiten den Eintrag in Zeile 20 AliasMatch /blockdruck/(..*) c:\abdata11\blockdruck/$1 Bitte kontrollieren Sie, ob der angegebene Pfad auf Ihr abdata11-verzeichnis in den Ordner Blockdruck verweist. (z.b. C:\abdata11\blockdruck\) Nachdem der Eintrag kontrolliert wurde, kann die Datei gespeichert und geschlossen werden. Wählen Sie nun zwei mal x um den ABD_Webadmin zu beenden. Seite 5 von 11
3.3 Unix 10 Der Blockdruck benötigt eine Umgebungsvariable für die Erstellung der Dateien. Es handelt sich um einen Eintrag in den beiden Dateien $ORACLE_HOME/forms/server/abdata.env.profile des Oracle Installationsusers Bitte ergänzen Sie die Variable ABD_JRE und verweisen Sie auf den Bin-Ordner der JRE_Installation Beispiel: ABD_JRE=/opt/java/jre6/bin In der Datei $ORACLE_HOME/forms/server/forms.conf muss folgender Eintrag angepasst werden: Aliasmatch ^/blockdruck/(..*) /oradev/abdata/blockdruck/$1 Bitte kontrollieren Sie, ob der angegebene Pfad auf Ihr abdata10-verzeichnis in den Ordner Blockdruck verweist. Führen Sie bitte den folgenden Befehl im Verzeichnis /oradev/abdata/ JAVA bzw. $ABDATA/JAVA aus: chmod +x * 3.4 Linux 10 Der Blockdruck benötigt eine Umgebungsvariable für die Erstellung der Dateien. Es handelt sich um einen Eintrag in den beiden Dateien $ORACLE_HOME/forms/server/abdata.env.profile des Oracle Installationsusers Bitte ergänzen Sie die Variable ABD_JRE und verweisen Sie auf den Bin-Ordner der JRE_Installation Beispiel: ABD_JRE=/opt/java/jre6/bin In der Datei $ORACLE_HOME/forms/server/forms.conf muss folgender Eintrag angepasst werden: Aliasmatch ^/blockdruck/(..*) /oradev/abdata/blockdruck/$1 Bitte kontrollieren Sie, ob der angegebene Pfad auf Ihr abdata10-verzeichnis in den Ordner Blockdruck verweist. Führen Sie bitte den folgenden Befehl im Verzeichnis /oradev/abdata/ JAVA bzw. $ABDATA/JAVA aus: chmod +x * 3.5 Linux 11 Der Blockdruck benötigt eine Umgebungsvariable für die Erstellung der Dateien. Bitte melden Sie sich dazu zuerst als User oracle an. Navigierung Sie im Terminal zu /home/oracle/abdata11/abd_webadmin. In diesem Ordner befindet sich die Dateien edit_abdata.env und edit_forms.conf. Rufen Sie zuerst die edit_abdata.env auf, die entsprechende Datei öffnet sich nun im Vi-Editor innerhalb des Terminals. Anschließend tragen Sie unter ABD_JRE den Pfad des Bin-Ordners der JRE-Installation ein. Beispiel: ABD_JRE=/usr/lib/jvm/jdk1.6.0_34/bin Speichern Sie nun die Dateien und beenden Sie den Vi. Als nächsten rufen Sie bitte die Datei edit_forms.conf auf und bearbeiten den Eintrag Aliasmatch ^/blockdruck/(..*) /oradev/abdata/blockdruck/$1. Bitte kontrollieren Sie, ob der angegebene Pfad auf Ihr abdata11-verzeichnis in den Ordner Blockdruck verweist. Speichern Sie bitte auch hier die Dateien und beenden Sie den Vi. Sie können das Terminal nun schließen. Seite 6 von 11
4 Betrieb in einem Rechenzentrum Bei einem Betrieb der Anwendung über ein Rechenzentrum (ab-data als Web-Anwendung) haben Sie die Möglichkeit verschiedene Pfade für den Blockdruck-Ordner anzugeben. 4.1 Einrichtung für den Webserver Wurde der virtuelle Blockdruckpfad durch unsere Technikabteilung auf dem jeweiligen Webserver eingerichtet, kann die Einstellung des benötigten Schlüssels vorgenommen werden. Seite 7 von 11
4.2 Anpassung des Schlüsseleintrages Im Schlüssel 932 / Wert "BDPFAD" wird nun im Text der entsprechende Ordner ohne Pfadangabe hinterlegt, der bereits vorher in der WEB-Konfiguration eingetragen wurde. Ist der Schlüssel nicht hinterlegt bzw. steht der Wert auf 0, wird der Standard "blockdruck" dort eingesetzt. Seite 8 von 11
5 Fehlerhafte Darstellung von Dokumenten im Querformat 5.1 Fehlerbeschreibung Sollte im Blockdruck ein im Querformat erstelltes Dokument dennoch im Hochformat erscheinen, so kann folgender Workaround genutzt werden, um den Fehler zu beseitigen. Seite 9 von 11
5.2 Fehlerbehebung Das Dokument muss mit Open Office erneut in das PDF-Format überführt werden. Achtung: Ein Drucken des Dokuments in das PDF-Format über einen PDF-Drucker würde zu dem gleichen Fehler führen! Bitte öffnen Sie das Dokument in Open Office und wählen Sie den Punkt Datei Exportieren als PDF aus. Bestätigen Sie bitte den darauf folgenden Dialog mit Exportieren und speichern Sie das Dokument im Anschluss unter dem entsprechendem Namen ab. Seite 10 von 11
Ersetzten Sie nun bitte die fehlerhafte PDF durch die neu erstellte. Anschließend führen Sie bitte den Blockdruck erneut aus. Seite 11 von 11