Skip to content

Commit

Permalink
Improved README and added logs folder
Browse files Browse the repository at this point in the history
  • Loading branch information
DavidKrassnig committed Oct 23, 2023
1 parent 2719abf commit 8f4e633
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 1 deletion.
24 changes: 23 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,24 @@
# UBFFM Buchungsjournal Splitter
This is a small script to split up the bulk PDF file generated by the journaling system used by the University Library of Goethe University Frankfurt.
Dies sind zwei Python-Skripte, die ich für die digitale Verteilung von Buchungsjournale an der UBFFM erstellt habe.

## Installation
Um die Skripte einwandfrei laufen lassen zu können, benötigt man Python 3.x und folgende Libraries, die nicht standardmäßig inkludiert sind: PyMuPDF, pywin32, tqdm

Für das E-Mail-Skript muss Outlook auf dem lokalen Rechner installiert sein.

## Nutzung
### Splitter
Um eine Buchungsjournal-Sammel-PDF-Datei in die einzelnen Buchungsjournale zu spalten, muss sich die entsprechende PDF-Datei in demselben Ordner wie die Skriptdatei befinden. Danach gibt es zwei Optionen: Entweder man gibt beim Aufruf des Skriptes explizit an, welche PDF-Datei gesplittet werden soll oder man führt das Skript aus, ohne dies zu spezifizieren. Im letzteren Fall werden einfach alle PDF-Dateien, die sich im Ordner befinden gesplittet.

Die gesplitteten Buchungsjournale befinden sich nach der Ausführung des Skripts in dem Unterordner "buchungsjournale" und sind dort jeweils nach Zeitraum und Abteilung sortiert.

#### E-Mail
Nachdem durch den Splitter Buchungsjournale in die entsprechenden Unterordner verteilt worden sind, kann das E-Mail-Skript aufgerufen werden, um diese automatisch an alle entsprechenden Mitarbeiter zu versenden. Damit dies funktioniert müssen folgende Konditionen erfüllt sein:
* Es besteht eine personal_db.csv Datei und sie wurde mit den entsprechenden Informationen gefüllt
* Es existiert mindestens ein Buchungsjournal
* Es muss Outlook auf dem lokalen Rechner installiert sein
* Der spezifizierte E-Mail-Account muss in der lokalen Outlook-Installation eingerichtet sein

Sind diese Bedingungen erfüllt, so kann man über das Auswahl-Menü entscheiden, welcher Zeitraum verschickt werden soll und ob innerhalb des ausgewählten Zeitraumes alle Buchungsjournale oder nur die Buchungsjournale einer bestimmten Abteilung verschickt werden sollen.

Sollte ein Mitarbeiter ein Buchungsjournal erhalten sollen, hat aber keinen entsprechenden Eintrag in personal_db.csv, so wird dies in der produzierten Log-Datei protokolliert und es wird auch direkt nach Abschluss des Skriptes angezeigt, wie viele E-Mails erfolgreich verschickt werden konnten.
1 change: 1 addition & 0 deletions logs/dummy
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
This is just a dummy file so Github records the otherwise empty log folder

0 comments on commit 8f4e633

Please sign in to comment.