Annual Holiday Manager

The goal of this build is to create a customized holiday list by allowing the user to specify the date calculation method in their calendar year and to send the calculated holidays to the assignee inbox. 

Installing App Store Applications

1. Navigate to the App Store in the Folders tab.
2. Search for the Annual Holiday Manager in the Not Installed section and select Details. 
3. On the App Details Page, select INSTALL.

After installing the project, the user will need to enable the scheduled job and add their office locations. To enable the scheduled job:

1. Navigate to System > Jobs and Events > Scheduled Jobs folder.
2. Right-click on the Annual Holiday Manager scheduled job.  
3. Select Enable Job.

By default, the scheduled job runs once a year on January 30th. The user will need to edit the settings if they want the job to run on a different schedule. To modify the job settings:

1. Navigate to System > Jobs and Events > Scheduled Jobs folder.
2. Right-click on the Annual Holiday Manager scheduled job.  
3. Select Edit Scheduled Job.
4. In the Calendar Information section, the user can edit the Yearly Schedule Information. The start date for the scheduled job can be changed in the Job Settings section.
5. Once the desired changes have been made, click Ok.

To add office locations:

1. Navigate to Settings > SystemData > Locations folder.
2. In the top left, click Add Location and provide the necessary location information and business hours.   
3. Click Save.
4. Repeat this process for all impacted locations.

Key Features

• Users are able to make their own customized holiday list in a year.
• The ability to select multiple locations.
• The ability to send for manual review once holidays are created.
• Reviewers will receive an email with the list of holidays to approve or deny. 
• Users can also submit One Time Holidays for existing holiday managers.

Considerations

• After importing the project, the user needs to enable the Scheduled Job in the Systemsfolder. To enable the Scheduled Job:
  • Navigate to System > Jobs and Events > Scheduled Jobs > Annual Holiday Manager.
  • Right-click on the job and select Enable Job.
• By default, the scheduled job will run every year on January 30th. 
  • To run the scheduled job more than once a year, users will need to edit the job's settings.
• Prior to using the Annual Holiday Managerscheduled job, the user will need to create office locations in their Decisions server. To create office locations:
  • Navigate to Settings > SystemData > Locations folder.
  • In the top left, click Add Location to add the impacted office locations. 

Main Flows

Generate Holidays

This flow is used to create holidays based on the office locations. It will fetch the Holiday Manager Settings and create a specified Holiday List for each holiday calculation. If the holiday requires manual review, the flow triggers the holiday assignment task, which notifies the assignee via email. If manual review is not required, the created holiday is saved. 

Annual Holiday Generator Scheduled Job

This is the primary flow which asynchronously runs over all Holiday Manager Settings. The flow will fetch enabled jobs from the holiday manager settings and generate a new Holiday List. 

Add Specified Holiday to List

This flow checks with the Date Calculation Method option selected and matches the calculation method accordingly. If the date calculation method selected is "Last Weekday of Month," then the flow path goes to the calculation of the last weekday of the month. If the date calculation method is "Xth Weekday In Month," then it is going to calculate Xth weekday in a month. In this case, it will initialize the weekday count, parse the date in the desired month, loop through 31 iterations, and check if the date of the week is equal to the weekday. If it is equal, it will add 1 to the weekday count in the loop and calculate the Xth weekday before finally adding it to the Holiday List. 

How to Use Annual Holiday Manager

Create/Update/Delete Holiday Managers

To create a new Holiday Manager:

• In the Annual Holiday Manager folder tree, navigate to the Holiday Manager Views Dashboard.
• In the top left of the page, click the Create New Holidays Manager button.
• In the form, enter the Holiday Manager Name and select the impacted Location.
• Select Job Enabled to run the created holiday calculations.
• If holidays require manual review, select Needs Manual Review. From the dropdown list, select the Assignee Email.
• Click Submit.

To update a Holiday Manager:

• In the Annual Holiday Manager folder tree, navigate to the Holiday Manager Views Dashboard.
• On the Holiday Manager Settings report, right-click the Holiday Manager that needs to be updated.
• Select the Update Holiday Manager Settings User Action.
• From the Form, the user can update the Holiday Manager Name, Job Enabled, and Manual Review settings. The office location cannot be updated.
• Once the desired changes have been made, click Update to store the changes.

To delete a Holiday Manager:

