ADIF-Import

Import eigener ADIF-Dateien

Mit dem ADIF-Import eines eigenen Logs können Sie Ihre QSO-Daten in das DCL importieren. Für die Auswertung im DCL muss jedoch immer beachtet werden, dass die entsprechende Verbindung auch von der Gegenseite bestätigt sein muss. Das unterscheidet sich also nicht von einer herkömmlichen Diplombeantragung anhand von QSL-Karten

Im DCL erfolgt das in der Regel automatisch durch einen Crosscheck (Kreuzvergleich) gegen 1.) die QSO-Datenbank des DML und 2.) gegen die Contestdatenbank. Mit anderen Worten: Nur wenn die QSO-Daten des QSO-Partners im DCL gespeichert sind, sind sie im Kreuzvergleich verfügbar. Dann kann Ihr QSO automatisch bestätigt und für einen Diplomantrag verwendet werden.

Weitere Möglichkeiten sind die Bestätigung durch LoTW, ClubLog oder eQSL, oder die Bestätigung durch einen Diplom-Manager.

Vorgehensweise

Nahezu jede Logsoftware besitzt standardmäßig eine ADIF-Exportfunktion. Damit lassen sich ausgewählte QSOs als ADIF-Datei lokal speichern. Diese Datei wird dann ins DCL importiert. Die Endung einer ADIF.Datei ist immer ".adi".

Beispiel:

Nach dem Login in das DCL klickt man im Menü auf Logbuch > ADIF-Import – danach die gespeicherte ADIF-Datei auf dem eigenen PC auswählen und mit einem Klick absenden.

Starten und Warten

Der Import wird nicht sofort, sondern als "Job" ausgeführt. Unter dem Menüpunkt Import Liste wird der erzeugte Job angezeigt.

Im Beispiel wird ein Job für das Hochladen von QSO-Daten aus einem Contest angezeigt

Mögliche Werte in der Spalte Status sind:

• n: neuer Job, wartet auf Ausführung
• p: Job in Bearbeitung
• x: Job wurde mit Fehler beendet
• f: Job wurde erfolgreich beendet
• LOG: Job wurde erfolgreich beendet und ein Protokoll wurde erzeugt, das durch Klicken auf LOG angezeigt werden kann.

Ist der Job abgearbeitet, klickt man zur Kontrolle der hochgeladenen QSO-Daten auf den blauen Eintrag "LOG" und öffnet damit das Protokoll. Die genaue Art der Ausgabe hängt allerdings von Browser-Typ und -Einstellung ab.

... und so sieht das Protokoll ggf. aus:

Häufige Fehler beim Import

Häufig fehlen in der Importdatei die folgenden wichtigen Einträge:

• Rufzeichen
• Datum und/oder Uhrzeit
• Band
• Mode
• RST

Das DCL kann diese Fehler nicht selber korrigieren. Es ist deshalb wichtig, die zu importierende Datei möglichst vorher auf Korrektheit zu überprüfen.

Falls Sie hinterher Daten mit Ihrer Logsoftware in der ADIF-Datei ergänzt haben, können Sie den ADIF-Import wiederholen. Felder, die beim ersten Import leer geblieben waren, können so nachträglich gefüllt werden. Bereits gefüllte Felder werden nicht überschrieben.
Sind versehentlich falsche Werte importiert worden, können diese nur in der DML-Logbuch-Maske korigiert werden, oder Sie löschen das QSO dort komplett und importieren es erneut.

Falls Sie mehrere Einträge in der Call Historie haben: Gültig-markierte(!) Rufzeichen aus der Call Historie werden beim ADIF-Upload zur Auswahl angeboten. Das ist eine Möglichkeit, Daten für frühere Rufzeichen in das DCL zu bekommen, falls es für das frühere Rufzeichen keinen eigenen DCL Account gibt.

Die Daten werden unter dem ausgewählten Rufzeichen importiert, egal was in der ADIF-Datei im Tag <STATION_CALLSIGN> steht. WICHTIG: Achten Sie deshalb darauf, das richtige Rufzeichen auszuwählen.
(Falls Sie hier einen Fehler gemacht haben, können Sie den Import innerhalb von 4 Wochen, durch  Anklicken des roten Kreuzes am rechten Rand der Import Liste, rückgängig machen.)

Technische Details

Um Mißverständnissen vorzubeugen, hier noch einige technische Details zur Umsetzung:

Regelwerk 1: Der ADIF-Import übernimmt den Wert aus einem ADIF-Feld, wenn das entsprechende Datenbankfeld erst neu angelegt wird (neuer QSO-Eintrag) oder wenn das entsprechende Datenbankfeld leer ist (vorhandener QSO-Eintrag).

