kleberj – bankstatement.cls

Feliz Navidad y un Feliz Año Nuevo

kleberj 24. Dezember 2016 0 Kommentare

bankstatement 0.9.2 im CTAN verfügbar

kleberj 16. November 2015 0 Kommentare

Seit Kurzem ist die neue Version 0.9.2 von bankstatement im CTAN verfügbar (siehe Ankündigung (ctan-ann@ctan.org)). Hier ein kurzer Auszug der Neuerungen im README:

Changes in v0.9.2:

* use of siunitx to force two decimals, if csv data contains
other formats like 16.2 -> 16.20

* added support for Standard Bank (Namibia) and namibian

feature requests by Dr. Eberhard Lisse

* organized package in dtx format

Das Update sollte in Kürze auch in TeXLive und in MiKTeX verfügbar sein!

bankstatement, develop

bankstatement, CTAN

HowTo: Unterstützung für andere Sprachen

kleberj 13. November 2015 0 Kommentare

#bankstatement #howto

Am Beispiel der neuen Datei stmnamibian.def möchte ich mal kurz erläutern, wie man andere Sprachen unterstützen kann. Man erkennt sofort, daß der Dateiname dem Muster stmSPRACHE.def folgen muß. Zunächst betrachten wir die Definitionsdatei für englisch:

\renewcommand*\STM@JK@holdername{Account Holder}%
\renewcommand*\STM@JK@bicname{BIC}%
\renewcommand*\STM@JK@ibanname{IBAN}%
\renewcommand*\STM@JK@firstcolumnheading{\bfseries Date}%
\renewcommand*\STM@JK@secondcolumnheading{\bfseries Reference}%
\renewcommand*\STM@JK@thirdcolumnheading{\bfseries Amount (GBP)}%
\renewcommand*\STM@JK@openingbalancename{Opening Balance}%
\renewcommand*\STM@JK@closingbalancename{Closing Balance}%
\sisetup{output-decimal-marker={.}}%
\endinput

1

2

3

4

5

6

7

8

9

10

\renewcommand*\STM@JK@holdername{Account Holder}%

\renewcommand*\STM@JK@bicname{BIC}%

\renewcommand*\STM@JK@ibanname{IBAN}%

\renewcommand*\STM@JK@firstcolumnheading{\bfseries Date}%

\renewcommand*\STM@JK@secondcolumnheading{\bfseries Reference}%

\renewcommand*\STM@JK@thirdcolumnheading{\bfseries Amount (GBP)}%

\renewcommand*\STM@JK@openingbalancename{Opening Balance}%

\renewcommand*\STM@JK@closingbalancename{Closing Balance}%

\sisetup{output-decimal-marker={.}}%

\endinput

Möchte man nun eine namibische Bank unterstützen, bedarf es natürlich der Änderung der Währung (3. Spalte) und der SEPA-Bezeichnungen BIC und IBAN:

\renewcommand*\STM@JK@holdername{Account Holder}%
\renewcommand*\STM@JK@bicname{Branch Code}%
\renewcommand*\STM@JK@ibanname{Account Number}%
\renewcommand*\STM@JK@firstcolumnheading{\bfseries Date}%
\renewcommand*\STM@JK@secondcolumnheading{\bfseries Reference}%
\renewcommand*\STM@JK@thirdcolumnheading{\bfseries Amount (NAD)}%
\renewcommand*\STM@JK@openingbalancename{Opening Balance}%
\renewcommand*\STM@JK@closingbalancename{Closing Balance}%
\sisetup{output-decimal-marker={.}}%
\endinput

1

2

3

4

5

6

7

8

9

10

\renewcommand*\STM@JK@holdername{Account Holder}%

\renewcommand*\STM@JK@bicname{Branch Code}%

\renewcommand*\STM@JK@ibanname{Account Number}%

\renewcommand*\STM@JK@firstcolumnheading{\bfseries Date}%

\renewcommand*\STM@JK@secondcolumnheading{\bfseries Reference}%

\renewcommand*\STM@JK@thirdcolumnheading{\bfseries Amount (NAD)}%

\renewcommand*\STM@JK@openingbalancename{Opening Balance}%

\renewcommand*\STM@JK@closingbalancename{Closing Balance}%

\sisetup{output-decimal-marker={.}}%

\endinput

bankstatement, howto, language

