Configuration

Target group: Administrators

Extension configuration

To configure the extension, go to Admin Tools > Settings > Extension Configuration and click on the Configure extensions button. Open the jobrouter_process configuration:

Log options in the extension configuration

Log options in the extension configuration

Log

Deprecated since version 1.1.0: The configuration of logging is deprecated and will be removed in version 2.0.0. Configure the required log writers in your site package instead.

Log into file

If this option is activated, the log output is written to the file var/log/typo3_jobrouter_process_<hash>.log. It is enabled by default.

Log into table

Activate this option to log into the table tx_jobrouterbase_log. It is disabled by default.

Hint

To display the log entries of this table in the TYPO3 backend, install the extension co-stack/logs.

Log level

Using the drop down menu you can select the log level for the activated log options. warning is selected by default.

Encryption

Encrypt transfer data

If activated, the fields processtable and summary are encrypted for enhanced security in the transfer table when using the Preparer class or the JobRouterStartInstance form finisher.

Tip

You should consider activating the encryption of the transfer data as this ensures confidentiality and integrity!

Important

If you lose or change the encryption key (generated with the JobRouter Connector extension), data cannot be decrypted by the start process command anymore!

Dashboard widget configuration

Instance Starts

The number of instance starts by days can be visualised by the widget Instance Starts. By default, 14 days are shown. This can be overridden in the Configuration/Services.yaml of your site package extension (or any other dependent extension):

parameters:
   jobrouter_process.widget.transfersPerDay.numberOfDays: 14

Instance start types

The instance starts of the last 14 days (including the current day) are taken into account for the Instance Start Types widget. This can be overridden in the Configuration/Services.yaml of your site package extension (or any other dependent extension):

parameters:
   jobrouter_process.widget.typeOfInstanceStarts.numberOfDays: 14

As already mentioned, the current day is also considered. So if you use 1 for the number of days, the widget will only show instance starts from today.

Logging

If logging is necessary to track process instance starts and possible warnings or errors, you can set up log writers depending on your needs.

Example: To log all warnings and higher levels of this extension into a file, add this snippet to the ext_localconf.php file of your site package extension:

$GLOBALS['TYPO3_CONF_VARS']['LOG']['Brotkrueml']['JobRouterProcess']['writerConfiguration'][\Psr\Log\Level::WARNING] = [
   \TYPO3\CMS\Core\Log\Writer\FileWriter::class => [
      'logFileInfix' => 'jobrouter_process'
   ]
];

The messages are then written to the var/log/typo3_jobrouter_process_<hash>.log file.