imptempl.htm
____________
(vorher TEMPLATE.TXT)

Copyright (c) 1997-2020 DF7BE Wilfried Brunken
Creative Commons License CC BY-SA 2.0 de

< allgemeine Textvorlage >
< Bitte passen Sie die Beschreibung entsprechend den individuellen
< Gegebenheiten an>

Beschreibung des Importprogrammes für CLLOG:


______________________

"@(#) TEMPLATE.TXT Stand : mm.tt.yyyy"
ID-String von CVS
"@(#)$Id: imptempl.htm 20 2020-05-03 21:03:53Z df7be $"

Angaben ohne Gewährleistung.

Vendor                        :
gültig für Versionen          :
Lizenz des Originalprogrammes :
Datenbanktyp                  :
Zielsystem                    : LINUX/DOS/WINDOWS 16/32bit
Referenz                      : http://...

Autor des Importprogrammes    : 
Lizenz des Importprogrammes   : GNU General Public Licence
Dateiname des Archives        : .ZIP
Zielsystem des Importes       :
Import von                    : xyz.DBF
Art des Importes              : Vollimport / Interaktiver Import
Hinweise                      :

Dateiliste: TEMPLATE.PRG, TEMPLATE.EXE, TEMPLATE.TXT, IMPLIB.PRG, LOGDBVER.PRG, S87.PRG


Inhalt:
_______

1.    Nutzung und Weitergabe
1.1    Ausdrücklicher Haftungsausschluß
2.    Datenstrukturanalyse
3.    Installation und Durchführung des Importes
4.    Dateiliste
5.    Zusatzbeschreibung



1. Nutzung und Weitergabe
_________________________

Copyright :

Copyright (c) 1995-2001  


Copyright (c) 1985-1993, Computer Associates International, Inc.

Alle zum Programmkomplex "CLLOG" gehörenden Programme, Module und
Komponenten sind freie Software und unterliegen der
"GNU General Public License".
Jeder kann diese unter den Bedingungen der GNU General Public License,
wie von der Free Software Foundation herausgegeben,
weitergeben und/oder modifizieren, entweder unter der Version 2
der Lizenz oder jeder späteren Version.

Die Veröffentlichung dieser Programme erfolgt in der Hoffnung, daß es
allem von Nutzen sein wird, aber OHNE JEDE GEWÄHRLEISTUNG - sogar ohne
die implizite Gewährleistung der MARKTREIFE oder EIGNUNG FÜR EINEN
BESTIMMTEN ZWECK.

Details finden Sie in der GNU General Public License. Eine Kopie der
GNU General Public License erhalten Sie im Internet unter
www.gnu.de , www.gnu.org oder schriftlich bei der Free Software
Foundation Inc., 675 Mass Ave, Cambridge, MA 021139, USA.


Eine nicht offizelle Übersetzung der GNU General Public License finden
Sie im Internet unter http://www.gnu.de (den Abschnitt GPL auswählen).
Die verbindliche Originalversion in Englisch heißt hier "GPL.TXT" und
sollte diesem Programm beiliegen.

< je nach verwendeten Kompiler , bitte Lizenzbedingungen
  genau durchlesen >

Die in den ausgelieferten EXE-Dateien befindlichen Runtime-Routinen
unterliegen dem Copyright von Computer Associates International, Inc.
(2. Zeile).
In den Lizenzbedingungen von wird von Computer Associates
"Ihr Softwareprodukt" als solches bezeichnet, welches mit CA-Clipper
erzeugt wurde (hier alle EXE-Dateien von CLLOG).

Daher gelten folgende Grundsätze für die Weitergabe und Nutzung
der CLLOG-EXE-Dateien
- Geben Sie alle EXE-Dateien nur zusammen mit allen anderen Dateien
  von CLLOG weiter (Das ist "Ihr Softwareprodukt")
- Entfernen Sie als Entwickler nicht die Copyright-Meldung von
  Computer Associates aus den Hauptprogrammen.
