EQSL.CC INBOX DOWNLOADING PROCEDURE revised 22 May 2008 Any questions or problems may be directed to Dave Morris, N5UP, E-mail to N5UP@eqsl.cc SYNOPSIS Users of the eQSL.cc system normally log into the web site with a username and password in order to retreive their new incoming eQSLs (from the InBox). Some logging software authors have expressed an interest in being able to download a portion or all of the InBox. For this purpose, the DownloadInBox.cfm program was created. HOW TO USE THE "DownloadInBox.cfm" PROGRAM This web page is actually an interactive ColdFusion "form" processor that accepts parameters to control its operation. It returns a response HTML page containing 2 hyperlinks to files in which the ADIF formatted InBox data is stored. It must be mentioned at this time that the InBox does NOT contain anything like the contents of the user's station log. These are the INCOMING cards, and not the Outgoing ones. It is crucial to understand the difference and what effect that will have on things like Callsign and RST tags. You can call the program with the following parameters in the URL: UserName = Callsign (mandatory if not logged in; Ignored if already logged in) Password = Password (mandatory if not logged in; Ignored if already logged in) QTHNickname = QTH Nickname (if not logged in, if multiple accounts with same callsign) (Note that if you are already logged in, Username and Password will be ignored, and you will be getting the InBox of the account you are logged into.) Optional LimitDateLo = Earliest QSO date to download LimitDateHi = Latest QSO date to download RcvdSince = (YYYYMMDDHHMM) Everything that was entered into the database on or after this date/time UnconfirmedOnly = Set to any value in the URL to signify you only want to download Inbox items you have not confirmed Archive = 1 for Archived records ONLY; 0 for Inbox (non-archived) ONLY; omit this parameter to retrieve ALL records in Inbox and Archive Remember that special characters such as brackets <> and colons : should be escaped. Ampersands & and question marks ? have special meaning to our programs and should be escaped when they appear in the data itself. The following example downloads the contents of the InBox for the user Test-SWL with all cards received since February 1, 2005: http://www.eqsl.cc/qslcard/DownloadInBox.cfm?UserName=Test%2DSWL&Password=TestPswd&RcvdSince=20050201 The following example downloads only unconfirmed InBox items for the user Test-SWL with all cards received since February 1, 2005: http://www.eqsl.cc/qslcard/DownloadInBox.cfm?UserName=Test%2DSWL&Password=TestPswd&RcvdSince=20050201&UnconfirmedOnly=1 RETURN PAGE FORMAT: Look for the string "Your ADIF log file has been built" in the returned page to indicate success. Somewhere on the page after that that will be two A HREF hyperlinks. The files contain identical contents, but one has an ADI extension, while the other has a TXT extension. This is solely for the benefit of browser access and automatic file type associations. If you are reading the ADIF file with software, you can choose either file. The files will stay on the system for a few hours and are then deleted, so you should retrieve the file as soon as you can. ADIF HEADER CONTENTS: The ADIF header will contain something like the following: ADIF 2 Export from eQSL.cc Received eQSLs for TEST-SWL for QSOs between 16-Jun-2002 and 08-Jun-2011 Generated on Monday, November 26, 2007 at 7:28:05 PM GMT eQSL.cc DownloadInBox 2 MODIFICATIONS TO THIS DOCUMENT OR TO SPECIFICATIONS 26 Nov 2007 First draft 18 Mar 2008 Added UnconfirmedOnly parameter 22 May 2008 Added Archive parameter