Submit result data
There are a couple of jatos.js functions that allow you to send data to the JATOS server. The result data can be anything that can be put into text, which includes formats like JSON or CSV. Images, audio or video data can only be sent via Upload (explained below).
The two functions
jatos.appendResultData (available since version 3.1.7) let you submit text data to the server. They are similar to each other. The only difference is that the first overwrites the data and therefore deletes previously sent data, while the latter appends new data to old data.
Then there are a couple of functions that do something else (primarily) but allow you to send result data out of convenience, since they usually go together anyway. These are all functions that start a new component (e.g.
jatos.startComponentByPos) and all functions that end a study (
jatos.endStudyAndRedirect). The latter one exists only since JATOS version 3.5.1 (prior versions can use
Sending data to a server can take some time, depending on the internet connection and the size of the result data. The convenience functions have the advantage that they will execute their primary function (e.g. start next component) only after the result data have been submitted. Therefore these are generally safer ways to submit your result data.
Upload and download result files (Since JATOS version 3.5.1)
If you want to upload audio, video, images or any other data that is not in text format, then uploading a result file is what you need:
And if you want to, in a later component, access the uploaded files again you can download them with
For more real-world examples have a look at the ‘Drawing’ and the ‘Video Recording’ examples.