@DATABASE "TTime-Abrechnung Release 2.3 Dokumentation" @NODE MAIN "TTime-Abrechnung Dokumentation" =============================================================== TTime-Abrechnung Version 2.3 =============================================================== Für Amiga ab Amiga-OS 2.04 (V37) Geschrieben 1997-1998 von J.Reinert/Lehrte Zubehör für TTime-Deluxe @{" Rechtliches " Link Rechtliches} @{" Voraussetzungen " Link Voraussetzungen} @{" Haftung " Link Haftung} @{" Was ist TT-Abrechnung " Link Was_ist_TT-Abrechnung} @{" Besondere Merkmale " Link Besondere_Merkmale} @{" Installation " Link Installation} @{" Programmstart " Link Programmstart} @{" Programm beenden " Link Programm_beenden} @{" TTime-Deluxe " Link TTime-Deluxe} @{" Grüße " Link Grüße} @{" Programmierer " Link Programmierer} @ENDNODE @NODE Rechtliches "Rechtliches" TTime-Abrechnung ist Freeware. Sie dürfen Kopien dieses Programmes mit den zugehörigen Anleitungen über die üblichen Kanäle weiter- geben, solange das Programm und dessen Anleitungen unverändert weitergegeben werden. Da TT-Abrechnung nur in Verbindung mit @{" TTime-Deluxe " Link TTime-Deluxe} verwendet werden kann, ist der Kreis der in Frage kommenden Anwender natürlich recht klein. Bestandteile des Paketes "TT-Abrechnung" : - Programm "TT-Abrechnung" mit Piktogramm - Anleitung mit Piktogramm im Guide-Format - Anleitung mit Piktogramm im ASCII-Format - ASCII-Datei "Geschichte.TXT" mit Piktogramm @ENDNODE @NODE Voraussetzungen "Voraussetzungen" Damit Sie TT-Abrechnung nutzen können benötigen Sie folgendes: - Einen Amiga mit mindestens 2MB RAM - Vollständig installiertes Amiga-OS 2.04 oder besser - Programm @{" TTime-Deluxe " Link TTime-Deluxe} @ENDNODE @NODE Haftung "Haftung" Obwohl ich TT-Abrechnung mit großer Sorgfalt programmiert und getestet habe, sind Fehler nicht ganz auszuschließen. Ich über- nehme keine Verantwortung für Schäden, die durch installieren und/oder nutzen von TT-Abrechnung entstehen. Wenn Sie Fehler (vor allem reproduzierbare) entdecken, können Sie mir diese mitteilen (siehe @{" Programmierer " Link Programmierer}). Ich werde dann versuchen, diese(n) Fehler so schnell wie möglich zu beseitigen. @ENDNODE @NODE Was_ist_TT-Abrechnung "Was ist TT-Abrechnung" Dieses Programm ist dazu gedacht, gespeicherte Verbindungsdaten von @{" TTime-Deluxe " Link TTime-Deluxe} (TTime-Protokoll) zu bearbeiten. Dazu wird das gespeicherte Protokoll eingelesen und alle Verbindungen in einer Liste aufgeführt. Hinweis: Wenn Sie nur die Light- oder Demo-Version (unregistriert) von TTime-Deluxe haben, können Sie zwar die angefallenen Kosten einsehen, aber Datum und Uhrzeit der Verbindungen bleiben Ihnen vorenthalten. Mit TT-Abrechnung haben Sie folgende Möglichkeiten: - Einen beliebigen Abrechnungszeitraum einstellen - Verbindungsdaten des Zeitraumes ansehen - Verbindungsdaten des Zeitraumes als TExt-Datei speichern - Verbindungsdaten des Zeitraumes drucken (noch nicht perfekt) - Kosten für den eingestellten Zeitraum berechnen lassen - Den eingestellten Abrechnungszeitraum aus der Protokoll- datei entfernen (ausschneiden) @ENDNODE @NODE Besondere_Merkmale "Besondere Merkmale" TT-Abrechnung ist in der zweiten Version etwas komfortabler geworden. In Version 1.0 wurde ein Zeitraum noch über zwei Schieberegler eingestellt. Bei sehr vielen Verbindungsdaten wurde dies mitunter zum Geduldsspiel. Die Version 2 bietet jetzt folgende herausragende Merkmale: - Anzeige einer Liste mit bis zu 800 gespeicherten Verbindungsdaten - Datum und Zeitraum jeder gespeicherten Verbindung wird angezeigt - Beginn und Ende eines Zeitraumes wird per Mausklick ausgewählt (Datumseingabe evtl. später) @ENDNODE @NODE Installation "Installation" Eine aufwendige Installation ist nicht erforderlich. Es wäre aber sinnvoll, die gesamte Schublade mit allen Dateien in das Unterverzeichnis zu kopieren, wo sich auch schon @{" TTime-Deluxe " Link TTime-Deluxe} befindet. @ENDNODE @NODE Programmstart "Programmstart" Gestartet wird TT-Abrechnung durch doppelten Mausklick auf das zugehörige Piktogramm (Icon). Nach kurzer Ladezeit sollte sich auf dem Workbench-Bildschirm ein Fenster öffnen. Ist dies nicht der Fall, könnte es entweder am minderwertigen Betriebsystem (@{" Voraussetzungen " Link Voraussetzungen} beachten) oder Speichermangel liegen. Auf dem geöffneten Fenster bieten sich nun verschiedene Schalter zum "rumspielen" an. Seien Sie aber vorsichtig. Schnell wurde ein Schalter betätigt, den man lieber nicht hätte wählen sollen. @{" Allgemeines " Link Allgemeines} @{" Verbindungsdaten-Liste " Link Verbindungsdaten-Liste} @{" Bedienelemente " Link Bedienelemente} @ENDNODE @NODE Allgemeines "Allgemeines" Das geöffnete Fenster verfügt über ein Schließ-Symbol zum beenden des Programmes, ein Tiefen-Symbol zum verstecken hinter andere Fenster und eine Ziehleiste, um das Fenster zu verschieben. In dieser "Dragbar" ist auch der Programmname nebst Programmversion zu erkennen. Im oberen Teil des Fensters (direkt unter der Fenster-Titelleiste) ist eine Statuszeile angeordnet, welche Sie auf bestimmte Zustände des Programmes aufmerksam macht. Links im Fenster sollte eine Liste der gespeicherten Verbindungs- daten von TTime zu sehen sein. Rechts im Fenster befinden sich die Schaltflächen zum steuern des Preogrammes @ENDNODE @NODE Verbindungsdaten-Liste "Verbindungsdaten-Liste" Die Liste in der linken Fensterhälfte zeigt alle von TTime gespeicherten Verbindungsdaten in der Reihenfolge, wie sie gespeichert wurden. Wenn das Systemdatum Ihres Amigas mal nicht korrekt war, kann es sein, daß mitten in der Liste ein Datum auftauch, welches dort nicht hingehört. Von der Reihenfolge der hergestellten Verbindungen ist es aber an der richtigen Position. Von links nach rechts werden für jede gespeicherte Verbindung das Datum, die Startzeit und die Endzeit angezeigt. Wenn Sie mit der Maus eine Zeile anklicken, wird diese unterhalb der Liste ineinem Text-Ausgabefeld angezeigt. Diese eine Zeile gilt so lange als ausgewählt, bis eine andere Zeile angeklickt wird. Das Datum der ausgewählten Verbindung können Sie mit einem der beiden @{" Setzen " Link Setzen} - Schalter (rechts im Fenster) als Bereich- Start oder auch als Bereich-Ende übernehmen (setzen). Mehr dazu erfahren Sie im nächsten Kapitel @{" Bedienelemente " Link Bedienelemente} @ENDNODE @NODE Bedienelemente "Bedienelemente" In der rechten Fensterhälfte befinden sich sämtliche Elemente, die Sie für die Bedienung von TT-Abrechnung benötigen. Ein Pulldown-Menü gibt es nicht. Sie können hier Abrechnungs- Zeiträume aus der Liste (links) übernehmen und diesen Zeitraum verarbeiten. @{" Setzen " Link Setzen} @{" Bereich berechnen " Link Bereich_berechnen} @{" Bereich exportieren " Link Bereich_exportieren} @{" Bereich drucken " Link Bereich_drucken} @{" Bereich anzeigen " Link Bereich_anzeigen} @{" Bereich entfernen " Link Bereich_entfernen} @{" Anzeigeprogramm " Link Anzeigeprogramm} @ENDNODE @NODE Setzen "Setzen" Durch betätigen einer der beiden "Setzen"-Schaltflächen können Sie ein aus der Liste ausgewähltes Datum (mit Zeit) sowohl als Beginn (Bereich von) als auch als Ende (Bereich bis) eines Abrechnungszeitraumes definieren. Der obere Schalter setzt dabei den Beginn eines Bereiches und der Untere das Ende. Zwischen diesen beiden Schaltern befindet sich ein weitere Schalter mit der Aufschrift "Alles". Wenn Sie diesen anklicken, werden alle Daten der Liste als Bereich eingestellt. Wählen Sie zuerst eine Verbindung in der Liste (links im Fenster) mit der Maus aus und betätigen Sie dann einen der beiden Setzen-Schalter. Wenn Sie aus versehen ein kleineres Datum für den Beginn setzen als für das Ende, wird TT-Abrechnung die beiden Daten selbstständig austauschen. Da der ausgewählte Bereich nur mit Datum angezeigt wird, können Sie durch anklicken des Schalters @{" Bereich berechnen " Link Bereich_berechnen} den aktuell eingestellten Zeitraum einsehen. In dem angezeigten Fenster sind neben den Daten auch die Zeiten zu sehen. @ENDNODE @NODE Bereich_berechnen "Bereich berechnen" Wählen Sie diesen Schalter, wenn Sie nur mal eben sehen möchten, wieviel der eingestellte Abrechnungszeitraum Sie kostet. @ENDNODE @NODE Bereich_exportieren "Bereich exportieren" Durch anwählen dieses Schalters wird eine Text-Datei auf einem beliebigen Datenträger erzeugt, die alle Verbindungsdaten des ausgewählten Zeitraumes enthält. Dies sind von links nach rechts: - Datum An diesem Tage wurden die Daten erfasst - Von Die Verbindung begann zu dieser Uhrzeit - Bis Die Verbindung hat bis zu dieser Uhrzeit gedauert - Vorwahl Zeigt die gewählte Vorwahl des Ziel-Eingabefeldes - Tarif Nach welcher Tarifzone wurde abgerechnet. Dieser Teil zeigt, in welcher Stellung sich der Tarif- Wahlschalter während der Verbindung befunden hat. - Einheiten Anzahl der aufgetretenen Einheiten und die Kosten - Online Kosten für T-Online-Nutzung - Takt Kosten für programmierten Zeittakt Die Schalter @{" Bereich drucken " Link Bereich_drucken} und @{" Bereich anzeigen " Link Bereich_anzeigen} verwenden das selbe Format der Darstellung. @ENDNODE @NODE Bereich_drucken "Bereich drucken" Der eingestellte Abrechnungszeitraum wird unverzüglich auf einem angeschlossenen Drucker ausgedruckt. Bei Seitendrucker kann es dabei NOCH leichte Probleme geben, weil die eingebaute Druck- Routine noch sehr simpel ist. Besser ist es, wenn Sie den eingestellten @{" Bereich exportieren " Link Bereich_exportieren} und mit einem anderen Programm ausdrucken. Das Format der Ausgabedaten habe ich im Kapitel @{" Bereich exportieren " Link Bereich_exportieren} bereits beschrieben. @ENDNODE @NODE Bereich_anzeigen "Bereich anzeigen" Wenn Sie die Daten weder exportieren noch drucken möchten, können Sie die Ausgabedaten (Format siehe @{" Bereich exportieren " Link Bereich_exportieren}) auch nur anzeigen lassen. Um das Rad nicht jedesmal wieder neu erfinden zu müssen, habe ich diesen Teil des Programmes so geschrieben, daß ein eingestelltes @{" Anzeigeprogramm " Link Anzeigeprogramm} von Ihrer Workbench zur Anzeige herangezogen wird. @ENDNODE @NODE Bereich_entfernen "Bereich entfernen" Vorsichtig mit diesem Schalter. Sie werden zwar vor ausführen der Funktion gewarnt, aber ein Requester ist schnell falsch bestätigt. Es ist Ihnen bestimmt aufgefallen, daß die Liste der gespeicherten Verbindungen immer länger wird. Nachdem Sie einen Teil der Liste exportiert oder ausgedruckt haben, können Sie diesen Teil aus der Protokolldatei ausschneiden lassen. Dieser Teil geht dabei (fast) unwiederbringlich verloren. Das einzige was übrigbleibt, ist ein Backup (Sicherheitskopie) der Datei, wie Sie vor der Entfernung des Bereiches im Speicher war. Da ich die Liste nur für 800 Datensätze ausgelegt habe, sollten Sie von Zeit zu Zeit einen Teil der Daten ausschneiden und damit die Protokolldatei verkürzen. @ENDNODE @NODE Anzeigeprogramm "Anzeigeprogramm" Da die Funktion @{" Bereich anzeigen " Link Bereich_anzeigen} einen externes Anzeigeprogramm benötigt, können Sie diese durch anklicken des Schalters "Anzeigeprogramm" auswählen. Unterhalb dieses Schalters können Sie den namen des aktuellen Anzeigers ablesen. Der Zugriffspfad wird aber nicht angezeigt. Den sehen Sie nur, wenn Sie ein anderes Anzeigeprogramm wählen möchten. Wenn Sie kein Programm gewählt haben, wird TT-Abrechnung das Programm "More" aus dem Verzeichnis "Utilities" der Workbench verwenden. Alternativ können Sie auch die Programm "AmigaGuide" oder "Multi- view" auswählen. Haben Sie ein Programm, welches eine Textdatei mit sauberer Seiten- trennung zu papier bringt ? Lässt sich dieses Programm aus einem Shell-Fenster heraus mit angabe der zu druckenden Textdatei starten ? Dann können Sie auch dieses Programm hier einstellen und haben damit eine bessere Druckroutine als die von TT-Abrechnung. @ENDNODE @NODE Programm_beenden "Programm beenden" Einfach das Schließ-Symbol des Fensters anklicken. TT-Abrechnung wird sich dann ohne Sicherheitsabfrage beenden. @ENDNODE @NODE TTime-Deluxe "TTime-Deluxe" Was ist TTime-Deluxe ? Es handelt sich hierbei um einen Telefon-Timer, der mit zustandekommen einer Telefonverbindung per Mausklick oder Schalter gestartet wird und Sie über die aktuellen Verbindungs- kosten informiert. Bei Modem-Verbindungen kann der Zähler von TTime auch automa- tischgestartet werden. Dazu muß das Modem am seriellen An- schluss des Amiga oder einer MultifaceCard angeschlossen sein und das "Carrier-Detect"-Signal an diesen Anschluss schalten. Wenn Sie eine andere Schnittstellele verwenden und mit dem Programm "MIAMI" ins's Netz gehen, können Sie auch Miami als Autostart-Quelle einstellen. Fern-Start des Zähler ist per ARexx ebenfalls möglich. Sollten Sie angemeldeter Nutzer von T-Online (BTX) sein, können Sie auch das dadurch entstehende Nutzungsentgelt zählen lassen. Für den Internet-Übergang können Sie zusätzlich einen Zeittakt programmieren. Auch die PPP-Übergänge der Telekom werden berücksichtigt. In der registrierten Version können Sie durch Eingabe einer Vorwahl-Nummer die Tarifzone automatisch einstellen lassen. TTime kennt dafür über 5000 Ortsnetze im Inland, 180 Auslands- Vorwahlnummern und diverse Sondernummern (0190.., 0180.., 0137.., D1, D2, E+ usw). Bezugsquellen für TTime-Deluxe sind: - Aminet (comm/misc) - AmigaPlus-CD 4/96 (Netz) - Meine Homepage (siehe @{" Programmierer " Link Programmierer}) @ENDNODE @NODE Grüße "Grüße" Ich grüße alle Mitglieder des "Amiga Club im BTX". Danke an all diejenigen, die sich für @{" TTime-Deluxe " Link TTime-Deluxe} registrieren ließen @ENDNODE @NODE Programmierer "Programmierer" TT-Abrechnung habe ich unter BlitzBASIC 2.1 entwickelt. Mit einigen Tricks lassen sich damit recht brauchbare Programme schreiben. Leider haben einige sehr spezielle Befehle immer noch ein paar "Mäckchen". Daher ist auch TT-Abrechnung kein reinrassiges BASIC-Programm, sondern mit Assembler vermischt. Außerdem habe ich, wo möglich und sinnvoll, auf Routinen des Betriebsystemes zugegriffen. Fragen und Anregungen können Sie direkt an mich leiten. Wenn Sie eine schriftliche Antwort erwarten, sollten Sie mir einen frankierten Rückumschlag für die Antwort zuschicken. Adresse: Jürgen Reinert Am Kirchberg 4 D-31275 Lehrte Tel. : 05175-3972 BTX-Mail: 051753972-0001 E-Mail : ac-techno@T-Online.de Homepage: http://home.t-online.de/home/ac-techno/homepage.htm Neue Versionen von TT-Abrechnung, TTime-Deluxe, Updates und andere meiner Programme können über die Download-Seite meiner Homepage im Internet direkt geladen werden. @ENDNODE