Import und Export Transaktions- und Kontodaten

• Grundidee für Daten-Abgleiche
• Depot-Export in CSV-Dateien
• Depot-Import aus CSV-Dateien - Import Assistent
• CSV-Portfolioimport-Formatbeschreibung
• Inkrementelle Transaktionsdaten und Sonderfälle
• XTB-Trades und XTB-Kataloge
• OnVista-Abgleich

Grundidee für Daten-Abgleiche

Shareholder ist bei den meisten Anwendern selten das Erstprogramm. In den meisten Fällen wurden andere Börsenprogramme oder eigene Excellisten zuvor gepflegt. Um hier einen reibungslosen Übergang zu realisieren und eine manuelle Datenerfassung zu vermeiden, wurde eine Export/Import-Schnittstelle realisiert die einfach (Keep-It-Simple) über ein CSV-Textformat funktioniert, dass insb. von Excel sehr gut verarbeitet werden kann.

Weiteres:

• Depot-Export in CSV-Dateien
  
• Depot-Import aus CSV-Dateien - Import Assistent
• XTB-Trades und XTB-Kataloge
• OnVista-Abgleich

Um den Export- und Import nicht nur für den einmaligen Abgleich nutzen zu können, sind die Funktionen so geschrieben, dass hiermit folgende Sonderaufgaben realisiert werden können:

• Zusammenführung oder Trennung von Transaktionen aus/in Einzeldepots. Hierzu kann eine Kombination aus Exports/Imports der Einzeldepots in der Umsetzung helfen.
• Manueller Abgleich eines kompletten Portfolios über Excel, um Eingaben und die Kontrolle der Transaktionen zu vereinfachen. Anschließender Re-Import der Daten.
• Eine Pflege der Transaktionsdaten kann so theoretisch komplett nach Excel verlagert werden, wenn man sich den Im- und Exportfunktionen bedient. Neben Updates und Neuanlagen für Transaktionen können neue Aktientitel, neue Konten, neue Börsen und neue Entscheidungstypen automatisch angelegt werden. 

Depot-Export in CSV-Dateien

Funktionsweise

Der Export erfolgt in einem Standardformat , welches nicht veränderbar ist. Kontobewegungen werden dabei ebenso exportiert, wie Depotumsätze. Der Export kann in dieser Form nach gewünschten Änderungen 1:1 wieder über den Import übernommen werden. Neue Einträge werden dabei hinzugenommen und geänderte in SHAREholder aktualisiert. Wenn es nicht möglich ist. die Ordernummer zu verwenden, wird die ISIN und der Zeitstempel herangezogen für den Abgleich.  

Weitere Hinweise für den Re-Import finden Sie beim Depot-Import aus CSV-Dateien - Import Assistent.

Das Standard-Export-Format ist aktuell dabei definiert über:

ciCheck.DefaultColumnSeparator = ";" 

ciName=0 
ciOrdernummer=1 
ciDepot=2 
ciBoerse=3 
ciISIN=4
ciTyp=5 

ciDatum=6
# ciDatum.shortdateformat='dd.mm.yyyy'

ciZeit=7
# ciZeit.shorttimeformat='hh:mm:ss'

ciKurs=8
ciWert=9
ciStk=10
ciGewinn=11 
ciGeb=12
ciEntscheidung=13
ciBewertung=14
ciNotiz=15

# ciOrdervolumen=16
# ciWertDatum=17
# ciStatus=18

Depot-Import aus CSV-Dateien - Import Assistent

Der Import Import-Assistent erlaubt es unterschiedlichste Formate manuell oder voll automatisch zu importieren, ohne die einzelnen Daten von Hand einpflegen zu müssen. Der Import erfolgt hierbei direkt in das aktuell geöffnete Portfolio oder kann innerhalb der Depot-Importdatei definiert werden über eine angegebene Depotnummer & Kontonummer.

Während des Imports werden bisher nicht vorhandene Titel und Aktien automatisch angelegt. Damit muss immer eine WKN, ISIN und Name beim Import definiert sein.

Formatbeschreibung für Import-Profile

