Skip to main content

All Tasks Properties

Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive With

Patchable (Instance Only)

actions

Actions

List of actions that the Controller will take automatically based on events that occur during the execution of this task.

XML
XML
<actions>
<abortAction>...</abortAction>
<setVariableAction>...</setVariableAction>
<emailNotification>...</emailNotification>
<snmpNotification>...</snmpNotification>
<systemOperation>...</systemOperation>
</actions>
JSON
JSON
"actions": {
"abortActions": [],
"emailNotifications": [],
"setVariableActions": [],
"snmpNotifications": [],
"systemOperations": []
},

See Task Action Properties.

N

N

agent

Agent

For Agent-based task types only; Name of the Agent to use.

Y
(unless agentVar,
agentCluster,
agentClusterVar,
broadcastCluster, or
broadcastClusterVar
is specified)

agentVar,
broadcastCluster, and
broadcastClusterVar

Y

agentCluster

Agent Cluster

For Agent-based task types only; Group of Agents, one of which the Controller will choose to run this task (compare with broadcastCluster).

Y
(unless agentClusterVar,
agent,
agentVar,
broadcastCluster, or
broadcastClusterVar
is specified)

agentClusterVar,
broadcastCluster, and
broadcastClusterVar

Y

agentClusterVar

Agent Cluster Variable

For Agent-based task types only; Name of a variable that will be resolved at run time to the name of the Agent Cluster to use.

Format: ${variable name}.

Y
(unless agentCluster,
agent,
agentVar,
broadcastCluster, or
broadcastClusterVar
is specified)

agentCluster,
broadcastCluster, and
broadcastClusterVar

Y

agentVar

Agent Variable

For Agent-based task types only; Name of a variable that will be resolved at run time to the name of the Agent to use.

Format: ${variable name}.

Y
(unless agent,
agentCluster,
agentClusterVar,
broadcastCluster, or
broadcastClusterVar
is specified)

agent,
broadcastCluster, and
broadcastClusterVar

Y

avgRunTime

Average Instance Time

Average duration of all the runs of the task.

Long value of the current average run time (in seconds).

n/a

N

avgRunTimeDisplay

n/a

Easier to read version of Average Run Time.

String value of Average Run Time in human readable format

n/a

N

broadcastCluster

Cluster Broadcast

For Agent-based task types only; Group of Agents, all of which will run this task (compare with agentCluster). Each instance of the task running on its own Agent becomes a separate task instance record in the database and displays separately on the Activity Monitor.

Y
(unless broadcastClusterVar,
agent,
agentVar,
agentCluster, or
agentClusterVar,
is specified)

broadcastClusterVar,
agent,
agentVar,
agentCluster, and
agentClusterVar

N

broadcastClusterVar

Cluster Broadcast Variable

For Agent-based task types only; Name of a variable that will be resolved at run time to the name of the Cluster Broadcast to use.

Format: ${variable name}

Y
(unless broadcastCluster,
agent,
agentVar,
agentCluster, or
agentClusterVar,
is specified)

broadcastCluster,
agent,
agentVar,
agentCluster, and
agentClusterVar

N

cpDuration

CP Duration

Used with cpDurationUnit; Allows override of the estimated Critical Path Duration of the task when running in a Workflow. In most cases, cpDuration and cpDurationUnit are not used, which implies that the Controller will estimate the Critical Path Duration based on historical executions.

Integer; Valid values are 0 or greater. Variables and Functions are supported.

N

N

cpDurationUnit

CP Duration Unit

Used with the cpDuration; type of Critical Path Duration. For example, for a Critical Path Duration of two minutes, specify 2 in cpDuration and Minutes in cpDurationUnit.

Valid Values:

  • As String = Seconds, As Value = 1
  • As String = Minutes, As Value = 2
  • As String = Hours, As Value = 3

Default is Minutes (2).

N

N

createdBy

Created By

Name of the user that created this record.

Read only

N

created

Created

Date and time that this record was created.

Read only

N

credentials

Credentials

For Agent-based task types only; Credentials under which an Agent runs this task. These credentials override any credentials provided in the Agent Details for any Agent running this task.

N

credentialsVar

Y

credentialsVar

Credentials Variable

