Asset Composer building block basics

The Asset Composer (ACM) building block is part of the Correspondence Management Solution, available with Adobe® LiveCycle® Enterprise Suite 3 (ES3). The Asset Composer building block provides core correspondence management capabilities such as asset (text, image, list, condition, and letter template) creation and document rendering. The Asset Composer building block consists of server-side components that are delivered as Spring Beans (OSGi Services), and user interface (Flex) components that are delivered as Presentation/Domain models and resource bundles. The server-side beans are exposed over Flex Remoting.

Building block structure

The Asset Composer building block is delivered as a CRX package which you can unzip to any installation directory. All of CRX packages fit into one one the following categories:

  • Platform packages: Packages that contribute to the complete Adobe Enterprise Platform.

  • Building block packages: Packages that contribute to the full range of Building Blocks that Partners use to help build custom solutions.

  • Solution template packages: Packages for demonstration components of a target solution. This package relies on building blocks already deployed on LiveCycle.

  • Solution packages: Includes a Solution Template and a set of building blocks all merged into one CRX package.

The Asset Composer building block contains two packages:

  • bb-assetcomposer-pkg-<version_number>.zip: Assets used to deploy and run the Asset Composer building block.

  • bb-assetcomposer-sdk-pkg-<version_number>.zip: ActionScript and Java Developer SDK for the Asset Composer building block.

Each Solution Template for LiveCycle provides one CRX package. This package contains a Sling Web Application used to demonstrate the Solution as well as all other assets run an example solution. Applications can be AIR applications, Forms, and LiveCycle assets such as custom DSCs and sample processes. The package for the Correspondence Management Solution Template is template-correspondencemanagement-pkg.zip.

APIs and Components

The following APIs and components are delivered with the Asset Composer building block.

SWC Path

Description

[SDK]/riaservices/assetcomposer/10.0.0.0/flex/xfalib.swc

Utility library provides some APIs related to XFA parsing and processing in ActionScript.

[SDK]/riaservices/assetcomposer/10.0.0.0/flex/adobe-acm-flex-utilities.swc

This utilities SWC contains a set of utility classes used by various ACM SWCs.

[SDK]/riaservices/assetcomposer/10.0.0.0/flex/adobe-acm-services-impl.swc

The infrastructure services for the ACM building block. This SWC contains classes that provide client APIs for calling the backend server APIs encapsulating the creation of channels and remote objects.

[SDK]/riaservices/assetcomposer/10.0.0.0/flex/adobe-acm-services-mock.swc

The SWC library that contains mock representations for all the infrastructure services of the ACM building block. This SWC can optionally be used for developing Flex views without actually running a server in the backend..

[SDK]/riaservices/assetcomposer/10.0.0.0/flex/adobe-acm-authoring-rb.swc

The resource bundles SWC for the authoring part of the Asset Composer building block. This SWC file contains bundles for all supported locales

[SDK]/riaservices/assetcomposer/10.0.0.0/flex/adobe-acm-authoring-domain-impl.swc

The domain library for the authoring part of the Asset Composer building block. It contains various domain classes encapsulating business data and behavior, and can be leveraged to build Flex views atop with less effort.

[SDK]/riaservices/assetcomposer/10.0.0.0/flex/adobe-acm-authoring-presentation.swc

The presentation SWC for the authoring part of the ACM building block. This SWC contains the Host Component and the Flex views that encompass various editors in the ACM building block.

[SDK]/riaservices/assetcomposer/10.0.0.0/flex/adobe-acm-authoring-styles.swc

The styles ans skins SWC for authoring the Asset Manager Building Block. This SWC file contains the Skins, the style sheets and various assets (such as animations, icons, skins) for Host Components available in adobe-acm-authoring-presentation.swc.

[SDK]/riaservices/assetcomposer/10.0.0.0/flex/adobe-acm-ccr-rb.swc

The resource bundles SWC for the Create Correspondence part of the Asset Composer building block. This SWC file contains bundles for all supported locales.

[SDK]/riaservices/assetcomposer/10.0.0.0/flex/adobe-acm-ccr-domain-impl.swc

The domain library SWC for the Create Correspondence part of the Asset Composer building block.

[SDK]/riaservices/assetcomposer/10.0.0.0/flex/adobe-acm-ccr-presentation.swc

The presentation SWC for the Create Correspondence part of the ACM building block. This SWC contains the Host Component and the Flex views that encompass CCR user interface in the ACM building block.

[SDK]/riaservices/assetcomposer/10.0.0.0/flex/adobe-acm-ccr-styles.swc

The styles ans skins SWC for Create Correspondence part of the ACM building block. This SWC file contains the Skins, the style sheets and various assets (animations, icons, skins, and so on) for Host Components available in adobe-acm-ccr-presentation.swc.

Building Block Configurations

The Asset Composer building block can be modified with solution-specific configurations. These configuration files are read from the LiveCycle Content Repository. You can find the configuration files in the /etc/aep/config/assetcomposer/<Solution App root> folder. For example:
  • /etc/aep/config/correspondencemanagement/ACLConfig.xml: The configuration file to define/configure ACLs applied on various asset folders.

  • Find this in acmExtensions folder./etc/aep/config/assetcomposer/apps/cm/acmExtensions/acmExtensionsConfig.xml: The configuration file to define/configure various action buttons for assets and correspondences.

Properties

The Asset Composer Building Block exposes the following configurable properties:
  • Indentation on modules. Defaults to 12.7mm (0.5 inches). This value can be any number.

  • Minimum width for the bullet/number field, when using numbered Lists apart from Roman numbers. Defaults to 8mm (0.3 inches). This value can be any number.

  • Minimum width for the bullet/number field, when using Roman numbers. Defaults to 12.7mm (0.5 inches). This value can be any number.

  • Target Highlight Type in the Create Correspondence application. Acceptable values are border, fill, and none.

  • Target Highlight Color in the Create Correspondence application. Acceptable values are any RGB color in format R;G;B.

  • Content Highlight Type in the Create Correspondence application. Acceptable values are border, fill, and none

  • Content Highlight Color in the Create Correspondence application. Acceptable values are any RGB color in format R;G;B

  • Field Highlight Type in the Create Correspondence application. Acceptable values are border, fill, and none.

  • Field Highlight Color in the Create Correspondence application. Acceptable values are any RGB color in format R;G;B

  • PDF Form Cache Enabled. Defaults to false.

  • PDF Form Debug Enabled. Defaults to false.

  • PDF Form Acrobat Version. Defaults to 8.

  • Non-interactive PDF Cache Enabled. Defaults to false.

  • Non-interactive PDF Debug Enabled. Defaults to false.

  • Non-interactive PDF Acrobat Version. Defaults to 8.

  • Parameter name for PDF document in post process. Defaults to 'inPDFDoc', but can be any string variable name.

  • Parameter name for XML document (data) in post process. Defaults to 'inXMLDoc', but can be any string variable name.

  • Parameter name for redirected URL. Defaults to 'redirectURL'.

  • PDF Submit Type (type of PDF generated on submitting from the Create Correspondence application). Acceptable values are interactive and non-interactive, if not specified it defaults to non-interactive.

  • Application Time Out. Defaults to 20 minutes.

  • Use Configured Data Formats

  • Data Display Formats

  • Data Edit Format

To configure these properties, open the following URL in a browser: http://<server>:<port>/lc/system/console/configMgr

and select Asset Composer Configurations.

// Ethnio survey code removed