# CKAN

## Adding a dataset to OpenUp’s CKAN

### Step-by-step instructions (see [video](https://drive.google.com/file/d/1krlWUJO4MqkfGLmmZB5Kg2tsy94dTKFY/view?usp=drive_link))

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.

{% embed url="<https://youtu.be/CtPZFWEsmRI>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://openup.gitbook.io/handbook/tech/ckan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.