Page Comparison

...

Panel

Table of Contents

maxlevel	2

...

As

String

=

Success

Exitcode

Range,

As

Value

=

1

<li>

As

String

=

Failure

Exitcode

Range,

As

Value

=

2

<li>

As

String

=

Success

Output

Contains,

As

Value

=

3

<li>

As

String

=

Failure

Output

Contains,

As

Value

=

4

</ul>

Default is Success Exitcode (1).

<ul> <li> As String =

As String = STDOUT,

As

Value

=

1

<li>

As

String

=

STDERR,

As

Value

=

2

<li>

As

String

=

FILE,

As

Value

=

3

</ul>

Default is STDOUT (1).

As

String

=

bat

<li>

As

String

=

cmd

<li>

As

String

=

js

<li>

As

String

=

ps1

<li>

As

String

=

py

<li>

As

String

=

uapy

<li>

As

String

=

vbs

<li>

As

String

=

wsf

<li>

As

String

=

Other

</ul>

Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive With

Anchor

	agent - UTEMP
	agent - UTEMP

agent

Agent

Name of the Agent to use.

N

agentVar,
broadcastCluster, and
broadcastClusterVar

Anchor

	agentCluster - UTEMP
	agentCluster - UTEMP

agentCluster

Agent Cluster

Group of Agents, one of which the Controller will choose to run this task (compare with broadcastCluster).

N

agentClusterVar,
broadcastCluster, and
broadcastClusterVar

Anchor

	agentClusterVar - UTEMP
	agentClusterVar - UTEMP

agentClusterVar

Agent Cluster Variable

Name of a variable that will be resolved at run time to the name of the Agent Cluster to use.

Format: ${variable name}.

N

agentCluster,
broadcastCluster, and
broadcastClusterVar

Anchor

	agentFieldsRestriction - UTEMP
	agentFieldsRestriction - UTEMP

agentFieldsRestriction

Agent Fields

Restriction to apply to the group of Agent Fields.

Valid values:

As String = No Restriction, As Value = 0
As String = Read Only, As Value = 1
As String = Hidden, As Value = 2

N

Anchor

	agentType - UTEMP
	agentType - UTEMP

agentType

Agent Type

Type of Agent on which Universal Tasks based on this template can be run.

Valid values:

As String = Any, As Value = 1
As String = Linux/Unix, As Value = 2
As String = Windows, As Value = 3

Y

Anchor

	agentVar - UTEMP
	agentVar - UTEMP

agentVar

Agent Variable

Name of a variable that will be resolved at run time to the name of the Agent to use.

Format: ${variable name}.

N

agent,
broadcastCluster, and
broadcastClusterVar

Anchor

	alwaysCancelOnFinish - UTEMP
	alwaysCancelOnFinish - UTEMP

alwaysCancelOnFinish

Always Cancel On Finish

Specification for whether or not to always perform a Cancel when Force Finishing a Universal Task for this template.

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

N

Anchor

	automaticOutputRetrievalFieldsRestriction - UTEMP
	automaticOutputRetrievalFieldsRestriction - UTEMP

automaticOutputRetrievalFieldsRestriction

Automatic Output Retrieval Fields

Restriction to apply to the group of Automatic Output Retrieval Fields.

Valid values:

As String = No Restriction, As Value = 0
As String = Read Only, As Value = 1
As String = Hidden, As Value = 2

N

Anchor

	broadcastCluster - UTEMP
	broadcastCluster - UTEMP

broadcastCluster

Cluster Broadcast

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.

N

broadcastClusterVar,
agent,
agentVar,
agentCluster, and
agentClusterVar

Anchor

	broadcastClusterVar - UTEMP
	broadcastClusterVar - UTEMP

broadcastClusterVar

Cluster Broadcast Variable

Name of a variable that will be resolved at run time to the name of the Cluster Broadcast to use.

Format: ${variable name}

N

broadcastCluster,
agent,
agentVar,
agentCluster, and
agentClusterVar

Anchor

	createConsole - UTEMP
	createConsole - UTEMP

