You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/docs/schedules.md
+20-10Lines changed: 20 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,29 +40,31 @@ If you are planning to schedule an actor run, you need to use the actor before y
40
40
41
41
In [Apify Console](https://console.apify.com/schedules), click on the **Schedules** button in the left-side menu, then click the **Create new** button.
42
42
43
-
In the **Settings** tab, give your schedule a memorable name, add a description, and choose how often you would like your actor or task to run using the **Cron expression** field.
43
+
In the **Settings** tab, give your schedule a memorable name, add a description, and choose how often you would like your actor or task to run using the [schedule setup tool](#schedule-setup).
Next, you'll need to give the schedule something to run. This is where the actor or task you prepared earlier comes in. Switch to the **Actors** or **Tasks** tab, as appropriate, and click the **Add actor/task button**.
47
+
Next, you'll need to give the schedule something to run. This is where the actor or task you prepared earlier comes in. Switch to the **Actors and Tasks** tab, and click the **Add [new]** button.
48
48
49
49
If you're scheduling an actor run, you'll be able to specify the actor's [input]({{@link actors/running/input.md}}) and running options like
The **timeout** value is specified in seconds; a value of **0** means there is no timeout and the actor runs until it finishes.
54
54
55
+
If you don't provide an input, then the actor's default input is used. If you provide an input with some fields missing, the missing fields are filled in with values from the default input. If input options are not provided, the default options values are used.
56
+
55
57

56
58
57
-
If you're scheduling a task, just select the task you prepared earlier from the **Task** dropdown. If you need to override the task's input, you can pass it as a JSON object in the **Input JSON overrides** field.
59
+
If you're scheduling a task, just select the task you prepared earlier using the drop-down. If you need to override the task's input, you can pass it as a JSON object in the **Input JSON overrides** field.
58
60
59
61

60
62
61
63
To add more actors or tasks, just repeat the process.
62
64
63
65
> You can add a maximum of 10 actors and 10 tasks to each schedule.
64
66
65
-
Now, all you need to do is click **Save** and wait for your scheduled actors/tasks to run and return your data.
67
+
Now, all you need to do is click **Save & activate** and let the scheduler take care of running your jobs on time.
66
68
67
69
For integrations, you can also add a [webhook](https://docs.apify.com/webhooks) to your tasks, which will notify you (or perform an action of your choice) every time the task runs.
68
70
@@ -103,9 +105,19 @@ You can add multiple actor and task runs to a schedule with a single POST reques
103
105
104
106
For more information, see the [schedules section](https://docs.apify.com/api/v2#/reference/schedules/schedule-object/get-schedule) in the API documentation.
105
107
108
+
## Schedule setup
109
+
110
+
The schedule setup tool uses [cron expressions](https://en.wikipedia.org/wiki/Cron#CRON_expression) to specify run times. If you're familiar with how to use them and need a specific run schedule, you can dive right in. If not, don't worry - the setup tool has a visual custom schedule builder that provides a similar level of control as cron expressions, though it's not quite as powerful.
The **Next runs** section at the bottom shows when the next five runs will be. You can use this live feedback to experiment until you find the correct configuration.
115
+
116
+
You can find more information and examples of cron expressions on [crontab.guru](http://crontab.guru/). For additional and non-standard characters, see [this](https://en.wikipedia.org/wiki/Cron#CRON_expression) Wikipedia article.
117
+
106
118
## Cron expressions
107
119
108
-
Schedules use [cron expressions](https://en.wikipedia.org/wiki/Cron#CRON_expression) to specify run times. A cron expression has the following structure:
120
+
A cron expression has the following structure:
109
121
110
122
| Position | Field | Values | Wildcards | Optional |
@@ -135,8 +147,6 @@ Additionally, you can use the following shortcut expressions:
135
147
-`@daily` = `0 0 * * *` - run once a day, at midnight.
136
148
-`@hourly` = `0 * * * *` - on the hour, every hour.
137
149
138
-
You can find more information and examples of cron expressions on [crontab.guru](http://crontab.guru/). For additional and non-standard characters, see [this](https://en.wikipedia.org/wiki/Cron#CRON_expression) Wikipedia article.
139
-
140
150
## Sharing
141
151
142
152
You can invite other Apify users to view or modify your schedules using the [access rights]({{@link access_rights.md}}) system. See the [full list of permissions]({{@link access_rights/list_of_permissions.md#schedules}}).
0 commit comments