Project Approvals In Timesheet 5.5

Help Contents

Timesheet 5.5 introduces a new approvals process, Project Approvals. Project Approvals allow you organization to have Time, Mileage and Expenses approved on a per-project basis. Project Approvals can be used in place of, or in combination with, the standard Timesheet period approvals. This section discusses Project Approvals in their entirety and provides information on using Project Approvals concurrently with Period Approvals. For more information on the standard Period Approvals processes, please see the Period Approvals portion of this documentation.

Creating A Project Approvals Process

Project Approvals processes are created using the Project Approval Settings Screen, which is accessed via the Create Project Approval icon ()located in the Approvals column on the Project Management Screen.

When you click this icon, Timesheet will then display the Project Approval Settings Screen for the Project in question. This screen is used to configure the Project Approval process for the selected Project.

Primary and Backup approvers for this process are established on this screen. Additionally, this screen can be used to turn an Approval Process off or on as well as indicating the relationship this Project Approval process has with the children of the currently selected project.

The actual process of creating a Project Approval is outlined below.

When you have made your selections, you may click either the Button or the Button.

The Button will cause Timesheet to refresh the Project Approval Settings Screen, including a green text message confirming the modifications.

The Button will cause Timesheet to refresh the Project Approval Settings Screen, including a green text message confirming the modifications and the application of those modifications to the Project Approval process of the current Project's descendents.

Deleting And Moving Approvers

If you have created a Project Approvals process and find that you need to move or delete an approver from the template, Timesheet doesn't leave you stranded.

To delete one or more approvers (primary or backup) from the Project Approval process, simply click the Remove? checkbox next to the name(s) of the approvers in question and click either the Button or the Button.

Timesheet will refresh the Project Approval Settings Screen, including a green text message confirming the modifications.

To change the order of approvers (primary or backup) within the Project Approval process, change the numbers in the Level text boxes to the left of each approver's name to reflect the new order of approvers. Hint: If you need to change only one approver level, use a decimal number to make the change. In the example pictured below, dchance will be moved from level three to level two, because Timesheet will automatically place "1.5" between level one and level two - thereby pushing djordan to level three.

Once you have entered your changes, click the Remove? checkbox next to the name(s) of the approvers in question and click either the Button or the Button. Timesheet will refresh the Project Approval Settings Screen, including a green text message confirming the modifications.

Email Notifications In Project Approvals Processes

Each Project Approvals process in Timesheet can have up to six associated, predefined email notifications. The tools to control and customize these email settings are located on the Project Approvals Email Settings Screen, which is accessed via the Email Settings for... link, located in the upper right hand corner of the main Project Approvals Setting Screen

This section of the manual explains the individual Project Approvals email notifications and describes the customization possible for each. Timesheet uses Journyx Tags to help you customize these email notifications. Journyx Tags and the customization process are covered below.

Please Note: For approvals emails to function properly, your organization's Timesheet Administrator must enable email notification in the Global Preferences section of Timesheet. For more information on the Global Preferences section of Timesheet, please see the Global Preferences portion of this documentation.

User Notification of Rejection
When this email notification is enabled, Timesheet sends an email to users when their entry is rejected by an approver associated with this Project.
Other Approver Notification of Rejections
When this email notification is enabled, other approvers, both within the same process as well as those independent from this process, are notified when an approver associated with this Project rejects a particular entry.
User Notification of Project Approval
When this email notification is enabled, Timesheet sends an email to users when their entry is approved by an approver associated with this Project.
Approver Notification of Project Submit
When this email notification is enabled, Timesheet sends an email to the approvers associated with this Project when a user submits an entry against the project in question.
Approver Notification of Project Resubmit
When this email notification is enabled, approvers associated with this Project are sent an email when users resubmit entries that have previously been rejected.
Backup Approver Notification
When this email notification is enabled, Timesheet will send an email at a specified point in time after an approval has been submitted to, but not processed by, the primary approver associated with this Project. The delay before sending to the backup approver is set at the time of Email Notifications modification and is discussed below.

Customizing And Enabling Email Notifications for Project Approvals

Each of the six email notifications associated with a Project Approvals process can be turned off or on as needed. The Enable? dropdown box allows you to select "yes" or "no" to turn each individual notification type off or on. Simply change the dropdown selection to suit your needs.

The Subject Line and Body of each of the six types of email notification can be modified to meet the needs of your organization. Both of these fields can accept plain text, HTML tags, or Journyx Tags.

Journyx Tags
Timesheet uses Journyx Tags to help you customize your Project Approvals email notifications. Journyx Tags are HTML-style tags that you can use to personalize certain information you would like included in Project Approvals email notifications.

Journyx Tag Replaced By
<reason>   displays the rejection reason
<prd>   timeperiod for entry
<type>   the entry type (time, expense, or mileage)
<uid>   the login id of the user
<ufn>   the full name of the user
<uem>   the user's email address
<uphn>   the user's phone number
<rjid>   login of the individual rejecting
<rjfn>   full name of the individual rejecting
<rjem>   email address of the individual rejecting
<rjphn>   phone number of the individual rejecting
<aprid>   login of the final approver
<aprfn>   full name of the final approver
<aprem>   email address of the final approver
<aprphn>   phone number of the final approver
<baid>   login of the backup approver
<bafn>   full name of the backup approver
<baem>   email address of the backup approver