createConsole

Create Console

If desktopInteract is true; Specification for whether or not to allocate a new console for the process, rather than having it inherit one.

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

N

Anchor

	credentialFieldsRestriction - UTEMP
	credentialFieldsRestriction - UTEMP

credentialFieldsRestriction

Credential Fields

Restriction to apply to the group of Credential Fields.

Valid values:

As String = No Restriction, As Value = 0
As String = Read Only, As Value = 1
As String = Hidden, As Value = 2

N

Anchor

	credentials - UTEMP
	credentials - UTEMP

credentials

Credentials

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

Anchor

	credentialsVar - UTEMP
	credentialsVar - UTEMP

credentialsVar

Credentials Variable

Name of a variable that will be resolved at run time to the name of the {Credentials] to use.

N

credentials

Anchor

	description - UTEMP
	description - UTEMP

description

Description

Description of this Universal Template.

N

Anchor

	desktopInteract - UTEMP
	desktopInteract - UTEMP

desktopInteract

Interact with Desktop

Specification for whether or not a task that runs an application with a GUI requires some manual actions from a user (for example, clicking buttons or entering values).

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

This property is effective only for tasks executed on Windows XP or Server 2003. Windows Vista introduced the desktop isolation feature, which prevents tasks from accessing the interactive desktop session on Vista, Windows 7, Server 2008, Windows 8, and Server 2012. The Windows agent will execute the task, but the Interact with Desktop option has no effect. Therefore, an interactive application's GUI will not be visible on those platforms.

N

Anchor

	elevateUser - UTEMP
	elevateUser - UTEMP

elevateUser

Run with Highest Privileges

Specification for whether or not to execute the task using an elevated privileges token, rather than one subject to User Account Control (UAC) restrictions. An elevated token allows a process to execute with all the privileges available to its specified credentials. For example, a task executed with an administrative account will behave as though it received permission via a UAC dialog to perform a privileged operation.

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

This property will not give a user account privileges that have are not already granted to it. For example, taking ownership of a file is a privileged operation by default. A task will still fail even with this option selected if it is run with a regular user account that has not been granted the ability to change file ownership.

N

Anchor

	environment - UTEMP
	environment - UTEMP

environment

Environment Variables

Environment variables needed by the program to run.

List of environment variables:

Panel

Html bobswift
<pre> <environment> <variable> <name>env1</name> <value>test1</value> </variable> <variable> <name>env2</name> <value>test2</value> </variable> </environment> </pre>

N

Anchor

	environmentVariableFieldsRestriction - UTEMP
	environmentVariableFieldsRestriction - UTEMP

environmentVariableFieldsRestriction

Environment Variable Fields

Restriction to apply to the group of Environment Variables Fields.

Valid values:

As String = No Restriction, As Value = 0
As String = Read Only, As Value = 1
As String = Hidden, As Value = 2

N

Anchor

	excludeRelated - UTEMP
	excludeRelated - UTEMP

excludeRelated

n/a

Specification for whether or not to exclude related records.

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

For XML, excludeRelated is specified as an attribute on the universalTemplate element.

N

Anchor

	exitCodeOutput - UTEMP
	exitCodeOutput - UTEMP

exitCodeOutput

Output File

Path and file name of the output file that should be scanned for the text in exitCodeText.

N

Anchor

	exitCodeProcessing - UTEMP
	exitCodeProcessing - UTEMP

exitCodeProcessing

Exit Code Processing

Specification for how the Controller should determine whether the executed command failed or completed successfully.

Valid values:

Html bobswift

N

Anchor

	exitCodeProcessingFieldsRestriction - UTEMP
	exitCodeProcessingFieldsRestriction - UTEMP

exitCodeProcessingFieldsRestriction

Exit Code Processing Fields

Restriction to apply to the group of Exit Code Processing Fields.

Valid values:

As String = No Restriction, As Value = 0
As String = Read Only, As Value = 1
As String = Hidden, As Value = 2

N

Anchor

	exitCodes - UTEMP
	exitCodes - UTEMP

