Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Publishing dataset files

Step by step for editors: create a dataset page, upload its files as distributions, check the download works for an anonymous visitor, and replace a file with a new version without breaking the address.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/government/open-data/publishing-dataset-files.md

On this page

Publishing dataset files

This page is for editors who publish a dataset and its files. It assumes a dataset class and a catalog folder exist (see "Designing a dataset class"). Downloads in Exponential go through the content/download view, which checks that the visitor may read the object before it sends the file (Files and downloads).

Contents

  1. Before you start
  2. Create the dataset page
  3. Add the files
  4. Check the download as a visitor
  5. Replace a file with a new version
  6. Formats and file names
  7. Problems

Before you start

  • You can create dataset and distribution (or file) objects in the catalog folder. If Create new does not offer them, ask an administrator for the policy (Roles and policies).
  • The file passed the privacy check of your body (see "Privacy checks before publishing data").
  • The license of the dataset is decided (see "Licensing datasets").

Create the dataset page

  1. In Content structure, open the catalog folder.
  2. Under Sub items, press Create new and choose Dataset (or use Create here in the item's menu in the tree).
  3. Fill in the fields: title, description, publisher, contact mailbox, license, dates, update frequency.
  4. Press Send for publishing. With an approval workflow the version waits as pending until a reviewer approves it (Drafts and pending items).

Add the files

  1. Open the new dataset page; under Sub items, press Create new and choose Distribution (or File).
  2. Give a title that names the format and scope, for example "CSV, all years".
  3. Choose the file in the file field and publish.

Several files at once: Media library > Upload files (ezmultiupload) uploads many files into a folder; move them below the dataset afterwards, or upload into the dataset if the role allows it (Media and uploads).

Upload limits come from PHP (upload_max_filesize, post_max_size) and from the maximum size set on the file field in the class. A file that is larger than these limits is refused by the upload.

Check the download as a visitor

  1. Sign out, or open the public site in a private browser window.
  2. Open the dataset page and click each file.
  3. Check that the browser receives the file with the right name, and that the page shows format and size.

If the file answers "access denied" for visitors, the dataset sits in a section the Anonymous role may not read (Sections). That protection is correct for drafts and internal data and wrong for open data; move the catalog to a public section.

Never link the stored file path below var/.../storage/ directly. It bypasses the permission check and changes when the file changes (Files and downloads).

Replace a file with a new version

To publish new data for the same distribution:

  1. Open the distribution and press Edit.
  2. Remove the old file in the file field and choose the new one.
  3. Update the "Last changed" date on the dataset page.
  4. Publish.

The distribution keeps its object ID, so its page address stays the same. The download address contains the object and attribute IDs and the file name; when the new file has a different name, the last part of the download address changes. Link to the distribution page, or keep the file name the same, if re-users bookmark downloads (see "Stable URLs for datasets").

The previous version of the object, with the old file, is kept in the version history until the version limit removes it (Content history).

Formats and file names

ChooseAvoid
CSV in UTF-8 with a header rowSpreadsheets with merged cells and colors as meaning
JSON or XML for nested dataScanned PDF tables
Lower-case file names without spaces: street-lights-2025.csvNames with dates in several formats
One file per logical tableMany tables in one sheet

Problems

SymptomCauseFix
The upload stops without a messagePHP upload limitAsk the administrator to raise upload_max_filesize and post_max_size
The visitor gets "access denied"Section not readable by AnonymousMove the catalog to a public section
The old file still downloadsA cache in front of the siteWait for the cache time or ask the administrator to clear it (Caches)

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x