Queue Based AgilePart Properties

This topic describes the properties that are common to Queue Based AgileParts.

Field Definitions

Field Name Definition

Retries

Definition:
Specifies the number of times to retry an action for a Queue Based AgilePart if it fails.
Allowed Values:
Any integer.
Default Value:
0
Custom Attributes:
No
Property Group:
Status and Error Message (Queue Based AgileParts Only)

HandleException

Definition:
Specifies the action to take when an exception occurs.
Allowed Values:
  • Ignore - Writes an error to the error log, and moves the process forward.
  • SuspendProcess - Writes an error to the error log and suspends the process.
  • UserDefined - Uses a custom dll you provide to determine the appropriate action.
Default Value:
Ignore
Custom Attributes:
No
Property Group:
Status and Error Message (Queue Based AgileParts Only)

Optimizing

Definition:
Specifies the action to take when an exception occurs.
Allowed Values:
  • Performance - A message from an AgilePart is sent directly to a third-party system without a message queue.

    When this is set, the Retries property is always treated as if the value were 0.

  • Scalability - A message from an AgilePart goes through the internal message queue within AgilePoint Server.
  • Connectivity - A message from an AgilePart goes through the Azure message queue in the cloud. This requires the AgilePoint Broker to be running in your internal environment.
  • Configuration - The value is set based on the value of the process attribute, QueuebaseAgilePartOptimizing. You can set the value of this attribute at the process model, application, or global level to one of the following values:
    • Performance
    • Scalability
    • Connectivity

    To determine the value the process attribute to use, AgilePoint checks QueuebaseAgilePartOptimizing in the following context:

    • [Application].[process model Name].QueuebaseAgilePartOptimizing - The process attribute within the context of a specific process model within a specific application.
    • [Application].QueuebaseAgilePartOptimizing - The process attribute within the context of a specific application.
    • Global.Setting.QueuebaseAgilePartOptimizing - The global process attribute.

Even if this process attribute is set, individual AgileParts can have a different property if desired.

Default Value:
Configuration, or Performance.

If the process attribute QueuebaseAgilePartOptimizing has a value, that value is used, and Configuration is considered the default setting.

If the value of QueuebaseAgilePartOptimizing is not defined, this property is treated as if Performance were the default value.

Custom Attributes:
No, but the Configuration option uses a process attribute to determine its behavior.
Property Group:
AgilePart (Queue Based AgileParts Only)