exitCodes

Exit Codes

If exitCodeProcessing is Success Exitcode Range or Failure Exitcode Range; Range of exit codes.

Format: Numeric. Use commas to list a series of exit codes; use hyphens to specify a range. Example: 1,5, 22-30.

Y

Anchor

	exitCodeText - UTEMP
	exitCodeText - UTEMP

exitCodeText

Scan Output For

If exitCodeProcessing is Success Output Contains (3) or Failure Output Contains (4); text for which the Controller should scan the output file.

The Controller will process this field as a regular expression.

Y

Anchor

	exportReleaseLevel - UTEMP
	exportReleaseLevel - UTEMP

exportReleaseLevel

n/a

Universal Controller release that the record was exported from.

read only

N

Anchor

	name - UTEMP
	name - UTEMP

name

Name

Name of this Universal Template.

Y

Anchor

	outputFailureOnly - UTEMP
	outputFailureOnly - UTEMP

outputFailureOnly

Failure Only

If outputReturnType = STDOUT (2), STDERR (3), FILE (4), or OUTERR (6), and waitForOutput is false; Indication for whether output should be retrieved on task failure only.

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

N

Anchor

	outputReturnFile - UTEMP
	outputReturnFile - UTEMP

outputReturnFile

Output File

If outputReturnType is FILE; Path and file name containing the output that you want automatically retrieved and attached to the task instance.

N

Anchor

	outputReturnNline - UTEMP
	outputReturnNline - UTEMP

outputReturnNline

Number of Lines

If outputReturnType is STDOUT, STDERR, FILE, or OUTERR; Limit the retrieved data to this number of lines.

Default is the value of the Retrieve Output Default Maximum Lines Universal Controller system property.

N

Anchor

	outputReturnSline - UTEMP
	outputReturnSline - UTEMP

outputReturnSline

Start Line

If outputReturnType is STDOUT, STDERR, FILE, or OUTERR; Instructs the Controller to retrieve data beginning at the line indicated.

Default is 1.

N

Anchor

	outputReturnText - UTEMP
	outputReturnText - UTEMP

outputReturnText

Scan Text

If outputReturnType is STDOUT, STDERR, FILE, or OUTERR; Instructs the Controller to scan the data for the text specified and retrieve only that.

The Controller will process this field as a regular expression.

N

Anchor

	outputReturnType - UTEMP
	outputReturnType - UTEMP

outputReturnType

Automatic Output Retrieval

Specificaton for whether you want the Controller to automatically retrieve any output from the job and attach it to the task instance record.

Valid values:

html-bobswift

As

String

=

NONE,

As

Value

=

1

<li>

As

String

=

STDOUT,

As

Value

=

2

<li>

As

String

=

STDERR,

As

Value

=

3

<li>

As

String

=

FILE,

As

Value

=

4

<li>

As

String

=

OUTERR,

As

Value

=

6

</ul>

Default is OUTERR (6).

Note

title	Note

If outputReturnType is not NONE (1), the web service will fail with Start Failure if outputProhibited is true for the specified agent.

N

Anchor

	outputType - UTEMP
	outputType - UTEMP

outputType

Output Type

If exitCodeProcessing is Success Output or Failure Output; Type of output.

Valid values:

Html bobswift

N

Anchor

	retainSysIds - UTEMP
	retainSysIds - UTEMP

retainSysIds

n/a

Specification for whether or not the Create a Universal Template web service will persist the sysId property.

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

For XML, retainSysIds is specified as an attribute on the universalTemplate element.

Used for both the Create and Update web services; for Update, it is used only for the related lists (Fields and Choices). It is recommended that retainSysIds be enabled when updating Choice values so that the command can determine which Choice values have been updated and propagate the new value to Universal Tasks using the previous Choice value.

If retainSysIds is not enabled when updating Choice values, the command can determine only which Choice values have been added or removed; Universal Tasks using the previous Choice values will not be updated.

N

Anchor

	runtimeDir - UTEMP
	runtimeDir - UTEMP

runtimeDir

Runtime Directory

Directory from which the application should be executed.

Variables are supported.

N

Anchor

	script - UTEMP
	script - UTEMP

script

Script

If useCommonScript is true; Script to be executed by the specified Agent.

N

Anchor

	scriptUnix - UTEMP
	scriptUnix - UTEMP

scriptUnix

Linux/Unix Script

If agentType is Any or Linux/Unix; Script to be executed by the Linux/Unix Agent.

N

Anchor

	scriptWindows - UTEMP
	scriptWindows - UTEMP

scriptWindows

Windows Script

If agentType is Any or Windows; Script to be executed by the Windows Agent.

N

Anchor

	scriptTypeWindows- UTEMP
	scriptTypeWindows- UTEMP

scriptTypeWindows

Windows Script File Type

If agentType is Windows; Type of Windows Script to be executed by the Windows Agent.

Valid values:

Html bobswift

N

Anchor

	sendVariables - UTEMP
	sendVariables - UTEMP

sendVariables

Send Extension Variables

If templateType is Extension; Specification for whether the Extension should be provided with task instance variable data when launched.

Options:

None
Do not provide the Extension with task instance variable data.
Local
Provide the Extension with task instance variable data.

Valid values:

As String = None, As Value = 0
As String = Local, As Value = 1

Default is None (0).

N

Anchor

	sysId - UTEMP
	sysId - UTEMP

sysId

UUID

System ID field in the database for this record.

Persisted only if retainSysIds is set to true.

N

Anchor

	templateType - UTEMP
	templateType - UTEMP

templateType

Template Type

Specification for whether the Universal Template will be executed as a Script or will be executed through the Universal Extension framework.

Valid values:

As String = Script, As Value = 1
As String = Extension, As Value = 2

Default is Script (1).

N

Anchor

	useCommonScript - UTEMP
	useCommonScript - UTEMP

useCommonScript

Use Common Script

Indication that the specified script can be executed by both Linux/Unix and Windows Agents.

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

N

Anchor

	variablePrefix - UTEMP
	variablePrefix - UTEMP

variablePrefix

Variable Prefix

Variable prefix to append to the default prefix (ops_) for the system-assigned variables that are provided for the user-defined Fields in this Universal Template.

Y

Anchor

	waitForOutput - UTEMP
	waitForOutput - UTEMP

waitForOutput

Wait For Output

If outputReturnType = STDOUT (2), STDERR (3), FILE (4), or OUTERR (6), and outputFailureOnly is false; Specification for whether or not the task should wait for the requested output before completing.

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

N

...

As

String

=

true/false,

As

Value

=

1

<li>

As

String

=

1/0,

As

Value

=

2

<li>

As

String

=

Custom,

As

Value

=

3

</ul>

Default is true/false (1).

As

String

=

Text,

As

Value

=

1

<li>

As

String

=

Integer,

As

Value

=

2

<li>

As

String

=

Boolean,

As

Value

=

3

<li>

As

String

=

Choice,

As

Value

=

4

<li>

As

String

=

Credential,

As

Value

=

5

<li>

As

String

=

Script,

As

Value

=

6

<li>

As

String

=

Array,

As

Value

=

7

<li>

As

String

=

Float,

As

Value

=

8

</ul>

Default is Text (1).

As

Value

=

1:

<li>

As

Value

=

2

<li>

As

Value

=

3

</ul>

Default is 1.

Property

UI Field Name

Description

Specifications

Required

Anchor

	arrayNameTitle - FIELD
	arrayNameTitle - FIELD

arrayNameTitle

Name Title

If fieldType is Array; Title to be displayed for the Name column.

N

Anchor

	arrayValueTitle - FIELD
	arrayValueTitle - FIELD

arrayValueTitle

Value Title

If fieldType is Array; Title to be displayed for the Value column.

N

Anchor

	booleanNoValue - FIELD
	booleanNoValue - FIELD

booleanNoValue

No Value

If booleanValueType is Custom; Boolean No value for this Field.

Y
(if booleanValueType
is Custom)

