Date Rule Properties
The Date Rule Properties window allows you to edit a date rule for an Execution Schedule within a Schedule Trigger. Options allow you to specify specific dates or rules that will determine the dates when a job will run.
Optional name for this selection
Optionally, specify a name for this selection to help identify it in lists.
Enabled
Check to enable this rule. If the box is unchecked, the rule is disabled and will be ignored by adTempus when scheduling jobs.
Months
Unless you are using the Easter option, you must select the month(s) in which the job should run.
Trigger On
Select the type of rule you want to use.
Selected days of month
Select this option to execute jobs on specific days of the month. The job will execute on the day(s) you select in each of the months you have selected in the Months list.
If days you select fall after the last day of a month, the job will execute on the last day. For example, if you have selected all of the months in the months list, and have specified "30" as the day on which to execute, the job will execute on the last day of February (28th or 29th), and on the 30th of the other months.
Selected days of week
The job will be executed on the days of the week you specify, in each of the months you have selected in the Months list.
The holiday settings for the Schedule Trigger determine which days, if any, are treated as holidays.
Use the Recur every x weeks option to run the job less frequently than every week. Specify 1 to run every week, 2 to run every other week, etc. This recurrence can be relative to the Active Range start date specified for the schedule, the beginning of the year, or the beginning of each selected month.
If you select more than one weekday, the job will trigger on each selected day. See Selecting Days of the Week below for more information.
Days specified using a floating rule
This option allows you to build complex rules to specify the date. This allows you to accommodate scenarios such as:
- The first business day of each month
- The third Tuesday of each month
- The day after the last business day of each month
- The Tuesday after the fourth Sunday of March
- The nearest business day to Christmas
To define your date:
-
Decide whether your floating date can be specified relative to the beginning of the month (as in the first four examples listed above) or must be specified relative to some specific or floating date (as in the Christmas example above).
- If the date is relative to the beginning of the month, select the "relative to the beginning of the month" option.
- If the date is relative to another date, select the "relative to a specific day..." option, then click the Select... button. This will display a new Date Rule Properties window, where you may use any of the available options to define your starting date.
-
Once you have decided on a starting point, decide which days of the week should serve as the basis for your rule, and select them.
If you select more than one day, the job will trigger only on the first day that meets the other criteria. See Selecting Days of the Week below.
- Then select the occurrence (1st, 2nd, 3rd, etc.) of that day within the month.
- Finally, you may specify a number of days before or after the selected date (enter "0" to use the selected date itself).
Days specified relative to end of month
Use this option to run the job on the last day of each month, or a certain number of days before or after the last day.
Days specified relative to Easter
Use this option to run this job on Easter, or a specified number of days before or after Easter. adTempus calculates the date for Easter each year and runs the job accordingly.
Selecting Days of the Week
The "Selected days of week" and "Days specified using a floating rule" rules both allow you to select one or more days of the week when jobs should trigger. However, these two rules behave differently when you select more than one day.
Selected days of week
When the rule is "Selected days of the week," the job is triggered on each weekday that you select. For example, if you configure the rule to "Recur every 2 months relative to Beginning of month" and select "Tuesday" and "Wednesday," the job will trigger every other Tuesday and every other Wednesday. For February 2013, the job will trigger on February 5 and February 6:
February 2013 | ||||||
Su | Mo | Tu | We | Th | Fr | Sa |
1 | 2 | |||||
3 | 4 |
5 |
6 |
7 | 8 | 9 |
10 | 11 | 12 | 13 | 14 | 15 | 16 |
17 | 18 | 19 | 20 | 21 | 22 | 23 |
24 | 25 | 26 | 27 | 28 |
Days specified using a floating rule
When the rule is "Days specified using a floating rule," the job is triggered for only the first date that matches the criteria. For example, if you configure the rule to trigger on the first occurrence of the month and select "Tuesday" and "Wednesday," the job will trigger on the first day of the month that is either a Tuesday or a Wednesday. For February 2013, this is February 5:
February 2013 | ||||||
Su | Mo | Tu | We | Th | Fr | Sa |
1 | 2 | |||||
3 | 4 |
5 |
6 | 7 | 8 | 9 |
10 | 11 | 12 | 13 | 14 | 15 | 16 |
17 | 18 | 19 | 20 | 21 | 22 | 23 |
24 | 25 | 26 | 27 | 28 |
The job will not trigger on February 6.
Matching Weekdays, Business Days, Weekends, Holidays for Floating Day Rules
In adTempus 3 and earlier, there were pseudo-days that matched based on weekdays, business days, weekends, holidays, etc. These have been remove starting with adTempus 4 in favor of selecting the days that you want, in order to provide greater flexibility. For example, in earlier versions you could configure a schedule for the "3rd business day," which worked fine as long as your "business days" are Monday through Friday. If your business days are Sunday through Thursday, there was no way to make a rule for that. Starting with adTempus 4, you can. The following table shows the settings that should be used to match the old options.
If you use a setting like "Any Weekday" frequently, you should set up a Shared Schedule configured with the appropriate settings and then reference it from your schedules, so that you don't have to configure the options each time you create a new schedule.
Version 3 Setting | Version 4 Settings | Notes |
---|---|---|
Any Weekday | Check the boxes for the days that are "weekdays" (working days), e.g., Monday through Friday. | |
Any Weekend Day | Check the boxes for the days that are weekend days (non-working days), e.g., Saturday and Sunday. | |
Any Business Day | Check the boxes for the days that are "weekdays" (working days), e.g., Monday through Friday. Also check the Exclude Holidays box. | The Schedule Trigger must be configured with the appropriate holiday settings; see below. |
Any Non-Business Day | Check the boxes for the days that are weekend days (non-working days), e.g., Saturday and Sunday. Also check the Any Holiday box. | The Schedule Trigger must be configured with the appropriate holiday settings; see below. |
Any Holiday | Check the Any Holiday box and make sure all weekday boxes are unchecked. | The Schedule Trigger must be configured with the appropriate holiday settings; see below. |
Any Non-Holiday | Check the Any Non-Holiday box and make sure all weekday boxes are unchecked. | The Schedule Trigger must be configured with the appropriate holiday settings; see below. |
Holidays
In order for a schedule to match holidays or non-holidays, the Holidays page of the Schedule Trigger properties must have a Holiday Set selected to tell adTempus which holidays you want to apply. However, you should set the holiday rule on that page to Run as scheduled so that none of the special holiday handling rules are applied. This is because your Date Rule already has the holiday settings you want to use.