Dies ist eine alte Version des Dokuments!
Inhaltsverzeichnis
E-Banking Splitter für PROFFIX
Mit diesem Tool können E-Bankingeinträge aus PROFFIX gesplittet und aufgeteilt werden. Die Splittung erfolgt mittels Regex und einer einfachen Berechnungssyntax, was auch anspruchsvolle Aufteilungen möglich macht.
Vereinfacht macht das Tool folgendes:
Original mit einzelnen, kombinierten Bewegungen mit Gebühren, Kommissionen etc.
Mit E-Banking Splitter automatisch aufgesplittete Bewegungen
Die so aufgesplitteten Kontobewegungen können anschliessend automatisch über PROFFIX verbucht werden.
Konfiguration
Sämtliche Konfiguration erfolgt über eine config.json welche sich im selben Verzeichnis wie das Tool befinden muss.
Beispiel
{ "Licence": "", "Database": { "Username": "sa", "Password": "1234", "Database": "DEMODB", "Instance": "PROFFIX", "Hostname": "SQLSERVER1", "Port": 1433, "Parameter": "?connection+timeout=30" }, "Filter": [{ "Contains": "", "DateFrom": "01.01.2018", "DateTo": "31.12.2018", "Regex": " KOM (.*?) TRX", "Original": { "Calculation": "ES_Betrag", "PostingText": "ORIGINAL ES_Buchungstext" }, "Splitted": { "Calculation": "ES_Kommission*(-1)", "PostingText": "SPLITTED ES_Buchungstext" } }, { "Contains": "DEMO PROVIDER", "DateFrom": "01.01.2018", "DateTo": "31.12.2018", "Regex": " KOMM(.*?)", "Original": { "Calculation": "ES_Betrag", "PostingText": "ES_Buchungstext" }, "Splitted": { "Calculation": "ES_Kommission*(-1)", "PostingText": "Kommission ES_Buchungstext" } } ], "Reset": { "Active": false, "DateFrom": "01.01.2018", "DateTo": "31.12.2018" } }
Parameter
Licence
Hier muss die Lizenz angegeben werden. Die Lizenz erhalten Sie von uns.
Demolizenz Das Tool ruft beim ersten Start automatisch eine Demolizenz ab und passt das config.json File damit an. Zusätzlich wird die entsprechende Lizenz an die angegebene Emailadresse gesendet.
Database
Parameter | Typ | Bemerkung |
---|---|---|
Username | string | Benutzername SQL - Server |
Password | string | Passwort SQL - Server |
Database | string | PROFFIX Datenbank |
Instance | string | Wenn vorhanden: Instanz des SQL - Servers |
Hostname | string | Hostname des SQL - Servers; kann auch IP sein |
Port | int | Port des SQL Servers |
Parameter | string | Div. Parameter für SQL-Server |
Single-Sign-On unter Windows wird unterstützt, d.h. wenn der ausführende Benutzer genügenden administrative Berechtigungen hat um die PROFFIX Datenbank zu bearbeiten kann sowohl Username wie auch Password leer gelassen werden.
Filter
Mit folgenden Filtern wird die Aufteilung der E-Banking Bewegung gesteuert. Der Betrag stammt jeweils aus der Regex Auswahlgruppe.
Parameter | Typ | Optional | Bemerkung |
---|---|---|---|
Contains | string | ja | Zusätzliche Bedingung welche prüft ob ein Wort in der Bewegung enthalten ist. Die Aufteilung wird nur vorgenommen, wenn diese zutrifft! |
Regex | string | Regex - Ausdruck mit Selektion | |
DateFrom | date | ja | Zusätzliche Bedingung welche nur Bewegungen ab diesem Datum splittet |
DateTo | date | ja | Zusätzliche Bedingung welche nur Bewegungen bis zu diesem Datum splittet |
Original | array | Siehe nächste Tabelle | |
Splitted | array | Siehe nächste Tabelle |
Original / Splitted
Parameter | Typ | Optional | Bemerkung |
---|---|---|---|
PostingText | string | Zu erstellender Buchungstext; Platzhalter können verwendet werden. | |
Calculation | string | Die Berechnung des Betrages; Platzhalter können verwendet werden. |
Berechnungsbeispiele:
"Calculation": "ES_Kommission*(-1)" // Schreibt Kommission als Belastung "Calculation": "ES_Kommission" // Schreibt Kommission als Vergütung "Calculation": "ES_Betrag-ES_Kommission" // Zieht Kommission vom Originalbetrag ab
Buchungstext / Berechnung Platzhalter
Der Buchungstext und die Berechnung für die gesplittete Kommissionsbewegung kann mit Platzhaltern angereichert werden:
Platzhalter | Effekt |
---|---|
ES_Kommission | Kommissionsbetrag (gemäss Regex) |
ES_Buchungstext | Original-Buchungstext |
ES_Betrag | Betrag der Original - Buchungsbewegung |
ES_BetragSW | BetragSW |
ES_Datum | Datum der Bewegung |
Beispiel:
"PostingText": "KOMMISSION #Kommission# #Datum# #Buchungstext#"
Der entsprechende Regex-Ausdruck kann z.B. mittels Online - Tools wie etwa Regex101.com erstellt werden. Ein effektives Beispiel finden Sie hier. Der Betrag für die Aufteilung wird jeweils nur aus der Selektionsgruppe 1 genommen.
Reset
Parameter | Typ | Optional | Bemerkung |
---|---|---|---|
Active | bool | Reset wird nur durchgeführt wenn wahr | |
DateFrom | date | ja | Einschränkungskriterium für Reset |
DateTo | date | ja | Einschränkungskriterium für Reset |
Damit die E-Bankingbelege korrekt zurückgesetzt werden können, schreibt der E-Banking Splitter sämtliche Logs inkl. der jeweiligen PROFFIX - Versionen und LaufNr in eine Zusatztabelle PITW_EbankingSplitter.
Installation
Der E-Banking Splitter besteht aus einer einzigen, ausführbaren Datei und muss entsprechend nicht installiert sondern einfach ausgeführt werden. Einige Möglichkeiten, um diesen besser in PROFFIX zu integrieren:
Verknüpfung in PROFFIX
Die Verknüpfung in PROFFIX kann an mehreren Orten erfolgen und anschliessen per Klick ausgeführt werden.
Weitere Möglichkeiten
Weitere Möglichkeiten für die automatisierte Ausführung sind etwa:
- Windows Aufgabenplaner; Aufgabe erstellen um E-Banking Splitter periodisch auszuführen
- Datenbank Trigger; Bei CREATE in FIB_CCBewegungen E-Banking Splitter ausführen
Startparameter
Folgende Startparameter sind möglich:
Parameter | Typ | Hinweis |
---|---|---|
-update | bool | Prüft, ob eine neuere Version des E-Banking Splitters vorhanden ist. |
-cfg-path | Pfad | Pfad zu einem alternativen Konfiguration (z.B für mehrere Mandanten) |
-cfg-name | Dateiname | Alternativer Konfigurationsname (anstelle von config.json); Es darf nur der Name ohne Endung angegeben werden. |
-help | Zeigt die obigen Befehle an |
Beispiele:
go-proffix-ebanking-splitter.exe -cfg-path=C:\Test -cfg-name=config -update=true go-proffix-ebanking-splitter.exe -cfg-path=C:\Demo -cfg-name=config go-proffix-ebanking-splitter.exe -cfg-name=mandant1
Download
Die aktuellste Version kann jeweils hier heruntergeladen werden (inkl. kostenloser Demoversion):
Auf Updates kann mit dem Parameter -update=true geprüft werden - der E-Banking Splitter aktualisiert sich dann selbst.
Beispiel:
C:\go-proffix-ebanking-splitter.exe -update=true
Changelog
Version 1.8 (aktuell)
- Bugfix Demolizenz
- kl. Anpassungen Logformatierung
Version 1.7
- Refractoring
- Upgrade Lizenzsystem (neu: per Gerät)
- kl. Bugs / Performance
Version 1.6
- Fix Problem mit Filter Content
- Umstellung Reset-Funktion auf Zusatztabelle
Version 1.5
- Aufteilung in Splitted / Original
- Platzhalter / Berechnungen für Splitbuchungen