For Agent-based task types only; Name of a variable that will be resolved at run time to the name of the Credentials to use.

N

credentials

Y

customChoiceField1

Custom Choice Field (default, which you can change in the User Defined Task Choice Field Label 1 Universal Controller system property.)

User-Defined choice field.

Example:

JSON
JSON
"customChoiceField1": {
"label": "Choice Field1",
"value": "Choice 1"
}

The custom choice field is only available if values have been defined for the User Defined Task Choice Field 1 Label and User Defined Task Choice Field 1 Options system properties.

Wildcards are supported.

N

Y

customField1

Custom 1 (default, which you can change in the User Defined Task Field Label 1 Universal Controller system property.)

User-Defined text field.

Example: <customField1 label="Domain">web.com</customField1>

The label is included only if a value has been defined for the User Defined Task Field Label 1 Universal Controller system property.

Wildcards are supported.

N

Y

customField2

Custom 2 (default, which you can change in the User Defined Task Field Label 2 Universal Controller system property.)

User-Defined text field.

Example: <customField2 label="Domain">web.com</customField2>

The label is included only if a value has been defined for the User Defined Task Field Label 2 Universal Controller system property.

Wildcards are supported.

N

Y

efDayConstraint

Early Finish Day Constraint

If efType = Time (1); Specification for whether or not to advance the early finish time to another day.

Valid values:

  • As String = None, As Value = 0
  • As String = Same Day, As Value = 1
  • As String = Next Day, As Value = 2
  • As String = Next Business Day, As Value = 3
  • As String = Sunday, As Value = 4
  • As String = Monday, As Value = 5
  • As String = Tuesday, As Value = 6
  • As String = Wednesday, As Value = 7
  • As String = Thursday, As Value = 8
  • As String = Friday, As Value = 9
  • As String = Saturday, As Value = 10
  • As String = Nth Day, As Value = 11

Default is None (0).

N

N

efDuration

Early Finish Duration

If efType = Duration (2); Shortest amount of time this task instance should take to run.

Format = dd:hh:mm:ss

N

N

efEnabled

Early Finish

Specification that if the task instance finishes before the specified efDUration or efTime, the task instance is flagged as early.

Boolean; Valid values: true/false. Default is false.

N

N

efNthAmount

Early Finish Nth Amount

If efDayConstraint = Nth Day; Number of days to advance.

Integer; Valid values are 1 or greater.

N

N

efOffsetDuration

Early Finish Duration Offset (-)

If efOffsetType is Duration (2); Duration offset to subtract from the Average Duration.

Integer; Valid values are 0 or greater. Variables and Functions are supported.

Y (if efOffsetType = Duration (2)).

efOffsetPercentage

N

efOffsetDurationUnit

Early Finish Duration Offset Unit

Used with the efOffsetDuration; Type of Early Finish Duration Offset. For example, for an Early Finish Duration Offset of two minutes, specify 2 in efOffsetDuration and Minutes in efOffsetDurationUnit.

Valid Values:

  • As String = Seconds, As Value = 1
  • As String = Minutes, As Value = 2
  • As String = Hours, As Value = 3

Default is Minutes (2).

N

N

efOffsetPercentage

Early Finish Offset Type

If efOffsetType is Percentage (1); Percentage offset to subtract from the Average Duration.

Integer; Valid values are 0 to 100. Default is 0.

Y (if efOffsetType = Percentage (1)).

efOffsetDuration

N

efOffsetType

Early Finish Offset Type

If efType = Average Duration (5); Specification for the type of offset to apply to the Average Duration.

Valid values:

  • As String = Percentage, As Value = 1.
  • As String = Duration, As Value = 2.

Default is Percentage (1).

N

N

efTime

Early Finish Time

If efType = Time (1); Time before which the task finish time is considered early. That is, the time at which the task should still be running.

Format = hh:mm, 24-hour time. Default is 00:00.

N

N

efType

Early Finish Type

Type of early finish.

Valid values:

  • As String = Time, As Value = 1.
  • As String = Duration, As Value = 2.
  • As String = Average Duration, As Value = 5.

Default is Time (1).

Y
(if efEnabled
is true)

N

enforceVariables

Enforce Variables

Specifies whether or not to enforce Launch with Variables... when launching a task using the User Interface. Not applicable for Web Service APIs.

Boolean; Valid values: true/false. Default is false.

N

N

excludeRelated

n/a

For Modify task JSON web services; specification for whether or not to exclude related records (Actions, Mutually Exclusive Tasks, Notes, Variables in Tasks, Virtual Resources) from the update, even if they are provided in the request.

info

In XML web services, excludeRelated is specified as an attribute in the <task type> element.

Valid values: true/false (default is false).

N

N

exclusiveTasks

Mutually Exclusive

List of all tasks that have been set to be mutually exclusive with this task.

XML
XML
<exclusiveTasks>
<exclusiveTask>
<sysId>5f2f5fbfb3af45fd9c1c66cb4238b5fd</sysId>
<task>my-task</task>
<type>Direct</type>
</exclusiveTask>
</exclusiveTasks>
JSON
JSON
"exclusiveTasks": [
{
"sysId": "5f2f5fbfb3af45fd9c1c66cb4238b5fd",
"task": "my-task",
"type": "Direct"
}
],

See Mutually Exclusive Tasks properties.

N

N

exclusiveWithSelf

Mutually Exclusive With Self

Specification for whether or not to allow the task to run concurrently with itself.

Boolean; Valid values: true/false. Default is false.

N

N

executionRestriction

Execution Restriction

For tasks in a workflow; Specification for whether or not there is a restriction for this task to be run, skipped, or held.

Valid values:

  • As String = -- None --, As Value = 0
  • As String = Run, As Value = 1
  • As String = Skip, As Value = 2
  • As String = Hold, As Value = 3

Default is - None - (0).

N

N

exportReleaseLevel

n/a

Universal Controller release that the record was exported from.

info

In XML web services, exportReleaseLevel is specified as an attribute in the <task type> element.

read only

N

N

exportTable

n/a

Record table information.

info

In XML web services, exportTable is specified as an attribute in the <task type> element.

read only

N

N

firstRun

First Execution

System-supplied; End Time of the first instance of this task to complete.

String value of the time that the task was first run.

n/a

N

holdResources

Hold Resources on Failure

Specifies whether or not the task instance will continue to hold Renewable resources if the task instance fails. Renewable resources will be returned only if the task instance status is either Complete, Finished, or Skipped.

Boolean; Valid values: true/false. Default is false.

N

N

lastRun

Last Execution

System-supplied; End Time of the last instance of this task to complete.

String value of the time that the task was last run.

n/a

N

lastRunTime

Last Instance Duration

Duration of the last run of the task.

Long value of the current last run time (in seconds).

n/a

N

lastRunTimeDisplay

n/a

Easier to read version of Last Run Time

String value of Last Run Time in human readable format

n/a

N

lfDayConstraint

Late Finish Day Constraint

If lfType = Time (1); Specification for whether or not to advance the late finish time to another day.

Valid values:

  • As String = None, As Value = 0
  • As String = Same Day, As Value = 1
  • As String = Next Day, As Value = 2
  • As String = Next Business Day, As Value = 3
  • As String = Sunday, As Value = 4
  • As String = Monday, As Value = 5
  • As String = Tuesday, As Value = 6
  • As String = Wednesday, As Value = 7
  • As String = Thursday, As Value = 8
  • As String = Friday, As Value = 9
  • As String = Saturday, As Value = 10
  • As String = Nth Day, As Value = 11

Default is None (0).

N

N

lfDuration

Late Finish Duration

If lfType = Duration (2); Longest amount of time this task instance should take to run.

Format = dd:hh:mm:ss

N

N

lfEnabled

Late Finish

Specification that if the task instance finishes after the specified lfDUration or lfTime, the task instance is flagged as late.

Boolean; Valid values: true/false. Default is false.

N

N

lfNthAmount

Late Finish Nth Amount

If lfDayConstraint = Nth Day; Number of days to advance.

N

N

lfOffsetDuration

Late Finish Duration Offset ( + )

if lfOffsetType is Duration (2); Duration offset to add to the Average Duration.

Integer; Valid values are 0 or greater. Variables and Functions are supported.

Y (if lfOffsetType = Duration (2)).

lfOffsetPercentage

N

lfOffsetDurationUnit