- Geben Sie neu erzeugte EXE-Dateien nur dann weiter,
  wenn Sie lizensierter Besitzer von CA-Clipper sind.
- Die EXE-Dateien dürfen niemals dekompiliert , verändert oder
  rückentwickelt werden.


1.1 Ausdrücklicher Haftungsausschluß
____________________________________

OHNE JEGLICHE GEWÄHRLEISTUNG
(siehe auch GNU General Public License )

Die Software wird so ausgeliefert WIE SIE IST und wurde mit größtmöglicher
Sorgfalt erstellt und getestet. Trotzdem kann eine einwandfreie Funktion
auf allen möglichen Rechnerkonfigurationen nicht gewährleistet werden.
Die Autoren des Programmes schließen jede Haftung für mittelbare oder
unmittelbare Schäden aus, die durch  Nutzung der Programme entstehen.
Das volle Risiko bezüglich Qualität und Leistungsfähigkeit liegt bei
Ihnen. Sollten sich die Programme als fehlerhaft herausstellen,
liegen die Kosten für den notwendigen Service, Reparatur oder Korrektheit
bei Ihnen.
In keinem Falle ist irgendein Copyright-Inhaber oder irgendein
Dritter, der die Software wie in der Lizenz erlaubt modifiziert oder
verbreitet hat, Ihnen gegenüber für irgendwelche Schäden haftbar,
einschließlich jeglicher allgemeiner oder spezieller Schäden,
Schäden durch Seiteneffekte (Nebenwirkungen) oder Folgeschäden,
die aus der Benutzung der Software oder Unbenutzbarkeit der Software
folgen (einschließlich - aber nicht beschränkt auf - Datenverluste,
fehlerhafte Verarbeitung von Daten, Verluste, die von Ihnen oder
anderen getragen werden müssen, oder dem Unvermögens der
Software, mit irgendwelchen anderen Programmen zusammenzuarbeiten),
selbst wenn ein Copyright-Inhaber oder Dritter über die Möglichkeit
solcher Schäden unterrichtet worden war.

Weiterhin kann nicht garantiert werden, daß die verwendeten Programme
je nach nationaler Rechtslage frei von Schutzrechten anderer sind.

Die Dateien enthalten möglicherweise urheber- , patent- und
markenrechtlich geschützte Firmen- und Markennamen sowie Produktbezeichnungen
verschiedener Soft- und Hardwarehersteller.


Achtung !
Beachten Sie bitte die Lizenzbedingungen des Programmes, aus dem Sie
Daten importieren. Für Verstöße gegen diese Bedingungen haftet weder der
Programmautor des Importprogrammes noch die Personen und Institutionen,
die das Importprogramm zur Verfügung stellen, sondern immer der Anwender des
beschriebenen Logbuchprogrammes.


2. Datenstrukturanalyse
________________________

Am Ende dieses Dokumentes finden Sie die Ausgabe der Strukturanalyse.
Falls Sie nicht sicher sind, ob das vorliegende Importprogramm zu Ihrer
verwendeten -Version paßt, laden Sie das CLLOG-Entwicklerpaket
von der Homepage von Z02 herunter.
Hier finden Sie auch ein Tool zur Analyse von DBF-Dateien.
Damit können Sie die Datenbestände von  überprüfen.
Das Importprogramm kann unter Umständen unterschiedliche Feldlängen anpassen,
fehlende Datenfelder und unterschiedliche Typen aber nicht.
Teilen Sie uns mit, wenn Sie auch mit einer anderen Version
Erfolg hatten, ansonsten benötigen wir Unterstützung von Ihnen,
um das Importprogramm zu erweitern.


3. Installation und Durchführung des Importes
__________________________________________


