Story: Customizing the Manage Assets UI

Narrative

The Manage Assets tool can be customized as required for your project. This user story describes how to perform some of the common customizations.

View full size graphic
Manage Assets UI

Estimated time to implement the story

Depending on the level of customization you require, the time to implement this user story can take a few minutes to several days.

Common questions to ask to clarify requirements

Not applicable to this user story.

Requirements addressed

Not applicable to this user story.

Implementation overview

Restyling and rebranding the UI

The Manage Assets tool uses three building blocks, the Asset Manager, Asset Composer and Data Dictionary. (For details, see Asset Manager Building Block Technical Guide , Asset Composer Building Block Technical Guide , and Data Dictionary Building Block Technical Guide . These building blocks contain a set of default styles and contribute to the Flex views which are used by the Manage Assets tool. To change the styles of the Manage Assets UI, changes to the associated the building blocks are required for the overall of user interface components to blend together.

The following three projects are the styles project of the three building blocks:

  • Asset Manager (adobe-amg-flex-presentation_styles-src)

  • Asset Composer (adobe-acm_styles-src)

  • Data Dictionary (adobe-dct-widgets_styles-src)

The Manage Assets styles are characterized by the following CSS files:

  • css/app.css

  • css/appHeader.css

  • css/appToolbar.css

  • css/appBody.css

  • css/baseControls.css

These CSS files are a part of the ManageTemplates project and can be located in your Flash Builder workspace. After changing these styles, you can include them in the EAR file by running the top level build file placed in the \CorrespondenceManagement\FinancialServicesInsurance\build directory. That would update the EAR placed in the \CorrespondenceManagement\FinancialServicesInsurance\deploy directory.

To change the Finance Corporation Logo that appears on top left of the Manage Assets UI:

  1. Open the Manage Templates project in the Package Explorer view.

    Note: In the solution template, the Manage Assets UI has been named “Manage Templates”.
  2. Navigate to Manage Templates > src > css > appHeader.css > GradientHBoxWH.appHeaderLogo > background-image: Embed(source='/assets/icons/appHeader/F...)

  3. Replace the path with a custom logo image file.

  4. Rebuild and Redeploy. See Setting up the Development Environment in the Asset Manager Building Block Technical Guide .

To change the background color of the editors:

  1. Open the adobe-acm_styles project in your Flash Builder workspace.

  2. In the Package Explorer view, navigate to adobe-acm_styles> css > editorCommon.css and double click to open it in the Editor.

  3. Change the style backgroundColor from #eeeee to any color hex code of your choice.

  4. Rebuild and Redeploy. For rebuilding EAR steps, refer the Setting up the Development Environment guide.

  5. Launch the Manage Assets application and open the Text Editor to verify the change.

Localizing the UI

The Managed Assets UI can be localized. For details on how to localize the Managed Assets UI see Supporting Japanese language , the process is similar for other locales.

Adding a new property to the Properties tab of an Editor

You can add a new property such as “Department” to the Properties tab on any of the Editors in the Manage Assets UI. For instructions, see Adding custom fields to asset definitions in the Asset Composer Building Block Technical Guide .

Configuring the Search Results Viewer

You can customize the Search Results Viewer (the main grid-like area in the Manage Assets UI) to show relevant columns, and specify their order. For instructions, see Adding custom search attributes to the Advanced Search pod in the Asset Manager Building Block Technical Guide .

Configuring custom actions on the Manage Assets toolbar

You can add custom actions such as “send for review” to the toolbar in the Manage Assets UI. For instructions, see Adding custom action buttons in the Asset Manager Building Block Technical Guide .

Tools used

You should have LiveCycle ES2.5 and the Correspondence Management Solution Accelerator installed on your system. After installing, you should be able to locate the SA SDK folder at the following location: C:\Adobe\Adobe LiveCycle ES2\sa_resources\SA_SDK_9.5.

The Correspondence Management Solution Accelerator and all the related building blocks are developed using Flex SDK 3.4.1. It is therefore strongly recommended that you download and use the specified SDK version. The SDK 3.4.1 comes bundled with Workbench. The Correspondence Management Solution Accelerator comes with several Flash Builder projects which you will need to import into Flash Builder in order to customize.

Apache ANT is required for building the individual projects or the top level EAR file.

Team members

This user story is performed by the Flex Developer.

Best practices/tips and tricks

Not applicable to this user story.

Legal Notices | Online Privacy Policy


undefined
// Ethnio survey code removed