ADIF File Processor (ADIFProc)Table Of ContentsIntroduction Open File To Process Input File Type Panel Edit Passwords Contents Progress
Window Introduction
ADIF
(Amateur Data
Interchange Format) is used to transfer amateur log data between different
logging programs and is also the format used to upload log data to eQSL.CC. It can also used to prepare
files for submission to ARRL’s TrustedQSL
program prior to uploading to LoTW.
The remainder of this document will guide you through the “how to” accomplish all of these things with ADIFProc System RequirementsMicrosoft Windows: 98, ME, NT-4.0 with Service Pack 6a,
2000 or XP. Installing ADIFProcClick here to download ADIFProc If you click “Open” (recommended) in the dialog that appears, ADIFProc will be installed automatically with a shortcut on your desktop and in your “Start->All Programs” list. If you decide to click “Save” instead, choose a convenient folder to save the setup file, then go there and click on “ADIFProc Setup.zip”. Follow the installer prompts; it should only take a few seconds to complete. Uninstalling ADIFProcTo uninstall ADIFProc go to your Control panel, select Add/Remove programs then select ADIF Splitter and click the Remove button. MenuFileOpen File To ProcessBefore selecting this item, you
should visit the Options item
in the Tools menu to be sure all options are properly
set Save Selected File TOWhen ADIFProc processes an ADIF file it creates one or more output files in a temporary folder and lists the filenames in the temporary file list. These temporary files are removed from the system when you close ADIFProc. You may want to save these files more permanently. To do that click on one of the file names to select it, then go to the File menu and select “Save File To”. A Save dialog box will appear allowing you to choose the folder in which to store the file. “Save Selected File To” is only available when a filename has been selected in the temporary file list. Upload Selected File to eQSL.CCIf you choose to upload your files manually to
eQSL.CC, do the following.: 1. Log
on to your account at eQSL.CC and select “Upload ADIF Log”. Ignore the notes
regarding files of more that 1000 records, it can easily handle 5000 or more
records. 2. Click on a filename in ADIFProc’s temporary
file list. 3. In ADIFProc’s File menu select “Upload
Selected File to eQSL.CC”. This will copy the selected filename to the windows
clipboard and pop up a little dialog asking if your upload completed
successfully –Don’t answer that right now, you
haven’t uploaded anything yet! 4. On
the eQSL upload page, scroll down to the filename text box. Right click in
that box and select “Paste”. The filename on your clipboard will be pasted
into the eQSL text box. 5. On
the eQSL page click “Upload it” and wait for the upload to complete. Don’t
pay any attention to the time estimate given by eQSL, it will go very much
faster than the estimate. 6. When
the upload is complete answer the question in the little dialog box mentioned
in step 3. If you choose “Yes”, the file you just uploaded will be deleted
from the temporary file list. If you click “No” the file will remain in the
temporary file list giving you an opportunity to try again. 7. If there are still more files in your list, select another one and repeat steps 3 through.6. You don’t worry about losing track of which files you have already uploaded because if it’s in the list you haven’t uploaded it yet. Save Errors ToAfter processing a file with ADIFProc you may have a list of Warnings and/or Errors displayed. If you would like to save those to a file, select “Save Errors To” from the File menu. This will bring up a Save As dialog where you can select a folder and filename to create a file for your list of errors. Note that this item is only available when there are items in the Errors/Warnings list. ExitTo exit from ADIFProc select “Exit” in the File Menu or click the “X” on the upper right corner of the ADIFProc window. ToolsOptionsThe first things to do after installing ADIFProc is click “Tools” and then select “Options….”. The Options dialog will appear. Input File Type PanelThe only thing you can select in this version of ADIFProc is “ADIF”. The other grayed out options are placeholders for a future release. Actions Panel·
Split: (default is not checked) If you
have a large ADIF file that you want to upload manually, selecting this option
will enable you to split your file into several smaller pieces. The default
size for each file is 5000 log records. Experiments have shown that this size
generally works reliably for a foreground upload via eQSL’s ADIF upload page.
However, if you have problems with timeout errors you can choose a smaller
file size and if your feeling lucky you can try a larger size. See the
section entitled Upload Selected File to
eQSL.CC for a quick and easy way to manage your split files. ·
Check Syntax: (default is checked)
Check this box if you would like ADIFProc to check your ADIF file errors and
report them. ·
Correct Minor Errors: (default is not
checked) This checkbox is only available when “Check Syntax” is checked.
Check this box if you would like ADIFProc to attempt to correct minor errors
in your log. This includes such actions as correcting the ADIF field length
specifier based on an actual count of the data characters and inserting
missing RST values. ·
Auto Upload To eQSL.CC: (default is not
checked). This is a powerful feature that will automatically upload your log
one record at a time to eQSL and report errors on each record as it proceeds.
Because it uses a special set of .NET functions provided by eQSL and uses a
multi-threading algorithm to keep several records at a time in the upload
queue it runs pretty quickly. The author has seen upload speeds of up to 1000
records per minute on a 45Kbps dialup connection to eQSL.CC. Normally there
is no need to split your file if you are going to use this method of
uploading. The first time you check this box, a dialog will appear for you to
define at least one Callsign and Password for logging on to your account at
eQSL.CC. See the section entitled Edit Passwords
for more detail on using the dialog box · Reporet Duplicates from eQSL.CC:(default is not checked) This checkbox is only available when “Auto Upload to eQSL.CC” is checked. This checkbox allows you do decide if you want to have duplicate QSO’s listed in the Errors/Warnings list box. Often you know that you will have a lot of duplicates because many of the QSO’s in you log have been uploaded previously In that case you might choose not to have them listed as they will tend to mask the reports of actual errors. Check Syntax PanelNote these are radio buttons, that is, only one of
the choices can be selected at one time. ·
eQSL.CC: (default is checked) Check the
data fields for compliance with the eQSL additional requirements such as
Modes and Frequencies ets. ·
ADIF 1.0: Check only for compliance
with the ADIF 1.0 specification. · ADIF 2.0: Check for compliance with the proposed ADIF 2.0 specification. Since this specification is still undergoing changes the rule for this may change. If they do we will update the rules for this test. Output Panel·
Only eQSL.CC Fields: If this radio
button is selected the ADIF file or files that are created by ADIFProc will
contain only data fields that are imported by eQSL.CC. This greatly reduces the
size of the output files, which saves space, and speeds uploading. ·
All ADIF Fields: All properly formatted
fields that exist in the Input file are output whether or not they are in
compliance with the selected ADIF specification. Edit PasswordsWhen you auto upload an ADIF file
to eQSL.CC, (See the Options menu) ADIFProc
needs to know the Callsign and Password for the eQSL account you are
uploading to. The Edit Passwords dialog allow you to create a list of callsigns
and passwords for your eQSL.CC accounts and select one of them as the
default. To upload to a different account, simply select the desired callsign
in the list and click “Set As Default”. Be very careful with this or you may
wind up adding QSO’s to the wrong account. HelpContentsClicking on “Contents” in the “Help”
menu will display a copy of this document. Note that if you are reading a
section and follow one of the hyperlinks to a different section you can
quickly return to the original spot by using your browsers back button. About
Progress WindowWhenever
ADIFProc is processing a file, a progress window will be displayed on top of
the “Results” panel of ADIFProc’s main window. It displays a progress bar and
variety of information to keep you informed about how the process is
progressing. Note that the time remaining field is an a forecast based on the
time that it has taken to process the last few records and the number of
records remaining to be processed, it may not always be 100% accurate. If you
are processing a very small log file, it is possible that the entire
operation will complete before the progress window even has time to open.
However, when processing large logs and especially when auto uploading to
eQSL.CC this window provides vital information. Results SummaryA results summary is displayed in the top panel of the main ADIFProc window after input file processing has completed. This has two slightly different forms depending on whether you are just processing a file locally or are auto uploading to eQSL.CC.
What If Errors Occur
Copyright Notice/DisclaimerThis computer program is the property of W3ZJ Software. Copyright law and all international treaties protect it. All amateur radio operators and short wave listeners may copy it for personal use free of charge. Commercial use is expressly forbidden. No warranties of any kind are expressed or implied. Neither W3ZJ Software nor Richard Drake is responsible for any damages that may result from the use of this program.
|