|
|
Open source tools written in Java. Sponsored by Acelet corporation |
| |Home | Products | Documents | Downloads | Partners | Contact | |
Holiday Policy Tour for SuperScheduler
Holiday policy is an advanced feature of SuperScheduler. If you want to set a holiday and weekend policy for a task, go through this tour is a good way to know how to do it.
Holiday policy defines how the job should behave if the task falls on a holiday or weekend. You can create a task with or without a holiday policy. To set up a task with a holiday policy, Please do the following step by step:
If your company uses only one holiday set, you do not need to worry about holiday sets. By default, SuperScheduler uses a default holiday set which has no holiday set name shown on the screen. Here is how to create holidays and holiday rules for the default holiday set.
1. There are a holiday table and a holiday rule table for each holiday set, including the default holiday set (no-name holiday set). A holiday table contains a group of holidays. Each holiday has a name and a date. A holiday rule table contains holiday rules, those rules are used to generate holidays. Holiday rules are an optional for your convenience only.
Let's start. Go to the main menu. Click on Module > SuperScheduler > Holiday to open the Holiday Organizer Panel.
2. There are two parts on the Holiday Organizer Panel: Holiday Rule Table Panel and Holiday Table Panel.
3. A holiday rule table is used to specify holiday rules. you can use the Add button to add an individual rule or use the Import button to add a group of rules.
First let us import a group of rules, click the Import button in the Holiday Rule Table section.
The Import Panel appears. There are some public holiday rules in the HolodayRules.xml file, which we provided in the Super home (the default is AceletSuper) . Choose HolodayRules.xml and click the Import button.
The Select Holiday Rule Panel appears. Select a group of rules by highlight them. and click the Add button and answer Yes on the Attention Panel. Click the Close button to return to the Holiday Organizer Panel.
You will see the rules you chose have been added in the Holiday Rule Table Panel.
To add a individual rule, click the Add button on the Holiday Rule Table Panel. The Holiday Rule Panel appears. Check an item from the Set Holiday Date section as you need and fill the text fields accordingly.
For example, we add the second day of Thanksgiving as a holiday rule.
The Thanksgiving2 rule has been added into the Holiday rule table section.
A holiday rule table for the default holiday set has been created. You can save the holiday rules from the holiday rule table into a XML-format file by using the Export button. So you can give it to other departments.
4. Let's create a holiday table for the default holiday set.
A holiday table is specified holidays for a holiday set. Adding holidays to a holiday table is similar to adding holiday rules to a holiday rule table.
You can easily generate holidays from the Holiday Rule Table Panel by using the Generate button. Here is how to do it.
You can also generate holidays from holiday rules. Click the Generate button on the Holiday Rule Table Panel on the Holiday Organizer Panel. The Generate Holidays Panel appears. Choose or type in which year you want to generate holidays from the holiday rule, then click Ok.
The Holiday Organizer Panel returns. You will see that a group of holidays are added into the Holiday Table Panel. By regulations, if the holiday falls info Saturday, it automatically shifts to the previous Friday and if the holiday falls info Sunday, if shifts to the next Monday.
Let's add an individual holiday now. To add a holiday to a holiday table, click the Add button in the Holiday Table Panel, a Holiday Panel appears. Fill up the text fields, then click Ok.
The Service day: May 12, 2004 has been added into the Holiday table section.
You can easily add, edit, delete a holiday in a holiday table. You can also import holidays from a file to a holiday table and export holidays from a holiday table to a file.
The default holiday set is ready to use. We recommend that you update the holiday table at the end of every year.
5. Now, we have holidays. Let's see how to set a task with a holiday policy.
Go to the Set Term Panel. Let's select Monthly in the Repeating JComboBox.
Click the Advanced button, the Advanced Panel appears. There are two parts in this panel. The lower part is the Expiration time section. You can set the expiration time for a task here. If the field is empty, there is no expiration day.
The upper part is the Holiday/Weekend rollover section. The same day has been setup as default. We check the Next business day here.
Click Ok to return to the Set Term Panel, you will see the Advanced button has a * sign in front of the word Advanced, it means that advanced feather is set for this task. Click Ok and continue to finish the task setup.
The holiday policy for this task has been setup as that, if the task falls on a holiday which is in the holiday table of the default holiday set or falls on weekends, it will run on the next business day.
Now you know how to create the default holiday rule table and the holiday table and how to set a holiday policy for a schedule task. It is very powerful, flexible and easy to use. All changes (add, edit or delete) for holidays take effect automatically and promptly (in interval - default value is two seconds) for all tasks on all machines in the network.
The following is even more advanced feature for SuperScheduler holiday policy.
If your company is a big enterprise organization and needs to use multiple holiday sets, the first step is to create holiday sets and the second step is to set tasks with a specific holiday set. SuperScheduler will show holiday sets JComboBox on the screen.
A holiday set stands for a group of holidays. You can create as many holiday sets as you need. Each task will choose its own holiday set for its holiday policy.
1. If you want to use multiple holiday sets, you need to add a line in scheduer.properties file which is located under the directory beanbox of the Super Home directory (default is AceletSuper):
useMultipleHolidaySets=true
You need to restart Super after adding that line.
2. Let's create a holiday set named Canada as an example.
Go to the main menu. Click on Module > SuperScheduler > Holiday to open the Holiday Organizer Panel.
3. Because we have add a property on step 1, there are 3 parts on the Holiday Organizer Panel: Holiday Set Panel, Holiday Rule Table Panel, Holiday Table Panel.
We have already set the default holiday set as above, so we see some holidays already there. The Holiday set JComboBox is empty, it means that the holiday set is the default set: no-name set.
4. Click the Add button on Holiday Set Panel, the Add Holiday Set Panel appears. Type Canada into the Name text field, click Ok.
A holiday set named Canada has been created. Then you can continue set a holiday rule table and holiday table for this holiday set.
Now you can use the Import button to add a group of rules on the Holiday Rule Table Panel. You can also use the Add button to add an individual holiday or use the Generate or Import button to add a group of holidays in the Holiday Table Panel. It is the same as we discussed before.
If you click on the Holiday set JComboBox of you will see there is two holiday sets in the ComboBox: Canada and the default (no-name).
You can create as many holiday sets as you need. You can choose any holiday set, the holiday and holiday rules of the holiday set will show up accordingly. Then you can add, edit, delete, import, export ...on this set as you like.
4. Let's see hoe to set a task with desired holiday set. The way to set a task with the holiday policy is exact the same as we did with the default holiday set. The only difference is that you must choose a holiday set first.
Go to the Set Term Panel. Let's select Monthly as the value for Repeating.
Click the Advanced button, the Advanced Panel appears. Because we have added a property in scheduler.properties, we can see the Holiday set JComboBox in the top of the Holiday/Weekend rollover section. Click the Holiday set JComboBox and a list of holiday sets shows up. Choose Canada and check the Previous business day here.
Click Ok to return to the Set Term Panel and continue to finish the task setup.
The holiday policy for this task has been set as that, if the task falls on a holiday which is in the holiday table of the Canada holiday set or falls on weekends, it will run in the previous business day.
Now you know how to create multiple holiday sets and how to set a holiday policy for a task with a chosen holiday set. It is very powerful, flexible and easy to use. All the changes (add, edit or delete) for holidays take effect automatically and promptly (in interval - default value is two seconds) on all instances of SuperScheduler cross the network.
This is our SuperScheduler holiday policy tour. You can get more information from SuperScheduler.