Action

In Foresight, an action is a real work unit in G Suite. For example, email someone, move a file to a folder in Google Drive, rename a Google Doc - you name it.

A list of supported actions can be found in Foresight Action List.

Global Variables

Global variables are a special type of variables that exist throughout the rule regardless of your automation rule setup. These variables come with the format of {{ variableName_global }}.

Such global variables may include the current time, the day of week, the hour of day etc.

Organizational Unit Path

An organizational unit path is a different representation of a given organizational unit (OU) in G Suite using the forward slash symbol / as the separator. The leading / is equivalent to your root OU, so in organizational unit path, the root OU name is unnecessary.

For example, an OU My Company > Sales > North America Sales is written as /Sales/North America Sales. The root OU My Company is written as /.

Rule

A rule is a configured automated program that will self-execute upon triggering events. A rule has 2 states, ON and OFF. When a rule is OFF, the rule will never execute. If a rule is ON, the rule stays still, waiting for events to pull the trigger.

A rule consists of one trigger and one or more actions. The automation starts when an events trigger the rule. The automation may succeed or fail due to varieties of reasons.

Rule Log

A rule log is a history record for your rule. It's like your assistant reports what they have done for your requests ("Your majesty, I followed your instructions step by step and made the following changes").

Runtime

Runtime is the period of time when an automation rule is running. It begins when a rule is triggered and ends with the automation is quit or closed.

Trigger

A trigger is essentially a resource update event in G Suite. For example, a user is created in G Suite, a response is submitted in Google Forms, a row is deleted in Google Sheets - you name it.

Some triggers are instant. Google notifies Foresight about the resource change so Foresight immediately triggers the rule.

Other triggers are not instant. As Google doesn't tell Foresight for the resource update, Foresight has to periodically check in with Google ("hey dude, any updates?").

A list of supported triggers can be found in Foresight Trigger List.

Variable

A variable in Foresight is a placeholder that would be populated with real time data at rule execution. It always comes with a form of {{ VARIABLE_NAME_xxxxxx }}, the variable name with 6 random text enclosed by a pair of double braces.

Variables are contextual and used in Actions. The variables available for current step / action depend on the last step. In another words, the last step determines and feeds what data is available for my step. For example, {{ firstName_9f48a1 }} is likely a person's first name, who did something in last step.

To use a variable, type {{ and select a variable from the popped menu. Commonly, variables have a short name, a longer description and an optional example.