General

You can view and update the general and system related settings.

A user should have sufficient access permissions to view or edit the general system settings. For a user with read-only permissions, the System settings dialog displays all setting in editable mode, but is not allowed to save the changes.

  1. Navigate to System > System settings > System > General.
    The General settings dialog box is displayed.
  2. Configure the following settings.

    Setting

    Description

    General

    Use business calendar

    If selected, calculates all job durations and due dates based on the business calendar which is selected separately for each scheduled job.

    Note Start the Kofax TotalAgility Core Worker Service to use the business calendar. See Stop and start the Kofax TotalAgility services.

    For more information on business calendar, see Exception handling in Kofax TotalAgility Best Practices Guide.

    Allow duplicate email addresses

    If selected, allows using the same email address by multiple resources.

    Note
    • On saving the settings, you must restart the IIS and Core worker service.

    • When you upgrade from any other supported versions prior to 7.2.0, the Allow duplicate email addresses setting is enabled by default.

    • The email address of the external resource must be unique regardless of the system settings.

    • If there are multiple resources with the same email address, and you use LogonWithEmailAddress API using an email address that is a duplicate, the API fails as you could log on the wrong resource.

    • If there are multiple individual/external resources with the same email address, and you use other APIs to get resource details using email address as the identifier, the APIs fail.

    If this setting is clear, you cannot create or edit (individual, group, external resource), or import a resource which does not have an unique email ID. If you try to do so, a message is displayed.

    For more information on using duplicate email addresses, see Allow duplicate email addresses in Kofax TotalAgility Best Practices Guide.

    Enable multilingual processes

    If selected, allows opening the form in the correct locale when the browser is set to a different language.

    Restrict job access

    If selected, restricts resources from accessing job properties, viewing associated milestones, variables, states, roles, history and map details.

    When you apply the Restrict job access setting, the job is not visible in job search results. However, users can still create and restart jobs, view the work type, and take and complete activities.

    Note Restarting the job is only possible by using the RestartJob API. See the SDK documentation for more information.

    To allow access to job properties and other associated details for some resources, you must set up functional and maintenance access for each process. See Functional access and Configure maintenance access

    Note The Restrict job access setting applies to live and archived jobs.

    Security key

    Displays the default key that protects sensitive data between client and server so that variable values stored on the client machine are encrypted when viewed. Click Generate to generate a new security key if required.

    Transformation server

    Reject documents on exceptions

    If selected, the system rejects the document or page on exceptions. (Default: Clear. This means the system suspends the activity on exception.)

    Core worker

    Auto activity reset limit

    Allows you to define the maximum number of attempts to reset an automatic activity. (Default: 5)

    Note For an Azure environment, the default Auto activity reset limit is 1.

    Restrict looping in synchronous

    Do either of the following:

    • By default, this setting is not enabled and allows you to define the Maximum loop count. (Default: 1000)

      Note For an Azure environment, the default value is 10,000 and read-only.

      Continuous looping in a synchronous job or business rule can cause high workload on the TotalAgility server. The Maximum loop count allows you to define the number of times an activity can be executed in a synchronous job or business rule to prevent continuous looping. When the loop count reaches the defined limit, the synchronous job is suspended at runtime.

      Note You can set the maximum loop count at system level or process level. The maximum loop count set at process level takes precedence over the system setting. See Process properties.
    • To allow the process to be synchronous so that it only has automatic activities, and does not have any manual activities, select Restrict looping in synchronous.

      If you enable this setting, the Maximum loop count setting becomes unavailable.

    Capture data clean-up task

    Operation time limit

    Allows you to set the operation time limit for deleting the child capture data. (Default: 12 Hrs: 00 Mins)

    Note Too large intervals between clean-up runs can lead to excessive database growth which causes increased task execution time and high load on the server. Too often clean-up task executions can lead to not optimal resources usage. Configure the operation time limit based on the data growth rate so that it can maintain a balance between manageable data growth and the server load.

    Enable custom sorting

    Work queue

    If selected, enables sorting of columns in a Work queue query.

    Workload

    If selected, enables sorting of columns in a System query.

    Jobs

    If selected, enables sorting of columns in a Job list query.

  3. Click Save.
    Note Restart the Kofax TotalAgility services for the settings to take effect.