09.07.2018 10:59
Inhaltsverzeichnis 1 Vorwort... 3 2 Download der IDL.EBILANZ... 4 3 Installationsvoraussetzungen... 5 3.1.1 IDL.KONSIS.FORECAST- Version 2016 und höher... 5 3.1.2 IDL-Applikationsserver-Dienst... 5 3.1.3 IDL.EBILANZ - Lizenzdatei... 5 4 Installation / Update der IDL.EBILANZ... 6 5 Installation des IDL Applikationsserver-Dienstes...13 6 Aufruf der Anwendung IDL.EBILANZ...14 6.1 Aufruf über den Internet-Browser...14 6.2 Aufruf über das IDL-PORTAL...15 7 Weitere Hinweise für den IT-Administrator...17 7.1.1 IDL-Applikationsserver...17 7.1.2 Das Installationsverzeichnis der IDL.EBILANZ...17 7.1.3 IDL.EBILANZ - Datenbank und Datenbanksicherung...17 7.1.4 Backup vor dem Update-Prozess der IDL.EBILANZ...18 7.1.5 Logfiles...18 8 Hilfestellung und Technischer Support...19 9 Kontakt...20 2 IDL GmbH Mitte
1 Vorwort Das vorliegende Handbuch richtet sich an IT-Administratoren und beschreibt die Installation und das Update der IDL.EBILANZ. Zum Installieren steht ein Installation-Wizard zur Verfügung, der Sie in wenigen Schritten durch den gesamten Installationsprozess führt. Die einzelnen Schritte sind in Bildern (Screenshots) dokumentiert. Die Screenshots beziehen sich auf den Installations-Wizard der Version IDL.EBILANZ 1.24. Der Installations-Wizard neuerer IDL.EBILANZ Versionen kann geringfügig abweichen. Aufruf der IDL.EBILANZ IDL.EBILANZ ist eine Webanwendung und kann über einen Internet-Browser aufgerufen werden. Die Anwendung IDL.EBILANZ kann auch aus dem IDL-Portal 1 aufgerufen werden. Die Konfiguration des Widget IDL.EBILANZ wird im vorliegenden Handbuch beschrieben. Informationen zum IDL-Portal finden Sie unter https://cpm-suite.idl.eu/startseite/idl-portal/ IDL.EBILANZ erstellt eine regelkonforme E-Bilanz entsprechend der für den Meldezeitraum gültigen XBRL-Taxonomie und übermitteln diese auf Knopfdruck an das Finanzamt. Das Tool übernimmt Strukturen und Daten aus unterschiedlichen Systemen und ermöglicht gleichzeitig die manuelle Erfassung zusätzlicher Daten. Für den Schnelleinstieg sind Formularvorlagen vorgesehen. Information zur IDL.EBILANZ bekommen Sie unter https://cpm-suite.idl.eu/idlebilanz/ 1 Das IDL-Portal ist der zentraler Einstieg und bringt Sie direkt in die Produkt- und Lösungswelt der IDL CPM Suite. IDL GmbH Mitte 3
2 Download der IDL.EBILANZ Die aktuelle Version der IDL.EBILANZ finden Sie im Service-Center auf der Website www.idl.eu. Sie müssen dazu angemeldet sein. Dies setzt voraus, dass ein Account vorhanden ist. Sollte keiner vorhanden sein, so legen Sie bitte einen an. Wichtig ist hierbei, dass Sie Ihre Kundennummer vorliegen haben, um diese im Nachhinein in Ihrem Profil eintragen zu können. Nach dem Download der aktuellen IDL.EBILANZ muss die ZIP-Datei entpackt werden. 4 IDL GmbH Mitte
3 Installationsvoraussetzungen 3.1.1 IDL.KONSIS.FORECAST- Version 2016 und höher Die erfolgt auf dem Server, auf dem IDL.KONSIS.FORECAST als Serverinstallation installiert ist. IDL.EBILANZ benötigt einen Anwendungsserver. Der Anwendungsserver wird durch IDL.KONSIS.FORECAST (Serverinstallation) ab der Version 2016 bereitgestellt. Der IDL Applikationsserver ist der Anwendungsserver für die Anwendungen IDL.KONSIS.FORECAST, IDL.XLSLINK und IDL.EBILANZ. Der IDL Applikationsserver ist auch ein Webserver und stellt eine Reihe von Diensten zur Verfügung. 3.1.2 IDL-Applikationsserver-Dienst Die IDL.EBILANZ-Installation setzt voraus, dass es einen installierten IDL Applikationsserver-Dienst der IDL.KONSIS.FORECAST-Version 2016 oder höher gibt. Wichtig: Während der werden Sie aufgefordert, den IDL Applikationsserver- Dienst zu beenden. Bevor der IDL Applikationsserver-Dienst gestoppt werden kann, muss sichergestellt sein, dass niemand mit dem Anwendungsserver arbeitet. Alle Anwender müssen zu diesem Zeitpunkt IDL.KONSIS.FORECAST und alle offenen IDL.XLSLINK-Verbindungen schließen. Ist bereits eine IDL.EBILANZ vorhanden, so müssen außerdem alle Anwender der IDL.EBILANZ Ihre Arbeit beenden, bevor der IDL Applikationsserver-Dienst gestoppt werden kann. 3.1.3 IDL.EBILANZ - Lizenzdatei Bei einer Neu-Installation wird zusätzlich nach einer IDL.EBILANZ-Lizenzdatei gefragt. Sie bekommen die Lizenz als Dateianhang (gezippt) per email zugesendet. Dieser Dateianhang muss entpackt werden. Die entpackte Datei hat den Dateinamen abz.lic. Kopieren Sie die Datei abz.lic auf den IDL.KONSIS.FORECAST-Server. Wenn Sie keine Lizenz-Datei bekommen haben, fragen Sie bitte beim Technischen Support nach. Kontaktinformationen finden Sie im abschließenden Kapitel. IDL GmbH Mitte 5
4 Installation / Update der IDL.EBILANZ Zum Installieren der IDL.EBILANZ starten Sie die install.exe aus dem entpackten ZIP-File Ein Wizard begleitet Sie nun durch den Installationsprozess. Auswahl der Sprache. Die Sprache bezieht sich nur auf den Installationsvorgang. Sie können den Installer (Wizard) in Deutsch und in Englisch ausführen. Nachfolgende Bilder (Screenshots) sind in Deutsch. Willkommen Schritt 1/7 6 IDL GmbH Mitte
Auswahl Zielverzeichnis Schritt 2 /7 Meldung bei Neu-Installation Bei Neu-Installation wird in einer nachfolgenden Dialogbox Meldung gefragt, ob das Verzeichnis erstellt werden soll. Bestätigen Sie dies mit Ja Warnung beim Update Bei einem Update wird in einer nachfolgenden Dialogbox Warnung angezeigt, dass bereits dieses Verzeichnis existiert und es wird gefragt, ob in dieses Verzeichnis installiert werden soll. Bestätigen Sie dies mit Ja IDL GmbH Mitte 7
Weitere Angaben Schritt 3/7 bei Neu-Installation Weitere Angaben Schritt 3/7 beim Update 8 IDL GmbH Mitte
Proxykonfiguration Schritt 4/7 Proxy-Einstellungen müssen nur dann gesetzt werden, wenn eine Proxy-Verbindung benötigt wird, um vom IDL.KONSIS.FORECAST-Server das Finanzamt zu erreichen. Proxy Parameter sind nachfolgend beschrieben: IDL GmbH Mitte 9
Hinweise zur Installation Schritt 5/7 Wichtig! Stellen Sie an dieser Stelle nochmals sicher, dass niemand von den Anwendern mit dem System IDL.KONSIS.FORERCAST UND IDL.EBILANZ arbeitet. Ausserdem müssen all offenen IDL.XLSLINK-Verbindungen getrennt werden. Stoppen Sie nun den IDL Applikationsserver-Dienst! Computerverwaltung / Dienste und Anwendungen / IDL Application Server beenden 10 IDL GmbH Mitte
Installationsfortschritt - in Arbeit - Schritt 6/7 Neu-Installation / Update erricclient; reportfactory.war, taxonomies Installationsfortschritt Gesamt 3/3 Fertig - Schritt 6/7 IDL GmbH Mitte 11
Installation abgeschlossen Schritt 7/7 Es wurden der ericclient, die reportfactory.war und die Taxonomie erfolgreich installiert. Betätigen Sie mit Fertig, um den Instalaltions-Vorgang abzuschließen. Bitte beachten Sie, dass der IDL Applikationsserver-Dienst von IDL.KONSIS.FORECAST installiert und anschließend gestartet werden muss. 12 IDL GmbH Mitte
5 Installation des IDL Applikationsserver-Dienstes Nach der erfolgten muss der IDL Applikationsserver-Dienst neu installiert werden. Zum Installieren des Dienstes führen Sie einfach die Datei installservice.bat als Administrator aus. Diese Datei finden Sie im Server-Verzeichnis von IDL.KONSIS.FORECAST. Beispielpfad einer IDL.KONSIS:FORECAST-Installation: C:\Programme\IDL\IDLKONSISFORECAST Im Anschluss daran muss der IDL Applikationsserver-Dienst wieder gestartet werden. IDL GmbH Mitte 13
6 Aufruf der Anwendung IDL.EBILANZ 6.1 Aufruf über den Internet-Browser Die IDL.EBILANZ ist eine Webanwendung. Der Aufruf erfolgt über einen Internetbrowser wie Firefox, Internet Explorer, Google Chrome oder Edge. Adresse: https://konsis-servername:portnummer/reportfactory Beispielaufruf: https://idl-th-app-01.a.idl.de:444/reportfactory/ Die Anmeldung zur Ersteinrichtung der IDL.EBILANZ erfolgt mit dem User admin und dem zugehörigen Passwort. Das Passwort zur Ersteinrichtung erfragen Sie bitte beim Technischen Support. Sie sollten das Passwort jedoch nach der ersten Anmeldung ändern. 14 IDL GmbH Mitte
6.2 Aufruf über das IDL-PORTAL Sie können aus dem IDL-PORTAL sehr komfortable die IDL.EBILANZ starten. Gehen Sie im IDL-PORTAL auf AppLauncher und benutzen das WIDGET IDL.EBILANZ. Einrichten IDL.EBILANZ als Widget Zum Einrichten eines neuen Widget benutzen den AppLauncher im IDL-Portal, klicken dort auf und legen eine neue Verknüpfung als individuellen Link auf eine Webseite an. Anlegen einer neuen Verknüpfung (Benutzerdefiniert) im IDL-Portal / AppLauncher: IDL GmbH Mitte 15
Nachfolgend werden die Eigenschaften des Widget IDL:EBILANZ konfiguriert. Bitte geben Sie unter URL die vollständige Adresse an (https://<hostname>:<port>/reportfactory). Hostname ist der Servername von IDL.KONSIS.FORECAST IDL-Portal\ AppLauncher\...\neue Verknüpfung\Eigenschaften 16 IDL GmbH Mitte
7 Weitere Hinweise für den IT-Administrator 7.1.1 IDL-Applikationsserver IDL.EBILANZ ist eine Java Anwendung und setzt einen Java-basieren Applikationsserver voraus, auf dem die IDL.EBILANZ ausgeführt wird. Mit IDL.KONSIS.FORECAST haben Sie seit Version 2016 einen java-basierenden Applikationsserver, den IDL Applikationsserver (Jetty). Im IDL Applikationsserver wird auch die IDL.EBILANZ ausgeführt. Im Installationsverzeichnis von IDL.KONSIS.FORECAST befindet sich ein Unterordner jetty_conf und dort der Ordner webapps. Dieser Ordner enthält eine Datei mit dem Namen appserver.war. Die appserver.war enthält die Serverlogik (Java) von IDL.KONSIS.FORECAST. Beispielpfad C:\Program Files\IDL\IDLKONSISFORECAST\jetty_conf\webapps Durch kommt im Ordner webapps eine weitere Datei mit dem Namen reportfactory.war hinzu, in der die Serverlogik von IDL.EBILANZ enthalten ist. 7.1.2 Das Installationsverzeichnis der IDL.EBILANZ Weiterhin gibt es ein Installationsverzeichnis der IDL.EBILANZ, in welcher der Eric Client, die Taxonomie, das Log, die Lizenz und auch die IDL.EBILANZ-Datenbank gespeichert wird. Default-Installationsverzeichnis der IDL.EBILANZ C:\ProgramData\IDL\IDL Reportfactory\ 7.1.3 IDL.EBILANZ - Datenbank und Datenbanksicherung Die IDL.EBILANZ besitzt eine eigene Datenbank mit dem Namen rp.h2.db. Default-Datenbankverzeichnis der IDL.EBILANZ: C:\ProgramData\IDL\IDL Reportfactory\reportfactory\db Solange der IDL Applikationsserver-Dienst läuft, ist diese Dateidatenbank in Benutzung. Bei jedem Update der IDL.EBILANZ (bei jedem Ausführen der install.exe) wird die Datenbank der IDL.EBILANZ als Backup-Datei gesichert. Diese enthält neben den Namen rp.h2.db außerdem einen Zeitstempel im Dateinamen und die Dateiendung mit der Bezeichnung bak. Die Backup-Datei liegt im Unterordner Backup des Installationsverzeichnis der IDL.EBILANZ. Beispielpfad Backup-Ordner C:\ProgramData\IDL\IDL Reportfactory\backup Da bei jedem erfolgreichem Ausführen der Installation (install.exe) eine weitere Datenbanksicherung mit Zeitstempel im Dateinamen hinzugefügt wird, sollte der Ordner Backup überwacht werden. Nichtbenötigte Datenbank-Backup-Dateien können manuell gelöscht werden. Außerdem befindet sich im Ordner Backup eine Kopie der Lizenzdatei abz.lic. IDL GmbH Mitte 17
7.1.4 Backup vor dem Update-Prozess der IDL.EBILANZ Vor Beginn des Update-Prozesses der IDL.EBILANZ (Schritt 6/7) wird ein temporärer Ordner mit dem Namen reportfactory_save angelegt, in dem die bereits vorhandene IDL.EBILANZ vor dem update gesichert wird. Dieser Ordner wird wieder entfernt, sobald im Schritt 7/7 der Installationsvorgang mit Fertig beendet wird. Der Ordner reportfactory_save ist explizit dafür gedacht, im Falle eines Abbruches während des Installationsvorganges den Original-Zustand der IDL.EBILANZ wieder herzustellen zu können. 7.1.5 Logfiles Zur Installation wird ein install.log geschrieben: Das install.log befindet sich im Installationsverzeichnis der IDL.EBILANZ. Beispielpfad C:\ProgramData\IDL\IDL Reportfactory Logfiles zur Anwendung IDL.EBILANZ befinden sich im Unter-Ordner logs Beispielpfad C:\ProgramData\IDL\IDL Reportfactory\reportfactory\logs 18 IDL GmbH Mitte
8 Hilfestellung und Technischer Support Weitere Informationen finden Sie unter http://help.idl.eu/v10/de-de/#welcome.html Bitte fragen Sie bei auftretenden Problemen nach Unterstützung. Hilfestellung bekommen Sie durch den Technischen Support der IDL GmbH Mitte. Möglichkeiten zur Kontaktaufnahme finden Sie im abschließenden Kapitel. IDL GmbH Mitte 19
9 Kontakt Sie können den technischen Support wie folgt erreichen: Per Online-Supportanfrage: https://www.idl.eu/service-center/support/weberfassung-supportanfrage/ Anmerkung: Dies setzt voraus, dass ein Konto (Account) vorhanden ist. Sollte kein Konto vorhanden sein, so legen Sie bitte eins an. Wichtig hierbei ist, dass Sie Ihre Kundennummer vorliegen haben, um diese in Ihrem Profil eintragen zu können. Per Mail: hotline@idl.eu Per Telefon: +49 (0)4102-4785-11 Ihr technischer Support IDL GmbH Mitte 20 IDL GmbH Mitte