Triggers

By default, adding a trigger will set the schedule to 15 minutes.

Check our pages dedicated to Scheduling and Triggering flows.

States

A state is an object stored as a resource of the resource type state which is meant to persist across distinct executions of the same script.

Schedules

Scheduling allows you to define schedules for Scripts and Flows, automatically running them at set frequencies.

For loops

Iterate a series of tasks.

Think of this as someone who checks the mailbox every day. If there is a new letter, they will continue to process it - open and read it - and if there is no new letter, they won’t do anything.The key part is that opened letters are not placed back in the mailbox. In getOperate, a Trigger Script has the job to keep track of what’s processed and what’s not.

Flows can be scheduled through the Flow UI using a CRON expression and then activating the schedule as seen in the image below. Example of a trigger script watching new Slack posts with a given word in a given channel and the flow sending each of them by email in a for loop:

This flow can be found on getOperate Hub.

Examples of trigger scripts include:

The following TypeScript code is an example of the first module of a Flow that checks for new documents in a MongoDB collection on a regular schedule. In this case we query documents that were created after a specific time, expressed with a timestamp. The timestamp is stored with the help of getOperate’s built-in state functions and is updated in each run.

Code below:

import { getState, type Resource, setState } from 'https://deno.land/x/getOperate/mod.ts';
import { MongoClient, ObjectId } from 'https://deno.land/x/atlas_sdk/mod.ts';

type MongodbRest = {
	endpoint: string;
	api_key: string;
};

export async function main(
	auth: MongodbRest,
	data_source: string,
	database: string,
	collection: string
) {
	const client = new MongoClient({
		endpoint: auth.endpoint,
		dataSource: data_source,
		auth: { apiKey: auth.api_key }
	});
	const documents = client.database(database).collection(collection);
	const lastCheck = (await getState()) || 0;
	await setState(Date.now() / 1000);
	const id = ObjectId.createFromTime(lastCheck);
	return await documents.find({ _id: { $gt: id } });
}

You can find this exact Trigger Script on getOperate Hub, or many more examples here.

Introduction

Worksflows

Developer

States

Schedules

For loops