Einmal aus einem ADIF-Import in die Datenbank übernommene Werte können per ADIF-Import nicht geändert werden. Sind Änderungen nötig, können Sie a) die Logbuchmaske benutzen, um Wert zu löschen oder zu ändern, oder b) in der Logbuch-Liste den ganzen Eintrag löschen und per erneutem Import korrigiert erzeugen.

Ausnahmen:

• ADIF-Feld <QSL_SENT>: Enthält das entsprechende Datenbankfeld qslout nicht "Y", so kann ein Wert "Y" jederzeit per Import gesetzt werden. Diese Ausnahme wurde implementiert, um zeitlich verzögerte Wertänderungen (Ereignis: Abschicken einer QSL-Karte) zu ermöglichen.
• ADIF-Feld <QSL_RCVD>: Enthält das entsprechende Datenbankfeld qslin nicht "Y", so kann ein Wert "Y" jederzeit per Import gesetzt werden. Diese Ausnahme wurde implementiert, um zeitlich verzögerte Wertänderungen (Ereignis: Eintreffen einer QSL-Karte) zu ermöglichen.
• ADIF-Feld <QSL_RCVD>: Wird beim Import ein "bestätigt"-Status "i" durch Kreuzvergleich erreicht, so setzt das DCL das entsprechende Datenbankfeld qslin auf "Y", egal, welcher Wert dort gerade vorhanden ist. 
• ADIF-Feld <DARC_DOK>: Der DOK der Gegenstation wird nicht aus der ADIF-Datei übernommen, sondern, wenn das zugehörige Datenbankfeld DOK2 leer ist, durch eine Automatik aus den Daten von DARC und VFDB errechnet. Diese Berechnung passiert also in der Regel nur einmal beim ersten ADIF-Import.
  (Zusätzlich gibt es noch 2 weitere Datenbankfeldler dok2b und dok2v, deren Werte bei jedem ADIF-Import durch die Autmomatik berechnet werden.)
• ADIF-Feld <DXCC>: Die DXCC Entity Number der Gegenstation (z.B. 230 für Deutschland) wird nicht aus der ADIF-Datei übernommen, sondern, wenn durch eine onnline-Anfrage bei ClubLog ermittelt und in das zugehörige Datenbankfeld adif2 eingetragen. 
  (Davon wird auch das Hauptrufzeichen (z.B. "DL") für das Datenbankfeld dxcc2 abgeleitet.)

Regelwerk 2 zum QSO-Status:

• Das DCL kennt die "unbestätigt"-Statuswerte x und w  sowie die "bestätigt"-Statuswerte c, i, m, n und o.
• Beim ADIF-Import werden QSO-Einträge mit Status x neu angelegt und können durch Kreuzvergleich gegen andere Einträge in der QSO-Datenbank oder durch Kreuzvergleich gegen die Einträge der Contestdatenbank den "bestätigt"-Status i erreichen.
• Wird beim Import ein "bestätigt"-Status "i" durch die Kreuzvergleiche nicht erreicht, erhält das Datenbankfeld status den Wert "x". Hat oder bekommt aber das Datenbankfeld qslin (das entspricht beim Import dem ADIF-Feld <QSL_RCVD>) den Wert "Y", so ändert sich der status-Wert auf "w" ("wartend"). Im Datenbankfeld  qsl_source wird ein Eintrag "DML[<Jobnummer>]<Datum> eingetragen.
• Wird beim Import ein "bestätigt"-Status "i" durch die Kreuzvergleiche erreicht, erhält das Datenbankfeld status den Wert i. Im Datenbankfeld  qsl_source wird ein Eintrag "DML[<Jobnummer>]<Datum>" eingetragen.

Geschwindigkeit

Die Geschwindigkeit des ADIF-Imports hängt u. a. stark von den Inhalten Ihrer ADIF-Datei ab. Je mehr ADIF-Felder auszuwerten sind, desto länger die Laufzeit. Zusätzlich brauchen QSOs mit deutschen Stationen etwas mehr Zeit, weil bei diesen automatisch der DOK ermittelt wird. 
Die Schwankungsbreite bei der Geschwiindigkeit ist sehr groß, Rechnen Sie, ab Start des Jobs, konservativ mit 4 Datensätzen pro Sekunde.
Der tatsächliche Wert wird selten darunter, häufig deutlich darüber liegen. Der gemessene Mittelwert liegt zurzeit bei rund 16 Datensätzen pro Sekunde. (Stand 2024-03).

Dazu kommt die Wartezeit bis zum Start, die der Job in der Warteschlange mindestens verbringt. Da die Job-Abarbeitung immer zur vollen Minute beginnt, beträgt diese Wartezeit, bei sonst leerer Warteschlange, im statistischen Mittel 30 Sekunden.