• In the Annual Holiday Manager folder tree, navigate to the Holiday Manager Views Dashboard.
• On the Holiday Manager Settings report, right-click the Holiday Manager that needs to be deleted.
• Select the Delete Holiday Manager Settings User Action.
• A message form will be displayed asking the user to confirm that they want to delete the Holiday Manager Settings. To delete the settings, click Yes.
• This will delete all Holiday Calculations that were created under those settings. 

Create/Update/Delete Holiday Calculations

To create new Holiday Calculations:

• Once the Holiday Manager is created, Holiday Calculations can be created from the Holiday Manager Views Dashboard or from the Dashboard for the specific Holiday Manager Settings. 
  • From the Holiday Manager Views Dashboard, the user can right-click on the Holiday Manager in the Holiday Manager Settings report and select the Create Holiday Calculation(s) User Action.
  • Alternatively, the user can left-click on the Holiday Manager to navigate to the page for those settings. From there, the user can click the Create Holiday Calculation(s) button in the top-left. 
• To create calculations, enter the name of the holiday you want to add and select the type of date calculation method. There are three different calculation methods in the drop down menu:
  • Fixed Day in Month is for holidays that occur on the same date every year. When selecting this calculation method, users will also need to enter the Expected Month and Expected Day as integers. For example, a holiday that is always on October 31st would have an expected month of 10 and an expected day of 31.
  • Xth Weekday in Month is for holidays that occur on a certain weekday in a specific month. For this calculation method, users will need to specify the Expected Month and Xth Weekday as integers and select the Weekday Name from the drop down list. For example, a holiday that is on the fourth Thursday of November would have an expected month of 11, an Xth weekday of 4, and the weekday name would be Thursday.
  • Last Weekday of Month is for holidays that occur on the last weekday of a specific month. The user will need to specify the Expected Month as an integer and select the Weekday Name from a drop down list. For example, holiday that is on the last Sunday in May would have an expected month of 5 and a weekday name of Sunday.
• Users can also add multiple calculations using the Add Calculation button at the bottom left. This will add a new row to specify a calculation. 
• To remove a calculation, select the row containing the calculation and click the Remove Calculation button in the bottom left. 
• Once all calculations have been entered, click Submit. 
• Created calculations will appear on the right side of the Holiday Manager Settings page in the Holiday Calculations report. For the calculations to also appear in the Holiday Settings calendar report on the left side of the page, users will need to run the Scheduled Job Flow. 
• To view the report in a calendar view, click on the three dots on the top-right side of the report. Click on the second icon under Views to view the calendar. 

To update a Holiday Calculation:

• In the Holiday Calculations report, right-click on the desired calculation and select the Update Holiday Calculation User Action.
• In the Form, the user can update the Holiday Name, Date Calculation Method, and associates fields.
• Once the desired changes have been made, click Update.

To delete Holiday Calculations:

• In the Holiday Calculations report, right-click on the desired calculation and select the Remove Holiday Calculation(s) User Action. Multiple calculations can be deleted using CTRL + right-click followed by clicking the checkbox next to the desired Holiday Calculations. 
• A message form will be displayed asking the user to confirm that they want to delete the selected calculation(s).
• To delete the calculation(s), select Yes. 

Submit One Time Holidays

Users can also create one-time holidays. These are non-recurring holidays that occur on a specific date and do not have an associated calculation method.

• On the page for the specific Holiday Manager Settings, click the Submit One Time Holiday(s) button in the top middle.
• Alternatively, this user action can be executed from the Holiday Manager Settings report on the Holiday Manager Views Dashboard.
• On the Form, specify the Holiday Name and Date.
• To add another one-time holiday, click the Add Holiday button. Another row will be populated on the form. 
• To remove a holiday, select the desired row and click the Remove Holiday button.
• Once the desired holidays have been specified, click Submit.
• One-time holidays will be visible in the Holiday Settings report. 
• These holidays can be deleted by right-clicking on the holiday from the Holiday Settings report and selecting Manage > Delete Holiday. A message will be displayed, prompting the user to confirm the deletion. 

Review Open Assignments

• The open assignments will show on the right side of the Holiday Manager Views Dashboard in the Open Assignments report.
• Open assignments can be closed directly from the Dashboard or from the assignee email.
  • From the Dashboard, left-click on the assignment and select Review Holidays.
  • From the email sent to the assignee, click Respond to This Task and submit the manual review.