                          Birthday 6.5
                  Das Geburtstags- und berweisungs-
                       Erinnerungsprogramm
                       von Oliver Buchmann


Einleitung
----------

Dieses Programm, das an die nchsten Geburtstage der lieben Bekannt- oder
Verwandtschaft erinnern soll, ist klein, schnell, komfortabel (naja) und
sehr sauber in einem Fenster realisiert. 

Es erinnert Sie ferner an wiederkehrende berweisungen, wenn Sie ein 
berweisungsprogramm verwenden, das eine Schnittstelle zu Birthday 
enthlt (z.B. PayDay von Ingo Plckhahn).

PayDay ist ein Programm um Offline-berweisungen fr ST Online zu 
generieren. Auf Wunsch erzeugt PayDay eine Datei, die an 
immerkehrende berweisungen erinnert. Diese werden dann von Birthday 
mitten in die Geburtstage eingestreut, um Sie an die berweisung zu 
erinnern. 


Installation 
------------

BIRTHDAY.PRG kopieren Sie am besten in den APPS-Ordner von MagiC 
(GEMSYS\MAGIC\START). Unter Single-TOS mssen Sie das Programm als 
AUTO-Start-Anwendung anmelden. 
Es darf nicht in den AUTO-Ordner kopiert oder als Accessory installiert
werden. Im gleichen Verzeichnis mu sich die Datei BIRTHDAY.DAT befinden, 
in der Sie die Geburtstage eintragen. Jede Person mit Geburtsdatum mu 
in einer Zeile durch CR/LF getrennt eingegeben werden. Das Datum mu 
das Format TT.MM.JJJJ haben, danach mu ein Komma, danach am besten ein 
Leerzeichen und dann der Name folgen. Das Alter, das die Person erreicht, 
wird spter vom Program errechnet (sehr komplizierter Algorithmus :-)) 
und am rechten Fensterrand dargestellt. Hier ein Beispiel fr eine 
solche Datei:

01.04.1965, Dr. med. Wurst
10.03.1967, Peter Schlnzke

Die nchsten Geburtstage werden beim Booten dann in einem Fenster
sortiert nach dem Auftreten dargestellt. Wenn Sie in Farbe arbeiten, 
wird der Geburtstag, der "heute" ist, rot dargestellt. Ansonsten wird
er fettgedruckt dargestellt. 


Birthday und Phoenix
--------------------

Natrlich bietet es sich an, die Geburtstagsdatei mit Phoenix zu 
erzeugen, wenn man dort schon seine Adressen samt 
Geburtsdaten verwaltet.
Hierzu sollten Sie folgende Abfrage namens "Geburtstag eingegeben" 
so definieren, da Sie im Abfragefenster im Feld Geburtstag "<> ''"
eingeben.

Danach definieren Sie einen Report namens "Geburtstag", der so aussehen 
sollte:

{$BREITE = 80}{$LNGE = 1}{$TABELLE = LEUTE}
{Geburtstag}, {Vorname} {Name}

Nun knnen Sie sich noch folgenden Batch namens "Geburtstagsexport" 
definieren:

REPORT query="Geburtstag eingegeben" name="Geburtstag" file="C:\GEMSYS\MAGIC\START\BIRTHDAY.DAT"

Das war's.


Konfigurieren von Birthday
--------------------------

Es gibt eine Konfigurationsdatei namens BIRTHDAY.CFG, die sich im 
selben Verzeichnis wie BIRTHDAY.PRG befinden mu. Ist keine Datei 
vorhanden, legt Birthday selbst eine an.
Die Datei, die in diesem Archiv mitgeliefert wird, erklrt sich von 
selbst, hier aber der Vollstndigkeit halber der Inhalt der Datei:

; CFG-Datei zu Birthday. Kommentare beginnen mit Semikolon
ANZAHL:10 ; Anzahl der Zeilen
BREITE:43 ; Breite des Fensters. Mu mind. 35 sein.
;XPOS:100 ; X-Position des Fensters
;YPOS:100 ; Y-Position des Fensters
ALTER:1   ; Altersanzeige. Bei 1 wird das Alter angezeigt. Bei 0 die verbleibenden Tage zum Geburtstag. Bei 2 beides. 
VERSCHWINDE:10 ; nach 10 Sekunde soll das Fenster verschwinden. Bei Null oder Fehlen dieser Zeile bleibt das Fenster stehen, bis es geschlossen wird.
MINIMUM:3 ; Fenster nur ffnen, wenn der nchste Geburtstag in 3 Tagen ist.
KOPFZEILE:1 ; Bei 1 wird eine Kopfzeile im Fenster angezeigt.
INTERVALL:40 ; Nur die nchsten 40 Tage bercksichtigen.
VORWARNUNG:7 ; Ist der Geburtstag am nchsten Tag, diesen Termin in dieser Farbe darstellen.
BREMSE:0 ; Ist dieser Wert 1, so kann man das Fenster vor Ablauf der Verschwindezeit nicht mit der Maus schlieen
HINTERGRUND:8 ; In Farbauflsungen Farbe des Fensterhintergrunds

