Skip to main content

Workflow Activities

Workflows are created and edited using the Workflow Designer which includes many building blocks (Activities) for submitting Jobs, updating JAMS Variables, and many more JAMS specific tasks.

Below is a listing and a brief description of Activities available in JAMS Workflow Designer. Each Activity is organized by grouping. Note that some tasks listed here require JAMS Integration Packs.

JAMS Grouping

AskQuestionUsed to halt an executing workflow until user input is provided. This Activity sends the question to the JAMS Scheduler and displays the question in the Monitor View. Users with Manage access for the Job can respond to the question using the Monitor View detail window.
GetVariableGets the value of a JAMS variable.
ManageActivityProvides an execution scope in which Activities can be canceled or retried.
RepeatHosts one Activity that is repeated at an interval.
SetJAMSContextThis is necessary only if you are using JAMS Activities in a non-JAMS environment. When a JAMS workflow is executed, the JAMS Context is automatically established. If using Activities outside of JAMS, you can either set the JAMS Server in each Activity or add a SetJAMSContext activity to the workflow allowing all subsequent JAMS Activities to utilize the JAMS Server.
SetVariableSets the value of a JAMS variable.
TimeLimitExecutes it’s child Activity until completed or if a set time limit is reached.
SetTodaySets the value of “today” in the workflow.
CommentAllows its child Activity to be enabled or disabled.
SubmitEntrySubmits another JAMS Job. The Activity can wait for the completion of the submitted Job and can take different actions depending on the success or failure of the entry. You can use the OverridePriority property to set the property of the submitted entry. If a number value is specified for the property, it will be set on the entry and override the value on the Job. The user that the Workflow runs as must have the Manage access to the Job being submitted.

SQL Grouping

OdbcScriptRuns SQL commands through an ODBC connection.
OleDbScriptRuns SQL commands through an OLEDB connection.
SQLScriptRuns SQL commands.
SQLStoredProcExecutes a SQL stored procedure.
SQLQueryScalar<T>Runs a query on a SQL Server database and outputs the first results into a Workflow variable of the specific Type.

Oracle Grouping

SQL*Plus ScriptRuns a SQL*Plus script on an Oracle database.
OracleQueryScalar<T>Runs a query on a Oracle database and outputs the first results into a Workflow variable of the specific Type.

Execution Grouping

CMDScriptRuns a command script.
ExecuteCMDExecutes a single command using CMD.EXE.
ExecuteProcessExecutes any process or executable.
CancelableIncludes an option to send a cancellation request to its body Activity.

PowerShell Grouping

PSWrapperWrapper around a PowerShell function or command.
PSRunspaceDefines the scope of a PowerShell runspace.
PSScriptRuns a PowerShell script.
PSScript <T>

Communication Grouping

SendEmailSends email using SMTP.

Files Grouping

ForEachFileFinds the designated files within a directory matching a wildcard pattern.
UnzipFilesUnzips a .Zip file.
WaitforFileWaits for events on a specified file.
ZipFilesCreates a .Zip file.

Files Transfer Grouping

FtpDownloadDownloads a file using FTP or SecureFTP (SFTP).
FtpUploadUploads a file using FTP or SFTP.
SftpDownloadDownloads a file using Secure FTP (SFTP).
SftpUploadUploads a file using Secure FTP (SFTP).
ScpDownloadDownloads a file using Secure Copy Protocol (SCP).
ScpUploadUploads a file using Secure Copy Protocol (SCP).
S3DownloadDownloads a file using Amazon's Simple Storage Service (S3).
S3UploadUploads a file using Amazon's Simple Storage Service (S3).

File Transfer Session Grouping

SFTPSessionHosts an SFTP connection for other FileTransferSession Activities.
FTPSessionHosts an FTP connection for other FileTransferSession Activities.
ScpSessionHosts an SCP connection for other FileTransferSession Activities.
S3SessionHosts an Amazon S3 connection for other FileTransferSession Activities.
FileTransferSessionUploadUploads a file within the current file transfer session.
FileTransferSessionDownloadDownloads a file within the current file transfer session
FileTransferSessionDeleteDeletes a file within the current transfer session.
FileTransferSessionRenameRenames a file within the current transfer session.
FileTransferSessionChangeDirectoryChanges the working directory in the current file transfer session.
FileTransferSessionGetCurrentDirectoryGets the working directory in the current file transfer session.
FileTransferSessionGetFileListGets the listing of files in a directory for the current file transfer session.
FileTransferSessionGetFileCreationDateGets the files creation date for the current file transfer session.
FileTransferSessionGetFileLengthGets the files size for the current file transfer session.
FileTransferSessionSendCommandSends a command during the current file transfer session.

Mail Server Session Grouping

EWSSessionCreates an EWS Session that hosts a mail server connection. When using Microsoft Office 365 Modern Authentication, specify the EWS Connection Store object in the JAMSConnection field. The Connection should have the ClientId, TenantId, and ClientSecret. To specify the email address, add it to a Credential and select it in the JAMSUsername field or enter it in the Username field.