Um die Arbeit zu erleichtern, werden die wichtigsten Importprofile z.B. für Comdirect, Flatex, Consors etc. vordefiniert bereitgestellt. Sie können dabei als Template genutzt werden und durch Kopieren und Verändern angepasst werden. 

Weitere Details unter:

• CSV-Portfolioimport-Formatbeschreibung

Dialog-Aufbau 

Vorgehen für den Import

• Auswahl des gewünschten Konto-Profils d.h. Auftragsübersicht/Kontobewegung etc. im rechten Baum (A)
• Drag & Drop (einfach auf (B) bzw. (C) oder manuelle Auswahl der Importdatei 
• Prüfung des Importvorschlags inkl. Importprofil-Konfiguration

• Prüfen Sie hier die Positions-Nummern und die Positionsangaben im Profil
• Wenn alle Einstellungen überprüft und vorgenommen worden sind, bitte den "Import starten", womit die Daten eingelesen werden
• Nach Abschluss erscheint eine Statistik und über den Reiter "Log-Ausgaben" wählbare Detail-Ansicht nach dem Import

Vorschau-Funktion

Da die Importfunktion eine sehr hohe Relevanz für die effektive Nutzung der Software hat, wurde eine Preview-Funktion implementiert. Diese nutzt exakt die gleichen Zuordnungen und internen Logiken. Es wird dabei lediglich die finale Gewinnberechnung unter Brutto-Gewinn nicht ausgewiesen, da diese erst mit einer Gesamtberechnung des Portfolios machbar ist. Diese wird daher nur als "Vorschau" ausgewiesen.

Sie können und sollten dabei auch die Log-Daten nutzen, sollte die Vorschau unerwartete Ergebnisse zeigen.

Import-Setup mit allen beteiligten Schritten am Beispiel eines Smartbroker-Imports

Während des Imports werden Titel automatisch angelegt. Leider ist in der Importdatei nur Lang & Schwarz hinterlegt, womit Sie mit Doppelklick auf die importierten Titel die Titelnamen nochmals anpassen sollten!

Bitte konfigurieren Sie danach einfach mit folgenden Schritten in lediglich zwei Minuten abschließen das Depot:

Weitere Importmöglichkeiten

Manuell automatischer Import aller bisher nicht importierten CSV-Dateien als Autoimport*.CSV

• Öffnen des Import-Verzeichnisses unter .\Daten\Import oder über die Quick-Icons wie im Bild dargestellt. Legen Sie dort alle aus Ihrer Sicht automatisch zu importierende Dateien ab. Bitte beachten Sie, dass Sie zuvor *Demo*.CSV entfernen sollten!
• Bitte wählen Sie hierzu folgenden Menüpunkt "Import Depot/Trade-Dateien". Bitte beachten Sie, dass Sie den oberen Reiter "Transaktionen" (siehe nachfolgenden Screenshot) nur innerhalb der Hauptauswahl Transaktionen sehen und NICHT innerhalb des Reiters "Depotansicht". 
• Es werden automatisch nach "Starten" alle noch vorhandenen Importdateien, die jeweils eine Konfigurationsdatei (INI) besitzen importiert:
  • Automimport.Aktienlisten.*
  • Automimport.Depotbestand.*
  • Autoimport.Stoplimits.*
  • Autoimport.Trades.*

Automatisiert bei Programmstart

Ein automatisiertes Einlesen macht Sinn, wenn viele Depots und damit viele verschiedene Kauf- / Verkauf und Depots vorliegen und direkt beim Programmstart die Konto/Transaktionsbewegungen eingelesen werden. Hierzu müssen die Dateien lediglich wie gehabt uner \Daten\Imports abgelegt werden. Beim Programmstart werden diese automatisiert eingelesen und Sie sehen sofort den aktuellsten Stand.

Vorgehen:

• Einmaliges Aktivieren des Auto-Imports in den Programmeinstellungen

• Speichern der zu importierenden Files im Ordner: \Daten\Imports 
• Anpassen des Dateinamen-Präfix mit dem von der gewünschten Import-Konfiguration erwarteten Datei Präfix. Eine Import-Konfiguration wird immer als INI-Datei beschrieben.
  z.B. für einen Comdirect-Import muss die Datei: mit Autoimport-Aktienliste-comdirect- entsprechend der INI-Datei als Prefix starten z.B. als "Autoimport-Aktienliste-comdirect-Musterdepot-DEMO-Musterdepot.csv". Über den Dateinamen wird die Zuordnung zwischen Konfiguration und Importdatei erreicht.

Erstellung eines eigenen Import-Profils

• Die Import-Routinen müssen zuvor in dem Verzeichnis SH24\\Daten\Imports gespeichert worden sein damit diese rechts sichtbar werden. Sie können dabei ein bestehende Import-Konfiguration einfach als Quelle nutzen und im Verzeichnis kopieren.  Eine neue Import-Routine entsteht damit durch Kopieren und Anpassen. Einfacher können Sie auch ein Profil im Assistenten markieren und danach mit Hinzufügen den Kopiervorgang durchführen.
• Pro Import-Routine kann eine gleichnamige Bild-Datei im JPG-Format als Vorschaubild angezeigt werden (opt. 920x720 Pixel). Dies zeigt an, wie das Import-File aussehen muss um korrekt importiert zu werden. (Liegt kein individuelles Bild vor, wird ein Default-Bild verwendet).
• Nutzen Sie für den Import für das Import-Format die Konfigurationsbeschreibung unter: CSV-Portfolioimport-Formatbeschreibung. Sie können im Editor zudem mit <Strg><Leertaste> eine Autovervollständigung aufrufen. Die Felder beginnen immer mit "ci" z.B. ciStk ...

Automatische Generierung eines Import-Profils auf Basis einer Beispiel-Datei

Die Importprofile erlaube eine komplette Beschreibung über Inhalt, Position der Transaktions- oder Kontodaten. Dabei sind auch bei manueller Einstellung praktisch immer bestimmte Schlüsselfelder relevant, die so auch automatisch zugeordnet werden können.

Daher ist es möglich einfach eine Beispiel-Datei zu öffnen in der Vorschau und dann automatisch ein Importprofil anzulegen. Dies funktioniert dabei nicht immer zu 100%, deckt aber bereits sehr viele Anwendungsfälle mit ab.

Wenn Sie dabei einen Broker/Bank verwenden, die so noch nicht vorkonfiguriert ist, starten Sie optimalerweise mit Anlage eines zunächst neuen leeren Profils über "Hinzufügen" auf der rechten Seite. Danach öffnen Sie per Drag & Drop oder manueller Dateiauswahl eine Beispieldatei. Danach können Sie es bereits mit "Erzeuge Basis-Konfiguration aus Beispiel-Kopfzeile" probieren. Es sollte dabei eine Kopfzeile und mind. eine ausgefüllte Datenzeile vorhanden sein.

CSV-Portfolioimport-Formatbeschreibung

Allgemeine Hinweise

Die Konfigurationen erfolgen innerhalb der INI-Dateien. Dabei gelten folgende Grundansätze:

• Normalisierung aller Zeilen, so dass Leerzeichen am Anfang und Ende ignoriert werden
• " oder ' für die Werte können genutzt werden, werden aber praktisch ignoriert. Die Zeichen sind damit jedoch als Sonderzeichen zu betrachten
• Zeilen mit #  am Anfang werden ignoriert und können daher als Kommentar-Zeilen verwendet werden

Die INI-Konfiguration nutzt praktisch einen Transformationsalgorithmus, der ein Zielformat beschreibt für den Trade-Import. Die INI-Konfiguration nutzt daher alle Felder aus dem Trade-Import, die hier dann in der Position oder Default-Werten etc. zu beschreiben sind.

Nutzbare Import-Felder

Nutzbare Spezial-Attribute

Mittels folgender Spezialausprägungen können spezielle Konstellationen festgelegt werden. Die Attribute sind für alle Zuordnungs-Schlüssel technisch nutzbar. Logisch gibt es nicht in allen
Fällen eine Verwendung z.B. das .shorttimeformat macht nur für ciDatum.shorttimeformat Sinn, um das genutzte Datumsformat zu beschreiben.

Konkrete Beispiele

• Im \Daten\Import-Verzeichnis finden Sie eine "Autoimport-Trades-Template.ini". Diese wird auch beim Hinzufügen eines neuen Profils im Editor verwendet. Es kann aber auch manuell zum Kopieren genutzt werden.
• Alle im \Daten\Import-Verzeichnis liegende Dateien mit ... können für eigene Tests verwendet werden
  • Autoimport-Trades-*.ini
  • Autoimport-Depotbestand-*.ini
  • Autoimport-Aktienliste-*.ini

Inkrementelle Transaktionsdaten und Sonderfälle

Als ein Spezialfall für den Import von Transaktions-/Kontobewegungen, können die Import-Dateien Zusatzinformationen enthalten, um automatisch zu einem Konto zugeordnet zu werden oder sogar das komplette Portfolio automatisch zurückzusetzen.

Importprozess

Es ist möglich sein, im Datenverzeichnis (\Daten\Import) eine oder mehrere Autoimport-Trades-*.CSV abzulegen, die automatisch beim Depot-Start importiert werden. Die Dateien sollten im shareHOLDER spezifischen Depot-Importformat vorliegen. Die Order-IDs werden dabei auf bereits vorhandene Einträge geprüft und im Zweifel ignoriert. Quelle der Datei kann ein externes Exportmodul sein wie z.B. ein automatischer Export des IC-Market-cAlgo-Trader-Informationen.

Vorteil ist so, dass praktisch Realtime-Depottransaktionen bereitgestellt werden können, die dann beim Start von shareHOLDER importiert werden.

Im ersten Schritt wird eine Liste der vorhandenen Importdateien aus dem \Daten\Import-Verzeichnis erstellt mit dem Namensschema "Autoimport-Trades*.csv". Diese werden dann schrittweise importiert und eine Log-Datei unter Daten\Import\<Import-Filename>.log geschrieben. Importierte Dateien werden anschließend in das \Daten\Import\Archiv-Verzeichnis verschoben.

Konfiguration

Siehe auch

• Autoimport-Deptbestandsdateien (siehe Depot-Import automatisch aus Depotbestands-Dateien)
• Autoimport-Aktienlisten-Dateien (siehe Autoimport von Stammdaten)
• Depot-Import aus CSV-Dateien - Import Assistent

Um eine weitere Flexibilität beim Import zu erreichen, können aus der Importdatei die ersten Zeilen mit Konfigurationsparametern belegt werden:

Nachfolgend ein Konfigurationsschema einer beliebigen Autoimport-Trades-*.CSV. Diese CSV-Datei enthält somit die Basis-Transaktionsdaten und die Konfigurationsdaten

# Konfiguration
#
# Konto-Stand kann direkt festgelegt und anschließend so automatisch übernommen werden
Account-Balance=XXX.XX


# Konto-Broker als Name
Account-Brokername=XXXX


# Konto mit Kontonummer
Account-Number=XXXX


# Das angegebene SHAREholder-Depot kann genutzt werden, um ein spezifisches Depot zu laden für den Import. Dies ermöglicht so auch fließende Wechsel der Depotdateien bei Import mehrerer Auto-
# Import-Trade-Dateien aus dem Import-Verzeichnis. Das letzte geladene Depot bleibt dann allerdings für die Session erhalten.
SHAREholder-Depot=<Filename z.B. Standard.DepotR2>


# Für das geladende Depot kann erzwungen werden, dass alle vorherigen Transaktionsdaten gelöscht werden
SHAREholder-Clear-All-Existing-Data=True|False


# Trade-Daten
#
Amazon.Com Inc;;Flatex;Frankfurt;US0231351067;Kauf;25.09.2016;12:27:35;805,750;805,75;1,0000;0,00;7,65;'Undefiniert;';;
SAP SE`X;;Flatex;Frankfurt;DE0007164600;Verkauf;07.12.2015;15:46:34;73,220;-1.464,40;-20,0000;644,40;8,68;'Undefiniert;';;

XTB-Trades und XTB-Kataloge

XTB ist ein eingetragener CFD/Forex-Broker für Forex, Rohstoffe, Indizes, ETFs (https://www.xtb.com/de). Technisch kann in ShareHolder sowohl ein Abgleich zu den Katalogen, Stammdaten, Kursdaten bis hin zur Trading-Historie/Offene Positionen erfolgen. Die Aufruf-Funktionen befinden sich unter anderem direkt in der Toolbar bzw. im Hauptmenü.

Voraussetzung

Es muss einmal unter den Programm-Einstellungen der Zugangscode für die XTB-Plattform hinterlegt werden, um die nachfolgenden Funktionen überhaupt aufrufen zu können. Sie können dabei über eine separate Checkbox auch gerne nur einen Demo-Account für die ersten Gehversuche nutzen.

XTB-Katalog-Synchronisation

Es werden praktisch alle vorhandenen XTB-Kataloge ausgelesen und stehen für einen Abgleich zu den internen Markt-Listen zur Verfügung. Während der Synchronisation erfolgt ein Abgleich im folgendem Umfang:

Über die Auswahlboxen entscheiden Sie selbst, ob gleichnamige Marktlisten automatisch erstellt werden. 

XTB-Kursdaten-Synchronisation

Es werden analog der Tai-Pan und Internet-Aktualisierung auf Basis der aktuellen dargestellten Liste alle Kursdaten abgerufen. Von XTB werden dabei Realtime-Kursdaten geliefert und bis max. 13M zurückgegeben als Historie.

XTB-Trade-Historie-Abgleich

Mittels des direkten Trade-Historie-Abgleichs können per Knopfdruck nativ die Trades übernommen werden. Dabei werden gleichzeitig automatisch die darunterliegenden Symbole/Titel der Trades einmalig mit aktualisiert. Über das Startdatum kann dabei der Umfang der Aktualisierung festgelegt werden. Der Abgleich erfolgt sowohl für Short-als auch Long-Trades. Die Konto-Bilanz (Liquidität) kann dabei mit berücksichtigt werden.

OnVista-Abgleich

OnVista bietet über das Webportal unter my onvista Möglichkeiten eigene Musterdepots und Watchlisten zu führen. Dabei können pro Titel auch Signale und Benachrichtigen versendet werden. Vor allem existiert eine Mobile-App, die auf den konfigurierten Datenbestand aufsetzt und sowohl eine Bearbeitung als auch Auswertung der eingetragenen Titel zulässt.

ShareHolder bietet aktuell keine eigene Mobile-App an, da hierfür auch die Daten-Provider-Infrastruktur genutzt werden müsste für eine aktuelle Depot-Bestandsanzeige. Es wird daher eine beidseitige Synchronisation der Daten angestrebt. Damit lassen sich Depottitel sowohl in onVista als auch in ShareHolder anlegen und dann per Klick in die andere Richtung synchronisieren.

Die Nutzung von ShareHolder in Kombination hat erhebliche Vorteile:

• Mobile Nutzung mit Echtzeitdaten aus OnVista

• Handelsstrategien zur Bewertung von Kauf-Kandidaten auf Basis von mobil gepflegten Watchlisten in ShareHolder

• Spätere automatische Signale durch Stop/Zielkursmarken die aus ShareHolder kommen

• Tiefenanalyse mittels Web-Recherche-Tools und Detail-Listen in ShareHolder, um insb. die Fundamentaldaten und technische Daten zu vergleichen

• Automatische Massendaten-Imports von den Konten und Brokern über ShareHolder und anschließend Übernahme per Klick in OnVista

Weitere Infos für die Mobile-App:

• (Android-App-Version)

• (iOS-App-Version)

Status der Entwicklung

Aktuell befindet sich die Entwicklung noch in einer ersten Beta-Version und es sind noch nicht alle Funktionalitäten umgesetzt und verfügbar.

1. Iteration (Version 21.10.0)

   1. Konfigurierte Portfolios, Watchlisten aus onVista auslesen

   2. Watchlisten aus onVista

      1. Watchlisten-Titel innerhalb einer konfigurierten Watchliste aus onVista auslesen

      2. Watchlisten-Titel übernehmen per Klick auf Einzeltitel-Ebene oder Gesamt aus onVista

      3. Automatischer Vergleich der Bestände zwischen einer ShareHolder-Watchliste und einer onVista-Liste

   3. Portfolio-Übernahme aus onVista

      1. Portfolio-Transaktionen innerhalb eines konfigurierten Portfolios aus onVista auslesen und darstellen

      2. Automatischer Vergleich der Bestände zwischen einer ShareHolder-Transaktionsliste und einer onVista-Portfolio-Transaktionsliste

2. Iteration (Version 21.10.1)

   1. Portfolio-Transaktionen zu ShareHolder übernehmen

3. Iteration (Version 21.10.3)

   1. Synchronisation in Richtung onVista für Portfolio-Titel

4. Iteration (in Arbeit)

   1. Synchronisation in Richtung onVista für Watchlisten-Titel

5. Iteration (TBD)

   1. Signal-Synchronisation für Stopp-Kurse oder Zielkurse

Anmeldung und Erstkonfiguration

Sie können sich bei onVista unter my onvista registrieren bzw. anmelden. Diese Anmeldedaten müssen Sie einmal nutzen, um einen Zugriffs-Code (Token) zu erzeugen in Shareholder. Sie müssen hierzu einmalig unter Einstellungen / Kursdaten - Datenanbieter - API-Keys gehen und dort unter dem Eintrag “onVista” einmalig den Nutzername und Kennwort eingeben und danach “API-Key ermitteln …” aufrufen. Sie erhalten so den Zugriffs-Code der automatisch unter dem Reiter “API-Key” übernommen wird. Dieser ist personalisiert auf Ihren Account und wird in allen nachfolgenden Funktionen benutzt.

Arbeit mit Watchlisten aus onVista

INITIALVERSION

Wenn Sie in onVista angemeldet sind in der Weboberfläche (App analog) haben Sie Zugriff auf Watchlisten. Dabei können auch Fremd-Watchlisten abonniert werden von Profi-Anlegern z.B. von Hamalaya Capital Management, Yale Universitry und weitere. ShareHolder kann diese Watchlisten beidseitig synchronisieren. In der aktuellen Iteration können Watchlisten von onVista zu ShareHolder übernommen werden.

Sie sehen automatisch alle enthaltenen Titel aus den onVista-Watchlisten. Sie haben auch Zugriff auf alle vorhandene definierten Watchlisten aus OnVista und können direkt zwischen diesen Wechseln. Wenn Sie auf der Ziel-Watchliste “<Neu>” auswählen, wird mit dem Hinzufügen von Titeln automatisch eine gleichnamige Watchliste angelegt. Sie können auch Einzel-Titel hinzufügen und über den Switch filtern, welche Titel bisher nicht lokal vorhanden waren.

Besonderheiten und Vorteile bei der Titel-Übernahme

Die Datenübernahme von Watchlisten-Titel umfasst automatisierte weitere Schritte, um die sofortige Arbeit mit den Watchlisten-Titeln zu ermöglichen:

Arbeit mit Portfolios aus onVista

INITIALVERSION

Nach Anmeldung im Webportal haben Sie neben den Watchlisten auch Zugriff auf die Musterdepots und Echtdepots. Dabei sind die definierten Musterdepots synchronisierungsfähig. Echtzeitdepots sind aktuell nicht angebunden, würden hier auch keine Transaktionsdaten zeigen, sondern nur den aktuellen Depot-Bestand.

Nutzung neuer bisher nicht genutzter Titel

Können bei der Übernahme von Watchlisten oder Portfolio-Titel Werte gefunden, die bisher in den Aktienstammdaten nicht vorhanden waren, werden diese automatisch importiert. Dabei wird versucht möglichst wenig Arbeit beim Nutzer zu verursachen: