Start processing a job with a trigger

Overview

In this article, we describe in short how to trigger your import or export jobs with DataBridge. A more detailed article can be found here.

The work will be done according to the profile configuration when a request is made to a specific secret URL.

There are 2 options that you need to enable separately with the toggle button:

1. Triggered jobs, allows you to create and run a triggered job in a background process by calling a URL. This is a long-running process and the execution is the same as with SCHEDULED jobs. Calling a triggered job is limited to once per 5 minutes (used to be 15) on each profile, more calls to the same trigger URL will fail; this fair use policy is maintained to keep the load on DataBridge and SuperOffice CRM Online acceptable.
2. Instant jobs, allows you to create and run an instant job directly in the browser by calling a URL with parameters. Because the work is done directly in the browser request, this is only suitable for limited work; for example, if you just want to export a single record to a file for further processing. Please carefully read the information below if you want to use this advanced functionality.

How to

• Log into DataBridge
• Click Manage Profile > Profile Settings
• Select the scheduling method Triggered

• When you select the TRIGGERED scheduling method you will be presented with the following options:

  • Triggered jobs enabled: switch to ‘Yes’ in order to create and run a triggered job in a background process by calling a URL.
  • Instant jobs enabled: switch to ‘Yes’ in order to create and run an instant job directly in the browser by calling a URL with parameters.
  • Secret access key: this key is similar to what is called an API key. Together with the profile ID, this acts as username and password for the webhook. In case you need to renew it press the GENERATE button and SAVE at the bottom of the page.