Late Finish Duration Offset Unit

Used with the lfOffsetDuration; type of Late Finish Duration Offset.

For example, for a Late Finish Duration Offset of two minutes, specify 2 in lfOffsetDuration and Minutes in lfOffsetDurationUnit.

Valid Values:

  • As String = Seconds, As Value = 1
  • As String = Minutes, As Value = 2
  • As String = Hours, As Value = 3

Default is Minutes (2).

N

N

lfOffsetPercentage

Late Finish Percentage Offset ( + )

If lfOffsetType is Percentage (1); Percentage offset to add to the Average Duration.

Integer; Valid values are 0 to 100. Default is 0.

Y (if lfOffsetType = Percentage (1)).

lfOffsetDuration

N

lfOffsetType

Late Finish Offset Type

If l``fTypeis Average Duration (5); Specification for the type of offset to apply to the Average Duration.

Valid Values:

  • As String = Percentage, As Value = 1
  • As String = Duration, As Value = 2

Default is Percentage (1).

N

N

lfTime

Late Finish Time

If lfType = Time (1); Time after which the task finish time is considered late.

Format = hh:mm. Default is 00:00.

N

N

lfType

Late Finish Type

Type of late finish.

Valid values:

  • As String = Time, As Value = 1
  • As String = Duration, As Value = 2
  • As String = Average Duration, As Value = 5

Default is Time (1).

Y
(if lfEnabled is true)

N

lockVariables

Lock Variables

Specifies whether or not to prevent editing variables when using Launch with Variables... from the User Interface. Not applicable for Web Service APIs.

Boolean; Valid values: true/false. Default is false.

N

N

logLevel

Log Level

Applicable only to Extension-based Universal Tasks;, default is Inherited.

For all other task types, logLevel is not applicable.

Valid values:

  • Inherited
  • Trace
  • Debug
  • Info
  • Warn
  • Error
  • Severe

N

N

lsDayConstraint

Late Start Day Constraint

If lsType = Time (1); Specification for whether or not to advance the late start time to another day.

Valid values:

  • As String = None, As Value = 0
  • As String = Same Day, As Value = 1
  • As String = Next Day, As Value = 2
  • As String = Next Business Day, As Value = 3
  • As String = Sunday, As Value = 4
  • As String = Monday, As Value = 5
  • As String = Tuesday, As Value = 6
  • As String = Wednesday, As Value = 7
  • As String = Thursday, As Value = 8
  • As String = Friday, As Value = 9
  • As String = Saturday, As Value = 10
  • As String = Nth Day, As Value = 11

Default is None (0).

N

N

lsDuration

Late Start Duration

If lsType = Duration (2); Duration (amount of relative time) after which the task is considered to have started late.

Format = dd:hh:mm:ss

N

N

lsEnabled

Late Start

Specification that if the task instance starts after the specified lsDuration or lsTime, the task instance is flagged as late.

Boolean; Valid values: true/false. Default is false.

N

N

lsNthAmount

Late Start Nth Amount

If lsDayConstraint = Nth Day; Number of days to advance.

Integer; Valid values are 1 or greater.

N

N

lsTime

Late Start Time

If lsType = Time (1); Time after which the task start time is considered late.

Format = hh:mm. Default is 00:00.

N

N

lsType

Late Start Type

Type of late start.

Valid values:

  • As String = Time, As Value = 1
  • As String = Duration, As Value = 2

Default is Time (1).

Y
(if lsEnabled
is true)

N

maxRunTime

Highest Instance Time

Longest duration that the task ran.

Long value of the current longest run time (in seconds).

n/a

N

maxRunTimeDisplay

n/a

Easier to read version of Maximum Run Time

String value of Maximum Run Time in human readable format

n/a

N

minRunTime

Lowest Instance Time

Shortest duration that the task ran.

Long value of the current shortest run time (in seconds).

n/a

N

minRunTimeDisplay

n/a

Easier to read version of Minimum Run Time

String value of Minimum Run Time in human readable format

n/a

N

name

Task Name

Name of this task.

Y

N

notes

Notes

List of all notes associated with this record.

