Docs
Repository Settings

Repository

Lunr uses repositories to separate and secure content within an organisation, while allowing administrators to configure repository-specific settings such as drafting packs, renditions, groups, tags, lookup lists, templates, and import/export templates.

Overview

Multiple Repositories can be configured in a single Lunr organisation where it is required for security or data separation.

To the end user, a repository is a standalone instance of Lunr, although some users can be granted access to more than one repository.

The Repository list showing the single Base repository, marked as default and active, with the multiple repositories toggle above it

Select a repository name to display its configuration options. A repository opens with fourteen tabs, covering its own details, the content rules that apply within it, and two bulk import tools.

Access Rights

Opening a repository requires Administration Pages, Manage Drafting Packs, or Manage Lookup Lists. Holding any one of them is enough. Each tab then has its own rule, and a user sees only the tabs they qualify for. As with the page, holding any one of the listed rights opens a tab.

TabOpens with
Drafting PacksAdministration Pages or Manage Drafting Packs
Lookup ListsAdministration Pages or Manage Lookup Lists
TemplatesAdministration Pages or Manage Repository Templates
Import/ExportAdministration Pages or Manage Repository Templates
Restricted DocsDownload Restricted Files
Every other tabAdministration Pages

For example, a user who holds only Manage Drafting Packs can open a repository but sees only the Drafting Packs tab.

A user who holds only Manage Repository Templates or only Download Restricted Files cannot open the repository page at all, because neither right is enough to reach it. Those two rights add a tab only for a user who can already open a repository through one of the first three rights.

Details

The Details tab edits the repository itself.

  • Repository name is required, and capped at 50 characters.
  • Default repository marks this as the repository users land in.
  • Active repository controls whether the repository is in use.

Select Save to keep your changes, or Cancel to discard them.

A default repository cannot be made inactive; remove its default status before deactivating it. Deactivating a repository does not delete any document data, so reactivating it later restores full access to its content.

The Details tab of the Base repository, showing its name plus the default and active checkboxes, and the full set of 14 repository tabs: Details, Configuration, Drafting Packs, Renditions, Groups, Lookup Lists, Tags, Tag Order, Expressions, CR Import, Collection Import, Templates, Import/Export, and Restricted Docs

Configuration

The Configuration tab holds three repository-level settings.

SettingWhat it controls
Title fragment separatorThe character used to join the fragments of a document title. Choose from Default (space), :, :, ,, |, or -.
Full Change Request pageWhether this repository uses the full Change Request page. Choose Use global setting, Enabled for this repository, or Disabled for this repository.
Change Request message placeholderThe hint shown in the empty Message box when a Change Request is created in this repository, and on one created without a message. Line breaks are kept. Leave it blank to use the global placeholder.

The Full Change Request page setting shows the current organisation-wide value beneath it, and an override applies to this repository only. The organisation-wide setting is Full Change Request page, on the Form page of the Change Request tab in Project Settings. The global placeholder is Message placeholder on the same page.

The Configuration tab showing the title fragment separator setting, the Full Change Request page override set to Use global setting against a global default of Disabled, and an empty Change Request message placeholder box

Drafting Packs

The Drafting Packs tab allows you to configure the drafting pack that is available within Change Requests for users to download. Select a drafting pack to configure it, or select Create Drafting Pack to create a new one. This tab opens with Administration Pages or Manage Drafting Packs.

Removing a drafting pack archives it rather than deleting it. An archived drafting pack can be brought back into view and reused, so removing one from this tab is reversible.

Renditions

The Renditions tab allows you to configure the default rendition settings used for content generation. These defaults apply to the repository you are configuring, so different repositories can render drawings to different sheet sizes or with different plotting styles.

A repository has a single default rendition setting. Once one exists, the Add Rendition Setting button no longer appears and you edit the existing entry instead. Users can choose another rendition setting when required for a particular document.

The Rendition Setting

The tab lists the current setting with the following columns.

ColumnWhat it shows
Repository IDThe identifier of the repository the setting belongs to.
Repository NameThe name of that repository.
Sheet SizeThe default sheet size renditions are generated at.
CTB StylesheetThe CTB plotting style sheet applied when generating renditions.

Each row offers Edit and Delete.

