Skip to main content
Ask ChatGPT

Additional Files: Crops, Trims, and Renditions

In Aprimo DAM, additional files are supplementary files linked to a record but not used as the primary file (Master File). These files can include design documents, annotated feedback, or marketing materials. This guide focuses on Crops, Trims, and Renditions.

Crops​

Crops apply exclusively to image files. They can be created automatically, manually, or via the REST API. All crops are stored as additional files in a DAM record.

Automatic Crops​

Admins can configure the system to automatically generate crops when specific conditions are met (e.g., when a new file version is uploaded). Crops can follow predefined settings or use Aprimo AI to determine optimal crops.

Manual Crops​

Users can create crops directly in the Aprimo UI.

REST API​

Crops can also be created using the CropImage action via the REST API.

Trims​

Trims are exclusive to video files and represent stored video segments as additional files.

Manual Trims​

Users can create trims directly in the Aprimo UI.

REST API​

Trims can be created using the TrimVideo action in the REST API.

Renditions​

Renditions are transformed versions of a file, such as format conversions or resolution changes. These can be generated automatically or via the REST API.

What Are Renditions?​

Renditions are transformed file versions created to meet specific needs (e.g., transcoding a video for social media). They are stored on an asset as an additional file.

Automatic Renditions​

Admins can configure predefined renditions in the .renditionPreset system setting. The system automatically generates these renditions when rules or triggers are met.

REST API Renditions​

Renditions can also be created on-demand using the CreateRenditions MaintenanceJob action in the REST API. Below is an example request:

curl --location 'https://{aprimoTenant}.dam.aprimo.com/api/core/maintenancejobs' \
--header 'Authorization: Bearer {accessToken}' \
--header 'API-VERSION: 1' \
--header 'Content-Type: application/json' \
--data '
{
   "type": "record",
   "targets": [
      {
      "recordId": {recordId} 
      }
   ],
   "actions": [
   {
      "action": "CreateRenditions",
      "parameters": {
         "presets": [
            {
            renditionPresetName
            }
         ]
      }
   }]
}'

Common Use Case - Background Removal​

To create a rendition with the background removed, configure the rendition as follows in .renditionPreset:

<add name="removeBG" format="png" usages="AI Renditions" aiActions="removeBackground" />

Then, use this API request:

curl --location 'https://{aprimoTenant}.dam.aprimo.com/api/core/maintenancejobs' \
--header 'Authorization: Bearer {accessToken}' \
--header 'API-VERSION: 1' \
--header 'Content-Type: application/json' \
--data '
{
   "type": "record",
   "targets": [{ "recordId": {recordId} }],
   "actions": [{
      "action": "CreateRenditions",
      "parameters": {
         "presets": ["removeBG"]
      }
   }]
}'