SN Documentation

Purpose

This page is specifically intended as additional documentation for the SavvyNovice aka. SN app, where you can learn how to create and use your own personalised question sets, and share them with others!
Because the power of the SN app is that freely edited/created question sets can be freely shared/available, which facilitates learning and preparation.
Whether you're preparing for a language exam and want to practice your questions on your mobile, or you're leading a team where you want to share some preparation question sets with team members on a topic, or you want to upload a test set for any reason, the SavvyNovice app makes it easy to do so!

Although on the My Profile page in the "Unleash the power of your App!" section the SavvyNovice app has information symbols    to help you navigate and understand the criteria, you can now find a more transparent overview of requirements below.
For simplicity, the abbreviation QS will be used to refer to the question set.

••

Who

Who and how many?

  • All registered users:
    → can upload a custom QS,
    → can only upload 1 QS at a time,
    → can upload a QS up to 6 times a day.

    If you have a QS uploaded, you can only upload a new one (another one) by deleting the current one.

••

How

Currently there are 2 ways to upload a file, i.e. two file types are allowed:
.xlsx (Excel) or .json (JSON Array).

File Requirements:

fig.1

# Condition Excel JSON
1 file size limit 3 MB 370 KB
2 maximum rows 3000 -
3 must be a JSON array - yes
4 maximum objects in the JSON array - 1000
5 5 predef. columns "question_id", "category", "question", "options", "answer" -
6 4 predef. keys/obj - "category", "question", "options", "answer"
7 at least 2 rows per question yes -
8 "question_id" values as integers yes -
9 "question_id" values as consecutive numbers yes -
10 same "category" and "question" value for each question yes -
11 "category" and "question" values as strings - yes
12 "options" and "answer" values as arrays, containing strings - yes
13 "options" array must contain at least 2 elements - yes
14 "answer" array must contain at least 1 element - yes
15 all "answer" array elements must be in "options" array - yes
16 "category" length 50 50
17 "question" length 700 700
18 "options" length in total 1000 1000
It's worth downloading one of the samples, personalizing it and upload it back.
Download Excel Sample
Download JSON Sample

Details for fig.1

  • #1 Maximum file size in case of .xlsx is limited to 3 MB and in case of .json to 370 KB.

    #2 If you choose to upload an excel file, the maximum number of rows is limited to 3000.

    #3 If you choose to upload a .json file, it must be a JSON array.

    #4 The JSON array can contain up to 1000 elements.

    #5 If you decide to upload an .xlsx file, make sure that your excel file has exactly 5 columns: "question_id", "category", "question", "options", "answer".

    #6 If you decide to upload an .json file, Each JSON array's object must contain these keys: "category", "question", "options", "answer". No other key is allowed.

    #7 In case of excel: each question should consist of at least two rows, i.e. it should contain at least two possible answers.

    #8 In case of excel: the "question_id" column should be an integer, i.e. you can only use numeric characters, not letters, or special characters.

    #9 In case of excel: the values in the "question_id" column must be consecutive, i.e. the number of "question_id"s must increase by one per question.
    Hint: since the "question_id" is the number of the question, it is recommended to start with 1.

    #10 In case of excel: The more answer options you want to offer for a given question, the more rows will belong to that question in your excel,
    so it is important that the "question_id" values within a given question are the same, the "category" values are the same, and the "question" cell value is also the same for each row in that question.

    #11 In case of JSON: The values of "category" and "question" should be strings.

    #12 In case of JSON: The values of the "options" and "answer" keys should be arrays of strings.

    #13 In case of JSON: Array "options" should consist of at least 2 elements.

    #14 In case of JSON: Array "answer" should consist of at least 1 element.

    #15 In case of JSON: All elements in the "answer" array must be in the "options" array, too.

    #16 Excel and JSON: The maximum length of a "category" is 50 characters.

    #17 Excel and JSON: The maximum length of a "question" is limited to 700 characters.

    #18 Excel and JSON: The maximum length of the "options" (with all it's "options" included per question) is limited to 1000 characters.

••

Usage

Share Your Key

  • Once you've successfully uploaded your file, a key will be generated to your QS and you can share it.
    If your friends and colleagues know the key, they can download your QS for free in the SavvyNovice app and can start practicing! 🤩
    Remember, your QS will be available for 24 hours, after which - or if you delete the uploaded QS in the meantime - it will no longer be possible to download it.
    Once you've uploaded your QS, you can easy-peasy download and use it on the SavvyNovice app is. 😎

Demo




Home