1.) Es wird davon ausgegangen, daß  in einem eigenen
    Verzeichnis installiert wurde (z.B. C:\ALTESLOG).

   Machen Sie den Datenbestand unter  konsistent:
    - Die noch nicht erfassten QSO's eingeben.
    - QSL-Schulden begleichen.
    - QSL-Eingabe einarbeiten.
    - Conteste und Runden abschließen, damit der Datenbestand in der
      Hauptdatei eingearbeitet wird.
    Sichten die Sie den gesamten Datenbestand noch einmal kurz.
    Notieren Sie einen "Stichtag" in Ihrem Papierlog oder
    woanders.
    Danach dürfen im alten Datenbestand keine Änderungen mehr
    vorgenommen werden.

2.) Installation von CLLOG:
    Sie haben CLLOG noch nicht installiert ?
    Erzeugen das Verzeichnis von CLLOG neu (z.B. MD LOG )
    und installieren Sie das Programm CLLOG dort, ohne es
    aufzurufen.
    Löschen Sie ggfs. den Demobestand von CLLOG, wenn sie neu beginnen
    wollen. Lesen Sie dazu die Installationsanleitung in CLLOG.TXT
    genau durch.

    Falls Sie CLLOG bereits installiert haben und Sie schon Daten
    eingegeben haben:
    - machen Sie eine Datensicherung ( Sie können auch den gesamten Inhalt
      des CLLOG-Arbeitsverzeichnisses in ein eigenes Verzeichnis auf Ihrer
      Festplatte kopieren)
    - Notieren Sie sich die Anzahl der bisher eingegebenen Datensätze.
      Starten Sie dazu CLLOG. Diese werden im Hauptmenü oben rechts
      angezeigt.
    - machen Sie weiter mit 3.)

3.) Packen Sie den Inhalt von TEMPLATE.ZIP in ein eigenes Verzeichnis
    z.B. C:\TEMPI aus.
    Kopieren Sie die den Import zuständige EXE in das
    Arbeitsverzeichnis von CLLOG:
    TEMPLATE.EXE

4.) Achtung ! ab jetzt darf weder  noch CLLOG gestartet sein !
    Kopieren Sie die folgenden Dateien aus  nach CLLOG:
      zum Beispiel :
      COPY C:\ALTESLOG\.DBF C:\LOG


5.) Gehen Sie in das Arbeitsverzeichnis von CLLOG (z.B. CD \LOG )
    und starten Sie das Importprogramm TEMPLATE.EXE

    Es werden folgende Programmoptionen angefragt:
    < bitte aufführen, was abgefragt wird >


6.) Wenn das Programm ohne sichtbare Fehlermeldung durchgegangen ist,
    sehen Sie in Datei IMPORT.LOG nach, welche Fehlermeldungen
    geschrieben wurden. Eventuelle Datenverluste durch Kürzen von
    Feldinhalten werden gemeldet.
    Bevor Sie die Datei mit einem Texteditor betrachten:
    Prüfen Sie die Dateigröße.
    Der MS-DOS Editor "EDIT" macht ab 64KByte Dateigröße Probleme.
    Falls Sie Probleme haben geben Sie einfach ein
    TYPE IMPORT.LOG | MORE
    Die Datei wird seitenweise dargestellt.
    In der Regel bleibt die Datei aber klein.

7.) Starten Sie CLLOG. Zuerst werden die Indexdateien neu erzeugt.
    Sichten Sie die importierten Daten (Bildschirmlisten).
    Nach einer Neuinstallation von CLLOG gehen Sie unter
    "I ... Installation" alle Punkte durch.

8.) Nacharbeiten:
    Drucken Sie dazu am besten IMPORT.LOG aus.
    Wurden Meldungen in IMPORT.LOG ausgegeben, so wird Ihnen die
    Datensatznummer aus der Quelldatei angegeben. Addieren Sie
    zu dieser Nummer die Anzahl der bereits vorhandenen Sätze aus CLLOG.
    Im Dialog "Bildschirmlisten / Datensatznummer" können Sie die
    Zielsätze ansteuern und korrigieren (z.B. sinnvolle Kürzung)
    Beachten Sie aber, daß die Plausibiltätprüfungen in diesem Dialog
    ausgeschaltet sind.
    Und so wird geändert:
    Gehen Sie mit dem Cursor auf das zu ändernde Feld und betätigen
    . Damit wird das Feld zur Änderung eingestellt.
    Wenn Sie nicht alle Datenfelder sehen:
    Mit den Cursortasten können Sie nach "rechts" rollen, dann
    sehen Sie weitere Datenfelder.

