Skip to main content

MediaAssets

Overview​

1. AccPack_MediaAssets​

The AccPack_MediaAssets gets images of a bucket or planned bucket and converts them to elements for a multiframe placeholder. All placeholders inside the multiframe must support being linked to the MediaAsset identifier. You can use this when you need to place multiple images from a single bucket into a multiframe layout.

2. Architectural Decision: Current Bucket vs. Child Buckets​

Choosing the correct multi-frame image placeholder depends on where the assets are located relative to the linked bucket.

PlaceholderPrimary Data SourceLinkage Logic
AccPack_MediaAssetsCurrent Level (Current Bucket / Planned Bucket)Retrieves multiple images linked directly to the current record.
AccPack_MediaAssetsFromChildrenChild Level (Children or Corded Buckets)Traverses one level down to collect unique images from child buckets or corded buckets.

When to choose AccPack_MediaAssets: A consultant should choose this placeholder when a layout requires multiple images—such as an image gallery or multi-view product shots—that are directly linked to the current bucket. All placeholders inside the resulting multiframe must support being linked to the MediaAsset identifier. If you require sub-templates to be linked to buckets instead of individual assets, you should use AccPack_ChildBucketTemplates.

Technical Specification​

Placeholder type: Multi-Frame

Entity: Works with both planning records and bucket records

Function Variables​

The behavior of the placeholder is controlled through these base and query-specific variables:

  • Template: Select the sub-template that should be built for each identified media asset.

  • Selection: Defines filtering logic based on planning record selection (see Selection Variable Logic below).

  • Result Entity ID: Media asset result entity identifier. If empty, all assets are retrieved.

  • Ranges: (Added by default query) Selects a range of assets (e.g., All, First, Last, 2-Last, 1-2, 2).

  • Sort / Sortorder: (Added by sorted query) Defines the list order (e.g., As is, Sequence, by Label) and direction (Ascending, Descending).

Developer Specifications​

  • Data Query:

    • com.priint.accpack.placeholder.dataquery.MediaAssetQueryPlugin.getListMediaAssetByRange (Default).

    • com.priint.accpack.placeholder.dataquery.MediaAssetQueryPlugin.getListMediaAssetByRangeSorted.

  • Data Mapping: com.priint.pubserver.comet.bridge.datamapping.mediaAssetsToElements.

  • Data Processing:

    • com.priint.pubserver.comet.bridge.dataprocessing.setTemplate: Sets the template for each identified element.

    • com.priint.accpack.placeholder.dataprocessing.setFormatString: (Optional) Allows setting the multiframe format string as a function variable.

Global Configuration Logic​

1. Context Definition​

Generic placeholders default to using the _language and _country parameters.

  • Context Reset: If assets are language-neutral, the context can be reset using the default staticValue Context Rule.

  • Mixed Usage: Use the useDocumentVariableWithEntityCheck rule to automatically skip context if an entity is not dynamic. This requires the Result Entity Id to be specified.

2. Selection Variable Logic​

The Selection variable determines behavior when a planning record is assigned in the Planner UI:

  • Ignore selected content: Every media asset linked to the bucket is recognized, bypassing planner selections.

  • Only selected content: Only returns assets explicitly selected in the planning record.

  • Use all if no content selected: Acts as the fallback state, returning all available assets unless a specific selection exists.

Technical Environment & Deployment​

Consultants could find guide for deployment of generic placeholders here: installation & configuration

Demonstration & Implementation Examples​

Demo data for example:

  • Pre-defined template:

    • Name: AccPack Demo Generic Template

    • ID: 410471354

  • Pre-defined product data:

    • Product: White heart

    • Entity type: product_application

Product image in priint

  • Placeholder options configuration:

    • Template to be used inside frame: AccPack MediaAsset 1/16

    • Result Entity Id: product_application

Product image in priint

  • Pre-defined template inside the frame:

    • Name: AccPack MediaAsset 1/16

    • ID: 410524265

AccPack MediaAsset 1/16 template

  • Result:

Product image in priint

Further Reading​