Backup Approver Timing And Activating Changes

After you have enabled the desired email notifications and made any changes to the Subject Line or Body of those emails, you may choose to set a specific length of time that must pass before notifications are sent to backup approvers. The interface for setting these time limits is located beneath the email configuration portion of the Project Approvals Email Settings Screen. If you have enabled the email notification for backup approvers, there are two settings that will require your attention here: You may choose to change these numbers to meet your organization's needs. Please Note: The values for these settings must be entered in whole day values.

After you have finished with this portion of the Project Approvals Email Notifications configuration, you may activate your changes by clicking either the Button or the Button. These buttons, like their counterparts on the main Project Approvals Settings Screen commit your changes to either the Project in question alone or to it and its descendents as well.

Once you click either of these buttons, Timesheet will refresh the Project Approvals Email Settings Screen and display a green text message confirming the changes you have made to the email notifications settings for the currently selected Project Approvals process.

Modifying Project Approvals Processes

The main Project Management displays the Modify icon () in the Approvals column for any Project that has an existing Project Approvals process defined. Clicking this icon will cause Timesheet to display the Project Approvals Settings Screen, as described above. This screen can then be used to make modifications to the currently selected Project Approval, using the previously outlined steps.

Please Note: Modifying a Project in this manner affects that Project only. Therefore, it is possible to change the setting of a descendents without affecting its siblings or parent. Journyx recommends that you proceed with caution when modifying an existing Project Approval process to ensure that you do not accidentally change the settings for a child Project in an unintended way.

Re-opening Records That Have Already Been Approved

