Differences between revisions 2 and 5 (spanning 3 versions)
Revision 2 as of 2008-02-27 00:29:30
Size: 970
Editor: AA6YQ
Comment:
Revision 5 as of 2009-05-20 23:51:01
Size: 3564
Editor: AA6YQ
Comment:
Deletions are marked like this. Additions are marked like this.
Line 11: Line 11:
    a. click the '''Import standard ADIF''' button     a. set the '''ADIF style options''' panel to '''Import standard ADIF''' unless your ADIF file was generated by one of the applications listed in this panel, in which case you should select that application
Line 16: Line 16:

There are two primary issues when importing an ADIF log exported by another
logging application:

 1. recovering each QSO's DXCC entity

 1. synchronizing with LotW

The '''ARRL''' defines a unique, immutable '''Entity Code''' for each DXCC entity in
[http://www.arrl.org/awards/dxcc/dxcclist.txt]

The [http://www.dxlabsuite.com/ADIF.htm ADIF specification] provides a tag named '''DXCC''' to convey each QSO's '''Entity Code'''. If your ADIF file
specifies a '''DXCC''' tag for each QSO, then DXKeeper will accurately recover the DXCC entity you logged with each of your QSOs. Unfortunately, some logging
applications do not include the DXCC tag in exported ADIF files. When DXKeeper imports an ADIF record that doesn't specify an Entity Code, it
determines the QSO's DXCC entity by analyzing the callsign -- using today's '''callsign-to-entity rules'''. If you logged a QSO with KA1DX back in 1952, and
your logging application exports this QSO without the Entity Code for Minami Torishima (which in ADIF would be '''<DXCC:3>177'''), then DXKeeper will assign
the imported QSO's DXCC entity to be the continental US (Entity Code 291). To automate the correction of such QSO's, Joe W4TV created a set of '''Fix'''
scripts that inspect each QSO in DXKeeper's log, apply the callsign-to-entity rules in force as of the date of the QSO, and if appropriate modify the QSO's DXCC entity, CQ zone, ITU zone, Continent, and IOTA tag. You'll find these scripts in DXKeeper's '''Scripts''' sub-folder. To run a script, click the button labeled '''~''' in the '''Filter''' panel at the bottom of the '''Main''' window's '''Log QSOs''' tab; this will cause a '''Scripts''' button to
appear. Click the Scripts button, and use the '''Run Script''' window to navigate to DXKeeper's Scripts sub-folder and select the Fix script you wish to run.

If you select a script that potentially modifies your QSOs (as all Fix scripts do), you'll be given the opportunity to make a log backup before running the
script; agreeing to create such backups is a good idea. After a script runs, DXKeeper will display a report that summarizes the changes made. More
information about Scripts can be found in [http://www.dxlabsuite.com/dxkeeper/Help/Scripts.htm], or click one of DXKeeper's Help buttons and navigate to the '''Filtering, Modifying, and Reporting with Scripts''' topic in the '''Logging and Managing QSOs''' section.



Importing QSOs

To import QSOs from an ADIF file,

  1. Select the Main window's Import QSOs tab

  2. in the Options panel,

    1. uncheck all boxes except the Record import errors in error file box, which should be checked

    2. set the ADIF style options panel to Import standard ADIF unless your ADIF file was generated by one of the applications listed in this panel, in which case you should select that application

  3. click the Start button in the window's lower-left corner; a standard Windows file selector window name ADIF Import will appear

  4. use the ADIF Import window to select the ADIF file you wish to import; when you click it's Open button, DXKeeper will import the contents of the selected file into your log; if errors are encountered during this process, DXKeeper will display a file describing these errors when the import process has completed.

There are two primary issues when importing an ADIF log exported by another logging application:

  1. recovering each QSO's DXCC entity
  2. synchronizing with LotW

The ARRL defines a unique, immutable Entity Code for each DXCC entity in [http://www.arrl.org/awards/dxcc/dxcclist.txt]

The [http://www.dxlabsuite.com/ADIF.htm ADIF specification] provides a tag named DXCC to convey each QSO's Entity Code. If your ADIF file specifies a DXCC tag for each QSO, then DXKeeper will accurately recover the DXCC entity you logged with each of your QSOs. Unfortunately, some logging applications do not include the DXCC tag in exported ADIF files. When DXKeeper imports an ADIF record that doesn't specify an Entity Code, it determines the QSO's DXCC entity by analyzing the callsign -- using today's callsign-to-entity rules. If you logged a QSO with KA1DX back in 1952, and your logging application exports this QSO without the Entity Code for Minami Torishima (which in ADIF would be <DXCC:3>177), then DXKeeper will assign the imported QSO's DXCC entity to be the continental US (Entity Code 291). To automate the correction of such QSO's, Joe W4TV created a set of Fix scripts that inspect each QSO in DXKeeper's log, apply the callsign-to-entity rules in force as of the date of the QSO, and if appropriate modify the QSO's DXCC entity, CQ zone, ITU zone, Continent, and IOTA tag. You'll find these scripts in DXKeeper's Scripts sub-folder. To run a script, click the button labeled ~ in the Filter panel at the bottom of the Main window's Log QSOs tab; this will cause a Scripts button to appear. Click the Scripts button, and use the Run Script window to navigate to DXKeeper's Scripts sub-folder and select the Fix script you wish to run.

If you select a script that potentially modifies your QSOs (as all Fix scripts do), you'll be given the opportunity to make a log backup before running the script; agreeing to create such backups is a good idea. After a script runs, DXKeeper will display a report that summarizes the changes made. More information about Scripts can be found in [http://www.dxlabsuite.com/dxkeeper/Help/Scripts.htm], or click one of DXKeeper's Help buttons and navigate to the Filtering, Modifying, and Reporting with Scripts topic in the Logging and Managing QSOs section.


[http://groups.yahoo.com/group/dxlab/post Post a question or suggestion on the DXLab reflector]

["Logging"]

[:GettingStarted:Getting Started with DXLab]

QSOImport (last edited 2020-07-18 15:51:59 by AA6YQ)