Hilfe und Dokumentation

Alles zu Einrichtung, Bedienung, Konfiguration und Betrieb von local-database, Version 9 (13.10.2026).

Schnellstart

  1. Leeren Ordner auf dem Netzlaufwerk anlegen, z. B. R:\Daten\Register.
  2. local-database.html über die Download-Seite herunterladen (Download-Code gibt es auf Anfrage) und in diesen Ordner kopieren.
  3. Die Datei in Edge oder Chrome öffnen (Doppelklick).
  4. „Datenordner wählen“ und den Ordner bestätigen.
  5. Dateizugriff auf den Ordner erlauben: Die Frage des Browsers mit „Dateien bearbeiten“ bzw. „Zulassen“ bestätigen. Beim ersten Start werden dann die nötigen Dateien angelegt.
  6. Kürzel (2–4 Buchstaben, je Person eindeutig) und Namen eingeben.
  7. Optional: Altbestand über CSV importieren übernehmen.
Startbildschirm von local-database mit den Schaltflächen „Datenordner wählen“ und „Demo ohne Ordner starten“ und dem Hinweis zum Dateizugriff
Beim ersten Start: Datenordner wählen und den Dateizugriff im Browser erlauben.

Danach öffnet sich der Ordner bei jedem Start automatisch. Fragt der Browser bei einem späteren Start erneut nach dem Zugriff, wieder erlauben; bietet er „Bei jedem Besuch zulassen“ an, diese Option wählen.

Alle Nutzer öffnen dieselbe HTML-Datei aus dem Datenordner. So arbeiten alle mit derselben Programmversion. Die Versionsnummer steht oben neben dem Titel.

Demo-Modus

Öffnen Sie local-database.html und klicken Sie auf „Demo ohne Ordner starten“. Die Demo erzeugt 320 fiktive Vorgänge nur im Speicher des Browsers. Beim Schließen ist alles wieder weg; es wird nichts übertragen.

Für einen Test mit realistischer Datenmenge gibt es auf der Download-Seite demodaten_10000.csv mit 10.000 fiktiven Vorgängen und 20 Merkmalen. Am besten in einen leeren Ordner importieren.

Funktionen

BereichFunktion
VorgängeAnlegen, Bearbeiten, Löschen; Volltextsuche; Filter; Sortierung per Klick auf die Spaltenüberschrift; „nur offene“ / „nur überfällige“
AuswertungKennzahlen (gesamt, offen, überfällig, kürzlich geändert), Verteilungen je Filterfeld, Neuanlagen je Monat; Klick auf einen Balken filtert die Liste
VerlaufJede Änderung mit Zeitpunkt und Kürzel nachvollziehbar
ImportCSV aus Excel mit automatischer Spaltenzuordnung, vorhandene Schlüssel werden übernommen
ExportExcel (.xlsx) der aktuellen Filterung, mit Autofilter und Blatt „Verlauf“
KonfigurationFelder und Auswahllisten in der Oberfläche bearbeiten, ohne Programmierung
SicherungAutomatische Excel-Sicherung (abschaltbar)

Die mitgelieferte Standardkonfiguration ist ein Beispiel-Register für Datenaustauschvorgänge mit 20 Feldern. Unter Felder und Auswahllisten passen Sie sie an Ihren eigenen Zweck an.

Ausgelegt für 2–4 gleichzeitige Nutzer und 15.000 Vorgänge à 20 Felder, getestet mit 20.000 Vorgängen.

Vorgangsliste mit Suchfeld, Filtern und sortierbaren Spalten
Die Vorgangsliste mit Volltextsuche, Filtern und Sortierung.
Auswertung mit Kennzahlen und Balkendiagrammen je Filterfeld
Die Auswertung: Ein Klick auf einen Balken filtert die Liste.

Systemvoraussetzungen

  • Browser: Microsoft Edge oder Google Chrome ab Version 86. Firefox und Safari unterstützen den nötigen Ordnerzugriff nicht.
  • Ordner: Lese- und Schreibrecht für alle Nutzer. Nicht empfohlen sind Ordner, die von Sync-Software (OneDrive, Google Drive, Dropbox) verwaltet werden.
  • Nicht nötig: Installation, Server, Datenbanksoftware, Administratorrechte, Internetverbindung, externe Bibliotheken.

Aufbau und Dateien

Die Anwendung arbeitet mit einem Änderungsprotokoll. Jede Änderung (anlegen, ändern, löschen) wird als Ereignis mit Zeitstempel und Kürzel gespeichert. Jede Person schreibt nur in ihre eigenen Dateien, deshalb gibt es keine gemeinsam beschriebene Datei und keine Sperrkonflikte.

