05-uploads
Data Uploader is an easy way to integrate your information system with TraceTracker GTNet. If you don't want to or cannot use GTNet Query Interface and GTNet Capture Interface for integrating with
GTNet, you can make your information system export XML files into Data Uploader user data directory (or do it manually, if needed) and let Data Uploader automatically upload these files to appropriate data repositories.
Location of upload directories
Unless you configure location differently, user data directory is located at ~/.slurp/userdata/ on Linux, resp. %USERPATH%\.slurp\userdata\ on Windows. (Hereinafter marked by {USERDATA} placeholder).
For every data repository, there is a set of directories to be used for scheduled data uploads in {USERDATA}/{datarepository}/uploads/{username}/ (Hereinafter marked as {UPLOADSBASE}). For instance, if you configure data repository URL as https://yourcompany.globaltraceability.net:8443/tix/yourtixname and you use username alice, {UPLOADSBASE}will be {USERDATA}/yourcompany.globaltraceability.net-8443.tix.yourtixname/uploads/alice/
Structure of upload directories
There are four directories used for scheduled uploads.
Directory | Description |
|---|---|
| the directory where the application looks for data files that should be uploaded. When any XML file is placed to this directory, data uploader will detect the file (according to the schedule) and try to upload it to the respective data repository. Subdirectories in data are used by plugins to upload different file types than XML (currently only CSV is supported) or to ensure that files are uploaded in different than chronological order. |
| the directory where successfully uploaded data files are stored. In case of successful upload, file is moved from |
| the directory where data files that cause a failure are stored. In case of unsuccessful upload, file is moved from |
recovery | the directory where failed data files should be put after they have been corrected. Files in this directory will be uploaded before files in the |
partiallyok | the directory where data files that have been marked by TIX as partially okay are put. See the below paragraph for a detailed explanation. |
Partially OK Uploads
TIX has an file upload status PartiallyOK for event files that have not been successfully converted to the ttData format. These files are however valid EPCIS documents and are accepted by TIX as "Successful Uploads" when uploaded by TDU. TDU however runs periodical (1 hour) log updates to look for the files that failed the data conversion stage. These partially ok files are removed from the archived folder to the partiallyok folder. The description for the failure of such failures is available on TDU's Upload Log page. After the necessary corrections the file may be moved manually back to the data folder so that it can be re-uploaded by TDU.