HowTo: Unterstützung für beliebige csv-Formate

kleberj 12. November 2015 0 Kommentare

#bankstatement #howto

Am Beispiel der neuen csv-Formatdatei csv-standard-bank-na.def möchte ich hier mal hoffentlich allgemeinverständlich erklären, wie man mehr oder wenig beliebige csv-Formate unterstützen kann. Nimm einfach eine der existierenden Dateien und passe sie entsprechend an!

\renewcommand*\STM@JK@dbkeys{ValueDate,PostingDate,Reference,Narrative,Amount,Balance}%
\renewcommand*\STM@JK@DTLforeach%
{%
  \DTLforeach{\STM@JK@dbname}%
  {\postingdate=PostingDate,\valuedate=ValueDate,\reference=Reference,\narrative=Narrative,\amount=Amount,\balance=Balance}%
  {%
    \parbox[t]{\widthof{ (YYYY-MM-DD) }}{\leavevmode\hphantom{(}\postingdate\\(\valuedate)} &%
    \parbox[t]{\STM@JK@referencewidth}{\raggedright%
                                       \DTLifstringeq{\reference}{}{}{\reference\\}%
                                       \DTLifstringeq{\narrative}{}{}{\narrative\\}%
                                      } &%
    \parbox[t]{\widthof{1234567.89)}}{\raggedleft\DTLifStartsWith{\amount}{-}{\textcolor{\STM@JK@negativecolor}{\num{\amount}\hphantom{)}}}{\num{\amount}\hphantom{)}}\\(\num{\balance})}
    \DTLiflastrow{%
                   \ifthenelse{\equal{\STM@JK@closingbalance}{none}}%
                   {}%
                   {\\\midrule\\ & \STM@JK@closingbalancename & \DTLifStartsWith{\STM@JK@closingbalance}{-}%
                    {\textcolor{\STM@JK@negativecolor}{\num{\STM@JK@closingbalance}}}{\num{\STM@JK@closingbalance}}}%
                   \\\bottomrule%
                 }%
                 {\\ & & \\}%
  }%
}%
\DTLsetseparator{,}%
\renewcommand*\STM@JK@noheader{false}%
\sisetup{detect-all,round-integer-to-decimal,round-mode=places,round-precision=2}%

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

\renewcommand*\STM@JK@dbkeys{ValueDate,PostingDate,Reference,Narrative,Amount,Balance}%

\renewcommand*\STM@JK@DTLforeach%

{%

\DTLforeach{\STM@JK@dbname}%

{\postingdate=PostingDate,\valuedate=ValueDate,\reference=Reference,\narrative=Narrative,\amount=Amount,\balance=Balance}%

{%

\parbox[t]{\widthof{ (YYYY-MM-DD) }}{\leavevmode\hphantom{(}\postingdate\\(\valuedate)} &%

\parbox[t]{\STM@JK@referencewidth}{\raggedright%

\DTLifstringeq{\reference}{}{}{\reference\\}%

\DTLifstringeq{\narrative}{}{}{\narrative\\}%

} &%

\parbox[t]{\widthof{1234567.89)}}{\raggedleft\DTLifStartsWith{\amount}{-}{\textcolor{\STM@JK@negativecolor}{\num{\amount}\hphantom{)}}}{\num{\amount}\hphantom{)}}\\(\num{\balance})}

\DTLiflastrow{%

\ifthenelse{\equal{\STM@JK@closingbalance}{none}}%

{}%

{\\\midrule\\ & \STM@JK@closingbalancename & \DTLifStartsWith{\STM@JK@closingbalance}{-}%

{\textcolor{\STM@JK@negativecolor}{\num{\STM@JK@closingbalance}}}{\num{\STM@JK@closingbalance}}}%

\\\bottomrule%

}%

{\\ & & \\}%

}%

\DTLsetseparator{,}%

\renewcommand*\STM@JK@noheader{false}%

\sisetup{detect-all,round-integer-to-decimal,round-mode=places,round-precision=2}%

Zunächst legt man die Reihenfolge der Schlüssel in der csv-Datei fest.

TeX

\renewcommand*\STM@JK@dbkeys{ValueDate,PostingDate,Reference,Narrative,Amount,Balance}%

1

\renewcommand*\STM@JK@dbkeys{ValueDate,PostingDate,Reference,Narrative,Amount,Balance}%