9.) Wenn Sie zufrieden sind , löschen Sie im Arbeitsverzeichnis
    von CLLOG die Dateien:
     DEL .DBF    
     DEL TEMPLATE.EXE
     DEL IMPORT.LOG

    Deinstallieren Sie  und entfernen Sie auch das Verzeichnis,
    in dem Sie das Importprogramm ausgepackt haben.

10.) Machen Sie vorsichtshalber eine Datensicherung von CLLOG mit
    dem importierten Datenbestand, bevor Sie weiterarbeiten.


Abbruch nach Laufzeitfehler:

Der Import ist erfolgreich beendet, wenn Sie die folgende Meldung
bekommen haben (in etwa):
 "Sätze importiert : nn
 in Ziel >LOGBUCH.DBF< von mmm bis  ooo".

Bei Importen mit Memo-Import ist eine 2. Meldung notwendig:
 "Sätze importiert : nn
 in Ziel >CALLMEMO.DBF< von mmm bis  ooo".

Wenn diese Meldung(en) nicht erscheinen, könnte es sein, daß ein Laufzeitfehler
vorliegt. Ein Laufzeitfehler wird vom Clipper-Laufzeitsystem in
der ersten Zeile des Bildschirms zumeist in englischer Sprache vermeldet.
Achten Sie verstärkt darauf.
Versuchen Sie jetzt, den Fehler zu beheben. (z.B. bei Platzmangel auf der
Festplatte oder Eintrag FILES= in CONFIG.SYS erhöhen).
Bei "unknown Variable xxx ..." paßt das Importprogramm nicht zur Programmversion
des alten Logbuchprogrammes. Bitte kontaktieren Sie in diesem Falle
den Programmautor, damit das Importprogramm angepaßt wird (oder auch
selber machen ?)

Auf jeden Fall müssen Sie jetzt die Daten von CLLOG anhand der Datensicherung
rekonstruieren. Haben Sie CLLOG in ein eigenes Verzeichnis kopiert,
geht das ganz einfach:

1.) alle Indexdateien löschen:
      DEL *.NTX
    bei LINUX:
      rm *.idx
     oder
      rm *.ntx

2.) kopieren Sie die folgenden 3 Dateien aus dem Sicherungsverzeichnis
    in das Arbeitsverzeichnis von CLLLOG:
    - LOGBUCH.DBF
    - CALLMEMO.DBF
    - CALLMEMO.DBT

3.) starten Sie CLLOG, damit die Indexdateien neu erzeugt werden.

Erst danach können Sie einen neuen Importversuch starten.


4. Dateiliste
______________

Das Auslieferungspaket LOGPROJ.ZIP muss folgende Dateien enthalten:

Beschreibung:
TEMPLATE.TXT      (diese Datei)

Quellcodes:
TEMPLATE.PRG
IMPLIB.PRG
IMPEDIT.PRG  < meist optional, wenn interaktiver Import>
LOGDBVER.PRG
S87.PRG

Ausführbare Programme
TEMPLATE.EXE


5. Zusatzbeschreibung
_____________________

Beschreibt die Regeln für den Import und das Ergebnis der
Datenstrukturanalyse.
Es ist bei einigen Datenfeldern mit Verlusten zu rechnen (Kürzung).



< tragen Sie hier die DBF-Datenstruktur ein ( oder die der
   vom Originalprogramm verwendeten Datenbank ) hier ein >

  Datenstruktur von .DBF:

   Header-Groesse  : n
   Satzlaenge      : m

NAME      TYP  FLEN DEC           Ziel in CLLOG