Delete always reports success, even if there was nothing to delete. If the row does not disappear afterwards, refresh the page rather than selecting Delete again.

Adding a Rendition Setting

  1. Select Add Rendition Setting. The page is headed "Add the default rendition setting for this repository".

  2. Choose a CTB Style Sheet. Both dropdowns support searching, which helps when your organisation has uploaded many style sheets.

  3. Choose a Sheet Size.

  4. Select Add to save the setting, or Cancel to discard it.

The Add Rendition Setting form for the Base repository filled in with an example CTB style sheet and A1 sheet size

The CTB style sheets available here are the files uploaded against the AutoCAD Drawing section on the Templates page.

Organisation-wide rendition defaults, including the default margin and the default plotting stylesheet, are set under Content Generation on the General Settings page. The organisation-wide plotting stylesheet is used only when drawing PDF generation did not specify one and there is no repository plot stylesheet setting, so the repository setting documented here takes precedence.

Groups

The Groups tab allows you to configure the user groups associated with the repository. Select Add Group to create a new group linked directly to this repository.

Lookup Lists

The Lookup Lists tab allows you to configure lookup lists associated with the repository. Select Add Lookup List to create a new lookup list for this repository. The boxes beside the list names let you enable or disable each lookup list on the repository. This tab opens with Administration Pages or Manage Lookup Lists.

Tags

The Tags tab allows you to modify tags in the repository. The boxes beside the tag names let you enable or disable each tag on the repository.

The repository-scoped Tags tab, listing the same structural tag hierarchy (Branch, Campus, Building, Discipline, and more) that can be enabled per repository

Tag Order

The Tag Order tab sets the order that tags are displayed on both the Preview view and Grid view in the repository. Select Add tag to include another tag, and Remove from preview or Remove from grid to drop one from a single view. Drag tags into position, then use the Save Order button in the top corner when finished.

Expressions

The Expressions tab holds the repository's computed expression overrides. A computed tag derives its value from an expression, and this tab lets a repository depart from the organisation-wide default.

Each entry shows the Default Expression alongside an Override Expression you can supply. Choose Use default to fall back to the organisation-wide expression, and select Save when you have finished.

The Computed Expression Overrides tab, shown in its empty state because no computed tags are applicable to the Base repository in this demo organisation

CR Import

The CR Import tab imports Change Requests in bulk from an Excel spreadsheet.

  1. Upload your .xlsx file. The file must be an Excel spreadsheet no larger than 50 MB, with ChangeRequestNumber and Subject columns.

  2. Select the target project.

  3. Optionally select a default assignee.

  4. Select Import to create the Change Requests.

Results are listed per row, showing the CR number and the outcome, so rows that produced an error, a warning, or a failure can be identified and corrected. Valid rows are still imported even when other rows in the same file fail, so a partial result is expected behaviour rather than an all-or-nothing operation.

Tag columns can create new tags

If your spreadsheet includes a Tag: column for a tag that does not yet exist, and the option to create missing tag definitions is enabled, the import creates a new tag definition for it across the whole organisation. This is a real change to the tag catalogue, not just to the Change Requests being imported.

Collection Import

The Collection Import tab imports collections in bulk from an Excel spreadsheet. Each row of the spreadsheet defines one collection, giving its name and description. The file must be an Excel spreadsheet no larger than 50 MB.

An option lets you create sheets named after each collection using the document ID.

Select Import to create the collections. The results list each collection with the number of documents added, any documents that could not be found, and the outcome. As with CR Import, valid rows are imported even when other rows in the same file fail.

Templates

The Templates tab allows you to select the document templates that are viewable for each repository. This tab opens with Administration Pages or Manage Repository Templates. See Templates.

Import/Export

The Import/Export tab allows you to select the import and export templates that are viewable for each repository. This tab opens with Administration Pages or Manage Repository Templates. See Import & Export.

The repository-scoped Import/Export tab, showing which global import and export templates (Import.xlsx, Basic Report.xlsx, CR.xlsx) are linked to the Base repository

Restricted Docs

The Restricted Docs tab lists the restricted documents held in the repository, showing each document's file name, size, and its created and modified dates.

Use the search field to find a document by file name. Long lists are paged.

This tab is gated by the Download Restricted Files access right rather than Administration Pages, and only appears to users who can already open the repository. See Access Rights above.

On this page