CKAN

Adding a dataset to OpenUp’s CKAN

Step-by-step instructions (see video)

1. Navigate to https://data.openup.org.za/ in your preferred browser.

2. Log in if you are not already logged in.

3. Once you are successfully logged in, click on Datasets at the top of the page.

4. Once the Datasets page loads, click on the Add Dataset button (just above the search bar).

5. Once the Add Dataset page loads, start by providing your dataset with a suitable Title.

6. Next, give your dataset a suitable Description. You can point to external links in this box too, but HTML is stripped out for security reasons.

7. Once you have added a suitable Description to your dataset, add some relevant Tags — these make it easier to search for datasets.

8. Next, select the appropriate licensing for your dataset (License definitions and additional information can be found at opendefinition.org).

9. Since you are adding a dataset to OpenUp’s CKAN, make sure to select OpenUp from the Organization drop-down list.

10. Also be sure to set the dataset’s Visibility to public (unless there is reason to keep the dataset private).

11. Next, add the Source url — this is a link to the original source of the data, not the dataset file you plan to upload.

12. The Version can be left as 1.0, since it is a new dataset being added to CKAN.

13. Under Author, provide your full name.

14. Under Author Email, provide your email address.

15. Under Maintainer, provide your full name (unless someone else is responsible for maintaining this dataset).

16. Under Maintainer Email, provide your email address (unless someone else is responsible for maintaining this dataset).

17. Once you are done, scroll all the way to the bottom of the page and click on the Next: Add Data button (bottom right).

18. Once the Add Data page loads, click on the Upload button.

19. Locate your .csv or .xlsx file, and hit upload. Note that more than one data file can be added to a dataset.

20. Next, give your data file(s) a Name (it will use the file name(s) by default).

21. Next, give your data file(s) a suitable Description. You can also point to external links in this box too, but as before, HTML is stripped out for security reasons.

22. Next, specify the Format of the data file(s) being uploaded (i.e., csv, xlsx, etc.)

23. Once you are complete, click on the Finish button (bottom left).

24. After a few seconds, your dataset and associated data files will load.

25. If you click on Datasets at the top of the page again, your newly created dataset should appear at the top of the list.