Skip to content
Vess Popov edited this page Dec 11, 2020 · 13 revisions

This documentation is OUTDATED. It applies to Concerto releases up to v5.0.beta.7.

There are two places to upload new items:

  1. As a data table within a specific node.
  2. As a data table that can be accessed from anywhere.

The second option is a little more tricky, but it has the advantage that the same item bank can be used across multiple nodes.

(1) Upload items within a specific node

  • Nodes that require item banks will have sections in the wizard to input items. One option is to enter items 'directly.'
  • In this case you can either enter the items by typing in the boxes. Or you can upload items using the 'Upload CSV' button at the top of the page.
  • Watch this video tutorial that explains how to add items from a CSV: Concerto v5 Uploading Items Tutorial
  • Uploading a CSV file will append data to the end of the existing table. In other words, if you want to completely replace your item bank then remove all the rows first and then upload the new items.

(2) Upload items to the 'Data Tables' tab

  • Go to the 'Data Tables' tab.
  • Click on the green 'Add New' button to add a new data table, then give it a name.
  • Once the new data table has been created, click on 'Upload CSV' at the bottom-right
  • 'restructure' means that the table columns and datatypes will be recreated based on the table being uploaded. Normally if you've changing an existing table then you should leave this unchecked. However, if you're uploading items for the first time then click on it.
  • Please note that a column name cannot have spaces.
  • Once you've uploaded your items, in order to use them in a test you need to go to the relevant node wizard
  • Enter the 'Type' of item bank as 'Custom'
  • You then need to map the columns so Concerto knows where to find the required data.
  • If you're not sure what the data should look like, a good rule of thumb is to add some items manually and then download the data table.

Tips

  • If you have trouble uploading items with non-English characters, it's probably because your file isn't using the right encoding (e.g. after saving a .csv file in Excel, if you upload it to Concerto then the non-English characters won't work). Try opening the .csv file in NotePad and then saving it with UTF-8 encoding - the resulting file should upload non-English characters successfully to Concerto.
  • Unless you've changed the default, then Concerto will use MySQL tables to store data. Bear that in mind when you're choosing data types.
Clone this wiki locally