# Berichte und Reports # Grundlagen ## Arbeitsschritte Reports bzw. Berichte werden genutzt um den aktuellen Depotstand zu drucken oder zu publizieren (ins Internet als HTML Bericht). Ein Report wird erstellt über das Hauptmenü "Depot - Berichtsdruck". Über eine Stichtagsabfrage legen Sie den Berichtszeitpunkt fest, d.h. die Kontostände, Transaktionslisten usw. gelten für den Stichtag bzw. bis zum Stichtag. ## Ansicht Die Reportansicht gliedert sich zum einen in ein Vorschaufenster und einem Einstellungsbereich. Im Einstellungsbereich lassen sich Berichtszeiträume, Inhalte und Layout festlegen. Über die Reportauswahl läßt sich ein vordefiniertes Layout auswählen. Das Layout wird durch sogenannte XSL Files bestimmt, die bereitgestellte XML Files aufbereiten als HTML Dateien durch eine [XSLT-Transformation](https://de.wikipedia.org/wiki/XSL_Transformation). Zur Anzeige kann so der Standardbrowser verwendet werden (Firefox, Safari, IE, Opera usw.). Die Vorschauansicht erfolgt allerdings mit den Möglichkeiten des installiertem Internet Explorers. [![image-1655628440624.png](https://www.shareholder24.com/wiki/uploads/images/gallery/2022-06/scaled-1680-/image-1655628440624.png)](https://www.shareholder24.com/wiki/uploads/images/gallery/2022-06/image-1655628440624.png) In diesem Beispiel sind im SHAREholder\\Report-Verzeichnis drei Report\*.XSL Dateien vorhanden: Report.Default.XSL und Report.Export.CSV.xsl und Report.Musterdepot\*.xsl. Die Export.CSV kann genutzt werden um die Depotdaten nach Excel als CSV-Datei zu exportieren und stellt ein sehr einfaches Beispiels für eine XSL-Format-Datei dar. ## Einstellungen Werden die Einstellungen zu einem Report geändert, wird nach dem Refresh die neue Ansicht angezeigt. [![image-1655628446200.png](https://www.shareholder24.com/wiki/uploads/images/gallery/2022-06/scaled-1680-/image-1655628446200.png)](https://www.shareholder24.com/wiki/uploads/images/gallery/2022-06/image-1655628446200.png) Mit Veränderung der Einstellungen für Zeiträume und Umfang, wird die vorbereitete XML-Datei verändert und damit der mögliche Output auch für die XSL-Datei. Weitere Details finden Sie unter [Eigene Berichte und Reports](https://shareholder.atlassian.net/wiki/spaces/SHARPUB/pages/2031386/Eigene+Berichte+und+Reports). ## Drucken Der Ausdruck erfolgt über den Standardexplorer des Systemes. Der Ausdruck ist optimiert für den Hochformat-Druck, wenn Depot-Grafiken verwendet werden.
- Bitte beachten Sie in diesem Zusammenhang, dass ein farblicher Ausdruck nur möglich ist, wenn die entsprechenden Einstellungen im Browser gesetzt sind insb. die Einstellung fürs Drucken/Printing mit Druck der Hintergrundbilder und -Farben sollte aktiviert sein. - Prüfen Sie auch unter Datei.Seiteneinstellungen, ob die Header und Footerdaten entfernt sind, da sonst unnötigerweise die Herkunftsadresse usw. ausgedruckt wird.
# Eigene Berichte und Reports ## Hintergrund Berichte werden in SHAREholder als HTML Datei abgelegt. Der Ausdruck selbst wird hierbei auch nicht von SHAREholder organisiert, sondern dem installierten Standardbrowser überlassen. Die Berichte selbst werden aufgrund von XML/XSL Vorlagen erzeugt. In diesen Vorlagen wird auf Basis von XSL Steuerkommandos die verbundene XML-Struktur ausgewertet und in HTML Steuerbefehle umgesetzt. [![image-1655628466819.png](https://www.shareholder24.com/wiki/uploads/images/gallery/2022-06/scaled-1680-/image-1655628466819.png)](https://www.shareholder24.com/wiki/uploads/images/gallery/2022-06/image-1655628466819.png) - XSL Dateien liegen unter SHAREholder\\Report. Für die Depotreports sind alle Report.\*.XSL Dateien interessant. Generierte Bilddateien werden unter \\Report\\Temp abgelegt ebenso wie die generierten Reportdateien als XML Files. Sie finden hier übrigens auch die XSL Files für den Chartdruck und für den Depotdruck. Folgende Zuordnungen gelten zur Zeit: - Print.Chart.XSL - Transformation beim Chartdruck - Print.Depotchart.XSL - Transformation beim Reportdruck in den Depotgrafiken - Print.Liste.XSL - Transformation bei Druck von Kurslisten - Report.\*.XSL - Transformationdateien für den Depotdruck ## XML Struktur Alle Daten die für den Druck verwendet werden sind in der Report.XML Datei abgelegt. In dieser Datei werden zunächst alle vorhandenen Daten abgelegt. Die XSL Datei entscheidet dann aufgrund den Eintragungen im XPath (/Depot/Einstellungen) was angezeigt werden kann und soll. Den Möglichkeiten der Berichtgestaltung sind kaum Grenzen gesetzt. Allein die vorhandenen Datenmenge schränkt die Informationsdichte ein. Der nachfolgende Screenshot zeigt die Struktur der Daten. [![image-1655628471112.png](https://www.shareholder24.com/wiki/uploads/images/gallery/2022-06/scaled-1680-/image-1655628471112.png)](https://www.shareholder24.com/wiki/uploads/images/gallery/2022-06/image-1655628471112.png) ## XSL Files Die XSL Files enthalten die Umsetzungslogik der XML Daten in HTML Steuercodes. Wenn Sie hier eigene Templates anlegen möchten, finden Sie weitere Informationen unter: - [https://www.xsl-rp.de/index.php?top=1&sub=2&action=index](https://www.xsl-rp.de/index.php?top=1&sub=2&action=index) - [https://de.wikipedia.org/wiki/XSL\_Transformation](https://de.wikipedia.org/wiki/XSL_Transformation) # Berichte-Reporting mit Publishing für Websites ## Anwendung und Ziel Ziel ist die Möglichkeit automatisiert oder manuell - Depotdaten - Watchlisten - Equity-Charts - Chartbilder bereitzustellen über einen online-FTP Zugang oder einen lokalen Server. Das Modul ist über den Shortcut "Strg-W" zugänglich und kann so konfiguriert werden, dass nach jeder Kursaktualisierung (manuell/automatisch) die Bereitstellung automatisch erfolgt. Die lokale Bereitstellung macht insb. dann Sinn, wenn ein entsprechender Webserver lokal konfiguriert über Network-Appliance-Geräte, kleinen Linux-Servern oder einfach über einen lokalen Apachen bereitgestellt werden soll. Der direkte FTP Upload ist für die Bereitstellung über Websites vorgesehen. ## Technische Hintergründe ### Voraussetzungen Die aktuellen Pfade in den Transformationsdateien (XSL) sind so eingestellt, dass auf dem Zielserver folgende Pfade und Dateien vorhanden sein sollten: - \[Root\] - Parallel zum Root-Verzeichnis (hier Temp-Verzeichnis) - \\Bilder - \\Bilder\\New Age - Über dem Root-Verzeichnis muss einmalig die format.css Datei sowie die Report.js - JavaScript - Datei abgelegt werden. - ..\\Format.css - ..\\Report.js ### Uploadumfang Die bei einer Bereitstellung zur Verfügung gestellten Dateien werden dabei so gering wie möglich gehalten. Der Upload-Umfang richtet sich nach dem Umfang der gewählten Optionen. Werden Depotreports gewählt, wird zu jedem Depot das entsprechende \*.Depot ebenfalls als Originaldatei geuploaded. Diese kann dann direkt über die Funktion "Lade Depot von URL ... " bereitgestellt werden. Die Datei "Internet.Depots.txt" im Datenverzeichnis enthält hierzu alle notwendigen Einstellungen. Die Datei muss manuell angepasst werden. Per default enthält Sie lediglich folgende Informationen: ```YAML [Depots] https://www.shareholder24.de/download/Tradingdepot.2004.Depot ``` Für die Depotdateien wird das in den Formulareinstellungen (siehe oben) definierte Root-Verzeichnis für Depotdateien verwendet, da hier im Normalfall ein spezieller Downloadordner genutzt werden soll. Werden die Depot/Watchlistencharts bereitgestellt, so werden alle Charts geöffnet und die zugehörigen Chartbilder gespeichert. Die Charts öffnen sich hier wie auch bei manuellem Aufruf, d.h. mit allen individuellen Einstellungsparametern für diesen Chart. So können gezielt auch Kommentare, Unterstützungslinien usw. eingeblendet werden. ## Arbeitsschritte ### Bereitstellungstyp Je nach technischen Bedürfnissen kann eine XML oder eine bereits transformierte HTML (mittels XSL) online gestellt werden. Reine XML-Dateien können so gezielt mittels Python/PHP/ASP/JSP auf dem Server geparst und ausgewertet werden. Komplexe Auswertungsszenarien sind so für mich vorstellbar. Bei der XML Bereitstellung muss die Bereitstellung der zugehörigen XSL-Dateien und/oder Logiken vom Anwender erfolgen. Die Default-Anwendung werden allerdings die HTML-Dateien geuploaded. Um den Umfang hierbei gering zu halten, werden lediglich die erstellten Grafiken und HTML-Dateien geuploaded. Eventuell notwendige CSS, JavaScript und Bilddateien müssen manuell bereitgestellt werden. Folgende Dateien sollten manuell auf dem Zielserver einmalig bereitgestellt werden (alle zu finden unter SHAREholder\\Report): - Report.js - Format.css - Bilder\\GreenPixel.gif (Prozentdarstellung) - Bilder\\RedPixel.gif (Prozentdarstellung) - Bilder\\New Age\*.gif (Alle Grafiken) Die XSL-Dateien sind zur Zeit so konfiguriert, dass ausgehend vom aktuellen Ordner die Bilder/Scripte/CSS-Dateien im übergeordneten Ordner vorliegen, d.h. wird in Server\\Temp das Root-Verzeichnis (siehe oben) definiert muss unter Server\\ die Report.js, Format.css liegen und unter Server\\Bilder die Bilddateien. Als erste Referenz ist unter www.shareholder24.de die Integration des Tradingdepots vorhanden. ## Protokollauswertung Das Protokoll gibt Auskunft während der Bereitstellung über den Fortschritt und dem Status der Einzelaktionen. Auch bei automatisierten Aufrufen wird das Protokoll aufgebaut und angezeigt.