====== AB-Transfers ======
{{ :wiki:progress:50.png?150|Fortschritt: 50% (Aktueller Projekt-Status)}}
AB-Transfers ist ein Programm um Überweisungen jeglicher Art Online durchzuführen. Es soll keine komplette Finanzverwaltung wie z.B. KMyMoney oder GnuCash werden, sondern parallel zu diesen verwendet werden können um Überweisungen durchzuführen die von anderen Programmen nicht unterstützt werden.
AB-Transfers ist für die private Nutzung gedacht. Es ist nicht geplant Funktionen die im gewerblichen Bereich sinnvoll sind zu implementieren.
AB-Transfers verwendet die Bibliothek [[http://www.aquamaniac.de/aqbanking/|AqBanking]]. Alle Transferarten die von AqBanking unterstützt werden, sollen in AB-Transfers verwendet werden können ((derzeit noch nicht alles implementiert, siehe Funktionsumfang)).
=== Motivation zur Erstellung von AB-Transfers ===
Ich nutze KMyMoney für die Verwaltung meiner Online-Konten. Da KMyMoney nur den Abruf der Umsätze unterstützt und auch andere Programme nicht alle Funktionalitäten bereitstellen habe ich mir gedacht dies in einem eigenem Programm zu realisieren. Bei dieser Gelegenheit kann ich mich auch weiter in Qt und C++ einarbeiten und lerne die AqBanking Bibliothek kennen.
Wann das Programm fertig sein wird und ob wirklich alle Transferarten umgesetzt werden kann ich momentan noch nicht beurteilen.
===== Links innerhalb des Wikis =====
* [[ab_transfer:Screenshots]]
* [[ab_transfer:ideen|Anmerkungen, Ideen, etc]] (frei bearbeitbar)
* [[ab_transfer:download|Download]]
* [[ab_transfer:changelog|Changelog]]
* [[ab_transfer:dev:todo|ToDo's]]
* [[ab_transfer:dev:info|Enwicklungs-Informationen]]
* [[ab_transfer:dev:widgets|Überweisungsformular]]
* [[:kontakt|Kontakt (E-Mail und PGP-Schlüssel)]]
* [[http://schmufu.dyndns.org/trac/abtransfers/|Fehlerberichte und Verbesserungen in trac]]
===== Funktionsumfang =====
Derzeit werden folgende Transaktionen unterstützt:
* Nationale Überweisung
* SEPA Überweisungen (AqBanking >= 5.0.27 erforderlich)
* Umbuchung
* Daueraufträge (Anlegen/Ändern/Löschen)
* Terminüberweisung (Anlegen/Ändern/Löschen)
Folgende Transaktionen werden **noch nicht** unterstützt:
* Internationale Überweisung
* SEPA Lastschrift
* Lastschriften
Das Abholen und verwalten von Umsätzen ist vorerst nicht geplant! Wie in der Einleitung beschrieben können dies andere Programme (KMyMoney, GnuCash, etc.) bereits sehr gut. Wenn alle Überweisungsarten fehlerfrei funktionieren und ich noch Zeit und Lust zur Weiterentwicklung habe könnte dies vielleicht irgendwann eingebracht werden.
===== Wichtige Hinweise =====
**Ich habe alles nach besten Wissen und Gewissen programmiert, allerdings kann ich nicht ausschließen das mir nicht doch an der ein oder anderen Stelle ein Fehler unterlaufen ist. Benutzung auf eigene Gefahr! Bitte erstellt vor der Benutzung ein Backup eurer Daten!**
Derzeit ist das Programm noch weit davon entfernt als fertig eingestuft werden zu können! \\
Bei Überweisungen wird derzeit auch noch ein Fehler im Log angezeigt, da Überweisungen erst von der Bank geprüft werden und der Anwendung nicht sofort mitgeteilt wird ob die Überweisung erfolgreich ist oder nicht. Wie ich dieses Verhalten in Zukunft beandeln werde weiß ich aber auch noch nicht genau.
===== Installationsanleitung =====
Da die Anwendung momentan noch in der Entwicklung ist und noch nicht für den produktiven Einsatz genutzt werden sollte,
existieren noch kaum Pakete zur einfachen Installation.
Für Debian und Ubuntu sind Pakete im entsprechenden //[[http://packages.debian.org/wheezy/abtransfers|wheezy]]// bzw. //[[https://launchpad.net/ubuntu/quantal/+package/abtransfers|quantal]]// Archiv verfügbar. Für Debian //[[http://packages.debian.org/testing/abtransfers|testing]]// stehen auch neuere Versionen zur Verfügung.
Anwender, die bereits jetzt schon die Entwicklungsversionen von Debian oder Ubuntu nutzen,
können also das Paket //abtransfers// einfach über die übliche Paketverwaltung installieren.
Wer die Anwendung testen möchte kann sich den entsprechenden Quelltext entweder direkt aus dem subversion repository holen oder das angebotene source-Archiv herunterladen und selbst kompilieren.
Für das Kompilieren werden die header-Dateien von Qt, AqBanking und gwenhywfar benötigt!
Dazu das folgende in der shell unter Linux ausführen:
**Quelltext direkt aus dem subversion repository** (X.X.X.X durch die Versionsnummer ersetzen)
# Quelltext aus dem repository holen
svn co http://schmufu.dyndns.org/svn/ab_transfers/tags/X.X.X.X abtransfers
#für die aktuelle Entwicklung kann auch "trunk" ausgecheckt werden, dieser
#Pfad kann aber auch Fehler die nicht kompiliert werden können enthalten!
#svn co http://schmufu.dyndns.org/svn/ab_transfers/trunk abtransfers
# in das neu erstellte Verzeichniss (abtransfers) wechseln
cd abtransfers
# qmake und make ausführen damit alles kompiliert wird
qmake
make
#in dem Verzeichniss 'build' befindet sich dann die ausführbare Anwendung.
#um diese zu starten folgendes Eingeben
./build/abtransfers
**Quelltext aus dem source-Archiv** (X.X.X.X durch die Versionsnummer ersetzen)
# Quelltext-Archiv herunterladen
wget http://schmufu.dyndns.org/abtransfers/source/abtransfers-X.X.X.X.tar.bz2
# Archiv entpacken
tar -xjf abtransfers-X.X.X.X.tar.bz2
# in das neu erstellte Verzeichniss wechseln
cd abtransfers-X.X.X.X
# qmake und make ausführen damit alles kompiliert wird
qmake
make
#in dem Verzeichniss 'build' befindet sich dann die ausführbare Anwendung.
#um diese zu starten folgendes Eingeben
./build/abtransfers
Sofern noch keine Online-Konten in AqBanking eingerichtet sind kann dies jetzt über "Einstellungen -> AqBanking einrichten ..." geschehen. Neu erstellte oder geänderte Konten können dann sofort in AB-Transfers verwendet werden.
===== Weiterführende Links =====
* [[http://schmufu.dyndns.org/doxy/abTransfers|doxygen doku von AB-Transfers]]
* [[http://schmufu.dyndns.org/doxy/aqbanking-5.0.5|doxygen doku von AqBanking-5.0.5]]
* [[http://schmufu.dyndns.org/doxy/gwenhywfar-4.0.9|doxygen doku von gwenhywfar-4.0.9]]