If the record you wish to modify is in any state during the approval process (submitted for approval or completely approved), you can make corrections to the record by using the sheet "Open" feature. You can access this feature as an approver if you are designated as the approver for the record in question. You can also access this feature as an Administrator either through the Approvals area or via Timekeeping. The Open button appears below the submitted/approved sheet. When a sheet is re-opened, the approval process gets completely reset. Once a sheet is re-opened, anyone who has the ability to enter time for the employee (the employee, timekeepers) will be able to modify the records just as if the sheet had never been submitted for approval. This includes the ability to modify the records in Record Modification. The sheet re-open process does not maintain the original records that were submitted or approved via an approval process, and the modifications must be submitted for approval again. This option is only recommended when the correction requires that the original record be completely removed from the database (i.e., the employee's comments reveal confidential information or the employee entered and submitted time for the wrong period).

Project Approvals Global Preferences Settings

There are two Global Preferences settings in Timesheet that directly affect the performance of Project Approvals. These two settings are:

For more information on Timesheet's Global Preferences, please see the Global Preferences portion of this documentation.

Synchronized Approvals Process: An Example

When Timesheet's Global Preferences are set to synchronize Project Approvals, each separate approver on every level must approve their portion of a timesheet, mileagesheet or expensesheet before that sheet continues on to the next level of approvers for each portion. Consider the following situation:

Kyle has a timesheet that contains entries against three projects, Support, Documentation and Development. These three projects each have three levels of approvers.

  Support Documentation Development
Level 1 Approver Clark Diana Bruce
Level 2 Approver Peter Steve Henry
Level 3 Approver Janet Charles Victor

When Kyle submits this timesheet for approval it goes to Clark, Diana and Bruce for approval. No portion of this sheet goes to the second level approvers until all three first level approvers approve it. The same concept holds true for subsequent levels. Therefore, once this timesheet has made it to the second level, all three second level approvers must approve it before it continues on to the third approval level.

Restart At First Level: An Example

Using the same set of projects and approvers as the above example, here is an explanation of how the second Project Approvals Global Preference functions. This example assumes that Project Approvals Synchronization has been turned off. Consider the following:

Kyle has an expensesheet that contains entries logged against the same three Projects, Support, Documentation and Development. Kyle submits his expense sheet and it begins to flow through the approvals process. Each Project continues on its own track without regard to other tracks, because Timesheet has been configured not to synchronize the approvals process. The approvers for Support, Clark, Peter and Janet all approve the entries associated with their Project without problem. The same happens with the approvers for the second Project, Documentation.

Bruce and Henry both approve the entries logged against Development, but the third level approver for that Project, Victor, spots and error with those records. Victor rejects the expensesheet. Because Timesheet has been configured to have rejected sheets start over at the first approval level, this expensesheet goes back to Bruce for approval and continues up the approval process again normally.

Using Synchronized Approvals And Restart At First Level: An Example

Using the same set of projects and approvers, this section provides an example of how the two Project Approvals Global Preferences work when used together. Consider the following:

Kyle has a mileagesheet that contains entries logged against Support, Documentation and Development. Kyle submits this mileagesheet for approval and the sheet goes to the first level approvers for each Project. The sheet cannot move on to the second level of approvers until all three first level approvers, Clark, Diana and Bruce, approve the entries logged against their respective Projects.

Once the sheet moves to the second level, Peter and Steve both approve the entries logged against their Projects. However, Henry notices a problem with the entries logged against Development and rejects the sheet, so that Kyle can make the needed changes. Because Timesheet has been configured to restart the approvals process at the first level after a rejection, and because Timesheet is synchronizing approvals levels, Kyle's expensesheet is now, effectively, completely unapproved. Kyle will have to make his changes and resubmit the expensesheet for approval. When he does so, the sheet will begin with the first level approvers for each Project and have to go through each level completely again before it can pass to the next level for approval.

Obviously, using Synchronized Approvals and Restart at First Level can become quite complicated and time consuming. Journyx provides these options for our customers who require such exacting control over their Approval Processes. Please be aware that using these two options simultaneously can have a serious impact on the overall speed of the Approvals process, due to the interdependency imposed by synchronization as well as the potential for submitted records to be returned to the first level and have to traverse the entire Approvals process.

Working With Project Approvals And Period Approvals

Journyx Timesheet allows you to use Project Approvals in conjunction with the standard Period Approvals to maintain the strictest control over your organization's business processes. When these two approvals methods are combined, the Project Approvals allow discrete control over individual Projects while the Period Approvals continue to focus on the payroll aspects of your business.

In general, the two Approvals formats can run side-by-side with little interaction. Users submit their sheets normally and the individual approvers approve or reject those sheets as needed. Project Approvals approvers and Period Approvals approvers work independently of one another. If one side approves a sheet completely, but another side rejects that same sheet, the sheet is returned to the user and must be resubmitted again if the total hours have changed.

The only time the two Approvals formats come into direct contact is if your organization has enabled the Synchronize Approvals Global Preference. When this Global Preference is enabled, both Period Approvals and Project Approvals are synchronized. The submitted sheet cannot move to the next level of approvers, in either category, until all approvers, from both categories, have approved it on its current level.

For more information about Period Approvals, please see the Period Approvals section of this documentation.

Using Project Approvals And Period Approvals In Tandem: An Example

When Timesheet is configured to use both Project Approvals and Period Approvals, both approvals processes run side-by-side without interaction in normal cases. Consider the following situation:

Kyle has a timesheet that contains entries against three projects, Support, Documentation and Development. These three projects each have three levels of approvers.

  Support Documentation Development
Level 1 Approver Clark Diana Bruce
Level 2 Approver Peter Steve Henry
Level 3 Approver Janet Charles Victor

Additionally, Kyle has been assigned a Period Approvals process that has two levels of approval. Kyle's primary Period Approvals approve is his direct manager, Bruce. Bruce is also the first level approver for the Project Development. Kyle's second level Period Approver is Susan, the payroll manager.

Level One
When Kyle submits his timesheet for approval, it is queued up for the first level Project Approvals approvers, Clark, Diana and Bruce. Additionally, it is queued up for the first level Period Approver, Bruce. Since Bruce serves two separate approvals functions, he will have to approve Kyle's timesheet twice - once as a Project Approver and once as a Period Approver. Each of these functions will require Bruce to use the appropriate criteria to approve or reject Kyle's timesheet, e.g. Bruce must decide if the timesheet is accurate in terms of hours logged to the Development project and he must decide if Kyle has entered his hours appropriately in terms of the payroll period.

If Bruce approves Kyle's timesheet in both categories, it then passes to the second level approvers for both Period Approvals and Project Approvals. Once Clark and Diana approve Kyle's timesheet for the hours logged against their Projects, the timesheet will move forward in the Project Approvals line for those Projects as well.

If this installation of Timesheet has been configured to synchronize approvals levels, Kyle's timesheet would not be able to move on to the second level approvers for both Project Approvals and Period Approver until all first level approvers, both Project and Period, has approved the timesheet.

Level Two
Once Kyle's timesheet has been approved by the level one approvers, either individually if approvals are not synchronized or by all of them if approvals are synchronized, it enters the queue for the second level approvers: Peter, Steve and Henry for Project Approvals and Susan for Period Approvals.

Just like the first level of approvals, each approver receives Kyle's timesheet in their queue and they must look at it and either approve or reject it. If Susan approves the timesheet, it is complete for Period Approvals and is simply waiting to finish the Project Approvals process. If Susan rejects the timesheet, it goes back to Kyle for modification.

If the three second level Project Approvers approve Kyle's timesheet, it moves on to the third level Project Approvers. If one or more of the second level approvers reject the timesheet, it is returned to Kyle to correct. Again, if approvals synchronization has been enabled, Kyle's timesheet will not be made available to the third level approvers until all second level approvers have approved it.

After Kyle's timesheet has passed the second level approvers, it enters the queue for the third level approvers. If the third level approvers approve the timesheet, its approval process is complete and the records are permanently stored in the Timesheet database.

If one or more of the third level approvers reject Kyle's timesheet, it returns to him to correct. Once he has made his corrections, he must submit it for approval again. If at any time during this process Kyle makes changes that affect another Project Approval or the Period Approval, the timesheet's approval status for those approval tracks is nullified and the timesheet must pass through the entire approvals process for that track again.