Dateien im Datenordner

DateiInhaltGeschrieben von
local-database.htmldas ProgrammBetreuung (beim Update)
konfiguration.jsonTitel, Schlüsselpräfix, Felder, Auswahllisten, Einstellungen„Felder & Auswahllisten“
journal_<Kürzel>_NNNN.jsonÄnderungsprotokoll einer Person, in Abschnitten zu je 200 Ereignissennur die jeweilige Person
bestand.jsonkonsolidierter Gesamtbestand inkl. Verlauf„Bestand konsolidieren“
sicherung/Register_aktuell.xlsxExcel-Sicherung, neuester Standautomatisch
sicherung/Register_JJJJ-MM-TT.xlsxExcel-Sicherung je Tagautomatisch
sicherung/bestand_*.jsonvorheriger Bestand, abgelegt vor jeder Konsolidierungautomatisch

Datenmodell

  • Vorgang = eindeutiger Schlüssel + konfigurierbare Felder + Metadaten (angelegt/geändert am, von) + Verlauf.
  • Schlüssel: DA-26-RB-0001 = Präfix – Jahr – Kürzel – laufende Nummer. Durch das Kürzel sind Schlüssel eindeutig, ohne dass sich die Nutzer abstimmen müssen. Schlüssel werden nie geändert oder wiederverwendet.
  • Löschen blendet einen Vorgang aus; er bleibt im Protokoll nachvollziehbar.
  • Gleichzeitige Änderung desselben Feldes: Die zuletzt gespeicherte Änderung gilt, beide stehen im Verlauf. Änderungen an verschiedenen Feldern werden zusammengeführt.
  • Eigene Änderungen bekommen immer einen Zeitstempel nach dem zuletzt gesehenen Stand. Das schützt auch bei leicht abweichenden PC-Uhren.
Formular „Vorgang bearbeiten“ mit Schlüssel, Feldern und Verlauf der Änderungen
Ein Vorgang mit seinen Feldern; unten der Verlauf mit Zeitpunkt und Kürzel jeder Änderung.

Speichern und Abgleich

  • Speichern läuft im Hintergrund. Das Formular schließt sofort, die Kopfzeile zeigt „Speichert …“ und danach „✓ gespeichert“.
  • Ist das Laufwerk nicht erreichbar, erscheint „⚠ … noch nicht gespeichert“. Die Anwendung versucht es alle 10 Sekunden erneut und warnt beim Schließen des Fensters.
  • Alle 15 Sekunden (und beim Zurückkehren ins Fenster) werden Änderungen anderer Nutzer geladen.
  • Jede geschriebene Datei wird zurückgelesen und geprüft. Ist eine Datei unvollständig lesbar, versucht die Anwendung es erneut bzw. nutzt den letzten lesbaren Stand. Daten gehen dabei nicht verloren.

Besonderheit Microsoft Edge

Je nach Sicherheitseinstellungen legt Edge beim Speichern eine Kopie name (1).json an, statt die Datei zu ersetzen. Die Anwendung erkennt das automatisch, schreibt danach unter dem richtigen Namen und räumt Kopien auf. Unter Verwaltung → Schreibtest lässt sich prüfen, ob ein Ordner mit dem aktuellen Browser geeignet ist.

Felder und Auswahllisten

Verwaltung → Felder & Auswahllisten bearbeiten

  • Felder anlegen, umbenennen und per ▲▼ sortieren
  • Typ wählen (siehe Tabelle unten)
  • per Häkchen: Pflichtfeld, Anzeige in der Tabelle, Filter & Auswertung, volle Breite
  • Auswahllisten: ein Eintrag pro Zeile
  • Werte, die in Vorgängen vorkommen, aber nicht in der Liste stehen, werden angezeigt und lassen sich übernehmen
  • festlegen, welche Status als „erledigt“ gelten
Dialog „Felder & Auswahllisten“ mit Feldliste, Feldtypen und Häkchen für Pflichtfeld, Tabelle und Filter
Felder und Auswahllisten werden direkt in der Oberfläche gepflegt.
FeldtypVerhalten
Text (einzeilig / mehrzeilig)Freitext
Auswahlliste (fest)nur hinterlegte Einträge wählbar, für einheitliche Auswertungen
Freitext mit Vorschlägenfreie Eingabe, bekannte Werte werden vorgeschlagen
Datum / Zahlin Excel als echte Datums- bzw. Zahlenwerte

