Documentation

Asset Repository

Asset repository allows you to store and access all assets used in your projects in an easy and intuitive way..

Accessing the repository

There are two ways to access the asset repository:

  • Through the Company Administration Panel, using the Asset Repository link.
  • Through the Project view, by clicking the 'Assets' option in the left-hand side of the page.

The former option will be displaying assets for the entire company by default, while the latter — only the assets for the selected project.

Adding new assets to the repository

Updating the repository

Initially, the repository will contain no assets – it has to be updated using the "Update asset repository" button in the top right part of the screen. This needs to be done each time the new assets that you'd like to be stored in the repository have been added to one of the lessons. You may update either the entire repository or a specific project/publication – you do that by first selecting the appropriate space from the projects tree on the left side of the screen. The update is going to proceed in the background. For each project, you will receive an email once its update is completed.

If the same file is featured in multiple lessons, it will be added as separate assets for each lesson, receiving the metadata of its respective content.

Uploading new assets

You may also add completely new assets that are not currently used in any of the projects to the repository, by clicking the "Upload asset" option in the upper right part of the screen and selecting the file you wish to add. The newly created asset will be assigned to the currently selected space in the projects tree and will have no custom metadata be default.

Removing assets

In order to delete an asset from the repository, you should select the asset you wish to remove, and then press the "Delete asset" button in the center-right part of the screen (the black trashcan icon). You should keep in mind this is a permanent action and updating the repository will not add the asset again.

Searching through the assets

Search

You may search for assets containing specific words or phrases using the 'Search' bar in the upper right part of the screen. You will find more information on the subject on the Asset Repository query syntax page.

Projects tree

On the left-hand side of the screen you will find the projects tree. It allows you to filter the assets so that only those belonging to a specific project or publication are displayed. The name of the currently selected space is bolded. If you wish to search through all assets, please select the "All" option.

Filtering

By selecting the 'Filters' option (the black funnel icon in the upper right part of the screen) you may choose which file types (images, audio files, video files, lesson pages) will be displayed.

Asset details

After clicking on one of the asset tiles, its detailed information will be displayed on the right-hand side of the screen. Doing so will also enable several additional options, such as deleting the asset or editing its metadata.

Project, publication, lesson

At the top of the asset details section, right beneath the asset's name, you will find the names of the project, publication and lesson where the asset was found. Clicking on one of those fields will link to the appropriate view. Not all of them may be available, for instance there will be no "Lesson" field if the asset has been added to the repository by using the "Upload asset" option.

Download and preview

Clicking on the 'URL' field in the asset details will open the file in another window or tab, while the 'Download' field will download it to your device. It should be noted that in case of the lesson pages that file is an xml – should you wish to open the selected page in the Player, please click the "Preview" field.

Access rights warning

When displaying the asset details you may see a warning asking you to ensure that you have the appropriate license to use it. This usually occurs when the same file is found in repositories of multiple companies, or when the file is hosted outside mAuthor. Should you wish to reuse that asset in another lesson or project, please make sure that you have all legal rights to do so.

Metadata

Here you will find the asset's custom metadata. By default, any asset added by updating the repository will receive the following fields: "short description", "title", "description" and "tags" based on the lesson where it has been found. Uploaded assets will have no custom metadata by default. These can be used for searching just like any other field (more information in the "Searching through the assets" paragraph). In order to add, edit, or remove individual fields, you should first select the "Edit asset" button (black pencil icon to the right of the "Metadata" header). Once done editing, you must select either the "Save changes" or "Abandon changes" button in the same location.