Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
249 lines (177 sloc) 11.5 KB
title review labels toc confluence tree_item_index history
Digital Asset Management with the Nuxeo Platform
comment date status
2018-01-19
ok
multiexcerpt
multiexcerpt-include
lts2017-ok
true
ajs-parent-page-id ajs-parent-page-title ajs-space-key ajs-space-name canonical canonical_source page_id shortlink shortlink_source source_link
11043048
Nuxeo Platform User Documentation
USERDOC
Nuxeo Platform User Documentation
Digital+Asset+Management+with+the+Nuxeo+Platform
26312925
3YCRAQ
/display/USERDOC/Digital+Asset+Management+with+the+Nuxeo+Platform
1800
author date message version
Solen Guitter
2016-04-20 08:00
6
author date message version
Manon Lumeau
2016-04-19 15:36
5
author date message version
Solen Guitter
2016-04-18 17:49
Add note about annotations removed from 8.2
4
author date message version
Solen Guitter
2015-08-27 12:48
3
author date message version
Solen Guitter
2015-07-10 09:30
2
author date message version
Solen Guitter
2015-07-10 09:30
1

{{! multiexcerpt name='Functional_overview'}}

The Nuxeo DAM document types are fully integrated in the Nuxeo Platform and are available alongside the other document types. They can be created the same ways as the platform default document types, they get the same metadata, the same workflows, etc.

JSF UI

Pictures

Pictures are specific files. To take into account the specificities of pictures, their Summary tab shows additional pieces of information, such as:

  • Rotate actions
  • The picture's EXIF metadata
  • Additional picture views

Pictures can be [created]({{page page='creating-content'}}) and [edited]({{page page='editing-content'}}) in workspaces and folders like any other document type. You can also classify and organize them in [collections]({{page space='nxdoc' page='collections'}}).

When pictures are created, the EXIF metadata of the pictures are automatically extracted and displayed on the Summary tab. They cannot be modified. The IPTC legend, copyright and source are used to automatically fill in the description, rights and source metadata. See the page [Binary Metadata]({{page space='nxdoc' page='binary-metadata'}}) for more information.

![]({{file name='picsMetadata.png' space='nxdoc' page='digital-asset-management-dam'}} ?w=450,border=true)

You can report to the page [Supported File Formats]({{page space='nxdoc' page='supported-file-formats'}}) to see which file formats are supported as pictures.

Browsing Pictures

Nuxeo DAM add the possibility to view pictures in a slideshow mode from the thumbnail mode of a workspace or search results. To view the pictures in a slideshow mode, click on the icon ![]({{file name='slideshow_enabled.png' page='icons-index'}}) from the thumbnail mode. You can then switch from one picture to the next or the previous using the right and left keys of you keyboard. You automatically go the next page picture when you're at the last picture of the current page.

If no picture is available on the current page, it shows the icon ![]({{file name='slideshow_disabled.png' page='icons-index'}}).

Picture Views

