Handbuch der Datenbank kla4db 0.8 für Klavierstimmer
This side is only in german. Here you can download the zipped distribution.
The complete english, hungarian and german documentation is into the distribution:
!!! Important notes to the installation !!!
Kla4_db successfully was tested with Linux and Mac OS X
I.
1. run as root: ./install
2. detect who your perl is with: which perl and edit the shebangs in the perl files
3. For Mac OS X export the global variable: export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:/path/to/mysql/lib
II.
Although the installing program automatically the missing modules
we recommend that you're installing the following modules with the native
installer of your OS (Fedora, Suse etc. with yum/RPM, Debian, Ubuntu with
dpkg/apt, *BSD with the ports, etc). DBI, DBD::mysql, Perl::Tk
III.
Following modules often are failing being installed: Perl::Tk and DBD::mysql (Mac OS X)
For the worst case that your OS doesn't have these modules we added them to the kla4_db distribution.
Installing by hand:
unpacking with tar xvzf *.tar.gz
perl Makefile.PL
make
as root: make install
IIII.
Windows WARNING -- Still not tested
Install perl downloading from https://www.perl.org/get.html
It seems that the Strawberry Perl distribution is the most suitable fot kla4_db.
because install is a bash script it doesn't function under Windows, install it by hand.
if not exist create a link Kla4doc.txt to your preferred language Kla4doc.
Run the perl script inst.plx which downloads and installs the needed modules via cpan
if one or more installation(s) fail(s) install by hand, read INSTALL.TXT.
Creating the mysql db run: mysqladmin -uroot -p create kla4_db
mysql -uroot -p $passwd kla4_db < kla4.sql
If you want an Example with virtual clients run: mysql -uroot -p $passwd kla4_db < kla4insert.sql
V.
For the newest modules consult https://metacpan.org/.
Diese Datenbank wurde mit Perl und Perl/TK geschrieben und arbeitet mit dem MySql-Datenbanksystem
zusammen.
Geplant ist die Anbindung an das Datenbanksystem PostgreSQL. Kla4_db ist unter der GNU General
Public License (GPL) lizensiert. Danksagungen Mein Dank geht an Günther Knaak, Göttingen,
der mir die Idee für
diese Datenbank verschaffte, Jens Kluge, Göttingen (jetzt Singapur),
der mir beim Zusammensuchen der passenden Software
half und die Datenbank, ebenso wie Günther, auf Fehler hin überprüfte,
an Michael Schilli, anhand dessen Lehrmaterial ich Perl lernte.
Vielen Dank an Larry Wall für Perl an alle, denen wir MySql verdanken. Linux Das tgz-Archiv wird, am besten in /usr/local, mit dem Befehl: tar xvfz kla4db_x.xx.tgz ausgepackt.
Es ist eine Dummydatenbank mit Fantasiefiguren: kla4insert.sql beigefügt,
die nicht mitinstalliert werden muß.
Falls die Dummydatenbank als Beispiel verwendet werden soll, wird die entsprechende
Zeile im Installationsskript install, einem bash-Skript, auskommentiert. Nach Start von ./install
wird nach dem Paßwort des Mysql-Administrators (Achtung nicht nach dem
Unix-Admin, sondern dem des Mysql-Systems) gefragt. Falls der Name des
Datenbankadministrators nicht root ist, bitte in der Datei install ändern:
<mysql-Befehl> -u<adminname> -p ... Für weitere Fragen stehen Antworten in INSTALL.TXT.
Gestartet wird die Datenbank mit ./kla4main.pl. Es erscheint der Login
(abb. 1).
2. Bedienung:
Frisch installiert besteht das Menü nur aus dem Eintrag Datenbank, mit
dem lediglich die Datenbank wieder beendet werden kann.
Nach erfolgreichem Einloggen erscheint die Datenbank in voller Schönheit mit
vollständigem Menü, den nächsten Terminen und einem Fenster mit säumigen
Kunden sowie Klavieren, bei denen die Besitzerdaten noch nachzutragen sind.
abb. 1 Das Loginfenster
Es ist zwar möglich, mit Root von Mysql die Klavierdatenbank zu verwalten.
Aber aus Sicherheitsgründen sollte ein ausschließlich für die
Datenbank privilegierter non-Root verwendet werden.
Unter dem Menüpunkt Admin(abb. 3) erscheint
das Popup-Fenster Neuer DB-Admin.
Nach dessen Aktivieren erscheint das Toplevelfenster, wie es in abb. 2
zu sehen ist.
Dort kann Mysql-Root Datenbankamnistratoren für Kla4db anlegen. Dies funktioniert allerdings
nur auf Unix-Systemen. Die unter Windows getestete Perl-Distribution erlaubt das nicht. Dort
muß der kla4db-Admin mit mysqladmin erzeugt werden.
abb. 2 Anlegen eines neuen Administrators für die Datenbank
2. Bedienung
abb. 3 Die Datenbank nach dem Einloggen. Was hinter den Menüs
steckt, ist in dieser Abbildung
als gesonderte Fensterchen dargestellt. Dei Nächsten Termine erscheinen im oberen Drittel
des Hauptfensters, offene Rechnungen in einem gesonderten gelben Fenster. In diesem Bild
heiß der Datenbank-Admin spirou
abb. 4 Die Datenbank nach Aktivieren der Kundenliste. Oben ist näliche Liste, darunter,
farblich abgesetzt, eine kleine Hilfe, wo welche Aktionen mit der Maus möglich sind,
darunter eine Scrollbar. Soll der Kunde mit der Kundennummer 1 geändert werden, weil er
beispielsweise umgezogen ist, wird auf den Balken mit der 1 mit der linken Maustaste
doppelgeklickt. Es erscheint ein Toplevelfenster wie abb. 7 oder,
falls der Ortsname der Datenbank noch unbekannt ist, wie abb. 20.
In der neueren Version wird, anders als in dieser abbildung, der neue Stimmtermin
nicht mehr bei «Klavier», sondern bei «Kunde» eingetragen.
abb. 5 Aktivierung des Scrollbar-Fensters nach einfachem Mausklick mit der linken Maustaste.
oben erscheinen sodann die Kundendaten der angeklickten Kundennummer.
Die entsprechenden Pendants für die Klaviere und die Lieferanten finden sich in
abb. 11, abb. 18 und abb. 19.
abb. 6 Toplevelfenster zum Löschen eines Kunden nach Doppelklick der rechten Maustaste
im Scrollbar-Fenster. Äquivalente Toplevelfenster gibt es auch zum Löschen von
Klavier- Lieferanten- und Termindaten in den jeweiligen Sektionen
(abb. 11, abb. 18 und abb. 19).
abb. 7 Das Toplevelfenster zum Ändern von Kundendaten. Nach Doppelklick der linken Maustaste
im Scrollbarfenster mit den Kundennummern (Sektion Kunden) erscheint dieses Fenster.
Hier ist die Postleizahl der Datenbank bekannt und es erscheint unten der korrekte
Ortsnamen. Ist dies nicht der Fall, ist das untere Feld rot (vgl. abb. 20).
Entsprechende Felder zum Editieren gibt es auch in der Klavier- (abb. 12),
Lieferanten-, Artikel- (abb. 17) und Terminsektion.
abb. 8 Das Fenster zum Eintrag von Neukunden. Für den Ort ist beim ersten Mal nur die
Postleitzahl einzutragen. Der Ortsname, falls er in der Datenbank fehlt, kann später
nachgetragen werden (siehe abb. 20).
abb. 9 Für die Kundensuche (Klavier siehe abb. 15 )
wird der Name eingetragen.
abb. 10 Bei einem Neukunden wird automatisch ein neuer Eintag bei den Klavieren
erzeugt, und ein Eingabefenster für einen Klaviereintrag öffnet sich.
Falls noch nichts über das Klavier bekannt ist, können die Daten später
eingetragen werden. Achtung damit der Klaviereintrag funktioniert, darf das
Klavierfenster nicht leer gelassen werden. Ein - als Namenseintrag
genügt fürs erste.
abb. 11 Die Sektion Klaviere
abb. 12 Das Toplevelfenster zum Ändern der Klavierdaten.
abb. 13 In der Klaviersektion können nach Klick der mittleren Maustaste die bisherigen
Besitzer des Klaviers eingesehen werden.
abb. 14 Arbeit in Sicht !
abb. 15 Suchen eines Klaviers.
abb. 16 Die Artikeltafel (Menü: Artikel - Artikeltafel).
abb. 17 Ändern der Daten eines Artikels.
abb. 18 Die Sektion Termine
abb. 19 Die Sektion Lieferanten
abb. 20 Das Fenster zum Ändern eines Kundeneintrags. Hier haben wir einen Kunden mit einer
Postleitzahl, die der Datenbank noch unbekannt ist. Der Ortsname ist nachzutragen, daher
ist das Feld rot. Bei Neukunden muß nur die Postleitzahl eingetragen werden. Ein eventueller
Nachtrag des Ortsnamens ist nur beim Editieren möglich.