Danach definiert man \STM@JK@DTLforeach ; ein Makro das die csv-Datei zeilenweise einliest und als LaTeX-Tabellenzeile ausgibt. Es nutzt dazu das \DTLforeach Makro (datatool.sty)

\renewcommand*\STM@JK@DTLforeach%
{%
  \DTLforeach{\STM@JK@dbname}%
  {\postingdate=PostingDate,\valuedate=ValueDate,\reference=Reference,\narrative=Narrative,\amount=Amount,\balance=Balance}%
  {%
    \parbox[t]{\widthof{ (YYYY-MM-DD) }}{\leavevmode\hphantom{(}\postingdate\\(\valuedate)} &%
    \parbox[t]{\STM@JK@referencewidth}{\raggedright%
                                       \DTLifstringeq{\reference}{}{}{\reference\\}%
                                       \DTLifstringeq{\narrative}{}{}{\narrative\\}%
                                      } &%
    \parbox[t]{\widthof{1234567.89)}}{\raggedleft\DTLifStartsWith{\amount}{-}{\textcolor{\STM@JK@negativecolor}{\num{\amount}\hphantom{)}}}{\num{\amount}\hphantom{)}}\\(\num{\balance})}
    \DTLiflastrow{%
                   \ifthenelse{\equal{\STM@JK@closingbalance}{none}}%
                   {}%
                   {\\\midrule\\ & \STM@JK@closingbalancename & \DTLifStartsWith{\STM@JK@closingbalance}{-}%
                    {\textcolor{\STM@JK@negativecolor}{\num{\STM@JK@closingbalance}}}{\num{\STM@JK@closingbalance}}}%
                   \\\bottomrule%
                 }%
                 {\\ & & \\}%
  }%
}%

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

\renewcommand*\STM@JK@DTLforeach%

{%

\DTLforeach{\STM@JK@dbname}%

{\postingdate=PostingDate,\valuedate=ValueDate,\reference=Reference,\narrative=Narrative,\amount=Amount,\balance=Balance}%

{%

\parbox[t]{\widthof{ (YYYY-MM-DD) }}{\leavevmode\hphantom{(}\postingdate\\(\valuedate)} &%

\parbox[t]{\STM@JK@referencewidth}{\raggedright%

\DTLifstringeq{\reference}{}{}{\reference\\}%

\DTLifstringeq{\narrative}{}{}{\narrative\\}%

} &%

\parbox[t]{\widthof{1234567.89)}}{\raggedleft\DTLifStartsWith{\amount}{-}{\textcolor{\STM@JK@negativecolor}{\num{\amount}\hphantom{)}}}{\num{\amount}\hphantom{)}}\\(\num{\balance})}

\DTLiflastrow{%

\ifthenelse{\equal{\STM@JK@closingbalance}{none}}%

{}%

{\\\midrule\\ & \STM@JK@closingbalancename & \DTLifStartsWith{\STM@JK@closingbalance}{-}%

{\textcolor{\STM@JK@negativecolor}{\num{\STM@JK@closingbalance}}}{\num{\STM@JK@closingbalance}}}%

\\\bottomrule%

}%

{\\ & & \\}%

}%

Als erstes Argument übergibt man den Namen der csv-Datei. Keine Änderung!
Im zweiten Argument mappt man die csv-Schlüssel auf Makros

Im dritten und letzten Argument erfolgt die Ausgabe der dreispaltigen Tabellenzeile

In der ersten Spalte erfolgt die Ausgabe des Buchungs- und Wertstellungstags

TeX

\parbox[t]{\widthof{ (YYYY-MM-DD) }}{\leavevmode\hphantom{(}\postingdate\\(\valuedate)} &%

1

\parbox[t]{\widthof{ (YYYY-MM-DD) }}{\leavevmode\hphantom{(}\postingdate\\(\valuedate)} &%

In der zweiten Spalte wird der Verwendungszweck ausgegeben, der aus mehreren csv-Schlüsseln aufgebaut sein kann.

\parbox[t]{\STM@JK@referencewidth}{\raggedright%
                                   \DTLifstringeq{\reference}{}{}{\reference\\}%
                                   \DTLifstringeq{\narrative}{}{}{\narrative\\}%
                                  } &%

1

2

3

4

\parbox[t]{\STM@JK@referencewidth}{\raggedright%

\DTLifstringeq{\reference}{}{}{\reference\\}%

\DTLifstringeq{\narrative}{}{}{\narrative\\}%

} &%

In der dritten Spalte erfolgt die Ausgabe des Betrags. Ein negativer Betrag wird dabei in Rot (negativcolor Option) gesetzt

\parbox[t]{\widthof{1234567.89)}}{\raggedleft\DTLifStartsWith{\amount}{-}{\textcolor{\STM@JK@negativecolor}{\num{\amount}\hphantom{)}}}{\num{\amount}\hphantom{)}}\\(\num{\balance})}

