Skip to content

Commit 38dc3ac

Browse files
authored
Merge pull request #108418 from ecfan/sliding-window
Add days, weeks, and months for Sliding Window
2 parents 9ad5c12 + 66c6605 commit 38dc3ac

11 files changed

+17
-18
lines changed

articles/connectors/connectors-native-recurrence.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: logic-apps
55
ms.suite: integration
66
ms.reviewer: deli, klam, logicappspm
77
ms.topic: conceptual
8-
ms.date: 05/25/2019
8+
ms.date: 03/25/2020
99
---
1010

1111
# Create, schedule, and run recurring tasks and workflows with the Recurrence trigger in Azure Logic Apps
@@ -50,7 +50,7 @@ For differences between this trigger and the Sliding Window trigger or for more
5050

5151
| Property | JSON name | Required | Type | Description |
5252
|----------|-----------|----------|------|-------------|
53-
| **Interval** | `interval` | Yes | Integer | A positive integer that describes how often the workflow runs based on the frequency. Here are the minimum and maximum intervals: <p>- Month: 1-16 months </br>- Day: 1-500 days </br>- Hour: 1-12,000 hours </br>- Minute: 1-72,000 minutes </br>- Second: 1-9,999,999 seconds<p>For example, if the interval is 6, and the frequency is "Month", then the recurrence is every 6 months. |
53+
| **Interval** | `interval` | Yes | Integer | A positive integer that describes how often the workflow runs based on the frequency. Here are the minimum and maximum intervals: <p>- Month: 1-16 months <br>- Week: 1-71 weeks <br>- Day: 1-500 days <br>- Hour: 1-12,000 hours <br>- Minute: 1-72,000 minutes <br>- Second: 1-9,999,999 seconds<p>For example, if the interval is 6, and the frequency is "Month", then the recurrence is every 6 months. |
5454
| **Frequency** | `frequency` | Yes | String | The unit of time for the recurrence: **Second**, **Minute**, **Hour**, **Day**, **Week**, or **Month** |
5555
||||||
5656

