Combine two pre-written studies into one
Take two separate studies and combine them into a single one
You might have created two parts of a study using different tools. For example, you coded a survey with labjs and a perceptual experiment with OSWeb. You have two .jzip files from each of these tools, but now you want to combine them into one. Here's how.
Note that this description works for any two halves of a study, coded in whatever way. (But of course, if you were the one writing the scripts instead of using an experiment builder, you'll likely not need this explanation).
Ingredients
To combine two studies into one you'll need:
- A local instance of JATOS. Make sure this is not the one on the server, but the one you run on your own computer. This will give you easy access to move and rename your files.
- Information about where your study assets are: Go to http://localhost:9000/jatos. On the homepage, find the section "Where are my files". (It's big, you can't miss it). Find that folder on your computer.
- The .jzip for the first half of your study.
- The .jzip for the second half of your study.
Note for 3. and 4.: You should not try to generate a .jzip file by hand at this point (although it is possible). A JZIP study archive file is a ZIP archive with a standardized content. They contain information that JATOS needs to understand that something is a study.
Strategy
The idea will be to, first, import one of these halves of a study into your local JATOS instance. Then, add the files from the second half as an additional component to the first half.
Steps
These steps sound complicated, but it's all really simple clicking around and copy-pasting. Basically a JATOS-study-collage.
Imagine you have half-study-1.jzip (a survey) and half-study-2.jzip (a perceptual task).
- Import the half-study-1.jzip into JATOS. You should get one study with a single component.
- Identify the folder in your local computer where these study assets are. (Ingredient 2, described above.)
- Import the half-study-2.jzip into JATOS. You should get one study with a single component.
- Look into the folder you found in Step 2. Navigate to the subfolder that corresponds to half-study-2. You should find a single .html file (this is what actually displays your study) and probably a lot of other assets, including libraries and CSS stylesheets.
- In your local JATOS: Go to the component properties of each of your study halves. Find the field with the path to the HTML file that runs your study. If the name of the HTML files is the same for both halves (it often is index.html), change the names. Now they are called index-half-1.html and index-half-2.html. You can change the names in the component properties. JATOS will change the actual file name on your filesystem for you. (Confirm that you want this when prompted).
- In your local filesystem: Copy all of the contents of this subfolder for half-study-2 into the subfolder for half-study-1. You now combined the information from both studies into a single folder and made sure that the HTML files are uniquely named.
- In your local JATOS: Go to the your half-study-1. Click on "New component". In the properties of this new component, indicate the path to the HTML file from half-study-2. Copy any other properties that might exist (e.g. study input or component input) from the single component in half-study-2 to this new component in half-study-1.
- Now you have a complete, combined study.
- Export this study from your local instance.
- Import the .jzip you created in step 9 into your online JATOS server.
Troubleshooting
Make sure that the study doesn't finish after the first component. In the javascript of the first component you should see something like:
jatos.startNextComponent(myResultDataObject);
and not
jatos.endStudy(myResultDataObject);