Vor XPOS und YPOS ist ein Semikolon. Dadurch wird diese Zeile 
ignoriert und das Fenster auf dem Bildschirm zentriert angezeigt. 
Sonst kann man hier eben die Position einstellen, falls man es an 
andere Stelle erscheinen lassen mchte. Sie knnen aber auch in 
Birthday das Fenster an die gewnschte Postion schieben und beim 
Beenden wird diese Postion in der CFG-Datei gespeichert.

Ist ALTER 0, so werden die noch verbleibenden Tage bis zum Geburtstag 
angezeigt, ist ALTER 1, wird das Alter angezeigt, das erreicht wird. 
Ist ALTER 2, wird beides angezeigt. 

Bei VERSCHWINDE kann eine Zeit in Sekunden angegeben werden, nach der das
Fenster geschlossen und das Programm beendet werden soll.

Man kann einstellen, da das Fenster nur gezeigt wird, wenn der nchste 
Geburtstag in soundsoviel Tagen ansteht.
Hierzu dient der Parameter MINIMUM.
Wenn der nchste Geburtstag noch mehr Tage entfernt ist, als hier angegeben, 
wird das Fenster nicht geffnet, sondern Birthday gleich wieder beendet.
Ist ein Geburtstag in diesem Zeitraum vorhanden, werden alle weiteren 
Termine ebenfalls gezeigt. 
Wenn man den Parameter auf 1 stellt, werden Geburtstage also nur 
gezeigt, wenn an diesem Tag auch einer ansteht. Wird eine 0 
angegeben, wird das Fenster immer gezeigt.
Die CFG- und die DAT-Dateien werden zuerst im aktuellen und danach im 
Start-Verzeichnis von MagiC gesucht.

Es kann eine Kopfzeile ausgegeben werden, in der
Datum, Name, Alter und/oder Tage bis Geburtstag steht. Fehlt die Kopfzeile,
wird die Anzeige der Daten vertikal zentriert, was einen schnen Rand ergibt.

Bei INTERVALL kann man angeben, wieviel Tage im voraus Birthday Termine
bercksichtigen soll. Nur Termine in diesem Zeitraum werden angezeigt. Stehen 
keine Termine in diesem Zeitraum an, beendet sich Birthday sofort wieder. 

Bei VORWARNUNG kann man eine Farbe angeben, die benutzt wird, wenn der 
Termin am nchsten Tag ist.
Das ist praktisch, wenn man jemandem per Mail im Mausnetz gratulieren will, 
denn dort betrgt die Mailluafzeit normalerweise einen Tag. 

Wenn BREMSE den Wert 1 bekommt, kann man das Fenster mit dem Closer nicht 
wegklicken, bevor die Zeit bei VERSCHWIBNDE verstrichen ist.

Bei HINTERGRUND kann man eine Fensterhintergrundfarbe bestimmen, 
z.B. 8 fr Hellgrau. 


Untersttzung von Terminen fr wiederkehrende berweisungsauftrge
------------------------------------------------------------------

Hierzu wird die Datei BIRTHPAY.DAT (man verzeihe mir diese grliche 
Wortschpfung, aber die Datei steht dann im Verzeichnis bei 
alphabetischer Sortierung genau unter BIRTHDAY und es geht ja ums 
Bezahlen) verwendet.

berweisungstermine werden blau bzw. kursiv dargestellt. Ist eine 
berweisung am aktuellen Tag fllig wird sie wie ein Geburtstag rot 
bzw. fett dargestellt.

Aufbau der BIRTHPAY.DAT
-----------------------

In jeder Zeile steht wie bei den Geburtstagen ein Datum (bei dem das 
Jahr nicht relevant ist, da die Termine immer wiederkehren), der 
Erinnergungstext
und am Ende in Klammern das Intervall in Monaten).
Also z.B. so:

10.03.1997, berweisung ans Finanzamt (03)
01.01.1996, Miete berweisen (01)
10.01.1994, berweisung Steuer Auto (12)

Im ersten Beispiel wird vierteljhrlich angemahnt, im zweiten monatlich, im dritten
einmal im Jahr.

Diese Datei wird unter Umstnden von Ihrem berweisungsprogramm PAYDAY oder KIES
auf Wunsch automatisch erzeugt.

Shutdown
--------
Der Shutdown-Mechanismus von MagiC wird von Birthday untersttzt.


Das Programm ist Fairware und darf nur zusammen mit den Dateien
BIRTHDAY.TXT, BIRTHDAY.DAT und BIRTHDAY.CFG weitergegeben werden. Wer es 
gut findet und stndig installiert hat, sollte sich mit einem kleinen 
Obulus (der Betrag ist jedem freigestellt) bei mir erkenntlich zeigen. 
Dann wird es auch weiterhin so ungemein praktische Programme von mir geben.

Im MAUS-Netz bin ich unter Oliver Buchmann @KA2 zu erreichen.

Das Programm wurde in PurePascal geschrieben.

Oliver Buchmann
Hermann-Hampe-Weg 4
69126 Heidelberg
