PeopleSoft Task Properties

Owned by Stonebranch (Deactivated)
Feb 06, 2023
4 min read

Task Properties: PeopleSoft Task

Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive With

command

Command

PeopleSoft command to execute.

Valid values:

  • As String = Schedule Process, As Value = 1
  • As String = Schedule Job, As Value = 2
  • As String = Run Jobset, As Value = 3

 
Default is Schedule Process (1).

N


connection

PeopleSoft Connection

Name of the PeopleSoft Connection.


Y
(unless connectionVar
is specified)

connectionVar

connectionVar

PeopleSoft Connection Variable

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


Y
(unless connection
is specified)

connection

contentFilter

Content Filter

Comma-delimited list of report file suffixes that will not be returned.

For example: pdf,xls

N


distributionOptions

Distribution Options

If command is Schedule Process; Recipients of the process output.

Format:
 

<distributionOptions>
	<distributionOption>
		<distributionId>PS_User_1</distributionId>
		<distributionIdType>User</distributionIdType>
	</distributionOption>
	<distributionOption>
		<distributionId>PS_Role_1</distributionId>
 		<distributionIdType>Role</distributionIdType>
	</distributionOption>
</distributionOptions>

N


emailAddresses

Email Address List

If command is Schedule Process; list of email addresses, separated by semicolons.


N


emailAttachLog

Email With Log

If command is Schedule Process; Specification for whether or not to attach log files resulting from the Structured Query Report (SQR). Only applicable if processType is SQR Report.

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

N


emailSubject

Email Subject

If command is Schedule Process; Subject line of the email.

If not specified, default subject line is used.

N


emailText

Email Text

If command is Schedule Process; Body of the email.

If not specified, default body message is used.

N


emailWebReport

Email Web Report

If command is Schedule Process; Specification for whether or not to include a link to the completed report output. Only applicable when outputType is Web.

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

N


exitCodeProcessing

Exit Code Processing

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

Valid values:

  • As String = Success Exitcode Range, As Value = 1
  • As String = Failure Exitcode Range, As Value = 2
  • As String = Success Output Contains, As Value = 3
  • As String = Failure Output Contains, As Value = 4


Default is Success Exitcode Range (1).

N


exitCodeText

Scan Output For

If exitCodeProcessing = Success Output Contains or Failure Output Contains; text for which the Controller should scan the output file.

The Controller will process this field as a regular expression.

N


exitCodes

Exit Codes

If exitCodeProcessing = 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


mainJobName

Main Job Name

If command = Run Jobset; Name of the job within the jobset schedule.


Y


mainSchedName

Main Schedule Name

If command = Run Jobset; Name of the jobset schedule.


Y


outputDestFormat

Output Destination Format

If command = Schedule Process or Schedule Job; Override of the default output format for the submitted job or process.


N


outputDestString

Output Destination String

If command = Schedule Process or Schedule Job; File path or printer destination for the output.


N


outputDestType

Output Destination Type

If command = Schedule Process or Schedule Job; Type of output for the submitted process.


N


outputFailureOnly

Failure Only

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

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

N


outputReturnFile

Automatic Output File

If outputReturnType = FILE; Output file to return automatically.


Y


outputReturnNline

Number of Lines

If outputReturnType = SSTDOUT, STDERR, FILE, or OUTERR; Allows you to limit the retrieved data to the number of lines specified.


N


outputReturnSline

Start Line

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


N


outputReturnText

Scan Text

If outputReturnType = STDOUT, STDERR, FILE, or OUTERR; Regex pattern that the Controller will search for a match for in STDOUT/STDERR or a specified file.

The Controller will include the Number of Lines above and below the first line matched.

N


outputReturnType

Automatic Output Retrieval

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

Valid values:

  • As String = NONE, As Value = 1
  • As String = STDOUT, As Value = 2
  • As String = STDERR, As Value = 3
  • As String = FILE, As Value = 4
  • As String = OUTERR, As Value = 6

Default is OUTERR (6).

N


outputType

Output Type

If exitCodeProcessing = Success Output Contains (3) or Failure Output Contains (4); Type of output.

Valid values:

  • As String = STDOUT, As Value = 1
  • As String = STDERR, As Value = 2
  • As String = FILEE, As Value = 3 

Default is STDOUT (1).

N


printAppMessage

Print Application Message

Specification for whether or not the application messages for the monitored processes are included in the Job Report.

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

N


printDistList

Print Distribution List

Specification for whether or not the report-recipient distribution list is included in the Job Report.

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

N


printJobTree

Print Job Tree

Specification for whether or not the job tree is included in the Job Report.

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

N


printParamList

Print Parameter List

Specification for whether or not the parameter list job items are included in the Job Report.

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

N


printSystemMessage

Print System Message

Specification for whether or not the system messages for the monitored processes are included in the Job Report.

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

N


processFileName

Process File Name

If command = Schedule Process or Schedule Job; Dependent file name.


N


processName

Process/Job Name

If command = Schedule Process or Schedule Job; Name of the PeopleSoft process.


N


processType

Process Type

If command = Schedule Process or Schedule Job; Type of the PeopleSoft process.


N


psCredentials

PeopleSoft Credentials

Credentials for the PeopleSoft system.


Y
(unless psCredentialsVar
is specified)

psCredentialsVar

psCredentialsVar

PeopleSoft Credentials Variable

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


Y
(unless psCredentials
is specified)

psCredentials

report

Report

Specification for whether or not reports associated with a process are returned.

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

N


reportFolderName

Report Folder Name

If command = Schedule Process or Schedule Job; Folder in which the report will be viewed in Report Manager.


N


retentionDays

Retention Days

If command = Schedule Process or Schedule Job; Number of days that reports generated by the submitted process should be retained by the system.


N


runControlId

Run Control ID

If command = Schedule Process or Schedule Job; Run control ID to be used for the process submission.


Y


serverName

Server Name

If command = Schedule Process or Schedule Job; Specific server name.


N


waitForOutput

Wait For Output

If outputReturnType = STDOUT, STDERR, FILE, or OUTERR, 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