CINXE.COM

<!DOCTYPE html> <html lang="en-AU"> <head> <title>Open data portal publishing guide | Queensland Government</title>  <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1"> <meta name="apple-mobile-web-app-capable" content="yes">  <meta name="dcterms.title" content="Open data portal publishing guide "> <meta name="dcterms.creator" content="Open Data"> <meta name="dcterms.created" content="2019-12-05T09:41:01+10:00"> <meta name="dcterms.modified" content="2023-05-08T12:12:04+10:00"> <meta name="dcterms.issued" content="2023-05-08T12:12:04+10:00"> <meta name="dcterms.format" content="HTML"> <meta name="dcterms.identifier" content="https://www.data.qld.gov.au/article/standards-and-guidance/publishing-guides-standards/open-data-portal-publishing-guide">     <meta name="description" content="A process guide showing how to create and update datasets and resources on the data.qld.gov.au CKAN portal." /> <meta name="keywords" content="" /> <meta name="DCTERMS.subject" content="" /> <meta name="DCTERMS.audience" content="all" scheme="AGLSTERMS.agls-audience" /> <meta name="DCTERMS.license" scheme="DCTERMS.URI" content="https://creativecommons.org/licenses/by/4.0/">  <link href="//fonts.googleapis.com/css?family=Lato:100,300,400,700,900,100italic,300italic,400italic,700italic,900italic" rel="stylesheet" type="text/css" />  <link rel="shortcut icon" href="https://www.qld.gov.au/favicon.ico"> <link rel="apple-touch-icon" sizes="180x180" href="https://www.qld.gov.au/favicon.ico"> <link rel="icon" type="image/png" sizes="32x32" href="https://www.qld.gov.au/favicon.ico"> <link rel="icon" type="image/png" sizes="16x16" href="https://www.qld.gov.au/favicon.ico">  <link rel="stylesheet" href="https://www.data.qld.gov.au/__data/assets/css_file_folder/0019/103492/open-data-plugins.min.css?v=0.1.19" /> <link href="/assets/css/main" rel="stylesheet" type="text/css" />  <link rel="stylesheet" type="text/css" href="/assets/css/data-qld">  <script>document.getElementsByTagName('html')[0].className += ' js';</script> <script type="text/javascript" src="/assets/js/jquery"></script>  <link href="https://www.data.qld.gov.au/__data/assets/git_bridge/0019/100846/open-data/dist/qld.css?h=d35263a" rel="stylesheet" /> </head> <body id="qld-gov-au" class="">  <noscript><iframe src="//www.googletagmanager.com/ns.html?id=GTM-PJBVFG" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript> <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src= '//www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','GTM-PJBVFG');</script>  <div class="page-wrapper">  <div id="qg-access" role="navigation" aria-labelledby="landmark-label"> <h2 id="landmark-label" tabindex="0">Skip links and keyboard navigation</h2> <ul> <li><a href="#content">Skip to content</a></li> <li id="access-instructions"><a href="https://www.qld.gov.au/help/keyboard#section-aria-keyboard-navigation">Use tab and cursor keys to move around the page (more information)</a></li> </ul> </div>         <div class="account-masthead"> </div> <header class="navbar navbar-static-top masthead"> <div class="container"> <button data-target="#main-navigation-toggle" data-toggle="collapse" class="btn btn-navbar navbar-toggle collapsed" type="button"> <span class="fa fa-bars"></span> <span class="sr-only">Open/Close Mobile Menu</span> </button> <hgroup class="header-image pull-left"> <a class="logo" href="https://www.qld.gov.au" title="Link to Queensland Gov website"> <img src="https://www.data.qld.gov.au/__data/assets/file/0014/100832/qld-gov-open-data-logo.svg" height="37px" alt="Queensland Government" /> </a> <div class="header__data-portal"> <a href="/">Open Data Portal</a> </div> </hgroup> <div class="navbar-collapse collapse" id="main-navigation-toggle"> <nav class="section navigation"> <ul class="nav nav-pills"><li><a href="/dataset">Data</a></li> <li ><a href="/visualisations">Visualisations</a></li> <li ><a href="/news-and-case-studies">News and Case Studies</a></li> <li ><a href="/article/standards-and-guidance">Standards and guidance</a></li> <li ><a href="/article/contact">Contact</a></li></ul> </nav> <form class="section site-search simple-input" action="/dataset" method="get" autocomplete="off"> <div class="field"> <input id="field-sitewide-search" type="text" name="q" placeholder="Search" aria-label="Search"> <button class="btn-search" type="submit"> <i class="fa fa-search"></i> <span class="sr-only">Submit site search</span> </button> </div> </form> </div> </div> </header>  <div role="main"> <div id="content" class="container"> <div class="toolbar"> <ol class="breadcrumb"> <li class="home"> <a href="https://www.data.qld.gov.au"><i class="fa fa-home"></i><span> Home</span></a> </li> <li > <a href="https://www.data.qld.gov.au/article/standards-and-guidance">Standards and guidance</a> </li><li > <a href="https://www.data.qld.gov.au/article/standards-and-guidance/publishing-guides-standards">Publishing and portal user guides </a> </li><li class="active"> <a class="active" href="https://www.data.qld.gov.au/article/standards-and-guidance/publishing-guides-standards/open-data-portal-publishing-guide">Open data portal publishing guide </a> </li> </ol> </div> <div class="row wrapper"> <div class="primary col-sm-9 col-xs-12"> <article class="module"> <div class="module-content"> <h1>Open data portal publishing guide </h1> <p>Last updated: 8/05/2023</p><h2>Contents</h2><p><a href="#Starting">Starting on data.qld.gov.au </a></p><p><a href="#Training">Training</a></p><p><a href="#Registering">Registering for a publishing account</a></p><p><a href="#Log%20in">Log in</a></p><p><a href="#Adding">Adding a Dataset and Resource/s</a></p><p><a href="#Draft">Draft Datasets</a></p><p><a href="#Groups">Adding a Dataset to a Group or Groups (formerly Categories) </a></p><p><a href="#Update">Update an Existing Dataset </a></p><p><a href="#Markdown">Markdown Formatting </a></p><p><a href="#Appendices">Appendices</a></p><h2 id="Starting">Starting on data.qld.gov.au</h2><h3>Use an optimised browser</h3><p>The Open data portal is optimised for modern browsers. e.g. Google Chrome, Firefox, Opera or Safari.</p><h2 id="Training">Training</h2><p>Publishers should familiarise themselves with the publishing process in the open data portal testing and training environment found here: <a href="https://training.data.qld.gov.au">https://training.data.qld.gov.au.</a></p><p>For publishing access to the open data portal testing and training environment, send an email to <a href="mailto:online@qld.gov.au">online@qld.gov.au</a> requesting a username and password. The publishing instructions in this document are also appropriate for this environment.</p><h2 id="Registering">Registering for a publishing account</h2><p>To create an account as a publisher, go to the <a href="https://www.forgov.qld.gov.au/request-publishing-access-data-and-publications-portals">self-publishing account request form</a> and complete the form. If you are not likely to publish to the Publications portal, please only tick the ‘Data portal’ check box. <strong>Before being granted access to publish, you must have appropriate permission from your organisational entity (Queensland Government Department, Agency or Statutory Body) to publish on their behalf. </strong></p><p>Your account will be set up by default as an Editor*. If you require an Administrator** role, please ensure this request is made through the senior open data representative in your Department or Agency (most agencies and legislative bodies that publish under the stewardship of a Department do not require Administrators).</p><p><strong>* EDITORS</strong> are able to add, edit and delete datasets and resources associated with their organisation.</p><p>** <strong>ADMINISTRATORS</strong> possess the access privileges of Editors and can also manage users within their organisation, update organisation details and manage data requests and comments for their organisation.</p><p><strong> </strong></p><h2 id="Log in">Log in</h2><p>If you already have an account, in the <a href="https://data.qld.gov.au">Open data portal</a>:</p><ol><li>Click <strong>Log in</strong> near the top right corner of the page or go to <a href="https://data.qld.gov.au/user/login">https://data.qld.gov.au/user/login</a>.</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0014/116015/Log-In-2.png" alt="Login 2" style="border:2px solid black" width="857" height="121" /></p><ol><li>In the provided fields, type your Username (not your email address) and Password then click the <strong>Login</strong> button.</li><li>If you have forgotten your username please email <a href="mailto:online@qld.gov.au">online@qld.gov.au</a>.</li></ol><p>Resetting passwords</p><p>If you already have an account but have forgotten your password:</p><ol><li>In the <a href="https://data.qld.gov.au">Open data portal</a>, click <strong>Log in</strong> near the top right corner of the page or go to <a href="https://data.qld.gov.au/user/login">https://data.qld.gov.au/user/login</a>.</li><li>Please use the <strong>Forgot your password?</strong> button on the left of the page, enter your Username then click the <strong>Request Reset</strong> button.</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0015/116016/forgotpassword2.png" alt="forgotpassword2" style="border:2px solid black" width="339" height="361" /></p><p>Passwords should be a minimum of 10 characters in length and contain (at least) one of each of the following: upper case letter, lower case letter, numeral and a symbol such as: @#$%^&.</p><h2 id="Adding">Adding a Dataset and Resource/s</h2><p>A dataset is the overall container which holds a single resource or a group of resources relating to a given topic.</p><p>Fields marked with <font color="red"> a red asterisk (*) </font> are mandatory.</p><ol><li>Log in with an account with publishing privileges</li><li>Click <strong>Data</strong> on the (top menu) to display a list of existing datasets</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0016/116017/databutton.png" alt="databutton " style="border:2px solid black" width="879" height="124" /></p><ol><li>Click <strong>Add Dataset</strong></li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0025/115990/add-dataset2.png" alt="Add Data" style="border:2px solid black" width="848" height="119" /></p><ol start="4"><li>On the first page you’ll be asked to complete fields to describe your data (this information is the metadata). <ul><li><strong>Title:</strong> name of the dataset (this is the short name of the topic relevant to the data to be added).</li><li>Enter a <strong>Description</strong> of your dataset (this is the explanation of the topic or overview of the data to be added)<br />NOTE: You can use <a href="#_Markdown_formatting_1">markdown formatting</a> in your description to link to other websites for more information.</li><li><strong>Tags:</strong> some keywords (or tags) that describe your data. These are key phrases or words to improve searching (e.g. ‘Gaming forms’, ‘Gaming licence application’, ‘Gaming machine application’). This uses <em>type-ahead</em> to suggest tags that have been used previously. Start typing your intended tag and make a selection. To add another tag, start typing again and repeat.</li><li><strong>License:</strong> select a licence from the drop-down menu. Most Queensland Government resources will be ‘Creative Commons Attribution’, but some resources may require a different licence type. For example, technical documents that we need to protect IP will be CC-NC. For descriptions of licence types visit the <a href="http://creativecommons.org.au/learn/licences">Creative Commons</a> website.</li><li><strong>Organisation:</strong> In most cases, this will be filled with your organisation as a default. Most users can only publish to a single organisation although drop-down box is provided to select from multiple choices if relevant.</li><li><strong>Visibility:</strong> whether the dataset will be viewable to all users once complete. The default is private, as such it will only be visible to people from your organisation that are logged into the data portal. <strong>Set it to public if you want anyone to be able to view it.</strong></li><li><strong>Source:</strong> Where the data contained in the dataset is taken or derived from a table or database located at, or accessible from, a web address, insert the URL in this field</li><li><strong>Version:</strong> Enter the version number. For a new dataset, this will generally be ‘1.0’. Where an existing dataset is updated with new data or significant details are changed, it may be appropriate to update this field to a great number in sequence.</li><li><strong>Email: </strong>Enter the publisher’s work email address, or, if appropriate, a group email address. This address is not exposed to public users, however, email notifications sent by the system when user comments/questions relating to this dataset are added, will be directed to the specified email address.</li><li><strong>Security Classification (required</strong>): The assessed security classification of the dataset.</li><li><strong>Used in data driven application: </strong>Where it is known by the publisher or editor that the contents of this dataset will be consumed by an application that relies upon this data, specify ‘Yes’ in this field.</li><li><b> Update Frequency (required): </b> How often the dataset is intended to be updated. e.g.: Daily, Weekly, Never.</li><li><strong>Next update due (conditionally required): </strong>If the update frequency is set to Monthly, Quarterly, Half-yearly or Annually, the Next update due field will appear and will auto populate with a date equal to today's date plus the respective update frequency. A user can modify this date to any future date.  Next update due is not visible or required for other update frequencies. The automatically calculated values have been set to: <ul><li>Monthly = +30 days</li><li>Quarterly = +91 days</li><li>Half-yearly = +182 days</li><li>Yearly = +365 days</li></ul></li></ul><ul><li><strong>Contains de-identified data (required):</strong> Where the published data has been derived from data containing personal information and edited to minimise the risk of re-identification, select 'Yes' from the drop down box.  Where the published data has not been derived from data containing personal information or has not been edited (e.g. publishing personal information is necessary) for de-identification purposes, select 'No' from the drop down box.</li><li><strong>Default Data Schema (if desired):</strong> A default data schema can be specified which will be applied to all new or edited resources in the dataset. A schema can be provided using <strong>Upload</strong> to provide a JSON file containing the schema, using <strong>Link</strong> to link to an external source containing JSON code for the schema or using the <strong>JSON</strong> option and adding the JSON code directly to the text box provided.</li><div><ul role="list"><li data-leveltext="" data-font="Wingdings" data-listid="2" data-list-defn-props="{"335552541":1,"335559684":-2,"335559685":2160,"335559991":360,"469769226":"Wingdings","469769242":[9642],"469777803":"left","469777804":"","469777815":"hybridMultilevel"}" aria-setsize="-1" data-aria-posinset="3" data-aria-level="3" role="listitem">If applied at the Dataset level  all future Resources uploaded will validate against this schema. If  the ‘Contains De-Identified Data’ field is set to YES the uploaded resource does not match the default schema an Error will be produced and the resource will be hidden.</li></ul></div></ul></li><li>Click the <strong>Save</strong> button</li><li>Click <strong>Next: Add Data</strong></li><li>Click <strong>Upload</strong> to select a resource/file from a folder or select <strong>Link</strong> to nominate a URL location of the resource. <ul><li>Add a <strong>Name</strong> for this resource (required).</li><li>In the <strong>Format</strong> field, start typing the file’s extension and select from the dropdown list (format or file type).</li><li>Add a <strong>Description</strong> of your new resource (required).</li><li>If you have uploaded the resource, the <strong>Size</strong> field will then not be visible. For linked resources, add the <strong>Size</strong> of your resource in bytes.</li><li>The default <strong>Resource visible</strong> field 'TRUE' value will generally make the resource publicly visible. See the below field explanation for the exception. If you wish to initially hide the resource from public view, select 'FALSE'.</li><li>The <strong>Re-identification risk governance completed?</strong> field defaults to 'NO'. The selection of a 'YES' or 'NO' value leads to the following behaviour:<strong> </strong><ul><li>Where the dataset metadata field, <strong>Contains de-identified data</strong> has a value of 'NO', selecting a <strong>Re-identification risk governance completed? </strong>value of 'NO' is the appropriate choice. Selecting 'YES' is also acceptable if a re-identification risk minimisation governance process has been completed.</li><li>Where the dataset metadata field, <strong>Contains de-identified data </strong>has a value of 'YES', the resource WILL BE PUBLICLY HIDDEN, irrespective of the <strong>Resource visible</strong> value, unless an acknowledgement is made that a re-identification risk minimisation governance process has been completed. Make this acknowledgement by selecting a <strong>Re-identification risk governance completed?</strong> value of 'YES'.</li></ul></li><li>The <strong>Request Privacy Assessment </strong>field defaults to 'NO' <ul><li>If 'YES' is selected and the dataset <strong>Contains de-identified data</strong> field is also set to 'YES' the resource WILL BE PUBLICLY HIDDEN irrespective of the <strong>Resource visible </strong>value.</li><li>A privacy assessment should only be requested if the <strong>Contains de-identified data </strong>field is set to 'YES'</li></ul></li><li>If desired, add a <strong>Data schema</strong> for this resource.</li><li>Add <strong>Validation</strong> <strong>options</strong> if desired. Follow the link for further information.</li><li>You can add additional files to the dataset by clicking <strong>Save and add another</strong> and repeating the process.</li></ul></li></ol><p><strong> </strong></p><ol start="8"><li>Click the <strong>Finish</strong> button.</li></ol><p><strong><font color="red">Each dataset must be added to at least one Group. Please refer to</font> </strong><a href="#_Adding_a_Dataset_2"><strong>Adding a Dataset to a Group</strong></a><strong>.</strong></p><div><h2 role="heading" aria-level="2" paraid="1541200581" paraeid="{f2f9e1e2-ae6d-4afa-b87d-9ec2cb64e531}{163}">Generating a Data Schema</h2></div><div><p paraid="1816467554" paraeid="{f2f9e1e2-ae6d-4afa-b87d-9ec2cb64e531}{170}">If you do not have a pre-existing data schema you may generate one based on an uploaded Resource</p></div><div><div><ol><li data-leveltext="" data-font="Symbol" data-listid="2" data-list-defn-props="{"335552541":1,"335559684":-2,"335559685":720,"335559991":360,"469769226":"Symbol","469769242":[8226],"469777803":"left","469777804":"","469777815":"hybridMultilevel"}" aria-setsize="-1" data-aria-posinset="1" data-aria-level="1" role="listitem">Navigate to the chosen resource and select <strong>Manage</strong></li><li data-leveltext="" data-font="Symbol" data-listid="2" data-list-defn-props="{"335552541":1,"335559684":-2,"335559685":720,"335559991":360,"469769226":"Symbol","469769242":[8226],"469777803":"left","469777804":"","469777815":"hybridMultilevel"}" aria-setsize="-1" data-aria-posinset="2" data-aria-level="1" role="listitem">Select the <strong>Data Schema </strong>tab from the top of the page</li><li data-leveltext="" data-font="Symbol" data-listid="2" data-list-defn-props="{"335552541":1,"335559684":-2,"335559685":720,"335559991":360,"469769226":"Symbol","469769242":[8226],"469777803":"left","469777804":"","469777815":"hybridMultilevel"}" aria-setsize="-1" data-aria-posinset="3" data-aria-level="1" role="listitem">Select <strong>Generate JSON Data Schema </strong>and the status will change to ‘Pending’. The system will now read the uploaded resource and produce a JSON Data Schema that matches the format of that resource</li><li data-leveltext="" data-font="Symbol" data-listid="2" data-list-defn-props="{"335552541":1,"335559684":-2,"335559685":720,"335559991":360,"469769226":"Symbol","469769242":[8226],"469777803":"left","469777804":"","469777815":"hybridMultilevel"}" aria-setsize="-1" data-aria-posinset="4" data-aria-level="1" role="listitem">After a short wait refresh the page and the status will have changed to ‘Complete’</li><li data-leveltext="" data-font="Symbol" data-listid="2" data-list-defn-props="{"335552541":1,"335559684":-2,"335559685":720,"335559991":360,"469769226":"Symbol","469769242":[8226],"469777803":"left","469777804":"","469777815":"hybridMultilevel"}" aria-setsize="-1" data-aria-posinset="5" data-aria-level="1" role="listitem">Select whether to apply this schema at the Dataset or Resource level</li><li data-leveltext="" data-font="Symbol" data-listid="2" data-list-defn-props="{"335552541":1,"335559684":-2,"335559685":720,"335559991":360,"469769226":"Symbol","469769242":[8226],"469777803":"left","469777804":"","469777815":"hybridMultilevel"}" aria-setsize="-1" data-aria-posinset="5" data-aria-level="1" role="listitem">Click <strong>Apply</strong></li></ol></div></div><h2 id="Draft">Draft Datasets</h2><p>A dataset may be created as a ‘draft’ only with the title appended with ‘[Draft]’. Irrespective of the Visibility selection, the draft dataset will not be discoverable through Search. It can be viewed either through the publisher’s ‘My datasets’ tab or is publicly visible through the use of the specific dataset URL. Draft datasets cannot, normally <font color="red"> (see below*) </font> , have resources attached.</p><h3>To create a draft dataset:</h3><ol><li>Use the normal process for <a href="#_Adding_a_Dataset_1">Adding a dataset</a> (but not the resource/s), completing the process after clicking the <strong>Next: Add data</strong> button</li><li>Upon the display of the Add new resource page, exit out of that page at any time WITHOUT attempting to save the resource.</li></ol><h3>To take the dataset out of [Draft] status:</h3><ol><li>Use the <a href="#_Adding_Additional_Resources">Adding Additional Resources to an Existing Dataset</a> process, and when complete, the [Draft] status will be removed.</li></ol><p><strong><font color="red">* If a resource has been added to a dataset but the [Draft] status remains:</font></strong></p><ol><li>Log in to the account with publishing privileges used to create the [Draft] dataset</li><li>Click on the Dashboard icon at the top right of the page</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0017/116018/dashboard2.png" alt="dashboard2" style="border:2px solid black" width="914" height="146" /></p><ol start="3"><li>Click on the <strong>My datasets</strong> tab</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0018/116019/mydatasets2.png" alt="mydatasets2" style="border:2px solid black" width="538" height="180" /></p><ol start="4"><li>Click to open the relevant dataset with ‘Draft’ appended to the title</li><li>In the dataset page, click on a resource to open the resource page</li><li>In the resource page, click on the <strong>Manage </strong>button</li><li>Click on the <strong>Finish</strong> button at the bottom of the page and ensure the update process is complete (momentarily cycles then displays the Dataset page) before taking other action.</li></ol><h2 id="Groups">Adding a Dataset to a Group or Groups (formerly Categories)</h2><p><u>NOTE: All datasets must be assigned to at least one group</u></p><ol><li>Log in with an account with publishing privileges</li><li>Browse to the relevant dataset and select to display</li><li>Click on the <strong>Groups</strong> tab near the top centre of the page</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0010/116020/groups2.png" alt="Groups2" style="border:2px solid black" width="837" height="88" /></p><ol start="4"><li>Click in the drop-down field and the list of groups will display</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0011/116021/groupsdropdown.png" alt="groupsdropdown" style="border:2px solid black" width="825" height="186" /></p><ol start="5"><li>Scroll if necessary and click on the relevant group</li><li>Click the <strong>Add to group</strong> button (and the selected group will appear under the heading ‘Title’)</li></ol><h2 id="Update">Updating an Existing Dataset</h2><p>Using the steps below you can locate relevant datasets, change metadata and update or add additional resources (files) to the dataset.</p><h3>Locating a Dataset</h3><p>In addition to the search functionality in the home page and data pages, you may be able to locate relevant datasets for the functions contained within this guide, you can also:</p><ol><li>Log in with an account with publishing privileges</li><li>Click on the <strong>Dashboard</strong> button on the top right of the page</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0017/116018/dashboard2.png" alt="dashboard2" style="border:2px solid black" width="914" height="146" /></p><ol start="3"><li>Click on <strong>My Datasets </strong>and select the relevant dataset.</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0018/116019/mydatasets2.png" alt="mydatasets2" style="border:2px solid black" width="538" height="180" /></p><h3>Updating a Dataset’s Metadata</h3><ol><li>Log in with an account with publishing privileges</li><li>Browse to the relevant dataset and select to display</li><li>Click the <strong>Manage</strong> button located near top right of the page</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0009/116001/manage.png" alt="manage" style="border:2px solid black" width="711" height="182" /></p><ol start="4"><li>Edit the metadata associated with a dataset <ul><li>Fields marked with <font color="red"> a red asterisk (*) </font> are mandatory<br /><em>see:</em> <a href="#_Adding_a_Dataset_1">Adding a Dataset and Resource/s (4)</a> <em>for guidance on the metadata fields.</em></li></ul></li><li>Once finished click the <strong>Update Dataset</strong> button at the bottom of the page.</li><li>It is recommended that no existing datasets are deleted although the ability to do so is included should publishers wish to correct an error.</li></ol><h3>Adding Additional Resources to an Existing Dataset</h3><ol><li>Log in with an account with publishing privileges</li><li>Browse to the relevant dataset and select to display</li><li>Click the <strong>Manage</strong> button located on the near top right of the page</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0009/116001/manage.png" alt="manage" style="border:2px solid black" width="711" height="182" /></p><ol start="4"><li>Click the <strong>Resources</strong> link near the top centre of the page</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0010/116002/resources.png" alt="resources " style="border:2px solid black" width="366" height="97" /></p><ol start="5"><li>Click the <strong>+ Add new resource</strong> button</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0011/116003/addnewresource.png" alt="addnewresource" style="border:2px solid black" width="379" height="133" /></p><p style="text-indent:0cm">If you want API access to be automatically generated for your dataset, the data must be in CSV or Excel formats and must comply with the criteria available here: <a href="https://www.data.qld.gov.au/article/standards-and-guidance/publishing-guides-standards/resource-formatting">Resource formatting</a></p><li>Click <strong>Upload</strong> to select a resource/file from a folder or select <strong>Link</strong> to nominate a URL location of the resource. <ul><li>Add a <strong>Name</strong> for this resource (required).</li><li>In the <strong>Format</strong> field, start typing the file’s extension and select from the dropdown list (format).</li><li>Add a <strong>Description</strong> of your new resource (required).</li><li>If you have uploaded the resource, the <strong>Size</strong> field will not then be visible. For linked resources, add the <strong>Size</strong> of your resource in bytes.</li><li>The default <strong>Resource visible</strong> field 'TRUE' value will generally make the resource publicly visible. See the below field explanation for the exception. If you wish to hide the resource from public view, select 'FALSE'.</li><li>The <strong>Re-identification risk governance completed?</strong> field defaults to 'NO'. The selection of a 'YES' or 'NO' value leads to the following behaviour:<strong> </strong><ul><li>Where the dataset metadata field, <strong>Contains de-identified data</strong> has a value of 'NO', selecting a <strong>Re-identification risk governance completed? </strong>value of 'NO' is the appropriate choice. Selecting 'YES' is also acceptable if a re-identification risk minimisation governance process has been completed.</li><li>Where the dataset metadata field, <strong>Contains de-identified data </strong>has a value of 'YES', the resource WILL BE PUBLICLY HIDDEN, irrespective of the <strong>Resource visible</strong> value, unless an acknowledgement is made that a re-identification risk minimisation governance process has been completed. Make this acknowledgement by selecting a <strong>Re-identification risk governance completed?</strong> value of 'YES'.</li></ul></li><li>The <strong>Request Privacy Assessment </strong>field defaults to 'NO' <ul><li>If 'YES' is selected and the dataset <strong>Contains de-identified data</strong> field is also set to 'YES' the resource WILL BE PUBLICLY HIDDEN irrespective of the <strong>Resource visible </strong>value.</li><li>A privacy assessment should only be requested if the <strong>Contains de-identified data </strong>field is set to 'YES'</li></ul></li><li>If a <strong>Default data schema</strong> is applied at the dataset level. A checkbox appears allowing you to align the resource to the default data schema for validation.</li><li>If not aligning to a <strong>Default data schema</strong> you may add a <strong>Data schema</strong> for this resource if desired.</li><li>Add <strong>Validation</strong> <strong>options</strong> if desired. Follow the link for further information.</li></ul></li><li>Click the <strong>Add</strong> button.</li><h3>Updating a Resource in an Existing Dataset</h3><ol><li>Log in with an account with publishing privileges</li><li>Browse to the relevant dataset and select to display</li><li>Select the relevant resource</li><li>Click the <strong>Manage</strong> button located on the near top right of the page</li><li>If the resource is to be changed, click the <strong>Clear </strong>button to remove the current resource URL</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0012/116004/clear.png" alt="clear" style="border:2px solid black" width="703" height="80" /></p><ol start="6"><li>Click <strong>Upload</strong> to select a resource/file from a folder or select <strong>Link</strong> to nominate a URL location of the resource.</li><li><strong>Nature of change to data </strong>will appear if a user uploads a new resource or modifies the URL of a resource and the dataset update frequency is set to  Monthly, Quarterly, Half-yearly or Annually. <ul><li><strong>Adding new time series data</strong> should be selected if a user is updating a resource to include the next period of data in the resource.  e.g. if a dataset has a monthly update frequency and a user is adding November data to a resource that already contains July to October data. <strong>NOTE</strong>: Selecting this option will set the datasets Next update due date to today's date plus the respective update frequency.</li><li><strong>Editing  resource with no new time series data added</strong> should be selected when changes are made to the resource that do not include updating new time series data.  e.g. correcting a mistake in the data, re-formatting the file, adding a column to existing data etc.</li></ul></li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0019/221671/natureofchangetodata.png" data-upload-id="1" style="border:2px solid black" width="703" height="112" /></p><ol start="8"><li>Additional updates can also be made to the following metadata fields:</li></ol><ul><li>Add a <strong>Name</strong> for this resource (required).</li><li>In the <strong>Format</strong> field, start typing the file’s extension and select from the dropdown list (format).</li><li>Add a <strong>Description</strong> of your new resource (required).</li><li>If you have uploaded the resource, the <strong>Size</strong> field will not then be visible. For linked resources, add the <strong>Size</strong> of your resource in bytes.</li><li>Select a <strong>Resource visible</strong> value of 'TRUE' to (generally) make the resource publicly visible. See the below field explanation for the exception. If you wish to hide the resource from public view, select 'FALSE'.</li><li>Select a <strong>Re-identification risk governance completed?</strong> value. The selection of a 'YES' or 'NO' value leads to the following behaviour:<strong> </strong><ul><li>Where the dataset metadata field, <strong>Contains de-identified data</strong> has a value of 'NO', selecting a <strong>Re-identification risk governance completed? </strong>value of 'NO' is the appropriate choice. Selecting 'YES' is also acceptable if a re-identification risk minimisation governance process has been completed.</li><li>Where the dataset metadata field, <strong>Contains de-identified data </strong>has a value of 'YES', the resource WILL BE PUBLICLY HIDDEN, irrespective of the <strong>Resource visible</strong> value, unless an acknowledgement is made that a re-identification risk minimisation governance process has been completed. Make this acknowledgement by selecting a <strong>Re-identification risk governance completed?</strong> value of 'YES'.</li></ul></li><li>The <strong>Request Privacy Assessment </strong>field defaults to 'NO' <ul><li>If 'YES' is selected and the dataset <strong>Contains de-identified data</strong> field is also set to 'YES' the resource WILL BE PUBLICLY HIDDEN irrespective of the <strong>Resource visible </strong>value.</li><li>A privacy assessment should only be requested if the <strong>Contains de-identified data </strong>field is set to 'YES'</li></ul></li><li>If a <strong>Default data schema</strong> is applied at the dataset level. A checkbox appears allowing you to align the resource to the default data schema for validation.</li><li>If not aligning to a <strong>Default data schema</strong> you may add a <strong>Data schema</strong> for this resource if desired.</li><li>If desired, add a <strong>Data schema</strong> for this resource.</li><li>Add <strong>Validation</strong> <strong>options</strong> if desired. Follow the link for further information.</li><p><strong> </strong></p></ul><ol start="9"><li>Click the <strong>Update</strong> <strong>Resource</strong> button.</li></ol><h3 id="reorder">Changing the Order in which Resources are Displayed</h3><ol><li>Log in with an account with publishing privileges</li><li>Browse to the relevant dataset and select to display</li><li>Click the <strong>Manage</strong> button located on the near top right of the page</li><li>Click the <strong>Resources</strong> tab at the top centre of the page</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0010/116002/resources.png" alt="resources " style="border:2px solid black" width="366" height="97" /></p><ol start="5"><li>Click the <strong>Reorder resources</strong> button</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0013/116005/reorder.png" alt="reorder" style="border:2px solid black" width="366" height="129" /></p><ol start="6"><li>Resources can now be reordered by dragging and dropping into a new position</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0014/116006/reorderresources.png" alt="reorderresources" style="border:2px solid black" width="869" height="290" /></p><ol start="7"><li>Once finished click the <strong>Save order</strong> button</li></ol><h3>Deleting Resources from a Dataset</h3><p><em><font color="red">DO NOT USE THIS</font> if you are planning to remove a resource and replace with an updated version. See: </em><a href="#_Updating_a_Resource">Updating a Resource in an Existing Dataset</a><em> above. Updating a resource will mean its unique identifier will not change. </em></p><p>Deleting a resource will mean that it is no longer available for use.</p><ol><li>Log in with an account with publishing privileges</li><li>Browse to the relevant dataset and select to display</li><li>Select the resource that is to be deleted</li><li>Click the <strong>Manage</strong> button located on the near top right of the page</li><li>Click the <strong>Delete</strong> button</li><li>Click the <strong>Confirm</strong> button</li></ol><p>NOTE: Depending on your role, you may not have permission to delete a dataset. In this case, ask your organisation’s Administrator to delete it.</p><h3>Deleting a Dataset</h3><ol><li>Log in with an account with publishing privileges</li><li>Browse to the relevant dataset and select to display</li><li>Click the <strong>Manage</strong> button located on the near top right of the page</li><li>Click the <strong>Delete</strong> button at the bottom of the page</li><li>A pop up window will appear.  Provide a reason, between 10 and 250 characters, for why the dataset is being deleted.</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0016/221731/deletedataset.png" data-upload-id="1" style="border:2px solid black" width="606" height="300" /></p><ol start="6"><li>Click <strong style="border: 0px">confirm </strong>to delete the dataset.</li></ol><p><strong>NOTE:  </strong>A dataset cannot be deleted while the <strong>Used in data driven application</strong> dataset metadata field is set to 'Yes'.</p><h3>Editing the visualisations on a resource page</h3><p>When a <a href="https://www.data.qld.gov.au/article/standards-and-guidance/publishing-guides-standards/resource-formatting">correctly formatted CSV or Excel resource</a> is added to a dataset, the Open Data Portal will automatically upload the contents of the resource to the <a href="https://docs.ckan.org/en/2.9/maintaining/datastore.html">CKAN Datastore</a>.  This enables the resource data to be accessed by <a href="https://docs.ckan.org/en/2.9/maintaining/datastore.html#the-datastore-api">CKAN API</a> functionality and will also display the ’Data Explorer’ visualisation by default on a resource page.</p><p><img src="https://www.data.qld.gov.au/__data/assets/image/0026/138581/Data-Explorer.JPG" alt="Data_Explorer" style="border:2px solid black" width="792" height="700" /></p><p>There are six different types of visualisation available and a publisher can change or add these by managing the resource. To do this:</p><ol><li>Log in with an account with publishing privileges</li><li>Navigate to the relevant resource page and click the <strong>Manage</strong> button.</li><li>Click the <strong>Views</strong> tab from the menu.</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0027/138582/views.JPG" alt="views" style="border:2px solid black" width="765" height="122" /></p><ol start="4"><li>Click the <strong>New view</strong> drop down button.</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0028/138583/Newviews.JPG" alt="new_view" style="border:2px solid black" width="612" height="250" /></p><ol start="5"><li>Select the type of view you want to add.  There are six in total including Data Explorer (the default visualisation), Graph, Grid, Image, Map and Website.</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0029/138584/types.JPG" alt="view_types" style="border:2px solid black" width="280" height="367" /></p><ol start="6"><li>Complete the <strong>Title</strong> field(mandatory), and adjust or use the fields presented which vary depending on the view type selected.</li><li>Click <strong>Preview</strong> to view a preview of the visualisation and <strong>Add</strong> to add the visualisation to the resource page.</li><li>To reorder visualisations, click the <strong>Reorder resource view</strong> button from the <strong>Views</strong> menu.</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0030/138585/reorder.JPG" alt="re-order" style="border:2px solid black" width="803" height="401" /></p><ol start="9"><li>Move the visualisations to the order you require.  The top visualisation will show by default when the resource page is loaded with any additional visualisations shown in tabs.</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0031/138586/tabs.JPG" alt="tabs" style="border:2px solid black" width="798" height="501" /></p><ol start="10"><li>To delete a visualisation, select the visualisation you want to delete from the <strong>Views</strong> page and  click the <strong>Delete</strong> button at the bottom left of the page.</li></ol><p>NOTE: The <strong>Map</strong> view will display when spatial fields such as longitude, latitude or polygon data are within a column or columns in a CSV.  The <strong>Webpage</strong> view is currently restricted to only show data.qld.gov.au pages.</p><h3>Removing a dataset from a Group or Groups (formerly Categories)</h3><p><u>NOTE: All datasets must be assigned to at least one group</u></p><ol><li>Log in with an account with publishing privileges</li><li>Browse to the relevant dataset and select to display</li><li>Click on the <strong>Groups</strong> tab near the top centre of the page</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0010/116020/groups2.png" alt="Groups2" style="border:2px solid black" width="837" height="88" /></p><ol start="4"><li>From the list under the heading ‘Title’, click the <strong>Remove</strong> button on the relevant Group row.</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0015/116007/removegroups.png" alt="removegroups" style="border:2px solid black" width="822" height="351" /></p><h3>Changing the Dataset Visibility as a batch</h3><p>As a publisher, you may choose to make a series of datasets ‘Private’ when setting their Visibility in the metadata. This method allows you to make a group of existing datasets under your organisation Public (or Private) as a batch rather than individually editing the metadata of each dataset.</p><ol><li>Log in with an account with publishing privileges</li><li>Visit your organisation's page by clicking on the dashboard icon on the very top right of the page:</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0017/116018/dashboard2.png" alt="dashboard2" style="border:2px solid black" width="914" height="146" /></p><ol start="3"><li>Click the <strong>My Organisations</strong> tab near the top centre of the page and then select your organisation.</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0016/116008/myorganisations.png" alt="myorganisation" style="border:2px solid black" width="537" height="136" /></p><ol start="4"><li>Click the <strong>Manage</strong> button located near top right of the page</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0009/116010/orgmanage.png" alt="orgmanage" style="border:2px solid black" width="711" height="91" /></p><ol><li>Click the <strong>Dataset</strong> tab located on the top centre of the page</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0010/116011/orgdatasets.png" alt="orgdatasets" style="border:2px solid black" width="344" height="68" /></p><ol start="6"><li>Click in the check boxes alongside the datasets that you wish to change</li><li>Click the <strong>Make public</strong> (or <strong>Make private</strong>) button to apply this action to the selected datasets</li></ol><h3>Updating a dataset after a machinery of government (MOG) change</h3><p>When a machinery of government change takes place, the custodian organisation, dataset and resource metadata may need to be updated to appropriately reflect the change.</p><p>A data custodian should ensure that their datasets belong to the correct organisation on the Open data portal.  If the dataset should be moved to a different organisation, please <a href="https://www.data.qld.gov.au/article/contact/general-open-data-enquiry">contact the Open Data Office team</a> to have this change actioned.</p><p>Small changes (name, email address, description etc.) to a dataset or resource metadata can be made to reflect the machinery of government change.  To do this, follow the steps in the <a href="#_Updating_an_Existing">Updating an Existing Dataset</a> section.</p><p>If the machinery of government change is significant to the point where a small change is inappropriate, the dataset should be modified to reflect that it will no longer be updated.  This may occur when a department is abolished, two departments merge or the name and function of a department changes significantly. To do this:</p><ol><li>Log in with an account with publishing privileges</li><li>Navigate to the relevant dataset page.</li><li>Click the <strong>Manage</strong> button.</li><li>Add a note in the description to identify what has changed and why the dataset will no longer be updated.</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0032/138587/custodian.JPG" alt="custodian" style="border:2px solid black" width="778" height="416" /></p><ol start="5"><li>Change the <strong>Update Frequency</strong> to “Not updated”</li></ol><p><img src="https://www.data.qld.gov.au/__data/assets/image/0033/138588/notupdated.JPG" alt="notupdated " style="border:2px solid black" width="786" height="141" /></p><ol start="6"><li>If a new dataset is required, create one by <a href="#_Adding_a_Dataset_1">Adding a Dataset and Resource/s</a>.</li></ol><h2 id="Markdown">Markdown formatting</h2><p>You use markdown formatting to include links to other web pages in descriptions and to emphasise words. This can be useful if you need to refer people to a web page to explain more than can be covered in a description.</p><h3>Links</h3><p>Put your link text inside square brackets. Put the URL inside regular brackets, following your link text. Follow the link text guidelines in the Link Text and Calls to Action information sheet. For example:</p><p><em><strong>Read the [Queensland road rules](http://real-url-would-go-here.qld.gov.au) for more information.</strong></em></p><p><em><strong>=</strong></em></p><p><em><strong>Read the <u>Queensland road rules</u> for more information.</strong></em></p><p><font color="red">WARNING:</font> Markdown formatting will not appear where the text is displayed in a list. This includes the dataset list. Do not use link text that, if read as normal text without the context of a hyperlink, might cause confusion. For example:</p><p>Description:<br /><strong>This is a dataset that represents something. <font color="blue"><u>Historical data 2012-2017</u></font></strong></p><p><strong>…will display in a list as:</strong></p><p><strong>Here is a dataset that represents something. Historical data 2012-2017</strong></p><p>Without the hyperlink displayed in the list, a user may not select this current data as the description suggests this is historical data. <strong>Choose your link text carefully</strong></p><h3>Italics</h3><p>Place single asterisks on either side of the text to be italicised. For example:</p><p><strong>*Felis catus* sat on the mat.</strong></p><p><strong>=</strong></p><p><strong><em>Felis catus</em> sat on the mat.</strong></p><h3>Bolding</h3><p>Place double asterisks on either side of the text to be bolded. For example:</p><p><strong>You **must** register first.</strong></p><p><strong>=</strong></p><p>You <strong>must </strong>register first.</p><p>Note: The more emphasis you use, the less effect it has. See the <a href="https://www.qld.gov.au/gov/web-writing-and-style-guide">Web writing and style guide</a> for more information.</p><h2 id="Appendices">Appendices</h2><h3>Appendix 1: Data in PDF format</h3><p>PDF is only allowed for an explanatory resource within a dataset, e.g. Queensland Globe has 2 resources: the KML file holding the actual data, and a PDF fact sheet explaining how to use it. In this case, there should also be an accessible version of the PDF (usually an RTF file).</p><p>The actual <strong>data itself should never be contained in a PDF</strong>.</p><p>Alternatively, you can always use the code below to put proper links into descriptions to link to a report that the data was related to.</p><p><strong><em>This is [an example](http://example.com/) inline link in which the link would point to ‘http://example.com/’.</em></strong></p><p>The code above would look like:</p><p><strong><em>This is <u>an example</u> inline link in which the link would point to ‘http://example.com/’</em></strong></p><p>Place the text to be linked inside square brackets, then the URL in regular brackets straight afterwards.</p><p>An annual report should be linked as below.</p><p><strong><em>See the <u>Department of Hurrah 2012 Annual Report</u> for more information about this data.</em></strong></p> </div> </article> </div> <div class="secondary col-sm-3"> <div class="social-aside"> <h2 class="module-heading"><i class="fa fa-share-square-o"></i> Share</h2> <ul> <li> <a href="https://twitter.com/intent/tweet/?text=Open data portal publishing guide &url=https://www.data.qld.gov.au/article/standards-and-guidance/publishing-guides-standards/open-data-portal-publishing-guide" target="_blank" rel="noopener" aria-label="Twitter"> <i class="fa fa-twitter" aria-hidden="true"></i> Twitter </a> </li> <li> <a href="https://facebook.com/sharer/sharer.php?u=https://www.data.qld.gov.au/article/standards-and-guidance/publishing-guides-standards/open-data-portal-publishing-guide" target="_blank" rel="noopener" aria-label="Facebook"> <i class="fa fa-facebook-square" aria-hidden="true"></i> Facebook </a> </li> </ul> </div> </div> </div> </div> </div>  <footer class="site-footer"> <div class="container"> <ul> <li><a href="https://www.qld.gov.au/contact-us" class="no-print">Contact us</a></li> <li class="mobile-hidden"><a href="https://www.qld.gov.au/help" class="no-print">Help</a></li> <li><a href="https://www.qld.gov.au/legal/copyright">Copyright</a></li> <li><a href="https://www.qld.gov.au/legal/disclaimer">Disclaimer</a></li> <li><a href="https://www.qld.gov.au/legal/privacy">Privacy</a></li> <li><a href="https://www.qld.gov.au/about/rights-accountability/right-to-information">Right to information</a></li> <li class="mobile-hidden"><a href="https://www.qld.gov.au/help/accessibility" class="no-print">Accessibility</a></li> <li class="mobile-hidden"><a href="http://www.smartjobs.qld.gov.au/" class="no-print">Jobs in Queensland Government</a></li> <li id="link-languages"><a href="https://www.qld.gov.au/help/languages" class="no-print">Other languages</a></li> </ul> <div class="site-footer__copyright"> <p>© The State of Queensland 1995-2024</p> </div> <div class="site-footer__signoff"> <p><a href="https://www.qld.gov.au">Queensland Government</a></p> </div> </div> </footer> <div class="footer-scripts">  <script src="https://www.data.qld.gov.au/__data/assets/js_file_folder/0018/100890/open-data-plugins.min.js?v=0.2.9"></script> <script src="https://www.data.qld.gov.au/__data/assets/git_bridge/0019/100846/open-data/dist/js/runtime.js?h=d35263a"></script> <script src="https://www.data.qld.gov.au/__data/assets/git_bridge/0019/100846/open-data/dist/js/main.js?h=d35263a"></script> </div>  </div> </body> </html>