README.md

ckanext-repeating

This extension provides a way to store repeating fields in CKAN datasets, resources, organizations and groups.

Add the repeating plugin to your ckan.plugins configuration settings and use ckanext-scheming or a custom form plugin to use the provided validators to store repeating values in metadata fields.

The easiest way to use repeating fields is with ckanext-scheming. Add ckanext.repeating:presets.json to your scheming.presets configuration settings:

scheming.presets = ckanext.scheming:presets.json
                   ckanext.repeating:presets.json

A repeating field in a scheming schema will look something like:

{
  "field_name": "authors",
  "preset": "repeating_text",
  "label": "Author",
  "form_blanks": 3
}

This new extra field "authors" will appear as multiple fields in the dataset form, with three blank values below existing values. by the form snippet.

When displayed, each value for the text entered will appear separately by the display snippet, eg.:

When the dataset is accessed from the API each value will appear and are updated as items in a list, eg.:

{
  "...": "...",
  "authors": [
    "Person One",
    "Person Two"
  ],
  "...": "..."
}