docs(wiki): cover every ADIF import option (dup modes, cty/ClubLog, station fill, field remap)

This commit is contained in:
2026-08-06 16:16:52 +02:00
parent a10fb2413a
commit 3d1602c4bd
+50 -12
View File
@@ -6,19 +6,54 @@ export modes.
## Import ## Import
Import an `.adi` / `.adif` file into the active profile's logbook. On import, **File → Import** (`Ctrl+O`) → pick an `.adi` / `.adif` file the **Import ADIF**
OpsLog parses every field, maps standard fields to columns and keeps unknown but dialog opens with the options below. Import runs into the **active profile's**
valid ADIF fields in a per-QSO **extras** store (editable later). Country / logbook. A file **without a header** (records pasted from another log) imports
zones are enriched from `cty.dat` where missing. A file **without a header** fine. Progress shows live; a summary follows — imported / updated / duplicates /
(records pasted from another log) imports fine. skipped / total — with expandable **error** and **duplicate** lists.
- **Field remapping**: the import dialog can move a field as it reads it — ### Duplicate handling
e.g. the RSGB IOTA contest exports the island reference in `STATE`; add a
`STATE → IOTA` row and it lands where the award looks. A **duplicate** is a record with the same **callsign + UTC minute + band + mode**
- **Fill from profile**: optionally stamps your station fields *and* your as a QSO already in the logbook. Pick how they are treated:
default confirmation statuses (paper QSL, LoTW, eQSL, Club Log, HRDLog,
QRZ.com) on QSOs the file leaves empty — a WSJT-X log carries almost none. | Mode | What it does |
Existing values are never overwritten. |------|--------------|
| **Skip duplicates** *(default)* | Adds only new QSOs; existing ones left untouched. Safe default. |
| **Update duplicates** | Merges the file's non-empty fields (QSL / LoTW / eQSL / QRZ statuses & dates, etc.) onto the matching QSO — fields the file omits are kept. Use to re-sync from Log4OM or LoTW. |
| **Import everything** | Inserts every record, duplicates included. For deliberately merging two overlapping logs. |
### Enrichment options
- **Fix country & zones (cty.dat + ClubLog)** *(on by default)* — recompute
Country, DXCC and CQ/ITU zones from `cty.dat`, overriding the file. Corrects
what contest software exports wrong (e.g. RG2Y tagged Asiatic instead of
European Russia). ClubLog's date-ranged DXpedition overrides are applied on top
per QSO date (e.g. TO2A in 2012 → French Guiana) whenever the ClubLog data is
downloaded. Everything else in the ADIF is kept as-is. *Tip: combine with
**Update duplicates** to re-fix QSOs already in your log.*
- **Fill my station fields from my profile** *(off by default)* — backfill empty
`MY_*` fields (grid, rig, antenna, address, city, state, county, SOTA/POTA ref,
TX power…) plus Operator and Owner callsign from the active profile. Existing
values are kept; only `STATION_CALLSIGN` is left untouched so a mixed-call log
isn't re-routed. It **also** stamps your default confirmation statuses (paper
QSL, LoTW, eQSL, Club Log, HRDLog, QRZ.com — sent & received) on QSOs the file
leaves empty. Enable when importing **your own** log; leave off for someone
else's.
### Field remapping (move fields on import)
Contest software stores the exchange where its own module keeps it. The RSGB IOTA
contest, for example, exports the island reference in `STATE` — imported as-is it
becomes a US state and the IOTA award stays empty. Click **"The file puts a field
in the wrong place…"**, then add a `STATE → IOTA` row (add as many rows as you
need). The destination is filled **only where the file left it blank**.
### Unknown fields
Any valid ADIF field OpsLog doesn't promote to a column is preserved in a per-QSO
**extras** store — editable later and re-exported intact. Nothing valid is
dropped.
## Export ## Export
@@ -41,4 +76,7 @@ not lose your award-reference assignments.
- To move a batch of QSOs between logs, export selected → import into the other - To move a batch of QSOs between logs, export selected → import into the other
profile. profile.
- Re-syncing statuses from another logger (Log4OM, LoTW, QRZ)? Import the file
with **Update duplicates** — it merges the new confirmations onto your existing
QSOs without creating copies.
- Use **Find duplicates** (Tools) after importing to catch overlaps. - Use **Find duplicates** (Tools) after importing to catch overlaps.