XML
XML
<notes>
<note>
<sysId>021370db4c454727be883983c58bb4e5</sysId>
<text>My note</text>
<title>Note</title>
</note>
</notes>
JSON
JSON
"notes": [
{
"sysId": "021370db4c454727be883983c58bb4e5",
"text": "My note",
"title": "Note"
}
]

See Notes Properties.

N

N

opswiseGroups

Member of Business Services

List of Business Services that this task belongs to:

XML
XML
<opswiseGroups>
<opswiseGroup>group</opswiseGroup>
</opswiseGroups>
JSON
JSON
"opswiseGroups": ["1","2"]

N

N

overrideInstanceWait

Override Previous Instance Wait

Specification for overriding the instanceWait specification of the parent workflow.

This option only applies for an instance running within a workflow.

Valid values (case-insensitive):

  • As String = No, As Value = 0
  • As String = Yes / -- None --, As Value = 1
  • As String = Yes / Wait For Last, As Value = 2
  • As String = Yes / Wait For Last / Same Workflow, As Value = 3
  • As String = Yes / Wait For All, As Value = 4
  • As String = Yes / Wait For All / Same Workflow, As Value = 5

Default is No (0).

N

N

resolveNameImmediately

Resolve Name Immediately

Specification for whether or not to resolve the Instance Name of the task instance at trigger//launch time.

Boolean; Valid values: true/false. Default is false.

N

N

resPriority

Virtual Resource Priority

Priority for acquiring a resource when two or more tasks are waiting for the resource. This priority applies to all resources required by the task.

Integer; Valid values: 1 (high) - 20 (low). Default is 10.

N

Y

resPriorityVar

Virtual Resource Priority Variable

Name of a variable that will be resolved at run time to the Virtual Resource Priority value to use.

Format: ${variable name}

N

Y

restrictionPeriod

Restriction Period

If executionRestriction = Run, Skip, or Hold; Period of time when the task is restricted.

Valid values:

  • As String = -- None --, As Value = 0
  • As String = Before, As Value = 1
  • As String = After, As Value = 2
  • As String = Span, As Value = 3
  • As String = On, As Value = 4

Default is - None - (0).

Y (if executionRestriction = Run, Skip, or Hold)

N

restrictionPeriodAfterDate

After Date

If restrictionPeriod = After or Span; Date after which the restriction is valid.

Format = yyyy-mm-dd

Y (if executionRestriction = Run, Skip, or Hold; and restrictionPeriod = After or Span)

N

restrictionPeriodAfterTime

After Time

If restrictionPeriod = After or Span; Time on the selected date after which the restriction is valid.

Format = hh:mm

N

N

restrictionPeriodBeforeDate

Before Date

If restrictionPeriod = Before or Span; Date before which the restriction is valid.

Format = yyyy-mm-dd

Y (if executionRestriction = Run, Skip, or Hold; and restrictionPeriod = Before or Span)

N

restrictionPeriodBeforeTime

Before Time

If restrictionPeriod = Before or Span; Time on the selected date before which the restriction is valid.

Format = hh:mm

N

N

restrictionPeriodDateList

Date List

If restrictionPeriod = On; Date(s) on which the restriction is valid.

N

N

retainSysIds

n/a

For Create web services; specification for whether or not the web service should persist the sysId property.

  • If retainSysIds is true and sysId is included in the request/response, sysId will be persisted to the database.
  • If retainSysIds is false and sysId is included in the request/response, sysId will be ignored; it will be autogenerated by the Controller.
info

In XML web services, retainSysIds is specified as an attribute in the <task type> element.

Valid values: true/false (default is true).

Y
(for Read)

N

runCount

Number of Instances

Number of times that the task has run.

Long value of the task run count

n/a

N

runTime

n/a

Total amount of time the task has ran.

Long value of the total amount of time that task has ran (in seconds).

n/a

N

simulation

Simulate

Specifies if the instance should execute under simulation mode.

Boolean; Valid values: true/false. Default is false.

N

N

startHeld

Hold on Start

Specification for whether or not when the task is launched, it appears in the Activity Monitor with a status of Held. The task runs when the user releases it.

Boolean; Valid values: true/false. Default is false.

N

N

startHeldReason

Hold Reason

If status is Held; Information about why the task will be put on hold when it starts.

N

Y

summary

Task Description

