Task Properties: SAP Task

Property	UI Field Name	Description	Specifications	Required	Mutually Exclusive With
`chainDesc`	Chain Description	If `sapDisplayCommand` equals Process Chains (19); Displays the list of processes contained within the specified process chain.		N
`chainId`	Chain ID	If `commandGroup` is one of the following; ID of the process chain to run: Run Process Chain Start Process Chain Wait Process Chain Interrupt Process Chain Display and `sapDisplayCommand` is Process Chains (19), Process Chain (20), Process Chain Log (21), Process Chain Start Condition (22), or Process Chain Status (23)		Y
`commandGroup`	Command Group	Universal Connector command group.	Valid values: As String = Run, As Value = 1 As String = Submit, As Value = 2 As String = Modify, As Value = 3 As String = Start, As Value = 4 As String = Wait, As Value = 5 As String = Abort, As Value = 6 As String = Purge Job, As Value = 7 As String = Raise Event, As Value = 8 As String = Display, As Value = 9 As String = Generate Variant Definition, As Value = 10 As String = Generate Job Definition, As Value = 11 As String = Create CM Profile, As Value = 12 As String = Set CM Criteria, As Value = 13 As String = Activate CM Profile, As Value = 14 As String = Deactivate CM Profile, As Value = 15 As String = Delete CM Profile, As Value = 16 As String = Purge Variant, As Value = 17 As String = Run Process Chain, As Value = 18 As String = Start Process Chain, As Value = 19 As String = Wait Process Chain, As Value = 20 As String = Interrupt Process Chain, As Value = 21 As String = Run InfoPackage, As Value = 22 As String = Start InfoPackage, As Value = 23 As String = Wait InfoPackage, As Value = 24 Default is Run (1).	N
`commandOptions`	SAP Command Options	Any additional command options supported by Universal Connector.		N
`dataSource`	Data Source	If `sapDisplayCommand` is InfoPackages(24); SAP InfoPackage data source.		N
`defFile`	Definition File	For Run, Submit, and Modify `commandGroups` if `repositoryOrFilesys` is File System; Path and file name of the file.		Y
`definitionOrModel`	Definition or Model	If `commandGroup` is Run(1); Specification for how the new SAP job will be created, based either on a USAP Definition File or an SAP Model Job.	Valid values: As String = USAP Definition File, As Value = 1 As String = SAP Model Job, As Value = 2 Default is USAP Definition File (1).	N
`definitionOrModelJobVar`	Definition or Model	If `commandGroup` is Submit(1); Name of a variable that will be resolved at run time to the name of the Definition or Model to use.	Valid values: As String = USAP Definition File, As Value = 1 As String = SAP Model Job, As Value = 2 As String = SAP Model Variant, As Value = 3 Default is USAP Definition File (1).	N
`dispAbapName`	SAP ABAP Program Name	If `definitionOrModelJobVar` is SAP Model Variant; Name of an ABAP program in an SAP system to which the model variant belongs.		Y
`dispSapEventId`	SAP Event	If `sapDisplayCommand` is Event History(16); ID of the Event.		Y
`dispSapEventParm`	SAP Event Parameter	If `sapDisplayCommand` is Event History(16); Optional parameter value for the event.		N
`dispVariant`	SAP Variant Name	Pre-existing SAP variant name to use as the model variant.		N
`emailNotification`		XML: `<emailNotification> <language>email language</language> <notifyType>Status Cancelled</notifyType> <recipient>email recipient</recipient> </emailNotification>` JSON: `"emailNotification": { "language": "email language", "notifyType": "Status Cancelled", "recipient": "email recipient" }`	See Email Notification payload properties.	N
`environment`	Environment Variables	List of environment variables needed by the program to run: <environment> <variable> <name>env1</name> <value>test1</value> </variable> <variable> <name>env2</name> <value>test2</value> </variable> </environment>		N
`exitCodeOutput`	Output File	If `outputType` = FILE (3); Path and file name of the output file that should be scanned for the text in `exitCodeText`.		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 As String = Step Conditions, As Value = 5 Default is Success Exitcode Range (1).	N
`exitCodes`	Exit Codes	If `exitCodeProcessing` = Success Exitcode Range (1) or Failure Exitcode Range (2); 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
`exitCodeText`	Scan Output For	If `exitCodeProcessing` = 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
`immediate`	Start Immediately	If `commandGroup` is Run(1) or Start(4), or `start` is true; Causes the job to fail if SAP resources are not available to start the job immediately (for example, a background work process). Otherwise, the job will wait for SAP resources to become available.	Boolean; Valid values: true/false. Default is false.	N
`infoPackage`	InfoPackage	If `commandGroup` is one of the following; Name of the InfoPackage: Run InfoPackage (22) Start InfoPackage(23) Display(9) and `sapDisplayCommand` equals InfoPackages (24).		Y
`infoPackageJobname`	InfoPackage Job Name	If `commandGroup` is one of the following; Name of the SAP batch job that processes the InfoPackage request: Run InfoPackage (22) Start InfoPackage (23)		Y
`infoSource`	InfoSource	If `sapDisplayCommand` equals InfoPackages (24); SAP InfoSource.		N
`jobClass`	Job Class	Job class for the SAP Job.	Valid Values: As String = High Priority, As Value = 1 As String = Middle Priority, As Value = 2 As String = Low Priority, As Value = 3 Default is Low Priority (3).
`jobId`	SAP Job ID	Job ID of the SAP job.	Variables are supported.	N
`jobLog`	Print Job Log	If `commandGroup` is Wait (5) or `wait` is true; Specification for whether or not the job's joblog is returned.	Boolean; Valid values: true/false. Default is false.	N
`jobLogChild`	Job Log Child	Specifies whether or not to return job logs for child jobs.	Valid Values: As String = Yes, As Value = 1 As String = No, As Value = 2 As String = Error, As Value = 3 Default is Yes (1).	N
`jobName`	SAP Job Name	Job name of the SAP job.	Variables are supported.	N
`jobStatus`	Status	If `sapDisplayCommand` equals InfoPackages(24); Current status for an SAP job.		N
`logId`	Log ID	If `commandGroup` is one of the following; Log ID for process chain instance to be restarted: Start Process Chain and `pcRestart` is true. Wait Process Chain. Display (9) and `sapDisplayCommand` is Process Chain (20), Process Chain Log (21), or Process Chain Status (23).		Y
`maxChildDepth`	Max Child Depth	Specifies the maximum depth of child processes that Universal Connector will monitor.	Integer	N
`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
`outputReturnFile`	Output File	If `outputReturnType` is FILE (4); Path and file name containing the output that you want automatically retrieved and attached to the task instance.		Y
`outputReturnNline`	Number of Lines	If `outputReturnType` is STDOUT (2), STDERR (3), FILE (4), or OUTERR (6); Allows you to limit the retrieved data to the number of lines specified.	Integer; Default is the value of the Retrieve Output Default Maximum Lines Universal Controller system property.	N
`outputReturnSline`	Starting Line	If `outputReturnType` is STDOUT (2), STDERR (3), FILE (4), or OUTERR (6); Allows you to instruct the Controller to retrieve data beginning at this line.	Integer; Default is 1.	N
`outputReturnText`	Scan Text	If `outputReturnType` is STDOUT (2), STDERR (3), FILE (4), or OUTERR (6); 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
`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 NONE (1). Note If `outputReturnType` is not NONE (1), the web service will fail with Start Failure if `outputProhibited` is true for the specified `agent`.	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 = FILE, As Value = 3 Default is STDOUT (1).	Y
`pcRestart`	Restart	If `commandGroup` equals Start Process Chain (18); Specification for whether or not to restart failed and cancelled processes (R or X) in the specified process chain instance.	Boolean. Valid values: true/false. Default is false.	N
`printAppLog`	Print Application Log	If `commandGroup` is Run (1) or Wait (5), or `wait` is true; Specification for whether or not the job's application log, if one was generated, is returned.	Boolean. Valid values: true/false. Default is false.	N
`printAppRc`	Print Application RC	If `commandGroup` is Run (1) or Wait (5) or `wait` is true; Specification for whether or not the job's application return codes, if they were set, are returned.	Boolean. Valid values: true/false. Default is false.	N
`purge`	Delete SAP Job on Completion	If `commandGroup` is Wait(5) or `wait` is true;	Boolean. Valid values: true/false. Default is false.	N
`purgeChild`	Purge Child	Specification for whether or not to purge all child jobs from the SAP system.	Boolean; Valid values: true/false. Default is false.	N
`repositoryOrFilesys`	Script or File System	Specification for whether the USAP definition file exists in the file system of the machine where the Agent is running or in Scripts.	Valid values: As String = Script, As Value = 1 As String = File System, As Value = 2 Default is Script (1).	N
`requestId`	Request ID	If `commandGroup` is Wait InfoPackage(24) or Display(9) and `sapDisplayCommand` is InfoPackages Status (25); Request ID of the InfoPackage that is to be monitored.		Y
`retryIndefinitely`	Retry Indefinitely	Specification for whether or not the Controller should continue trying indefinitely to run this task.	Boolean; Valid values: true/false. Default is false. This value overrides any value placed in `retryMaximum`.	N
`retryInterval`	Retry Interval]	Number of seconds between each retry.	Integer; Default is 60.	N
`retryMaximum`	Maximum Retries	Maximum number of times that the Controller should retry this task after it has started and gone to a failed state.	Integer; Default is 0.	N
`retrySuppressFailure`	Suppress Intermediate Failures	Specification for whether or not the following will be suppressed until all scheduled retry attempts have been made: All Actions (Abort, Email Notification, Set Variable, SNMP Notification, and System Operation) to be made against the task instance. Workflow conditional path processing; any Successors waiting on a failure path will not be released. Task Monitors will not be notified of the Failed status. Also, any Task Monitor task that has a Time Scope in the past will disqualify any matching task instance in the past with a Failed status if the task instance is scheduled for automatic retry and for which Suppress Intermediate Failures has been enabled. Any Workflow containing the Failed task instance will not transition to the Running/Problems status.	Boolean; Valid values: true/false. Default is false.	N
`runtimeDir`	Runtime Directory	Directory from which the application should be executed. Variables are supported.		N
`sapCmProfileId`	SAP Criteria Manager Profile ID	If `commandGroup` is Set CM Profile, Activate CM Profile, or Delete CM Profile; ID of the profile.		Y
`sapCmProfileType`	SAP Criteria Manager Profile Type	If `commandGroup` is Set CM Profile, Activate CM Profile, Deactivate CM Profile, or Delete CM Profile; Type of profile. For the default criteria types provided by SAP, the values are: EVTHIS - Identifies a criteria type for event history. EVHIRO - Identifies a criteria type for the reorganization of raised events. INTERC - Identifies a criteria type for job interception.		Y
`sapCmXmlFile`	SAP Criteria Manager XML File	If `commandGroup` is Create CM Profile or Set CM Profile, and `repositoryOrFilesys` is File System; Name of the file that contains the Criteria Manager information.		Y
`sapCommandMask`	SAP Command Mask	Name of a command or a mask used to select SAP external commands that match the mask.		N
`sapConnection`	SAP Connection	Name of the SAP connection.	The SAP connection specifies information about the SAP server.	Y (unless {{sap ConnectionVar}} is specified)	`sapConnectionVar`
`sapConnectionVar`	SAP Connection Variable	Name of a variable that will be resolved at run time to the name of the SAP Connection to use.		Y (unless {{sap Connection}} is specified)	`sapConnection`
`sapCred`	SAP Credentials	Login credentials that the Controller will use to access the SAP system.	The credentials are stored in the Universal Controller credentials table; see Credentials.	Y (unless `sapCredVar` is specified)	`sapCredVar`
`sapCredVar`	SAP Credentials Variable	Name of a variable that will be resolved at run time to the name of the SAP Credentials to use.		Y (unless `sapCred` is specified)	`sapCred`
`sapDispConfirmEvents`	Confirm Returned Events	If `sapDisplayCommand` is Event History(16); Specification for whether or not the status of returned events should be changed in the SAP system.		N
`sapDispEventSelectState`	Event Select State	Event status of the events which should be read.	Valid values: As String = New, As Value = 1 As String = Confirmed, As Value = 2 As String = All, As Value = 3 Default is New (1).	N
`sapDisplayCommand`	Display Command	Displays the specified data, which is written to standard output.	Valid values: As String = Job Log, As Value = 1 As String = Spool List, As Value = 2 As String = Status, As Value = 3 As String = Variants, As Value = 4 As String = Variant, As Value = 5 As String = Job Definition, As Value = 6 As String = Select, As Value = 7 As String = System Log, As Value = 8 As String = Intercept Table, As Value = 9 As String = Intercepted Jobs, As Value = 10 As String = Reports, As Value = 11 As String = Commands, As Value = 12 As String = Output Devices, As Value = 13 As String = Print Formats, As Value = 14 As String = Selection Screen, As Value = 15 As String = Event History, As Value = 16 As String = Criteria Manager Profiles, As Value = 17 As String = Criteria Manager Criteria, As Value = 18 As String = Process Chains, As Value = 19 As String = Process Chain, As Value = 20 As String = Process Chain Log, As Value = 21 As String = Process Chain Start Condition, As Value = 22 As String = Process Chain Status, As Value = 23 As String = InfoPackages, As Value = 24 As String = InfoPackages Status, As Value = 25 Default Value: Log (1)	N
`sapEventId`	SAP Event	If `commandGroup` is Raise Event (8); Name of the event.		Y
`sapEventParm`	SAP Event Parameter	If `commandGroup` equals Raise Event(8); Optional parameter value for the event.		N
`sapFromDate`	From Date	If `sapDisplayCommand` is Select (7) or System Log (8); Earliest date to use for job selection or syslog request.		N
`sapLang`	SAP Language	SAP logon language used when executing the SAP task.	Valid values: Any valid 1-character SAP language identifier. Any valid 2-character ISO language identifier. (no value). SAP will use the default language set up for the user. If there is no such default, the default is EN (English).
`sapPrinterName`	SAP Printer Name	If `sapDisplayCommand` is Print Formats (14); Name of the SAP printer.		Y
`sapToDate`	To Date	If `sapDisplayCommand` is Select(7) or System Log (8); Latest date to use for job selection or syslog request.		N
`sapView`	View	Specifies whether to display the SAP task in Legacy View or Enhanced View. Enhanced View runs as Command Group Submit with both Start and Wait options enabled automatically.	Valid Values: As String = Legacy View, As Value = 1 As String = Enhanced View, As Value = 2 Default is Legacy View (1).
`script`	Script	If `repositoryOrFilesys` is Script; Name of an SAP Definition script in the Controller database.		Y
`sourceSystem`	Source System	If `sapDisplayCommand` equals InfoPackages (24); SAP InfoPackage source system.		N
`spoollist`	Print Spooled Output	If `commandGroup` is Wait(5) or `wait` is true; Specification for whether or not the spoollists of all job steps are returned.	Boolean; Valid values: true/false. Default is false.	N
`spoollistChild`	Spool List Child	Specification for whether or not to print the spool list for child jobs.	Boolean; Valid values: true/false. Default is false.	N
`spoolListRecipient`		XML: `<spoolListRecipient> <blindCopy>true</blindCopy> <copy>true</copy> <deliver>true</deliver> <express>true</express> <mailStatus>Always</mailStatus> <noForwarding>true</noForwarding> <recipient>notificationRecipient</recipient> <recipientType>External Addresses</recipientType> </spoolListRecipient>` JSON: `"spoolListRecipient": { "blindCopy": true, "copy": true, "deliver": true, "express": true, "mailStatus": "Always", "noForwarding": true, "recipient": "notificationRecipient", "recipientType": "External Addresses" }`	See Spool List Recipient payload properties.	N
`start`	Start	Specification for whether or not the newly-defined SAP job should be started.	Boolean; Valid values: true/false. Default is false.	N
`stepNum`	SAP Job Step Number	If `sapDisplayCommand` is Spool List; Step number of the SAP job step.		Y
`targetJobName`	Target Job Name	If `commandGroup` equals Run or Submit and `definitionOrModel` is SAP Model Job (2); Name of the new SAP job being created.	If you do not include `targetJobName`, the Controller uses the same name as the SAP Model Job.	N
`targetServer`	SAP Target Server	If `commandGroup` is Run (1) or Start (4), or `start` is true; Name of an SAP instance at which a background job should be run.	The name has the following format: [host name]_[SAP System name]_[SAP System number] Where host name is the name of the server computer on which the instance is running, as specified in the system profile parameter SAPLOCALHOST. For example: hs0123_C11_55	N
`targetVariantName`	Target Variant Name	If `commandGroup` is Submit and `definitionOrModelJobVar` is SAP Model Variant (3); One or more replacement variants for ABAP program job steps in an SAP job.		Y
`useAppRc`	Use Application RC	If `commandGroup` is Run (1) or Wait(5), or `wait` is true; Specification for whether or not the SAP job's application return codes will be used to determine the return code for the Universal Controller task.	Boolean; Valid values: true/false. Default is false.	N
`wait`	Wait	Specification for whether or not the Controller should wait for the SAP process chain to complete processing.	Boolean; Valid values: true/false. Default is false.	N
`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
`waitChild`	Wait Child	Specification for whether or not to monitor child jobs.	Boolean; Valid values: true/false. Default is false.	N

Email Notification Properties: SAP Task

Property

UI Field Name

Description

Specifications

Required

recipient

Email Recipient

Specifies one or more email addresses.

N

language

Email Language

Specifies the language of the email.

N

notifyType

Send Email

Specifies the circumstances in which to send the email notification.

Valid Values:

As String = Status Cancelled , As Value = 1
As String = Status Completed and Cancelled, As Value = 2
As String = Never, As Value = 3

Default is Status Cancelled (1).

N

Spool List Recipient Properties: SAP Task

Property	UI Field Name	Description	Specifications	Required
`recipient`	Recipient	Recipient address.		N
`copy`	Copy	If true, recipient will receive the document as a copy.	Boolean; Valid values: true/false. Default is false.	N
`express`	Express	If true, document will be sent to the recipient as an express message.	Boolean; Valid values: true/false. Default is false.	N
`blindCopy`	Blind Copy	If true, recipient will receive the document as a blind copy.	Boolean; Valid values: true/false. Default is false.	N
`noForwarding`	No Forwarding	If true, recipient cannot forward the document to other users.	Boolean; Valid values: true/false. Default is false.	N
`deliver`	Report Send Status		Valid Values: As String = -- System Default -- , As Value = 0 As String = Always, As Value = 1 As String = Error , As Value = 2 As String = Never , As Value = 3 Default is -- System Default -- (0).	N
`recipientType`	Type	Recipient type.	Valid Values: As String = None, As Value = 0 As String = SAP Username, As Value = 1 As String = External Addresses, As Value = 2 As String = Shared Distribution List , As Value = 3 As String = Private Distribution List, As Value = 4 As String = Fax Number, As Value = 5 As String = Internet Address, As Value = 6 As String = X.400 Address , As Value = 7 As String = Remote Mail Address, As Value = 8 Default is None(0).	N
`mailStatus`	Report Status by Email		Valid Values: As String = -- System Default -- , As Value = 0 As String = Always, As Value = 1 As String = Error , As Value = 2 As String = Never , As Value = 3 Default is -- System Default -- (0).	N

Browser not supported