Application profile

This section provides reference information for the application profile that is specific to the ConnectorForMsExcel application.

START_SNIFFER

Set this element to "true" to start Dialog Sniffer by the task if it has not yet been started. Dialog Sniffer detects dialog boxes that appear during the execution of a task, and writes the dialog box text to a log file.

Where used

Service > osTypes > osType > env

Required/Optional

Optional

Valid values

true | false

Default value

false

FATAL_PATTERNS

Only used when START_SNIFFER is set to true.

String indicating a pattern or list of patterns to search for within the log files under directory %SOAM_HOME%\logs\sniffer.

Separate different strings with double semi-colons (;;).

The ConnectorForExcel service searches the log file for this pattern. If the log file contains one of the specified patterns, the service terminates the Excel process started by this task and throws a fatal exception. Symphony will not attempt to rerun this task.

If no patterns are specified, the service will not search the log file for patterns.

Where used

Service > osTypes > osType > env

Required/Optional

Optional

Valid values

string

NON_FATAL_PATTERNS

Only used when START_SNIFFER is set to true.

String indicating a pattern or list of patterns to search for within the log files under directory %SOAM_HOME%\logs\sniffer.

Separate different strings with double semi-colons (;;).

The ConnectorForExcel service searches the log file for this pattern. If the log file contains one of the specified patterns, the service terminates the Excel process started by this task and throws a failure exception. Symphony will attempt to rerun this task up to the taskRetryLimit indicated in the session type.

If no patterns are specified, the service will not search the log file for patterns.

Where used

Service > osTypes > osType > env

Required/Optional

Optional

Valid values

string

DISMISS_DLG_WITH_PATTERNS

Only used when START_SNIFFER is set to true.

String indicating a pattern or list of patterns to search for within the log files under directory %SOAM_HOME%\logs\sniffer.

Separate different strings with double semi-colons (;;).

The ConnectorForExcel service searches the log file for this pattern. If the log file contains one of the specified patterns, Symphony dismisses any dialog boxes that contain text with the specified patterns. Dismissed dialog boxes are registered in the log files under directory %SOAM_HOME%\logs\sniffer.

If no patterns are specified, no dialogs are dismissed.

Where used

Service > osTypes > osType > env

Required/Optional

Optional

Valid values

string

FATAL_TIMEOUT

Task timeout in seconds for Fatal exceptions.

The ConnectorForExcel service throws a fatal exception when it detects that the execution time of the task exceeds the specified timeout. Before throwing this fatal exception, the service terminates the Excel process started by this task. Symphony will not retry the terminated task.

If a timeout is not specified, or if it is equal to 0, task execution time is considered unlimited.

Where used

Service > osTypes > osType > env

Required/Optional

Optional

Default value

30 seconds

NON_FATAL_TIMEOUT

Task timeout in seconds for Failure exceptions.

The ConnectorForExcel service throws a failure exception when it detects that the execution time of the task exceeds the specified timeout. Symphony will attempt to rerun this task up to the taskRetryLimit indicated in the session type.

If a timeout is not specified, or if it is equal to 0, task execution time is considered unlimited.

Where used

Service > osTypes > osType > env

Required/Optional

Optional

Default value

40 seconds

APP_DEPLOY_DIR

Do not use. Reserved for system use.