/
Import a contest

Import a contest

Before starting the importing process, you must know which data file you are using. The contest importer only accepts .json files, and you can either create your own file (using our example files as a starting point) or you can use the candidates file from the Candidacy system - read more on that process in the section Import a Candidacy file.

  1. Go to the “Contests” tab on the left-hand menu.

  2. Click “Import.”

Screenshot 2024-08-02 at 15.11.46.png
Screenshot 2024-08-02 at 15.12.57.png

  1. Click Screenshot 2024-08-02 at 15.13.18.png to open a new contest importer.

Screenshot 2024-08-02 at 15.13.35.png

  1. Click “Choose file.” Select the following example .json file: (you may also use this file as a starting point for your own). Alternatively, refer to the section on creating a contest importer file to create your own file for use in the contest importer.

  2. Once you select the file, its data string will appear in the overview box, as shown below:

Screenshot 2024-08-02 at 15.29.58.png

  1. Click Screenshot 2024-08-02 at 15.15.25.png.

Screenshot 2024-08-02 at 15.30.38.png

  1. You now need to map all of the data in the file. Start by mapping each ballot one at a time. You can do this by clicking on “Ballot A” to the left or under “Contest data” to the right:

Screenshot 2024-08-02 at 15.31.51.png

  1. Do the mappings as follows:

 

Screenshot 2024-08-02 at 15.53.04.png
Screenshot 2024-08-02 at 15.54.40.png

  1. ClickScreenshot 2024-08-02 at 15.59.28.png and repeat the previous steps for the remaining ballots. Please note that contest mappings can only be done before importing!

  2. Once all of your contest data has been mapped, you are now ready to import.

Screenshot 2024-08-02 at 16.00.14.png

  1. Click “Import”at the bottom of your screen, after which a progress bar will show how far along the import is. Once the import is complete, the system will show a green “Data successfully imported!” message.

Screenshot 2024-08-02 at 16.01.24.png
Screenshot 2024-08-02 at 16.01.39.png

  1. Return to the “Contests” tab to see all of your imported contests

Screenshot 2024-08-02 at 16.02.29.png

NOTE! Remember to configure each contest’s advanced settings to set up the voting rules. Read more on these settings here: Contest Advanced settings & Create a contest.

 

  1. Click “Choose file.” Select the following example .json file: (you may also use this file as a starting point for your own contest importer). Alternatively, refer to the section on creating a contest importer file to learn how to create your own file.

  2. Once you select the file, its data string will appear in the overview box, as shown below:

Screenshot 2024-08-02 at 16.07.22.png

  1. Click Screenshot 2024-08-02 at 15.15.25.png.

Screenshot 2024-08-02 at 16.08.04.png

  1. You now need to map all of the data in the file. Start by mapping one ballot at a time. You can do this by clicking on “Contest Name” to the left or under “Contest data” to the right:

Screenshot 2024-08-02 at 16.08.42.png

  1. Complete the mapping in the below manner:

 

Screenshot 2024-08-02 at 16.09.39.png

 

  1. Under “Contest options,” you will see “Parties” and “Profiles.”

Screenshot 2024-08-02 at 16.10.07.png

  1. Start by clicking on “Parties.” The following items you will map correspond to those that are included in the .json file.

    1. Under “Title,” select “name” from the dropdown menu, if it isn’t already selected.

    2. Under “Description,” select “description” from the dropdown menu, if it isn’t already selected.

    3. Skip “Image.”

    4. Under “Url,” select “url” from the dropdown menu, if it isn’t already selected.

    5. Skip “Reference.”

    6. Skip “Exclusive,” “Selectable,” “Randomize children,” and “Accent color.” To read more about these options, go to the section entitled “Contest options mapping.”

Screenshot 2024-08-02 at 16.10.20.png
Screenshot 2024-08-02 at 16.15.49.png

  1. Now click on “Profiles.” The following items you will map also correspond to those which are included in the .json file.

    1. Under “Title,” select “name” from the dropdown menu, if it isn’t already selected.

    2. Under “Description,” select “description” from the dropdown menu, if it isn’t already selected.

    3. Under “Image,” select “image” from the dropdown menu, if it isn’t already selected.

    4. Under “Url,” select “url” from the dropdown menu, if it isn’t already selected.

    5. Under “Reference,” select “reference” from the dropdown menu if it isn’t already selected.

    6. Skip “Exclusive,” “Selectable,” “Randomize children,” and “Accent color.”

Screenshot 2024-08-02 at 16.10.35.png
Screenshot 2024-08-02 at 16.17.35.png

  1. ClickScreenshot 2024-08-02 at 15.59.28.png . Please note that contest mappings can only be done before importing!

  2. Once all contest data has been mapped, you are now ready to import.

Screenshot 2024-08-02 at 16.00.14.png

  1. Click “Import” at the bottom of your screen and a progress bar will indicate how far along the import is. Once the import is complete, the system will show a green “Data successfully imported!” message.

Screenshot 2024-08-02 at 16.19.22.png

  1. Return to the “Contests” tab to see all of your imported contests.

Screenshot 2024-08-02 at 16.20.02.png

NOTE! Remember to configure each contest’s advanced settings to setup the voting rules. Read more on these settings here: Contest Advanced settings & Create a contest.

If you choose to upload a Candidacy file, you need to connect the election to the specific Candidacy event. You can do this by doing the following:

  1. Go to the “Configuration” tab on the election event.

  2. Under “Candidacy,” click on the “Candidacy” item.

Screenshot 2024-08-08 at 15.41.16.png

  1. Select the specific Candidacy event (whose data was previously exported) which you wish to import into the contest importer.

Screenshot 2024-08-08 at 15.41.27.png

You are now ready to import. Follow these instructions:

  1. Go to “Contests” tab from the left-hand menu.

  2. Click “Import.”

Screenshot 2024-08-02 at 15.11.46.png
Screenshot 2024-08-02 at 15.12.57.png

  1. Click Screenshot 2024-08-02 at 15.13.18.png and a new contest importer will open

Screenshot 2024-08-02 at 15.13.35.png

Below, you can see the different steps to import a contest file extracted from Candidacy.

  1. Click “Choose file.” Select the following example .json file: . Alternatively, read how to download your own file here.

  2. Once you select the file, its data string will appear in the overview box, as shown below:

Screenshot 2024-08-19 at 09.08.05.png

 

  1. Click Screenshot 2024-08-02 at 15.15.25.png.

Screenshot 2024-08-19 at 09.08.28.png

  1. You now need to map all of the data in the file. In this case, there is only one contest in the file. Start by mapping it. You can do this by clicking on “Pre Election 2024” or under “Contest data,” as shown below:

Screenshot 2024-08-19 at 09.08.50.png