@@ -75,17 +75,17 @@ For differences between this trigger and the Sliding Window trigger or for more
7575
| Property | JSON name | Required | Type | Description |
7676
|----------|-----------|----------|------|-------------|
7777
| **Time zone** | `timeZone` | No | String | Applies only when you specify a start time because this trigger doesn't accept [UTC offset](https://en.wikipedia.org/wiki/UTC_offset). Select the time zone that you want to apply. |
78-
| **Start time** | `startTime` | No | String | Provide a start date and time in this format: <p>YYYY-MM-DDThh:mm:ss if you select a time zone <p>-or- <p>YYYY-MM-DDThh:mm:ssZ if you don't select a time zone <p>So for example, if you want September 18, 2017 at 2:00 PM, then specify "2017-09-18T14:00:00" and select a time zone such as Pacific Standard Time. Or, specify "2017-09-18T14:00:00Z" without a time zone. <p>**Note:** This start time has a maximum of 49 years in the future and must follow the [ISO 8601 date time specification](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) in [UTC date time format](https://en.wikipedia.org/wiki/Coordinated_Universal_Time), but without a [UTC offset](https://en.wikipedia.org/wiki/UTC_offset). If you don't select a time zone, you must add the letter "Z" at the end without any spaces. This "Z" refers to the equivalent [nautical time](https://en.wikipedia.org/wiki/Nautical_time). <p>For simple schedules, the start time is the first occurrence, while for complex schedules, the trigger doesn't fire any sooner than the start time. [*What are the ways that I can use the start date and time?*](../logic-apps/concepts-schedule-automated-recurring-tasks-workflows.md#start-time) |
78+
| **Start time** | `startTime` | No | String | Provide a start date and time in this format: <p>YYYY-MM-DDThh:mm:ss if you select a time zone <p>-or- <p>YYYY-MM-DDThh:mm:ssZ if you don't select a time zone <p>So for example, if you want September 18, 2020 at 2:00 PM, then specify "2020-09-18T14:00:00" and select a time zone such as Pacific Standard Time. Or, specify "2020-09-18T14:00:00Z" without a time zone. <p>**Note:** This start time has a maximum of 49 years in the future and must follow the [ISO 8601 date time specification](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) in [UTC date time format](https://en.wikipedia.org/wiki/Coordinated_Universal_Time), but without a [UTC offset](https://en.wikipedia.org/wiki/UTC_offset). If you don't select a time zone, you must add the letter "Z" at the end without any spaces. This "Z" refers to the equivalent [nautical time](https://en.wikipedia.org/wiki/Nautical_time). <p>For simple schedules, the start time is the first occurrence, while for complex schedules, the trigger doesn't fire any sooner than the start time. [*What are the ways that I can use the start date and time?*](../logic-apps/concepts-schedule-automated-recurring-tasks-workflows.md#start-time) |
7979
| **On these days** | `weekDays` | No | String or string array | If you select "Week", you can select one or more days when you want to run the workflow: **Monday**, **Tuesday**, **Wednesday**, **Thursday**, **Friday**, **Saturday**, and **Sunday** |
8080
| **At these hours** | `hours` | No | Integer or integer array | If you select "Day" or "Week", you can select one or more integers from 0 to 23 as the hours of the day for when you want to run the workflow. <p><p>For example, if you specify "10", "12" and "14", you get 10 AM, 12 PM, and 2 PM for the hours of the day, but the minutes of the day are calculated based on when the recurrence starts. To set specific minutes of the day, for example, 10:00 AM, 12:00 PM, and 2:00 PM, specify those values by using the **At these minutes** property. |
8181
| **At these minutes** | `minutes` | No | Integer or integer array | If you select "Day" or "Week", you can select one or more integers from 0 to 59 as the minutes of the hour when you want to run the workflow. <p>For example, you can specify "30" as the minute mark and using the previous example for hours of the day, you get 10:30 AM, 12:30 PM, and 2:30 PM. |
8282
|||||
8383

84-
For example, suppose that today is Monday, September 4, 2017. The following Recurrence trigger doesn't fire *any sooner* than the start date and time, which is Monday, September 18, 2017 at 8:00 AM PST. However, the recurrence schedule is set for 10:30 AM, 12:30 PM, and 2:30 PM on Mondays only. So the first time that the trigger fires and creates a logic app workflow instance is at 10:30 AM. To learn more about how start times work, see these [start time examples](../logic-apps/concepts-schedule-automated-recurring-tasks-workflows.md#start-time).
84+
For example, suppose that today is Friday, September 4, 2020. The following Recurrence trigger doesn't fire *any sooner* than the start date and time, which is Friday, September 18, 2020 at 8:00 AM PST. However, the recurrence schedule is set for 10:30 AM, 12:30 PM, and 2:30 PM on Mondays only. So the first time that the trigger fires and creates a logic app workflow instance is on Monday at 10:30 AM. To learn more about how start times work, see these [start time examples](../logic-apps/concepts-schedule-automated-recurring-tasks-workflows.md#start-time).
8585

8686
Future runs happen at 12:30 PM and 2:30 PM on the same day. Each recurrence creates their own workflow instance. After that, the entire schedule repeats all over again next Monday. [*What are some other example occurrences?*](../logic-apps/concepts-schedule-automated-recurring-tasks-workflows.md#example-recurrences)
8787

88-
![Advanced scheduling example](./media/connectors-native-recurrence/recurrence-trigger-more-options-advanced-schedule.png)
88+
![Advanced scheduling example](./media/connectors-native-recurrence/recurrence-trigger-advanced-schedule-options.png)
8989

9090
> [!NOTE]
9191
> The trigger shows a preview for your specified recurrence only when you select "Day" or "Week" as the frequency.
@@ -118,7 +118,7 @@ This example shows how a Recurrence trigger definition might look in an underlyi
118118
"Monday"
119119
]
120120
},
121-
"startTime": "2017-09-07T14:00:00Z",
121+
"startTime": "2020-09-07T14:00:00Z",
122122
"timeZone": "Pacific Standard Time"
123123
}
124124
}

