PTAGIS Data Specification

 

 

Interrogation File Processing

 

Simplified flow diagram for processing of interrogation files.

 

Validate file format

Interrogation files are checked against the appropriate interrogation file specification.

Reject file

If any validation checks fail, the entire file is rejected and no records are loaded into the database.

Check if file is loaded

Interrogation files are not versioned and can only be loaded once. Validation fails if a file with the same name has already been loaded into PTAGIS.

Validate site status

Check that the site code is registered in PTAGIS and that the site is active.

Validate site configuration

Check that each antenna ID for which a detection or diagnostic value is recorded exists in the site configuration for that time period.

Validate data values

Data values of each record are checked against the current interrogation data specification.

Load records

If all validation checks pass, all records are loaded into the database.

Send notification emails

Automated emails are sent to the distribution list as determined by site stewards. Two types of notifications are available for interrogation files: File Notification and Monitor Uploads. If File Notification is enabled for a site, automatic notifications are sent when a file is successfully loaded. This option is best for sites which are not connected to the internet and are unable to submit data automatically. If Monitor Uploads is enabled for a site, automatic notifications are sent if a file is NOT successfully loaded within a specified time period. This option is best for sites which are connected to the internet and able to submit data automatically. Regardless of  which notification type is enabled for a site, an email is always sent if a file is rejected.

Copy file to archive

The file is copied to the appropriate directory in the file archive.

Update reporting system

Newly appended records are pushed to the reporting system and available to query within 15-30 minutes of being received for processing.