home *** CD-ROM | disk | FTP | other *** search
/ ST-Computer Leser 1998 October / STC_CD_10_1998.iso / UTILITY / BIRTHDAY / BIRTHDAY.TXT < prev    next >
Text File  |  1998-09-26  |  15KB  |  321 lines

  1.                           Birthday 7.5
  2.                   Das Geburtstags- und Überweisungs-
  3.                        Erinnerungsprogramm
  4.                        von Oliver Buchmann
  5.  
  6.                     Birthday-Edition 10.3.98
  7.  
  8. Einleitung
  9. ----------
  10.  
  11. Dieses Programm, das an die nächsten Geburtstage der lieben Bekannt- oder
  12. Verwandtschaft erinnern soll, ist klein, schnell, komfortabel (naja) und
  13. sehr sauber in einem Fenster realisiert. 
  14.  
  15. Es erinnert Sie ferner an wiederkehrende Überweisungen, wenn Sie ein 
  16. Überweisungsprogramm verwenden, das eine Schnittstelle zu Birthday 
  17. enthält (z.B. PayDay von Ingo Plückhahn).
  18.  
  19. PayDay ist ein Programm um Offline-Überweisungen für ST Online zu 
  20. generieren. Auf Wunsch erzeugt PayDay eine Datei, die an 
  21. immerkehrende Überweisungen erinnert. Diese werden dann von Birthday 
  22. mitten in die Geburtstage eingestreut, um Sie an die Überweisung zu 
  23. erinnern. 
  24.  
  25.  
  26. Installation 
  27. ------------
  28.  
  29. BIRTHDAY.PRG kopieren Sie am besten in den APPS-Ordner von MagiC 
  30. (GEMSYS\MAGIC\START). Unter Single-TOS müssen Sie das Programm als 
  31. AUTO-Start-Anwendung anmelden. 
  32. Es darf nicht in den AUTO-Ordner kopiert oder als Accessory installiert
  33. werden. Im gleichen Verzeichnis mu₧ sich die Datei BIRTHDAY.DAT befinden, 
  34. in der Sie die Geburtstage eintragen. Jede Person mit Geburtsdatum mu₧ 
  35. in einer Zeile durch CR/LF getrennt eingegeben werden. Das Datum mu₧ 
  36. das Format TT.MM.JJJJ haben, danach mu₧ ein Komma, danach am besten ein 
  37. Leerzeichen und dann der Name folgen. Das Alter, das die Person erreicht, 
  38. wird später vom Program errechnet (sehr komplizierter Algorithmus :-)) 
  39. und am rechten Fensterrand dargestellt. Hier ein Beispiel für eine 
  40. solche Datei:
  41.  
  42. 01.04.1965, Dr. med. Wurst
  43. 10.03.1967, Peter Schlönzke
  44.  
  45. Die nächsten Geburtstage werden beim Booten dann in einem Fenster
  46. sortiert nach dem Auftreten dargestellt. Wenn Sie in Farbe arbeiten, 
  47. wird der Geburtstag, der "heute" ist, rot dargestellt. Ansonsten wird
  48. er fettgedruckt dargestellt. 
  49.  
  50.  
  51. Birthday und Phoenix
  52. --------------------
  53.  
  54. Natürlich bietet es sich an, die Geburtstagsdatei mit Phoenix zu 
  55. erzeugen, wenn man dort schon seine Adressen samt 
  56. Geburtsdaten verwaltet.
  57. Hierzu sollten Sie folgende Abfrage namens "Geburtstag eingegeben" 
  58. so definieren, da₧ Sie im Abfragefenster im Feld Geburtstag "<> ''"
  59. eingeben.
  60.  
  61. Danach definieren Sie einen Report namens "Geburtstag", der so aussehen 
  62. sollte:
  63.  
  64. {$BREITE = 80}{$LÄNGE = 1}{$TABELLE = LEUTE}
  65. {Geburtstag}, {Vorname} {Name}
  66.  
  67. Nun können Sie sich noch folgenden Batch namens "Geburtstagsexport" 
  68. definieren:
  69.  
  70. REPORT query="Geburtstag eingegeben" name="Geburtstag" file="C:\GEMSYS\MAGIC\START\BIRTHDAY.DAT"
  71.  
  72. Das war's.
  73.  
  74.  
  75. Konfigurieren von Birthday
  76. --------------------------
  77.  
  78. Es gibt eine Konfigurationsdatei namens BIRTHDAY.CFG, die sich im 
  79. selben Verzeichnis wie BIRTHDAY.PRG befinden mu₧. Ist keine Datei 
  80. vorhanden, legt Birthday selbst eine an.
  81. Die CFG- und die DAT-Dateien werden zuerst im aktuellen und danach im 
  82. Start-Verzeichnis von MagiC gesucht.
  83. Die Datei, die in diesem Archiv mitgeliefert wird, erklärt sich von 
  84. selbst, hier aber der Vollständigkeit halber der Inhalt der Datei:
  85.  
  86. ; CFG-Datei zu Birthday. Kommentare beginnen mit Semikolon
  87. ANZAHL:10 ; Anzahl der Zeilen
  88. BREITE:45 ; Breite des Fensters. Mu₧ mind. 40 sein.
  89. ;XPOS:100 ; X-Position des Fensters
  90. ;YPOS:100 ; Y-Position des Fensters
  91. ALTER:2   ; Altersanzeige. Bei 1 wird das Alter angezeigt, bei 0 die verbleibenden Tage zum Geburtstag. Bei 2 beides. 
  92. VERSCHWINDE:10 ; nach 10 Sekunden soll das Fenster verschwinden. Bei Null oder Fehlen dieser Zeile bleibt das Fenster stehen, bis es geschlossen wird.
  93. MINIMUM:30 ; Nur Anzeigen, wenn der nächste Geburtstag nur noch 30 Tage entfernt ist.
  94. KOPFZEILE:1 ; Bei 1 wird eine Kopfzeile im Fenster angezeigt.
  95. INTERVALL:80 ; Nur die nächsten 80 Tage berücksichtigen.
  96. VORWARNUNGSFARBE:3 ; Ist der Geburtstag am nächsten Tag, diesen Termin in dieser Farbe darstellen. 3=grün
  97. VORWARNUNGSATTRIBUT:0 ; Geburtstag am nächsten Tag, diesen Termin mit diesem Schriftattribut darstellen. 1=hell.
  98. HEUTEFARBE: 2 ; Ist der Geburtstag heute, dann diese Farbe verwenden. 2=rot
  99. HEUTEATTRIBUT: 1 ; Ist der Geburtstag heute, dann dieses Schriftattribut verwenden. 1=dick
  100. TERMINFARBE: 4 ; Ist der Termin heute, dann diese Farbe verwenden. 4=blau
  101. TERMINATTRIBUT: 4 ; Ist der Termin heute, dann dieses Schriftattribut verwenden. 4=kursiv
  102. KOPFZEILEFARBE: 4 ; Kopfzeile in dieser Farbe darstellen. 4=blau
  103. KOPFZEILEATTRIBUT: 8 ; Kopfzeile mit diesem Schriftattribut darstellen. 8=unterstrichen
  104. VERPASSTATTRIBUT: 0 ; Attribut, in der der verpa₧te Geburtstag dargestellt wird. 
  105. VERPASSTFARBE: 10 ;  Farbe, in der der verpa₧te Geburtstag dargestellt wird. 
  106. BREMSE:0 ; Ist dieser Wert 1, so kann man das Fenster vor Ablauf der Verschwindezeit nicht mit der Maus schlie₧en
  107. HINTERGRUND:8 ; In Farbauflösungen Farbe des Fensterhintergrunds. 8=grau
  108. JAHRHUNDERT:1 ; Bei 0 wird das Jahrhundert ausgeschrieben, bei 1 werden die ersten beiden Ziffern weggelassen, bei 2 die ganze Jahresangabe
  109. WOCHENTAG:1 ; Bei 1 wird zusätzlich das Wochentagskürzel ausgegeben.
  110. KOMMA:1 ; Bei 0 wird ein vorhandenes Komma entfernt.
  111. NUREINMAL:0 ; Bei 1 wird Birthday nur einmal pro Tag gestartet. Au₧er man hält beim Start die Shift-Taste gedrückt
  112. VERPASST:1 ; Ist dieser Wert 1, wird der zuletzt stattgefundene und damit evtl. verpa₧te Geburtstag in der letzten Fensterzeile, getrennt durch eine Linie, dargestellt. 
  113.  
  114.  
  115. Erklärung der einzelnen Parameter:
  116. ----------------------------------
  117.  
  118. ANZAHL legt die Anzahl der Zeilen fest, die das Fenster maximal gro₧ 
  119. werden darf.
  120.  
  121. BREITE legt die Fensterbreite fest.
  122.  
  123. Vor XPOS und YPOS ist ein Semikolon. Dadurch wird diese Zeile 
  124. ignoriert und das Fenster auf dem Bildschirm zentriert angezeigt. 
  125. Sonst kann man hier eben die Position einstellen, falls man es an 
  126. andere Stelle erscheinen lassen möchte. Sie können aber auch in 
  127. Birthday das Fenster an die gewünschte Postion schieben und beim 
  128. Beenden wird diese Postion in der CFG-Datei gespeichert.
  129.  
  130. Ist ALTER 0, so werden die noch verbleibenden Tage bis zum Geburtstag 
  131. angezeigt, ist ALTER 1, wird das Alter angezeigt, das erreicht wird. 
  132. Ist ALTER 2, wird beides angezeigt. 
  133.  
  134. Bei VERSCHWINDE kann eine Zeit in Sekunden angegeben werden, nach der das
  135. Fenster geschlossen und das Programm beendet werden soll. Ist hier 0 
  136. angegeben, bleibt das Fenster, bis es von Hand geschlossen wird.
  137.  
  138. Man kann einstellen, da₧ das Fenster nur gezeigt wird, wenn der nächste 
  139. Geburtstag in soundsoviel Tagen ansteht.
  140. Hierzu dient der Parameter MINIMUM.
  141. Wenn der nächste Geburtstag noch mehr Tage entfernt ist, als hier angegeben, 
  142. wird das Fenster nicht geöffnet, sondern Birthday gleich wieder beendet.
  143. Ist ein Geburtstag in diesem Zeitraum vorhanden, werden alle weiteren 
  144. Termine ebenfalls gezeigt. 
  145. Wenn man den Parameter auf 1 stellt, werden Geburtstage also nur 
  146. gezeigt, wenn an diesem Tag auch einer ansteht. Wird eine 0 
  147. angegeben, wird das Fenster immer gezeigt.
  148.  
  149.  
  150. Es kann eine Kopfzeile ausgegeben werden, in der
  151. Datum, Name, Alter und/oder Tage bis Geburtstag steht. Fehlt die Kopfzeile,
  152. wird die Anzeige der Daten vertikal zentriert, was einen schönen Rand ergibt.
  153.  
  154. Bei INTERVALL kann man angeben, wieviel Tage im voraus Birthday Termine
  155. berücksichtigen soll. Nur Termine in diesem Zeitraum werden angezeigt. Stehen 
  156. keine Termine in diesem Zeitraum an, beendet sich Birthday sofort wieder. 
  157.  
  158. Bei VORWARNUNGSFARBE kann man eine Farbe angeben, die benutzt wird, 
  159. wenn der Termin am nächsten Tag ist.
  160. Das ist praktisch, wenn man jemandem per Mail im Mausnetz gratulieren will, 
  161. denn dort beträgt die Maillaufzeit normalerweise einen Tag. 
  162. Bei VORWARNUNGSATTRIBUT kann man ein Textattribut angeben, falls man 
  163. das zusätzlich möchte oder nur über eine monochromen Bildschirm 
  164. verfügt.
  165.  
  166. Die gleichen Dinge gelten für HEUTEFARBE, HEUTEATTRIBUT, TERMINFARBE, 
  167. TERMINATTRIBUT, KOPFZEILEFARBE, KOPFZEILEATTRIBUT, VERPASSTFARBE 
  168. und VERPASSTATTRIBUT. 
  169. HEUTEFARBE ist für die Geburtstage gedacht, die am aktuellen Tag 
  170. sind, TERMINFARBE für alle Überweisungstermine, KOPFZEILEFARBE für 
  171. die Farbe der Kopfzeile, sofern man eine verwendet und VERPASSFARBE
  172. für den zuletzt stattgefundenen Geburtstag. 
  173.  
  174. Wenn BREMSE den Wert 1 bekommt, kann man das Fenster mit dem Closer nicht 
  175. wegklicken, bevor die Zeit bei VERSCHWINDE verstrichen ist.
  176.  
  177. Bei HINTERGRUND kann man eine Fensterhintergrundfarbe bestimmen, 
  178. z.B. 8 für Hellgrau. 
  179.  
  180. Ist JAHRHUNDERT 0, wird das Jahrhundert ganz ausgeschrieben 
  181. (01.01.1998), bei 1 werden die ersten beiden Ziffern weggelassen 
  182. (01.01.98), bei 2 die ganze Jahresangabe (01.01.). Im letzten Fall 
  183. sollte man den Wert KOMMA auf 1 setzen, da das Datum mit einem Punkt 
  184. endet und das Komma danach etwas hä₧lich wirkt.
  185.  
  186. Ist der Wert WOCHENTAG eine 1, wird zusätzlich das Wochentagskürzel 
  187. vor dem Datum ausgegeben.
  188.  
  189. Wenn KOMMA den Wert 1 erhält, wird das erste in der Zeile vorkommende 
  190. Komma gelöscht. Siehe JAHRHUNDERT.
  191.  
  192. Durch Setzen von NUREINMAL auf 1 kann man erreichen, da₧ Birthday nur einmal 
  193. pro Tag gesartet wird. Es vermerkt dies in der Datei BIRTHDAY.LOG. Will man 
  194. beim nächsten Rechnerstart Birthday trotzdem starten lassen, mu₧ man in der 
  195. Startphase von Birthday die linke Shift-Taste gedrückt halten. Die 
  196. Einstellung wird dann ignoriert.
  197.  
  198. Hat VERPASST den Wert 1, wird der zuletzt stattgefundene und damit evtl. 
  199. verpa₧te Geburtstag in der letzten Fensterzeile, getrennt durch eine Linie, 
  200. dargestellt. 
  201.  
  202. Unterstützung von Terminen für wiederkehrende Überweisungsaufträge
  203. ------------------------------------------------------------------
  204.  
  205. Hierzu wird die Datei BIRTHPAY.DAT (man verzeihe mir diese grä₧liche 
  206. Wortschöpfung, aber die Datei steht dann im Verzeichnis bei 
  207. alphabetischer Sortierung genau unter BIRTHDAY und es geht ja ums 
  208. Bezahlen) verwendet.
  209.  
  210. Überweisungstermine werden blau bzw. kursiv dargestellt. Ist eine 
  211. Überweisung am aktuellen Tag fällig, wird sie wie ein Geburtstag rot 
  212. bzw. fett dargestellt.
  213.  
  214. Aufbau der BIRTHPAY.DAT
  215. -----------------------
  216.  
  217. In jeder Zeile steht wie bei den Geburtstagen ein Datum (bei dem das 
  218. Jahr nicht relevant ist, da die Termine immer wiederkehren), der 
  219. Erinnergungstext
  220. und am Ende in Klammern das Intervall in Monaten).
  221. Also z.B. so:
  222.  
  223. 10.03.1997, Überweisung ans Finanzamt (03)
  224. 01.01.1996, Miete überweisen (01)
  225. 10.01.1994, Überweisung Steuer Auto (12)
  226.  
  227. Im ersten Beispiel wird vierteljährlich angemahnt, im zweiten monatlich, im dritten
  228. einmal im Jahr.
  229.  
  230. Diese Datei wird unter Umständen von Ihrem Überweisungsprogramm PAYDAY oder KIES
  231. auf Wunsch automatisch erzeugt.
  232.  
  233. Will man Termine nicht monatlich, sondern z.B. auch wöchentlich 
  234. angezeigt bekommen, so kann man ein zweistelliges Tagesintervall in 
  235. eckigen Klammern verwenden.
  236. Also z.B.
  237. 28.02.1998, Auto waschen [14]
  238. um alle zwei Wochen an etwas erinnert zu werden (nein, ich wasche 
  239. mein Auto nie).
  240.  
  241. Shutdown
  242. --------
  243. Der Shutdown-Mechanismus von MagiC wird von Birthday unterstützt.
  244.  
  245. Tasten
  246. ------
  247. Wenn das Birthday-Fenster das oberste ist, erscheint auf Druckvon Help, Tab
  248. oder Ctrl-I eine Info-Box. Mit Ctrl-Q wird das Programm beendet.
  249.  
  250.  
  251. Das Programm ist Fairware und darf nur zusammen mit den Dateien
  252. BIRTHDAY.TXT, BIRTHDAY.HYP, BIRTHDAY.REF, BIRTHDAY.DAT und 
  253. BIRTHDAY.CFG weitergegeben werden. Wer es 
  254. gut findet und ständig installiert hat, sollte sich mit einem kleinen 
  255. Obulus (der Betrag ist jedem freigestellt) bei mir erkenntlich zeigen. 
  256. Dann wird es auch weiterhin so ungemein praktische Programme von mir geben.
  257.  
  258. Im MAUS-Netz bin ich unter Oliver Buchmann @KA2 zu erreichen. Sonst 
  259. über Oliver.Buchmann@t-online.de
  260.  
  261. Das Programm wurde in PurePascal geschrieben.
  262.  
  263. Oliver Buchmann
  264. Hermann-Hampe-Weg 4
  265. 69126 Heidelberg
  266.  
  267. Bankverbindung: Commerzbank Heidelberg, BLZ 67240039, Konto 1831742.
  268.  
  269.  
  270.  
  271.  
  272. History:
  273. ========
  274. Erweiterungen in der Version 2:
  275. Es gibt jetzt eine Konfigurationsdatei namens BIRTHDAY.CFG, die sich 
  276. im selben Verzeichnis wie BIRTHDAY.PRG befinden mu₧.
  277.  
  278. Neu in der Version 3:
  279. Bei VERSCHWINDE kann eine Zeit in Sekunden angegeben werden, nach der das
  280. Fenster geschlossen und das Programm beendet werden soll.
  281.  
  282. Neu in der Version 4:
  283. Man kann einstellen, da₧ das Fenster nur gezeigt wird, wenn der nächste 
  284. Geburtstag in soundsoviel Tagen ansteht.
  285. Bei Mono wird aktueller Geburtstag fett geschrieben.
  286. Version 5: PayDay-Überweisungen werden angemahnt.
  287. Version 6: Pay-Day-Überweisungen optimiert.
  288. Version 6.1: Überweisungen wieder blau
  289. Version 6.2: Neu: Intervall. Zeigt nur diese nächsten Tage an.
  290. Version 6.3: Neu: Vorwarnung. Zeigt auch Termine für den nächsten Tag markiert an.
  291. Version 6.4: Neu: Bremse. Verhindert das vorzeitige Schlie₧en des Fensters.
  292. Version 6.5: Bugfix: yoffs wieder korrekt zentriert.
  293.              Neu: Farbiger Fensterhintergrund.
  294. Version 7.0: Bugfix: Am Ende des Jahres wurden keine Überweisungen des nächsten Jahres 
  295.                      berücksichtigt.
  296.              Neu: Jahrhundert und Jahreszahl können weggelassen werden.
  297.              Neu: Komma kann weggelassen werden.
  298.              Neu: Wochentagskürzel können vorangestellt werden.
  299.              Neu: Farbe und Attribute für alles einstellbar.
  300.              Neu: Wiederholung nicht nur monatlich, sondern auch nach Tagen einstellbar.
  301.              Neu: Es kann eingestellt werden, da₧ es nur einmal täglich gestartet wird.
  302. Version 7.1:          Bugfix: Kopfzeile konnte nicht abgeschaltet werden. 
  303.                       Bugfix: Altersanzeige kann wieder ausgeschaltet werden.
  304.                       Bugfix: Tägliche Intervalle in BIRTHPAY.DAT 
  305.                       sollten jetzt korrekt funktionieren. Bugfix: 
  306.                       Fenstertitel wird jetzt mit einer anderen 
  307.                       Funktion erzeugt. Bugfix: Variablentyp für 
  308.                       Berechnung der täglichen Intervalle geändert.
  309. Version 7.2:          Bugfix: Anzahl der möglichen Zeilen in der CFG erhöht 
  310.                       (jedoch max. 80).Bugfix: Bei der Berechnung der 
  311.                       täglichen Wiederholungen in der BIRTHPAY mit [] war ein 
  312.                       dämlicher Fehler.
  313. Version 7.3:          Neu: Verpa₧ter (letzter) Geburtstag wird auf Wunsch in 
  314.                       letzter Zeile angezeigt.
  315. Version 7.4:          Einige interne Änderungen bei der Berechnung. 
  316. Version 7.5:          Wird als Jahreszahl 19__ (Leerzeichen) oder 19XX angegeben, man 
  317.                       das genaue Geburtsjahr also nicht wei₧, wird kein Alter angegeben.
  318.                       Bei Verpa₧t wird garantiert nur ein Geburtsdatum ermittelt. 
  319.                       Bugfix: Ist NUREINMAL eingeschaltet, aber es steht kein Termin an, 
  320.                       wird Birthday nicht mehr trotzdem gestartet. 
  321.