Transformations
Page reserved for super administrators (members of the GROUP_ALFRESCO_ADMINISTRATORS group).
Purpose of this page
This page lets you inspect and test the transformation (converting one file format to another) and rendition (generating a derived representation of a document, e.g. a thumbnail or a PDF preview) capabilities available on the server. It is useful for diagnosing a preview or conversion issue (“no preview available”, thumbnail generation failure, etc.).
The content shown depends on the installed Alfresco Content Services version: up to four sections can appear, as collapsible panels.
Accessing the page
Pristy Portail menu: OOTBee Support Tools > Transformations.
Content Service Transformers (legacy framework)
This section only appears if the server still exposes the older synchronous transformation mechanism (Content Service Transformers). It groups advanced diagnostic tools:
| Tool | Description |
|---|---|
| Transformer Properties | Lists all defined transformer properties |
| Set / Remove Transformer Properties | Adds, replaces, or removes transformer properties (PropertyName=Value format) |
| Transformation Log / Debug Log | Lists the latest entries of the transformation log, or its debug log |
| Transformer Names | Lists the names of all top-level transformers |
| Transformation Statistics | Transformation statistics for the current node |
| Test Transform | Transforms a small test file from one MIME type to another and shows the result |
| Transformations By Extension / By Transformer | Lists all possible transformations, sorted by extension or by transformer |
[to complete] Since this mechanism is being progressively replaced by RenditionService2 (see below), the exact detail of each screen in this section was not verified in the portal.
Rendition Definitions (RenditionService2)
This section appears if the server supports RenditionService2, the newer transformation framework. It shows:
- RenditionService2 Feature Status: availability and activation of the different transform clients (Local Transform Client, Legacy Transform Client — bridging to the old mechanism, dropped from
ACS7.0 onward —, Synchronous Transform Client, Remote Transform Client, used inAlfrescoEnterprise edition). - Test Rendition Definitions: for a given source MIME type and file size, tests which renditions are available.
- List Rendition Definitions: shows the configuration of every rendition definition present on the server.
Transformation registries (Local / Remote Transform Service Registry)
Two similar sections can appear: the local registry (local transform engines, called T-Engines) and the remote registry (Alfresco Enterprise transformation service). Each offers:
- Test Registered Transformations: looks up eligible transformers for a given source/target MIME type and size, and shows the likely selected transformer along with the maximum supported size.
- Supported Transformations: lists the transformations supported by each transformer, with priority, size limit, and options.
- Metadata Extraction / Embedding Support: MIME types for which the registry offers metadata extraction or embedding.
- For the local registry only: a list of configured T-Engine URLs, with their ready probe (availability check) and live probe (functional check) status, and a Show Logs button opening the recent transformations reported by that engine.
On an Alfresco Community instance without RenditionService2 or an Enterprise transformation service, some of these sections may not appear at all.
Last Update - October 20, 2026