Essential configuration files for Document Automation Server

This section lists the different configuration files we have in Nutrient Document Automation Server (DAS), along with their uses.

Autobahn.config

The Nutrient DAS configuration file Autobahn.config can be found in the config directory of Nutrient DAS. This file allows the user to make some backend changes to the way Nutrient DAS works. Below are the contents of the file.

Information

We strongly advise users not to change any undocumented settings.

These settings are important for Nutrient DAS to function properly and should never be changed unless guided by the Nutrient support team.

<configuration\>

<appSettings file="">

<clear />

<add key="inputdelay" value="10" />

<add key="jobqueuetimeout" value="180" />

<add key="jobqueueinterval" value="10" />

<add key="mergeflag" value="" />

<add key="trigger1001" value="" />

<add key="triggerlevel" value="" />

<add key="allowlongfilename" value="" />

</appSettings\>

</configuration\>

The input delay

This in an integer value that represents the number of seconds a file must exist in the input folder before Nutrient DAS attempts to process it. The default value is 0; to change this, update the value of the inputdelay key:

<add key="inputdelay" value="10" />

Information

The value is in seconds.

Multicore throttle settings

Refer to the guide on multicore throttling for more information:

<add key="jobqueuetimeout" value="180" />

<add key="jobqueueinterval" value="10"/>
Information

The value of jobqueuetimeout is in seconds.

Output trigger files

This feature makes Nutrient DAS copy a file (trigger file) to the output folder after the job completes and successfully copies the processed files to the output folder. This file can be used to trigger a post-processing workflow.

The keys below can be used to control the way this feature acts.

Setting name Details
trigger%JOBID% When you add a value to this key, Nutrient DAS will create a file with the name of the value in the output folder of the job with ID = %JOBID%.
To send a trigger file for a job with job ID 1002, use trigger1002 as the key.
triggerlevel This specifies if the trigger file should be copied to the top-level folder only or also the subfolders.
The possible values are:
- sub — Copies the file to the top-level folder and the subfolders.
- top — Copies the file to the top-level folder only.

The setting below will copy test.csv to the top-level output folder of a job with job ID 1001:

<add key="trigger1001" value="test.csv" />

<add key="triggerlevel" value="top" />

The merge flag feature

This feature is used to give the user a certain level of control over which folders to be included in the merge operations (e.g. Merge Tiffs, Merge PDF, Merge Tiffs to PDF, and Extended Merge Tiffs to PDF). It provides the user with a mechanism of flagging folders to include for processing.

To use this feature, follow the steps below:

  • Choose a name you want to set as the flag name. For instance, _ready.

  • Open the Autobahn.config file located at <InstallDirectory>\Autobahn DX\config\.

  • Change the value of <add key="mergeflag" value="" /> to <add key="mergeflag" value="ready.adx.merge" />.

Information

The file extension must be .adx.merge for this to work.

  • Next, create the zero-size byte file named _ready.adx.merge, and copy and paste in each folder that requires processing.

  • Restart the service to load the new configuration.

Information

Restarting the service will cause all jobs that are running through the job manager to terminate.

Allow long file names

Starting in Windows 10 and Windows Server 2016, version 1607, MAX_PATH limitations have been removed from common Win32 file and directory functions. However, you must opt in to the new behavior. Refer to the file name length guide for more details on how to enable this setting.

After enabling support for long file names in the registry, set the value of the allowlongfilename key to true.

Allow users to disable SSL in email steps

SSL is a security feature that helps establish secure connections when sending emails. However, sometimes emails are only sent internally, in which case an SSL certificate may not be required (or available).

Though we recommend keeping SSL enabled in most cases, it can now be disabled by setting the secureoption configuration option to None. It’s set to Auto by default.

<add key="secureoption" value="Auto" />

Setting name Values
secureoption - None — Disable SSL certificate requirement when sending emails
- Auto — Use default settings
- StartTls — StartTLS informs the email server that the email client wants to upgrade from an insecure connection to a secure one using TLS or SSL.
- SslOnConnect — The email connection should use SSL or TLS encryption immediately.

tiffjunction.exe.config

The TIFF Junction configuration file tiffjunction.exe.config can be found in the distribution\tj\bin directory of Nutrient DAS. It allows the user to make some backend changes to the way TIFF Junction works. Below are the contents of the file:

<?xml version="1.0"?>

<configuration>

<appSettings>

<add key="DetailedValidation" value="false" />

<add key="CompatabilityMode" value="false" />

<add key="DateFormat" value="MM dd yyyy" />

<add key="AllowErrorTiffFiles" value="false" />

<add key="UseLibTiff4JPEG" value="false" />

<add key="OrderByInt" value="false" />

<add key="ConvertToTIFFThreshold" value="50" />

<!--Extensions in lower case -->

<add key="AcceptedImages" value=".jpeg,.png,.bmp,.wbmp,.tif…" />

</appSettings>

</configuration>

It’s important to pay attention to the element within the appSettings tags. The table below gives a more detailed explanation of each setting.

Setting name Details
DetailedValidation Set this to true if you want TIFF Junction to carry out extra checks and validations, like PDF/A validation after conversion. Setting it to true will make TIFF Junction slower.
CompatabilityMode Set this to true if the arguments you’re using to call tiffjunction were generated before 2015.
DateFormat You can change the DateFormat of the output file names here. This works in conjunction with the %DATESTAMP%.
AcceptedImages TIFF Junction will treat any extension found here as an acceptable image file.
OrderByInt When merging files with numbers as their file name, setting this to true will make sure they’re ordered numerically.
AllowErrorTiffFiles
UseLibTiff4JPEG
ConvertToTIFFThreshold
Only use these settings when advised by our Support team.

pj.exe.config

The PDF Junction configuration file pj.exe.config can be found in the distribution\pj\bin directory of Nutrient DAS. This file allows the user to make some backend changes to the way PDF Junction works. Below are the contents of the file:

<?xml version="1.0"?>

<configuration>

<startup useLegacyV2RuntimeActivationPolicy="true">

</startup>

<appSettings>

<add key="OrderByInt" value="true"/>

<add key="ValidatePDFa" value="true"/>

<add key="RemoveDuplicateFontFiles" value="true"/>

<add key="DateFormat" value="MM dd yyyy"/>

<add key="DateFormat" value="MM dd yyyy" />

</appSettings>

</configuration>

Pay attention to the element within the appSettings tags. The table below gives a more detailed explanation of what each setting.

Setting name Details
ValidatePDFa Set this to true if you want PDF Junction to validate PDF/A files after conversion.
DateFormat You can change the DateFormat of the output file names here. This works in conjunction with the %DATESTAMP%.
RemoveDuplicateFontFiles When merging PDFs with embedded fonts, this option will ensure there are no duplicate font files in the target file. Setting this to false can cause very large output PDF files, while setting it to true might slow down the process a bit.
OrderByInt When merging files with numbers as their file name, setting this to true will ensure they’re ordered numerically.

Other configuration files

File name Location Comment
topdf.exe.config distribution\pj\bin Refer to the in-depth look at the configuration file guide for more details.
AnyFileToSearchablePDF.exe.config bin Chooses the operation for anyfiletopdf job steps based on the file extension.