When you import a document having the Picture facet on your platform, additional formats are available on it. The default ones are:

  • Thumbnail: the picture is converted to JPG and resized to 100 px height or width.
  • Small: the picture is converted to JPG and resized to 280 px height or width.
  • Medium: the picture is converted to JPG and resized to 550 px height or width.
  • FullHD: the picture is converted to JPG and resized to 1,920 px height or width.
  • OriginalJpeg: the picture is converted to JPG but the original size is kept. This export is done even if the original picture was a JPG file. {{#> callout type='tip' }} The original and medium pictures can be the same size when you download them if the original is smaller or equal to medium size. {{/callout}}

To download the picture view that you want, click on ![]({{file name='download.png' space='userdoc' page='icons-index'}}) in front of it.

![]({{file name='Additionnal Picture Views Download.png' space='nxdoc' page='digital-asset-management-dam'}} ?w=600,border=true)

{{#> callout type='info' }}

To contribute new picture views, follow [How to Contribute Picture Conversions]({{page space='nxdoc' page='how-to-contribute-picture-conversions'}}).

{{/callout}}

A user interface is added in the Admin tab so that it is possible to re-compute picture conversions (Picture views). This is particularly useful when you add new conversions and want to compute them over existing images, or if you change the definition of some of the existing conversions.

![]({{file name='Admin Picture Conversions.png' space='nxdoc' page='digital-asset-management-dam'}} ?w=650,border=true)

Video

Video is a document type dedicated to the management of videos files. It provides the following specific features: A player to view the video from the application, a storyboard to navigate in the video and alternative video formats.

Video documents can be [created]({{page page='creating-content'}}) and [edited]({{page page='editing-content'}}) like any other document type. See the page [Supported File Formats]({{page space='nxdoc' page='supported-file-formats'}}) for supported video files.

![]({{file name='video_document_type.png' space='nxdoc' page='digital-asset-management-dam'}} ?w=600,border=true)

Viewing Videos

Video documents can be viewed from their Summary tab where a video player is available. You can also navigate in the video using the Storyboard that is generated at import time.

Converting Videos

It is possible to convert the video to various formats from the user interface:

  • Ogg
  • WebM
  • MP4

To convert the video, from the Summary tab click on the Convert button corresponding to the format you want.

Exporting Videos

When your export a video asset, you get a folder with several files available:

  • The original video file
  • One WEBM conversion
  • One MP4 conversion
  • One JPEG picture by storyboard chapter
  • One JPG picture prefixed with "StaticPlayerView_video-screenshot-", which is the picture extracted from the video that is used for the player picture
  • One JPG picture prefixed with "Thumbnail_video-screenshot-", which is the thumbnail used in folders proposing a thumbnail view (typically in the DAM view)

A video is exported like any other document. See the page [Exporting Documents]({{page page='exporting-documents'}}).

Audio

Audio is a document types dedicated to audio files management. It provides a player from the document Summary tab to listen to it from the application.

Audio documents can be [created]({{page page='creating-content'}}) and [edited]({{page page='editing-content'}}) like any other document type. They don't have any specific tab or action available.

See the page [Supported File Formats]({{page space='nxdoc' page='supported-file-formats'}}) for supported audio files.

![]({{file name='audio_document_type.png' space='nxdoc' page='digital-asset-management-dam'}} ?w=600,border=true)

Web UI

Pictures

Pictures are specific files. To take into account the specificities of pictures, additional information are available such as:

  • Rotate actions
  • Dimensions
  • Format
  • ...

![]({{file name='picsMetadata-webui.png' space='nxdoc' page='digital-asset-management-dam'}} ?w=600,border=true)

Pictures can be created and edited in workspaces and folders like any other document type. You can also classify and organize them in collections.

![]({{file name='Additionnal Picture Views Download-webui.png' space='nxdoc' page='digital-asset-management-dam'}} ?w=300,border=true)

When you import a document having the Picture facet on your platform, additional formats are available on it. The default ones are:

  • Thumbnail: the picture is converted to JPG and resized to 100 px height or width.
  • Small: the picture is converted to JPG and resized to 280 px height or width.
  • Medium: the picture is converted to JPG and resized to 550 px height or width.
  • FullHD: the picture is converted to JPG and resized to 1,920 px height or width.
  • OriginalJpeg: the picture is converted to JPG but the original size is kept. This export is done even if the original picture was a JPG file. {{#> callout type='tip' }} The original and medium pictures can be the same size when you download them if the original is smaller or equal to medium size. {{/callout}}

To download the format that you want, click on ![]({{file name='download.png' space='userdoc' page='icons-index'}}) in front of it.

Videos

Video is a document types dedicated to the management of videos files and can be created or edited like any other files.

![]({{file name='video_document_type-webui.png' space='nxdoc' page='digital-asset-management-dam'}} ?w=600,border=true)

Viewing Videos

Video documents can be viewed from their View tab where a video player is available.

Converting Videos

It is possible to convert the video to various formats from the Web UI user interface:

  • WebM
  • MP4

To convert the video, click on ![]({{file name='download.png' space='userdoc' page='icons-index'}}) corresponding to the format you want.

Browsing Assets

{{! multiexcerpt name='assets-search'}} Once DAM installed and assets documents created, a new search type is displayed in the left menu, the Assets search. This search will let you search by assets metadata, such as:

  • Type
  • Format
  • Width
  • Height
  • Etc.

The Assets search leverages Elasticsearch to provide a quicker and more efficient search. The search form uses Elasticsearch aggregates for most fields: aggregate fields values are filtered so as to display only relevant values and show the count of matching documents for each value.

![]({{file name='assets-search.png' space='nxdoc' page='digital-asset-management-dam'}} ?w=600,border=true)

The Assets search form offers several search criteria, that you can associate to define your search and find documents. Search results use the thumbnail view by default. Clicking on a document thumbnail will lead you directly to the document.

To search documents using detailed criteria:

  1. Click on the Assets tab.
  2. Fill in the form with your criteria and/or select the search criteria corresponding to your needs.

The search results will be automatically updated according to the criteria selected.

{{! /multiexcerpt}} {{! /multiexcerpt}}

{{#> panel heading='Related User Documentation'}}
  • [Creating Content]({{page page='creating-content'}})
  • [Editing Content]({{page page='editing-content'}})
  • [Collections]({{page page='collections'}})

{{/panel}}

{{#> panel heading='Other Related Documentation '}}
  • [DAM developer documentation]({{page space='nxdoc' page='digital-asset-management-dam'}})
  • [How to Contribute a New Video Conversion]({{page space='nxdoc' page='how-to-contribute-a-new-video-conversion'}})
  • [How to Contribute Picture Conversions]({{page space='nxdoc' page='how-to-contribute-picture-conversions'}})

{{/panel}}

You can’t perform that action at this time.