Datenbankverwaltung

Datenbankverwaltung

OpenSchichtplaner5 arbeitet direkt mit den originalen DBF-Datenbankdateien von Schichtplaner5 im FoxPro-Format. Dieses Kapitel erklärt, wie die Datenbankverbindung konfiguriert und verwaltet wird.

Datenbankformat

Die Schichtplaner5-Datenbank besteht aus mehreren .DBF-Dateien im FoxPro-Format, die sich alle in einem gemeinsamen Ordner befinden (üblicherweise der Daten-Ordner der SP5-Installation).

Wichtige Datenbankdateien (Auswahl):

Datei	Inhalt
5EMPL.DBF	Mitarbeiterstammdaten
5ABSEN.DBF	Abwesenheiten & Dienstplaneinträge
5SPSHI.DBF	Spezielle Schichteinträge
5SHIFT.DBF	Schichtartdefinitionen
5GROUP.DBF	Gruppen / Abteilungen
5GRASG.DBF	Gruppenassoziationen (Mitarbeiter↔Gruppe)
5LEAVT.DBF	Abwesenheitsarten
5LEAEN.DBF	Urlaubsansprüche
5HOLID.DBF	Feiertage
5HOBAN.DBF	Urlaubssperrtage
5CYCLE.DBF	Schichtmodelle (Zyklen)
5CYASS.DBF	Schichtmodell-Zuordnungen
5CYENT.DBF	Zykluseinträge
5CYEXC.DBF	Zyklusausnahmen
5SHDEM.DBF	Allgemeiner Personalbedarf
5SPDEM.DBF	Besonderer Personalbedarf
5DADEM.DBF	Tagesbezogener Bedarf
5WOPL.DBF	Arbeitsplätze / Arbeitsstätten
5XCHAR.DBF	Zulagen (Extra Charges)
5BOOK.DBF	Zeitkonto-Buchungen
5OVER.DBF	Überstunden
5NOTE.DBF	Notizen
5PERIO.DBF	Abrechnungszeiträume
5USER.DBF	Benutzerkonten
5USETT.DBF	Benutzereinstellungen
5RESTR.DBF	Schichteinschränkungen
5MASHI.DBF	Maschinenschichten
5BUILD.DBF	Gebäude / Standorte

Datenbankordner konfigurieren

Der Pfad zur Datenbank wird beim Start des Backends als Umgebungsvariable übergeben:

SP5_DB_PATH=/pfad/zu/sp5/Daten uvicorn sp5api.main:app --host 0.0.0.0 --port 8000

Der Pfad muss auf den Ordner zeigen, der die .DBF-Dateien enthält — nicht auf eine einzelne Datei.

Datenbank öffnen

Nach dem Start des Backends liest OpenSchichtplaner5 automatisch alle Datenbankdateien aus dem konfigurierten Ordner. Es ist kein manuelles Öffnen der Datenbank notwendig.

Beim Start werden folgende Prüfungen durchgeführt:

• Existiert der konfigurierte Datenbankordner?
• Sind die wichtigsten DBF-Dateien vorhanden?
• Sind die Dateien lesbar (Dateisystem-Berechtigungen)?

Fehler werden in der Konsole ausgegeben.

Neue Datenbank anlegen

Wenn du OpenSchichtplaner5 ohne bestehende SP5-Daten nutzen möchtest, kannst du eine leere Datenbank anlegen:

1. Erstelle einen leeren Ordner für die Datenbank
2. Starte das Backend mit SP5_DB_PATH=/pfad/zum/leeren/ordner
3. Das Backend legt automatisch die notwendigen DBF-Dateien mit leeren Tabellen an
4. Trage nun die Stammdaten über die Oberfläche ein (Gruppen, Schichtarten, Mitarbeiter, ...)

Parallelbetrieb mit Original SP5

OpenSchichtplaner5 und das Original Schichtplaner5 können gleichzeitig auf denselben DBF-Dateien arbeiten — solange nicht beide Programme gleichzeitig schreiben. Empfohlene Vorgehensweise:

• Original SP5 für komplexe Funktionen nutzen, die noch nicht in OpenSP5 implementiert sind
• OpenSP5 für die tägliche Planung und den Browser-Zugriff
• Regelmäßige Backups erstellen

⚠️ Hinweis: CDX-Indexdateien (.CDX) werden von OpenSchichtplaner5 nicht geschrieben. Das Original SP5 baut diese beim nächsten Start automatisch neu auf — das ist normales Verhalten.

Datenbankpflege

• Backups regelmäßig erstellen (täglich empfohlen) → Backup
• Defekte Einträge können über die Stammdaten-Seiten korrigiert werden
• Datenbankgröße: DBF-Dateien wachsen kontinuierlich. Das Original SP5 bietet eine Pack-Funktion (Verdichten), die gelöschte Datensätze endgültig entfernt.

---

➡️ Verwandte Seiten: Backup | Import | Einleitung