# Welcome to the Aristotle Metadata Knowledge Base

<figure><img src="/files/YFfBiYAEkqRIgcx9yy2C" alt=""><figcaption></figcaption></figure>

Welcome to the Aristotle Metadata knowledge base where you can find all the information you need to manage your metadata better using the Aristotle Metadata Registry.

If you are not sure where to begin, start from our top topics below or use the search bar in the top right of the window to search for topic and help.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Getting started</td><td><a href="/pages/ONF03ETvckKP1SBOsH6z">/pages/ONF03ETvckKP1SBOsH6z</a></td></tr><tr><td>Search and discovery</td><td><a href="/pages/xSPR96Vs4GUTBFnDfWUt">/pages/xSPR96Vs4GUTBFnDfWUt</a></td></tr><tr><td>Creating and editing metadata</td><td><a href="/pages/WXNUXXvhF4rMM4TmmtTI">/pages/WXNUXXvhF4rMM4TmmtTI</a></td></tr><tr><td>Managing your Registry using Admin tools</td><td><a href="/pages/miWGNQITJPVDjW4zxhPh">/pages/miWGNQITJPVDjW4zxhPh</a></td></tr><tr><td>Collaborating with Aristotle Metadata</td><td><a href="/pages/VwdackECjmrMqoMYm1CF">/pages/VwdackECjmrMqoMYm1CF</a></td></tr><tr><td>Personalising your experience</td><td><a href="/pages/d00kpyf8sSqY5VthmIzU">/pages/d00kpyf8sSqY5VthmIzU</a></td></tr></tbody></table>

Join us on the Aristotle Metadata Community! Is there something you can't find or would you like to ask a question? The Aristotle Community is the place for you, join the Aristotle Metadata team along with other users to engage with the growing community. Visit or join the Community today <https://community.aristotlemetadata.com/>.


# Finding and Viewing Metadata


# Search

The Aristotle Metadata Registry is equipped with search functions that allow all users to search for:

* Metadata items
* Data
* Help
* References
* Issues
* Discussions
* Inventories
* Harvested items

### Search Functions

The Aristotle Metadata Registry supports the following search functions:

* Omnisearch
* Advanced search
* Filters


# Using omnisearch to find registry content

Omnisearch can be used from any page of the registry save the homepage and the advanced search page to quickly locate content. Omnisearch makes use of an array of filters and links to maximise the ease and speed with which a user can find their content.

### Prerequisites

The omnisearch can only be used by users who are signed in to the Aristotle Metadata Registry. If you are not signed in, the search bar in the registry header will not display any filters or links.

### How to use omnisearch to find registry content

1. Navigate to any page of the registry that is not the homepage or the advanced search page, and select the omnisearch from the registry header.

<figure><img src="/files/nidofBPh6jQkSmhVMmDb" alt=""><figcaption></figcaption></figure>

**Notes:**&#x20;

* If you are accessing omnisearch from a Stewardship Organization's page, the search will automatically filter to only show content from that Stewardship Organization
* Pressing Alt+Q will select the omnisearch whenever it is available.

2. **If you wish to access recent or popular content**, browse the following sections as desired:
   * 'Recently viewed metadata'
   * 'Recent issues'
   * 'Recent reviews'
   * 'Search History'
   * 'Popular'.

<figure><img src="/files/Q3UfZcVTMD7aNHQLY0UI" alt=""><figcaption></figcaption></figure>

**Note:** If you type in the search field, these panels will change. When accessing recent or popular content, do not type in the search field.

3. **If you wish to access more specific content**, type a relevant search term into the search field, then adjust the left dropdown panel's filters as desired.

<figure><img src="/files/YQSk5BqoS2EyOH8ohPhZ" alt=""><figcaption></figcaption></figure>

**Notes:**

* The 'Category' filters are defined as follows:
  * 'All': Searches for content from all categories
  * 'Issues & Discussion': Searches for issues and discussion posts
  * 'Data': Searches for:
    * Datasets
    * Data catalogues
    * Distributions
  * 'Help': Searches for:
    * Concept help pages: Help pages relating to concepts outlined in ISO 11179
    * Standard help pages. Help pages relating to other functions of the Aristotle Metadata Registry
  * Metadata: Searches for:
    * Data elements
    * Data element concepts
    * Properties
    * Distributions
    * Value domains
    * Object classes
    * Data sets
    * Data types
    * Glossary items
    * Data set specifications
  * References: Searches for:
    * Collections
    * Reference documents
    * Reference folders
    * Pages
* 'Clear Filters' can be selected to revert all filters back to default (unfiltered).

4. Results will be displayed in the right dropdown panel. **If your desired result has appeared, select it from here.**

<figure><img src="/files/J7Dlzc3gVhqMUeaHtN9Q" alt=""><figcaption></figcaption></figure>

5. **If you wish to continue searching**, you can either select the magnifying glass on the right of the search field to search for your entered term(s) **without filters**, or you can select 'See More Results' to move your results **with the relevant filters applied** to the [advanced search](/finding-and-viewing-metadata/search/using-advanced-search-filters-to-find-registry-content) page.

<figure><img src="/files/g9Db8dZKSBbKAsIzEOT5" alt=""><figcaption></figcaption></figure>

**Note:** The omnisearch does not offer spelling suggestions until after a user has searched. If you are unsure how to spell the content you are searching for, be sure to press search to see results, rather than rely solely on the results dropdown panel.


# Using advanced search filters to find registry content

The advanced search page provides registry users with the ability to filter, refine and sort search results more precisely than what is possible with the omnisearch alone.

### How to use advanced search filters to find registry content <a href="#how_to_search_for_content_in_the_registry" id="how_to_search_for_content_in_the_registry"></a>

1. Access the advanced search page by searching for anything in the homepage search bar, or via the omnisearch's magnifying glass (non-filtered search).

<figure><img src="/files/8rpQFtgAE47urB8cwsrD" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/CO9a3rD2pLRSpf7vQNWL" alt=""><figcaption></figcaption></figure>

2. Select the filter menu (which reads 'All' by default) and adjust the search filters as desired. Only content that matches the type chosen as your search filter will appear in the relevant search results.

<figure><img src="/files/686EibXYhHn7N253VQiW" alt=""><figcaption></figcaption></figure>

**Note:** The 'Type' filters are defined as follows:

* 'All': Searches for content of all types
* 'Issues & Discussion': Searches for issues and discussion posts
* 'Data': Searches for:
  * Datasets
  * Data catalogues
  * Distributions
* 'Help': Searches for:
  * Concept help pages: Help pages relating to concepts outlined in ISO 11179
  * Standard help pages. Help pages relating to other functions of the Aristotle Metadata Registry
* Metadata: Searches for:
  * Data elements
  * Data element concepts
  * Properties
  * Distributions
  * Value domains
  * Object classes
  * Data sets
  * Data types
  * Glossary items
  * Data set specifications
* References: Searches for:
  * Collections
  * Reference documents
  * Reference folders
  * Pages.

3. Select 'Item type' and adjust the item type filters as desired. Only metadata items of the chosen types will appear in the relevant search results.

<figure><img src="/files/43ONAjp6O7zUAwBI3f4H" alt=""><figcaption></figcaption></figure>

4. Select 'Status' and adjust the status filters as desired. Only content of the selected statuses will appear in the relevant search results.

<figure><img src="/files/L171G8dR3VL2ENtK2nms" alt=""><figcaption></figcaption></figure>

5. Select 'Registration Authority' and adjust the Registration Authority filters as desired. Only content from the selected Registration Authorities will appear in the relevant search results.

<figure><img src="/files/2cPq17r5p1qkdoARkLf9" alt=""><figcaption></figcaption></figure>

6. Select 'Updated', then select the desired update recency of content you wish to appear in search results.

<figure><img src="/files/dP1Rc89YjTrohDVdJj0h" alt=""><figcaption></figcaption></figure>

7. Select 'Created', then select the desired creation recency of content you wish to appear in search results.

<figure><img src="/files/NOyYj1DUfFP8aCMJaLQs" alt=""><figcaption></figcaption></figure>

8. Select 'Sort by...', then select the sorting method to be used by the search results.

<figure><img src="/files/tSNZ889NhxQO1OsDbTkL" alt=""><figcaption></figcaption></figure>

**Note:** Sorting by 'Relevance' will sort search result content based on the frequency with which search terms appear within the content.

9. Select 'Search' once you are ready to search.

<figure><img src="/files/3eopi7YbP1P9h96QoLUL" alt=""><figcaption></figcaption></figure>

10. **If you wish to refine your search results**, select a relevant descriptor from the 'Refine your results' field.

<figure><img src="/files/rXvFRkibMGZ9YGgGjSNx" alt=""><figcaption></figcaption></figure>

**Notes:**

* The number of registry items currently matching the relevant descriptor (based on current filters) is listed alongside it.
* For additional advanced search functionality, see [Advanced Search: Help](/finding-and-viewing-metadata/search/using-advanced-search-filters-to-find-registry-content/advanced-search-help).


# Advanced Search: Help

The following page contains additional, more technical functionalities of the advanced help page.

### Restricting search

When searching, the "indexed text" refers to everything crawled by the search engine. This always includes names, definitions, version and comments. Some items will also include additional text from associated items. For example, Data Elements include the text from its related Data Element Concept and Value Domain.

