This blog post includes the new features provided by Transform Core 3.0.0, released together with ACS Community 7.3.x.
Source Code
All the Source Code from Transform Core is available in following Alfresco GitHub project:
https://github.com/Alfresco/alfresco-transform-core
The project includes a number of Transformation Engines that can be deployed together (AIO) or separately:
https://github.com/Alfresco/alfresco-transform-core/tree/master/engines
Additional resources
Deployment
Sample project is available in https://github.com/aborroy/alfresco-transform-service-3.0.0
Deployment as a single Core AIO (All-In-One) T-Engine:
services:
alfresco:
image: alfresco/alfresco-content-repository-community:7.3.0
environment:
JAVA_OPTS: >-
-DlocalTransform.core-aio.url=http://transform-core-aio:8090/
transform-core-aio:
image: alfresco/alfresco-transform-core-aio:3.0.0
Deployment as a set of individual T-Engines:
services:
alfresco:
image: alfresco/alfresco-content-repository-community:7.3.0
environment:
JAVA_OPTS: >-
-DlocalTransform.core-aio.url=
-DlocalTransform.pdfrenderer.url=http://alfresco-pdf-renderer:8090/
-DlocalTransform.imagemagick.url=http://imagemagick:8090/
-DlocalTransform.libreoffice.url=http://libreoffice:8090/
-DlocalTransform.tika.url=http://tika:8090/
-DlocalTransform.misc.url=http://transform-misc:8090/
alfresco-pdf-renderer:
image: alfresco/alfresco-pdf-renderer:3.0.0
imagemagick:
image: alfresco/alfresco-imagemagick:3.0.0
libreoffice:
image: alfresco/alfresco-libreoffice:3.0.0
tika:
image: alfresco/alfresco-tika:3.0.0
transform-misc:
image: alfresco/alfresco-transform-misc:3.0.0
Configuration endpoints
Registered transformations are available in Transform Configuration endpoint:
http://localhost:8090/transform/config
Additional endpoints for http://localhost:8090:
- "POST /transform" to perform a transform. Performs a transform on content uploaded as a Multipart File and provides the resulting content as a download. Transform options are extracted from the request properties. The following are not added as transform options, but are used to select the transformer: sourceMimetype & targetMimetype
- "GET /" provides an html test page to upload a source file, enter transform options and issue a synchronous transform request.
- "GET /log" provides a page with basic log information.
- "GET /error" provides an error page when testing.
- "GET /version" provides a String message to be included in client debug messages.
Changing default configuration
From Transform Core 3.0.0, several methods are available to override default configuration. Additional details are available in https://github.com/aborroy/alfresco-transform-service-3.0.0#changing-default-configuration
Creating a new Transform Engine
Instructions to create a new Transform Engine are available in https://github.com/aborroy/alfresco-transform-service-3.0.0#creating-new-transform-engine
Additional deployment configurations
Limit the number of threads to be used for transformation operations (between 4 and 12 in the sample) and change the log level (to ERROR in the sample):
transform-core-aio:
image: alfresco/alfresco-transform-core-aio:3.0.0
environment:
JAVA_OPTS: "
-Dserver.tomcat.threads.max=12
-Dserver.tomcat.threads.min=4
-Dlogging.level.org.alfresco.transform.common.TransformerDebug=ERROR
"
Scaling up Transform Service samples are available in https://github.com/aborroy/acs-transform-cluster
SSL/TLS configuration sample is available in https://github.com/aborroy/alfresco-transform-ssl
Additional resources
https://www.slideshare.net/angelborroy/alfresco-transform-core-300
https://www.slideshare.net/angelborroy/alfresco-transform-services-400
