...
Interfacing systems are required to download fish ticket numbers from the eLandings system for each report that the interfacing system will submit. Sets of fish ticket numbers can be downloaded in anticipation of future reports. Each number downloaded shall be used for one, and only one, report.
Failure modes: if an interfacing system generates its own fish ticket numbers and uses them to submit reports then confusion can result. The reports will be saved successfully, but referencing reports by fish ticket number may result in the wrong report being referenced.
Exceptions: if an interfacing system generates a report, but has a user submit it through the Report Import web page then the fish ticket numbers in the report may be replaced with new number generated on the eLandings system. This depends on whether or not the fish ticket numbers in the report are importable numbers, retrieved from the Importable Numbers web page. If the fish ticket numbers are replaced the interfacing system can get them by having the user input them, or by having the user download the resulting report on eLandings and feed it back to the interfacing system.
For additional information see:
getFishTicketNumbers()
Uploading Reports
Interfacing systems are required to upload reports one at a time. That is, one call to eLandings for each report. No capability for mass upload of a single file containing multiple reports will be provided. Multiple report uploading would increase the complexity of error feedback to interfacing systems if reports have errors.
For example, let us say that uploading 100 records typically takes your application two minutes to run. If the upload fails after 1 minute and 17 seconds, how do you recover? How do you know which records were uploaded and which failed? Compare this to a single report upload situation. If you are uploading a single report and it fails, it is very easy to pinpoint what report failed to upload. It is easier to write error handling to handle errors in uploading a single report at a time.
Requests for a multiple report upload capability should not be made to the eLandings development or support team.
For additional information:
File Import
Manually importing & extracting reports via XML
saveLandingReport()
submitInitialLandingReport()
submitFinalLandingReport()
saveProductionReport()
submitProductionReport()
Report and Fish Ticket Number Conservation
...