Skip to main content

Concepts

This page goes through various concepts that needed to be understood before using the Realtask.

Connection​

A Connection captures details necessary to connect to an external system. There are many types of connections. For example, Sfdc (for Salesforce) or S3 (Aws S3 storage) or Google (for Google Sheet or Google Drive) etc.,

Users can create one or more connections and use them in Jobs/Tasks. When a new connection is created, by default it can only be used by user created it (or admins) but Connection can be shared with other users.

Job​

Job is an entity which models the work that needs to be done. It consists of one or more Tasks. Job can be scheduled using various supported methods and when run all active tasks part of the Job are executed in the defined order.

There are some settings which are defined at Job level and are inherited by all Tasks and there are some which can be overridden at Task level.

Task​

Task is the unit of work can be done in the system. Each Task has type which identifies type of task. Each Task type allows different set of properties that can be configured. If a Task needs a connection to perform its work, it can be configured with one, or more so usually uses the Job level connections.

Some tasks are,

  • Sfdc Export
  • Sfdc Insert
  • Sfdc Update
  • Sfdc Dml Update
  • Sfdc Apex Script
  • Sfdc Rest Api
  • Params
  • ...

Environment​

Environment models the various deployment environments in your company. Each Job belongs to one and only Environment. Think of these as your dev or prd Environments. These are managed by Admins and can be used by all users.

Frequency​

Frequency is an interval at which Job needs to be run.

  • Manual: Job is executed (Run) only when manually triggered

  • Various other pre-defined repeat frequencies

    • Every Minute
    • Every Hour
    • ...

  • Cron: Specify cron expression which dictates the repeat Frequencies

Scheduling​

Scheduling is the process of defining when a Job needs to be executed. Job can be scheduled to run at a particular time using Frequency. Job is automatically scheduled if Frequency is anything but 'Manual' and Job is active.

Entity Status​

All entities (Job or Task or Connection) has status associated with it. If status is 'Active', then Job/Task/Connection is eligible to be executed. When Job/Task is deleted, they will be marked with Entity status as Deleted and are available to be undeleted upto 30 days, after which they will be purged from the system.

Run​

Each time Job is executed, a record is created in the system to capture information associated with that execution. This record is called Job Run or Run. Each job can have zero or more Runs associated with it. Each time system run a Job, it adds that to Run History.

Run Stats​

At the end of the Run, we summarize the execution status and that summary is captured as part of Run Stats of that Job. This Run Status is shown as graph in Job overview tab.

Formula​

Realtask allows users to configure the system to adopt to their needs via low-code programming environment. The engine that facilitates this is Formula Engine and low-code that you write is called Formula. In a Formula you use mix of constants, dynamic variables and functions. Realtask provides a lot of functions to achieve the result you're looking for.

Formula Template​

Formula Template is variation of Formula where default you write text and dynamic low-code parts are written inside ${ and } tags.