Exception maps and initialization parameters

In order to fully utilize the functionality that exception maps offer, you must assign variables as initialization parameters to track the source of the exception. See Configure the exception settings for more information.

The exception which offer this functionality and the associated parameters in the order in which they should be added are outlined below.

Note the following:

  • Variables must be added to the initialization parameters individually and in the order stated here or the values will not be populated correctly.

  • When you import a process map with exceptions from TotalAgility 5.5.0 to TotalAgility7.0.0, the exceptions which are not supported in TotalAgility 7.0.0 are not available within the system and therefore cannot be used in the process.

The following table displays information on exception codes.

Code

Name

Description

Initialization Parameter

Variable Type

Purpose

EXP0001

Resource Inactive

Invoked when a resource is inactive for an excessive period of time.

RESOURCEID

String

Records the GUID for the resource which is idle.

EXP0004

Job Cost Overrun

Invoked when the cost of job exceeds the expected value.

JOBID

String

Records the GUID for the job which exceeds the cost.

EXP0005

Job Duration Overrun

Invoked when a job exceeds its expected duration.

JOBID

String

Records the GUID for the job which exceeds the duration.

EXP0006

Activity Overrun

Invoked when an activity exceeds its expected duration.

TASKNAME

String

Records the name of the activity, GUID, Resource ID, Node ID, Embedded Process Count and Subjob ID of the activity which exceeds the duration.

JOBID

String

RESOURCEID

String

NODEID

Short

EMBEDDED PROCESS COUNT

Short

SUBJOBID

String

EXP0009

Script Object Failed

Invoked when a Script Object fails to execute automatically.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed script.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0010

Process Stalled

Invoked when a process is stalled in the following cases:

  • When a live usable resource is not available for an activity.

    • No usable resources are assigned to the process.
    • No resources to perform activity and exit condition is not met. For example, expand group resource members but all members are excluded.

  • On activity completion, if the job is not complete and does not have a live activity and its status is active.

JOBID

String

Records the GUID for the job which has stalled.

EXP0013

Activity Due

Invoked when an activity crosses the due date.

String

Records the Node Name, NodeID, Embedded Process Count, Job ID/GUID, Subjob ID and assigned resource for the activity that has become due.

NODENAME

NODEID

Short

EMBEDDED PROCESS COUNT

Short

JOBID

String

SUBJOBID

String

RESOURCEASSIGNED

Dynamic Complex

EXP0017

Synchronous Processing Failed

Invoked when synchronous processing fails.

JOBID

String

Records the GUID for the synchronous job which has failed.

EXP0018

No Usable Resources

Invoked when no usable resource is assigned to an activity.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed .NET activity.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0019

.NET Object Failed

Invoked when a .NET object fails to execute when running automatically.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed .NET activity.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0020

Web Service Failed

Invoked when a Web Service object fails to execute when running automatically.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed web service activity.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0022

C# Script Activity Failed

Invoked when a C# Script activity fails to execute when running automatically

EMBEDDED PROCESS COUNT

NODEID

JOBID

SUBJOBID

Short

Short

String

String

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed C# Script activity.

EXP0023

VB .NET Script Activity Failed

Invoked when a VB .NET Script activity fails to execute when running automatically.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed VB .NET Script activity.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0025

Data Access Activity Failed

Invoked when a Data Access activity fails to execute when running automatically.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has failed DAS activity.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0027

Synchronization Activity Failed

Invoked when a Synchronous activity fails to execute when running automatically.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed Synchronous activity.

NODEID

Short

JOBID

String

SUBJOBID

String

EXP0035

License/Volume Threshold Alert

Invoked when the number of licenses or volumes consumed exceeds the configured thresholds.

Note This is a system level exception which is not available to view in the Exceptions tab within the process.

LICENSE_TYPE

String

Records the License Type, Remaining Count, Threshold, License Server and Serial Number for the job which has exceeded the number of licenses or volumes, for the configured thresholds.

REMAINING_COUNT

Long/Short

THRESHOLD

Long

LICENSE_SERVER_NAME

String

SERIAL_NUMBER

String

EXP0036

Transfer Activity Failed

Invoked when the transfer of documents to another server fails to execute.

EMBEDDED PROCESS COUNT

Short

Records the Embedded Process Count, Node ID, GUID and Subjob ID for the job which has the failed Transfer activity.

NODEID

Short

JOBID

String

SUBJOBID

String

Not Applicable

Document Type Overdue

Invoked when the due date on a document has passed without the rule being met.

Note This exception is only set for a document set.

Job ID

Document Type Name

String

String

Records the Job ID and Document Type for the job that awaits required documents.