Paolo Predonzani edited this page Dec 9, 2017 · 6 revisions

Uploader-plus: an Alfresco uploader that prompts for metadata

If document management systems (DMS) like Alfresco didn't exist, we'd be storing documents on a file-system. The practice of having a shared Z: drive is still common in many teams and small organisations. After all, a "file" system must be good at storing documents, right?

But while file-systems are certainly good at storing, it is not so obvious that they are good at searching, classifying, reporting and policy-enforcing, especially when the number of documents is high. In contrast, this is where a DMS can make a difference.

The DMS advantage is largely based on its ability to handle different content types and the associated metadata. When you have thousands of documents, being able to search for those of type "invoce" with certain metadata for "year", "supplier", "buyer" or "department" is a definite plus.

A document without type or metadata is difficult to search and will tend to get lost in the multitude of other documents. For this reason, organisations want documents to have a type and some metadata at the earliest, ideally as soon as the documents enters the DMS.

With these requirements in mind, the purpose of the uploader-plus plugin is to enhance the standard Alfresco uploader with a mechanism to prompt the user for content type and metadata during the upload process.

The project is hosted on GitHub and is licensed under the LGPL.

Drop-in replacement

Uploader-plus is an enhancement of the standard uploader and integrates perfectly in Alfresco's user interfaces.

Alfresco uploader-plus: upload dialog

For maximum compatibility the plugin supports the three upload variants (Flash, HTML and drag-and-drop) in both single and multiple upload modes.

Metadata form

For each document to upload, the plugin prompts for a type and the associated metadata. Fields are subject to validation. It is NOT possible for a user to upload a document without metadata or with incorrect values.

Alfresco uploader-plus: metadata form

Content type selection

The user is offered a list of allowed content types for the destination folder. Different folders can have different allowed content types. One folder could allow only marketing documents while another could allow only HR documents. The rules are configurable from an admin interface as explained in the following section.

Alfresco uploader-plus: content type selection

Admin interface

The plugin adds a new item in Share's admin tools. The admin interface allows to manage the upload folders and their associated content types.

Alfresco uploader-plus: admin interface

An upload folder can be any folder in the repository, typically a folder in a Share site.

Alfresco uploader-plus: admin selection of folder

The administrator can pick the allowed types from a list of all the content types in the system.

Alfresco uploader-plus: admin selection of allowed types


Uploader-plus supports English, Italian and Brazilian Portuguese out of the box and can be translated into other languages easily.

Alfresco uploader-plus: translation in Italian


This project wiki contains further documentation pages: