Configurations relating to the Categorized Grouping agent are made in the Categorized Grouping profile.

The Categorized Grouping profile is loaded when you start a workflow that depends on it. Changes to the profile become effective when you restart the workflow.

Configuration

To create a new Categorized Grouping profile configuration, click the New Configuration button from the Configuration dialog available from Build View and then select Categorized Grouping Profile from the menu.

The contents of the menus in the menu bar may change depending on which configuration type has been opened in the current active tab. The Categorized Grouping Profile profile uses the standard menu items and buttons that are visible for all configurations, and these are described in Common Configuration Buttons.

Categorized Grouping profile dialog

The contents of the menus in the menu bar may change depending on which configuration type that has been opened. The Audit profile uses the standard menu items and buttons that are visible for all configurations, and these are described in Build View.

The Audit profile configuration contains the following settings:

Setting	Description

Setting	Description
Working Directory	Absolute path to the working directory to be used by the agent. It will be used to keep data over multiple input transaction boundaries. The same root directory can be used for several agents over several workflows. To enable concatenation and grouping over several activations of the workflow, all ECs where the workflow can be activated, must be able to access the same global root directory. Each agent will create and work in its own unique subdirectory. An agent may leave persistent data if closing conditions are not met, the workflow aborts or Cancel Batch occurs in the last transaction.
Abort on Inconsistent Working Directory	This setting controls the agents behavior if its storage is not in its expected state, that is, if the agent discovers that the persistent directory does not have the expected contents. Not selected - Warn about the condition and continue from a clean state. Any old data will be moved to a subdirectory. Selected - Abort the workflow. If the workflow aborts, manual intervention may be needed. Regardless of this setting, warnings will be logged.
Activate Use of Grouping	Activating this option will lead to the spawning of an external process of the script identified by the "Script path" described next. If not used, the category data will be concatenated.
Script Path	Specifies the external script to be used for grouping operations.
Script Arguments	Used to state the order and contents of arguments and flags in the user defined script. The reserved words `%1` and `%2` states the position in the call where the arguments are expected.
Byte Count	Specifies the byte count closing condition for the agent. This field will have to be set to a value larger than zero.
File Count	Specifies the file count closing condition for the agent. This value is optional.
Closing Interval	Specifies the closing interval in seconds for the agent. This value is optional. After each timeout, all categories will be closed and the timer will be moved forward according to the timeout interval.
Close on Deactivation	Setting this option will cause the agent to emit its data when the last file has been finished by the workflow. If a workflow aborts before all categories have been committed and this check box is enabled, the agent shall try to log a warning in the system log that data is remaining in the persistent storage.