![](https://cdn.aristotle.ninja/aristotle_mdr/help/search_filters.png)

#### Search titles only

Selecting this option restricts Aristotle to only search for items with titles or names. This option is available for all searchable objects, including metadata types, pages, collections, documents, discussions and issues.

#### Only show public items

When logged in, selecting this option limits search results to only those items that are publicly visible to all users, including those without an account. This option is only shown to logged-in users as non-logged in users only have right to view to public content.

#### Only show items in my workgroups

When searching select this box to limit results to only those items that are within a workgroup a user belongs. This option is only shown to logged-in users.

#### Smart spellcheck and filter removal

When searching Aristotle-MDR performs spellchecks against search terms, and if there is a low number of results will recommend an alternate search term.\
Along with this, if a search returns zero results, Aristotle-MDR will remove any filters such as item type or date restrictions to automatically broaden the search corpus.\
Any time the search is changed, such as spelling correction or filter removal, a notification will appear under the search bar to let users know.

#### Default Search

When searching without selecting an item type or category, the search engine searches across everything in the registry.

### Keyword search shortcuts

When searching there are a few advanced options available to make searching easier. These can be entered into any search box using the keyword:search\_term format.

#### Narrow search results using tokens

Certain tokens and field names, such as name, or version, can be used to limit results when searching. These will force the search engine to only return results where terms appear in those fields.

Sample queries are shown below:

<table><thead><tr><th width="239">Token</th><th>Description</th><th>Sample Query</th></tr></thead><tbody><tr><td><code>status:argument</code></td><td><p>Filters items to those that have the given registered state. This can only be used for items which can be registered.<br>Possible values:</p><ul><li><code>incomplete</code> (or <code>inc</code>),</li><li><code>candidate</code> (or <code>can</code>),</li><li><code>recorded</code> (or <code>rec</code>),</li><li><code>qualified</code> (or <code>qual</code>),</li><li><code>standard</code> (or <code>st</code>),</li><li><code>preferred</code> (or <code>pref</code>)<br>(short for Preferred Standard),</li><li><code>superseded</code> (or <code>sup</code>), or</li><li><code>retired</code> (or <code>retired</code>)</li></ul></td><td><code>status:st</code> Returns all items in the 'standard' registration state</td></tr><tr><td><code>id:argument</code> or <code>identifier:argument</code></td><td>Filters items that have an additional namespaced identifiers.</td><td><ul><li><code>id:123485</code> Returns all items that have an extra Identifier of "123485", with any version number</li><li><code>id:my_org/123485</code> Returns all items that have an extra Identifier of "123485" in the namespace "my_org", with any version number</li><li><code>id:my_org/123485/2.0.1</code> Returns the item that has the extra Identifier of "123485" in the namespace "my_org", with the version number "2.0.1"</li></ul></td></tr><tr><td><code>name:argument</code></td><td>Filters items where the given argument is in the name field of the object.</td><td><code>name:Person</code> Returns items with "Person" in the name</td></tr><tr><td><code>namespace:argument</code></td><td>Filters items that have an additional namespaced identifiers with the specified namespace.</td><td><code>Person namespace:my_org</code><br>Returns items where Person appears anywhere in the indexed text, and also has a namespace of "my_org"</td></tr><tr><td><code>type:argument</code></td><td>Filters items to be of the given item type. This can be any metadata type, help page, or other indexed content.</td><td><code>type:property</code> Returns 'property' metadata items</td></tr><tr><td><code>version:argument</code></td><td>Filters items where the given argument is in the version field of the object.<br>Note: Because of the nature of the search engine, version queries need to be at least 3 characters long.</td><td><code>Person version:1.0.0</code><br>Returns items where Person appears anywhere in the indexed text, and also has a version of "1.0.0"</td></tr><tr><td><code>uuid:argument</code></td><td>Filters items where the given argument is in the UUID field of the object.</td><td><p><code>uuid:beb4a870-8c40-11eb-ac36-0242ac150007</code> </p><p>Returns items that have an identifier of "UUID - beb4a870-8c40-11eb-ac36-0242ac150007"</p></td></tr><tr><td><code>tc:argument</code></td><td>Filters datasets and distributions which have temporal coverage within the bounded limits. Dates must be in iso format YYYY-MM-DD...YYYY-MM-DD. Dates can be uncomplete.</td><td><p><code>tc:2020-06-11...2021</code></p><p>Returns items which have temporal coverage with the dates from 2020-06-11 to 2021-01-01</p></td></tr><tr><td><code>bb:argument</code></td><td>Filters datasets and distributions which have spatial coverage within the bounding box. Bounding box must be in the format ('minimum_longitude','minimum_latitude', 'maximum_longitude', 'maximum_latitude')</td><td><code>bb:-180,-90,180,90</code> Returns all items which have a bounding box within these bounds. This query will return every dataset and distribution which has a spatial coverage because these are the latitudinal and longitudinal limits.</td></tr></tbody></table>

#### Restrict item types using the type keyword

When searching, you can enter a type along with the name of the object type to further restrict your search. The type must not include spaces, which should be removed, or replaced with underscores or hyphens. For an even shorter query, type names can be abbreviated to the first letter of each word in the type name.

This is the same as selecting options in the Item Type dropdown on the search page.

Sample queries are shown below:

<table><thead><tr><th width="317">Query</th><th>Result</th></tr></thead><tbody><tr><td><code>Age type:property</code></td><td>Returns <em>only properties</em> with "Age" in the text</td></tr><tr><td><code>Person type:objectclass</code></td><td>Returns <em>only Object Classes</em> with "Person" in the text</td></tr><tr><td><code>Person type:object_class</code></td><td>Returns <em>only Object Classes</em> with "Person" in the text</td></tr><tr><td><code>Person type:oc</code></td><td>Abbreviated way to return <em>only Object Classes</em> with "Person" in the text</td></tr><tr><td><code>Person Age type:dec</code></td><td>Abbreviated way to return <em>only Data Element Concepts</em> with "Person" and "Age" in the text</td></tr><tr><td><code>Person Age type:dec type:de</code></td><td>Abbreviated way to return <em>Data Element Concepts <strong>or</strong> Data Elements</em> with "Person" and "Age" in the text</td></tr></tbody></table>

**Keyword queries can be used together to create complex queries.**&#x46;or example, this query - `Person Age name:Person type:dec version:1.2.3` - searches for items that meet the following criteria:

* `Person Age` - "Person" or "Age" in the indexed text
* `name:Person` - "Person" appearing in the name
* `type:dec` - Are of the type Data Element Concept
* `version:1.2.3` - Have a version of "1.2.3"


# Browsing the registry

### How to Browse for content in the Registry <a href="#how_to_browse_for_content_in_the_registry" id="how_to_browse_for_content_in_the_registry"></a>

From your Dashboard, select 'Browse' in the Header bar.

<figure><img src="/files/eHpu4DT8GTlOvT8uLrbr" alt=""><figcaption></figcaption></figure>

What you can Browse in the Registry -

<figure><img src="/files/uuLYUX7vifFJF5G8chdT" alt=""><figcaption></figcaption></figure>

Metadata

<figure><img src="/files/WdHQMemLuURxJwxLGhfD" alt=""><figcaption></figcaption></figure>

You can browse all the different types of Metadata content in the Registry that you have permission to view.

<figure><img src="/files/zSZjiIJRdRLe924EFfpj" alt=""><figcaption></figcaption></figure>

Registration Authorities

<figure><img src="/files/OZKfXtuXFITe2eWAN26I" alt=""><figcaption></figcaption></figure>

You can browse all the Registration Authorities within the Registry that you have permission to view.

<figure><img src="/files/iZtT6xwXaiLohlbqz3KU" alt=""><figcaption></figcaption></figure>

Stewardship Organisations

<figure><img src="/files/X2eubsSNVodzWaXRsWER" alt=""><figcaption></figcaption></figure>

You can browse all the Stewardship Organisations within the Registry that you have permission to view.

<figure><img src="/files/Ln3J4V2DJkkg6h3wawbN" alt=""><figcaption></figcaption></figure>

Help pages

<figure><img src="/files/mBgrk9gKTi2FTEdvuaGa" alt=""><figcaption></figcaption></figure>

You can browse all the Help pages within the Registry.

<figure><img src="/files/3i5HkE1icTS7MD1Vy3be" alt=""><figcaption></figcaption></figure>

Pages

<figure><img src="/files/ovQGEoUWG5GS086YkZp2" alt=""><figcaption></figcaption></figure>

You can browse and view Pages available in the Registry.


# Item page breakdown

## What are the components of an item page? <a href="#what_are_the_components_of_an_item_page" id="what_are_the_components_of_an_item_page"></a>

This is a basic item page for a Data Element Concept. The item pages will change depending on how much content has been put into the item, and what type of item is being viewed.

<figure><img src="/files/cNtpGWmNOfZODiTBZybF" alt=""><figcaption></figcaption></figure>

Item pages are broken up into different sections: the main content area, the 'info box', and the 'actions bar'.

* The main content area is where you can view any issues associated with the item, the item history, graphs for the item, the components of the item, the relationships, and the related content.

<figure><img src="/files/LVORfWaxwFri1ylsjz5f" alt=""><figcaption></figcaption></figure>

* The 'info box' is where you can see what the type of metadata the item is, the unique identifier that is assigned to this specific item, any endorsements, when it was last updated and by whom, when the item was created, if it has any supersedes and if it has been superseded by anything.
* Some content in the 'info box' may not be visible to some users, depending on the users permissions.

<figure><img src="/files/ge93IGLfMTzzRarW7QwC" alt=""><figcaption></figcaption></figure>

* The 'actions bar' is where you can favourite the item, publish the item, perform different actions depending on your permissions, and download the content.

<figure><img src="/files/m67jNm9272MwRW2Wqsgx" alt=""><figcaption></figcaption></figure>


# Searching for Alternate Names in the Search Bar

Alternate names can be created for all types of metadata items. Adding an alternate name to an item allows you to refer to a metadata item with a different name. If the alternate name is searched in the search bar in the Aristotle Metadata Registry, the search will display the metadata item in the search results.

Follow the steps below to create alternate name types and enable searching for them:

1. Go to the Stewardship Organisation Homepage you want to create an alternative name type in.

<figure><img src="/files/Wk9sJnP0mThfNVvbWBEt" alt=""><figcaption></figcaption></figure>

2\. Go to ![](https://help.aristotlemetadata.com/~gitbook/image?url=https%3A%2F%2Fdesk.zoho.com.au%2FgalleryDocuments%2Fedbsn0a832dc2d8b6188337f853cafc29d547e821546c3810160743bf3a69e7b729b2c7a335156264b0c4af3557c6e25e267bb0f865081cec92111f879706055d0be0%3Finline%3Dtrue\&width=300\&dpr=4\&quality=100\&sign=5b870e6fbd68ac2b484a5581c3be70a28ee2f3e91de9a019c965d800ab25c86e) and select 'Alternative Name Type'.

<figure><img src="/files/rmOyUB1qvr1ADzz9GkKn" alt=""><figcaption></figcaption></figure>

3\. Select ![](https://help.aristotlemetadata.com/~gitbook/image?url=https%3A%2F%2Fdesk.zoho.com.au%2FgalleryDocuments%2Fedbsn0a832dc2d8b6188337f853cafc29d547f96d10820cfd770eaa6e0dd11b46c622384a533646a3b7e854232ef053aeeb7e4ab44b818ef1ef6782fb026de3a15c39%3Finline%3Dtrue\&width=300\&dpr=4\&quality=100\&sign=b16cd76e24660a70ffd1b4e9af007aa3e5bbe530a41fe1c4407523fa02848d0b) and enter all the required fields.

<figure><img src="/files/zZ1RzbVo0sO91ph3IPBy" alt=""><figcaption></figcaption></figure>

Ensure to select 'Included in the search index' in the 'Search Index' option, as highlighted in the screenshot above.

4. Click 'Save' once you have filled in the details.
5. Now, you can add alternate names to any metadata item under this particular stewardship organisation.<br>

Refer to this page to learn ['How to add alternative names to a metadata item'](https://help.aristotlemetadata.com/creating-and-editing/how-to-add-alternative-names-to-a-metadata-item).

Once you have added the alternative names, you can search for them in the search bar, and the search will display the metadata item that has the alternate name you searched for.


# Viewing related items and graphs

### Related items <a href="#related_items" id="related_items"></a>

From an items page, you are able to view items that are related to the selected item. \
\
To view related items

1\. Go to an item page

<figure><img src="/files/z62K4LyHAVs4bOME5AYu" alt=""><figcaption></figcaption></figure>

2\. Select the<img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7w1f6fda05d98146f5ae6100ad3472a25a" alt="" data-size="line">tab

3\. From here you can view the items that are related to the selected item

<figure><img src="/files/MMkYzXdqhTeEoWK3fmw7" alt=""><figcaption></figcaption></figure>

### Graphs <a href="#graphs" id="graphs"></a>

From an items page you are able to view different graphs for the selected item.

To view graphs

1. Go to an item page

   <figure><img src="/files/e2wVlWs3ULk3PA5yF2lf" alt=""><figcaption></figcaption></figure>

2\. Select the<img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7waf1bf9bacfd74be68060ac0258e0363d" alt="" data-size="line">tab

3\. From here you can view different graphs for the selected item

* <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7wcf6f31ad03b749ddb7993f0aaa06f2d8" alt="" data-size="line"> - will show you the general relationships&#x20;

<figure><img src="/files/GyroDM5K0iv6Ok9Sd9CR" alt=""><figcaption></figcaption></figure>

* <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7w9c4bdb415f1b4e928b14a6f6578abc9a" alt="" data-size="line"> - will show you any supersedes&#x20;

  <figure><img src="/files/t1aiElBLKCOQySS2jCs1" alt=""><figcaption></figcaption></figure>

  * <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7w60826fb9bd9c4965971dc05e67848d03" alt="" data-size="line"> - will show you if the item is linked to other items

    <figure><img src="/files/4VFCLxmEiTu4SYfENoAe" alt=""><figcaption></figcaption></figure>


# Compare different versions of a metadata item

From an item page, you have the ability to compare historical versions of content. \
\
To compare different versions of an item<br>

> 1\. Go to the items page

<figure><img src="/files/KFYVeIb1IVc5CDGUdEXp" alt=""><figcaption></figcaption></figure>

> 2\. Select the <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7w2d1a7031dbf342129ab0f1f39c0b3c2d" alt="" data-size="line"> tab <br>

> 3\. From here, you can compare any of the versions listed

<figure><img src="/files/2yTfFQGuFfBZDZDLLUj5" alt=""><figcaption></figcaption></figure>

4\. Select what you would like to compare

<figure><img src="/files/tATT7mB3RQVl01Jt8Ooi" alt=""><figcaption></figcaption></figure>

then click the![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=qdj7wf78c76ef1688442aafcc03cb1a233b36)button

5\. The two items selected will be compared and you can view the differences between the two

<figure><img src="/files/mZZemn734wky5DtcQMlQ" alt=""><figcaption></figcaption></figure>

> You may also be able to see a side by side comparison for certain fields, if you see the clickable "![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=qdj7wdcfd3499177e42a0be9558a282c16778)" icon next to the field name.<br>

> In the example above, the "Definition" field has the clickable icon next to it, and you can view the differences between the two versions for that field:

<figure><img src="/files/TGqT7a3yggIfiK63hJHe" alt=""><figcaption></figcaption></figure>


# Bulk actions

On pages where you can view lists of metadata items, you may also see the "Bulk Actions" button at the bottom of the page.

<figure><img src="/files/EsBpGGhkk5kTFJ8wG15p" alt=""><figcaption></figcaption></figure>

Some notable places where you can perform Bulk Actions include: Your Sandbox, Favourites and Tags & the Search results pages.&#x20;

<figure><img src="/files/bK6Kgw3lMrlEdD7TuPJi" alt=""><figcaption></figcaption></figure>

### What can I do with Bulk Actions?  <a href="#what_can_i_do_with_bulk_actions" id="what_can_i_do_with_bulk_actions"></a>

Performing bulk actions means just that, it allows you to select multiple items and perform different actions on them.

An example from a search results page:

<figure><img src="/files/o42ET2dAeoVmwpRuK88j" alt=""><figcaption></figcaption></figure>

You will notice a little tick box in the upper left hand corner of each search result. <br>

<figure><img src="/files/nGXm9tZjGWJv0oueDvau" alt=""><figcaption></figcaption></figure>

You can also select this box to select all the search items.

<figure><img src="/files/llqmQHk68WJPcdqyEHoW" alt=""><figcaption></figcaption></figure>

Ticking those boxes will add them to the items you are performing the bulk actions on.

<figure><img src="/files/SXaGMIQA0uDeTVH2wraw" alt=""><figcaption></figcaption></figure>

The different Bulk Actions you can perform:<br>

* <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7w252b4dfd43c5446cbb674bd04653c216" alt="" data-size="line"> - This will add the selected items to your Favourites. You will know an item has been Favourited if you see a "![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=qdj7weab1c1b1b1c14a0e85337d672d254130)" under the item type in the results.  <br>
* <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7w5a83d36de68f4824ad3e546e47dfc040" alt="" data-size="line"> - This will remove the selected items from your Favourites.<br>
* <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7w26f7cddfa8de4006a918ab2e6ec56b6d" alt="" data-size="line"> - This lets you download the selected items into a single package.<br>
* <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7w2f169301feb9486faa4c33bc890b1e2d" alt="" data-size="line"> - This lets you create a review request for the selected items.
* <img src="/files/WjRgsQrCCf6hFEyAPz2p" alt="" data-size="line"> - This lets you add the selected items in an existing review.

<mark style="background-color:orange;">The Bulk Actions below can only be performed by Administrators of the system.</mark>

* <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7wba8bf0a6de144373b43762a27964766c" alt="" data-size="line"> - This allows you to change the Registration Status for the selected items.<br>
* <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7w53154317e7dc438d888f75b4e1a2d404" alt="" data-size="line"> - This allows you to move the selected items to a different Workgroup.&#x20;
* <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7w2eaf1bb91efe4a27aecbeafab2543106" alt="" data-size="line"> - This allows you change the Stewardship Organisation for the selected items.&#x20;
* <img src="/files/37CjtZTRtOvGMaRo2vOF" alt="" data-size="original"> - This allows you to move items between the collections you have permission to manage.
* <img src="/files/HCzISjGRIiXfsyg67alH" alt="" data-size="original"> - This allows you to link/unlink items to a selected Metadata Item Template. It's important to remember that you should have access to edit the items you want to link to an item template, and ensure you are linking the metadata items to the correct metadata type item template. For example, a dataset can only be linked to a dataset item template.


# Downloading Content

Within the Registry, there are many places where you can download content, a few notable places include: from a search page, browsing content, an individual item page and from your Sandbox.

### Bulk downloading content <a href="#bulk_downloading_content" id="bulk_downloading_content"></a>

You can bulk download content from several locations, including browsing content pages and from your Sandbox.\
\
To bulk download content <br>

> 1\. Select the items you would like to bulk download.

<figure><img src="/files/nUIWrcRt92aMTnruo410" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/QIvoFGIjuHhefsmx0xif" alt=""><figcaption></figcaption></figure>

2\. From the "Bulk Actions" button, at the bottom of the page, select "Bulk download".

<figure><img src="/files/s2KHyJedbgyzQNJaojq1" alt=""><figcaption></figcaption></figure>

3\. On this form, you will be able to add or remove items from the bulk download, if required. You can also select the type of download format you would like.

<figure><img src="/files/NQK288m7i73TntHtap6q" alt=""><figcaption></figcaption></figure>

Once done, select "Download"&#x20;

![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=qdj7w8a0612f13ddf40838503ee826436b440)

4\. Download Options

&#x20;From here you can personalise the downloads, add a Title for the download, select a cover page or a back page. None of this is required to download the content.

<figure><img src="/files/ZtwyDNLhIAmm5hcSb76e" alt=""><figcaption></figcaption></figure>

Once done, select "Download"

![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=qdj7wf62d12aa6f7d419cb2ccd82ae9f57066)

5\. Your content will now be downloaded. Once ready, a link will appear and will take you to a new tab with your download ready. If you've selected to email a copy to yourself, it will now be available to view in your email inbox for 24 hours.

<figure><img src="/files/RJsHjr37n8UFdbR7Azcf" alt=""><figcaption></figcaption></figure>

### Single item download <a href="#single_item_download" id="single_item_download"></a>

From an item page you have the ability to download the item content.\
\
To download a single item

> 1\. From the item page select the Download dropdown and the type of download you would like.&#x20;

<figure><img src="/files/4cClkD4VbLCYOoY0zRMY" alt=""><figcaption></figcaption></figure>

From Download Options page, you can personalise the downloads, add a Title for the download, select a front page or a back page. None of this is required to download the content.

Once done, select "Download"<br>

![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=qdj7w7f8d765dbfe34ed0b1fc34fbb57eb0d3)

3\. Your content will now be downloaded. Once ready, a link will appear and will take you to a new tab with your download ready. If you've selected to email a copy to yourself, it will now be available to view in your email inbox for 24 hours.

<figure><img src="/files/HE28yj6EX6l06IrtO0mD" alt=""><figcaption></figcaption></figure>


# Generating an API token

### How to generate an API token

1. Select My Profile from the registry header dropdown.

<figure><img src="/files/NxKU2fbtoyOLUxFdXRVH" alt=""><figcaption></figcaption></figure>

2. Select API Token Management.

<figure><img src="/files/tjxQoCBdAr5ZMW40NJlY" alt=""><figcaption></figcaption></figure>

3. Select Generate New Token.

<figure><img src="/files/zypl1RSZHJ3nmcqB8vo5" alt=""><figcaption></figcaption></figure>

3. Adjust the Name and Expiry date fields as desired.

<figure><img src="/files/qSte1g1qKEvXdgtPv9Vt" alt=""><figcaption></figcaption></figure>

3. Adjust the permissions to read and write as desired.

<figure><img src="/files/niXjDNte10DgCqHpV9GI" alt=""><figcaption></figcaption></figure>

3. Select Create Token.

<figure><img src="/files/U7jY0QS5KjxzfnxlDwqS" alt=""><figcaption></figcaption></figure>

6. Your API key will be generated, along with instructions on how to use it, and examples. Save it somewhere, as it will not reappear if you go back or close the web page.

<figure><img src="/files/hwakvDRL8Qx1l34WPEOB" alt=""><figcaption></figcaption></figure>


# Personalisation


# Navigation Choices on 'My Dashboard'

On the 'My Dashboard' page, Aristotle Metadata Registry offers users a variety of options and features to enhance their experience and productivity within the Aristotle Registry.&#x20;

Click on your name in the header of the registry to go to 'My dashboard'.

<figure><img src="/files/BnBHdPTN0oc6smBglPVZ" alt=""><figcaption></figcaption></figure>

This is what the 'My Dashboard' page looks like. See below:

<figure><img src="/files/nFhGcW5Pn9lo3myL6xrg" alt=""><figcaption></figcaption></figure>

Let's discuss the options in the left-side navigation bar on the 'My Dashboard' page. These features are:

* **My Profile:** is a personalised space for users to manage and showcase their information, manage notifications, and to generate API tokens.

<figure><img src="/files/fKjHj08vF6xm4LFm2g1Z" alt=""><figcaption></figcaption></figure>

* **Create Metadata**: Allows users to create metadata.

<figure><img src="/files/Jsev2qDM4whaCERZ7TZb" alt=""><figcaption></figcaption></figure>

* **Favourites and Tags**: Enables users to mark and categorise their preferred or important items for easy access.

<figure><img src="/files/WAVf1AwXmu45biIqqPbd" alt=""><figcaption></figcaption></figure>

* **Notifications**: We can see notifications on this page to stay updated with relevant information, alerts, or messages.

<figure><img src="/files/MAHXra4OVP9KLTFlA10A" alt=""><figcaption></figcaption></figure>

* **Organisations**: Displays a list of stewardship organisations that you have access to or are a part of.

<figure><img src="/files/Z5L7pY7pkz6OszJGr8Nj" alt=""><figcaption></figcaption></figure>

* **Workgroups**: Facilitates collaboration by allowing users to form or join specific workgroups, and you can see the list of workgroups here that you have access to.

<figure><img src="/files/apzfCWfMGFPOdIa58Z1o" alt=""><figcaption></figcaption></figure>

* **Discussions**: Provides a platform for users to engage in conversations and exchange ideas or information. You can see any existing discussions here and you can create new discussions by clicking on the ‘New Discussion’ button.

<figure><img src="/files/6fxjkoPsKS9oxiIGUAAt" alt=""><figcaption></figcaption></figure>

* **Issues**: Helps users track and address any problems or challenges they encounter. We can see all the issues here that we have access to.

<figure><img src="/files/KAcOtv6yn9KcvLtdTZaI" alt=""><figcaption></figcaption></figure>

* **My Sandbox**: Offers a dedicated space for users to create content that is private to them. You can move this content to a workgroup or stewardship organisation if you want to share your content with other registry users.

<figure><img src="/files/3UuWdM7525z42ciLqEbM" alt=""><figcaption></figcaption></figure>

* **Review Requests**: Allows us to request feedback or reviews from others on our work or content.

<figure><img src="/files/5etYuUlzyDrwtwjjTSUX" alt=""><figcaption></figcaption></figure>

* **Toolbox**: Provides a collection of useful tools or resources to aid users in their tasks or projects.

<figure><img src="/files/uDkA4tQJe6JVh9wcWx6f" alt=""><figcaption></figcaption></figure>


# Managing your account

Your Profile is where you can go to manage your account.

To get to your profile select 'My Profile' from your Dashboard side panel or from the dropdown in the Header bar.

<figure><img src="/files/RClOQ6nlSyqh6pIpLlBd" alt=""><figcaption></figcaption></figure>

From your Profile page you can:

* Edit your personal information - such as your display name, profile picture, email address, and default content language.

<figure><img src="/files/Du96WdhBkcJTZz8YpVtP" alt=""><figcaption></figcaption></figure>

* View the Organisations you belong to.

<figure><img src="/files/mfH0NDZLR98Be4CocQuq" alt=""><figcaption></figcaption></figure>

* View any active sessions, you can even log out from here by clicking on the 'End Session'.

<figure><img src="/files/Cbtmarjrb4fCSkU0jKgi" alt=""><figcaption></figcaption></figure>

The Actions you can do from your Profile:

<figure><img src="/files/gJ0LqkIk14nbPbEMy53N" alt=""><figcaption></figcaption></figure>

* From 'Edit Profile', you can edit your account details such as your Display Name, upload a Profile Picture, and select the default Content Language.

<figure><img src="/files/ZZaruTQiDgHeQlRWO0ef" alt=""><figcaption></figcaption></figure>

* From 'Change Password', you can change your password.

<figure><img src="/files/cfuxJRAcgulGu5n8fheT" alt=""><figcaption></figcaption></figure>

* From 'View History', you can view your recently viewed metadata. From here you can clear your history by selecting the ![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=17qfd42cdef9237d648beaf1be64265990b7a) button. This will clear all the history on this page. To delete individual items from your history, select the ![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=17qfd413cc4f97828497aa2abd1674f7b297a) next to the item.&#x20;

<figure><img src="/files/PDlplJwL8X359L9gWBOy" alt=""><figcaption></figcaption></figure>

* From 'View Recent Actions', you can view your recent actions.

<figure><img src="/files/Niotu0fkF7vJc6PB83aE" alt=""><figcaption></figcaption></figure>

* From 'View my Roles', you can view your Roles - This will show you all your Roles within the different groups in the Registry.

<figure><img src="/files/yO30iBbLu7kRwgReLMFU" alt=""><figcaption></figcaption></figure>

* From 'Notification Permissions', you can view/edit your notification permissions - This will let you change your notification permissions, letting you choose which notifications to receive in the registry. You can also choose to send notifications to your email.

<figure><img src="/files/g5HgdVx1lm4I1Dje1XqT" alt=""><figcaption></figcaption></figure>

* From 'API Token Management', you can manage your API Tokens.

<figure><img src="/files/2e01lOMyZ8PfhL8jXhZ6" alt=""><figcaption></figcaption></figure>

* From 'Multi-factor Authentication', you can enable or disable Multi-factor Authentication. You can also generate and view your Backup Codes.

<figure><img src="/files/tcrQZT85b1Z7UvlMVMWB" alt=""><figcaption></figcaption></figure>


# How to reset your password

The password reset feature enables the Aristotle Users to reset or change the password of their account in the Registry.

### How to Reset or Change Password

1. Go to the login page.

   <figure><img src="/files/bkZQRqQ2YyWLEQnWCCLq" alt=""><figcaption></figcaption></figure>

If you are on your home page of the registry, click on <img src="/files/xipaa9G1VLXXsFyfx3GE" alt="" data-size="line"> from Task Bar to go to the login page.

<figure><img src="/files/E3SlblC5uhE3izkDriO5" alt=""><figcaption></figcaption></figure>

2\. Click on "Forgotten your Password?" to reset your password.

<figure><img src="/files/FlHMJ05WiMjZu5vL5IQ8" alt=""><figcaption></figcaption></figure>

3\. You will be navigated to new page where you can enter the email address associated with your Registry account.&#x20;

<figure><img src="/files/oFXQ6yWXjwkkb2vuZHxe" alt=""><figcaption></figcaption></figure>

Enter the email address and click on "Send instructions".

<figure><img src="/files/5JTxlGevzPReTkieikv2" alt=""><figcaption></figcaption></figure>

&#x20;The reset instructions have been sent to your email address you have submitted.&#x20;

<figure><img src="/files/AwcqcvnrASeiTSrGaeRa" alt=""><figcaption></figcaption></figure>

4\. Go to your email inbox, click on the password reset link to set a new password.

<figure><img src="/files/QNiesG66CDXwjH2mofzg" alt=""><figcaption></figcaption></figure>

Once you click the link, you will be navigated to the Registry's Password Reset page.&#x20;

<figure><img src="/files/YQqT3B3butvwmGnxhesW" alt=""><figcaption></figcaption></figure>

5\. Set a new password and click on "Change my password".

<figure><img src="/files/jdPv6DsNXGQRlFnfeyhi" alt=""><figcaption></figcaption></figure>

6\. Once your password is reset you must login with the new password to access your account.&#x20;


# Invite/Reset Password Link Is expired

### Email Server Protection software automatically expired the link 

Many users are facing issues trying to log in to the platform after receiving the invitation to join the Registry. They get the message “Account Couldn’t be Activated”.  This issue is arising due to certain Browsers, such as Outlook and Outlook Online. These browsers have certain features such as “Link preview” that automatically opens all the links received in the email. &#x20;

When the link is sent by Aristotle Metadata Registry for a new user to sign up, it is designed to verify the email address that was provided is valid and monitored by the user. This link is one time only and is used to verify the user.&#x20;

When the activation link is opened by the email server, this link is activated automatically, and the user will see the message showing that the link has expired.&#x20;

This can be a potential solution to the problem:&#x20;

**Note: Account is Showing activated on manager portal**

#### Solution 1:&#x20;

* As account is showing activated on manager site, user can login using the password set at activation.&#x20;
* Alternatively, the user can reset their password as normal by clicking “Forgot Password”. &#x20;

If the account is showing Deactivated on manager portal&#x20;

#### Solution 2: &#x20;

* Invitation email will be sent to person to join the Registry.&#x20;

  <figure><img src="/files/Z4AwnY1RWjC71uDhv2Pg" alt=""><figcaption></figcaption></figure>
* Copy the link to the internet Browser rather than clicking the link.&#x20;

  &#x20;

  <figure><img src="/files/nwkjXKbgldHxxvBF773C" alt=""><figcaption></figcaption></figure>

#### Known software that can cause the password link to expire:&#x20;

* McAfee feature 'Link Protect'&#x20;
* Mimecast Anti-spoofing software&#x20;
* Covenant Eyes - Internet Filtering&#x20;
* Outlook all versions (corrupted rules)&#x20;


# How to set up multi factor authentication

## How to Setup Multi-Factor Authentication (MFA) in Aristotle <a href="#how_to_setup_multi-factor_authentication_mfa_in_aristotle" id="how_to_setup_multi-factor_authentication_mfa_in_aristotle"></a>

### What is Multi-Factor Authentication (MFA)? <a href="#what_is_multi-factor_authentication_mfa" id="what_is_multi-factor_authentication_mfa"></a>

Multi-factor verification helps you to access your accounts more securely. As passwords can be stolen or compromised, multi-factor verification adds additional layers of verification that help protect your accounts by making it harder for other people to login to your accounts. Based on research by Microsoft, it reduces your risk of account compromise by over 99.9%.&#x20;

Aristotle MDR currently only supports authentication via a time-based code generated by an authentication app on a user’s phone. This is a 6-digit numeric code that changes every 30 seconds. To learn more about authentication apps, follow this [link](https://www.cyber.gov.au/acsc/view-all-content/advice/multi-factor-authentication) from the Australian Cyber Security Centre.

### How to Setup MFA <a href="#how_to_setup_mfa" id="how_to_setup_mfa"></a>

1. Go to your user profile, from either the Dashboard side panel or the dropdown from the header bar.

   <figure><img src="/files/OeuovGuIt2SRX6AvWccI" alt=""><figcaption></figcaption></figure>

2\. On the action tab of your profile, click on the ‘Multi-factor authentication’ link of the Action tab.

<figure><img src="/files/RvKIsLc2tAZ683IDzDcd" alt=""><figcaption></figcaption></figure>

3\. If you don’t have multi factor authentication enabled, your Multi-factor Authentication Settings page will look like this:

<figure><img src="/files/9Xdqm3WIzmFVkp4ugvhc" alt=""><figcaption></figcaption></figure>

4\. Start the ‘Enable two-factor authentication’ wizard by Clicking on "Next".

<figure><img src="/files/EjNWLM3TSV1VzyOmX5ey" alt=""><figcaption></figcaption></figure>

5\. Use your authentication device to generate a token by scanning the QR Code.

<figure><img src="/files/JrsRNbOXYNoF6YBSuYrR" alt=""><figcaption></figcaption></figure>

6\. Enter the token generated by your authenticator application and select 'Next'. Below is an example token.

<figure><img src="/files/53rqjqLVFP9H3qxCuhgX" alt=""><figcaption></figcaption></figure>

7\. Click on the ‘Back to Account Security’ button to confirm that multi-factor has been enabled.

<figure><img src="/files/csMfPgpVN6bZE043mUbV" alt=""><figcaption></figcaption></figure>

Make sure you also generate recovery codes once you have setup your device. If you lose access to your device, recovery codes will allow you to access your account. To access your recovery codes, click on the ‘Show Codes’ button. Make sure you keep these codes in a safe location.

<figure><img src="/files/92JPGttfuGQvCUmBFLqm" alt=""><figcaption></figcaption></figure>

### How to Change a MFA Device  <a href="#how_to_change_a_mfa_device" id="how_to_change_a_mfa_device"></a>

If you want to swap your MFA device, you must first disable your current MFA authentication, before adding a new device.&#x20;

1. Go to your profile, and click on 'Multi-factor authentication’ to go to your two-factor security page.

   <figure><img src="/files/RvKIsLc2tAZ683IDzDcd" alt=""><figcaption></figcaption></figure>

2\. Click on 'Disable Multi-Factor Authentication'.

<figure><img src="/files/7VZm8Z5qJgKlH6XMHONZ" alt=""><figcaption></figcaption></figure>

3\. Disable multi-factor authentication by confirming that you want to disable.

<figure><img src="/files/Sg8BbvGGKztfHWweeJHy" alt=""><figcaption></figcaption></figure>

4\. Follow the "**How to setup MFA in Aristotle"** tutorial above to setup multi-factor authentication again with your new device

### **What happens if I lose my MFA device?** <a href="#what_happens_if_i_lose_my_mfa_device" id="what_happens_if_i_lose_my_mfa_device"></a>

If you lose your device, and have access to your recovery codes, simply enter a recovery code during the second factor of the login.

1. Click on the 'Use Backup Token' button and enter your backup token there.

<figure><img src="/files/wHJBvnwHlyjNhS0YV4bV" alt=""><figcaption></figcaption></figure>

If you lose your MFA device and you don’t have access to your backup codes, you need to get in contact with an Administrator for your registry, who can disable your multi-factor authentication.

### **How to disable MFA for another user in Aristotle** <a href="#how_to_disable_mfa_for_another_user_in_aristotle" id="how_to_disable_mfa_for_another_user_in_aristotle"></a>

{% hint style="info" %} <mark style="background-color:orange;">In order to disable MFA for another user, you must be a registry Administrator.</mark>
{% endhint %}

1. From the Dashboard side panel select 'Administrator Tools'.

   <figure><img src="/files/qAiSnx63CKyBdqkLBFDB" alt=""><figcaption></figcaption></figure>

2\. Select 'Manage Users' under the Manage Registry heading.

<figure><img src="/files/1Sm8Eocz0euBRPJCHWTl" alt=""><figcaption></figcaption></figure>

3\. Find the user that you are trying to disable in the table, here we are going to disable the MFA for Lauren.

<figure><img src="/files/FfeNIfis846b71DwXmjG" alt=""><figcaption></figcaption></figure>

4\. Click on the user’s name to go to their profile. Here, we can see from their profile that multi-factor authentication is enabled.

<figure><img src="/files/smM5FPruQmJoqA6sZsxl" alt=""><figcaption></figcaption></figure>

5\. Click on the ‘Multi-factor authentication’ link in the Actions tab.

<figure><img src="/files/wDnMy2TvUjnn4E5Hl58p" alt=""><figcaption></figcaption></figure>

6\. Confirm that you want to disable two-factor authentication for that user.

<figure><img src="/files/JAVtjaC870ZbvGh6utXz" alt=""><figcaption></figcaption></figure>


# Roles in the registry

## Roles in the Registry  <a href="#roles_in_the_registry" id="roles_in_the_registry"></a>

There are many users of the metadata registry, and all of them have different roles when it comes to maintaining the relevance and quality of metadata in the registry.<br>

### Workgroup

*What is a Workgroup?*

It’s a team within the Metadata Registry that brings together stewards and submitters into a workspace where they can collaborate on the production of metadata for a certain purpose.

Below is a list of members in the Workgroup, every person listed on this page can view content in the Workgroup. Additional permissions are listed with each group. Permissions only apply to specific Workgroups, so a user may be a manager in one group but an editor in another. All members of a Workgroup can participate in the Workgroup's Discussion posts.

**NOTE:** Permissions are hierarchical.

* **Viewer** - These are read-only users. They are people or groups of people who can view the metadata, and can contribute to discussions, but they can’t edit content. Viewers can see the metadata before it is published, so they may be proof-readers, stakeholders of the metadata, or people who are required to provide feedback on the metadata.

  > A viewer could be a doctor or health staff who is monitoring a new metadata standard and are collecting data about a newly identified disease.

* **Submitter** - This is someone who can create metadata within the registry. They submit content to a Workgroup where it can be reviewed by stewards. These people are trained to understand the requirements for good quality metadata and work closely with stakeholders to transfer requirements into metadata.

  > A submitter could be a health researcher who understands the field of research and works to document it

* **Steward** - These are the people responsible for the metadata, helping to maintain its quality. Within Aristotle they are the only ones who can edit content once it becomes “locked” by a registrar.

  > A steward may be staff working with the people maintaining the metadata registry to ensure the quality of the metadata registry. They could also be Information Analysts or Data Architects.

* **Manager** - This is the person who oversees the operation and membership of a Workgroup. They can add users to a Workgroup and assign them roles. They can archive a Workgroup to close it and prevent new material from being added. They can also close or remove discussions within a Workgroup.

### Stewardship Organisation (SO)  <a href="#stewardship_organisation_so" id="stewardship_organisation_so"></a>

*What is the Stewardship Organisation?*<br>

A Stewardship Organisation is a group responsible for the maintenance of metadata. All endorsed or published metadata belongs to a Stewardship Organisation responsible for keeping it up to date. Workgroups and Registration Authorities also belong to a Stewardship Organisation that assists with the maintenance of these groups.<br>

* **Member** - These users can view metadata published to members, and a list of all the Workgroups in the Stewardship Organisation.
* **Steward** - These are the users responsible for the maintenance of metadata within the Stewardship Organisation, they are able to edit any metadata that has been endorsed in the SO, even if the metadata content is at a "locked" status. Members can publish metadata, and they can create, edit, and publish collections and reference documents.&#x20;
* **Manager** - These are the users responsible for the maintenance of the Stewardship Organisation, they also have control of all content within the SO. They can rename, archive, or edit details of the SO. They are responsible for giving/revoking membership to the SO, and are the users who assign roles to members. These users can also create, edit, and remove both Workgroups and Registration Authorities within the SO. These users can also create labels for issues that other users can use to tag issues with during the creation of an issue for a metadata item.&#x20;
* **External Collaborator** - This is a specialised external role within an SO. These users can be given roles to maintain metadata in an SO, but can only view metadata in their Workgroups. They cannot view metadata that is published only for SO members. They can be given submitter, steward, or manager permissions in a Workgroup within an SO.&#x20;

### Registration Authority (RA)<br>

*What is the Registration Authority?*

One or more people who are trusted and have the knowledge and responsibility of enforcing the correctness of metadata.

* **Registrar** - A person who acts on behalf of the registration authority who endorses metadata as meeting a set of requirements for use. Within the registry, they can endorse metadata independently or respond a request for review from other users.

  > A registrar would be someone working on behalf of a standards body, like representatives of government agencies who endorse national metadata standards.<br>
* **Manager** - This is the person responsible for the maintenance of the RA, they have control of the RA. They can rename, archive and edit details of the RA, they can also invite and remove registrars. They are responsible for setting the status level at which metadata is made "public". They also are responsible for setting the status level at which metadata is "locked" from further editing.&#x20;

### Registry wide users<br>

*What is the Registry?*

A running copy of the Aristotle Metadata Registry that helps an organisation manage its metadata.

* **User** - A user is any person who has an account and can login to the registry. A user account is tied to one email address the user uses to login.&#x20;
* **View-all** - A user can be given "view-all" permissions which gives them permission to view all metadata items, regardless of status - including content in users private sandboxes. This role should be restricted and be given to trusted users, such as help desk staff who need permission to view content to assist other users.&#x20;
* **Administrator** - This is the superuser role of the whole registry. This is the person who can add, remove, and deactivate users. They can add and remove Workgroups, Registration Authorities, and Stewardship Organisations. The administrator can assign people to be managers, and they can carry out all the additional roles assigned to the different users of the registry. They can also monitor and perform system tasks, such as backups and site management.&#x20;

### How to view your roles in the registry <a href="#how_to_view_your_roles_in_the_registry" id="how_to_view_your_roles_in_the_registry"></a>

1\. From your Dashboard, you can either select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qx576c08a902c177b4439bef0e47c4a467490" alt="" data-size="line"> from your side panel or from the dropdown in the header bar\ <br>

<figure><img src="/files/qNmWAroB6fxnFWW1gjt5" alt=""><figcaption></figcaption></figure>

2\. From your Profile page, select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qx576a2085e0749ec4615b5a6b6d79524514b" alt="" data-size="line"> under "Actions"&#x20;

<figure><img src="/files/2keDttSSqsuCt1yrJJwY" alt=""><figcaption></figcaption></figure>

3\. This is your My Roles page, and from here you will see all your roles within the registry, with a brief description of your permissions in that group&#x20;

<figure><img src="/files/eeQBf4J44isN88G6XIdZ" alt=""><figcaption></figcaption></figure>


# Viewing your roles

1\. Go to 'My Profile' from your Dashboard side panel or the dropdown in the Navigation bar.

<figure><img src="/files/PGZigXa6GukQbb6VGjuy" alt=""><figcaption></figcaption></figure>

2\. From your Profile under Actions, select 'View My Roles'.

<figure><img src="/files/5yKCdTfgkB2DighISKzS" alt=""><figcaption></figcaption></figure>

3\. This will show your Roles within the Registry.

<figure><img src="/files/Dya1Jg0l8YtTUP1kXmBu" alt=""><figcaption></figcaption></figure>

This page will show you the Group names, the Type of Group (Registry wide, Workgroup, Registration Authority), your Role within the Group, and the Description of your permissions within that Group.


# Favouriting and tagging content

### How to favourite content <a href="#how_to_favourite_content" id="how_to_favourite_content"></a>

Favouriting an item is like bookmarking an item to make it easier to find.

You can Favourite items from several locations:

1. From an item page
2. From "Browse"
3. From your Sandbox

To favourite an item, select the  ![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=qdj7w118ee1e7bb8e414a8a015949d72c917a)  icon on the item page.

<figure><img src="/files/gOKy9g3wx8adcGFP73L1" alt=""><figcaption></figcaption></figure>

Once the item is Favourited, the icon will appear filled in.

<figure><img src="/files/rtORzGl1ieq9v9Phdxlz" alt=""><figcaption></figcaption></figure>

To unfavourite an item, reselect the  ![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=qdj7we53ffc3502904eb393749295f3b399c9)  icon on the item page.&#x20;

### Finding your favourite content  <a href="#finding_your_favourite_content" id="finding_your_favourite_content"></a>

To view your Favourites from your Dashboard, Select 'Favourites and Tags' in the side panel, or from the dropdown in the Header bar.

<figure><img src="/files/QEBg7L1esB2h2JiN4BJO" alt=""><figcaption></figcaption></figure>

This page will display your Favourite items.

<figure><img src="/files/bWSlXFW2SO4p9Ie9dQ6l" alt=""><figcaption></figcaption></figure>

### How to Tag content  <a href="#how_to_tag_content" id="how_to_tag_content"></a>

{% hint style="info" %}
Tagging items lets you group different items together, which makes them easier to find and access together. Tagged items are personal to you, other users of the Registry will not be able to view or see the tags you've attached to items.
{% endhint %}

1\. Go to an item page.

<figure><img src="/files/hwcBBTvFLA1kKEXXDvIq" alt=""><figcaption></figcaption></figure>

2\. Select the  ![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=qdj7w0b3f63bebff147ad8328f66a0e765499)  button in the Action bar.

<figure><img src="/files/BeB0W1nShhS83C7L100c" alt=""><figcaption></figcaption></figure>

3\. Start typing in your tag. You can add multiple tags, you just have to press "enter" or insert a comma from your keyboard to create each tag.

<figure><img src="/files/sJz4WAg7WBlG0S03Roys" alt=""><figcaption></figcaption></figure>

If a Tag shows up darker, then it hasn't been created previously and is a new Tag. In this case, the 'Best item' Tag has been used before to Tag items.

<div align="left"><figure><img src="/files/jMS6NJ0jx3ggVBBk9Q7M" alt=""><figcaption></figcaption></figure></div>

4\. Once done, select ![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=qdj7we0e51e194df34c1c9d018ce01916b6d0)to create your tag(s) for the item.

Your tags will now show up in the bottom of the info box on the item page.

<figure><img src="/files/LdacBIIm73dyS9HXCeoK" alt=""><figcaption></figcaption></figure>

### Finding your tagged content  <a href="#finding_your_tagged_content" id="finding_your_tagged_content"></a>

1\. Select 'Favourites and Tags' in the side panel on your Dashboard, or from the dropdown in the Header bar.

<figure><img src="/files/XSYc7q5o07ZIiLJlcl6q" alt=""><figcaption></figcaption></figure>

2\. To view all your Tags, select the 'View all tags' button.

<figure><img src="/files/7p7251fzFJWkAYfpUKKb" alt=""><figcaption></figcaption></figure>

3\. From here you can view all your Tags, see Descriptions for the Tags, see how many items are Tagged, and you can also delete your Tags.

<figure><img src="/files/dEaKhxKBovqjyeTKdzwX" alt=""><figcaption></figcaption></figure>

If you click on the Tag name you can:

* Edit the Tag Description.

<figure><img src="/files/chkcPDTYg71wqoFyKPMl" alt=""><figcaption></figcaption></figure>

* Edit the Tag name.

<figure><img src="/files/5RfzoGNX4SkgRsFclVLE" alt=""><figcaption></figcaption></figure>

* Perform Item Actions like delete the item or edit the item, if you have the Permissions to do so.

<figure><img src="/files/jd7IkT5OHZcdfefxwEVP" alt=""><figcaption></figcaption></figure>

* Apply Settings to how the Tagged content is viewed.

<figure><img src="/files/gwlVo23PdpFwGhs0eJ4E" alt=""><figcaption></figcaption></figure>

* The Settings let you select what information about the item you want displayed.

<figure><img src="/files/HAg1WDfq12k2p5MRcwbN" alt=""><figcaption></figcaption></figure>


# Notifications

Aristotle users can receive in-registry and/or email notifications upon the occurrence of any registry actions they have enabled notifications for.

## Notification Functionality

Notifications for the following triggers can be [viewed](/personalisation/notifications/viewing-all-notifications), and [configured/toggled](/personalisation/notifications/configuring-notification-permissions) on an individual basis:

* Changes to items:
  * In the user's workgroup(s)
  * That the user has tagged/favourited
  * That the user can edit
* Superseding of items:
  * In the user's workgroup(s)
  * That the user has tagged/favourited
  * That the user can edit
* Additions of new items to the user's workgroup(s)
* If the user is a Registrar, Registration Authority relevant:
  * Item:
    * Supersedes
    * Registers
    * Status changes
  * Review:
    * Requests created
    * Requested updated
    * Comments posted
* Updates to issues attached to items:
  * In the user's workgroup(s)
  * That the user has tagged/favourited
  * That the user can edit
* Discussion posts and comments.

For the above, users can also configure whether they are notified via:

* Email
* In-registry notifications

**Note:** The following Administrator-only notification triggers cannot be configured/toggled:

* New user or Aristotle staff registration
* Superuser permission changes
* Harvest tasks starting.


# Configuring notification permissions

All users can adjust which triggers that they receive notifications for, as well as whether they receive notifications via email, in-registry, both, or not at all.

## How to configure notification permissions <a href="#notification_permissions" id="notification_permissions"></a>

1. Select 'My Profile' from your username dropdown.

<figure><img src="/files/p6RIjpIMERABAfrzQORT" alt=""><figcaption></figcaption></figure>

2. Select 'Notification Permissions'.

<figure><img src="/files/AEYTLy4gcabQxUv80z1R" alt=""><figcaption></figcaption></figure>

3. Navigate to the following sections and toggle the applicable notification triggers as desired:
   * 'General Changes': Contains triggers for changes to items:
     * In your workgroup(s)
       * That you've tagged/favourited
       * That you can edit
   * 'Supersedes': Contains triggers for the superseding of items:
     * In your workgroup(s)
     * That you've tagged/favourited
     * That you can edit
   * 'New Items': Contains triggers for additions of new items to your workgroup(s)
   * 'Registrar': Contains triggers for Registrars regarding Registration Authority relevant:
     * Item:
       * Supersedes
       * Registers
       * Status changes
     * Review:
       * Requests created
       * Requested updated
       * Comments posted
   * 'Issues': Contains triggers for updates to issues attached to items:
     * In the user's workgroup(s)
     * That the user has tagged/favourited
     * That the user can edit
   * 'Discussions': Contains triggers for discussion posts and comments.

<figure><img src="/files/BuJOZmxptiBGe2Wg2mjs" alt=""><figcaption></figcaption></figure>

4. Navigate to the 'Notification Methods' section, and select the methods you wish to be notified through.

<figure><img src="/files/nPyKwDSelq3FY5YJBE6d" alt=""><figcaption></figcaption></figure>

5. Select 'Save Changes' once satisfied.

<figure><img src="/files/iMPDO9MpDT2q9sdXYHyu" alt=""><figcaption></figcaption></figure>


# Viewing all notifications

All users can view their most recent notifications from their user dashboard, or view all of their unread notifications in detail.

## How to view all notifications <a href="#viewing_notifications" id="viewing_notifications"></a>

1. Select the notifications icon from the registry header. This will display the same selection of your most recent notifications as your dashboard.

<figure><img src="/files/6I5SZQQshoUJmkQrGVIn" alt=""><figcaption></figcaption></figure>

2. **If you wish to mark all notifications as read,** select 'Mark all as read'. **If you do not wish to mark all notifications as read**, select 'View all unread notifications'.

<figure><img src="/files/KBMqhySBWbJa2R2OMYEb" alt=""><figcaption></figcaption></figure>

**Note:** Once read or marked as read, notifications will be deleted.

3. Review your notifications. **If you wish to delete a notification**, select the delete icon from that notification's row. **If you wish to mark all notifications as read**, select 'Mark all as read'.

<figure><img src="/files/UGMPxBQPMO3h8RZGfTvb" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/vXFdxo5IlCQm5rdpowfT" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/FCPGdt5HjskufdM3f3Fw" alt=""><figcaption></figcaption></figure>


# Creating and Editing


# My sandbox

This is the place items sit that you've created that haven't been submitted for review, added to a Workgroup or been registered.

### Access your Sandbox <a href="#access_your_sandbox" id="access_your_sandbox"></a>

1\. Go to ![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=qdj7weac026cef6a24d9cb313c83e85d1efb9) on the Dashboard side panel.&#x20;

### What you can do in your Sandbox <a href="#what_you_can_do_in_your_sandbox" id="what_you_can_do_in_your_sandbox"></a>

This is an example of what a Sandbox looks like:

<figure><img src="/files/FX5tRFCGoHt59AMjm1po" alt=""><figcaption></figcaption></figure>

You can Search for items here, either by Name or Details.

<figure><img src="/files/wQCrq4R6TS1WJDSMiuzJ" alt=""><figcaption></figcaption></figure>

You can also Filter Search results by Item type and also Status, or State, that an item is registered at.

<figure><img src="/files/ogBwV1xE1zLg8hD9wHGD" alt=""><figcaption></figcaption></figure>

You can perform 'Bulk Actions' - This allows you to perform an action on multiple items at once.

<figure><img src="/files/twZgbIdFgmGM6wFX9JQH" alt=""><figcaption></figcaption></figure>

You can perform 'Item actions' where you can delete items or edit items.

<figure><img src="/files/XhuHoet6hj3GX8hyhk3w" alt=""><figcaption></figcaption></figure>

'Create Share Link' - This is where you can share your Sandbox contents with other authenticated users of the system, you can revoke these permissions at any time and other users will not be able to edit or delete items from here, only viewing privileges.

<figure><img src="/files/fHlX3HqlIdFVRaUmwQmm" alt=""><figcaption></figcaption></figure>


# Metadata Toolbox

Toolbox is the feature in Aristotle Registry supporting various functions such as extract reports related to metadata, Bulk importing and downloading of metadata.

### How to navigate to toolbox page from My dashboard?

Click on the Toolbox from the drop down list.

<figure><img src="/files/cw2i0JtjNR7lFMXoJhTZ" alt=""><figcaption></figcaption></figure>

User would be navigated to the toolbox page.

<figure><img src="/files/UBDXq87wZDZ0JeyTAKzz" alt=""><figcaption></figcaption></figure>

#### Various Features Under Toolbox that user can use to explore their metadata in Aristotle Registry

* **Data Element Component Registration Report:** A tool to display Data Elements which have component metadata items with a different status with a selected Registration Authority.

{% hint style="info" %}
User must be the administrator of the Registry to have access to this function.
{% endhint %}

<figure><img src="/files/buEccAktAxKatN0ghmgP" alt=""><figcaption></figcaption></figure>

After Clicking on <img src="/files/BcJ5bgvbAHvuGuhnX0SL" alt="" data-size="line">, user can select the "Registration Authority" and preferred status for metadata. To generate the results, user must click on <img src="/files/shcfpFcUbWEhJqtKSqPr" alt="" data-size="line">&#x20;

<figure><img src="/files/KlZgP0cN2lkNBM35AUT8" alt=""><figcaption></figcaption></figure>

* **Metadata Comparision Tool:** This function in Aristotle Registry helps user to compare different metadata elements to see the differences between them.

<figure><img src="/files/Cef5yrGuOSU1tYdeyCTh" alt=""><figcaption></figcaption></figure>

After Clicking on <img src="/files/ce2bc89OvVUigPXknJQg" alt="" data-size="line">,  user can select the different metadata from the  drop down list . User can type the ids of the metadata in the search bar provided on the top of the drop down list.&#x20;

After selecting the different metadata for which comparation needs to be drawn, User needs to click on <img src="/files/MfeNnPlBNBmsImCMykZl" alt="" data-size="line"> to see the results.&#x20;

* **Metadata Reports:** This function in the Aristotle registry allows user to generate reports related to metadata and helps to develop deep and novel insights into the metadata.

{% hint style="info" %}
To access this function:

User must be Administrator of the Registry or must have certain permissions given by Administrator.
{% endhint %}

<figure><img src="/files/tvBBxdnI4LVRWKVkOBKP" alt=""><figcaption></figcaption></figure>

After Click on <img src="/files/sAeK3lmWD3iZ1s7118t9" alt="" data-size="original">, User can either generate a new report or can also import the reports that are generated by other user in the registry.

To generated the new Report, user needs to select stewardship organisation and Base Model. After selecting the base model, user will have access of the side panel, containing two fields: relational and item. User can select the item from item fields and also explore different relations associated with the items.&#x20;

<figure><img src="/files/sSQaZwsU2Y5hdcEZQnax" alt=""><figcaption></figcaption></figure>

* **Simple Data Dictionary Format: T**his function allows user to bulk import the data dictionaries in Excel and CSV format that will be converted into the metadata items.

  <figure><img src="/files/Qmw05Lh80M7uBpWcccC4" alt=""><figcaption><p>  </p></figcaption></figure>

  After clicking on <img src="/files/KjS1yGKXIQon3UfsecmH" alt="" data-size="line">, User can download the template in Excel and CSV format that can support the bulk import of data dictionary in Aristotle Registry. After completing the file, user can upload that file from their computer or can drag and that file to the upload section.

  <figure><img src="/files/D2WwDTlcZDloNfQWVo8q" alt=""><figcaption></figcaption></figure>

* **Aristotle Bulk Importer:**  This feature helps user to create and update metadata item.&#x20;

  <figure><img src="/files/ChQfaYzexJfgK5b8GFap" alt=""><figcaption></figcaption></figure>

User can select the metadata type from the drop down lis&#x74;**.**&#x20;

<figure><img src="/files/ztgG1eBCC5eaoGkLk5N1" alt=""><figcaption></figcaption></figure>

User can also download the template that is compatible with Aristotle Registry for the particular metadata import or update. &#x20;

<figure><img src="/files/PtCnk1OP4dsZ2GepwazL" alt=""><figcaption></figcaption></figure>

* **Aristotle Bulk Downloader:** This feature allows user to bulk down the metadata from Aristotle Registry.&#x20;

  <figure><img src="/files/it3Siz8TmrvdX0WOz6u6" alt=""><figcaption></figcaption></figure>

  After clicking on <img src="/files/zCt0CNGrlyxAY9MABl1v" alt="" data-size="original">, user can select the type of the metadata that they want to from the Aristotle Registry.

  <figure><img src="/files/dGxREGfFJMJ7SfUtARvc" alt=""><figcaption></figcaption></figure>

  User can apply filter to the item fields. They can also filter by workgroups and stewardship Organisation

  <figure><img src="/files/G8GA70HbqoAp7cdmNlr1" alt=""><figcaption></figcaption></figure>
* **Executive Dashboard:** This is a flexible dashboard which shows high level views and depictions of the use of the registry.&#x20;

{% hint style="info" %}
User must be the Administrator of the Registry.
{% endhint %}

<figure><img src="/files/9mDBS7ilpBqylRaoKxc4" alt=""><figcaption></figcaption></figure>

After clicking on <img src="/files/IVj72pwagun6Q9jHaQcu" alt="" data-size="line">, user will be navigated to a page where they can see the high level views and insights of their Aristotle Registry.&#x20;

<figure><img src="/files/FHPVetnyYWNhEcgjD1sl" alt=""><figcaption></figcaption></figure>


# Creating metadata items

The Aristotle Metadata Registry supports the wizard-based creation of a variety of metadata items.

### How to create metadata Items <a href="#how_to_create_metadata_items" id="how_to_create_metadata_items"></a>

1. Select either 'Create Metadata' from the dashboard side panel, or the creation tool from the registry header.&#x20;

<figure><img src="/files/l6qftajOaylw4fo3koCU" alt=""><figcaption></figcaption></figure>

**Note:** The header's creation tool links directly to the single item creation wizards for Objects Classes, Properties, Value Domains, Data Element Concepts and Data Elements. Select 'See all...' from the bottom of the list to see the complete 'Create New Metadata' page.

2. Select the creation wizard for the desired metadata item type (see subpages 'Creating a data element or data element concept' and 'Creating a metadata item with a single item creation wizard').

### Single item creation wizards <a href="#single_item_creation_wizards" id="single_item_creation_wizards"></a>

These wizards are useful if you know you want to create just one item.

<figure><img src="/files/K1Th8mQOaxy6zg6Pye57" alt=""><figcaption></figcaption></figure>

This is the form you will see when selecting to create an object class.

<figure><img src="/files/7HawfjhRlrC7zTSvto4m" alt=""><figcaption></figcaption></figure>

Because reuse is important, each wizard will search for the name of your item and give you results if there are any matching or similar to your item. If you would like to create a new item, just type the name, version, workgroup and definition.

If you would like to simply create the item click <img src="/files/M3beY1eL50nlPMLDd73u" alt="" data-size="line">, or click 'Create item and keep editing'

At any time of the item creation, you can choose to 'Return to item page', 'Save changes and keep editing', or 'Save changes'

<figure><img src="/files/ApUVxxoUN85nJgZu3X4d" alt=""><figcaption></figcaption></figure>

After saving the changes, the item will look like the following image:

<figure><img src="/files/XCIza0PiyqIi9LsHQsUH" alt=""><figcaption></figcaption></figure>


# Creating a data element or data element concept

Wizards help make metadata creation and reuse of metadata items easier. Using these wizards, you will be stepped through creating either a Data Element of a Data Element Concept.

A Data Element can be created by either using a pre-existing object class, property, and value domain, or creating new items of these types within the wizard. A Data Element Concept can be created by either using a pre-existing object class and property, or creating new items of these types within the wizard.

### How to create a complete data element or data element concept

1. Select either 'Create Metadata' from the dashboard side panel, or the creation tool from the registry header followed by 'See all'.

<figure><img src="/files/y1FaPzsOWWRA6WQMqidI" alt=""><figcaption></figcaption></figure>

2. Select 'Get started >>' from either the 'Create new Data Element', or the 'Create new Data Element Concept' subheadings.

<figure><img src="/files/jv4L8pKpmMYvNjtRO7Ib" alt=""><figcaption></figcaption></figure>

3. Follow the resulting wizard's steps, answering its questions as best fits your requirements and populating mandatory fields when instructed.

**Note:** When asked to pick a metadata item, if no pre-existing items fulfill your needs, a new item can be created within the wizard by selecting 'None of the above meet my needs'. The steps that follow are mostly identical to those outlined in 'Creating a metadata item with a single item creation wizard' on the next page.

<figure><img src="/files/1Cs8vuCpMD2OvpTU5ulI" alt=""><figcaption></figcaption></figure>


# Creating a metadata item with a single item creation wizard

Wizards help make metadata creation and reuse of metadata items easier. Using these wizards, you will be stepped through creating a single metadata item, in the type of your choice.

### How to create a metadata item with a single item creation wizard

**Note:** For this guide, a Data Element will be chosen as the required metadata item type, but the basic procedure is consistent across all item types.

1. Select either 'Create Metadata' from the dashboard side panel, or the creation tool from the registry header (followed by 'See all' if your desired metadata type does not appear in the dropdown).

<figure><img src="/files/y1FaPzsOWWRA6WQMqidI" alt=""><figcaption></figcaption></figure>

2. Select 'Create' from the subheading that matches the item type you require.

<figure><img src="/files/SurCbpIZPIsHCctEOTTd" alt=""><figcaption></figcaption></figure>

3. Add the mandatory and desired information to the following tabs of the item creation page, as necessary:
   * Definition: The fields on this tab help to identify and define the metadata item
   * Names & References: This tab is entirely optional, but can be used to give extra context to the item
   * Components: This tab is entirely optional, but can be used to give extra context to the item. Components can also be added pose-creation
   * Slots: These fields are optional but can be used to annotate the item with additional attributes.

<figure><img src="/files/uhR2QPc4P7wVaKc0eSUY" alt=""><figcaption></figcaption></figure>

4. Select 'Create item' when all mandatory fields have been satisfied, and you have entered all of the desired optional content.

<figure><img src="/files/Xgb69rQhLUAlVSWGLJVq" alt=""><figcaption></figcaption></figure>

5. Your metadata item is now present in the registry.


# Editing content

## How to edit an item <a href="#how_to_edit_an_item" id="how_to_edit_an_item"></a>

{% hint style="info" %}
This help applies to logged in users with permission to edit metadata.
{% endhint %}

1\. When viewing an item, click the 'Actions' button in the top right of the screen to open the Actions menu, then select 'Open item editor'.

<figure><img src="/files/UbwtqbX4FBV4ONDPVxx6" alt=""><figcaption></figcaption></figure>

2\. You will be taken to the item editor. From here, you can edit any aspect of an item.&#x20;

<figure><img src="/files/tE3RbXeENH9DgOaG1lUA" alt=""><figcaption></figcaption></figure>

3\. Once you're done editing the item you can add in a change message. If you do not add in a change message an automatic message will be used and displayed on the item page.&#x20;

<figure><img src="/files/5C7dOHixSYl9sQvzLqJP" alt=""><figcaption></figcaption></figure>

4\. Don't forget to save by selecting the ![](https://help.aristotlemetadata.com/galleryDocuments/edbsn311b17045207c3164fe871497579f2141caf033617fe87c9089edb4480b9442f52bc4d8c3991b7b53d89834a6af463526f4a9a46737b504f54da2fb891f56d54?inline=true) button at the bottom of the page.&#x20;

<figure><img src="/files/5PblXwv4E9wf2vCmnqXo" alt=""><figcaption></figcaption></figure>

5\. Once the item is saved, you will be taken back to the item page where you can see the update from the 'History' tab on the page and that the item was updated in the item box next to 'Last updated.

<figure><img src="/files/aScGTwsyiSQ8B0UkP1DU" alt=""><figcaption></figcaption></figure>


# Recording physical data types

Physical data refers to tangible sources of data such as hard drives and data warehouses. Physical data 'type' refers to the storage format of data in these sources; INT and VARCHAR are common examples of physical data types.

Data type metadata items can be recorded as physical data types against a distribution's data element paths.

## Prerequisites

Before being attached to a distribution, a physical data type must be created as a representative data type metadata item. See [here](/creating-and-editing/creating-metadata-items/creating-a-metadata-item-with-a-single-item-creation-wizard) for instructions for creating a data type.

## How to record physical data types

1. Navigate to the desired distribution, and select 'Open item editor' from its 'Actions' dropdown.

<figure><img src="/files/l5Po5VKyZtWHouZrLmPC" alt=""><figcaption></figcaption></figure>

2. Select the 'Components' tab.

<figure><img src="/files/KHA7j7y3X3Un2wLbl8OS" alt=""><figcaption></figcaption></figure>

3. Navigate to the 'Data Element Path' section, and select either of the following:
   * An existing data element path
   * 'Add' to create a new data element path.

<figure><img src="/files/gejMXIyanfx8lTc2QDoJ" alt=""><figcaption></figcaption></figure>

4. Select a data type from the 'Physical Data Type' dropdown.

<figure><img src="/files/4sknNy4g4UYqanTz37Uq" alt=""><figcaption></figcaption></figure>

5. Complete any other configurations as required, then select 'Save changes' when satisfied. The physical data type will appear in a 'Physical Data Type' column on the relevant distribution's item page.

<figure><img src="/files/C9FKqjRjwxKK2n96DdDx" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/9SXAyaCiYA2Z2FeZIeLS" alt=""><figcaption></figcaption></figure>


# Cloning

Cloning is feature in Aristotle registry that can help user to create a Copy of the current metadata.

## How to Clone a metadata item <a href="#how_to_clone_a_metadata_item" id="how_to_clone_a_metadata_item"></a>

1\. Go to the item page of the item you would like to clone.

2\. In the Actions bar click on  "Clone this item".

<figure><img src="/files/ODktNInZN8ER3R95rBEn" alt=""><figcaption></figcaption></figure>

3\. The item is now cloned and you will be able to edit the item from a metadata creation page.

<figure><img src="/files/7NfpoiplV9RPIJfBHpxQ" alt=""><figcaption></figcaption></figure>

4\. User can define the version number to the cloned metadata.&#x20;

<figure><img src="/files/3XdgDResDxoHB67PAFJz" alt=""><figcaption></figcaption></figure>

User can also assign this cloned metadata to any workgroup. User can also assign workgroup after creating the item. This cloned version if not assigned to any workgroup with be in the User's Sandbox.

<figure><img src="/files/pBvL5Mz2ecEePN06Kv4R" alt=""><figcaption></figcaption></figure>

### How to add different value domain or data element Concept to the cloned data element

1. User can also add different value domain and data element concept to the cloned Data element.&#x20;
2. User can click on the Components tab.

   <figure><img src="/files/KuxIJUxMOPgPdBajFYGF" alt=""><figcaption></figcaption></figure>

3\. user can make changes to the cloned data element by changing data element concept and value domain.&#x20;

<figure><img src="/files/AcToOwhqWEw12qyl0y82" alt=""><figcaption></figcaption></figure>

4\. Once user is satisfied with the cloned item, Click on <img src="/files/e39r01fcfA8FdVbSvNIk" alt="" data-size="original">  and the item will be saved and user will be taken to the new items "item page".

<figure><img src="/files/k8RhSxA1KORudBbjy6Jk" alt=""><figcaption></figcaption></figure>


# Deleting metadata items

As the Aristotle Metadata Registry is intended to be an authoritative record of all the ‘business intelligence’ around data, content cannot be permanently deleted from the registry. However, in order to facilitate the maintenance of an up-to-date registry, Aristotle supports the soft deletion of content, which removes it from being displayed in the registry. Soft deleted items can be restored if they are required again.

To protect audit reports, metadata can only be deleted from a user's Sandbox. To return metadata to a user's Sandbox it must be **removed** from all groups, including Workgroups, Stewardship Organizations and Registration Authorities.

### How to delete metadata from the Sandbox <a href="#from_the_sandbox" id="from_the_sandbox"></a>

{% hint style="info" %}
All users can delete items in their Sandbox at any time.
{% endhint %}

1. Select 'My Sandbox' from the left side panel.

<figure><img src="/files/LDUF1STQxdRnd96Yivxa" alt=""><figcaption></figcaption></figure>

2. Select the 'Item actions' button next to the metadata item you want to delete and select 'Delete item'.

<figure><img src="/files/6fX9uOoSIClihB6cZ0hq" alt=""><figcaption></figcaption></figure>

### How to delete metadata that is registered <a href="#metadata_that_is_registered_or_in_a_workgroup" id="metadata_that_is_registered_or_in_a_workgroup"></a>

{% hint style="info" %}
Only users with the appropriate permissions can delete registered metadata.
{% endhint %}

1. Go to the item page and in the Info box select 'View registration history'.

<figure><img src="/files/tNVfUE6kxLyXM2o2CsXN" alt=""><figcaption></figcaption></figure>

2. Select 'Manage', then 'Delete'. The registration status will be removed.

<figure><img src="/files/0R8ZuCrleHm0TxPcWFAZ" alt=""><figcaption></figcaption></figure>

### How to delete metadata from a workgroup <a href="#remove_from_workgroup" id="remove_from_workgroup"></a>

{% hint style="info" %}
Only Users with the appropriate permissions can delete metadata from a workgroup.
{% endhint %}

1. Select 'Workgroups' from the left side panel.

<figure><img src="/files/tcltUUW68nn8HDPYYnFM" alt=""><figcaption></figcaption></figure>

1. From the 'Item actions' dropdown that relates to the desired item, select 'Remove from workgroup'.

<figure><img src="/files/dOFvT5ccf1dtgKZqhrv5" alt=""><figcaption></figcaption></figure>

2\. Select 'Confirm', and the metadata will be sent to the sandbox of the user who created it. From there, it can be soft deleted.

<figure><img src="/files/A8fLSLBV0aOohmaekKRZ" alt=""><figcaption></figcaption></figure>

### How to delete metadata from a Stewardship Organization <a href="#remove_from_stewardship_organisation" id="remove_from_stewardship_organisation"></a>

1. From the desired item's  'Actions' dropdown, select 'Change stewardship organization'.

<figure><img src="/files/Cz1uqacYpzr4fxr9iMlV" alt=""><figcaption></figcaption></figure>

2. Select the cross on the right side of the 'Move item into this stewardship organization' field.

<figure><img src="/files/aVRToR7oBw8vNSVKmpjY" alt=""><figcaption></figcaption></figure>

3. Select 'Change Stewardship Organization'.

<figure><img src="/files/olerYfPkB6E4KLi1HEl2" alt=""><figcaption></figcaption></figure>

4. The item will now appear in the sandbox of the user who created it. From there, it can be soft deleted.

### How to delete multiple metadata items at once using bulk delete

1. Select 'Browse' from the registry's header.

<figure><img src="/files/xB8VrTIJfBDEOcpUkLXU" alt=""><figcaption></figcaption></figure>

2. Select 'Browse' from the 'Metadata' field.

<figure><img src="/files/iogQtjPIZOBseNZSELsf" alt=""><figcaption></figcaption></figure>

3. Select the metadata item type you wish to delete.

<figure><img src="/files/qm62Xs0Ik127QFq6hDVt" alt=""><figcaption></figcaption></figure>

4. Select the tickboxes of all of the items you wish to delete.

<figure><img src="/files/pLswDfybzimZfVidBA6g" alt=""><figcaption></figcaption></figure>

5. Select the 'Bulk Action' dropdown, then 'Bulk delete'.

<figure><img src="/files/ilocxEBxFWxwpNdFKZHY" alt=""><figcaption></figcaption></figure>

6. If you wish to add more items, use the autocomplete field to search for, and add them to the list of items that will be deleted.

<figure><img src="/files/QMBuHLRyrBtI5BN23P1p" alt=""><figcaption></figcaption></figure>

7. Select 'Bulk Delete' once you are satisifed with your list. The items will be deleted, but can be restored via the procedure outlined in [Restore Deleted Content](/creating-and-editing/restore-deleted-content).

<figure><img src="/files/wY1n1xACwsp2pnEagMqF" alt=""><figcaption></figcaption></figure>


# Restore Deleted Content

### How to restore deleted content&#x20;

There are two ways you can view and restore deleted content in the registry: from your sandbox and from your workgroup.

1. From the metadata page of a workgroup you are a member of, click on the ‘View Deleted Metadata’ button.

<figure><img src="/files/AfTbcMADI2OmHsKMhkcy" alt=""><figcaption></figcaption></figure>

2\. From the Item actions column, click on the ‘Restore item’ tab.

<figure><img src="/files/5Pb7cWsyrB2wtpDvjXCq" alt=""><figcaption></figcaption></figure>

3\. From the confirmation page, click on the Restore button to restore the item.

<figure><img src="/files/jhkEdjxnYuD22DhaG0cn" alt=""><figcaption></figcaption></figure>


# How to create and link quality statements

## How to Create and Link Quality Statements <a href="#how_to_create_and_link_quality_statements" id="how_to_create_and_link_quality_statements"></a>

A Data Quality Statement records any known issues that may be related to a data asset. A Data Quality Statement assesses data against seven key factors: Institutional Environment, Relevance, Timeliness, Accuracy, Coherence, Interpretability & Accessibility.<br>

### &#x20;How to create a Quality Statement&#x20;

When browsing or creating metadata within the Aristotle Metadata Registry, Quality Statements are included under “**Performance Indicator Management Objects”** section

1\. Go to <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcn01c7d365a0d440adb26ef245c24cab65" alt="" data-size="line"> from your Dashboard side panel or from the dropdown in the header bar, Scroll down to “Quality Statement” and select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcn7d69b655e9de40009078525c1f99beee" alt="" data-size="line"> \\

<figure><img src="/files/8E5UVR1U9avjKPiRdVL4" alt=""><figcaption></figcaption></figure>

2\. Complete the Name and Definition fields in Step 1 Once done, select Next.

2\. Complete the Name and Definition fields in Step 1 Once done, select Next. <br>

<br>

3\. In Step 2, you can refine the Definition and add additional content like References from the Names and References tab. You are also able to add a Workgroup that the item is going to     belong to. If you do not select a Workgroup in this step, once the item is saved it will be available in your Sandbox.&#x20;

3\. In Step 2, you can refine the Definition and add additional content like References from the Names and References tab. You are also able to add a Workgroup that the item is going to belong to. If you do not select a Workgroup in this step, once the item is saved it will be available in your Sandbox.

<figure><img src="/files/0OcKarSfLuDNsq7GGuSF" alt=""><figcaption></figcaption></figure>

4\. Select the Components tab and complete each of the sections using the following table to answer the questions

<figure><img src="/files/f6GEQR4ypRiUK9hFyfBL" alt=""><figcaption></figcaption></figure>

* **Institutional Environment:** Is the collection managed according to a data quality framework? (add a description of the framework where possible). \
  What Data governance roles and responsibilities exist in the organisation?  \
  Are the data governance arrangements clearly assigned for this dataset or data source? (add a description of the Data governance arrangements where possible).&#x20;
* **Timeliness:** How often is the data collected or expected to be collected? \
  What is the information around the timeframe of the data such as when did it become available, is it likely to be updated routinely? \
  What is the reference period for the data?&#x20;
* **Accessibility:** What is the privacy or confidentiality issues that prevent the data from being released publicly? \
  Can data that hasn't been published be requested? \
  In which formats is the data available for people to use? Where and how do you access them? &#x20;
* **Interpretability:** Is a data dictionary available to explain the meaning of data elements? \
  What is the context that this data needs to be considered within? \
  Is there other information available to help users better understand this data source?&#x20;
* **Relevance:** What key data items are available?  \
  About whom, what, where and when was the data collected? \
  How have rates and percentages been calculated, are the numerators and denominators for the same data source(s)?  \
  What was the original purpose for collecting the data? \
  Have standard classifications been used?  \
  What are the classifications and if no standards have been used what are decisions for not using standard classifications?&#x20;
* **Accuracy:** How was the data collected? \
  If any adjustments to the data have been made, what are they what items are affected. \
  What is the collection and sample size? \
  Identify any known issues with under counts or over counts and the management of these? \
  How are processing errors handled? \
  What parts of the population are excluded from the collection?&#x20;
* **Coherence:** If this is an ongoing collection, how consistent is the data over time? \
  Can data from different States/Territories be compared? \
  Is a time series available for this data? \
  Have there been changes to the underlying data collection? \
  How have world-wide events impacted on the data since the previous release?  \
  Is this data reported in other publications, what are these and how do they compare?&#x20;

5\. Don’t forget to click save changes on the item after creating the quality statement

<figure><img src="/files/nkFVqQZ5Mc8DJ7TA14vD" alt=""><figcaption></figcaption></figure>

### How to Link Quality Statements  <a href="#how_to_link_quality_statements" id="how_to_link_quality_statements"></a>

1. Go to the indicator that you would like to link a quality statement to

   <figure><img src="/files/Ie8VsNjXlHBdqAQV7jki" alt=""><figcaption></figcaption></figure>
2. From the Actions bar, select Open Item Editor

   <figure><img src="/files/qxC7WtWBlIcoPEPWPvEK" alt=""><figcaption></figcaption></figure>
3. In the Editor Screen select the Components tab.

   <figure><img src="/files/Y1DlT5HaaaAXjA4UiUdy" alt=""><figcaption></figcaption></figure>
4. Scroll down to the Quality Statement section

   <figure><img src="/files/y49sv4SomPLZ9K5e8gbx" alt=""><figcaption></figcaption></figure>
5. Don’t forget to click <img src="/files/K1u1KmdTXgQNzs4wuWyi" alt="" data-size="original"> on the item after linking to the quality statement<br>

<figure><img src="/files/m7VMSAh0CiXe4nLBxwtW" alt=""><figcaption></figcaption></figure>

* **Definition tab:** Complete the Name and Definition fields in the Definition tab.

<figure><img src="/files/WNHC0wKAmNIAdxxoq4PS" alt=""><figcaption></figcaption></figure>

You are also able to add a Workgroup to this metadata. If you do not select a Workgroup in this step, once the item is saved it will be available in your Sandbox

* **Names & References:** These fields are optional. These field help to add more content to the item. You can add reference, origin and comments to the document.&#x20;

  <figure><img src="/files/newdoNDF6MRjm62KCAua" alt=""><figcaption></figcaption></figure>

You can also choose organisation Records type from the dropdown by selecting ![](/files/cf8lt7fUGDovcXykZpDC)

<figure><img src="/files/hostaXHpkK1w30GTTWj9" alt=""><figcaption></figcaption></figure>

* **Components tab**: Component Tab has seven categories to be taken into consideration: Institutional Environment, Relevance, Timeliness, Accuracy, Coherence, Interpretability and Accessibility. These fields are optional but gives an extra context to this metadata. If you don't fill these out at time of creation, you can fill in at a later stage.

  <figure><img src="/files/xVNvLRluS6m90CkvQHzd" alt=""><figcaption></figcaption></figure>

| **Quality Statement Section Name** | <p><strong>Questions to answer for each section</strong> </p><p><strong>(Suggest the application of a rating from 1 (lowest) to 5 (highest) for each of the 7 sections which will result in a score out of 35)</strong> </p>                                                                                                                                                                                                                                                          |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Institutional Environment**      | <p>Is the collection managed according to a data quality framework? (add a description of the framework where possible). </p><p>What Data governance roles and responsibilities exist in the organisation?  </p><p>Are the data governance arrangements clearly assigned for this dataset or data source? (add a description of the Data governance arrangements where possible). </p>                                                                                                |
| **Timeliness**                     | <p>How often is the data collected or expected to be collected? </p><p>What is the information around the timeframe of the data such as when did it become available, is it likely to be updated routinely? </p><p>What is the reference period for the data? </p>                                                                                                                                                                                                                    |
| **Accessibility**                  | <p>What is the privacy or confidentiality issues that prevent the data from being released publicly? </p><p>Can data that hasn't been published be requested? </p><p>In which formats is the data available for people to use? Where and how do you access them?  </p>                                                                                                                                                                                                                |
| **Interpretability**               | <p>Is a data dictionary available to explain the meaning of data elements? </p><p>What is the context that this data needs to be considered within? </p><p>Is there other information available to help users better understand this data source? </p>                                                                                                                                                                                                                                |
| **Relevance**                      | <p>What key data items are available?  </p><p>About whom, what, where and when was the data collected? </p><p>How have rates and percentages been calculated, are the numerators and denominators for the same data source(s)?  </p><p>What was the original purpose for collecting the data? </p><p>Have standard classifications been used?  </p><p>What are the classifications and if no standards have been used what are decisions for not using standard classifications? </p> |
| **Accuracy**                       | <p>How was the data collected? </p><p>If any adjustments to the data have been made, what are they what items are affected. </p><p>What is the collection and sample size? </p><p>Identify any known issues with under counts or over counts and the management of these? </p><p>How are processing errors handled? </p><p>What parts of the population are excluded from the collection? </p>                                                                                        |
| **Coherence**                      | <p>If this is an ongoing collection, how consistent is the data over time? </p><p>Can data from different States/Territories be compared? </p><p>Is a time series available for this data? </p><p>Have there been changes to the underlying data collection? </p><p>How have world-wide events impacted on the data since the previous release?  </p><p>Is this data reported in other publications, what are these and how do </p>                                                   |


# How to create and link glossary items

A Glossary Item is a commonly used business term that may not be well understood outside of the Organisation. It's useful to record Glossary Items so that when an uncommon term or piece of jargon is used in a definition, the meaning of this term can be captured and linked within the Registry.

### How to create a Glossary Item <a href="#how_to_create_a_glossary_item" id="how_to_create_a_glossary_item"></a>

When browsing or creating metadata within the Aristotle Metadata Registry, Glossary Item  is included under **“Business Glossary Objects”** section

1\. Go to ![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=s1a2u815c65488d2040cd82ff81bb94ff1c83) from your Dashboard side panel or from the dropdown in the header bar.

&#x20;Scroll down to "Glossary Item" and click ![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=s1a2u566ee744e2e2422f9d55ed01f8a50e6f)

<figure><img src="/files/4IHgnjtm3ryWshxlXlnL" alt=""><figcaption></figcaption></figure>

2\. You will be navigated to new window showing different Tabs:

* **Definition:** under this tab, you can name and define you glossary item.&#x20;

  <figure><img src="/files/X6oLJ4cGGtdcLqqrJRUK" alt=""><figcaption></figcaption></figure>

* **Names & References:** This tab is used to add extra content to the glossary item. You can add references, comments or any documentation related to the item.

  <figure><img src="/files/A8sQBPf7fYBVqhi3rE6I" alt=""><figcaption></figcaption></figure>

* Click on <img src="/files/6WNFn2CL1NiYRmweO4kv" alt="" data-size="line">. Adding a version to this Item is optional. You are also able to add a Workgroup to this glossary item. If you do not select a Workgroup in this step, once the item is saved, it will be available in your Sandbox.

### How to link a Glossary Item to other items  <a href="#how_to_link_a_glossary_item_to_other_items" id="how_to_link_a_glossary_item_to_other_items"></a>

1\. Go to the metadata that you would like to link a glossary item to

<figure><img src="/files/GUm5I6zckurR7j9joTnz" alt=""><figcaption></figcaption></figure>

2\. From the Actions bar, select Open Item Editor

<figure><img src="/files/3TPQI4KXOaTbdkXk4obz" alt=""><figcaption></figcaption></figure>

3\. In the Editor Screen, highlight the word to be linked to the glossary item and select the ![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=s1a2u4f3cac21074a4a71bae6065fb0b816aa)icon

<figure><img src="/files/OYByHI5XRbXH2EpOPWZK" alt=""><figcaption></figcaption></figure>

4\. Search for the name of the Glossary Item and click OK to create the link between the item and the Glossary Item

<figure><img src="/files/dyOIm8EmyTSAGKJkzD2q" alt=""><figcaption></figcaption></figure>

5\. Don’t forget to click save changes on the item after linking the Glossary Item

Once a Glossary Item is linked, you'll be able to hover over it in the item page and see a brief description of the item. If you select "...see more" you will be taken to the Glossary Item's item page.

<figure><img src="/files/vddqwsZRmPDgf5cqrqEX" alt=""><figcaption></figcaption></figure>


# How to record data lineage

### In a Dataset  <a href="#in_a_dataset" id="in_a_dataset"></a>

1\. Go to the "Create Metadata" from the side panel and select 'Create' for a Data Set.

<figure><img src="/files/oc4ZHnVNV4FvrX6hMuL1" alt=""><figcaption></figcaption></figure>

2\. Give the Data Set a name and definition, select the Workgroup if required, and click the Create Item button.&#x20;

<figure><img src="/files/qRXRYMni61a5F1FuPrrJ" alt=""><figcaption></figcaption></figure>

3\. In this step, you must define the Data Set if not provided in the previous step. You can also add different components to the item from here.

<figure><img src="/files/dpYa2sEvNojhI7MtIYkU" alt=""><figcaption></figcaption></figure>

4\. To record data lineage for this item, navigate the Components tab, and scroll down to the "provenance" section of the page.&#x20;

<figure><img src="/files/kQuY3mERhbTu4kMPq5z6" alt=""><figcaption></figcaption></figure>

5\. Select the 'Add' button to add a link. You can add multiple Data Sets by selecting![](/files/OiRVHXynfvDf13iWiDUC)for each item you would like to link.&#x20;

6\. Once done, select![](/files/Y6yiOAK092yd6jVblaMY)to create the new Data Set. The data lineage will now be visible on the item page under "Provenance".&#x20;

<figure><img src="/files/PTFIvAanSwsuTRWIiflD" alt=""><figcaption></figcaption></figure>


# How to add alternative names to a metadata item

{% hint style="info" %} <mark style="background-color:orange;">Make sure the item belongs to the Stewardship Organisation in which the alternative name type has been created</mark>
{% endhint %}

1\. Go to a metadata item and from the 'info bar', select  <img src="https://desk.zoho.com.au/galleryDocuments/edbsn0a832dc2d8b6188337f853cafc29d5477ce4a554903bc31bab1ea094ebbd6bb03c73eb5e2caea29d46714840a6efd736e25a8f1bea414adcbb2a72ed69480015?inline=true" alt="" data-size="line">  and then<img src="https://desk.zoho.com.au/galleryDocuments/edbsn0a832dc2d8b6188337f853cafc29d54701ece8e64a741b53c6bb2eaaa124ddd3319711c28668445508a84324f9045e0976ffc01aabdcb2903343c2bb09ab843c?inline=true" alt="" data-size="line">from the dropdown

<figure><img src="/files/RcO7Nzj82ISMz84hiy0F" alt=""><figcaption></figcaption></figure>

2\. Click ![](https://desk.zoho.com.au/galleryDocuments/edbsn0a832dc2d8b6188337f853cafc29d547bb57b8fcd48c06f54dcea8a765c1abc9df1bcd587e16955708a4f25d508d3b6abac3fa5b7ad2bd0f5a2209614cf98c4f?inline=true) to create an alternative name for the item&#x20;

<figure><img src="/files/or5ZuiYzNVeGBakKqEES" alt=""><figcaption></figcaption></figure>

Add an 'Alternative Name' in the free text box

<figure><img src="/files/qO5bjbwuSlVq0sC23SHx" alt=""><figcaption></figcaption></figure>

Select <img src="https://desk.zoho.com.au/galleryDocuments/edbsn0a832dc2d8b6188337f853cafc29d547a8af29d34f12741aa5ebfb9f239765a8cfcf09fa5461a80bcc1e6231bac07adf59838b6611379d3158002055328f7d27?inline=true" alt="" data-size="line"> to create the alternative name for the item. You can now edit and delete the alternative name as well

<figure><img src="/files/ZsxdIpXBk7j8UOwNDb1b" alt=""><figcaption></figcaption></figure>

3\. The alternative name is now visible on the item page in the Info box as ![](https://desk.zoho.com.au/galleryDocuments/edbsn0a832dc2d8b6188337f853cafc29d54728122cc6c2f64bb5702dc3388de254aafaba2dea553ba8ac15663b4df3e006c7fc2e3e0a2a9d37f53ce96bb2b2c3894c?inline=true)

<figure><img src="/files/TbVPV8TaLGUZ4SWpKsUI" alt=""><figcaption></figcaption></figure>


# How to move individual and bulk metadata into a collection

### Moving individual metadata into a collection

1. Go to the metadata item page and click on the Actions dropdown, then select 'Add collections'.

<figure><img src="/files/TEJM6iSRcsExw8fLaEC1" alt=""><figcaption></figcaption></figure>

2\. In manage the collections of the item, click on 'Add to new collections'.

<figure><img src="/files/BesSkZKSErUBXavB9pNI" alt=""><figcaption></figcaption></figure>

3\. A pop-up will show all the existing collections under that stewardship organisation. Select the collection where you want that metadata to move into and then click confirm.

<figure><img src="/files/2uDPYvjusW1Rrn9my2bp" alt=""><figcaption></figcaption></figure>

### Moving bulk metadata into a collection

1. Go to the metadata where you want to perform a bulk move to the collection. Check the ones you want to move, then click on 'Bulk Action' and select 'Change collection'.

<figure><img src="/files/F9XlwBfhz49oTKj20DGU" alt=""><figcaption></figcaption></figure>

2\. In the 'Collection to move items to' section, select the collection where you want to move all the selected metadata and click 'Move to collections'.

<figure><img src="/files/JPivj7Kc7rPv1705Wxjz" alt=""><figcaption></figcaption></figure>

3\. All the selected metadata has now been moved to the Collection.


# Upload Metadata Using Bulk Import Feature

Bulk metadata can be imported into the Aristotle registry in two ways: either using "Simple Data Dictionary Format" or "Aristotle Bulk Importer".

#### Steps to upload bulk metadata using 'Simple Data Dictionary Format':

1. Using "Simple Data Dictionary Format", we can do bulk upload only for the data elements.

Go to "Create Metadata" from the left side panel. Under Upload metadata, the first option is for "Simple Data Dictionary Format". Click on the "Upload SDDF" button.

<figure><img src="/files/kbeFa9eDiIDnAttZk1H4" alt=""><figcaption></figcaption></figure>

2\. From this page, you can either download the example or the template in excel or csv format.

<figure><img src="/files/4lGFCBv5W8lyPESogl4U" alt=""><figcaption></figcaption></figure>

3\. Once the download is done, fill in the excel sheet with the metadata.

<figure><img src="/files/DgZd2QrLNE2X5Bc8EC6N" alt=""><figcaption></figcaption></figure>

4\. Once the Excel is ready, go back to step 2. Click on the "Drop your file here or upload from your computer." and upload the Excel sheet.

<figure><img src="/files/HrOCTNIpxBgWnueFtgmu" alt=""><figcaption></figcaption></figure>

5\. When it shows "Upload complete" 50% with a green highlighted background, click on the save metadata.&#x20;

<figure><img src="/files/bXYeGBXlq3VOIeUDc63m" alt=""><figcaption></figcaption></figure>

6\. After saving metadata, the percentage bar will show 100% and the bulk data element upload is complete. If you want to undo the bulk upload, click on the "X" and it will undo the changes.

<figure><img src="/files/pFtGRLD1RUxsRLZoAyH1" alt=""><figcaption></figcaption></figure>

#### Steps to upload bulk metadata using 'Aristotle Bulk Importer':

1. Using "Aristotle Bulk Importer", we can do bulk upload for mostly all the kind of metadata, For instance, Data Set, Data Set Specification, Distributions, Object Class, Object Class Specialisation etcetera.

Go to "Create Metadata" from the left side panel. Under Upload metadata, the second option is for "Aristotle Bulk Importer". Click on the "Upload metadata" button.

<figure><img src="/files/GWeIZnZJ19fGM2zPwtBk" alt=""><figcaption></figcaption></figure>

2\. From this page, click on the "Please select a metadata type" dropdown. Select the metadata you want to perform bulk upload for, or type the metadata name, for instance, Object class, it will show you the filters for Object Class press enter.

<figure><img src="/files/tOV1k3ftpLw2bT5BlVzd" alt=""><figcaption></figcaption></figure>

3\. Click on the "Download template file for Object Class", fill in the Excel with the metadata, and drop your file in the drop box.

<figure><img src="/files/KuvXibGJSSMCcdjW91vz" alt=""><figcaption></figcaption></figure>

4\. This page shows 50% completion. Click on the "Save metadata".

<figure><img src="/files/7Up7wT68ZYbEUzKC346B" alt=""><figcaption></figcaption></figure>

5\. After saving metadata, the percentage bar will show 100% and the bulk upload is complete. If you want to undo the bulk upload, click on the "X" and it will undo the changes.

<figure><img src="/files/pFtGRLD1RUxsRLZoAyH1" alt=""><figcaption></figcaption></figure>


# HTML Sanitization

HTML sanitization is the process of cleaning and filtering HTML code to ensure it is safe to display and use. This process removes or neutralizes potentially harmful code that could be used for cross-site scripting (XSS) attacks or other malicious activities. Sanitizing HTML is crucial for maintaining the security and integrity of web applications.

### How HTML Sanitization Works

HTML sanitization involves parsing the input HTML code and removing or escaping any potentially dangerous elements or attributes. The goal is to retain the safe, expected content while eliminating the risk of harmful actions.

#### Default Allowed Tags and Attributes

In our HTML sanitization process, we have a predefined set of tags and attributes that are allowed to ensure the security and integrity of the content. All other tags and attributes are blocked to prevent potential security risks.

**Default Allowed Tags**

These are the default tags allowed *for user generated content* everywhere in the Aristotle Metadata Registry. Any tags not listed here will be removed during the sanitization process:

`<a>`, `<abbr>`, `<acronym>`, `<b>`, `<blockquote>`, `<br>`, `<code>`, `<col>`, `<colgroup>`, `<del>`, `<em>`, `<h1>`, `<h2>`, `<h3>`, `<h4>`, `<h5>`, `<h6>`, `<hr>`, `<i>`, `<img>`, `<ins>`, `<li>`, `<ol>`, `<p>`, `<strong>`, `<sub>`, `<sup>`, `<table>`, `<tbody>`, `<td>`, `<th>`, `<thead>`, `<tr>`, `<u>`, `<ul>`

On custom pages, we also allow the `<iframe>` tag to accommodate additional functionality.

**Default Allowed Attributes**

In addition to allowing certain tags, we also specify which attributes are permitted for each tag to further control the content and ensure security. The following attributes are allowed:

* **Links (`<a>`)**: `href`, `title`, `class`, `data-aristotle-concept-id`, `target`
* **Abbreviations (`<abbr>`)**: `title`
* **Acronyms (`<acronym>`)**: `title`
* **Images (`<img>`)**: `src`, `height`, `width`, `alt`, `style`
* **Table Data (`<td>` and `<tr>`)**: `colspan`, `rowspan`, `style`
* **Table Headers (`<th>`)**: `colspan`, `rowspan`, `style`
* **Column Groups (`<colgroup>` and `<col>`)**: `span`
* **Strong Emphasis (`<strong>`)**: `title`
* **Tables (`<table>`)**: `align`, `border`, `cellpadding`, `cellspacing`

For custom pages, we also permit certain attributes for `<iframe>` elements, such as `src`, `height`, `width`, `title`, `allowfullscreen`, `style`, and `sandbox`.

**Allowed CSS Styles**

We also allow specific CSS styles to enable better control over the presentation of the content. These include:

* `height`, `width`, `background-color`, `vertical-align`, `text-align`

This comprehensive approach to HTML sanitization ensures that we maintain a balance between functionality and security, allowing necessary content while preventing potential threats.


# Version Control - Supersede

The Aristotle Registry has the functionality to supersede metadata items. Superseding involves replacing an existing version of a metadata item with a new version that contains updated content or revisions. When a metadata item is superseded, it ceases to be the active or current version, and the new version takes its place. However, both versions are retained to maintain a track record of which metadata item superseded another item or which item has been superseded by a specific metadata item. This allows for a comprehensive history of metadata changes and ensures transparency in the evolution of metadata items. The steps to supersede the metadata items are as follows:

* Go to the latest version of metadata item that you have created in the Aristotle registry. Click on Actions, and then click on Edit Supersedes

<figure><img src="/files/jE9Pu3HsPHIH1UGQZL2p" alt=""><figcaption></figcaption></figure>

* Click on "Add a relationship"

<figure><img src="/files/rxCy0LrgIwZWT7up3dSu" alt=""><figcaption></figcaption></figure>

* Select the metadata item by which you want this specific metadata item to be superseded. Choose the registration authority, type a message if desired, and select the effective date from which this supersede should take effect, and then click on Submit.

<figure><img src="/files/8tsXIZpUXmjqs3Z7AfVZ" alt=""><figcaption></figcaption></figure>

* On the item page, you will see that this item is a supersede to another item.

<figure><img src="/files/YP0xbhnXwkiVdYn7bfVg" alt=""><figcaption></figcaption></figure>

* If you click on the highlighted 'Address: Postcode' item in the above screenshot, you will see that this metadata item has been superseded by another item, as indicated in the following screenshot.

<figure><img src="/files/lBEJzsq5etJjOXTPZE05" alt=""><figcaption></figcaption></figure>

In this way, we can create supersedes and can keep a track.


# Classifications

A list of mutually exclusive categories representing values of the classification variable. It can be used to record complex and deep data classifications.

{% embed url="<https://www.youtube.com/watch?v=wLn9QT3tgAE>" %}

### Steps for how to create a Classification in the Registry

* From the Dashboard, Click on "Create new Metadata"

  <figure><img src="/files/9EEaRPLfkrbMhJyC9B3S" alt=""><figcaption></figcaption></figure>

  2\. Scroll Down to "Classification" under "Classification Management" session and Click on "Create"

  <figure><img src="/files/ONiKekOcIiZXxHDjiTDL" alt=""><figcaption></figcaption></figure>

  3\. User would be navigated to Create Classification Page.
* Definition Tab: under this tab, User can name and define the classification. They can also assign this Classification to a workgroup.

  <figure><img src="/files/qPpzwgH3quwUMw7qBOHg" alt=""><figcaption></figcaption></figure>
* Names & References: Under this tab, user can provide additional information to this Classification.&#x20;

  <figure><img src="/files/P8BpJsylFZHuuyuIUbro" alt=""><figcaption></figcaption></figure>
* Components: User can add information about the structure and level of the Classification

  <figure><img src="/files/nW7APLSNDVFVNbZrwxo2" alt=""><figcaption></figcaption></figure>

  After adding all the relevant information,  Click on "Create Item".

### Steps to add items to the classification

* After creating the classification, click on Actions Tab and than click on "Edit Classification items".

  <figure><img src="/files/2iqMUyinHahMeP3vpceo" alt=""><figcaption></figcaption></figure>

  2\. User will be navigated to the page where they can start creating the Schema for the Classification. To add the item to the classification, Click on "Add item"

  <figure><img src="/files/BA656nL7SkyEz3qMMjOK" alt=""><figcaption></figcaption></figure>

  3\. Classification is a list of categories of groups and associated sub groups.&#x20;

  <figure><img src="/files/EsfOcACfz2KtDJwxywZU" alt=""><figcaption></figcaption></figure>
* Code Tab: This tab helps the user to group the categories of the classification.&#x20;
* Title tab: this tab helps the user to add title to the particular category in the classification
* Alternative Titles: This tab helps to add alternative title to the particular category in the classification.&#x20;
* Explanatory Notes: this tab helps to add information to particular category in the classification.&#x20;

### How to add Sub groups to the Groups in the Classification

1. To add the sub group to the any group in the classification. User can create the item.&#x20;

   <figure><img src="/files/eOEMdk9zV3UJ03JgjUp4" alt=""><figcaption></figcaption></figure>

   2\. Once the item is saved, User can drag the sub group item and drop it to the its parent group category. &#x20;

   <figure><img src="/files/YDzhjL4WoPrkFKEaR6yU" alt=""><figcaption></figcaption></figure>

   After adding all the grouping and sub-grouping to the Classification, Click on "Save Changes" to save the classification.&#x20;

### How to view the Classification?

To view the Classification, user can click on the "Classification Viewer" Tab

<figure><img src="/files/bmXZDG1rT3h0MBdOCoW7" alt=""><figcaption></figcaption></figure>

2\. User can expand the classification by Clicking at Arrows to see the sub groups associated with the groups.

<figure><img src="/files/GXr9gTLBPU7YIF0WxpHL" alt=""><figcaption></figcaption></figure>

User can search a particular group or sub group in the classification by using Search Functionality.

<figure><img src="/files/wGcUjv4KonWFKfujaR2G" alt=""><figcaption></figcaption></figure>

User can apply filters to the search at different level of sub groups in the classification

<figure><img src="/files/SGlBLPDzP4cTywGHHUq2" alt=""><figcaption></figcaption></figure>


# Indicators

An indicator represents a regularly reported value used to track the performance of a process or policy. Indicators can be linked to associated data elements, and grouped into indicator sets.

### **Prerequisites**

For indicators to be viewed or created, their extension ('Comet Indicator Registry') must be enabled in the Aristotle Cloud Settings Editor. See the [relevant help documentation](/administrator-tasks/aristotle-cloud-settings-editor/adjusting-metadata-and-functionality-extensions) for enabling metadata extensions.

### Functionality of Indicators

Indicators can be:

* Created
* Linked to data elements
* Grouped into indicator sets.


# Creating an indicator

Indicators can be created by any user of a registry that has the appropriate metadata extension enabled.

### Prerequisites

For indicators to be viewed or created, their extension ('Comet Indicator Registry') must be enabled in the Aristotle Cloud Settings Editor. See the [relevant help documentation](/administrator-tasks/aristotle-cloud-settings-editor/adjusting-metadata-and-functionality-extensions) for enabling metadata extensions.

### How to create an indicator

1. Select 'Create Metadata' from the dashboard side panel, or select the creation shortcut from the registry header followed by 'See all...'.

<figure><img src="/files/IbKLv0To99dByDuUQ0bp" alt=""><figcaption></figcaption></figure>

2. Navigate to the 'Performance Indicator Management Objects' category, then select 'Create' in the 'Indicator' field.

<figure><img src="/files/rr0Z89eIxGNnZ4OG73hh" alt=""><figcaption></figcaption></figure>

3. Populate the following tabs' fields as desired:
   * 'Definition'
   * 'Names & References'
   * 'Components'
   * 'Slots'.

<figure><img src="/files/U4iNq72EUdHrsL66mWJx" alt=""><figcaption></figcaption></figure>

**Note:** Only the 'Definition' tab's 'Name' and 'Definition' fields are mandatory.

4. Select 'Create item'.

<figure><img src="/files/mc6ABRUgpxw5j5oUOpjW" alt=""><figcaption></figcaption></figure>


# Linking an indicator to a data element

Indicators can be linked to data elements associated with the tracked value that they represent.

### Prerequisites

For indicators to be viewed or created, their extension ('Comet Indicator Registry') must be enabled in the Aristotle Cloud Settings Editor. See the [relevant help documentation](/administrator-tasks/aristotle-cloud-settings-editor/adjusting-metadata-and-functionality-extensions) for enabling metadata extensions.

### How to link an indicator to a data element

1. From the desired indicator's page, select 'Open item editor' from its 'Actions' dropdown.

<figure><img src="/files/PK5LcZzgrobwVXVxOVvJ" alt=""><figcaption></figcaption></figure>

2. Select the 'Components' tab.

<figure><img src="/files/HdUJy3RA5ShsmJYAD218" alt=""><figcaption></figcaption></figure>

3. Navigate to the 'Numerator', 'Denominator' and 'Disaggregator' fields, and select 'Add' based on which of these terms is the most appropriate descriptor of the data element you wish to link the indicator to.

<figure><img src="/files/uo6Tc80Mz6rM3aS7MPlk" alt=""><figcaption></figcaption></figure>

4. Select the desired data element, data set specification or data set using the relevant dropdowns.

<figure><img src="/files/81gXt1wwPgfZTVZiA1Ni" alt=""><figcaption></figcaption></figure>

5. Populate the 'Description' and 'Guide For Use' fields as desired.

<figure><img src="/files/UP7yt3FCh6DjI9D7qq1n" alt=""><figcaption></figcaption></figure>

6. Select 'Add'.

<figure><img src="/files/cNe18ItrL8NjFuyCCfLJ" alt=""><figcaption></figcaption></figure>

7. **If you wish to link this indicator to more data elements**, repeat steps 3-6. Then, when you are satisfied, select 'Save changes'.

<figure><img src="/files/hC2MQsaNuMkS0qCRFxlG" alt=""><figcaption></figcaption></figure>

8. The data elements you have linked, inclusive of selectable links, will now appear on the relevant identifier's page.

<figure><img src="/files/8WhwZ7q1zYhCcJ2nRHr6" alt=""><figcaption></figcaption></figure>


# Adding an indicator to an indicator set

Indicator sets can be created or added to by any user of a registry that has the appropriate metadata extension enabled.

### Prerequisites

For indicators to be viewed or created, their extension ('Comet Indicator Registry') must be enabled in the Aristotle Cloud Settings Editor. See the [relevant help documentation](/administrator-tasks/aristotle-cloud-settings-editor/adjusting-metadata-and-functionality-extensions) for enabling metadata extensions.

### How to create an indicator set

1. Select 'Create Metadata' from the dashboard side panel, or select the creation shortcut from the registry header followed by 'See all...'.

<figure><img src="/files/IbKLv0To99dByDuUQ0bp" alt=""><figcaption></figcaption></figure>

2. Navigate to the 'Performance Indicator Management Objects' category, then select 'Create' in the 'Indicator Set' field.

<figure><img src="/files/4zKqKg4hLx4E70KsOvb6" alt=""><figcaption></figcaption></figure>

3. Populate the following tabs' fields as desired:
   * 'Definition'
   * 'Names & References'
   * 'Components'
   * 'Slots'.

<figure><img src="/files/WLEFnc9rj5xHEOUFOoKA" alt=""><figcaption></figcaption></figure>

**Note:** Only the 'Definition' tab's 'Name' and 'Definition' fields are mandatory.

4. **If you wish for the indicator set to contain indicators upon creation,** select the 'Components' tab, then 'Add'.

<figure><img src="/files/I706DJ1FAcqgL5kZlprG" alt=""><figcaption></figcaption></figure>

5. Select the desired indicator using the 'Indicator' dropdown, then populate the 'Name' field.

<figure><img src="/files/eD2S0EqEY76MagmpOMm7" alt=""><figcaption></figcaption></figure>

6. **If you wish to add more indicators,** repeat steps 4-5. When you are satsified, select 'Create item'.

<figure><img src="/files/0geocgghlkPE1fRx1V5W" alt=""><figcaption></figcaption></figure>

7. The indicators added to the indicator set will now appear on the indicator set's page.

<figure><img src="/files/O4Bnh9czhBtv28Ac5KHs" alt=""><figcaption></figcaption></figure>

### How to add an indicator to a pre-existing indicator set

1. Select 'Browse' from the registry header.

<figure><img src="/files/2RavptxtjUKHdXFbiHNj" alt=""><figcaption></figcaption></figure>

2. Select 'Browse' from the 'Metadata' field.

<figure><img src="/files/ShW0gUgUPT7vG5xh8TRB" alt=""><figcaption></figcaption></figure>

3. Navigate to and select 'Indicator Sets'.

<figure><img src="/files/OLZ1rvQeMXPtmtEPIDpB" alt=""><figcaption></figcaption></figure>

4. Select the desired indicator set.

<figure><img src="/files/WNAKfYv3FhFA3Pm1YZGD" alt=""><figcaption></figcaption></figure>

5. Select 'Open item editor' from the 'Actions' dropdown.

<figure><img src="/files/x34udeSjFeB7NKdzvVdO" alt=""><figcaption></figcaption></figure>

6. Select the 'Components' tab, then 'Add'.

<figure><img src="/files/IGvae8Ln95uEf4h6hnmo" alt=""><figcaption></figcaption></figure>

7. Select the desired indicator using the 'Indicator' dropdown, then populate the 'Name' field.

<figure><img src="/files/IFvvtrZ9QRafYpenjpxZ" alt=""><figcaption></figcaption></figure>

8. **If you wish to add more indicators,** repeat steps 6-7. When you are satsified, select 'Save changes'.

<figure><img src="/files/Gx4xC0rhbUlQhYzQGrpf" alt=""><figcaption></figcaption></figure>

9. The indicators added to the indicator set will now appear on the indicator set's page.

<figure><img src="/files/kxt4Spi75A90icArbByR" alt=""><figcaption></figcaption></figure>


# How to link Quality statement to an Indicator?

A Data Quality Statement records any known issues that may be related to a data asset. A Data Quality Statement assesses data against seven key factors: Institutional Environment, Relevance, Timeliness, Accuracy, Coherence, Interpretability & Accessibility.

#### Steps to Go to "Indicator" from dashboard

1. Click on "Browse" under "Metadata" section.&#x20;

<figure><img src="/files/gnXtDojqh78bbH4oC9RN" alt=""><figcaption></figcaption></figure>

2\. Scroll down to "Indicators". After click on it, you would be navigated to the metadata having all the indicators in the registry.

<figure><img src="/files/BFQQg5zjE6rM5fCa9jgH" alt=""><figcaption></figcaption></figure>

3\. You can search indicator by name as shown to link quality statement.&#x20;

<figure><img src="/files/G4VNNoqaYzMBKDoDeVDH" alt=""><figcaption></figcaption></figure>

### How to add Quality Statement links to Indicators?

1. Click on "Actions" Tab. From the drop list, click on "Open item editor"

   <figure><img src="/files/b4HhoRIiT64pW2ncQkG7" alt=""><figcaption></figcaption></figure>

   2\. In the Advanced editor, Click on the "components" tab.

   <figure><img src="/files/wd72GD5oc11Soom5qmkx" alt=""><figcaption></figcaption></figure>

3\. Scroll down to "Quality Statement tab" under "Components" Tab.

<figure><img src="/files/QQ2bnvr92bjTZpH7A2Bb" alt=""><figcaption></figcaption></figure>

4\. You can search the quality Statement by its Name and ID in the Pop Up as shown.&#x20;

<figure><img src="/files/GuAP3NLjhxVzYdQHyMOn" alt=""><figcaption></figcaption></figure>

5\. Click on <img src="/files/Ky2gLEwAiQgaGOTeHDSW" alt="" data-size="line"> after adding Quality Statement.&#x20;

The quality statement is link to your indicator.

<figure><img src="/files/l953f8diABSkiN4OSgPe" alt=""><figcaption></figcaption></figure>


# Dataset Grouping

Dataset groupings are the capacity to create groups within datasets, allowing users to organise the distributions within datasets into a familiar folder-based approach. Dataset groups can store any number of distributions or other dataset groups, enabling collection of similar distributions.&#x20;

Additionally, the dataset groups may also remind users of the Collections in Aristotle, which have been used extensively for grouping distributions and datasets. There will also remain the option to include distributions in the root level of the dataset, without any groups, similar to the current implementation of the dataset distribution structure.

This is a tree structure will aid high-level interrogation of the data assets.

### Functionality of the dataset groupings

* These groupings help to improve the search functionality. Searching of the distribution in the large datasets is now much easier after the introduction of the groupings.
* These groupings help user to have a more organised ways while working with the datasets that contains a lot of tables.
* The organisational structure is akin to a file and folder structure and, therefore, will be a familiar mode of organisation.&#x20;
* The updates will decrease the loading times experienced by users with extensive datasets. They will make the navigation and interrogation of datasets easier and more dynamic.

  <figure><img src="/files/VPKV5ut5kTjVdYDrDdtA" alt=""><figcaption></figcaption></figure>

How to create the dataset groupings?

1. Go the dataset where user wants to create the grouping and click on "open editor".

   <figure><img src="/files/dAsJPnSEjkGtJsI79YT8" alt=""><figcaption></figcaption></figure>

2. Navigate to "components" tab, Scroll down to the "Distributions and Groups" section .

   <figure><img src="/files/tvpSGBOmn6pCTslFQH7w" alt=""><figcaption></figcaption></figure>

3. Click on “Add” to create a new distribution group and enter name and definition for the group.

   <figure><img src="/files/JP8hERe1pCkPPgueSPgm" alt=""><figcaption></figcaption></figure>

4. Scroll down to add distributions to this group.

   **Please Note:** One distribution will belong to one distribution group.

   <figure><img src="/files/nvGZFqJgs4dyGguJffpU" alt=""><figcaption></figcaption></figure>

5. Once all the required distribution is added to the groups, Click on “Save Changes”.

   <figure><img src="/files/PpUylQ8lRPlOf1amgcOP" alt=""><figcaption></figcaption></figure>


# Property Groups

A property group is a collection that gather sets of related [Properties](https://dss.aristotlecloud.io/help/concepts/aristotle_mdr/property) to aid discovery and navigation.  All properties that describe the same features are gathered together in property groups. Each property in the registry will be assigned to one property group. For example, Property Group named “Life Event Characteristics” will have the properties that are related to lifetime of a person or organisation like Date of Birth, Time of Birth etc.

### Property Groups Functionalities:

* These groupings allow the categorisation of the properties in the Aristotle Registry.
* The editor of the property groups can set permissions to control the other user to link the metadata to any property group.
* These groups play a vital role in the Business information model of an organisation.

### Permissions:

#### Control on Users: Editor can set the permissions to control users of the registry to link the properties to the property group. Permissions are as below:

* This can allow any user in the registry to link properties to the property group.
* Only users in same Stewardship organisations can allowed to link properties.
* Only Administrators of the registry can link the properties.
* Only users with permissions to edit the property groups can link the properties.

#### Control on properties that can be linked to the group: Editor can also set some control on which properties can be linked to the property groups. Permissions are as below:

* Any properties can be linked to this property group.
* Only properties within the same stewardship organisations can be linked to this property group.
* The property group cant be linked to the properties, this means only editor of the property group can link properties.

  <figure><img src="/files/6NcfI46HH7PcrEBP40pG" alt=""><figcaption></figcaption></figure>


# How to Create Property Groups In Aristotle Registry?

### Steps to create Property Group:

1. Go to My Dashboard, click on “Create new Metadata”.

   <figure><img src="/files/zavTxDg1kFFEPNlMgl1h" alt=""><figcaption></figcaption></figure>

2. Scroll down to “property group” under “Ontology” tab, click on “Create”.

   <figure><img src="/files/192KKueEKmbQUzma8zFo" alt=""><figcaption></figcaption></figure>

3. User can give name and definitions to the property group. The property group can be assigned to any workgroup from this page.

   <figure><img src="/files/qY69V2JWHYi9pfVFVpYu" alt=""><figcaption></figcaption></figure>

### Setting the permissions to control the users and properties that can be linked to the property group

1. Editor need to navigate to the components tab to set the permissions for the created property group.

   <figure><img src="/files/CgqWMtzVUNfT5qibs3rI" alt=""><figcaption></figcaption></figure>

2. Editor can set permissions to control other users to link property to this property group.

   <figure><img src="/files/lXAezRMwhDdGcEGsFDzQ" alt=""><figcaption></figcaption></figure>

3. Editor can also set the permissions to control properties that can be linked to the property group.

   <figure><img src="/files/xyC5ZHCwg61g2VdWU4fJ" alt=""><figcaption></figcaption></figure>

4. Editor can add properties to this group by scrolling down to “Included properties” tab and clicking “Add”.

   <figure><img src="/files/jjbC73ldYE7RmyqYsqpq" alt=""><figcaption></figcaption></figure>

5. User can search for properties from the list of the properties to be attached to this group.

   <figure><img src="/files/SsInbD7NDJ8kVVzuioKj" alt=""><figcaption></figcaption></figure>

6. After adding the properties, Editors needs to click on “Create Item”.

   <figure><img src="/files/rT4f2zP0TlZ2lYcOSxGf" alt=""><figcaption></figcaption></figure>


# Object Class Specialisation

Object class specialisation is grouping various object classes that are related. It is a collection that gather sets of related object classes to aid discovery and navigation.  All object classes that describe the same features are gathered together in property groups. Each object class in the registry will be assigned to one specialisation. For example, Specialisation named “Person-party” will have the object classes that are related to a person or organisation like Customer, Client, Child etc.

### Object Class Specialisation Functionalities:

* These groupings allow the categorisation of the objects in the Aristotle Registry.
* These groups play a vital role in the Business information model of an organisation.

### How to create object class specialisation in Aristotle registry

1. From the "My dashboard", Click on "Create metadata".

   <figure><img src="/files/hpbTwViI2RqgZyhbEIs2" alt=""><figcaption></figcaption></figure>

2. Scroll Down to Onology section, under Object class specialisation tab, Click on "create".

   <figure><img src="/files/v05qoNMz5Gl2dIdTt8fK" alt=""><figcaption></figcaption></figure>

3. User can name and define the specialisation, and click on "Save Changes"&#x20;

   <figure><img src="/files/XcHJFqU0bjB8ZXk4DwQ9" alt=""><figcaption></figcaption></figure>

New object class specialisation is created in the Registry.

### How to add object class the Specialisation.

1. Go to the object class specialisation, click on open item editor under actions tab.&#x20;

   <figure><img src="/files/HrY121FjI2qjNWNSTD27" alt=""><figcaption></figcaption></figure>

2. Navigate to components tab.

   <figure><img src="/files/DlFVbIh7Coxipr5Efbkz" alt=""><figcaption></figcaption></figure>

3. Under the Narrow class, Click on "Add" and select the object class from the drop down list.

   <figure><img src="/files/3QtUVHHUMOAnrpVyU3UC" alt=""><figcaption></figcaption></figure>

   Click on Save changes to attach the object class to its specialisation.


# How to create an object class specialisation

{% hint style="info" %}
The Aristotle Ontology Tools metadata extension must be enabled from the Aristotle Cloud Dashboard, this enables the Object Class Specialisations to be created from the Create New Metadata page.
{% endhint %}

Object Class Specialisations describe relationships between Object Classes, where multiple specialised Object Classes are all contained by a common broader Object Class.

To create an Object Class Specialisation:

1\. Go to Create new metadata from the Dashboard side panel or from the dropdown in the header bar&#x20;

<figure><img src="/files/VfpAfgVXXv8VAA6Uibju" alt=""><figcaption></figcaption></figure>

2\. Scroll down to the Ontology section of the page, Select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qx5767d906dabe36e4bf785c7c579c447bf10" alt="" data-size="line"> next to Object Class Specialisation&#x20;

<figure><img src="/files/chnSITFp1AxJPvQKw0ci" alt=""><figcaption></figcaption></figure>

3\. In Step 1, fill in the Name and Definition section of the form and select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qx5762ab597f6633c4cbaa3e3312006c23370" alt="" data-size="line"> to go to the next step

<figure><img src="/files/kVCKWcZaPTEBoakFrfaT" alt=""><figcaption></figcaption></figure>

4\. In Step 2, you can refine the Name and Definition and you can add additional content and a Workgroup

<figure><img src="/files/xSbhNKx4IK43QiwupEt7" alt=""><figcaption></figcaption></figure>

&#x20;   In the  tab: ![](/files/UV4lGUxanQ9opyMNlRvj)

* You can add References for this item, such as documents that contributed to the development of the metadata item&#x20;
* You can add an Origin for this item, such as the document or project which is the source of the metadata item
* You can add Comments describing the metadata item
* You can also add Organisation Records  and Reference Documents as well&#x20;

<figure><img src="/files/RQMWqIds3Ag7I4kIi4RN" alt=""><figcaption></figcaption></figure>

&#x20;  In the  tab: ![](/files/C9thQirEtu0b5hZBrUUJ)you can add information to provide context to the metadata item

* In Broader Class you can add information about the overarching idea that is being captured in the Object Class Specialisation. Example: "Person" <br>
* In Narrower Class you can add information about the smaller aspect of the broader class that is being captured. Example: "Adult", "Child"&#x20;

<figure><img src="/files/xlCPyPCxCbZkfiFdksnM" alt=""><figcaption></figcaption></figure>


# Collaborating within the registry


# Aristotle Help

A lot of help is available in the Aristotle metadata registry. The help in the registry assists registry users and public users to easily search and find any workflow or process they need to do in the Aristotle registry.

To see help in the Aristotle registry, click on 'Help' button, from either the header or the footer of the registry.

<figure><img src="/files/b4zggUTBjMsjWnH44ajc" alt=""><figcaption></figcaption></figure>

You will see some generic help documentation here on this page, with a few additional links.&#x20;

<figure><img src="/files/PZ8YYo78QqwSfkIBxraP" alt=""><figcaption></figcaption></figure>

* If you will click on the above-highlighted '**Metadata help pages**' link, you will see a lot of help documentations about the different types of metadata.

<figure><img src="/files/vVuT8UZ7tn80dIBV6cpG" alt=""><figcaption></figcaption></figure>

* Click on the 'Getting Help' help pages to see all the ways you can find help including links to the '[Aristotle Metadata Registry Knowledge base](https://help.aristotlemetadata.com/)'.


# How to add content to workgroups

### **From Sandbox** <a href="#from_sandbox" id="from_sandbox"></a>

#### An individual item from your Sandbox <a href="#an_individual_item_from_your_sandbox" id="an_individual_item_from_your_sandbox"></a>

1. Go to "My Sandbox". Click on the metadata where you want to add the workgroup.

<figure><img src="/files/QKKLLX74tltP1b5P8WXy" alt=""><figcaption></figcaption></figure>

2\. Click on Actions dropdown, then click on  open item editor.

<figure><img src="/files/InECTenWHgvx8G64aStv" alt=""><figcaption></figcaption></figure>

3\. To add an individual item to a Workgroup, select the Workgroup you would like to move this item to.&#x20;

<figure><img src="/files/fCehZZhzHWKRoTQTj0CZ" alt=""><figcaption></figcaption></figure>

4\. Select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7wecdb34b700784365aaa7cbb13cb36d14" alt="" data-size="line"> and the item will now be available in the selected Workgroup.

### Multiple items to a single Workgroup from your Sandbox

1. Select the tick box next to the items you would like to add. Once you've selected the items, select the <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7web0831dc3754408ca494989eb6a0013c" alt="" data-size="line"> dropdown and then <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7w298265fbb4344a048ac3a9a0a32d1de8" alt="" data-size="line">

<figure><img src="/files/JXp6Jp0KWBon8R8ojg0J" alt=""><figcaption></figcaption></figure>

2\. Fill in what Workgroup you want to move the items to.

<figure><img src="/files/Des11rfLrRHNh7Wdh5rK" alt=""><figcaption></figcaption></figure>

3\. Select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7wc249644e03464b4e976ee84339407055" alt="" data-size="line"> and the items will now be available in the selected Workgroup.&#x20;

### Change Workgroup&#x20;

How to change the Workgroup of an item that currently has a Workgroup

1. Go to the item page, click on the Actions dropdown and open item editor.

<figure><img src="/files/faTU8SFzIrzI5sDh2l3v" alt=""><figcaption></figcaption></figure>

2\. Under "Workgroup" select the Workgroup you would like to move this item to.

<figure><img src="/files/2u96JJZBIC6qRNw3HGF9" alt=""><figcaption></figcaption></figure>

3\. Once done, select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=qdj7w24b609f0265349a6893f9b3d09269500" alt="" data-size="line">and the item will now be available in the new Workgroup. \ <br>


# Opening a review

Reviews are used to endorse metadata to different states by Registration Authorities - it's a way for different Registration Authorities, or different business areas, to put their 'stamp of approval' on metadata content.

### How to open a review from the dashboard side panel <a href="#how_to_open_a_review" id="how_to_open_a_review"></a>

1\. Go to 'Review Requests' on the Dashboard side panel.

<figure><img src="/files/Mcde7aNRRzeYcrnfcDaq" alt=""><figcaption></figcaption></figure>

2\. Select ![](https://desk.zoho.com.au/DocsDisplay?zgId=7000211905\&mode=inline\&blockId=qx576dcc75037dce04ae5ba34737a4a972de8) in the upper right hand corner of the page.

<figure><img src="/files/iu3ndoRyfwUp2JLBZEOI" alt=""><figcaption></figcaption></figure>

3. Populate the following fields as desired:
   * 'Title'
   * 'Workgroup'
   * 'Registration authority'
   * 'Date response required'
   * 'Target registration date'
   * 'Date registration effective'
   * 'Metadata'
   * 'Cascade registration'.

<figure><img src="/files/qD064hohuMEff90eV1GS" alt=""><figcaption></figcaption></figure>

4. Select 'Create New Review'.

<figure><img src="/files/OBuENIc8g2HLHEoUssZ0" alt=""><figcaption></figcaption></figure>

### How to open a review directly from a metadata item page <a href="#from_an_item_page" id="from_an_item_page"></a>

1. Go to the item page for the item you wish to open a review for.

<figure><img src="/files/VfwlizLkAnP6VSlRMPeu" alt=""><figcaption></figcaption></figure>

2. From the Actions bar dropdown, select 'Submit for review'.

<figure><img src="/files/XIH7KozjvhhmNrbWpOo7" alt=""><figcaption></figcaption></figure>

3. Fill in the 'Create new review' form as desired.

<figure><img src="/files/MxGqq9squSe3Rqad8lCq" alt=""><figcaption></figcaption></figure>

4. Select 'Create New Review'.

<figure><img src="/files/v8qkQjkNoCKOJ89Ggiwc" alt=""><figcaption></figcaption></figure>


# Aristotle metadata community

## What is the Aristotle Metadata Community? <a href="#what_is_the_aristotle_metadata_community" id="what_is_the_aristotle_metadata_community"></a>

The Aristotle Metadata Community is a forum that all users of the Aristotle Metadata Registry or interested parties can join and be a part of the growing community of people interested in all things metadata. The main purpose of the forum is that anyone can ask a question or submit a query and either a user of the Aristotle Metadata Registry or an employee will respond directly, giving a more open and direct way to communicate and share metadata knowledge.

### Where do I find the Aristotle Metadata Community?  <a href="#where_do_i_find_the_aristotle_metadata_community" id="where_do_i_find_the_aristotle_metadata_community"></a>

The Aristotle Metadata Community forum is available at [community.aristotlemetadata.com](https://community.aristotlemetadata.com/), and you can browse through many topics already available, or you can sign up to reply to a topic or create a new one.&#x20;

<figure><img src="/files/taO1lXIV8NjWmhWUrKbm" alt=""><figcaption></figcaption></figure>


# How to create Collections and Sub Collections

### How to create Collections

{% hint style="danger" %}
You have to be an Administrator to create Collections
{% endhint %}

1. To create collections, go to browse.

<figure><img src="/files/wziVYMTDbIKwZ3Mll0ol" alt=""><figcaption></figcaption></figure>

2\. Go to the stewardship organisation, click on browse.

<figure><img src="/files/UzuZCexpmQj4QIbWqTPu" alt=""><figcaption></figcaption></figure>

3\. Click on the stewardship organisation name where you want to create collections. Go to the collections tab, click on 'create collection'.

<figure><img src="/files/coNUPqLfcXhduTCZkmNR" alt=""><figcaption></figcaption></figure>

4\. Give a name and description to the collection. From the 'add metadata permission' dropdown, select who you want to give access to the collection. Once done, click on  <img src="/files/adzZ8uFef6PVH5s1Hhxm" alt="" data-size="line">

### How to create a Sub Collection

1. Go to stewardship organisation. In the Collections tab, click on the Collection name where you want to create sub collection.

<figure><img src="/files/JuzKtUjtG9XRdbsZ1CEV" alt=""><figcaption></figcaption></figure>

2\. Click on 'Create Sub Collection'

<figure><img src="/files/qyomF6xoYTlYxFNCIpkM" alt=""><figcaption></figcaption></figure>

3\. Give a name and description to the sub collection. From the 'add metadata permission' dropdown, select who you want to give access to the sub collection. Once done, click on  <img src="/files/adzZ8uFef6PVH5s1Hhxm" alt="" data-size="line">

<figure><img src="/files/VzJ3RlM1LLG7fEYPbpxg" alt=""><figcaption></figcaption></figure>


# Issues and Change Requests

Issues allow users to comment on metadata items and suggest changes to common metadata fields. Issues can also be labelled for improved context/identification.

### Functionalities of Issues and Change Requests <a href="#creating_a_new_issue" id="creating_a_new_issue"></a>

Issues can be:

* Created
* Labelled
* Viewed via the 'All Issues' page.

Change requests can be proposed within an issue.


# Creating an issue label

Issue labels (labels) are used to add more context to item issues, similarly to tags (the difference being that other authenticated users can see issue labels). Issue labels can be created in the relevant Stewardship Organisation, or by an Administrator of the registry. They can be either Stewardship Organisation specific or, if created by a registry Administrator, registry-wide.

**Note:** The following procedure is for users planning to apply a label to a new issue. If you know you are not going to need a label, see [*Creating an issue*](/collaborating-within-the-registry/issues-and-change-requests/creating-an-issue) for the issue creation procedure.

### How to create an issue label

#### As a registry Administrator:

1. Select 'Administrator tools' from the dashboard side panel.

<figure><img src="/files/CzPlgXhvo3orPrSLG5Na" alt=""><figcaption></figcaption></figure>

2. Select 'Manage Issue Labels'.

<figure><img src="/files/Sgih60bnddR3aJpBPhEY" alt=""><figcaption></figcaption></figure>

3. Select 'Add new label'.

<figure><img src="/files/hNlMC6hptvWOXyu3GWMj" alt=""><figcaption></figcaption></figure>

4. Populate the 'Label' name' and 'Description' fields as desired, then select either the Stewardship Organization the label will be used by, or 'Registry-wide'. Registry-wide labels can be used on any item across the registry.

<figure><img src="/files/PYmDR9gw2tQnko5kGaVn" alt=""><figcaption></figcaption></figure>

4. Select 'Create Label'. Once created, labels can be edited and deleted from this screen as well.

<figure><img src="/files/Bce3mGWqHiwmDr90MnrI" alt=""><figcaption></figcaption></figure>

#### As a Stewardship Organization Administrator:

1. Select 'Organisations' from the dashboard side panel.

<figure><img src="/files/xLaSj9D6B0mqSYdqR2nV" alt=""><figcaption></figcaption></figure>

2. Select the Stewardship Organization you wish to create an issue label for.

<figure><img src="/files/kiXLcjCl4aiD0jE1zplU" alt=""><figcaption></figcaption></figure>

3. Select the settings icon.

<figure><img src="/files/eRL8ox9mr8roxgmWrWPv" alt=""><figcaption></figcaption></figure>

4. Select 'Issue Labels'.

<figure><img src="/files/bMsRqE12933pf4wWOSD4" alt=""><figcaption></figcaption></figure>

5. Select 'Add new label', then populate the 'Label name' and 'Description' fields as desired.

<figure><img src="/files/C328aRYoUOnweS1bcgm4" alt=""><figcaption></figcaption></figure>

6. Select 'Create Label', and the label will become available for use within the relevant Stewardship Organization.

<figure><img src="/files/4NHmTSP3p7nXp05VxdTC" alt=""><figcaption></figcaption></figure>


# Creating an issue

Issues act as a platform that allows users to comment on, and propose changes to metadata items. Issues can be assigned a label, to better contextualise or identify them.

### How to create an issue

1. Select the 'Issues' tab from the desired metadata item page.

<figure><img src="/files/zCOIjg9fRX6eQ2d7AxLN" alt=""><figcaption></figcaption></figure>

2. Select 'New Issue', then 'New Issue' from the dropdown.

<figure><img src="/files/qxeE6BDvv81oKnFLaJ2f" alt=""><figcaption></figcaption></figure>

3. Populate the 'Title' and 'Description' fields as desired.

<figure><img src="/files/KHoBVTSid4AQC6hBVmdY" alt=""><figcaption></figcaption></figure>

**Note:** The title (name) of the issue is shown in lists and notifications.

4. **If you wish to add labels to the item**, select those that apply from the 'Labels' field.

<figure><img src="/files/p56O6g2LI9rzrkXAmOG3" alt=""><figcaption></figcaption></figure>

**Notes:**

* If the item does not belong to a Stewardship Organisation, no labels will be available to choose from
* See [*Creating an issue label*](/collaborating-within-the-registry/issues-and-change-requests/creating-an-issue-label) if you need to create a label.

5. Select 'Create Issue'.

<figure><img src="/files/so9Y0IsEy8PuRcnOj83s" alt=""><figcaption></figcaption></figure>


# Viewing all issues

From the 'All Issues' page, users can view all issues that have been created, as well as:

* What labels are assigned to what issues
* What item each issue is assigned to
* When each issue was:
  * Created
  * Updated
* The number of comments on each issue
* Each issue's description
* The stewardship organization of relevant issues.

### How to view all issues

1. Select 'Issues' from the dashboard side panel.

<figure><img src="/files/e42tvxR6Hp0PbjVeOKsT" alt=""><figcaption></figcaption></figure>

2. The 'All Issues' page will now appear, showing all of the issues that you have permission to view, as well as their relevant statistics.

<figure><img src="/files/4QsS2hRtgnkbWjxiWaps" alt=""><figcaption></figcaption></figure>

### Breakdown of the All Issues Page  <a href="#breakdown_of_the_all_issues_page" id="breakdown_of_the_all_issues_page"></a>

**You can search for issues in the search bar:**

* By name
* Through filters
* By issue number.

<figure><img src="/files/uPM7nQQTSuQyS3ux1uVh" alt=""><figcaption></figcaption></figure>

**You can apply filters by selecting a:**

* User
* Workgroup
* Stewardship Organization
* Label.

<figure><img src="/files/oeZtl7VwPpG7SbnN8V6x" alt=""><figcaption></figcaption></figure>

**Notes:**

* In the above example, 'Definition' is the issue's label
* Filters can be removed by selecting the cross on any applied filter once it has appeared beneath the search bar.

**You can toggle between open and closed issues by selecting 'Open' or 'Closed' accordingly.**

<figure><img src="/files/haxsQIkM4Wk4FVrvc9Fa" alt=""><figcaption></figcaption></figure>

**'Issue Name' displays an issue's:**

* Name
* Unique issue number
* Creator
* Workgroup
* Stewardship Organization the issue belongs to
* Labels.

<figure><img src="/files/Lc7CI1XQznIL8v9wPaA9" alt=""><figcaption></figcaption></figure>

**Note:** Unique issue numbers can be searched for in the URL, as well as in the 'All Issues' page's search bar.

**'Item' displays the item an issue is assigned to.**

<figure><img src="/files/HOIYOmXCqvBRhfKT5uqe" alt=""><figcaption></figcaption></figure>

**Note:** Whilst selecting an item here will allow you to view it, it will not open in a new tab.

**'Created' displays the issue's creation time.**

<figure><img src="/files/o3VVFBbYXzrBdmwOdqK3" alt=""><figcaption></figcaption></figure>

**'Updated' displays when the issue was last updated.**

<figure><img src="/files/2kAJw5pXRSMi0h3AffGx" alt=""><figcaption></figcaption></figure>

**'Comments' displays how many comments are attached to the relevant issue.**

<figure><img src="/files/7c9r43iHApvdRQuX9WO8" alt=""><figcaption></figcaption></figure>


# Proposing a change request

Issues can also be used by users to suggest changes to an item, via the 'propose change' feature. This is useful for users who are providing feedback to a metadata item, but do not have permission to edit the item. Suggestions can be made for every field of the item editor that can be accessed on an item's creation.

### **Prerequisites**

For a user to propose, or approve changes to a workgroup item, the appropriate permissions must be active in the relevant workgroup's settings tab (below).

<figure><img src="/files/Kl6wWj8dX5zLVSxHjrKh" alt=""><figcaption></figcaption></figure>

### How to propose a change request

1. Navigate to the desired metadata item's 'Issues' tab.

<figure><img src="/files/dnfbbxHe5A9yuDogcUF8" alt=""><figcaption></figcaption></figure>

2. Select 'New Issue', then 'Propose Change'.

<figure><img src="/files/7WzVNyrbVVcCsFFRxb3V" alt=""><figcaption></figcaption></figure>

**Note:** A change can also be proposed to an existing issue by the issue from the 'Issues' tab, then selecting 'Edit proposed changes' (below).

<figure><img src="/files/AfAJWOBYVoClxzoD3B0C" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/RtpfT3cd3kMGWfG6HCRZ" alt=""><figcaption></figcaption></figure>

3. Populate the following tabs in accordance to the changes you wish to propose to the metadata item:
   * 'Definition'
   * 'Names & References'
   * 'Components'
   * 'Slots'
   * 'Identifiers'

<figure><img src="/files/8gMCm94Pg1EBUaeH5Q5U" alt=""><figcaption></figcaption></figure>

4. Select 'Save changes'.

<figure><img src="/files/9ybhulIPc5d9ykNZMO5j" alt=""><figcaption></figcaption></figure>

5. Your change proposal will be saved as a new issue with a title reflecting your proposed changes. **To rename the issue**, select it, then select 'Edit issue name'.

<figure><img src="/files/rHiud698p6c5xui3sODX" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/UUDfAuCrMWK1ylbXVLn2" alt=""><figcaption></figcaption></figure>

**Notes:**

* You can select the name of your proposed change to see a list of fields that include the proposed changes (below)
* When a change is proposed, a notification will appear in all workgroup members' registry notifications page.

<figure><img src="/files/AqZH4aAjHaGdcFafQdAY" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/izh0DHbl8Dux9X4GUPqO" alt=""><figcaption></figcaption></figure>


# Metadata History: Comparing change logs

In the Aristotle metadata registry, we can view and compare the change logs for each metadata item. The history/compare feature enables us to track these change logs with additional details, such as the user who made a change and the specific modifications made.

Follow the steps below to view the history of a metadata item and compare the change logs:

1. Navigate to the metadata item page you want to see or compare change logs for. For instance, I am on the 'Northwind Dataset' item page. On the item page, click on the 'History' tab.

<figure><img src="/files/o5qQdYLJhanhfbjau07q" alt=""><figcaption></figcaption></figure>

2. You will see a list of all the changes to the metadata item page here, with additional details like Date/time, User, Comments, and visibility settings. Select the two change logs that you want to compare and click on the compare button.

<figure><img src="/files/ej9ljX0IfrgK4sRdGjZy" alt=""><figcaption></figcaption></figure>

3. On this page, you will see highlighted text in red and green. The green color indicates what has been added, while the red color indicates what has been removed or deleted in the selected change logs.

<figure><img src="/files/NsZ9QLhDIyHeRn0ZyyYB" alt=""><figcaption></figcaption></figure>

That's how we can keep track of and compare the change logs for any metadata item.


# Registration Authorities

A registration authority is defined as a unique framework of authority within which individuals act, or are designated to act, towards some purpose. This are represented in Aristotle as a body of users within a Stewardship Organisation that have the authority to review, publish and adjust the visibility of the metadata items of that Stewardship Organisation.

When a user requests an item undergo a review, it is the members of the chosen registration authority that review it.

## Registration authority functionality

Registration authorities can be:

* Created and edited
* Used to endorse content:
  * Automatically, via validation rules
  * Manually, via:
    * Reviews
    * Direct Administrator publication

Stewardship Organisation Administrators and Registry Administrators can add users to a Registration authority and assign them roles.


# Creating and editing registration authorities

{% hint style="info" %}
Registration authorities can only be created or edited by Stewardship Organisation Administrators, or Registry Administrators.
{% endhint %}

Registration authorities are created within a Stewardship Organisation, the metadata items of which it will generally be responsible for reviewing and endorsing. After creation, registration authorities' basic details, registration states and validation rules can be edited.

### How to create registration authorities

1. Select 'Browse' from the registry header.

<figure><img src="/files/Fu6c4ukvx8JK9ysxcMeQ" alt=""><figcaption></figcaption></figure>

2. Select 'Browse' from the 'Stewardship Organisations' field.

<figure><img src="/files/Lisu2zxaIn67EX1Mr08U" alt=""><figcaption></figcaption></figure>

3. Select the Stewardship Organisation you wish to create a registration authority for from the list.

<figure><img src="/files/jlEuxOEaUdYXaZzlInLs" alt=""><figcaption><p>\</p></figcaption></figure>

4. Select the 'Registration Authorities' tab.

<figure><img src="/files/hkYUExVKQnlJCVkctRQ6" alt=""><figcaption></figcaption></figure>

5. Select 'Add New Registration Authority'.

<figure><img src="/files/3Kf5mbtiKpqR2dTwm3c9" alt=""><figcaption></figcaption></figure>

6. Populate the 'Name' and 'Definition' fields as desired.

<figure><img src="/files/CcPQ1ys3KZCsriRHYsCK" alt=""><figcaption></figcaption></figure>

7. Select 'Create new Registration Authroity'.

<figure><img src="/files/wFrVE9xyaVl32v7qCG8d" alt=""><figcaption></figcaption></figure>

8. The new registration authority will appear in the relevant Stewardship Organisation's 'Registration Authorities' tab.

<figure><img src="/files/ILW0q4WZkBORg3wm6csX" alt=""><figcaption></figcaption></figure>

### How to edit registration authorities

1. Select 'Browse' from the registry header.

<figure><img src="/files/Fu6c4ukvx8JK9ysxcMeQ" alt=""><figcaption></figcaption></figure>

2. Select 'Browse' from the 'Stewardship Organisations' field.

<figure><img src="/files/Lisu2zxaIn67EX1Mr08U" alt=""><figcaption></figcaption></figure>

3. Select the Stewardship Organisation you wish to edit a registration authority of from the list.

<figure><img src="/files/jlEuxOEaUdYXaZzlInLs" alt=""><figcaption></figcaption></figure>

4. Select the 'Registration Authorities' tab.

<figure><img src="/files/hkYUExVKQnlJCVkctRQ6" alt=""><figcaption></figcaption></figure>

5. Select the registration authority you wish to edit.

<figure><img src="/files/rVMOTps7RkFAy1xO6OIH" alt=""><figcaption></figcaption></figure>

6. Select the 'Settings' tab.

<figure><img src="/files/FVed2b03wcbGBGcP2X3c" alt=""><figcaption></figcaption></figure>

7. **If you wish to make changes to the registration authority's name, visibility state or definition**, do so via the relevant fields of the 'General ' tab, then select 'Save changes'.

<figure><img src="/files/4NfdKOoRGZImvlvOEBzH" alt=""><figcaption></figcaption></figure>

**Note:** The options presented in the 'State' dropdown are as follows:

* 'Active & Visible': The registration authority is able to be used to endorse content, and is visible to users with permission to see it
* 'Deactivated & Visible': The registration authority is unable to be used to endorse content, but is still visible to users with permission to see it
* 'Deactivated & Hidden': The registration authority is unable to be used to endorse content, and is only visible to Stewardship Organisation Administrators and Registry Administrators.

8. **If you wish to make changes to registration states for this authority**, select the 'States' tab. **If you do not wish to make changes to registration states for this authority**, proceed to step 11.

<figure><img src="/files/LAnGrcK7INPSmS8o7AZB" alt=""><figcaption></figcaption></figure>

9. Adjust the visibility status, editing status and description of the registration authority's statuses as desired using the relevant fields.

<figure><img src="/files/31KDfFW2WLHjuTe2qYdZ" alt=""><figcaption></figcaption></figure>

**Note: Excluding Registry Administrator permissions**, the meaning of the registration state settings are as follows:

* Visibility statuses:
  * Registration Authority Only: The endorsed item can be viewed by Registration Authority Managers and Registrars
  * Workgroup: The endorsed item can be viewed by all members of the workgroup it belongs to
  * Steward Organisatio&#x6E;*:* The endorsed item can be viewed by all members of the Stewardship Organisation that it belongs to
  * Authenticated users: The endorsed item can be viewed by all registry users that are logged in
  * Public: The endorsed item can be viewed by anyone with access to the registry.
* Editing statuses:
  * Locked. The endorsed item can be edited by stewards of the:
    * Workgroup it belongs to
    * Stewardship Organisation that it belongs to
  * Unlocked: The endorsed item can be edited by all users that would normally have permission to edit the item.

10. Select 'Save'.

<figure><img src="/files/8hWg1VOUa6T32PMLBaCh" alt=""><figcaption></figcaption></figure>

11. **If you wish to set validation rules for the registration authority**, select 'Validation Rules'.

<figure><img src="/files/mzr0E9HlOpuANjPdRhYv" alt=""><figcaption></figcaption></figure>

12. [Write your desired validation rule(s)](/registration-authorities/creating-and-editing-registration-authorities/validation-rules/setting-validation-rules/writing-validation-rules) into the 'Rules' field, then select 'Submit'.

<figure><img src="/files/ZXLwEdUa31NWeVxsBBHJ" alt=""><figcaption></figcaption></figure>

**Note:** For information regarding validation rules and how to write them, see [Validation Rules](/registration-authorities/creating-and-editing-registration-authorities/validation-rules) and its relevant procedures.


# Validation Rules

{% hint style="info" %}
Registration Authority validation rules can only be written and assigned by Registration Authority Managers and Registrars, or Registry Administrators.

Registry-wide validation rules can only be written and assigned by Registry Administrators.
{% endhint %}

Validation Rules allow Registration Authority Managers and Registrars to set business rules for metadata within their Registration Authority, or Registry Administrators to set registry-wide rules for all content.

Validation Rules can be used to specify:

* Mandatory fields
* Uniqueness of fields
* Length of fields
* Formats of names.

### Validation Rule Functionality

Validation rules can be:

* Written (as [YAML](https://en.wikipedia.org/wiki/YAML) regular expressions)
* Assigned to either:
  * A Registration Authority
    * Whether a metadata item passes or fails a Registration Authority validation rule's checks, this will display against its [review request](/collaborating-within-the-registry/opening-a-review) when one is opened using that Registration Authority
    * Validation rules can only be written for Registration Authorities by Managers or Stewards of that Registration Authority, or Registry Administrators
  * The entire registry
    * When a registry-wide validation rule is written, it will apply to any and all metadata items that fit its criteria, and display its checks against those items' review requests when one is opened using any Registration Authority
    * Registry-wide validation rules can only be written by Registry Administrators.


# Setting validation rules

{% hint style="info" %}
Registration Authority validation rules can only be written and assigned by Registration Authority Managers and Registrars, or Registry Administrators.

Registry-wide validation rules can only be written and assigned by Registry Administrators.
{% endhint %}

Validation Rules allow Registration Authority Managers and Registrars to set business rules for metadata within their Registration Authority, or allow Registry Administrators to set registry-wide rules for all content.

Validation Rules can be used to specify:

* Mandatory fields
* Uniqueness of fields
* Length of fields
* Formats of names.

### How to assign a validation rule to a Registration Authority <a href="#how_to_create_validation_rules_for_a_registration_authority" id="how_to_create_validation_rules_for_a_registration_authority"></a>

1. Select 'Browse' from the registry header.

<figure><img src="/files/sEQOjIVR0aUvAsjvz1Di" alt=""><figcaption></figcaption></figure>

2. Select the icon for 'Registration Authorities', or 'Browse' beneath it.

<figure><img src="/files/HJsULJYx0W9cZ3v1Ta8q" alt=""><figcaption></figcaption></figure>

3. Select the Registration Authority you wish to write a validation rule for.

<figure><img src="/files/eLlqJLudjJNkRIHbM6HQ" alt=""><figcaption></figcaption></figure>

4. Select the 'Settings' tab.

<figure><img src="/files/bkjpcMg9QkarTFmqtAOu" alt=""><figcaption></figcaption></figure>

5. Select 'Validation Rules'.

<figure><img src="/files/iaeCAdoLzsmSZdfEAFxK" alt=""><figcaption></figcaption></figure>

6. [Write your desired validation rule(s)](/registration-authorities/creating-and-editing-registration-authorities/validation-rules/setting-validation-rules/writing-validation-rules) into the 'Rules' field, then select 'Submit'.

<figure><img src="/files/IBaxNWtHzf4AHbj8MLIU" alt=""><figcaption></figcaption></figure>

### How to assign a registry-wide validation rule

1. Select 'Administrator tools' from the dashboard side panel.

<figure><img src="/files/Shfce3rDpEUXCJjQ8Zwi" alt=""><figcaption></figcaption></figure>

2. Select 'Manage Registry Validation Rules'.

<figure><img src="/files/nbRJvsZa6GhdaE2omWhf" alt=""><figcaption></figcaption></figure>

3. [Write your desired validation rule(s)](/registration-authorities/creating-and-editing-registration-authorities/validation-rules/setting-validation-rules/writing-validation-rules) into the 'Rules' field, then select 'Submit'.

<figure><img src="/files/1Ro7uGoMZ52vgiAfcgef" alt=""><figcaption></figcaption></figure>


# Writing validation rules

{% hint style="info" %}
Registration Authority validation rules can only be written and assigned by Registration Authority Managers and Registrars, or Registry Administrators.

Registry-wide validation rules can only be written and assigned by Registry Administrators.
{% endhint %}

Validation rules are written as [YAML](https://en.wikipedia.org/wiki/YAML) configuration files, and represent a single or series of checks against any metadata item that fits their criteria. A validation rule*set* refers to a collection of validation rules.

## Validation rule structure

The two mandatory elements of a validation rule are its **status** and its **checks**. Validation rules may also include an **object**, which specifies the metadata item type the rule will be applied to, but this element is non-mandatory.

Below is an example of a validation rule that includes all three of these elements:

```
- status: Standard
  object: DataElement
  checks:
    - validator: RegexValidator
      name: "Starts with a capital letter"
      severity: warning
      field: name
      regex: "[A-Z].+"
```

## How to write a validation rule's status

&#x20;A validation rule's status defines which metadata items the rule will apply to by looking for matching endorsement statuses in those items.

If a rule's status is set to 'Standard', for example, it will only run its checks against metadata items endorsed as 'Standard' by the relevant Registration Authority, or by any Registration Authority if the validation rule is registry-wide.

Valid statuses include:

* `any`: The validation rule will apply to all endorsed metadata items
* `Not Progressed`
* `Incomplete`
* `Candidate`
* `Recorded`
* `Qualified`
* `Standard`
* `Preferred Standard`
* `Superseded`
* `Retired`.

## How to write a validation rule's checks

A validation rule's checks represent the specific attributes that the rule checks for in any metadata items it applies to.

**Note:** Because a check exists inside a rule, it must be appropriately indented.

Checks have their own structure, and must include a **validator** and a **severity**. Checks may also include a **name**, but this element is non-mandatory. These elements are defined below:

### Validators

Currently available validators include:

* RegexValidators
* RelationValidators
* UniqueValuesValidators
* StatusValidators

#### RegexValidators

A `RegexValidator` checks the formatting of text fields via a specified '[regular expression](https://en.wikipedia.org/wiki/Regular_expression)' ('regex'). RegexValidators look for specific information inside metadata item fields, and require two additional elements be added to a validation rule to run:

* `field`: The name of the metadata item field being checked (in accordance to the registry API or GraphQL)
* `regex`: The rule that the chosen field is checked against. As a regex can include special characters, it's recommended to enclose it in quotation marks
  * Helpful regexes include:
    * Character regexes:
      * `.`: Any single character
      * `[A-Z]`: Any single uppercase letter
      * `[a-z]`: any single lowercase letter
      * `[A-Za-z]`: Any uppercase or lowercase letter
      * `[0-9]`: Any single digit
      * `[0-9A-Za-z]`: Any number, uppercase or lowercase letter.
    * Repetition regexes:
      * `?`: Match 0 or 1 of the previous token. E.g. `[A-Z]?` will match `""` (any empty string) or any single uppercase character
      * `*`: Match 0 or more of the previous token. E.g. `[A-Z]*` will match any number of uppercase characters
      * `+`: Match 1 or more of the previous token. E.g. `[A-Z]+` will match a string with at least one uppercase character.
    * Positioning regexes:
      * `^`: Match at the start of the line. E.g. `^A` will only match if a string starts with a capital A
      * `$`: Match at the end of the line. E.g. `Z$` will only match if a string ends with a capital Z.

Examples of rules containing RegexValidators include:

* Testing that a standard data element concept:
  * Starts with a capital letter
  * Includes a colon between the object class and property in its name.

```
- status: Standard
  object: DataElement
  checks:
    - validator: RegexValidator
      name: "Starts with a capital letter"
      severity: warning
      field: name
      regex: "[A-Z].+"
```

**Note:** The regex '.+' specifies any character ( . ), repeated any number of times ( + ).

* Testing that a standard data element has a definition of at least 100 characters

```
- status: Standard
  object: DataElement
  checks:
    - validator: RegexValidator
      name: Definition must be longer than 100 characters
      severity: warning
      field: name
      regex: ".{100,}"
```

**Note:** Regex syntax can vary between programming environments. **The examples above use Python**.

#### RelationValidators

A `RelationValidator` checks whether specified metadata is attached to an item. RelationValidators require an additional element be added to a validation rule to run:

* `field`: The name of the metadata item field being checked (in accordance to the registry API or GraphQL). This must be a field that contains relation to another metadata item.

An example of a rule containing a `RelationValidator` can be found below:

* Testing that a data element has an associated value domain.

```
- status: Recorded
  object: DataElement
  checks:   
    - validator: RelationValidator
      severity: error
      field: valueDomain
      name: Value Domain should be linked to Data Element
```

#### UniqueValuesValidators

A `UniqueValuesValidator` checks whether value domains have unique values. Aristotle does not restrict the values used for codes in value domains; UniqueValuesValidators can be used to accommodate by checking that value domains have codes that are all unique.

An example of a rule containing a `UniqueValuesValidator` can be found below:

* Testing whether a value domain contains unique values.

```
- status: Recorded
  object: ValueDomain
  checks:   
    - validator: UniqueValuesValidator
      severity: error
      field: valueDomain
      name: Value Domain must have unique values
```

**Note:** This validator tests all permissible and supplementary values.

#### StatusValidators

A `StatusValidator` checks the status lifecycle of a metadata item. This can be used to confirm whether an item that has been endorsed as a certain status has met any business-required prerequisite statuses before this was done. StatusValidators require an additional element be added to a validation rule to run:

* `status`: A list of statuses that an item must have been endorsed as at least one of immediately prior to it being endorsed as its current status.

An example of a rule containing a `StatusValidator` can be found below:

* Testing that all metadata items have been endorsed as either 'recorded' or 'candidate' before 'standard'.

```
- status: Standard
  checks:   
    - validator: StatusValidator
      name: Candidate or Recorded -> Standard
      description: Metadata should progress along the lifecycle correctly
      severity: warning
      status:
        - Candidate
        - Recorded
```

## Example ruleset

Below is a small collection of valid validation rules for your reference or use:

```
- status: any
  object: Indicator
  checks:
    - validator: RegexValidator
      name: "Name starts with Proportion of"
      severity: error
      field: name
      regex: "^Proportion of.*"
    - validator: RegexValidator
      name: "Name starts with Proportion of"
      severity: error
      field: name
      regex: "^Number of.*"
    - validator: RegexValidator
      name: "Rationale must not be empty"
      severity: error
      field: rationale
      regex: "^.(?:.|\\s)+$"
    - validator: RegexValidator
      name: "Computation description must not be empty"
      severity: error
      field: computation_description
      regex: "^.(?:.|\\s)+$"
    - validator: RegexValidator
      name: "Computation must not be empty"
      severity: error
      field: computation
      regex: "^.(?:.|\\s)+$"
    - validator: RegexValidator
      name: "Origin must not be empty"
      severity: error
      field: origin
      regex: "^.(?:.|\\s)+$"
```

```
- status: any
  object: DataElementConcept
  checks:
    - validator: RegexValidator
      name: "Name pattern must include a colon separator"
      severity: error
      field: name
      regex: ".+: .+"
    - validator: RelationValidator
      severity: error
      field: objectClass
      name: "Object Class linked to Data Element Concept"
    - validator: RelationValidator
      severity: error
      field: property
      name: "Property linked to Data Element Concept"
```

```
- status: any
  object: DataElement
  checks:
    - validator: RegexValidator
      name: "Name pattern must include a colon separator"
      severity: error
      field: name
      regex: ".+: .+"
    - validator: RegexValidator
      name: "Name pattern must include a comma"
      severity: error
      field: name
      regex: ".+, .+"
    - validator: RelationValidator
      severity: error
      field: valueDomain
      name: "Value Domain linked to Data Element"
    - validator: RelationValidator
      severity: error
      field: dataElementConcept
      name: "Data Element Concept linked to Data Element"
```


# Directly endorsing metadata items

{% hint style="info" %}
Metadata items can only be directly endorsed by Stewardship Organisation Administrators, or Registry Administrators.
{% endhint %}

Registry Administrators can directly apply a registration status to a metadata item using the registration authority of their choosing, rather than needing to submit the item for review first.

### How to directly endorse a metadata item

1. Navigate to the metadata item you wish to endorse and select its 'Actions' dropdown.

<figure><img src="/files/HirA8RYAUkquTqB2yjvC" alt=""><figcaption></figcaption></figure>

2. Select 'Add registration status'.

<figure><img src="/files/8ZCeYNakEJcjeQ0JrhMC" alt=""><figcaption></figcaption></figure>

3. Select the date the registration state will be active from via the 'Registration date' field.

<figure><img src="/files/e3mj0PzE75bMkCW7RFLv" alt=""><figcaption></figcaption></figure>

4. Select whether the metadata item's related items will also be endorsed via the 'Cascade registration' field.

<figure><img src="/files/CozbGCi9bVfhoxle0itk" alt=""><figcaption></figcaption></figure>

5. Select the registration authority that the item will be endorsed by.

<figure><img src="/files/w6dCaEQbFzE0UN7Fjfpu" alt=""><figcaption></figcaption></figure>

6. Select the state the content will be endorsed as via the 'State' dropdown.

<figure><img src="/files/gwCSxNu4TEsswToJIkxH" alt=""><figcaption></figcaption></figure>

7. **If you wish to leave an administrative note**, so do using the 'Administrative Note' field.

<figure><img src="/files/4Nu69PGidoubYpAnXrG8" alt=""><figcaption></figcaption></figure>

8. Select 'Review and apply status changes'.

<figure><img src="/files/BRRgSF2lTsjdppcIwVhE" alt=""><figcaption></figcaption></figure>

9. Review your choices, then select either instance of 'Apply selected statuses' once satisfied.

<figure><img src="/files/Ms7StNvWYdPhWFjMhW7S" alt=""><figcaption></figcaption></figure>

10. If your selected 'Registration date' was today, or has otherwise passed, the endorsement status will appear in the item's infobbox.

<figure><img src="/files/CpxsEu1AAf555IIM9C9B" alt=""><figcaption></figcaption></figure>


# Managing members of a registration authority

{% hint style="info" %}
Registration authority members can only be added, or have their roles changed by a Registration Authority Manager, a Stewardship Organisation Administrator or a Registry Administrator.
{% endhint %}

Users can be added to registration authorities in order to view the registration authority's information, review and endorse metadata submitted to that registration authority, or manage the registration authority's settings and other details.

### How to add users to a registration authority

1. Select 'Browse' from the registry header.

<figure><img src="/files/oS18rl9tNMaB3g2vjHbU" alt=""><figcaption></figcaption></figure>

2. Select 'Browse' from the 'Registration Authorities' field.

<figure><img src="/files/21RcJPsdHFADDrmbg8cL" alt=""><figcaption></figcaption></figure>

3. Select the registration authority you wish to add a user to.

<figure><img src="/files/X6hmw6CigMq3j2HINFsz" alt=""><figcaption></figcaption></figure>

4. Select the 'Members' tab.

<figure><img src="/files/YfmDarwJpah9btjTkYll" alt=""><figcaption></figcaption></figure>

5. Select 'Add a member'.

<figure><img src="/files/hDrx84SAwASs1QWwC1zU" alt=""><figcaption></figcaption></figure>

6. Populate the 'Users' field with the name of the user(s) you wish to add to the registration authority, then select them when they appear.

<figure><img src="/files/N6te9qbSDBw8brHt8BGk" alt=""><figcaption></figcaption></figure>

**Notes:**

* To remove a user from the 'Users' field, select the 'x' beside their profile picture
* Only users that are members of the owning stewardship organisation can be added to a registration authority.

7. Select the role(s) you want the new member(s) to have via the 'Role' field. The available roles are defined as:
   * Manager: Can edit all details of the registration authority, as well as approve reviews to endorse metadata items
   * Registrar: Can approve reviews to endorse metadata items
   * Viewer: Can view information about the registration authority and any reviews requested of it, but cannot interact with any of this information.

<figure><img src="/files/oTo16zvqQQtcCNnAPEII" alt=""><figcaption></figcaption></figure>

8. Select 'Add member'.

<figure><img src="/files/zd07PA2Jxufi99zkjunK" alt=""><figcaption></figcaption></figure>

9. The new member(S) will now appear on the 'Members' tab.

<figure><img src="/files/HFdvdZEX9KufMAm8Xw6h" alt=""><figcaption></figcaption></figure>

### How to change a user's role within a registration auithority

<figure><img src="/files/oS18rl9tNMaB3g2vjHbU" alt=""><figcaption></figcaption></figure>

2. Select 'Browse' from the 'Registration Authorities' field.

<figure><img src="/files/21RcJPsdHFADDrmbg8cL" alt=""><figcaption></figcaption></figure>

3. Select the registration authority you wish to add a user to.

<figure><img src="/files/X6hmw6CigMq3j2HINFsz" alt=""><figcaption></figcaption></figure>

4. Select the 'Members' tab.

<figure><img src="/files/YfmDarwJpah9btjTkYll" alt=""><figcaption></figcaption></figure>

5. Select the cog icon from the row of the user whose role you wish to change.

<figure><img src="/files/qv2CSdtbnbEBbKXKJJ1d" alt=""><figcaption></figcaption></figure>

6. Select 'Change role'.

<figure><img src="/files/WEuVcHt8u3ArqHj3kZzF" alt=""><figcaption></figcaption></figure>

7. Select the role you'd like the selected user to have from the 'Role' field.

<figure><img src="/files/dYeT818dnG6DxB8EFuph" alt=""><figcaption></figcaption></figure>

8. Select 'Change roles'.

<figure><img src="/files/IVLGu4Krv2nMKSNu26Q5" alt=""><figcaption></figcaption></figure>

9. The user's new role will now display in their row of the 'Members' tab.

<figure><img src="/files/vHSaPgANmXUNK9IVx0Pm" alt=""><figcaption></figcaption></figure>


# Viewing and editing a metadata item's registration history

{% hint style="info" %}
Registration histories can only be viewed by Registry Administrators.

Registration histories can only be edited by the relevant registration authority's registrars and managers, or Registry Administrators.
{% endhint %}

Any metadata item's registration history can be viewed by users with permission to see the item via its infobox.

## How to view and edit a metadata item's registration history

1. Navigate to the desired item, then select 'View registration history' from its infobox. The item's registration history will be displayed.

<figure><img src="/files/TMLlYsPXZViJCVZXnTOS" alt=""><figcaption></figcaption></figure>

**Note:** Users will only see registration history entries that correspond to a status they are able to see with their current permissions.

2. **If you wish to edit a registration history entry**, select 'Manage', then 'Edit' from the row of the status you wish to edit. **If you do not wish to edit a registration history entry**, proceed to step 8.

<figure><img src="/files/WWFxDotKjHSLrkOwJADm" alt=""><figcaption></figcaption></figure>

3. Configure the entry's 'Registration date' and 'Expiration date' fields as desired.

<figure><img src="/files/Wqcu6dEGI2dpMEvm8xag" alt=""><figcaption></figcaption></figure>

4. Select the status you would like the relevant entry to be listed as via the 'State' field.

<figure><img src="/files/Vn3garowFMXMNAaNAGDL" alt=""><figcaption></figcaption></figure>

5. **If you wish to add/change a note for this entry**, do so via the 'Administrative note' field.

<figure><img src="/files/dtnyX9wnZbszRop6KgjL" alt=""><figcaption></figcaption></figure>

6. **If you wish to provide a rationale for your edits**, do so via the 'Change message' field.

<figure><img src="/files/f0RteptjDm5wKpiJlPBt" alt=""><figcaption></figcaption></figure>

7. Select 'Update Status' once satisfied.

<figure><img src="/files/mzLWpl3G1YuWoKnIpzIM" alt=""><figcaption></figcaption></figure>

8. **If you wish to view the history of a specific entry**, select 'Manage'. then 'Check Status History' from the relevant entry's row. A full change history will be shown for the relevant entry.

<figure><img src="/files/3kSwmvP6jOPYoe38ykSf" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/4MuOv0HRARJXqdFX1fWE" alt=""><figcaption></figcaption></figure>

**Note:** Status history can only be checked by Registry Administrators.


# Administrator Tasks


# Managing user accounts

{% hint style="info" %}
User accounts can only be managed by a registry Administrator.
{% endhint %}

Registry administrators can access, deactivate, manage and edit the accounts of registry users, as well as invite new users to the platform.

## How to access user accounts  <a href="#how_to_manage_user_accounts" id="how_to_manage_user_accounts"></a>

As an Administrator of the Registry you have the ability to manage user accounts.

To access user accounts:

1\. From your Dashboard side panel, select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcn09b97cffdce744d2b5c4cb98248d8839" alt="" data-size="line"> <mark style="color:blue;">.</mark>

<figure><img src="/files/wHxCH1IY2BBsaFtuez0n" alt=""><figcaption></figcaption></figure>

2\. Select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcn30082df3cf1f45d0bf8ed5db5f2fdddc" alt="" data-size="line"> from the Manage Registry list, and from here you will see a list of all the users within the Registry.

<figure><img src="/files/ylLGuwxCnJELJnhxSEK4" alt=""><figcaption></figcaption></figure>

### Inviting new users  <a href="#inviting_new_users" id="inviting_new_users"></a>

From the Current members of the Registry page:

1\. Select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcn93507c7ee9934a63971a6ef6041a63cf" alt="" data-size="line">&#x20;

<figure><img src="/files/jA9DSGD0WVIXtCrfctAV" alt=""><figcaption></figcaption></figure>

2\. Fill in emails of users you would like to invite to the Registry. Make sure you only put one email per line.

<figure><img src="/files/MpimeEPxAB98Tf0mMtXo" alt=""><figcaption></figcaption></figure>

3\. Select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcn212058b3467a4fd1be444b597e098e05" alt="" data-size="line"> once done and the users will receive an activation email.&#x20;

### Deactivating a user <a href="#deactivating_a_user" id="deactivating_a_user"></a>

{% hint style="info" %}
When a user has been deactivated they will no longer be able to log into the Registry.
{% endhint %}

From the Current members of the Registry page:

1. Search for the name of the user you wish to deactivate in the search bar.

<figure><img src="/files/ilii9maEijqcSm36kYdO" alt=""><figcaption></figcaption></figure>

2\. Select the <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcndd0b4b6cdd2e4ea6ae6820608c81e643" alt="" data-size="line"> button next to the users name and then 'Deactivate this user'.

<figure><img src="/files/t4amaOaGg5UQlLL0k9v4" alt=""><figcaption></figcaption></figure>

3\. You will receive a warning page before deactivating a users account.

<figure><img src="/files/uDh2WAKbAGmHESH0kniz" alt=""><figcaption></figcaption></figure>

4\. Select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcn1892b9ab129b44f4936cf7c0d45aa6b5" alt="" data-size="line"> and the user will be deactivated in the Registry.

### Managing user accounts <a href="#managing_user_accounts" id="managing_user_accounts"></a>

#### Permissions <a href="#permissions" id="permissions"></a>

From the Current members of the Registry page:

1\. Select the <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcn9624208a18154a7384f75cf0615ad108" alt="" data-size="line"> button next to the user's name and then 'Change site-wide permissions'.

<figure><img src="/files/Dw0qr7k7uZWAkVSJ9cJD" alt=""><figcaption></figcaption></figure>

2\. You will be able to change the user's permissions for the whole Registry:

<figure><img src="/files/CcUxxmPrffnUcRs47SEP" alt=""><figcaption></figcaption></figure>

### Sandbox

From the Current members of the Registry page:

1\. Select the <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcn9624208a18154a7384f75cf0615ad108" alt="" data-size="line"> button next to the users name and then 'View profile'.

<figure><img src="/files/BBfNkwJ0YpYgQCXEbnv4" alt=""><figcaption></figcaption></figure>

You will be taken to the user's Profile page:

<figure><img src="/files/Qf11ug1RJtwUOiFfxoAV" alt=""><figcaption></figcaption></figure>

2\. Under 'Actions', select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcnca85bd3c7d084b439197553f13201b5b" alt="" data-size="line"> and you will be taken to a view of the users Sandbox.

<figure><img src="/files/gxLvPllnXvyJ6Q8wCU8x" alt=""><figcaption></figcaption></figure>

### Edit user profile <a href="#edit_user_profile" id="edit_user_profile"></a>

From the 'Current members of this Registry' page:

1\. Select the <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcn9624208a18154a7384f75cf0615ad108" alt="" data-size="line"> button next to the users name and then 'Edit profile'.

<figure><img src="/files/JvgRcHQ957oACGMYQdH7" alt=""><figcaption></figcaption></figure>

You will be able to edit:\
The users email address, the user's full name, the users display name and the users profile picture.

<figure><img src="/files/Fy20O2NJW8ouvaBWctYu" alt=""><figcaption></figcaption></figure>

2\. Once done, select 'Save Changes'.


# Creating and maintaining a Stewardship Organization

{% hint style="info" %}
Stewardship Organizations can only be created and maintained by a registry Administrator.
{% endhint %}

### How to create a Stewardship Organization <a href="#how_to_create_a_stewardship_organisation" id="how_to_create_a_stewardship_organisation"></a>

1. Go to 'Administrator Tools' at the bottom of the Dashboard side menu.

<figure><img src="/files/2ywQAX9IUaRrWhTSjcx9" alt=""><figcaption></figcaption></figure>

2\. Select 'Manage Stewardship Organizations'.

<figure><img src="/files/Kz6A9ATJlajO8aPRIGwk" alt=""><figcaption></figcaption></figure>

3\. Select 'Add Organization'.

<figure><img src="/files/w3lAuZcFPlYrJzbqQDah" alt=""><figcaption></figcaption></figure>

4\. Add in a Name for the Stewardship Organization and a Definition.

<figure><img src="/files/AN7JBt7joj3Iqa0hpmu7" alt=""><figcaption></figcaption></figure>

5\. Once done, select <img src="/files/PVdFFmuA8OnfuhdxN3qb" alt="" data-size="line">. You will be taken to the new Stewardship Organization page.

<figure><img src="/files/rDRVMm3fDqcZtm1drQcT" alt=""><figcaption></figcaption></figure>

### Maintaining a Stewardship Organization  <a href="#maintaining_a_stewardship_organisation" id="maintaining_a_stewardship_organisation"></a>

#### Stewardship Organization settings  <a href="#stewardship_organisation_settings" id="stewardship_organisation_settings"></a>

1\. To get to a Stewardship Organizations settings, select the ![](/files/tvOkFqKXUpqWpAEmO0Yp) icon.

<figure><img src="/files/WyKtXhwgeqfMkBobqCeO" alt=""><figcaption></figcaption></figure>

2\. In the ![](/files/ZB4iax5mytNyHcUpRRv1)tab settings, you can change or add:

* Slug - This is what shows up in the URL for the Stewardship Organization (SO).
* Name - You can change the name of the SO.
* State - This is where you can change the visibility of this SO.
  1. 'Active' means this SO is active and visible to all uses of the Registry.&#x20;
  2. 'Private' means this SO is only visible to users who are members of this SO.
  3. 'Deactivated & Visible' means this SO is visible to all users of the Registry, but content cannot be added into this SO.
  4. 'Deactivated and Hidden' means this SO is only visible to Admins of the Registry, and content cannot be added into this SO.&#x20;

<figure><img src="/files/8DVgdDwX3pDZmBpsyxxT" alt=""><figcaption></figcaption></figure>

* Definition - You can change the definition of the SO.
* Profile picture - You can add a profile picture for the SO, this will be visible on the Browse page and the SO's Homepage.
* Banner image - You can add a banner image, this will show up above the definition on the SO's Homepage.
* External URL - You can add an external URL that will show up under the profile picture on the SO's Homepage.&#x20;

3\. In the ![](/files/Pb6lhTH1UHzf4xDibjg5)tab, you can see how many users per role are in the SO.

<figure><img src="/files/4qMfQBKj7skQ8DyfqI7Q" alt=""><figcaption></figcaption></figure>

4\. In the ![](/files/Th9l6SQctBr0b0ui6T9W)tab, you can add in auto signup for specific email extensions. Users who are **invited** to join the Registry that have the email extensions specified in the SO's Allowed Domains will have the option, when creating their account, to join the SO.&#x20;

<figure><img src="/files/CW8yUvQUbFtCmsEA6X0Y" alt=""><figcaption></figcaption></figure>

The 'Role for automatically joining users' is where you can set the role for users who automatically sign up to the SO. You can only set up one role for all the allowed domains, but this can be changed at any time.

<figure><img src="/files/PasCBpB523F0lBegOyeb" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/0yPANPFoJTb3yeMN88XX" alt=""><figcaption></figcaption></figure>

5\. In the![](/files/CkpIppkTFWnct4m5cVpD) tab, you can add a new label that can be attached to Issues when they are created.

<figure><img src="/files/YH7j9AyIzG6Ha6c3AS7K" alt=""><figcaption></figcaption></figure>

You can also Edit and Delete the Issue labels from here.

<figure><img src="/files/FuAeDFLJAWdeTbJg26JL" alt=""><figcaption></figcaption></figure>

6\. In the <img src="/files/EvLUyWkhABuGjeYDVOCh" alt="" data-size="original">tab, Alternative names can be used to change the displayed name for metadata when downloading metadata, and will rank higher in search results.

Examples of alternative names can include a "Physical name" for Distributions, a "Short name" for Data Elements with technical components in names, or an "Abbreviation" that a Specification or Classification is known by.

You can also Create and edit the Alternative name.&#x20;

<figure><img src="/files/LfYMlPF88raPqRcPLLMm" alt=""><figcaption></figcaption></figure>

Navigate to the metadata item you wish to assign the alternative name, select the 'Actions' dropdown, then select 'Alternative name'.

&#x20;

<figure><img src="/files/m8zc0jp43jNfxor1XsuW" alt=""><figcaption></figcaption></figure>

Click <img src="/files/8wLhMoMmSIcXg02ah4Ho" alt="" data-size="line"> tab, Add alternative name to the metadata.

<figure><img src="/files/dwMqRRWZ8b7GGSMzdT18" alt=""><figcaption></figcaption></figure>

The alternative name will assigned to metadata.

<figure><img src="/files/UbpJsXk0a9v9XG9ysent" alt=""><figcaption></figcaption></figure>


# Workgroups

A workgroup is an administrative collection of people working together to create and/or maintain a set of metadata for a specific purpose. Workgroups exist within Stewardship Organisations, and have their own roles (Managers, Stewards, Submitters and Viewers).

## Workgroup functionality

Workgroups:

* Can be [created and managed](/administrator-tasks/workgroups/creating-and-managing-workgroups)
* Contain:
  * Metadata items
  * [Discussions](/administrator-tasks/workgroups/discussions)
  * [Issues](/collaborating-within-the-registry/issues-and-change-requests/creating-an-issue)
  * [Reviews](/collaborating-within-the-registry/opening-a-review).


# Creating and managing workgroups

{% hint style="info" %}
Workgroups can only be created and managed by a Stewardship Organisation or registry Administrator.
{% endhint %}

A workgroup is an administrative collection of people working together to create a set of metadata for a specific purpose. A workgroup exists within and beneath a Stewardship Organisation, and its members can be comprised only of users that are already members of its parent Stewardship Organisation.

Stewardship Organisation Administrators can create a workgroup for their Stewardship Organisation, and subsequently manage its members and settings.

## How to create a workgroup <a href="#creating_a_new_workgroup" id="creating_a_new_workgroup"></a>

**Note:** Workgroups can be archived after creation, but not deleted.

1. Navigate to the desired Stewardship Organisation, then select the 'Workgroups' tab.

<figure><img src="/files/TtWBhWhYHMfR5Rq1D4A1" alt=""><figcaption></figcaption></figure>

2. Select 'Add New Workgroup'.

<figure><img src="/files/AvrfOyegORcyx2pWa8tj" alt=""><figcaption></figcaption></figure>

**Note: If you wish to edit the basic details of an existing workgroup**, select 'Edit' from the 'Workgroups' tab (below).

<figure><img src="/files/1C7er7ohAbVb9RwdYatC" alt=""><figcaption></figcaption></figure>

3. Populate the 'Name' and 'Definition' fields as desired:

<figure><img src="/files/m5RpmA809l3WdndnBNmA" alt=""><figcaption></figcaption></figure>

4. Select what users will be able to see this workgroup via the 'Workgroup Visibility' field.

<figure><img src="/files/VjFt8LRudAjnbTQtfoNd" alt=""><figcaption></figcaption></figure>

5. Select whether this workgroup's metadata will be visible to non-workgroup members via the 'Metadata Vsibility' field.

<figure><img src="/files/6vNg0QW3ZoFiUzkM2kqH" alt=""><figcaption></figcaption></figure>

6. Select whether this workgroup will be displayed in the infoboxes of metadata items that belong to it via the 'Display Options' field.

<figure><img src="/files/gur50LV2Lq9ySMzV0MYw" alt=""><figcaption></figcaption></figure>

**Note: If the 'Allow workgroup managers to select to show this Workgroup on each item page' option is selected**, workgroup Managers can choose whether or not to display workgroup association on a per-item basis by navigating to the relevant item page and selecting 'Show workgroup association' from its 'Actions' dropdown (below).

<figure><img src="/files/hKIN0XmUQjtYxKRdiz6f" alt=""><figcaption></figcaption></figure>

7. **If you wish to display this workgroup's contact information on its homepage**, select 'Display contact email on workgroup homepage' and populate the 'Contact email' field with the relevant email address.

<figure><img src="/files/LnqlkDahR1ai6fhagY9A" alt=""><figcaption></figcaption></figure>

8. Select 'Create new Workgroup' once satisfied.

<figure><img src="/files/OslG39ffT9rk3KTx9DqJ" alt=""><figcaption></figcaption></figure>

## How to manage a workgroup <a href="#managing_a_workgroup" id="managing_a_workgroup"></a>

1. Select the 'Workgroups' tab of the relevant Stewardship Organisation.

<figure><img src="/files/XRs8OtODkFPjzwePTEfe" alt=""><figcaption></figcaption></figure>

2\. Select the workgroup you wish to manage.

<figure><img src="/files/QoG63CH2vQbpgT3qQVwA" alt=""><figcaption></figcaption></figure>

3\. **If you wish to manage workgroup discussions**, select the 'Discussions' tab. From here, you can create, edit and contribute to discussions relevant to this workgroup and its metadata.

<figure><img src="/files/DiqZsdUeSQfoS72GU3pL" alt=""><figcaption></figcaption></figure>

4. **If you wish to manage workgroup issues**, Select the 'Issues' tab. From here you can create, edit and contribute to issues relevant to this workgroup and its metadata.

<figure><img src="/files/EyWT5IwUKlZQXL49SEVN" alt=""><figcaption></figcaption></figure>

5. **If you wish to manage workgroup reviews,** Select the 'Reviews' tab. From here you can create, edit and contribute to issues relevant to this workgroup and its metadata.

<figure><img src="/files/dTvw7YR3elXmxXW2KISU" alt=""><figcaption></figcaption></figure>

6. **If you wish to add, change the role of or remove workgroup members,** select the 'Members' tab. **If you do not wish to add, change the role of or remove workgroup members**, proceed to step 16.

<figure><img src="/files/EsDvKhHv3p7PMvOm1a6o" alt=""><figcaption></figcaption></figure>

7. **If you wish to add a user to this workgroup**, select 'Add a user'. **If you do not wish to add a user to this workgroup**, proceed to step 11.

<figure><img src="/files/Oyxse202mYYBNibBtdBC" alt=""><figcaption></figcaption></figure>

8. Select the user(s) you wish to add to the workgroup from the 'User' field.

<figure><img src="/files/ipIn45wdoAzvpHVxJ1mP" alt=""><figcaption></figcaption></figure>

9. Select the role you wish to grant the chosen user(s) from the 'Role' field.

<figure><img src="/files/H4aN9P11eaMtUuUs1Jyd" alt=""><figcaption></figcaption></figure>

10. Select 'Add member'.

<figure><img src="/files/p0k8P6kPZqpGzyURz9ft" alt=""><figcaption></figcaption></figure>

11. **If you wish to change the role of a workgroup member**, select the settings icon from their row in the 'Members' tab, then select 'Change roles'. **If you do not wish to change the role of a workgroup member**, proceed to step 14.

<figure><img src="/files/S0ixds0PxvJI5Dpm7h5a" alt=""><figcaption></figcaption></figure>

12. Select the role you wish to assign to this user from the 'Roles' field.

<figure><img src="/files/4BQ6b3DyVTaHVKCxxAuS" alt=""><figcaption></figcaption></figure>

13. Select 'Change roles'.

<figure><img src="/files/iftLXEDhKuMCuo0MTQfo" alt=""><figcaption></figcaption></figure>

14. **If you wish to remove a user from the workgroup**, select the settings icon from their row in the 'Members' tab, then select 'Remove from this group.' **If you do not wish to remove a user from the workgroup**, proceed to step 16.

<figure><img src="/files/Pqf0U95ysO9ip9aVQbbt" alt=""><figcaption></figcaption></figure>

15. Select 'Remove user'.

<figure><img src="/files/cEOgERiB89VKEgp0BpVh" alt=""><figcaption></figcaption></figure>

16. **If you wish to adjust workgroup settings**, select the 'Settings' tab.

<figure><img src="/files/53245gCmIk1U0ZhYKxNa" alt=""><figcaption></figcaption></figure>

17. **If you wish to adjust general workgroup settings**, adjust the 'Name' and 'Definition' fields as desired. **If you do not wish to adjust general workgroup settings**, proceed to step 20.

<figure><img src="/files/rXdoZvpKCMvnueXruiiB" alt=""><figcaption></figcaption></figure>

18. Adjust what users can propose and apply changes using issues via the 'Who can propose changes' and 'Who can apply issue changes' fields respectively.

<figure><img src="/files/9RuHYoGIZd9HkljymGPN" alt=""><figcaption></figcaption></figure>

19. Select 'Save changes' once satisfied.

<figure><img src="/files/xiTHLzu5BUuGvubJa04Y" alt=""><figcaption></figcaption></figure>

20. **If you wish to adjust visibility settings**, select the 'Visibility' tab. **If you do not wish to adjust visibility settings**, proceed to step 26.

<figure><img src="/files/wtLqO4omSDKYKIAQwQyy" alt=""><figcaption></figcaption></figure>

21. Select what users will be able to see this workgroup via the 'Workgroup Visibility' field.

<figure><img src="/files/VjFt8LRudAjnbTQtfoNd" alt=""><figcaption></figcaption></figure>

22. Select whether this workgroup's metadata will be visible to non-workgroup members via the 'Metadata Vsibility' field.

<figure><img src="/files/6vNg0QW3ZoFiUzkM2kqH" alt=""><figcaption></figcaption></figure>

23. Select whether this workgroup will be displayed in the infoboxes of metadata items that belong to it via the 'Display Options' field.

<figure><img src="/files/gur50LV2Lq9ySMzV0MYw" alt=""><figcaption></figcaption></figure>

24. **If you wish to display this workgroup's contact information on its homepage**, select 'Display contact email on workgroup homepage' and populate the 'Contact email' field with the relevant email address.

<figure><img src="/files/LnqlkDahR1ai6fhagY9A" alt=""><figcaption></figcaption></figure>

25. Select 'Save changes' once satisfied.

<figure><img src="/files/XL1QIrGqY5Lbf7qdKBgA" alt=""><figcaption></figcaption></figure>

26. **If you wish to move the workgroup to a different Stewardship Organisation**, select the 'Move Workgroup' tab.

<figure><img src="/files/DhsmZsmabyQJIBG4lOal" alt=""><figcaption></figcaption></figure>

27. Select the Stewardship Organisation you wish to migrate the workgroup to via the 'New Stewardship Organisation' dropdown.

<figure><img src="/files/SV4ERkBKF74MgIsnosG1" alt=""><figcaption></figcaption></figure>

28. Select whether the workgroup's members will be granted membership in the chosen Stewardship Organisation by toggling the 'Migrate memberships' checkbox.

<figure><img src="/files/ZBlsq2ONOWEOQmU9nnWM" alt=""><figcaption></figcaption></figure>

**Note:** If this checkbox is left unticked, all workgroup members will be removed from the workgroup.

29. Select 'Move'.

<figure><img src="/files/VtnWisj7yoTqoSrL3UHK" alt=""><figcaption></figcaption></figure>


# Discussions

Discussions are spaces which workgroup members can use to discuss a specified topic. When a discussion is created or edited, users can attach related items to associate the discussion with one or more specific metadata items, and labels to better organise the discussion itself amongst others in the same workgroup.

## Discussion functionality

* Discussions can be:
  * [Created and edited](/administrator-tasks/workgroups/discussions/creating-and-editing-discussions)
  * [Commented on](/administrator-tasks/workgroups/discussions/commenting-on-a-discussion)
  * Closed and deleted
* Labels can be:
  * [Created and edited](/administrator-tasks/workgroups/discussions/creating-and-editing-labels).


# Creating and editing discussions

Any member of a workgroup can create and edit a discussion to facilitate an in-workgroup conversation around a chosen topic. Discussions can be organised by labels.

## How to create discussions

1. Select 'Workgroups' from the dashboard side panel.

<figure><img src="/files/aOsdCOf64nMxOWo1ExXU" alt=""><figcaption></figcaption></figure>

2. Select the title of the desired workgroup.

<figure><img src="/files/Nkcg8M3VfiBLTFNMWYWw" alt=""><figcaption></figcaption></figure>

3. Select the 'Discussions' tab.

<figure><img src="/files/aSzjgyuDOAw61HXnetoG" alt=""><figcaption></figcaption></figure>

4. Select 'New discussion'.

<figure><img src="/files/JAb5VLSHIrpNUZfjuSQv" alt=""><figcaption></figcaption></figure>

5. Populate the 'Title' and 'Body' fields as desired. These will name, and explain the purpose of your discussion respectfully.

<figure><img src="/files/6MWIiqTLx3TjnId4fgYW" alt=""><figcaption></figcaption></figure>

6. **If you wish to attach a metadata item to this discussion**, select one from the 'Related items' field.

<figure><img src="/files/Mabr3wpep3dwi9qInsRv" alt=""><figcaption></figcaption></figure>

**Notes:**

* To find the desired metadata item faster, you can type its name into the field itself
* Metadata items attached to a discussion this way will contain a link to the discussion in their infobox, visible only to those who are also able to view the discussion itself (below).

<figure><img src="/files/Z4yzxQIf35G7GIhkrm24" alt=""><figcaption></figcaption></figure>

7. **If you wish to attach a label to this discussion**, select one from the 'Labels' field.

<figure><img src="/files/RPwm8b4vBBnAoeFjScCx" alt=""><figcaption></figcaption></figure>

**Note:** To find the desired label faster, you can type its name into the field itself.

8. Select 'New post'.

<figure><img src="/files/qUG2GIRJVOa43mFPH0Lh" alt=""><figcaption></figcaption></figure>

9. Once created, the discussion will appear on the relevant workgroup's 'Discussions' tab, along with the details outlined during its creation.

<figure><img src="/files/EPeeoM4hQ07OOmWufpZV" alt=""><figcaption></figcaption></figure>

**Note:** Labels can be selected from this screen to filter the 'Discussions' tab by the selected label.

## How to edit discussions

1. From the desired workgroup's page, select the 'Discussions' tab.

<figure><img src="/files/lu9ODOxw3KQLGCCWRVdk" alt=""><figcaption></figcaption></figure>

2. Select the discussion you wish to edit.

<figure><img src="/files/uIajBfMhOVyGY3HMVUjr" alt=""><figcaption></figcaption></figure>

3. Select 'Edit'.

<figure><img src="/files/DrSW464mDPJOYVrwctGE" alt=""><figcaption></figcaption></figure>

4. **If you wish to edit the discussion's title or body message**, edit the 'Title' or 'Body' fields respectively.

<figure><img src="/files/CvTpb5jQgKOqYjuiiCX7" alt=""><figcaption></figcaption></figure>

5. **If you wish to attach a metadata item or label to the discussion**, select the desired item or label from the 'Related items', or 'Labels' field respectively.

<figure><img src="/files/bDgSdW0ZVAYKYthCwSAC" alt=""><figcaption></figcaption></figure>

**Note:** To find the desired metadata item or label faster, you can type its name into the relevant field itself.

6. **If you wish to remove a related item or label from the discussion**, select the 'x' symbol of the relevant item or label.

<figure><img src="/files/O8MMd4oOQjkDkbZjn1x1" alt=""><figcaption></figcaption></figure>

7. Select 'Save changes' when satisfied.

<figure><img src="/files/KvoYhumnhmbpsRoohOkj" alt=""><figcaption></figcaption></figure>


# Commenting on a discussion

Discussions are engaged with by workgroup members via comments.

## How to comment on a discussion

1. From the desired workgroup's page, select the 'Discussions' tab.

<figure><img src="/files/lu9ODOxw3KQLGCCWRVdk" alt=""><figcaption></figcaption></figure>

2. Select the discussion you wish to edit.

<figure><img src="/files/uIajBfMhOVyGY3HMVUjr" alt=""><figcaption></figcaption></figure>

3. Select the 'New Comment' field, and enter the comment you wish to post.

<figure><img src="/files/DlQBR6hc3RoeDKLdnB1K" alt=""><figcaption></figcaption></figure>

4. Select 'Comment'.

<figure><img src="/files/V0H40hBgpRX2tGKoU8sL" alt=""><figcaption></figcaption></figure>

5. Your comment will be added to the discussion (below).

<figure><img src="/files/h26hNebc4aDurWy13Zjo" alt=""><figcaption></figcaption></figure>


# Closing and deleting a discussion

{% hint style="info" %}
A discussion can only be closed or deleted by a Manager of the relevant workgroup, or the user who created it.
{% endhint %}

When a discussion is no longer needed, it can be closed by either a Manager of the workgroup it belongs to, or the user who initially created it.

## How to close or delete a discussion

1. From the desired workgroup's page, select the 'Discussions' tab.

<figure><img src="/files/lu9ODOxw3KQLGCCWRVdk" alt=""><figcaption></figcaption></figure>

2. Select the discussion you wish to close or delete.

<figure><img src="/files/uIajBfMhOVyGY3HMVUjr" alt=""><figcaption></figcaption></figure>

3. **If you wish to close the discussion**, select 'Close' or 'Close Discussion'.

<figure><img src="/files/TcVVusUPDeUJSmeLtB4v" alt=""><figcaption></figcaption></figure>

4. **If you wish to delete the discussion**, select 'Delete post and all comments'.

<figure><img src="/files/dwBDVmMxTff9ah5g1DLg" alt=""><figcaption></figcaption></figure>

**Note:** This will close the discussion, and remove it from the workgroup permanently, along with any information contained within its comments.


# Creating and editing labels

Labels can be used to sort and better identify a workgroup's discussions.

## How to create a label

1. From the desired workgroup's page, select the 'Settings' tab.

<figure><img src="/files/wxrcUfRugeeNyMkCCt0n" alt=""><figcaption></figcaption></figure>

2. Select 'Manage Discussions'.

<figure><img src="/files/Q0W9m3JWqPfO218F7pnA" alt=""><figcaption></figcaption></figure>

3. Select 'Create label'.

<figure><img src="/files/aN3BD60os558zP2Ed9iI" alt=""><figcaption></figcaption></figure>

4. Populate the 'Name' field.

<figure><img src="/files/PPAWWR7wX9LdagZgF0KH" alt=""><figcaption></figcaption></figure>

5. Select 'Create label'.

<figure><img src="/files/ytDU0bgYEhhuq7Zb9yvP" alt=""><figcaption></figcaption></figure>

6. Your label will appear on the 'Manage Discussions' page (below).

<figure><img src="/files/KiMCZaqNEYOjdgEKdQ86" alt=""><figcaption></figcaption></figure>

**Note:** Labels can be deleted from this page by selecting 'Delete' from the row of the relevant label (below).

<figure><img src="/files/zt22Xg3rIMA7BMtON3Uj" alt=""><figcaption></figcaption></figure>

## How to edit a label

1. From the desired workgroup's page, select the 'Settings' tab.

<figure><img src="/files/wxrcUfRugeeNyMkCCt0n" alt=""><figcaption></figcaption></figure>

2. Select 'Manage Discussions'.

<figure><img src="/files/Q0W9m3JWqPfO218F7pnA" alt=""><figcaption></figcaption></figure>

3. Select 'Edit' from the row of the label you wish to edit.

<figure><img src="/files/PwuATIcfvWl49s29fFfx" alt=""><figcaption></figcaption></figure>

4. Make your changes to the 'Name' field, then select 'Save changes'. The label will be updated.

<figure><img src="/files/n6Ovzvw1cR6eTvXWvS40" alt=""><figcaption></figcaption></figure>


# Add a user to Multiple Stewardship Organizations and Workgroups

{% hint style="danger" %} <mark style="color:red;">**You must be an Administrator to be able to perform these actions.**</mark>
{% endhint %}

1. Select ‘Administrator Tools’ on the Dashboard side panel

<figure><img src="/files/HiImBIu6NjdZlErOMU9m" alt="" width="173"><figcaption></figcaption></figure>

2. A page with buttons will be visible, click on ‘Manage Users’.

<figure><img src="/files/whiJsMUQsGmL0NY9ZILw" alt=""><figcaption></figcaption></figure>

3. From here, a list of Users in the registry will be visible. Find the name of the person needing access to multiple workgroups. Click on the drop-down menu that says Manage to the right of the name.

<figure><img src="/files/rHJ72twoTpiJCu7ZvCoW" alt=""><figcaption></figcaption></figure>

4. Select the option in the drop-down menu that says ‘Click Bulk Change Roles’

<figure><img src="/files/CMO5qXd4POjXbUQpsiMD" alt=""><figcaption></figcaption></figure>

5. From this page you can add a person to multiple stewardship organisations, workgroups. In addition, you can change their roles. Once you have added all the Organisations, Workgroups and Roles that are required click Save at the bottom of the page.

<figure><img src="/files/pM0zfJmbEOT40vzREVrN" alt=""><figcaption></figcaption></figure>


# Creating and editing namespaces and identifiers

{% hint style="info" %}
Namespaces and identifiers can only be created and edited by an Administrator of a Stewardship Organization.
{% endhint %}

{% hint style="info" %}
**What is a Namespace?**

A namespace is the scope of an identifier. In the case that two people or Stewardship Organizations use the same identifier, they can be differentiated using their namespaces.
{% endhint %}

## Namespaces and Identifiers <a href="#namespaces_and_identifiers" id="namespaces_and_identifiers"></a>

### How to add a new Namespace to a Stewardship Organization <a href="#how_to_add_a_new_namespace_to_a_stewardship_organisation" id="how_to_add_a_new_namespace_to_a_stewardship_organisation"></a>

1. Select 'Browse' from the registry header.

<figure><img src="/files/aYdJMKMdVwhB2Nu4FuO2" alt=""><figcaption></figcaption></figure>

2. Select 'Stewardship Organisations'.

<figure><img src="/files/ZzrLGIRkvn9gFQz9obfG" alt=""><figcaption></figcaption></figure>

3. Select the Stewardship Organisation to which you'd like to add a new namespace.

<figure><img src="/files/3y01LGx0OOShZQ3o2pbx" alt=""><figcaption></figcaption></figure>

2\. Select the <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcn478921d1db8642aa8d0223fa75385e89" alt="" data-size="line"> tab, then select 'Namespace'.

<figure><img src="/files/lPtLnxxwOWepiFUWhFzU" alt=""><figcaption></figcaption></figure>

3\. Select 'Create Namespace'.

<figure><img src="/files/ybHbuvoYDyXSSo7i4Dar" alt=""><figcaption></figcaption></figure>

4\. Fill in the form. The Stewardship Organization will be pre-selected for you, add in a Name for the Namespace and then a definition.

<figure><img src="/files/EHeTXqL8sXVNdFbONqQp" alt=""><figcaption></figcaption></figure>

5\.  Once done, select the <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcn210a7e94913f43eda1058ee7fda57217" alt="" data-size="line"> button and you will be taken to the newly created Namespace page.

<figure><img src="/files/O3siZJMwrbad0Af3tvET" alt=""><figcaption></figcaption></figure>

### How to edit a Namespace in a Stewardship Organization <a href="#how_to_edit_a_namespace_in_a_stewardship_organisation" id="how_to_edit_a_namespace_in_a_stewardship_organisation"></a>

1. Go to the Stewardship Organization homepage.

   <figure><img src="/files/ax6wpsUl8Jk7mJdhA2K0" alt=""><figcaption></figcaption></figure>

&#x20;2\. Select the <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcn478921d1db8642aa8d0223fa75385e89" alt="" data-size="line"> tab and then select Namespace under Type.

<figure><img src="/files/AYIFWT0yztuCfFOftx8R" alt=""><figcaption><p>Select the Name of the Namespace you would like to edit</p></figcaption></figure>

3\. Click on the name to select the Namespace you would like to edit.

<figure><img src="/files/eKcYDC8ws09w9Big4gU3" alt=""><figcaption></figcaption></figure>

4\. You will be taken to that Namespaces page.

<figure><img src="/files/5GPtpeir4HWfmLGwzu0C" alt=""><figcaption></figcaption></figure>

5\. To edit the Namespace, in 'Actions' select 'Open item editor'.

<figure><img src="/files/EkxbRRwx572ZbvLA56lA" alt=""><figcaption></figcaption></figure>

6\. Here you can edit the Namespace. Once you're done editing, don't forget to Save Changes.

<figure><img src="/files/38AIZzivxDJKh5ygMQq1" alt=""><figcaption></figcaption></figure>

### How to add a Namespace and Identifier to an item  <a href="#how_to_add_a_namespace_and_identifier_to_an_item" id="how_to_add_a_namespace_and_identifier_to_an_item"></a>

1. Go to the item page of the item you would like to add a Namespace/identifier to.

<figure><img src="/files/Qq7Y983IjBBti6sGakQv" alt=""><figcaption></figcaption></figure>

2\. In the Actions bar select 'Open item editor'.

<figure><img src="/files/TdzcgTgHXZlOFP7GnOhS" alt=""><figcaption></figcaption></figure>

3\. From here, select the 'Identifiers' tab.

<figure><img src="/files/okI7haHozGdIFjxTj8h1" alt=""><figcaption></figcaption></figure>

4\. Select 'Add' and a new Namespace field will appear.&#x20;

<figure><img src="/files/1eLr5FEBwB6Jr0HrI3yZ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/tOaTNCLRnvEXzOjlXwJQ" alt=""><figcaption></figcaption></figure>

5\. Select the Namespace you would like to have an Identifier in, then add in an Identifier and version (not required).

<figure><img src="/files/q9Uvnf9ALfJQp0UTZSzM" alt=""><figcaption></figcaption></figure>

6\. Select <img src="https://desk.zoho.com.au/DocsDisplay?zgId=7000211905&#x26;mode=inline&#x26;blockId=grtcne569515506784688b055508f4230a8d1" alt="" data-size="line"> and your Identifier will now be visible in the Info Box of the item.

<figure><img src="/files/Lxvkv44fnAGRV3xjiQGd" alt=""><figcaption></figcaption></figure>


# Configuring manually triggered incremental identifiers

{% hint style="info" %}
Manually triggered incremental identifiers can only be configured by an Administrator of the relevant Stewardship Organization.
{% endhint %}

Stewardship Organization Administrators can add manually triggered incremental identifiers to metadata items, and configure them. An incremental identifier is an identifier which increases by a single value with each new item it is assigned to.

**Note:** Incremental identifiers must exist within a namespace, which itself must exist within a Stewardship Organization. See this procedure's [parent page](/administrator-tasks/creating-and-editing-namespaces-and-identifiers) for more information.

### How to configure manually triggered incremental identifiers

1. Select 'Administrator Tools' from the dashboard side panel.

<figure><img src="/files/cllNfUfd8CndUmxtUZNk" alt=""><figcaption></figcaption></figure>

2. Select 'Manage Stewardship Organisations'.

<figure><img src="/files/4oFVtCnewlPOIFRtpDQm" alt=""><figcaption></figcaption></figure>

3. Select the relevant Stewardship Organization from the list.

<figure><img src="/files/SnpJevyoPJxOtDHxjib5" alt=""><figcaption></figcaption></figure>

4. Select 'Managed Items', then 'Namespace'.

<figure><img src="/files/KGFCmeh3Dzj27HDoHVA3" alt=""><figcaption></figcaption></figure>

5. Select 'Create Namespace'.

<figure><img src="/files/u4WKu1m6j0kzqZsEeHQx" alt=""><figcaption></figcaption></figure>

6. Adjust the 'Name', 'Shorthand prefix' and 'Definition' fields as desired.

<figure><img src="/files/pZJS6FnZKDMgCXH4rKXH" alt=""><figcaption></figcaption></figure>

7. From the Autoincrement dropdown, **if you want to assign a custom identifier,** select 'Free-text identifier'. **If you want to assign an editable, auto-incrementing identifier**, select 'Manually assigned incrementing identifier'.

<figure><img src="/files/l1M3JUBcqzjtKwW1MQHL" alt=""><figcaption></figcaption></figure>

7. Select 'Create New Namespace' from the bottom of the page.

<figure><img src="/files/ur2Qfi5p6mOx0mM9aBqF" alt=""><figcaption></figcaption></figure>

9. Navigate to the metadata item you wish to assign a manually triggered incremental identifier to, and select 'Open item editor' from its 'Actions' dropdown.

<figure><img src="/files/i3MWbkztkYiTg8zGzzL6" alt=""><figcaption></figcaption></figure>

10. Select the 'Identifiers' tab.

<figure><img src="/files/3jco5fC2SWDpzsP7aUz5" alt=""><figcaption></figcaption></figure>

11. Select the appropriate manually triggered identifier from the 'Namespace' dropdown, then adjust the 'Identifier' field as desired.

<figure><img src="/files/ogZ140x4PhH1bwGdcWsV" alt=""><figcaption></figcaption></figure>

12. Select 'Save changes' when you are satisfied.

<figure><img src="/files/RPXcOmx61geFRERS8hNg" alt=""><figcaption></figcaption></figure>

13. The item's identifier will now appear in its infobox.

<figure><img src="/files/SVfCVTiMe0DcVSFo8nPl" alt=""><figcaption></figcaption></figure>


# Configuring automatically triggered incremental identifiers

{% hint style="info" %}
Automatically triggered incremental identifiers can only be configured by an Administrator of the relevant Stewardship Organization.
{% endhint %}

Stewardship Organization Administrators can add automatically triggered incremental identifiers to metadata items, and configure them. An incremental identifier is an identifier which increases by a single value with each new item it is assigned to.

**Note:** Incremental identifiers must exist within a namespace, which itself must exist within a Stewardship Organization. See this procedure's [parent page](/administrator-tasks/creating-and-editing-namespaces-and-identifiers) for more information.

### How to configure automatically triggered incremental identifiers

1. Select 'Administrator Tools' from the dashboard side panel.

<figure><img src="/files/cllNfUfd8CndUmxtUZNk" alt=""><figcaption></figcaption></figure>

2. Select 'Manage Stewardship Organisations'.

<figure><img src="/files/4oFVtCnewlPOIFRtpDQm" alt=""><figcaption></figcaption></figure>

3. Select the relevant Stewardship Organization from the list.

<figure><img src="/files/SnpJevyoPJxOtDHxjib5" alt=""><figcaption></figcaption></figure>

4. Select 'Managed Items', then 'Namespace'.

<figure><img src="/files/KGFCmeh3Dzj27HDoHVA3" alt=""><figcaption></figcaption></figure>

5. Select 'Create Namespace'.

<figure><img src="/files/u4WKu1m6j0kzqZsEeHQx" alt=""><figcaption></figcaption></figure>

6. Adjust the 'Name', 'Shorthand prefix' and 'Definition' fields as desired.

<figure><img src="/files/G9JERRJb3F8rg3siEFP3" alt=""><figcaption></figcaption></figure>

7. From the Autoincrement dropdown, select 'Automatically assigned incrementing identifier'.

<figure><img src="/files/QBq4BQy5UQv8MO9lsvvf" alt=""><figcaption></figcaption></figure>

7. Select the automatically triggered identifier's triggers via the 'Metadata types', 'Metadata templates', 'Registration authorities' and 'Registration statuses' checkbox lists.

<figure><img src="/files/eNVEsx43fDg6htMU0b8N" alt=""><figcaption></figcaption></figure>

**Notes:**

* Metadata item templates will only appear in the 'Metadata templates' list if they are active, as opposed to drafts
* The 'Regisitration authorities' and 'Registration statuses' lists will only appear if the relevant Stewardship Organization contains Registration Authorities.

<figure><img src="/files/J5EKNpVj8LLAORzafsGb" alt=""><figcaption></figcaption></figure>

10. The item's identifier will now appear in its infobox.

<figure><img src="/files/9pFanrBld2dn6Lmx5ZeR" alt=""><figcaption></figcaption></figure>


# Deactivating a user account

{% hint style="danger" %} <mark style="color:red;">**You must be an administrator of the Registry to be able to perform these actions.**</mark>
{% endhint %}

Deactivating a users account prevents them from being able to log into the Registry. This prevents them from creating new metadata items, participating in Workgroups, and registering metadata. They will still be able to perform actions that users without an account can do such as view published metadata, and search or browse.

### How to deactivate a user account <a href="#how_to_deactivate_a_user_account" id="how_to_deactivate_a_user_account"></a>

1\. From your dashboard side panel select 'Administrator Tools'.

<figure><img src="/files/SPyZHVu8AcfBMdAJrP37" alt=""><figcaption></figcaption></figure>

2\. From here, select 'Manage Users' in the Registry Administrator tools list.

<figure><img src="/files/GTFiVle7m2BGwifMQUgD" alt=""><figcaption></figcaption></figure>

3\. Find the user's account you are deactivating and select the 'manage' button next to their name and select 'Deactivate this user'.

<figure><img src="/files/05miVxU3sQNnW87N4G5l" alt=""><figcaption></figcaption></figure>

4\. You will then be prompted to confirm you want to deactivate the user.

<figure><img src="/files/3CMvW2wT3tWxn7ibP1ni" alt=""><figcaption></figcaption></figure>

Once you deactivate the user, they will no longer be able to log into the registry.

Users accounts can be reactivated in future and they will retain ownership of any metadata that was in their sandbox at the time of account deactivation.

<figure><img src="/files/vSFn8pKAdXHNg6tm7vtk" alt=""><figcaption></figcaption></figure>


# View CRUD (Create, Read, Update and Delete) Changes

{% hint style="danger" %} <mark style="color:red;">**You must be an administrator of the Registry to be able to perform these actions.**</mark>
{% endhint %}

All the CRUD functions performed in the registry can be monitored by going to the 'CRUD events' in the Aristotle registry.

1. Click the 'Django administration' on the left side panel.

<figure><img src="/files/lgm0G0RVBFrowx4UzuWD" alt=""><figcaption></figcaption></figure>

If 'Django administration' is not visible on the left side panel:

* Go to the 'Administrator tools' and click on the 'Manage Users'.

<figure><img src="/files/QNIhYS1NsVLTdidGbnXC" alt=""><figcaption></figcaption></figure>

* Click on the 'Manage' dropdown, inline with your name, then Click on the 'Change site-wide permissions'.

<figure><img src="/files/psX4p9MOk8cy5oTRDdPw" alt=""><figcaption></figcaption></figure>

* Tick the check box for 'Access Django admin area' if it is not checked, and click the 'Save Changes' button

<figure><img src="/files/TAinGXxhD6kRbCjaQxZG" alt=""><figcaption></figcaption></figure>

* Once the changes are saved, refresh the page, and you will be able to see 'Django Administration' on the left side panel.&#x20;

2\. After clicking 'Django Administration' scroll down to 'EASY AUDIT APPLICATION', Click on the change button inline with 'CRUD events'.

<figure><img src="/files/OhS0OfXsnjWCORZFN9mz" alt=""><figcaption></figcaption></figure>

3\. On this screen, you can see the CRUD actions performed in the registry. You can apply filters either from the right side 'Filters' options or by date below search. Also, you can search for the item name or id in the search bar.

<figure><img src="/files/PMi5J4ocAb7c0lBZY7IZ" alt=""><figcaption></figcaption></figure>

4\. Click on the item's event type to further see the details of the particular item. We can see who has performed that action, at what time, the changed fields and the action taken, For instance, in the below example, action is 'Update' and it was updated on 25 Oct 2022 at 10.23 a.m.

<figure><img src="/files/X40wZ2Yd7QwkotN0Bf6g" alt=""><figcaption></figcaption></figure>

5\. Similarly, you can check who has created, updated or deleted items in the registry and at what time by following the same steps.


# View deleted items using query string

{% hint style="danger" %} <mark style="color:red;">**You must be an administrator of the Registry to be able to perform these actions.**</mark>
{% endhint %}

The Administrators and the Superusers of the Aristotle Metadata Registry have access to delete the items. Once the item is deleted, the users cannot find the item using the search bar.&#x20;

* For example, the item 'Business: Age, Years Number' has id='59'.

<figure><img src="/files/UnnLTXmv8tIfqKI6YB9i" alt=""><figcaption></figcaption></figure>

* Once deleted, if you will try to search for the item in the search bar and it will show 0 results.

<figure><img src="/files/Rog53OpBrpWKe0FRAs9i" alt=""><figcaption></figcaption></figure>

* To view the deleted item, the direct and quick way is to search for the item through a query string. The first step is to add '/item/59' at the end of the registry URL, where 59 is the metadata Id we want to look for in the deleted list and press enter. It will show page not found.

<figure><img src="/files/U8QQN5RWBLuJbua8ijO1" alt=""><figcaption></figcaption></figure>

* Add the query string '?show\_deleted=true' at the end of the URL and press enter.

<figure><img src="/files/TRCgUzG8BQ9f1dHFG2JB" alt=""><figcaption></figcaption></figure>

* After enter, you will notice the URL is changed, The URL tells us that the item has Id=59 and it is a data element, named 'business-age-years-number'

<figure><img src="/files/2LRcpa5WLNhNQeRTIq4e" alt=""><figcaption></figcaption></figure>

* To find the deleted item, add the query string '?show\_deleted=true' at the end of the URL, which shows the item id as '59', stored as a 'dataelement' and the item name is 'business-age-years-number'

<figure><img src="/files/oZC5ch13NXyyGXvL821a" alt=""><figcaption></figcaption></figure>

* Press enter and it will show the deleted item. The item needs to be restored if you want to make any changes to the deleted item.

<figure><img src="/files/Ytx2sNETk9gkn5PvYWVf" alt=""><figcaption></figcaption></figure>


# Contact Forms

{% hint style="info" %}
Only registry Administrators can create or add homepage links to contact forms.
{% endhint %}

Contact forms are web-based forms that are used to collect information from registry visitors. They include fields for users to enter their name, email address, and a message or inquiry. The purpose of a contact form is to allow visitors to easily get in touch with registry administrators.

### Functionality of contact forms

Contact forms can be:

* Created (by a registry Administrator)
* Linked to the registry homepage (by a registry Administrator)
* Submitted (by a registry user)


# Creating contact forms

{% hint style="info" %}
Contact forms can only be set up by registry Administrators.
{% endhint %}

Registry Administrators can create contact forms for future linking to the registry's homepage.

### How to create a contact form

1. Select 'Administrator tools' from the dashboard side panel.

<figure><img src="/files/sTYVBo6pRKybCwWlm5ad" alt=""><figcaption></figcaption></figure>

2. Select 'Manage Contact Forms'.

<figure><img src="/files/tRXEIl1ga9ur9umi7MnH" alt=""><figcaption></figcaption></figure>

3. Select 'Create New Form'.

<figure><img src="/files/clUsrPxEl1JAHkd9FWPk" alt=""><figcaption></figcaption></figure>

4. Populate the following fields as required:
   * 'Title': The title of the contact form
   * 'Body': The purpose of the contact form, or reason for inquiry
   * 'Audience': Whether this contact form is for use by public or authenticated registry users
   * 'Status': Whether or not the form is able to be accessed and responses to it submitted (open)
   * 'Assigned users': The users allowed to view responses to this form, and respond to submitters
   * 'Extra notification email': Any email addresses (atop those of any assigned users) that should be notified of incoming responses
   * 'Thanks message': The thank you message displayed to users who successfully submit the form
   * 'Template response message': A recommended template to follow when responding to this contact form's submissions
   * 'Require user details': Whether or not users without an account will need to provide their name and email in order to submit this form
   * 'Enable spam detection': Whether reCAPTCHA verification is used to detect spam behaviour within this form.

<figure><img src="/files/FS4K5K3p7y5exM0oxmgl" alt=""><figcaption></figcaption></figure>

**Note:** If the correct site keys have been configured (see [Adjusting Spam Detection Options](/administrator-tasks/aristotle-cloud-settings-editor/adjusting-spam-detection-options)), a contact form's reCAPTCHA will display as below:

<figure><img src="/files/v1a4XFyrHOsSIJhTib7O" alt=""><figcaption></figcaption></figure>

5. Select 'Submit' once satisfied.

<figure><img src="/files/AX9EKuLIQfwfG4r6g6b6" alt=""><figcaption></figcaption></figure>


# Adding contact form links to the homepage

{% hint style="info" %}
Links to contact forms can only be added to the homepage by a registry Administrator.
{% endhint %}

Registry Administrators can add links to the registry homepage which take users to the contact form of their choice.

### How to add contact form links to the homepage

1. Select 'Administrator tools' from the dashboard side panel.

<figure><img src="/files/sTYVBo6pRKybCwWlm5ad" alt=""><figcaption></figcaption></figure>

2. Select 'Manage Contact Forms'.

<figure><img src="/files/tRXEIl1ga9ur9umi7MnH" alt=""><figcaption></figcaption></figure>

3. Select 'Test' from the row of the contact form you wish to link, then **copy the page URL from your browser**.

<figure><img src="/files/TMKPwCrXZpuaQDxY5iuQ" alt=""><figcaption></figcaption></figure>

4. Select 'Aristotle Cloud Dashboard' from the dashboard side panel.

<figure><img src="/files/4eo0bWlqFZBWhAuZ14dF" alt=""><figcaption></figcaption></figure>

5. Select 'Homepage Editor'.

<figure><img src="/files/xF5TOcRbmnDsYIzZITxg" alt=""><figcaption></figcaption></figure>

6. Select 'Edit Homepage using safe editor'.

<figure><img src="/files/PRtBMQBrX0y0YTckOe7Q" alt=""><figcaption></figcaption></figure>

7. Using the rich text editor, navigate to where on the homepage you would like the link to be located, then select the link function.

<figure><img src="/files/C1AXROI1jz5rVuzNsqR7" alt=""><figcaption></figcaption></figure>

8. Populate the 'Display Text' field with the text you want the link to appear as on the homepage

<figure><img src="/files/ltw5yIdFXZhKlm9NPYnw" alt=""><figcaption></figcaption></figure>

9. Paste the contact form link you copied into the 'URL' field.

<figure><img src="/files/XyiLHPpRxfsXANCsQF46" alt=""><figcaption></figcaption></figure>

10. Select 'OK'.

<figure><img src="/files/Duvn0x6G6Uh6jR24Hi9f" alt=""><figcaption></figcaption></figure>

11. **If you wish to preview your homepage changes**, select 'Preview changes'. Once satisfied, select 'Save custom homepage'.

<figure><img src="/files/NeqEfC1UHqu6xXTdiQe5" alt=""><figcaption></figcaption></figure>


# Submitting and replying to contact forms

{% hint style="info" %}
Contact forms can only be **replied to** by registry Administrators.
{% endhint %}

Any registry user can submit a contact form once it has been [linked to the registry homepage](/administrator-tasks/contact-forms/adding-contact-form-links-to-the-homepage). These submissions can then be responded to by registry Administrators.

### How to submit a contact form

1. Select the desired contact form from the registry homepage.

<figure><img src="/files/pnfa6jWG3VNg9aktN8ON" alt=""><figcaption></figcaption></figure>

2. Populate the available fields as required.

<figure><img src="/files/YQeAlDMerAeYqiZD1yZI" alt=""><figcaption></figcaption></figure>

3. Select 'Submit'.

<figure><img src="/files/Ov9TOoIb6neGhrJitaJy" alt=""><figcaption></figcaption></figure>

### How to reply to a user who has submitted a contact form

1. Select 'Administrator tools' from the dashboard side panel.

<figure><img src="/files/sTYVBo6pRKybCwWlm5ad" alt=""><figcaption></figcaption></figure>

2. Select 'Manage Contact Forms'.

<figure><img src="/files/tRXEIl1ga9ur9umi7MnH" alt=""><figcaption></figcaption></figure>

3. Select the contact form you wish to see submissions of.

<figure><img src="/files/GG5S1gfEbXyr6ksuEEC5" alt=""><figcaption></figcaption></figure>

4. From this screen, Administrators can see a record of every submission of the selected contact form. Select 'Details' on the submission you wish to reply to.

<figure><img src="/files/CZAf0JI71Bt5nzsyag6c" alt=""><figcaption></figcaption></figure>

4. Populate the 'Details' field with your reply to the chosen submission.

<figure><img src="/files/DYOQZ4EQnaVT1TCmpBnp" alt=""><figcaption></figcaption></figure>

4. Check the 'Send to submitter' checkbox.

<figure><img src="/files/zxu76yozCH6dHlF3PvJv" alt=""><figcaption></figcaption></figure>

**Note:** Adding an update to the submission will still work if this box is not checked, but the original submitter will not be notified of your reply. Leave the box unchecked if you wish only to leave a note on the submission.

4. Adjust the following checkboxes as desired:
   * 'Send yourself a copy of the response email': If enabled, a copy of your response will be sent to your account's associated email address
   * 'Send a copy of the response to the extra notification email': If enabled, a copy of your response will be sent to the email specified in the 'Extra notification email' field of the relevant contact form, if any.

<figure><img src="/files/8WXRRAyZ6g7Err8WnyGI" alt=""><figcaption></figcaption></figure>

4. Select 'Add update' once satisfied.

<figure><img src="/files/FMb3bnvUeLSDJ85OEcaf" alt=""><figcaption></figcaption></figure>


# Custom Item Templates

Custom item templates allow users to quickly create metadata items that adhere to a predefined, customisable template. These templates allow for changes that differ from the default Aristotle Metadata Registry page format (including the addition of [sub-pages](/administrator-tasks/custom-item-templates/creating-and-editing-custom-item-templates/creating-and-editing-item-template-sub-pages)), as well as custom item editors for the metadata items that use them.

### Custom item template functionality

{% hint style="info" %}
Only Registry Administrators can create and edit custom item templates.
{% endhint %}

Custom item templates can be:

* [Created and edited](/administrator-tasks/custom-item-templates/creating-and-editing-custom-item-templates)
* Used to [create templated metadata items](/administrator-tasks/custom-item-templates/creating-metadata-items-using-custom-item-templates)
* [Applied to or unlinked from existing metadata items](/administrator-tasks/custom-item-templates/removing-or-applying-an-item-template-for-an-existing-metadata-item).

**Note:** Sub-pages can only be added to a custom item template **after** its creation via editing the custom item template.


# Creating and editing custom item templates

{% hint style="info" %}
Custom item templates can only be created by a Registry Administrator.
{% endhint %}

Registry Administrators can create and edit custom metadata item templates from their Administrator tools. These allow users to quickly create metadata items that adhere to a predefined, customisable template, and make changes that differ from the default Aristotle Metadata Registry page format (including the addition of sub-pages, and custom item editors).

### How to create or edit a custom item template

1. Select 'Administrator tools' from the dashboard side panel.

<figure><img src="/files/HxtwRRUNPsV1CGDFsj6d" alt=""><figcaption></figcaption></figure>

2. Select 'Manage Metadata Item Templates'.

<figure><img src="/files/L0qSBrnEWP11165gZgZ2" alt=""><figcaption></figcaption></figure>

3. **If you are creating a new custom item template,** select 'Create New Template'. **If you are editing an existing custom item template**, select 'Edit' from the row of your desired template.

<figure><img src="/files/qdmPZgPMc4jj5AtoaAmi" alt=""><figcaption></figcaption></figure>

4. Populate the 'Name' and 'Template Description' fields as desired.

<figure><img src="/files/RwVVAtDteKuOW4CbYbwO" alt=""><figcaption></figcaption></figure>

5. Select the metadata item type this template will create when used via the 'Base Metadata Type' dropdown.

<figure><img src="/files/81w3SjrEaTQkagCbaYuT" alt=""><figcaption></figcaption></figure>

6. Select whether the template will be usable registry-wide, or by a specific Stewardship Organisation via the 'Applicable to' dropdown.

<figure><img src="/files/NStGL3KkNWedmvYzEhHY" alt=""><figcaption></figcaption></figure>

7. **If you selected 'Stewardship Organisation' in the last step**, select the Stewardship Organisation the template will be usable by via the 'Stewardship Organisation' dropdown. **If you selected 'Registry' in the last step**, proceed to step 8.

<figure><img src="/files/vIsv3XPq9YtStEtr1Xwn" alt=""><figcaption></figcaption></figure>

8. Select whether this template will be in draft status, or active (able to be used) upon creation/saving via the 'Status' dropdown.

<figure><img src="/files/69hcAbMVRRXqVh6NJ6ZQ" alt=""><figcaption></figcaption></figure>

9. Drag and drop all fields you wish to be editable via the item editor of templated item(s) from the 'All Fields' box to the 'Editor Fields' box.

<figure><img src="/files/aW6qIVxKMAPvIPoawqmy" alt=""><figcaption></figcaption></figure>

10. **If you wish to include templated items' infoboxes on their pages**, tick the 'Include Infobox' checkbox. **If you wish to exclude templated items' infoboxes from their pages**, untick the 'Include Infobox' checkbox.

<figure><img src="/files/RyXAdmcEKxSyejo09b4u" alt=""><figcaption></figcaption></figure>

11. **If you wish to add containers, fields, widgets or custom HTML to the template**, select the '+' symbol in the 'Container' field. **If you do not wish to add containers, fields, widgets or custom HTML to the template**, proceed to step 13.

<figure><img src="/files/U9d5sPZJMhIemee81u0N" alt=""><figcaption></figcaption></figure>

**Notes:**

* Select the cog symbol to adjust:
  * Header:
    * Inclusion and collapsibility via the 'Include Header?' and 'Content Collapsible' checkboxes
      * Text via the 'Header Text' field
      * Element overriding via the 'Override Header Element' dropdown:
        * Header 1-6: Different sized heading styles, with 'Header 1' being the largest, 'Header 2' being the default size in Aristotle and 'Header 6' being the smallest
        * Span: Inserts extra space between words of the header
        * Label: A style reminiscent of a subtitle
  * CSS style elements via the 'Additional CSS classes' field
  * Container font size via the 'Container Font Size' dropdown.
* Select the dynamic layout symbol (a double-sided, horizontal arrow by default) to cycle through the available formats of the container. It will display any inserted containers, fields, widgets or custom HTML in the layout you choose.

<figure><img src="/files/kLC8PkHuU8vpPpJwIuBa" alt=""><figcaption></figcaption></figure>

**Note:** The 'Content Collapsible' checkbox, 'Header Text' field and 'Override Header Element' dropdown will only appear if the 'Include Header' checkbox is ticked.

12. Select from the following to add them to the template:

* 'Container': Adds another container, which itself can contain more containers, fields, widgets or custom HTML:
  * **See step 11's notes for cog and layout symbol functionality**
  * Select the '+' symbol to add containers, fields, widgets or custom HTML to this container

<figure><img src="/files/heyQrg98zoVopDqiFJds" alt=""><figcaption></figcaption></figure>

* 'Field':  Opens a dropdown. Templated item fields selected from this dropdown will appear in the relevant container
  * The cog symbol allows headers and labels to be adjusted for the selected field:
    * **See step 11's notes for header configuration**
    * 'Override Label Text': Allows the text of an included label to be customised
    * 'Override Label Element': Allows the style of an included label to be selected
    * 'Field Font Size': Allows the size of a field's font to be adjusted

<figure><img src="/files/S2xGd8su8Eh0WviNIQgy" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/9LwGbN9IsXhVAa2u5UL0" alt=""><figcaption></figcaption></figure>

**Note:** Greyed-out dropdown fields are selectable, but represent fields that are currently not included or editable in the item template (step 9), and will therefore be empty without further configuration.

* 'Widget': Opens a dropdown. Widgets chosen from this dropdown will be included in the relevant container, populated by the templated items information
  * **See step 11's notes for cog symbol functionality**

<figure><img src="/files/IhOch2tJxw2wOOpdvdN7" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/8Ic79I3aKLfWxzTlkDin" alt=""><figcaption></figcaption></figure>

* 'Custom HTML': Allows custom HTML to be added to the relevant container.

<figure><img src="/files/MBaMS4dbn9iBw6PTUXeI" alt=""><figcaption></figcaption></figure>

**Notes:**

* The following HTML formulas can be used to retrieve a:
  * Custom field, where '**system-name**' is the custom field's system name:
    * Non-Json custom fields: '\<div>{{ item.customvalue\_set\["**system-name**"] }}\</div>'
    * 'JsonDict' custom field: '\<div>{{ item.customvalue\_set\["**system-name**"].name }} : {{ item.customvalue\_set\["**system-name**"].age }}\</div>'
    * 'JsonArray' custom field: '\<div>{% for item in item.customvalue\_set\["**system-name**"] %}\<li>{% endfor %}\</div>'
  * Specific identifier: '\<div>{% for i in item.identifiers %}{{ i.identifier }}{% endfor %}\</div>'
* The bin symbol (below) that appears when configuring **any of the above** can be selected to remove the relevant container, field, widget or custom HTML from the template.

<figure><img src="/files/LC1s09X9Z8wRhZzDJhiG" alt=""><figcaption></figcaption></figure>

13. Once satisfied, select 'Submit'/'Save Changes'.

<figure><img src="/files/8ON1mGLPnI3g29Jw0bMd" alt=""><figcaption></figcaption></figure>

14. **If you wish to add sub-pages to the template,** proceed to [Creating and editing sub-pages](/administrator-tasks/custom-item-templates/creating-and-editing-custom-item-templates/creating-and-editing-item-template-sub-pages).

**Note: Sub-pages cannot be added** during the initial creation of an item template. Submit the item template, then edit it from the 'Metadata Item Templates' page to add sub-pages.


# Creating and editing item template sub-pages

{% hint style="info" %}
Sub-pages can only be created and edited by a Registry Administrator
{% endhint %}

Once a custom item template has been created, Registry Administrators can add sub-pages to them. Sub-pages will appear alongside the default and templated view modes for a templated metadata item, and can each be customised individually of their parent item template.

### How to create or edit a sub-page

1. Select 'Administrator tools' from the dashboard side panel.

<figure><img src="/files/sL8uYotgngNxN7hvNOmK" alt=""><figcaption></figcaption></figure>

2. Select 'Manage Metadata Item Templates'.

<figure><img src="/files/4jICDlEgqlb7jY3yhbII" alt=""><figcaption></figcaption></figure>

3. Select 'Edit' from the row of the template you wish to add a sub-page to.

<figure><img src="/files/Dv2KSKuwhsg5h4f0k78a" alt=""><figcaption></figcaption></figure>

4. Navigate to the 'View Template Sub-Pages' section of the item template editor, then select 'Create New Sub-Page'.

<figure><img src="/files/jql7LKO4a0uZxbzTTSVO" alt=""><figcaption></figcaption></figure>

5. Populate the following fields:
   * Name: The sub-page's title, which will appear alongside templated items' default and templated view options
   * Slug: The sub-page's URL slug. This will appear at the end of the sub-page's URL when it is being viewed
   * Sub-Page Description: A description of the sub-page to provide context to Administrators.

<figure><img src="/files/9B1JpIlH75urRTSnJwh8" alt=""><figcaption></figcaption></figure>

**Note:** A sub-page's description is for the context of Admins/editors only, and will not appear as a field of the sub-page itself.

6. Select the visibility permission of the sub-page:
   * 'Authenticated User': All logged in users of the registry will be able to see the sub-page
   * 'Public User': All users of the registry will be able to see the sub-page regardless of login status
   * 'Stewardship Organisation': Only members of the same Stewardship Organisation that the item the sub-page is attached to is a part of will be able to see the sub-page
   * 'Workgroup': Only members of the same workgroup that the item the sub-page is attached to is a part of will be able to see the sub-page
   * 'Registry Administrator': Only Registry Administrators will be able to see the sub-page.

<figure><img src="/files/FgDvfNlkQipzeBF5o2a7" alt=""><figcaption></figcaption></figure>

**Note:** Setting individual sub-page visibility can be used to add a Stewardship Organisation or workgroup restricted viewing mode to items that are otherwise endorsed to the public. When used this way, an item's main page will be visible to the public, but members of the relevant Stewardship Organisation or workgroup will be able to access the restricted sub-page.

7. **If you want the sub-page to include the templated item's infobox,** tick the 'Include Infobox' checkbox. **If you do not want the sub-page to include the templated item's infobox**, untick the 'Include Infobox' checkbox.

<figure><img src="/files/BScAT4tMwcKH3qr4M9Ha" alt=""><figcaption></figcaption></figure>

8. Select the '+' symbol in the 'Container' field to add containers, fields, widgets or custom HTML to the sub-page. **See steps 11 and 12 of**  [**Creating and editing custom item templates**](/administrator-tasks/custom-item-templates/creating-and-editing-custom-item-templates#how-to-create-or-edit-a-custom-item-template) for further guidance on container, field, widget and custom HTML configuration.

<figure><img src="/files/M3e8pW0H7MwbbBsKYNft" alt=""><figcaption></figcaption></figure>




---

[Next Page](/llms-full.txt/1)

