cqrlog/help/h3.html
OH1KH 3e4ade1d85 Fixes to adif import
This is revision for PR #423 not yet accepted.

More user friendly, popup opens without click. Just mouse over.
Reimported err file can be deleted if it still caused errors.

---------

Commit #419 had errors in fAdifImport.lfm. I had cleaned it too much removing the popupmenu that should appear. Fixed.

I do not know if I also cleaned btnClose onClick, but as also the pas file did not had btnCloseClick procedure it might have been missing for long.
Now added btnCloseClick that sets boolean AbortEdit true. That stops long, or looping import.

Using popup at error file name with selection adif import file caused a loop if error file was not completely fixed. If there was still error(s) they were added to error file that was the same as imported file. Endless loop.
Now importing error file will create a new error file with different name.
2021-07-07 11:56:37 +03:00

381 lines
24 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>CQRLOG - Maintenance</title>
</head>
<body>
<table border="0" cellpadding="5" cellspacing="2" width="100%">
<tbody>
<tr>
<td valign="top"><img src="img/exc.png"></td>
<td bgcolor=ffffcc valign="top" align="justify"><strong>
<font color="red">WARNING!</font></strong>
Backup your data often! BACKUP your log directory at the end of EVERY session!
All that you need to backup and store in a safe place is the log database directory
located in the ~/.config/cqrlog/database folder, or you can enable the autobackup function
in Preferences. This autobackup function creates an ADIF file with a backup of your log.
</td>
</tr>
</tbody>
</table>
<table style="text-align: left; width: 100%;" border="0" cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td width="33%" align="center">[<a href="index.html" target="_top">Menu</a>]</td>
</tr>
</tbody>
</table>
<br>
<div style="text-align: left;"><strong>CQRLOG for LINUX by OK2CQR &amp; OK1RR</strong></div>
<p align=center><img src=img/line.png></p>
<h2><strong>Maintenance</strong></h2>
<div style="text-align: justify;">
<a name=ah24><strong>ADIF import</strong></a><br><br>
The main purpose is to add QSO records from other logging and/or contesting programs.
You may need it if you migrate from another logger or if you are adding contacts made
in a contest (any modern contesting program has the ADIF export facility, some older
programs may need a third party conversion utility).
<br><br>
Cqrlog now follows ADIF 3.1.0 specification of special UTF8 characters. Mainly they can be found from Name, QTH, Comment and Notes fields. Specification says that when there is special character(s) some adif tags may have suffix _INTL to show this. Like &lt;QTH_INTL:6&gt;Pyhtää
<br>If pure ASCII charcters are found the usual tag format is used. Like &lt;QTH:4&gt;Pori
<br>Every time special UTF8 character is found in tags, where specification allows, UTF8 printing routines are used and the _INTL suffix is added.
<br>At import side tags with suffix _INTL are read with UTF8 routines. Without _INTL with normal ASCII routines. This makes importing backward compatible with old cqrlog exports that have set tag lenght wrong if there has been special UTF8 characters in tag data.<br><br>
Go to QSO list (Ctrl-O on the main logging screen or File -> Show QSO list from the menu).
<br><br>
<img src="img/h39.png" border="0"><br><br>
From the menu <strong>here</strong> choose File -> Import -> ADIF.<br><br>
Click on 'ADIF' and an 'Open file' dialog appears.<br><br>
<img src="img/h40.png" border="0"><br><br>Navigate to the file you want to import and
click 'Open'. You will see a new dialog, click the 'Import' button here. You can also
add a QTH profile and a note ('Comment to QSO(s):') which will appear on every imported QSO record.
Using this option, a portable, mobile or QRP operation can be clearly marked.
<br>
You can also filter by date range of adif file records. Checking "No check for duplicates" and "ADIF file contains..." may speed up big ADIF imports.<br><br>
<img src="img/h41.png" border="0"><br><br>
If you import a huge file, you will see a progress bar, however import of a small file
is so fast that you never notice the progress indicator.<br><br>
If the ADIF file contains a grid locator (tag MY_GRIDSQUARE) that will be used upon import.
In the case that this is not present the grid locator from the selected profile will be used.
If also that is absent or incorret the default locator from the config will be used.
However the user can choose to override a MY_GRIDSQUARE from ADIF file by selecting the checkbox.
In this case MY_GRIDSQUARE from the ADIF file is overriden by the locator from the selected profile
or if no profile is selected the default locator from the config is used.<br><br>
<img src="img/h42.png" border="0"> <img src="img/h42b.png" border="0"><p>
The window now shows the import completion, the number of imported records and
the number of errors. If the ADIF file contains incorrect entries, they will be stored
separately in the file <strong>errors_HH_MM_SS.adi</strong> located in the user's home folder.
You can open, import or delete the file by pointing the name with left mouse click.</p><p>
If you plan to import fixed error file you have to fix every qso record line at point(s) the ERROR: -line(s) show.
After fixing a qso record you must delete corresponding ERROR: -line(s).<br>
Text editor to use must be defined at preferences/External viewers. If reimported error file still has errors you can delete it from popup menu and continue with new error file.<br>
<strong>NOTE:</strong> If you change tag text you have to check the length of text that is after tag name, before text itself, as <strong>:xx&gt;</strong> where
xx is the count of characters in tag string.
<i><br><br>
&lt;Complete adif qso record here&gt;<br>
ERROR: Wrong QSO IOTA: NO
<br><br></i>
<strong>NOTE:</strong> Error file now contains also qsos that are imported with shrunken adif tags. There is no need to import them again. You can fix shrunken tags with QSL list/Edit QSO.
<i><br><br>
&lt;Complete adif qso record here&gt;<br>
ERROR: Imported with shrink(s):<br>
STATE shrink to 4 chrs:05 // Yamagata-ken -> 05 /<br>
QSL_VIA shrink to 30 chrs:via Bureau, Direct, e-QSL, LoTW -> via Bureau, Direct, e-QSL, LoT<br>
<br></i></p><p>
<img src="img/h43.png" border="0"><br><br>
Duplicate entries (contacts already in the log) are indicated with a separate dialog
allowing you to exclude or include these records. This will be asked every time a duplicate is found. If you check <b>Case of duplicates; Remember my answer</b> it is asked only once and then the same answer is used every time a duplicate is found.</p>
<p align=center><img src=img/line.png></p>
<a name=ah25><strong>ADIF export</strong></a><br><br>
Go to QSO list using Ctrl-O or choose the QSO list from the upper menu - item 'File'.<br><br>
<img src=img/h39.png><br><br>
From the QSO list, choose 'Export' in the menu - item 'File'.<br><br>
<img src=img/h45.png><br><br>
Choose 'ADIF'. An usual a dialog appears (depending on the desktop used). Choose a
location and file name.<br><br>
<img src=img/h45b.png><br><br>
<img src=img/h45c.png><br><br>
When <b>OK</b> is pressed export begins.<br><br>
<p align=center><img src=img/line.png></p>
<a name=ah26><strong>HTML export</strong></a><br><br>
The same as above, only difference is to set column names and widths (in character counts). Note that contest Nr and Msg column names will get "R" or "S" added as last letter of column name.
<br><br>
<img src=img/h45d.png><br><br>
If "HTML auto size columns" is checked width setting is ignored and column width is set by longest text (in header or data).
<br><br>
<img src=img/h45e.png><br><br>
Choose the 'HTML' option from QSO list Export menu.<br><br>
<p align=center><img src=img/line.png></p>
<p><a name=ah27><strong>EDI export</strong></a><br><br>
This function can be used to export contest logs in .edi file format. This export requires a
suitable filter to be set. Generally only one band per file is allowed. Also make sure that the
fields like exchange sent/received are set properly before exporting. If you choose this export
you will see the follwing window.
<br><br>
<img src=img/h45f.png><br><br>
You can set the filename to export to as well as some meta data describing the equipment you
used for this contest.
<p align=center><img src=img/line.png></p>
<p><a name=ah28><strong>Cabrillo export</strong></a><br><br>
This dialog can be used to export contest logs in Carbillo format. Cabrillo is very compilcated to export as
almost all contests have their own QSO line layout and score counting. That's why Export has no score counting, but it offers
some statistics from exported qsos to help manual counting of claimed score.<br><br>
For export <b>Qso list/filter/create</b> or <b>Qso list/filter/Contest filter </b>has to be set to select qsos to be exported.<br>
If you used <b>Qso list/filter/Contest filter </b> you can press button <b>Frm Flt</b> to get contest name from filtered result.
<br><br>QSO-line header follows most used layout and can not be modified, except <b>width of callsign space</b> that affects both calls (my&amp;wkd).
<br><b>Use UpCase letters for all QSO records</b> is defaut checked and converts QSO lines to upper case. Mainly changes exchange messages if they have been written with low case letters. This setting can be saved to log settings file.<br>
Info sent and rcvd can be modified using selections. Some contests do not use <b>reports, they can be omitted from checbox.</b><br>
Exchange1 and Exchange2 can contain data by selected by selectors with <b>given space width</b> 1-99. If empty they are ignored.<br>
<B>TX count</b> is the transmitter count at the end of line. It can also be empty and so ingnored<br>
Many template layouts to study can be found from <b> http://www.contestlogchecker.com/cabrillo-templates.html</b>
<br><br>
With <b>Count pfx</b> user can get statistic count from qsos to certain country. Type in callsign prefix of country. If export thinks prefix is wrong
it clears column when moved away from it. Then try again. Example: VA is not ok, but VA1 will turn accepted as VE.
<br><br>
Export remebers last used settings (by used log). You can also save and load settings for different contests using <b>save and load buttons</b>.
<br> At bottom of form there is prograss indicator and after export there is some statistics and possible error message.
<br><br>
As cabrillo export output is very basic you may need to edit exported file afterwards with text editor to suit your purposes!
<br><br>
<img src=img/h45g.png> <img src=img/h45gg.png><br><br>
<p align=center><img src=img/line.png></p>
<p><a name=ah29><strong>Program version update:</strong></a><br><br>
Ubuntu 16.04, 17.10, 18.04 users can use CQRLOGs repository on Launchpad. To add repository to your system, put into terminal this:<br/>
<br>sudo add-apt-repository ppa:ok2cqr/ppa;sudo apt-get update;sudo apt-get install cqrlog<br>
<br>For those who does not use Ubuntu, load install package, or binaries, from: Cqrlog.com <a href="https://www.cqrlog.com/download" target="_new"> download page.</a><br>
<br>The binaries should work in any distribution. Please don't forget to install MySQL server, MySQL client, Hamlib libraries and if LoTW support is desired, trustedqsl package and libssl-devel must be installed.</p>
<table width="100%" border="0" cellpadding="5" cellspacing="2">
<tbody>
<tr>
<td valign="top"><img src="img/note.png"></td>
<td style="width: 100%; text-align: justify; background-color: rgb(204, 255, 255);">
<strong><font color="blue">Note:</font></strong> Very often Cqrlog version update requires just file /usr/bin/cqrlog change to latest version. If your package manager does not support latest version and you have well running old version in use just copy folder ~/.config/cqrlog with all files and subfolders to safe place as backup. Copy also
/usr/bin/cqrlog to same place. Then download the tgz file "Complete application directory for other distributions", extract file /usr/bin/cqrlog from there and copy it to your /usr/bin folder (you need to use root priveleges I.E sudo for that).
If everything works you have latest version. If not, just copy back your saved folder ~/.config/cqrlog and the old /usr/bin/cqrlog.
</td>
</tr>
</tbody>
</table>
<p align=center><img src=img/line.png></p>
<a name=ah30><strong>How to update Country files:</strong></a><br>
<ol>
<li>Unpack and copy all the files into the /ctyfiles folder in your CQRLOG main folder.
The purpose of this folder is to store these files only, it is not bound to CQRLOG and
does not affect its function.
</li>
<li>Start CQRLOG and select the 'Show QSO list' from the 'File' item in the main menu.
You can also get there using shortcut Ctrl-O.
</li>
<li>If you are already in the QSO list, go to menu. Click the 'File' item, then the 'Import'
option. Choose the DXCC data option, located at lowest position. A dialog appears,
navigate to your /ctyfiles folder. Click the 'Open' button. All files are read and if
the import completes, a small window with the message 'Import complete. Please restart
program' appears. Click the OK button and quit CQRLOG.
</li>
<li>Restart CQRLOG. The update is finished.</li>
</ol>
<table width="100%" border="0" cellpadding="5" cellspacing="2">
<tbody>
<tr>
<td valign="top"><img src="img/note.png"></td>
<td style="width: 100%; text-align: justify; background-color: rgb(204, 255, 255);">
<strong><font color="blue">Note:</font></strong> While opening your new country files
[see 3.], you dont need to open a particular file. The 'Open' button starts a procedure
which reads ALL files in the /ctyfiles folder.
</td>
</tr>
</tbody>
</table>
<br>
<table width="100%" border="0" cellpadding="5" cellspacing="2">
<tbody>
<tr>
<td valign="top"><img src="img/exc.png"></td>
<td style="width: 100%; text-align: justify; background-color: rgb(255, 255, 204);">
<strong><font color="red">WARNING!</font></strong> Don't attempt to create your own
country files. This can result in the program crashing or incorrect statistics. If you
find an incorrectly resolved station (no matter if current log or an old record), send
a note directly to me: martin@ok1rr.com. <strong><font color="red">ALWAYS</font></strong>
replace all files in the /ctyfiles folder! If you leave an old file or update only a single
file from the new version, the resulting tables will become out-of-sync which leads to
incorrect statistics. Also, the logger may not work properly.
</td>
</tr>
</tbody>
</table>
<br>
<table width="100%" border="0" cellpadding="5" cellspacing="2">
<tbody>
<tr>
<td valign="top"><img src="img/exc.png"></td>
<td style="width: 100%; text-align: justify; background-color: rgb(255, 255, 204);">
<strong><font color="red">WARNING!</font></strong> If you update your country files or
upgrade the CQRLOG version, <strong>always</strong> perform the 'Rebuild DXCC statistics'
which is accessible from the QSO list screen.
</td>
</tr>
</tbody>
</table>
<br>
Some users have reported that their DXCC statistics became 'out of sync' and the
actual DXCC scoring does not match the results reported by CQRLOG.<br><br>
Remember that a regular rebuild of your DXCC statistics is a matter of importance.
Rebuild if you upgrade country files, rebuild also if you upgrade the program version!
<p align=center><img src=img/line.png></p>
<a name=ah31><strong>QSL Manager Database update</strong></a><br><br>
Since version 0.8.0 CQRLOG uses its own QSL Manager database in a very simple, plain
text format (CSV, semicolon separated). The update is very simple. The automated update
checks the availability of a new version, downloads and unpacks the tar.gz file if
available. The new version must be imported - go to QSO list (Ctrl-O or from menu
<em>File -> Show QSO list</em>) and choose the <em>File -> Import -> Import
qsl managers database</em>.<br><br>
A manual update is also possible if you download a recent version from the CQRLOG site
<a href=http://www.cqrlog.com target="_new"><strong>http://www.cqrlog.com</strong></a>.<br><br>
<img src=img/h107.png><br><br>
The QSL Manager database format is as follows:<br>
<pre>
call;qsl_manager;publishing_date
Example:
3D2BV;JA1PBV;2008-01
</pre>
You can maintain your own records but we carefully maintain this database with verified
records from reliable sources (DX Bulletins). The database is updated monthly and the
covered timespan of QSL Managers is limited to 10 years after publishing date. After
this time, the expired records will be removed and stored in another file (archive)
which will be available on the CQRLOG site
<a href=http://www.cqrlog.com><strong>http://www.cqrlog.com</strong></a>.<br><br>
<table width="100%" border="0" cellpadding="5" cellspacing="2">
<tbody>
<tr>
<td valign="top">
<img src="img/note.png"></td>
<td style="width: 100%; text-align: justify; background-color: rgb(204, 255, 255);">
<strong><font color="blue">Note:</font></strong> Because the HamQTH.com/QRZ.COM entries very often
contain details useful for direct lookup but not suitable to print on QSL labels,
choose the option <em>'Ignore HamQTH.com/QRZ.COM qsl info'</em> in the <em>Preferences ->
New QSO</em> dialog.
</td>
</tr>
</tbody>
</table>
<br>
If a station has more than one QSL Manager, click the small button to the left of the
QSL VIA field.<br><br>
<img src=img/h106.png><br><br>
A popup window of selections appears:<br><br>
<img src=img/h105.png><br><br>
Navigate to the appropriate QSL manager, use the publishing date column or verify the
QSL manager from another source. This ensures that the QSL label will contain the
proper QSL manager.
<p align=center><img src=img/line.png></p>
<a name=ah32><strong>Statistics rebuilding</strong></a><br><br>
<img src=img/h46.png><br><br>
The only way to rebuild your statistics is <strong>from the QSO list</strong>.
The 'Statistics' menu item has the 'Rebuild DXCC statistics' option (the similar option
on the logging screen does NOT have a 'Rebuild' option).<br><br>
<table width="100%" border="0" cellpadding="5" cellspacing="2">
<tbody>
<tr>
<td valign="top"><img src="img/exc.png"></td>
<td style="width: 100%; text-align: justify; background-color: rgb(255, 255, 204);">
<strong><font color="red">WARNING!</font></strong> The statistics rebuilding takes a long
time if your log contains tens of thousands records!
</td>
</tr>
</tbody>
</table>
<br>
<img src=img/h46.png><br><br>
A warning appears before the rebuilding process. If you answer 'Yes', be prepared for a
long wait.<br><br>
<img src=img/h47.png>
<p align=center><img src=img/line.png></p>
<a name=ah33><strong>Membership databases</strong></a><br><br>
CQRLOG supports online tracking of up to 5 memberships simultaneously. The membership
databases can also be used for filter creation, along with a date span (from-to).
The tracking and filtering feature is not limited to membership, you can create your
own databases using lists of your particular interests (short-term awards, local
groups etc.). The databases have a pure text format with data columns separated by
a semicolon ';'.<br><br>
The default installation contains data of some 57 clubs: AFM, AGCW, ARKTIKA, A1-CLUB,
A1-OP, CAV, CCT, CFO, CFT, CONVENIAT, CTC, CWJF, CWSP, DIG, DTC, EHSC, EPC, FFR, FIRAC,
FISTS, FMC, FOC, GACW, GQRPC, HACWG, HHC, HH, HSC, HTC, JAIG, MARCONISTA, MCL, MFCA,
MF, OKDXC, OKDXF, OTC-SARA, PRC, PRL, QCWA, RAFARS, RIA, RNARS, RRDXA, RTC, SHSC, SKCC,
SPAR, SPDXC, TEN-TEN, TFC, UDXC, UFT, VHSC, VRK, WAP, 070-CLUB, 9ACWG.
<br>You can go to<br>
<pre>/home/~/.config/cqrlog/members</pre>
(the tilde ~ represents the name of your personal subdirectory within the 'home' folder).
<br><br>
Any membership file also contains a header consisting of two lines:
<pre>HSC
High Speed Club</pre>
where the first line represents the <strong>short</strong> name of the club and the second
line is the long <strong>club</strong> name. Both names must be in the header on separate
lines. The first line must be the same as the filename without suffix, ie. the HSC
membership list <strong>must</strong> be
<pre>hsc.txt</pre>
The mandatory suffix is
<strong>.txt</strong> and the filename must be in <strong>lowercase</strong>.<br><br>
You can examine the syntax which is more descriptive than this short example,
however there are basically 3 types of membership list files:<br><br>
<strong>1. Simple list of call signs.</strong> It does not contain any membership
number or date limits. Syntax:<br><br>
&nbsp;&nbsp;W5LGY<br>
&nbsp;&nbsp;W5LJT<br>
&nbsp;&nbsp;W5LKL<br>
&nbsp;&nbsp;W5LP<br><br>
ie. a <strong>single</strong> call per line.<br><br>
<strong>2. List of call signs with membership numbers.</strong> Syntax:<br><br>
&nbsp;&nbsp;DL5JAN;4603<br>
&nbsp;&nbsp;DL5JBM;4746<br>
&nbsp;&nbsp;DL5JBN;4642<br>
&nbsp;&nbsp;DL5JBW;5740<br><br>
ie. a <strong>single</strong> call and membership number per line. The call and the
membership number are separated by a semicolon ';'.<br><br>
<strong>3. List of call signs with membership numbers and date limits.</strong>Used
for short term awards or time span limited memberships. Syntax:<br><br>
&nbsp;&nbsp;6O2NG;533;1957-04;2005-03<br>
&nbsp;&nbsp;6Y5SR;868;1966-03;1982-07<br>
&nbsp;&nbsp;6Y5XG;331;1951-05;-<br>
&nbsp;&nbsp;7J1AEF;1297;1976-06;-<br><br>
ie. a <strong>single</strong> call, membership number and datelimits from-to, separated by
a semicolon ';', per line. See above the two optins: 6O2NG with membership number 533 was
a member of the club from April, 1957 to March, 2005. 6Y5XG with number 331 started his
membership May, 1951 and is still a member. The dash instead of a date (separated from
the begin date by a semicolon) denotes that the membership is still active. A dash can
be used <strong>only</strong> in the field for 'to'.<br><br>
<table width="100%" border="0" cellpadding="5" cellspacing="2">
<tbody>
<tr>
<td valign="top"><img src="img/exc.png"></td>
<td style="width: 100%; text-align: justify; background-color: rgb(255, 255, 204);">
<strong><font color="red">WARNING!</font></strong> You must keep lists of your particular
interests updated yourself! It is impossible for the authors to keep all these tables up-to-date,
however if you update a list and would like to share it with others, you are welcome!
</td>
</tr>
</tbody>
</table>
<br>
<p align=center><img src=img/line.png></p>
<a name=ah34><strong>Log backup</strong></a><br><br>
Your log is in the <br>
<pre>/home/~/.config/cqrlog/</pre>
(the tilde ~ represents the name of your personal subdirectory within the 'home' folder).
<br><br>
Backup this directory, however it is big. If you want to save space, export your log into
an ADIF file which is about half the size of the database directory. ADIF is also version
independent. Zipped or tared ADIF files also have a reasonable size if your log
contains several 100 000 records.
<p align=center><img src=img/line.png></p>
</div>
<table style="text-align: left; width: 100%;" border="0" cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td width="33%" align="center">[<a href="index.html" target="_top">Menu</a>]</td>
</tr>
</tbody>
</table>
<br>
</body>
</html>