articles/connectors/connectors-native-sliding-window.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: logic-apps
55
ms.suite: integration
66
ms.reviewer: deli, klam, logicappspm
77
ms.topic: conceptual
8-
ms.date: 05/25/2019
8+
ms.date: 03/25/2020
99
---
1010

1111
# Schedule and run tasks for contiguous data by using the Sliding Window trigger in Azure Logic Apps
@@ -14,9 +14,9 @@ To regularly run tasks, processes, or jobs that must handle data in contiguous c
1414

1515
Here are some patterns that this trigger supports:
1616

17-
* Run immediately and repeat every *n* number of seconds, minutes, or hours.
17+
* Run immediately and repeat every *n* number of seconds, minutes, hours, days, weeks, or months.
1818

19-
* Start at a specific date and time, then run and repeat every *n* number of seconds, minutes, or hours. With this trigger, you can specify a start time in the past, which runs all past recurrences.
19+
* Start at a specific date and time, then run and repeat every *n* number of seconds, minutes, hours, days, weeks, or months. With this trigger, you can specify a start time in the past, which runs all past recurrences.
2020

2121
* Delay each recurrence for a specific duration before running.
2222

@@ -36,24 +36,23 @@ For differences between this trigger and the Recurrence trigger or for more info
3636

3737
1. Sign in to the [Azure portal](https://portal.azure.com). Create a blank logic app.
3838

39-
1. After Logic App Designer appears, in the search box, enter "sliding window" as your filter. From the triggers list, select this trigger as the first step in your logic app workflow: **Sliding Window**
39+
1. After the Logic App Designer appears, in the search box, enter `sliding window` as your filter. From the triggers list, select the **Sliding Window** trigger as the first step in your logic app workflow.
4040

4141
![Select "Sliding Window" trigger](./media/connectors-native-sliding-window/add-sliding-window-trigger.png)
4242

4343
1. Set the interval and frequency for the recurrence. In this example, set these properties to run your workflow every week.
4444

4545
![Set interval and frequency](./media/connectors-native-sliding-window/sliding-window-trigger-details.png)
4646

47-
| Property | Required | JSON name | Type | Description |
47+
| Property | JSON name | Required | Type | Description |
4848
|----------|----------|-----------|------|-------------|
49-
| **Interval** | Yes | interval | Integer | A positive integer that describes how often the workflow runs based on the frequency. Here are the minimum and maximum intervals: <p>- Hour: 1-12,000 hours </br>- Minute: 1-72,000 minutes </br>- Second: 1-9,999,999 seconds<p>For example, if the interval is 6, and the frequency is "Hour", then the recurrence is every 6 hours. |
50-
| **Frequency** | Yes | frequency | String | The unit of time for the recurrence: **Second**, **Minute**, or **Hour** |
49+
| **Interval** | `interval` | Yes | Integer | A positive integer that describes how often the workflow runs based on the frequency. Here are the minimum and maximum intervals: <p>- Month: 1-16 months <br>- Week: 1-71 weeks <br>- Day: 1-500 days <br>- Hour: 1-12,000 hours <br>- Minute: 1-72,000 minutes <br>- Second: 1-9,999,999 seconds <p>For example, if the interval is 6, and the frequency is "Month", then the recurrence is every 6 months. |
50+
| **Frequency** | `frequency` | Yes | String | The unit of time for the recurrence: **Second**, **Minute**, **Hour**, **Day**, **Week**, or **Month** |
5151
||||||
5252

5353
![Advanced recurrence options](./media/connectors-native-sliding-window/sliding-window-trigger-more-options-details.png)
5454

55-
For more recurrence options, open the **Add new parameter** list.
56-
Any options that you select appear on the trigger after selection.
55+
For more recurrence options, open the **Add new parameter** list. Any options that you select appear on the trigger after selection.
5756

5857
| Property | Required | JSON name | Type | Description |
5958
|----------|----------|-----------|------|-------------|
18.9 KB
Loading
21.6 KB
Loading
3.11 KB
Loading
2.23 KB
Loading
18.9 KB
Loading
5.92 KB
Loading
2.47 KB
Loading

0 commit comments

Comments
 (0)