Anchor

	booleanValueType - FIELD
	booleanValueType - FIELD

booleanValueType

Boolean Value Type

Type of Boolean value for this Field.

Valid values:

Html bobswift

N

Anchor

	booleanYesValue - FIELD
	booleanYesValue - FIELD

booleanYesValue

Yes Value

If booleanValueType is Custom; Boolean Yes value for this Field.

Y
(if booleanValueType
is Custom)

Anchor

	choiceAllowEmpty - FIELD
	choiceAllowEmpty - FIELD

choiceAllowEmpty

Allow Empty Choice

If fieldType is Choice; Specification for whether or not an empty (blank) option is available for this Choice field in any Universal Task based on this template, allowing the user to clear the value of this field.

N

Anchor

	choiceAllowMultiple - FIELD
	choiceAllowMultiple - FIELD

choiceAllowMultiple

Allow Multiple Choices

If fieldType is Choice; Specification for whether or not more than one choice can be selected at a time. When multiple choices are selected, the built-in field variable will resolve to a comma-delimited String of choice values.

N

Anchor

	choiceSortOption - FIELD
	choiceSortOption - FIELD

choiceSortOption

Choice Sort Option

If fieldType is Choice; Specification for how Choices will be listed in the Choice field in Universal Task.

Valid values:

html-bobswift

As

String

=

Sequence,

As

Value

=

1

<li>

As

String

=

Label,

As

Value

=

2

</ul>

Default is Sequence (1).

N

Anchor

	defaultListView - FIELD
	defaultListView - FIELD

defaultListView

Add To Default List View

Specification that the label of this Field will display, by default, in the list of Universal Tasks based on this template.

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

N

Anchor

	fieldLength - FIELD
	fieldLength - FIELD

fieldLength

Length

If fieldType is Text or Integer; Length of this Field.

Integer

N

Anchor

	fieldMapping - FIELD
	fieldMapping - FIELD

fieldMapping

Mapping

Field, from a pool of available fields provided for use in a Universal Template, that this Field is mapped to.

Valid values:

As String =
- Integer Field [1-10]
- Boolean Field [1-10]
- Text Field [1-20]
- Large Text Field [1-2]
- Choice Field [1-15]
- Credential Field [1-6]
- Script Field [1-2]
- Array Field [1-4]
- Float Field [1-4)

Y

Anchor

	fieldType - FIELD
	fieldType - FIELD

fieldType

Type

Field type for this Field.

Valid values:

Html bobswift

N

Anchor

	fieldValue - FIELD
	fieldValue - FIELD

fieldValue

Default Value

Default value for this Field.

Value values by fieldType:

fieldType = Text, fieldValue = string
fieldType = Integer, fieldValue = integer
fieldType = Boolean, fieldValue = true/false
fieldType = Choice, fieldValue = Choice Value
fieldType = Credential, fieldValue = Credential Name
fieldType = Script, fieldValue = Script Name
fieldType = Array, fieldValue = (not supported)
fieldType = Float, fieldValue = float

N

Anchor

	formColumnSpan - FIELD
	formColumnSpan - FIELD

formColumnSpan

Column Span

Number of columns (width) in the Universal Task (based on this Universal Template) Details for this Field.

Valid values:

Html bobswift

N

Anchor

	formEndRow - FIELD
	formEndRow - FIELD

formEndRow

End Row

Specification that this Field will end the current row.

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

N

Anchor

	formStartRow - FIELD
	formStartRow - FIELD

formStartRow

Start Row

Specification that this Field will start a new row.

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

N

Anchor

	hint - FIELD
	hint - FIELD

hint

Hint

Field hint for this Field in the Controller user interface.

N

Anchor

	intFieldMax - FIELD
	intFieldMax - FIELD

intFieldMax

Maximum

If fieldType is Integer; Maximum value for this Field.

Integer

N

Anchor

	intFieldMin - FIELD
	intFieldMin - FIELD

intFieldMin

Minimum

If fieldType is Integer; Minimum value for this Field.

Integer

N