Wichtig

  • Umbenennen eines Feldes ändert nur die Anzeige. Die Daten hängen an einer festen internen ID.
  • Listenwerte umbenennen oder zusammenlegen: Verwaltung → Wert in allen Vorgängen ersetzen. Das wird im Verlauf jedes Vorgangs protokolliert und passt die Liste mit an.
  • Entfernen eines Feldes blendet es nur aus. Die Inhalte bleiben erhalten, das Feld kann wiederhergestellt werden.
  • Systemfelder (Bezeichnung, Status, Frist) können umbenannt, aber nicht entfernt werden.
  • Änderungen gelten nach dem nächsten Abgleich für alle Nutzer, spätestens nach 15 Sekunden.

Weitere Einstellungen

Diese Schlüssel stehen in konfiguration.json im Datenordner.

SchlüsselStandardBedeutung
titellocal-databaseTitel der Anwendung
schluesselPraefixDAPräfix neuer Vorgangsschlüssel
abgeschlossenAbgeschlossen, VerworfenStatus, die als erledigt gelten
excelSicherungtrueautomatische Excel-Sicherung ein/aus
excelSicherungMinuten15Mindestabstand der Sicherungen nach Änderungen
excelSicherungTage60Aufbewahrung der Tagesdateien (0 = unbegrenzt)
betreuung–optionaler Kontakt, erscheint im Tab „Information“

Import und Export

Import (CSV)

  • Aus Excel speichern über „Speichern unter → CSV UTF-8“ oder „CSV (Trennzeichen-getrennt)“.
  • Trennzeichen Semikolon, Komma oder Tabulator werden erkannt.
  • Spalten werden über die Überschrift automatisch zugeordnet und können angepasst werden.
  • Datumsangaben als TT.MM.JJJJ oder JJJJ-MM-TT.
  • Eine Spalte „Schlüssel“ bzw. „Nr.“ übernimmt vorhandene Schlüssel; Dubletten werden übersprungen.
  • Nach einem großen Import: Bestand konsolidieren.
Import-Dialog mit Vorschau der CSV-Datei und automatischer Zuordnung der Spalten zu den Feldern
Beim CSV-Import werden die Spalten automatisch zugeordnet und lassen sich vor der Übernahme anpassen.

Export

„Excel exportieren“ speichert die aktuell gefilterte Liste als .xlsx, mit Autofilter und einem Blatt „Verlauf“.

Sicherung und Wiederherstellung

  • Primär: die reguläre Sicherung des Netzlaufwerks. Der Datenordner enthält den vollständigen Bestand.
  • Zusätzlich (abschaltbar): Excel-Sicherung beim ersten Start des Tages und nach Änderungen höchstens alle 15 Minuten.
  • Vor jeder Konsolidierung wird der bisherige Bestand in sicherung/ abgelegt.
  • Wiederherstellung: Datenordner aus der Laufwerkssicherung zurückspielen. Im Notfall eine Excel-Sicherung als CSV speichern und in einen leeren Ordner importieren. Der Verlauf geht dabei verloren.

Betrieb und Pflege

AufgabeVorgehen
UpdateNeue HTML-Datei im Datenordner ersetzen, alle Nutzer laden die Seite neu (Versionsnummer prüfen). Daten älterer Versionen werden automatisch übernommen.
KonsolidierenNach großen Importen und etwa monatlich: Verwaltung → Bestand konsolidieren
Excel-Sicherung abschaltenNach der Einführungsphase "excelSicherung": false in konfiguration.json
FehlersucheVerwaltung → Dateien im Datenordner (Diagnose) und Schreibtest
Nutzer wechselnSchaltfläche mit Kürzel oben rechts
Ordner wechselnSchaltfläche „Ordner wechseln“; zuletzt verwendete Ordner stehen unter Verwaltung
Tab „Verwaltung“ mit Felderübersicht, Bestand konsolidieren, Excel-Sicherung und Dateidiagnose
Der Tab „Verwaltung“ bündelt Felder, Konsolidierung, Sicherung und Diagnose.

Sicherheit und Datenschutz

  • Die Anwendung baut keine Netzwerkverbindungen auf, lädt keine externen Inhalte und überträgt keine Daten.
  • Der Zugriff wird über die Berechtigungen des Ordners gesteuert. Die Anwendung selbst hat kein eigenes Rechtekonzept.
  • Im Browser werden lokal nur Kürzel, Name und die Verweise auf zuletzt verwendete Ordner gespeichert.
  • Vorgesehen für öffentliche Informationen; personenbezogene Daten sind nicht vorgesehen.

Hinweise zu dieser Webseite selbst stehen in der Datenschutzerklärung.