User-defined description of this task.

N

Y

sysId

n/a

System ID field in the database for this task.

Persisted only if retainSysIds is set to true.

N

N

timeZonePref

Time Zone Preference

Specifies the time zone that will be applied to the task.

N

N

twDelayAmount

Delay Duration In Seconds

If twDelayType = Seconds (3); Number of seconds to delay after starting the task.

N

N

twDelayDuration

Delay Duration

If twDelayType = Duration (2); Number of days, hours, minutes, and seconds to delay after starting the task.

Format = dd:hh:mm:ss

N

N

twDelayType

Delay On Start

Amount of time to delay the start of a task, after it has been launched, from the time that it is eligible to start; that is, all dependencies have been met. For example: it is not being held, it is not waiting on any predecessors, or there is no wait time specified.

Valid values:

  • As String = None, As Value = 0
  • As String = Duration, As Value = 1
  • As String = Seconds, As Value = 2

Default is None (0).

N

N

twWaitAmount

Wait Duration In Seconds

If twWaitType = Seconds (3); Number of seconds to wait before starting the task.

N

N

twWaitDayConstraint

Wait Day Constraint

If twWaitType = Time (1) or Relative Time (4). Specification for whether or not to advance the wait time to another day.

Valid values:

  • As String = None, As Value = 0
  • As String = Same Day, As Value = 1
  • As String = Next Day, As Value = 2
  • As String = Next Business Day, As Value = 3
  • As String = Sunday, As Value = 4
  • As String = Monday, As Value = 5
  • As String = Tuesday, As Value = 6
  • As String = Wednesday, As Value = 7
  • As String = Thursday, As Value = 8
  • As String = Friday, As Value = 9
  • As String = Saturday, As Value = 10

Default is None (0).

N

N

twWaitDuration

Wait Duration

If twWaitType = Duration; Number of days, hours, minutes, and seconds to wait before starting the task.

Format = dd:hh:mm:ss

N

N

twWaitTime

Wait Time

If twWaitType = Time (1) or Relative Time (4); Number of hours and minutes to wait before starting the task.

Format = hh:mm

N

N

twWaitType

Wait To Start

Amount of time to wait before starting a task from the time that it was launched.

Valid values:

  • As String = None, As Value = 0
  • As String = Time, As Value = 1
  • As String = Duration, As Value = 2
  • As String = Seconds, As Value = 3
  • As String = Relative Time, As Value = 4

Default is None (0).

N

N

twWorkflowOnly

Workflow Only

Specification for whether or not to apply the twWaitType and twDelayType specifications only if the task is in a Workflow.

Valid values:

  • As String = -- System Default --, As Value = 0
  • As String = Yes, As Value = 1
  • As String = No, As Value = 2

Default is - System Default - (0).

N

N

type

Type

Task type.

info

In XML web services, type is specified as the name of the task element. For example: <taskWindows>...</taskWindows>

Task type is specified in the format task<Type>.

Valid values for each task type are given in the following list. For your convenience, each value is paired with the UI display name (in parentheses) of the task type.

Click here to expand...
  • taskUnix (Linux/Unix)
  • taskWindows (Windows)
  • taskIbmi (IBM i)
  • taskZos (z/OS)
  • taskUcmd (Universal Command)
  • taskSap (SAP)
  • taskPeoplesoft (PeopleSoft)
  • taskFtp (File Transfer)
  • taskManual (Manual)
  • taskSleep (Timer)
  • taskSql (SQL)
  • taskStoredProc (Stored Procedure)
  • taskEmail (Email)
  • taskWebService (Web Service)
  • taskRecurring (Recurring)
  • taskMonitor (Task Monitor)
  • taskFileMonitor (Agent File Monitor)
  • taskFtpFileMonitor (Remote File Monitor)
  • taskSystemMonitor (System Monitor)
  • taskVariableMonitor (Variable Monitor)
  • taskEmailMonitor (Email Monitor)
  • taskUniversalMonitor (Universal Monitor)
  • taskZosMonitor (z/OS Monitor)
  • taskApplicationControl (Application Control)
  • taskApproval (Approval)
  • taskUniversal (Universal)
  • taskWorkflow (Workflow)
info

