.. include:: /includes.rst.txt

.. comments - headings

   # with overline, for parts
   * with overline, for chapters
   = for sections
   - for subsections
   ^ for subsubsections
   " for paragraphs
   * for H5
   + for H6

.. index:: pair: Configuring ; Asset URIs

.. _configuring_asset_uris_target:

Configuring Asset URIs
----------------------

Default Namespace
^^^^^^^^^^^^^^^^^

**Default Namespace** is available under the *Settings* tab.
The default namespace is used to construct URIs (unique identifiers) for the assets in the collection.
The default namespace was set when the collection was created but users with *manager* privileges can edit it at a later time.
Changing the default does not affect any existing asset URIs.

URI Construction Rules
^^^^^^^^^^^^^^^^^^^^^^

**URI Construction Rules** is available under the *Manage* tab.
URI construction rules are first set when a new asset collection is created and this feature allows the user to change those rules.
These override the default EDG-wide construction rules for the URIs for new assets created in the collection.

Changing the rules does not modify any existing asset URIs, they are only applicable to newly created assets.

EDG offers the following options for the local name part of the URI construction:

* *label* – create URIs using the labels of resources

* *counter* – generate and increment a numeric count when a new resource is created and use that in new URIs.
  A *Counter Offset* can be set, to avoid conflicts with existing counter-based URIs for example.

* *uuid* – generates a new standard *universally unique identifier (UUID)* for use in each new URI.

.. note:: Using a UUID guarantees the uniqueness of URIs across the widest scope.

Additionally, users can specify that EDG to pre-pend the class name or class acronym to the local name.
The Class acronym must be stored using edg:acronym property.
All classes in the EDG models already have acronyms.

The user can also use specify here whether users can modify the EDG-generated URIs or not when creating a new asset.