Table of Contents

ADAM - Automatic Digital Asset Management

you are here (click to zoom) - discover the stack

In a CMS environment, images and PDFs usually belong to a content-item. The user shouldn't have to worry about saving it in the right place. Ideally it's only used there, and when the content becomes obsolete, so do the assets that belong to it.

Tip

This is what ADAM is all about. It allows editors to just add images and files. ADAM will take these and magically store it somewhere so the user doesn't have to worry about folders and naming.

Warning

Since ADAM does everything behind the scenes, it's recommended that users don't try to link to files of another content-item, because that would defeat the purpose. It would also not allow any clean-up in future, because you wouldn't know if the asset was re-used.

How ADAM works

Internally ADAM creates a folder for each Entity (Content-Item) using the GUID of that item. It also creates a sub-folder for each field, so that a logo.png used in the Logo-field is separate from a my-case-study.pdf used in the CaseStudy-field.

The final folder structure looks like this

[Content-Root]/adam/[App-Folder-Name]/[Compact-Entity-Guid]/[Field-Name]/

How to Use

ADAM is a standard part of 2sxc, it's automatically in use everywhere. Any link/file or wysiwyg field support drag-and-drop and will automatically store the file in the right place.

Security Concerns

ADAM uses the Dnn file-numbering system by default, and keeps a reference to file:27 in the field linking such a file. In rare situations you may have many untrusted editors, where you want to prevent them asking the API for file:1, file:2, file:3 etc. There is an advanced switch to only allow resolving the file number if it's really part of the current item. Contact 2sxc for support on this.

Also Read

Platform Differences Dnn ☢️ & Oqtane 🩸

ADAM Content-Root Folder

In Dnn ☢️ the adam root is:

[Website-Root]\Portals\[site-id]\adam\

In Oqtane 🩸 the adam root is:

[Website-Root]\Content\Tenants\[Tenant-Id]\Sites\[Site-Id]\adam\

Adam File URLs

Dnn ☢️ urls look like this:

[Domain]/Portals/[Site-Id]/adam/[App-Folder-Name]/[Short-Guid]/[Field-Name]/[Optional-Subfolders]/FileName.Ext

Oqtane 🩸 urls will probably look like this:

[Domain]/adam/[App-Folder-Name]/[Short-Guid]/[Field-Name]/[Optional-Subfolders]/FileName.Ext


History

  1. General Tokens introduced in 2sxc 8.0
  2. Added extra security switch in 2sxc 9.32