Note: To use this updated EWSSession activity with Modern Authentication, update your JAMS Client and JAMS Scheduler.
IMAPSessionCreates an IMAP Session that host a mail server connection.
POPSessionCreates an POP Session that host a mail server connection.
GraphAPISessionCreates a GraphAPI Session that hosts a mail server connection. Enter the GraphAPI Connection Store object in the JAMSConnection field and the JAMS Server. If you enter a MailServer and Port, they override the values in the GraphAPI Connection Store. Use the GraphAPISession activity as the main container to drag-and-drop in other activities. The other Mail Server Session activities will inherit the mail server information from this container.
DeleteMailMessageDeletes a mail message on a mail server with a corresponding header.
GetMailHeaderListGets a collection of mail headers on a mail server that matches the specified mask. The returned collection is a list of JAMSMailMessageInfo objects.
GetMailMessageGets a JAMSMailMessage object for the specified header on a mail server.
GetMailServerFolderGets the current folder on a mail server.
ProcessEmailsLooks for one or more emails matching a specified mask and invokes the body Activity for all matching email.
SaveMessageAttachmentsSaves attachments on a mail message to the file system.
SetMailServerFolderSets the current folder on the mail server.
ForEachMailMessageLooks for one or email messages matching a mail specification and invokes the body Activity once for each matching message.
ForEachAttachmentLooks for one or more mail messages matching a mail specification, then downloads the attachments to the specified working directory and invokes the body Activity for each matching file.

Coordinators Grouping

ClearEventSets the specified event to false.
SetEventSets the event time.
WaitforEventWaits for the specified event to be set by a SetEvent Activity. If the event has already been set, the WaitForEvent Activity completes immediately.

Control Flow Grouping

DoWhileExecutes the Activity contained in its body at least once until a specified condition evaluates to false.
ForEach<T>Executes an Activity action once for each value provided in the values collection.
IfProvides a conditional if-then-else condition.
ParallelIs a container object that executes multiple child Activities at the same time. This class cannot be inherited.
ParallelForEach<T>Enumerates a collection and executes an Activity for each element of the collection in parallel.
PickContains a collection of PickBranch Activities where each PickBranch is a pairing between a Trigger and an Action Activity. At execution time the triggers for all branches are executed in parallel. When one trigger completes its corresponding action is executed and all other triggers are canceled.
PickBranchEach PickBranch is contained within a branch of the Pick Activity and can be executed based on an incoming event that serves as a trigger.
SequenceIs a container object that executes Activities one after another. Sequences can incorporate more than one child Activity. Sequences can only execute forward, not backward.
Switch<T>Evaluates a specified expression and executes using a collection of Activities whose associated key matches the value obtained from the evaluation.

Flowchart Grouping

FlowchartIs a container object that executes multiple child activities one after another. Similar to a Sequence, a Flowchart is more flexible allowing control to return to an earlier step. Sequences can only execute forward, not backward.
FlowDecisionIs a conditional node that provides a branch for the flow of control into one of two alternatives based on whether a specified condition is satisfied. If the flow requires more than two branches, use FlowSwitch instead.
FlowSwitch<T>Is a conditional node that provides branching for the flow of control based on matching criterion when more than two alternative branches are required. If the flow branching requires only two paths, use the FlowDecision activity instead.

Messaging Grouping

CorrelationScopeProvides implicit CorrelationHandle management for child messaging Activities.
InitializeCorrelationInitializes correlation without sending or receiving a message.
ReceiveReceives a message.
ReceiveAndSendReplyReceives a message as part of a request/reply message exchange pattern.
SendSends a message to a service.
SendAndReceiveReplySends a message as part of a request/reply message exchange pattern.
TransactedReceiveScopeScopes the lifetime of a transaction which is initiated by a received message. The transaction may be flowed into the workflow on the initiating message or created by the dispatcher when the message is received.

RunTime Grouping

PersistSaves a workflow to disk, if possible. This Activity cannot be executed in a non-persistence zone, for example, within a TransactionScope Activity.
TerminateWorkflowTerminates the execution of a workflow.

Primitives Grouping

AssignAssigns a value to a variable at the current scope.
DelayPuts one path of execution into an idle state, possibly allowing the workflow to be unloaded.
InvokeMethodExecutes a public method of a CLR object.
WriteLineWrites a specified string to the console or a specified TextWriter object.

Transactions Grouping

CancellationScopeSpecifies an Activity for execution and cancellation logic for that Activity.
CompensableActvitySupports compensation of its child activities.
CompensateUsed to explicitly invoke the compensation handler of a CompensableActivity.
ConfirmInvokes the confirmation handler of a CompensableActivity.
TransactionScopeDemarcates a transaction boundary.

Collection Grouping

AddtoCollection<T>Adds an item to a specified collection.
ClearCollection<T>Clears a specified collection of all items.
ExistsInCollection<T>Determines whether a specified item exists in a particular collection.
RemoveFromCollection<T>Removes an item from a specified collection.

Error Handling Grouping

RethrowThrows a previously thrown exception. This Activity can only be used in a Catch handler in the TryCatch Activity.
ThrowThrows an exception
TryCatchContains Activities to be executed by the workflow runtime in an exception handling block.

SYM (Symitar) Grouping

DataFiletoPCFTP download from the “DATAFILES” folder on the Symitar server.
DeleteLetterFileRemoves a letter file from the “LETTERSPECS” folder on the Symitar server.
EmailReportsAttaches one or more reports to an email message and sends it to the designated recipient(s).
FiletoPCGenerates an FTP download from any Symitar directory to a local PC.
LetterFiletoPCFTP download from the “LETTERSPECS” folder on the Symitar server.
PCToDataFileFTP upload to the “DATAFILES” folder on the Symitar server.
PCToEditFileInitiates an FTP from a PC to the Symitar edit file.
PCToFileCreates a generic upload to any directory on the Symitar system.
PCToLetterFileFTP upload to the “LETTERSPECS” folder on the Symitar server.
ReportsFileToPCFTP download from the “REPORT” folder on the Symitar server.
RunJobFileRuns a job file in the specified SYM, such as Sym222.
SymConfigThe parent activity that allows users to set the configuration settings, such as Server Name, SymUserId, Symitar logon credentials, for all Symitar activities contained within it. Each child activity can override the settings in the SymConfig.