Grenzen

  • Kein Rechtekonzept: Wer Schreibzugriff auf den Ordner hat, darf alles. Keine Freigabe-Workflows.
  • Gleichzeitige Änderung desselben Feldes: Die zuletzt gespeicherte gewinnt (beide im Verlauf).
  • Bearbeiten zwei Personen gleichzeitig die Felder, fragt die Anwendung vor dem Überschreiben nach.
  • Der Browser zeigt aus Sicherheitsgründen nur den Ordnernamen, nicht den vollständigen Pfad.
  • Nur Chromium-Browser (Edge, Chrome).

Häufige Fragen

Der Browser fragt nach dem Zugriff auf den Ordner.

Das ist gewollt: Ohne Ihre Erlaubnis darf die Anwendung keine Dateien lesen oder schreiben. Bestätigen Sie mit „Dateien bearbeiten“ bzw. „Zulassen“. Wurde der Zugriff versehentlich abgelehnt, klicken Sie erneut auf „Datenordner wählen“.

Die Schaltfläche „Datenordner wählen“ fehlt oder funktioniert nicht.

Der Browser unterstützt den Ordnerzugriff nicht. Öffnen Sie die Datei in Microsoft Edge oder Google Chrome ab Version 86. Der Demo-Modus funktioniert auch in anderen Browsern.

In der Kopfzeile steht „⚠ … noch nicht gespeichert“.

Das Laufwerk ist gerade nicht erreichbar. Die Anwendung versucht es alle 10 Sekunden erneut. Schließen Sie das Fenster erst, wenn wieder „✓ gespeichert“ erscheint. Unter Verwaltung → Schreibtest prüfen Sie, ob der Ordner beschreibbar ist.

Im Ordner tauchen Dateien wie journal_RB_0001 (1).json auf.

Das ist die Besonderheit von Microsoft Edge. Die Anwendung erkennt die Kopien, schreibt danach unter dem richtigen Namen und räumt sie auf. Es ist nichts zu tun.

Ein Kollege sieht meine Änderung nicht.

Änderungen anderer werden alle 15 Sekunden und beim Zurückkehren ins Fenster geladen. Prüfen Sie außerdem, ob beide denselben Datenordner geöffnet haben (Tab „Information“).

Wie benenne ich einen Listenwert in allen Vorgängen um?

Über Verwaltung → Wert in allen Vorgängen ersetzen. Die Änderung wird im Verlauf jedes betroffenen Vorgangs protokolliert und die Auswahlliste wird mit angepasst.

Kann ich OneDrive oder SharePoint als Datenordner verwenden?

Nicht empfohlen. Sync-Software kann Dateien verzögert oder als Kopie ablegen. Nutzen Sie einen Ordner auf einem Netzlaufwerk.

Wie spiele ich eine neue Version ein?

Ersetzen Sie die HTML-Datei im Datenordner und lassen Sie alle Nutzer die Seite neu laden. Die Versionsnummer steht oben neben dem Titel. Daten älterer Versionen werden automatisch übernommen.

Versionshistorie

VersionÄnderungen
9Feld-Editor in der Oberfläche, „Wert in allen Vorgängen ersetzen“, Tab „Information“, 20 Standardfelder, robustere Zeitstempel
8Speichern im Hintergrund mit Statusanzeige, Protokoll in kleinen Abschnitten, Wartekreisel
7Versionsanzeige, verbesserte Diagnose
6automatische Korrektur für Microsoft Edge (Kopien „(1)“)
5Ordner wechseln, zuletzt verwendete Ordner
4Schreibtest, geprüfte Konsolidierung
3automatische Excel-Sicherung, Excel-Export
1–2Grundfunktionen, robuster Mehrbenutzer-Abgleich

Lizenz und Haftung

local-database steht unter der PolyForm Noncommercial License 1.0.0. Den englischen Originaltext und eine unverbindliche deutsche Übersetzung finden Sie auf der Seite Lizenz. Kurz zusammengefasst:

  • Erlaubt: nichtkommerzielle Nutzung, auch durch gemeinnützige Organisationen, Bildungseinrichtungen und Behörden; anpassen, weiterbearbeiten und mit Lizenzhinweis weitergeben.
  • Nicht erlaubt: kommerzielle Nutzung, insbesondere der Verkauf. Für eine kommerzielle Nutzung wenden Sie sich an office@calhelp.de.

Betrieb auf eigene Verantwortung. local-database wird ohne Gewähr bereitgestellt. Für Einrichtung, Betrieb, Datensicherung und die gespeicherten Inhalte ist allein der jeweilige Betreiber verantwortlich. Soweit gesetzlich zulässig, haftet calHelp nicht für Schäden aus der Nutzung.