For task instances, the type is specified in the format exec<Type>, rather than task<Type>.

For example, a Windows task type is taskWindows, but the type of the task instance is execWindows.

Y (for Create)

N

updatedBy

Updated By

Name of the user that last updated this record.

Read only

N

updated

Updated

Date and time that this record was last updated.

Read only

N

userEstimatedDuration

User Estimated Duration

Estimated amount of time it should normally take to run this task.

Format = dd:hh:mm:ss

Y
(if efType = Average Duration (5) or lfType = Average Duration (5))

N

variables

Variables

List of all user-defined variables associated with this record; that is, variables that have been defined for this specific record.

XML
XML
<variables>
<variable>
<allowEmptyOption>false</allowEmptyOption>
<allowUnlistedOption>false</allowUnlistedOption>
<description />
<name>my_var</name>
<options/>
<required>false</required>
<sysId>5f8d331ce84d49cca73f96531613dab8</sysId>
<value>1</value>
</variable>
</variables>
JSON
JSON
"variables": [
{
"allowEmptyOption": false,
"allowUnlistedOption": false,
"description": null,
"name": "my_var",
"options": [],
"required": false,
"sysId": "5f8d331ce84d49cca73f96531613dab8",
"value": "1"
}
]

See Variables in Tasks properties.

N

N

version

n/a

For Read and List task web services; specification of the task version being read or listed.

info

In XML web services, version is specified as an attribute in the <task type> element.

Y

N

virtualResources

Virtual Resources

List of all Virtual Resources to which this task is assigned.

XML
XML
<virtualResources>
<virtualResource>
<amount>1</amount>
<lastResolvedResource>VR3</lastResolvedResource>
<resource>my_resource</resource>
<resourceVar />
<sysId>00ea986ab68a47fca197de97929d1208</sysId>
</virtualResource>
</virtualResources>
JSON
JSON
"virtualResources": [
{
"amount": 1,
"lastResolvedResource": "VR2",
"resource": "my_resource",
"resourceVar": null,
"sysId": "00ea986ab68a47fca197de97929d1208"
}
],

See Virtual Resources properties.

N

N

All Task Instances Properties

Property

UI Field Name

Description

Patchable (Instance Only)

statusCode

Status

Identifies the current status of every task instance on the list.

N

exitCode

Exit Code

The exit code, if any, returned by the task instance.

N

statusDescription

Status Description

System-supplied; additional information, if any, about the status of the task instance.

N

statusHistory

Status History

History of statuses for this task instance.

N

triggerTime

Trigger Time

System-supplied; Date and time the task instance was triggered.

N

launchTime

Launch Time

System-supplied; Date and time the task instance was launched.

N

queuedTime

n/a

System-supplied; Date and time the task was queued for processing.

N

startTime

Start Time

System-supplied; Date and time the task instance started.

N

endTime

End Time

System-supplied; Date and time the task instance completed.

N

duration

Duration

System-supplied; amount of time the task instance took to run.

N

cpuTime

n/a

System-supplied; amount of CPU time the task took to run.

N

memo

Operational Memo

User-defined operational memo.

Y

memoHistory

n/a

History of Operational Memos for this task instance.

N

percentDone

n/a

Measure of how much the task has executed.

N

stateChangedTime

n/a

The time at which the status of the task last changed.

N

statusAttributes

n/a

Attributes for the associated execution status (Ex: Transient, Transient Re-run & Deploy Extension).

N

instanceWaitResolved

Previous Instance Wait Resolved

System-supplied; If the overrideInstanceWait specification for the task is set to No, instanceWaitResolved will be set to the value of the instanceWait specification of the parent workflow. Otherwise, it will be set to the value specified by overrideInstanceWait.

Values:

  • As String = -- None --, As Value = 1
  • As String = Wait For Last, As Value = 2
  • As String = Wait For Last / Same Workflow, As Value = 2
  • As String = Wait For All, As Value = 2
  • As String = Wait For All / Same Workflow, As Value = 2

N

instanceWaitLookupResolved

Previous Instance Wait Lookup Option Resolved

System-supplied; Specification for which field(s) to use to look up qualifying previous task instances.

Values:

  • As String = Task, as Value = 1
  • As String = Task / Instance Name, as Value = 2

N