Anchor

	label - FIELD
	label - FIELD

label

Label

Name of this Field to be displayed in the Controller user interface.

Y

Anchor

	name - FIELD
	name - FIELD

name

Name

Name of this Field in the Controller database.

Y

Anchor

	noSpaceIfHidden - FIELD
	noSpaceIfHidden - FIELD

noSpaceIfHidden

No Space If Hidden

Specification that a space should not be reserved in place of the hidden field.

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

N

Anchor

	preserveValueIfHidden - FIELD
	preserveValueIfHidden - FIELD

preserveValueIfHidden

Preserve Value If Hidden

Specification that the value of this field should be preserved if the field is hidden.

Note

title	Note

A Field with preserveValueIfHidden = true will be validated even if the Field is hidden.

Also, if a Field's showIfField or requireIfField specifies a field (for example, Boolean Field 1) that has preserveValueIfHidden = true, when validating whether the Field is visible or required, Boolean Field 1’s value is considered visible.

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

N

Anchor

	required - FIELD
	required - FIELD

required

Required

Specification for whether this Field is required or optional.

Note

title	Note

If you modify a Universal Template Field to add a Required condition, review and assign an appropriate field value to any Universal Tasks that are no longer in compliance to avoid a Start Failure.

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

N

Anchor

	requireIfField - FIELD
	requireIfField - FIELD

requireIfField

Require If Field

If required is false and showIfField is not specified; Specification that this Field in the template will be required in any Universal Tasks based on this template the Choice Field (Choice Field 1-15) or Boolean Field (Boolean Filed 1-10) selected as the Require If Field has a value corresponding to the value(s) defined in the Require If Filed Value(s) field.

Note

title	Note

If you modify a Universal Template Field to add or augment a Require If Field condition, review and assign an appropriate field value to any Universal Tasks that are no longer in compliance to avoid a Start Failure.

Valid values:

As String = Choice Field [1-15]
As String = Boolean Field [1-10]

N

Anchor

	requireIfFieldValue - FIELD
	requireIfFieldValue - FIELD

requireIfFieldValue

Require If Field Value(s)

If requireIfField is not null/empty; Value(s) for the specified requireIfField.

Y
(if requireIfField
is specified)

Anchor

	requireIfVisible - FIELD
	requireIfVisible - FIELD

requireIfVisible

Require If Visible

Specification that the Field is required if it is visible.

Note

title	Note

If you modify a Universal Template Field to add a Require If Visible condition, review and assign an appropriate field value to any Universal Tasks that are no longer in compliance to avoid a Start Failure.

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

N

Anchor

	sequence - FIELD
	sequence - FIELD

sequence

Sequence

For existing Fields only; System-defined; Sequence of this Field among all user-defined Universal Template Fields to be included in the Universal Task Details. Starting sequence is 0 for the first defined Field.

Integer; Read-only.

Note

title	Note

sequence is included in the XML/JSON by the Read and List web services; however, it is not used by the Create and Update web services. For Create and Update, the sequence is set based on the Field order specified in the XML/JSON.

N

Anchor

	showIfField - FIELD
	showIfField - FIELD

showIfField

Show If Field

If required is false and requireIfField is not specified; Specification that this Field in the template will be visible in any Universal Tasks based on this template if the Choice Field (Choice Field 1-15) or the Boolean Field (Boolean Field 1-10) selected as the Show If Field has a value corresponding to the value(s) defined in the Show If Field Value(s) field.

Valid values:

As String = Choice Field [1-15]
As String = Boolean Field [1-10]

N

Anchor

	showIfFieldValue - FIELD
	showIfFieldValue - FIELD

showIfFieldValue

Show If Field Value

If showIfField is not null/empty; Value(s) for the specified showIfField.

Y
If showIfField
is specified.

Anchor

	sysId - FIELD
	sysId - FIELD

sysId

n/a

sys_id used within the Controller to identify this Universal Template Field.

Persisted only if retainSysIds is set to true.

N

...

Versions Compared

Old Version 41

New Version Current

Key