Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To successfully create scheduled tasks, you need to associate the corresponding a query api authentication tokens for the recipients you want to specifytoken corresponding to your own user. If you need help with authentications tokens, visit this article.

...

356
1

Name: give the task a meaningful name that helps you identify its purpose.

30_Scheduled tasks.pngImage Removed
2

Token: you need to include a valid query api authentication token for the intended recipients. Visit this article to get help finding them or creating them.

30_Scheduled tasksV2.pngImage Added
2

Repeats: select the desired periodicity from the dropdown.

  • Daily: if you select this option, you must select the time of the day. The time of the day can also be written using the 24h-format (hh:mm).

  • Weekly: if you select this option, you must select the day(s) of the week and the time of the day.

  • Monthly: if you select this option, you must select the day(s) of the month and the time of the day.

  • Yearly: if you select this option, you must select the month(s) of the years, the day(s) of the month, and the time of the day.

43

Sending to: introduce the email address(es) of the users you want to receive the query result.

Info

Character limit: the length of this field cannot exceed 256 characters.

4

Subject: indicate the content of the subject displayed on the emails received from this scheduled task.

Info

Character limit: the length of this field cannot exceed 140 characters.

5

Query time period: indicate the time range for the data examined by the query. You can either select time presets or specify a custom period. If you select custom, you need to specify the start and end dates using relative dates (more info about relative dates here).

76

Query expression: insert a valid query to return the desired data and create the report that will be sent. The query must be written in LINQ, using the syntax recognized by the APIs. This article will help you with the basics for constructing a query using LINQ, and you may find this article useful to adapt your query to the API standards.

Info

Character limit: the length of this field cannot exceed 249k characters.

Activating scheduled tasks

Once you've scheduled a task, remember to activate it. Failure to do so will prevent its execution and consequently, the result won't be sent. To active it, use the toggle in the Active column of the list.

...

Info

10 20 active tasks per domain

Attempting to enable a task the exceeds this limit will not be successful, and you will receive a notification informing you about it. If you need to expand this limit, contact us in our support site.

Receiving scheduled task results

When a scheduled task is activated, it will be executed at the designated time and periodicity (check the Next execution column for the upcoming launch). Upon completion, the indicated email address(es) will receive an email with the result.

In this email you can find attached a CSV with the data for the specified query and time range.

...

Managing scheduled tasks

Filtering scheduled tasks

...