1	\parbox[t]{\widthof{1234567.89)}}{\raggedleft\DTLifStartsWith{\amount}{-}{\textcolor{\STM@JK@negativecolor}{\num{\amount}\hphantom{)}}}{\num{\amount}\hphantom{)}}\\(\num{\balance})}

Abschließend erfolgt ein Test auf die letzte Datenzeile und die Ausgabe des Schlußsaldos bzw. einer Leerzeile

\DTLiflastrow{%
               \ifthenelse{\equal{\STM@JK@closingbalance}{none}}%
               {}%
               {\\\midrule\\ & \STM@JK@closingbalancename & \DTLifStartsWith{\STM@JK@closingbalance}{-}{\textcolor{\STM@JK@negativecolor}{\num{\STM@JK@closingbalance}}}{\num{\STM@JK@closingbalance}}}%
               \\\bottomrule%
             }%
             {\\ & & \\}%

1

2

3

4

5

6

7

\DTLiflastrow{%

\ifthenelse{\equal{\STM@JK@closingbalance}{none}}%

{}%

{\\\midrule\\ & \STM@JK@closingbalancename & \DTLifStartsWith{\STM@JK@closingbalance}{-}{\textcolor{\STM@JK@negativecolor}{\num{\STM@JK@closingbalance}}}{\num{\STM@JK@closingbalance}}}%

\\\bottomrule%

}%

{\\ & & \\}%

Im letzten Schritt definieren wir den Trenner der csv-Datei und legen fest, ob sie über eine Kopfzeile verfügt (Achtung: header → noheader=false! (noheader Option (datatool.sty))). Die letzte Zeile kann man überlicherweise einfach kopieren (siunitx-Setup)!

TeX

\DTLsetseparator{,}% \renewcommand*\STM@JK@noheader{false}% \sisetup{detect-all,round-integer-to-decimal,round-mode=places,round-precision=2}%

1
2
3

\DTLsetseparator{,}%
\renewcommand*\STM@JK@noheader{false}%
\sisetup{detect-all,round-integer-to-decimal,round-mode=places,round-precision=2}%

Damit gelingt hoffentlich die Anpassung und Unterstützung anderer csv-Formate! 😉

Unterstützung für namibisch und Standard Bank (Namibia)

kleberj 11. November 2015 0 Kommentare

#bankstatement #develop

Die neueste Version von bankstatement enthält jetzt auch eine angepasste Sprachdatei für namibisch. Zusätzlich wird nun auch das csv-Format der Standard Bank (Namibia) unterstützt.

bankstatement, develop

bankstatement, csv, language

siunitx zur Rundung auf exakt 2 Nachkommastellen

kleberj 10. November 2015 0 Kommentare

#bankstatement #develop

Die neueste Version von bankstatement stellt sicher, daß die Kontobewegungen mit genau zwei Nachkommastellen ausgegeben werden. Insbesondere auch dann, wenn in der csv-Datei beispielsweise der Betrag mit 16,2€ gespeichert ist (16,2 → 16,20).

Zusätzlich ermöglicht die Verwendung von siunitx die Festlegung des Dezimaltrenners in Abhängigkeit der Sprache – jedoch unabhängig von der Notation in der csv-Datei, wie z.B. \sisetup{output-decimal-marker={,}} in der Datei stmgerman.def!

bankstatement, develop

bankstatement, siunitx

bankstatement.jklatex.de online

kleberj 7. November 2015 0 Kommentare

Hello World or bankstatement.jklatex.de!

Willkommen auf der neuen Homepage der LaTeX-Klasse bankstatement. Hier findet ihr zukünftig Beispiele, neue Features oder alles Neue rund um bankstatement.cls!