Managing assets
Browsing assets
You can browse the Magnolia DAM in three views:
Tree view displays a hierarchical tree, including the folder structure.
List view displays the items individually.
You can sort them alphanumerically by clicking the column headings. |
Thumbnail view displays thumbnail images of the assets. There is a zoom control at the top for resizing.
How to handle large amount of assets
The DAM can handle a very large number of assets. However, if you have more than 20,000 assets, you should organize them into folders. If your number of assets drastically exceeds the 20,000 guideline, we recommend that you use an external storage system with our DAM Connector Pack, our DAM API, or one of our Incubator modules extensions.
As a rule of thumb when using JCR for assets, you should keep it to about 500 assets per folder. This is independent of the asset type. So, whether it’s an image, pdf, or some other type of asset, let’s try to keep it under 500.
Avoid storing too many assets in the same folder. Instead, create subfolders and organize your assets. Storing too many assets within the same folder may lead to performance issues. If you need a large and unstructured flat list of assets, disable the thumbnail and list views.
Supported file formats for preview generation
Searching for an asset
To search for an asset, use the Find Bar at the top of the UI:
You can also narrow your search. Click the funnel button on the right side and refine your search using the options provided: |
Uploading a single asset
To upload an asset:
-
Select a parent folder or upload the image at the root level.
-
Click Upload asset.
-
Select a file to upload or drag and drop it into the Media field.
-
The file uploads.
-
For images, the image details and a thumbnail displays. You can edit the image in Magnolia.
-
For other assets, the file details and an asset type icon displays.
The filename field
In the default configuration, the dialog does not have a field for renaming the filename of the asset.
You can add the field to the dialog by hotfixing the configuration of the dialog.
In the Resource Files app:
-
Open the
/dam-app-jcr/dialogs/uploadAndEdit.yaml
configuration file for editing. -
In the
jcrDetail
part, add thejcr:content:
property shown below to the intended position of the filename field, for example just below the mediaupload
field property. -
Save the updated configuration.
form:
properties:
upload:
factoryClass: info.magnolia.dam.app.field.factory.DamUploadFieldFactory
class: info.magnolia.ui.editor.UploadViewDefinition
required: true
itemProvider:
$type: jcrChildNodeProvider
nodeName: jcr:content
nodeType: mgnl:resource
jcr:content:
$type: compositeField
itemProvider:
$type: jcrChildNodeProvider
properties:
fileName:
$type: textField
label: ""
label: Filename
Afterwards, to bring the modified configuration to life, open /dam-app-core/apps/dam.yaml
for editing and save it without changes.
You can touch any decoration that is part of the Dam app so that the included file changes would be picked up. |
In a similar way, you can also modify the configuration of the Asset (node) rename dialog (/dam-app-jcr/dialogs/rename.yaml
) to enable the filename field there as well:
Import a zip file with the assets app
You can upload a ZIP file in the Asset app in order to import multiple assets.
To import a ZIP file:
-
Click Upload ZIP archive.
-
Select a location. You can choose between:
-
Extract into new folder – Adds a new parent folder (default).
-
Extract here – Extracts the ZIP archive directly into the current folder.
-
-
Browse to the file.
-
In Encoding, select
UTF-8
orCP437
, depending on what system the ZIP file was created on. -
Click Save.
The assets are imported like this:
Extract into new folder | Extract here |
---|---|
Uploading an asset from another app
You can upload an asset into the Magnolia DAM also from any other app that can browse the DAM, for example when creating a new contact in the Contacts app. The procedure and actions are identical to those in the Assets app and work in exactly the same way. You can define app-specific metadata fields which can be different from the standard metadata fields available when uploading in the Assets app.
Deleting an asset
Versioning is enabled in the DAM. This allows you to restore previous versions of an asset or folder. The delete action marks the node for deletion and the deletion is completed on publication of the deletion.
To delete an asset or folder:
-
Select an item.
-
Click Delete folder/asset.
-
Confirm your action in the dialog.This marks the node for deletion and creates a restorable version. The item icon (folder or node) is replaced with the trash bin.
-
Click Publish deletion to complete the deletion. At this point you can cancel the deletion by clicking Restore previous version.
Exporting and importing assets
In the dam
workspace, asset data are stored as binary data under the jcr:data
subnodes. If you export an asset (or folder) from the app, an XML file will be exported and the data will be part of it.
An XML file is therefore expected if you want to import an asset.
Exporting
To export an asset or folder:
-
Select an item or folder.
-
In the Action bar, click Export.
The exported XML file will contain also asset (folder) metadata such as mgnl:activationStatus . If you delete the asset on the author instance, publish the deletion and reimport the asset to the instance, the asset will retain the publication status even though it no longer exists on the public instance.
|
Asset metadata
The metadata fields are located in the Asset dialog. You can set metadata when uploading or add/edit it by clicking Edit asset to open the dialog.
Magnolia native metadata
The system records certain data automatically, with such fields typically disabled. By default, the following fields cannot be edited:
-
Describe asset using: The supported metadata standard. By default, the Simple Dublin Core Metadata Element Set (DCMES) is supported. You can customize Magnolia to support different standards.
-
Identifier: An unambiguous reference to the resource within a given context. An alphanumerical string is used to identify and reference the asset. Editors can move assets without breaking links in the DAM.
-
Type: The nature or genre of the resource.
-
Creation Date: Date of upload.
-
Modification Date: Date of last modification.
-
Creator: An entity responsible for creating the resource (uploading the asset).
Dublin Core metadata
Magnolia supports the Simple Dublin Core Metadata Element Set (DCMES) standard by default and the following fields are available:
-
Caption: The asset caption.
-
Language: Language tag of the asset. Recommended best practice is to use a controlled vocabulary such as RFC 4646.
-
Title: Asset title.
-
Subject: The topic of the asset. Typically, the subject will be represented using keywords, key phrases, or classification codes.
-
Coverage: Scope of the asset. Typically this refers to a place, period or jurisdiction.
-
Description: Full description of the asset.
-
Publisher: Original publisher of the asset if being republished from another source.
-
Contributor: Use to name asset contributors.
-
Rights: Type of copyright.
-
Source: A related asset from which this asset is derived.
-
Relation: Related assets.