Configuration using the global-properties.file - Configuration using the global-properties.file - Alfresco - Alfresco Document Transformation Engine - Alfresco/Alfresco-Document-Transformation-Engine/2.2/Alfresco-Document-Transformation-Engine/Alfresco-Document-Transformation-Engine/Configure-the-Document-Transformation-Engine/Configure-the-Alfresco-Transformation-client/Configuration-using-the-global-properties.file - 2.2

Alfresco Document Transformation Engine
Platform
Alfresco
Product
Alfresco Document Transformation Engine
Release
2.2
ft:lastPublication
2026-05-06T17:29:20.529000
ft:locale
en-US
ArchiveStatus
Archived

You configure the Alfresco Transformation client by adding the relevant properties to the global properties file.

  1. Open the alfresco-global.properties file.

  2. Add the required properties for configuration settings on the Alfresco Transformation client.

  3. Save the alfresco-global.properties file, and then restart your server.

The following table shows an overview of the available properties:

Property Description
transformserver.aliveCheckTimeout Sets the timeout for the connection tester in seconds. If the Document Transformation Engine does not answer in this time interval, it is considered to be off line. The default value is 2.
transformserver.test.cronExpression Sets the cron expression that defines how often the connection tester will check. The default is every 10 seconds: 0/10 ?
transformserver.disableSSLCertificateValidation Set this property to true to allow self-signed certificates (that is, it is not issued by an official Cert Authority). The default is false.
transformserver.username The user name used to connect to the Document Transformation Engine. Note: Do not change from the default alfresco.
transformserver.password The password used to connect to the Document Transformation Engine. Note: Always change the password from the default alfresco.
transformserver.qualityPreference There are two values for this property. The default is QUALITY.
  • QUALITY: optimizes the preview for quality.
  • SIZE: optimizes the preview for size. This is interesting if you have a lot of big Office documents, for example, PPT file over 100 MB.
transformserver.transformationTimeout Sets the time in seconds to wait for the transformation to complete before assuming that it has hung and therefore stop the transformation. If you are transforming very large or complex files, this time can be increased. The default is 300.
transformserver.url The URL of your Document Transformation Engine (or the network load balancer if you are using more then one transformation engine). Use https:// if you want to use encrypted communication between the Alfresco Content Services server and the Document Transformation Engine.
transformserver.usePDF_A Use this setting to transform PDF to PDF/A or to keep PDF/A in PDF/A format. The default is false.

In a normal setup, you will always overwrite the transformserver.password and transformserver.url properties. If you want to use SSL encryption with the default certificate of the transformation engine, make sure that you set transformserver.disableSSLCertificateValidation=true.