Create and configure Asset Editor pages creating-and-configuring-asset-editor-pages
This document describes the following:
- Why you would create customized Asset Editor pages.
- How to create and customize Asset Editor pages, which are WCM pages that let you view and edit metadata as well as perform actions on the asset.
- How to edit multiple assets simultaneously.
Why Create and Configure Asset Editor Pages? why-create-and-configure-asset-editor-pages
Digital Asset Management is being used in more and more scenarios. When moving from a small-scale solution for a small user group of professionally trained users - for example photographers or taxonomists - to larger and more diverse user groups - for example business users, WCM authors, journalists, and so on - the powerful user interface of Adobe Experience Manager Assets for professional users can provide too much information and stakeholders start to request specific user interfaces or applications to access the digital assets that are of relevance to them.
These asset-centric applications can be simple photo galleries in an intranet where employees can upload photos from trade show visits or a press center in a public-facing website, such as the example provided with Geometrixx. Asset-centric applications can also extend to complete solutions including shopping carts, checkout, and verification processes.
Creating an asset-centric application becomes to a large extent a configuration process that does not require coding, only knowledge of user groups and their needs as well as knowledge of the metadata being used. Asset-centric applications created with Assets are extensible: with moderate coding effort reusable components for searching, viewing, and modifying assets can be created.
An asset-centric application in Experience Manager consists of an Asset Editor page, which can be used to get a detailed view of a specific asset. An Asset Editor page also allows for the editing of metadata, provided the user accessing the asset has the necessary permissions.
Create and configure an Asset Share page creating-and-configuring-an-asset-share-page
You customize the DAM Finder functionality and create pages that have all the functionality you require, which are called Asset Share pages. To create a new Asset Share page, you add the page using the Geometrixx Asset Share template and then you customize the actions users can perform on that page, determine how viewers see the assets, and decide how users can build their queries.
Here are some use cases for creating a customized Asset Share page:
- Press Center for Journalists
- Image Search Engine for internal business users
- Image Database for website users
- Media Tagging Interface for metadata editors
Create an Asset Share page creating-an-asset-share-page
To create a new Asset Share page, you can either create it when you are working on web sites or from the digital asset manager.
To create an new Asset Share page in the Websites console:
-
In the Websites tab, navigate to the place where you want to create an asset share page and click New.
-
Select the Asset Share page and click Create. The new page is created and the asset share page is listed in the Websites tab.
The basic page created using the Geometrixx DAM Asset Share template looks as follows:
To customize your Asset Share page, you use elements from the sidekick and you also edit query builder properties. The page Geometrixx Press Center is a customized version of a page based on this template:
To create a new asset share page via the digital asset manager:
-
In the digital asset manager, in New, select New Asset Share.
-
In the Title, enter the name of the asset share page. If desired, enter a name for the URL.
-
Double-click the asset share page to open it and configure the page.
By default, when you create an Asset Share page from New, an Asset viewer and Asset editor are automatically created for you.
Customize actions customizing-actions
You can determine what actions users can perform on selected digital assets from a selection of predefined actions.
To add actions to the Asset Share page:
-
In the Asset Share page that you want to customize, click Actions in the sidekick.
The following actions are available:
-
Drag the appropriate action to the Actions area on the page. Doing so creates a button that is used to execute that action.
Determine how search results are presented determining-how-search-results-are-presented
You determine how results are displayed from a predefined list of lenses.
To change how search results are viewed:
-
In the Asset Share page that you want to customize, click Search.
-
Drag the appropriate lens to the top center of the page. In the Press Center, the lenses are already available. Users press the appropriate lens icon to display search results as desired.
The following lenses are available:
Mosaic Lens mosaic-lens
List Lens list-lens
Customize the Query Builder customizing-the-query-builder
The query builder lets you enter search terms and create content for the Asset Share page. When you edit the query builder, you also get to determine how many search results are displayed per page, which asset editor opens when you double-click an asset, the path the query searches, and customizes nodetypes.
To customize the query builder:
-
In the Asset Share page that you want to customize, click Edit in the Query Builder. By default, the General tab opens.
-
Select the number of results per page, the path of the asset editor (if you have a customized asset editor) and the Actions title.
-
Click the Paths tab. Enter a path or multiple paths that the search will run. These paths are overwritten if the user uses the Paths predicate.
-
Enter another node type, if desired.
-
In the Query Builder URL field, you can override or wrap the query builder and enter the new servlet URLs with the existing query builder component. In the Feed URL field, you can override the Feed URL as well.
-
In the Text field, enter the text you want to appear for results and page numbers of results. Click OK when finished making changes.
Add predicates adding-predicates
Experience Manager Assets includes a number of predicates that you can add to the Asset Share page. These let your users further narrow searches. In some cases, they may override a query builder parameter (for example, the Path parameter).
To add predicates:
-
In the Asset Share page that you want to customize, click Search.
-
Drag the appropriate predicates to the Asset Share page underneath the query builder. Doing so creates the appropriate fields.
The following predicates are available:
For more information, see the predicate javadocs.
-
To configure the predicate further, double-click it. For example, when you open the Path Predicate, you need to assign the root path.
Create and configure an Asset Editor page creating-and-configuring-an-asset-editor-page
You customize the asset editor to determine how users can view and edit the digital assets. To do this, you create a new Asset Editor page and then customize the views and the actions users can perform on that page.
/apps/dam/content/asseteditors.Creat the Asset Editor page creating-the-asset-editor-page
When creating the Asset Editor page, a good practice is to create the page directly below the Asset Share page.
To create an Asset Editor page:
-
In the Websites tab, navigate to the place where you want to create an asset editor page and click New.
-
Select Geometrixx Asset Editor and click Create. The new page is created and the page is listed in the Websites tab.
The basic page created using the Geometrixx Asset Editor template looks as follows:
To customize your Asset Editor page, use elements from the sidekick. The Asset Editor page that is accessed from the Geometrixx Press Center is a customized version of a page based on this template:
Set which Asset Editor opens from an Asset Share page setting-which-asset-editor-opens-from-an-asset-share-page
After you have created the customized Asset Editor page, you need to ensure that when you double-click assets that the customized Asset Share you created opens the assets in the customized Editor page.
To set the Asset Editor page:
-
In the Asset Share page, click Edit next to the Query Builder.
-
Click the General tab if it is not already selected.
-
In the Path of Asset Editor field, enter the path to the asset editor you want the Asset Share page to open assets in and click OK.
Add Asset Editor components adding-asset-editor-components
You determine what functionality an asset editor has by adding components to the page.
To add asset editor components:
-
In the Asset Editor page that you want to customize, select Asset Editor in the sidekick. All available asset editor components are displayed.
note note NOTE What you can customize depends on what components are available. To enable components, go to Design mode and select the components you need enabled. -
Drag the components from the sidekick to the asset editor and make any modifications in the component dialogs. The components are described in the following table and described in the detailed instructions that follow.
note note NOTE When designing the asset editor page, you create components that are either read-only or editable. Users know a field can be edited if an image of a pencil appears in that component. By default, most components are set up as read-only. table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 Component Description Metadata Form and Metadata Text Field Lets you add additional metadata to an asset and perform an action, such as submitting, on that asset. Sub Assets Lets you customize sub-assets. Tags Lets users select and add tags to an asset. Thumbnail Shows a thumbnail of the asset, its filename, and lets you add an alternate text. You can add asset editor actions here as well. Title Displays the asset title, which can be customized. 
Metadata Form and Text Field - Configuring the View Metadata Component metadata-form-and-text-field-configuring-the-view-metadata-component
The Metadata Form is a form that includes a start and end action. In between, you enter Text fields. See Forms for more information on working with forms.
-
Create a start action by clicking Edit in the Start area of the form. You can enter a Box title, if desired. By default, the Box title is Metadata. Select the Client Validation check box if you want the java-script client code for validation generated.
-
Create an End action by clicking Edit in the End area of the form. For example, you may want to create a Submit button to allow users to submit their metadata changes. Optionally, you can add a Reset button that resets the metadata to its original state.
-
In between the Form Start and the Form End, drag Metadata Text Fields to the form. Users populate metadata into these text fields, which they can submit or complete another action on.
-
Double-click the field name, for example, Title to open the metadata field and make changes. In the General tab of the Edit Component window, you define the namespace and the field label as well as type, for example,
dc:title.
See Customizing and Extending Assets for information on modifying the namespaces available in the metadata form.
-
Click the Constraints tab. Here you can select whether a field is required and if necessary, add any constraints.
-
Click the Display tab. Here, you can enter a new width and number of rows for the metadata field. Select the Field is read only checkbox to allow users to edit the metadata.
The following is an example of a Metadata form with various fields:
On the Asset Editor page, users can then enter values into the metadata fields (if they are editable) and perform the end action (for example, submitting the changes).
Sub Assets sub-assets
The Sub Assets component is where you can view and select sub-assets. You can determine what names appear under the main asset and sub-assets.
Double-click the Sub Assets component to open the sub assets dialog where you can change the titles for the main asset and any sub assets. The default values appear below the corresponding field.
The following is an example of a populated Sub Assets component:
For example, if you select a sub asset, note how the component displays the appropriate page and the Box title changes from Sub Assets to Siblings.
Tags tags
The Tags component is a component where users can assign existing tags to an asset, which helps later in organization and retrieval. You can make this component read-only, so users cannot add tags, but only view them.
Double-click the Tags component to open the tags dialog where you can change the title from Tags, if desired, and where you can select the allocated namespaces. To make this field editable, clear the Hide Edit button check box. By default, tags are editable.
If users can edit tags, then they can click the pencil to add tags by selecting them from the Tags drop-down menu.
The following is a populated Tags component:
Thumbnail thumbnail
The Thumbnail component is where the asset displays the selected thumbnail (for many of the formats the thumbnail is extracted automatically). In addition, the component displays the filename, and actions that you can modify.
Double-click the thumbnail component to open the thumbnail dialog where you can change the alt text. By default, the thumbnail alt text defaults to Click to download asset.
The following is an example of a populated Thumbnail component:
Title title
The Title component displays the title of the asset and a description.
By default, it is in read-only mode so users cannot edit it. To make it editable, double-click the component and clear the Hide edit button checkbox. In addition, enter a title for multiple assets.
If the Title can be edited, you can add a title and description by clicking the Pencil to open the Asset Properties window. In addition, you can turn the asset on and off by selecting the date and time.
When users edit the Title by clicking the Pencil icon, they can change the Title, Description, and enter On and Off Times to turn the asset on and off.
The following is an example of a populated Title component:
Add Asset Editor actions adding-asset-editor-actions
You can determine what actions users can perform on selected digital assets from a selection of predefined actions.
To add actions to the Asset Editor page:
-
In the Asset Editor page that you want to customize, click Asset Editor in the sidekick.
The following actions are available:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 Action Description Download Lets users download selected assets to their computers. Editors Lets users edit an image (interactive editing) Lightbox Saves assets to a “lightbox” where you can perform other actions on them. This comes in handy when working with assets across multiple pages. Locking Lets users lock an asset. This functionality is not enabled by default and needs to be enabled in the list of components. References Click this to show on what pages the asset is being used. Versioning Lets you create and restore versions of an asset. -
Drag the appropriate action to the Actions area on the page. Doing so creates a button that is used to execute that action.
Edit multiple assets with the Asset Editor page multi-editing-assets-with-the-asset-editor-page
With Assets you can make changes to several assets at once. After having selected assets, you can simultaneously change their:
- Tags
- Metadata
To multi-edit assets with the Asset Editor page:
-
Open the Geometrixx Press Center page at
http://localhost:4502/content/geometrixx/en/company/press.html. -
Select the assets:
- on Windows:
Ctrl + clickeach asset. - on Mac:
Cmd + clickeach asset.
To select a range of assets: click the first asset then
Shift + clickthe last asset. - on Windows:
-
Click Edit Metadata in the Actions field (left part of the page).
-
The Geometrixx Press Center Asset Editor page opens in a new tab. The metadata of the assets are displayed as follows:
- A tag, that does not apply to all the assets but only to a few ones, is displayed in italics.
- A tag that applies to all the assets is displayed with a normal font.
- Metadata other than tags: the value of the field is only displayed if it is the same for all the selected assets.
-
Click Download to download a ZIP file containing the assets original renditions.
-
Click the pencil icon beside the Tags field to edit the tags:
- A tag that does not apply to all the assets, but only to a few ones has a grey background.
- A tag that applies to all the assets has a white background.
You can:
- Click the
xicon to remove the tag for all the assets. - Click the
+icon to add the tag to all the assets. - Click the
arrowand select a tag to add a new tag to all the assets.
Click OK to write the changes to the form. The box beside the Tags field is automatically checked.
-
Edit the Description field. For example set it to:
This is a common description. When a field is edited, its value overwrites the existing values of the selected assets when the form is submitted. The box beside the field is automatically checked when the field is edited.This is a common descriptionWhen a field is edited, its value overwrites the existing values of the selected assets when the form is submitted.
Note: the box beside the field is automatically checked when the field is edited.
-
Click Update Metadata to submit the form and save the changes for all the assets. Only the checked metadata are modified.