Databus Gitbook
Databus
Databus
  • Overview
  • Guides
    • Data Publishing
    • Data Download
  • Use Cases
    • Data Version Control
    • Populating Database with Data
    • Data Quality Control
    • Data Crawling
    • Automated Deployment
    • Building Data Repositories
  • Organising Your Data (Model)
    • How to Organise Your Data
    • URI Design
    • Versioning
    • Metadata
      • Group
      • Artifact
      • Version
      • Distribution
      • Collection
    • Content Variants
    • Persistence (HowTo)
  • Usage
    • Quickstart Examples (Publish, Download)
    • Web Interface
      • Publish
      • Collections
      • Auto-Completion
    • API
    • Databus Mods
    • Databus Client
    • Integration with CI (Jenkins)
  • Running Your Own Databus Server
    • Run with Docker
    • Configuration
    • HTTPS & Proxy Setup
  • Development Environment
Powered by GitBook
On this page
  • Base URI Rule
  • Account URI Rules (foaf:account)
  • Group URI Rules (databus:Group)
  • Artifact URI Rules (databus:Artifact)
  • Version URI Rules (databus:Version)
  • Dataset URI Rules (databus:Dataset)
  • Distribution URI Rules (databus:Part)
  • File URI Rules (databus:file)
  1. Organising Your Data (Model)

URI Design

PreviousHow to Organise Your DataNextVersioning

Last updated 1 year ago

The URIs in your input have to follow a specific pattern in order to be accepted by the API. Make sure that your URIs reflect the hierarchical structure of the Databus. All URI rules are enforced by the SHACL validation using these .

Base URI Rule

  • The Base URI is the URI of the Databus instance (e.g.https://databus.example.org)

Account URI Rules (foaf:account)

  • An account URI has exactly one path segment.

  • The first path segment of ALL URIs has to match the namespace of the publisher (E.g. john)

  • A user namespace (e.g. john) must have at least 4 characters.

An example of valid account URI: https://databus.example.org/john

Group URI Rules (databus:Group)

  • A group URI contains exactly two path segments.

  • The first path segment is the publisher name (i.e. account name), while the second path segment identifis the group.

An example of a valid group URI: https://databus.example.org/john/animals

Artifact URI Rules (databus:Artifact)

  • An artifact URI has exactly three path segments.

  • The first path segment identifiees the publisher, the second segment the group, while the third segment the published artifact.

  • An example of a valid artifact URI:* https://databus.example.org/john/animals/cats

Version URI Rules (databus:Version)

  • A version URI has exactly four path segments.

  • A version URI in addition to the artifact URI includes a segment identifying the version of the specific artifact.

  • An example of a valid version URI:* https://databus.example.org/john/animals/cats/2021-11-11

Note: While the version segment in the example above indicates a date, there is no restriction on the version format, it can be any artbitrary string. The versioning approach is not strict and the publisher can freely choose the way of versioning artifacts.

Dataset URI Rules (databus:Dataset)

  • A dataset URI has exactly four path segments

  • A dataset URI contains the URI of the publisher, group, artifact and its associated version

  • The hash fragment of a dataset URI is the Dataset string

  • An example of a valid dataset URI:* https://databus.example.org/john/animals/cats/2021-11-11#Dataset

Distribution URI Rules (databus:Part)

  • A distribution URI has exactly four path segments.

  • A distribution URI contains the URI of its publisher, group, artifact and its associated version.

  • The hash fragment of a distribution URI is a custom string which identifies the distribution (i.e. the content variant)

  • An example:* https://databus.example.org/john/animals/cats/2021-11-11#lang=en

Note: the content variant of the cats artifact is "lang=en". In this example, there is one specific content variant: lang=en.

File URI Rules (databus:file)

  • A file URI has exactly five path segments identifying a physical file.

  • A file URI provides the download location of the file for the specific artifact (with a specific content variant) which belongs to a particular group published by a particular publisher.

  • An example of a valid file URI:* https://databus.example.org/john/animals/cats/2021-11-11/lang=en.ttl

shapes