Journyx Timesheet v4.5 Owner's Manual


Global Preferences In Timesheet v4.5

Timesheet allows your organization control over many of its appearance and behavioral values. The Global Preferences Modification screen server as the command center for making these modifications. The myriad possible preferences settings are divided into subscreens and are grouped according to which aspects of Timesheet they affect. The preferences subscreens are available via the links on the left side of the master Global Preferences Screen. Each of these subscreens is detailed below.

Values listed in bold text are the default values for Timesheet. Options in blue text may not appear in the Global Preferences section of your organization's Timesheet installation. These options are related to optional modules of Timesheet that your organization may not have purchased. If you are interested in the functionality that relates to these options, please contact your Journyx Sales Representative.

User Interface Preferences

User Interface Options    
Option Value Results
Are Blank or Unentered Comments OK? yes Allows users to leave the comment field blank on Time Entry and Expense Entry screens. Select yes for this option if comments are not critical to your organization's needs
  no Requires users to enter a comment on Time Entry and Expense Entry screens. Select no for this option if comments are critical to your organization's needs.
     
Allow users to modify Memorized Time Entries? yes Allows users to modify Memorized Time Entries that have been assigned to them by the admin or their manager
  no Prevents users from modifying Memorized Time Entries that have been assigned to them by the admin or their manager
     
Default comment on time entry screen (if applicable) Varies The text entered here will serve as the default text for the comment field on all Time Entry Screens. Please Note: This field is overridden by individual user preferences
     
Show the Start/Stop button on Time Entry Screen? Yes Displays the Start/Stop button on each Time Entry Screen. Please Note: If you will be using any Time Entry Screens that are based on the Start/Stop format, you must have this option set to yes.
  No Hides the Start/Stop button on each Time Entry Screen
     
Root directory of MS Project File Repository Varies Specifies the location of the folder that will hold MS-Project .mdb files for Timesheet installations that are using Journyx ProjectLink MS-Project integration. Please Note: The path entered here is relative to the Timesheet host machine.
Expenses    
Option Value Results
Use Expenses? Yes Enables the Expense Tracking functionality of Timesheet
  No Disables the Expense Tracking functionality of Timesheet
     
Custom Bug Reports    
Option Value Results
Enter text to be displayed on error screen. Varies Text entered into this field will appear on any error screen that users may encounter
     
Enter text for Bug Report button. Varies Text entered into this field will appear on the button that is used to submit bug reports
     
Enter url for Bug Report button to link to. Varies Specifies a URL that the bug report button links to. Please Note: Typically, a CGI script must be resident at the referenced URL to achieve maximum error processing functionality. Please contact the Journyx Professional Services team to receive assistance with this feature.
     

Security And Access Preferences

Project Access Options    
Option Value Results
New users get default access to all projects, codes etc? yes Provides newly created users with access to all projects, tasks, pay types and bill types by default. Please Note: This option should be set to yes only if your organization intends to allow users access to the majority your projects, etc. Otherwise, set this option to no to minimize the amount of editing that must be performed on new users
  no Limits newly created user's access to Projects, Tasks, Pay Types and Bill types to only those items that are in a group that also contains the new user(s)
     
Can users add projects? yes Provides users with the ability to create new projects
  no Prevents users from creating new projects.
Security Options    
Option Value Results
Idle time before a user is forced to relogin (minutes) Varies (number) Defines a number of minutes that a user can be idle before a relogin is forced. The default is 1720 minutes, or 28 hours and 40 minutes.
     
Number of Days before password is invalid Varies (number) Defines a number of days that user passwords can be used before they must be changed. The default is 360 days.
     
Minimum number of characters a password can be Varies (number) Defines the minimum number of characters that each password must be. The default is 1 character.
     
Number of old passwords to save and disallow Varies (number) Defines a number of passwords that are kept in the system and may not be used again by users until they have been "pushed out" by newer passwords. The default is 1 password.
     
Require mix of letters and numbers in password? yes Indicates that passwords must be a mix of letters and numbers for additional security. With this option set to yes, all user passwords <i>must</I> be composed of both Alpha and Numeric characters.
  no Indicates that passwords do not have to be composed of letters and numbers. With this option set to no, any password that meets the minimum length requirement defined above will be accepted by Timesheet
     
Show URLs which would take you out of jtime? yes URLs contained within Timesheet that would lead users out of Timesheet are displayed.
  no URLs contained withing Timesheet that would lead users out of Timesheet are hidden.

Time Entry Preferences

Time Record Column Names    
Option Value Results
The name of the group time record field Varies (text) Defines the name for the group field throughout Timesheet. The default name is Group
     
The name of the hierarchical time record field Varies (text) Defines the name for the hierarchical dropdown field throughout Timesheet. The default name is Project
     
The name of the first dropdown time record field Varies (text) Defines the name for the first dropdown field throughout Timesheet. The default name is Task
     
The name of the second dropdown time record field Varies (text) Defines the name for the second dropdown field throughout Timesheet. The default name is Pay Type
     
The name of the third dropdown time record field Varies (text) Defines the name for the third dropdown field throughout Timesheet. The default name is Bill Type
     
The name of the textbox time record field Varies (text) Defines the name for the text input field throughout Timesheet. The default name is Comments
     
Time Entry    
Option Value Results
Day length for time entry as percent Varies (number) Defines the number of hours in a work day when percentage time entry is used. The default value for this field is 8. Therefore, if a time entry of 50% is made, Timesheet will consider this time as 4 hours. If you modified this value to 10, then that same 50% would be considered 5 hours.

Mileage Entry Preferences

Mileage Entry Column Description    
Option Value Results
The name of the "Reason" mileage field Varies (text) Defines the name for the Reason field throughout Timesheet. The default name is Reason
     
The name of the "Vehicle" mileage field Varies (text) Defines the name for the Vehicle dropdown field throughout Timesheet. The default name is Vehicle
     
The name of the "Measurement" mileage field Varies (text) Defines the name for the Measurement dropdown field throughout Timesheet. The default name is Measurement
     
The name of the "Comment" mileage record field Varies (text) Defines the name for the Comment dropdown field as it relates to Mileage Entry throughout Timesheet. The default name is Comment

Expense Entry Preferences

Expense Entry Column Description    
Option Value Results
The name of the first expense field Varies (text) Defines the name for the first expense dropdown field throughout Timesheet. The default name is Expense Code
     
The name of the second expense field Varies (text) Defines the name for the second expense dropdown field throughout Timesheet. The default name is Source
     
The name of the third expense field Varies (text) Defines the name for the third expense dropdown field throughout Timesheet. The default name is Currency
     
The name of the comment expense record field Varies (text) Defines the name for the Comment field as it relates to Expense Entry throughout Timesheet. The default name is Comment

Screen Appearance Preferences

Screen Appearance Options    
Option Value Results
For an extra button in the button bar, enter text here Varies (text) Text entered here will appear as a new button in the button bar that is displayed at the top and bottom of each screen in Timesheet. By default there is no extra button.
What URL should the extra button point to? Varies (URL) If an extra button is to be displayed in the button bar, the URL that this button should link to must be entered here. Please Note: This option requires a full URL including the scheme name (http://).
     
Text for the email link at the bottom of each screen Varies (text)  Defines the text that appears as an email link at the bottom of each screen in Timesheet. The default value is: Comments to author: Time@journyx.com
Email address at the bottom of each screen Varies (email address) Defines the actual email address that the link at the bottom of each screen will access if clicked. Please Note: This value must be a complete email address. The default value is: Time@journyx.com
     
URL of the GIF at the top of each screen Varies (URL) Specifies a URL that points to a .gif or .jpg image that will appear at the top of every screen in Timesheet. There is no defined default for this option. To return to the Journyx logo information that occupies this feature at the time of installation, simply delete the URL in this option and click the Modify Preference Values button. Please Note: This must be a complete URL, including the scheme name (http://). Additionally, this value must not be a UNC path as used by some Windows environments.
URL of the GIF at the bottom of each screen Varies (URL) Specifies a URL that points to a .gif or .jpg image that will appear at the bottom of every screen in Timesheet. There is no defined default for this option. To return to the Journyx logo information that occupies this feature at the time of installation, simply delete the URL in this option and click the Modify Preference Values button. Please Note: This must be a complete URL, including the scheme name (http://). Additionally, this value must not be a UNC path as used by some Windows environments.
     
Screen Colors Options    
Option Value Results
Darkest Color (Button Bar) Varies (HTML hex color string) Specifies the darkest color used by Timesheet for screen generation. The default value for this option is: #333366. To return to this value from another value, simply delete the contents of the value box and click the Modify Preference Values button. For further information on Hex Colors, please see the link at the bottom of the Global Preferences screen.
Dark Color (Table Titles) Varies (HTML hex color string) Specifies the second darkest color used by Timesheet for screen generation. The default value for this option is: #666699. To return to this value from another value, simply delete the contents of the value box and click the Modify Preference Values button. For further information on Hex Colors, please see the link at the bottom of the Global Preferences screen.
Middle Color (Some Table Backgrounds) Varies (HTML hex color string) Specifies the middle color used by Timesheet for screen generation. The default value for this option is: #9999cc. To return to this value from another value, simply delete the contents of the value box and click the Modify Preference Values button. For further information on Hex Colors, please see the link at the bottom of the Global Preferences screen.
Light Color (All Table Backgrounds) Varies (HTML hex color string) Specifies the second lightest color used by Timesheet for screen generation. The default value for this option is: #ccccff. To return to this value from another value, simply delete the contents of the value box and click the Modify Preference Values button. For further information on Hex Colors, please see the link at the bottom of the Global Preferences screen.
Lightest Color (Page Background) Varies (HTML hex color string) Specifies the lightest color used by Timesheet for screen generation. The default value for this option is: #ffffff. To return to this value from another value, simply delete the contents of the value box and click the Modify Preference Values button. For further information on Hex Colors, please see the link at the bottom of the Global Preferences screen.

Miscellaneous Options Preferences

Communications Options    
Option Value Results
SMTP mail server name Varies (text) Specifies the SMTP server that Timesheet will use for automated email notifications. Please Note: This option must have a value specified for automated email notifications to work properly in Timesheet
     
From address of mail sent by jtime Varies (text) Specifies the address that will be shown in the "from" field on all automated email notifications.
     
Do not process emails for timesheets before date Varies (date in YYYYMMDD format) Indicates the historical cutoff date for Timesheet related emails. Timesheet will not send emails regarding any time sheet that covers a period before this date. The default value for this field is August 18, 1972 (19720818).
Group Management Options    
Option Value Results
Allow Modification of the "All" Group? yes Enables modification of the "All" Group beyond simply removing users from that Group. Please Note: Removing any item other than users from the "All" group may render that item unusable in Timesheet. For this reason, modification of the "All" Group is strongly discouraged.
  no Prevents modification of the "All" Group other than removing users from that Group.
     
Javascript Options    
Option Value Results
Use javascript enhancements? yes Enables javascript in Timesheet. Javascript is used by Timesheet in several locations, notably in Javascript enhanced Time Entry Screens for automatic column and row totaling. Please Note: If this option is set to yes, certain non-javascript browsers may experience difficulties. Journyx recommends enabling this option unless your organization uses a non-javascript browser.
  no Disables the javascript enhancements in Timesheet.

Project Management Preferences

Editing Projects    
Option Value Result
Allow Checkbox Deletion of Projects? no Disables checkbox deletion of projects. Deletion is only possible through the Delete Icon. Please Note: With this option set to "no" you will only be able to delete one project at any given time.
  yes Enables checkbox deletion of projects. Deletion is only possible though selected one or more projects via checkboxes and clicking the Delete button. Please Note: With this option set to "yes" you will be able to delete multiple projects at one time.
     
Allow Checkbox Modification of Projects? no Disables checkbox modification of projects. Modification is only possible through the Modify Icon. Please Note: With this option set to "no" you will only be able to modify one project at any given time.
  yes Enables checkbox modification of projects. Modification is only possible though selected one or more projects via checkboxes and clicking the Modify button. Please Note: With this option set to "yes" you will be able to modify multiple projects at one time.
     
Allow creation of projects under projects that are hidden? yes Allows the creation of projects under parent projects whose status has been set to "hidden." Please Note: If hidden projects are not displayed in the project tree (see Show Hidden Projects in Tree, below) creating new projects under hidden projects will not be possible.
  no Prevents the creation of projects under parent projects whose status has been set to "hidden."
     
Behavior    
Option Value Result
Always Show The Full Project Tree? yes Timesheet will display the full project tree at all times. Please Note: If this option is set to "yes" then the options "Limit the number of projects on any single page to:" and "Default number of branches to show" are effectively disabled. See below for more information on these options.
  no Timesheet will not display the full project tree. Please Note: If this option is set to "no" then the options "Limit the number of projects on any single page to:" and "Default number of branches to show" are used by Timesheet to determine which portions of the project tree to display. See below for more information on these options.
     
Limit the number of projects (rows) on any single page to: 100 Specifies the maximum number of projects that Timesheet will display on any given Project Management Screen. Please Note: If the "Always Show The Full Project Tree?" option (see above) is set to "yes" then this option will have no effect on the Project Management Screen display.
     
Allow re-parenting of projects through the gui? yes Allows use of the Cut and Paste buttons on the Project Management Screen to change the project hierarchy by moving projects between parents. This option does not supercede the ability to reparent projects via direct project editing.
  no Disallows the use of the Cut and Paste buttons on the Project Management Screen to change the project hierarchy by moving projects between parents. Please Note: If this option is set to "no" the Cut and Paste buttons will no longer appear on the Project Management Screen.
     
View Project "Icon Legend"? no Turns off the legend that describes the functions of each of the icons used in the Project Management Screen.
  yes Turns on the legend that describes each of the icons used in the Project Management Screen.
     
Number of new projects allowed on new project screen:
5 Indicates the maximum number of new projects that may be created at one time when using the Create New Projects functions of Timesheet.
     
Default number of branches to show 3 Indicates the default number of branches of the Project tree to display. Please Note: If the "Always Show The Full Project Tree?" option is set to "yes" then this option is effectively disabled.
     
Show hidden projects in tree? yes Forces Timesheet to display all projects, even those whose status has been set to "hidden" within the Project tree.
  no Forces Timesheet to keep all projects whose status has been set to "hidden" from being displayed in the project tree.
     
Interface    
Option Value Result
Use Enhanced Management Interface no Turns off the UI enhancements to the Project Management Screen. These enhancements include bold dark lines that more clearly separate each section of the project tree as well as a footer for the project tree that displays the same information as the header. Finally, when enabled the Enhanced Management Interface automatically displays the Create New Projects controls at the bottom of the Project Management Screen.
  yes Turns on the UI enhancements to the Project Management Screen. These enhancements include bold dark lines that more clearly separate each section of the project tree as well as a footer for the project tree that displays the same information as the header. Finally, when enabled the Enhanced Management Interface automatically displays the Create New Projects controls at the bottom of the Project Management Screen.
     
Extra Data    
Option Value Result
Let Managers see actual hours? no Turns off the appearance of "Actual Hours" in the Project Tree display for users other than Administrators.
  yes Turns on the appearance of "Actual Hours" in the Project Tree display for users other than Administrators.

Disconnected Client Basic Preferences

Disconnected Client Basic Settings    
Option Value Result
User DC forms are submitted to this address Varies (text) This option allows you to specify the address to which all Disconnected Client forms will be sent. You may modify this text as required by your organization; however, please note that the mailto: tag must remain part of this field or the DC functions in Timesheet v4.5 will not function properly. The default value for this option, mailto:changeme@yourhost, must be changed before your user will be able to work with the Disconnected Client features of Timesheet.
     
How many minutes between new submission checks Varies (number) This option allows you to specify the number of minutes that Timesheet waits between checks for newly submitted DC Forms. You may modify this option as required by your organization. The default value for this option is 2 minutes.
     
Force project form to be submitted first Yes Forces users to submit any outstanding DC Project creation form(s) before they can successfully submit any Time, Expense or Mileage Entry forms
  No Allows users to submit outstanding Time, Expense or Mileage Entry forms prior to submitting any outstanding DC Project creation forms.
     
Force Email addresses to pass validator? No Allows DC Form submission emails to be logged in Timesheet without first passing the email address validator.
  Yes Prevents DC Form submission emails from being logged in Timesheet without first passing the email address validator.
     
Disconnected Client Mail Text Settings    
Subject line prefix for DC form emails Varies (text) This option allows you to specify the text that will appear in the Subject line of each email Timesheet sends that contains a disconnected client form. You may modify this text as required by your organization. The default text for this field is JTime DC
     
Body text for DC form emails Varies (text) This option allows you to specify the text that will appear in the Body of each email Timesheet sends that contains a disconnected client form. You may modify this text as required by your organization. The default text for this field is: Please open these HTML attachments in your web browser by double-clicking on them. This is a multi-part message in MIME format with base64 encodings. (Your mail reader should be able to figure this out automatically.)

Please Note:
If you change the encoding method (see below), you should change the information on the encoding method used contained within this text.
     
     
Disconnected Client Mail Sending Settings    
Option Value Result
DC Form sender name and email Varies (text) This option allows you to specify the name and email address that will be displayed in the From line of each email Timesheet sends that is related to the disconnected client module. You may change modify this text as required by your organization. The default text for this field is: Journyx Timesheets <discon@journyx.com>
     
SMTP server name Varies (text) This option allows you to specify the name of the SMTP (outgoing) mail server that Timesheet will use when sending emails related to the disconnected client module. You may modify this text as required by your organization. The default value for this field is: smtp
     
SMTP port Varies (port number) This option allows you to specify the port used by the SMTP (outgoing) mail server that Timesheet will use when sending emails related to the disconnected client module. You may modify this text as required by your organization. The default value for this field is: 25
     
Form encoding method Varies This option allows you to specify which encoding method Timesheet will use when sending emails related to the disconnected client module. While future versions of Timesheet will support alternate encoding methods, Timesheet supports only one encoding method: base64. More information on the base64 encoding method can be found at the following URL: http://info.internet.isi.edu/in-notes/rfc/files/rfc1421.txt
     
Outgoing mail user agent Varies (text) This option allows you to specify which mail client is shown as the sender of outbound Disconnected Client forms emails. The default value is Journyx Disconnected Client Mailer
     
Disconnected Client Mail Receiving Settings    
Option Value Result
Incoming mail server type Server Type This option allows you to specify which type of incoming mail server Timesheet will use to receive incoming disconnected client emails. The two options are POP & IMAP
     
Incoming mail account name Varies (text) This option allows you to specify the name for the incoming mail account that Timesheet will use to receive incoming disconnected client emails. You may change modify this text as required by your organization. The default text for this field is: discon
     
Incoming mail account password Varies (text) This option allows you to specify the password for the incoming mail account that Timesheet will use to receive incoming disconnected client emails. You may change modify this text as required by your organization. The default text for this field is: discon1
     
Incoming mail server name Varies (text) This option allows you to specify the name of the incoming (POP or IMAP) mail server that Timesheet will use when receiving emails related to the disconnected client module. You may modify this text as required by your organization. The default value for this field is: mail
     
Incoming mail port Varies (port number) This option allows you to specify the port used by the incoming (POP or IMAP) mail server that Timesheet will use when receiving emails related to the disconnected client module. You may modify this text as required by your organization. The standard port for a POP server is 110. The standard port for an IMAP server is 143. The default value for this field is: 143
     
Incoming mail folder Varies (text/path) This option, required for IMAP servers only, allows you to specify the mail folder where Timesheet will look for incoming emails related to the disconnected client module. You may modify this text as required by your organization. The default value for this field is: INBOX

Disconnected Client Advanced Preferences

Disconnected Client User Visible Text Settings    
Option Value Result
Request Submit button text Varies (text) This option allows you to specify the text that will appear within the button that users click to request Disconnected Client forms. You may modify this text as required by your organization. The default value for this field is: Request Forms
     
Retire requests button text Varies (text) This option allows you to specify the text that will appear within the button that users click to retire Disconnected Client forms. You may modify this text as required by your organization. The default value for this field is: Retire these DC requests
     
Instructions that appear at the top of each DC form Varies (text) This option allows you to specify the text that will appear at the top of each Disconnected Client form. You may modify this text as required by your organization. The default value for this field is: Journyx Time Disconnected Client.
     
Text to show in front of Approval checkbox Varies (text) This option allows you to specify the text that will appear at the to the left of the approval submission checkbox on each Disconnected Client form. You may modify this text as required by your organization. The default value for this field is: Submit this form for approval:
Time format specifier Time String This option allows you to specify the format that Timesheet will use for storing the times associated with each Disconnected Client form. You may modify this format as required by your organization. The default value for this field is: %m/%d/%Y %H:%M:%S. These characters translate as follows:
  • %m = month
  • %d = day
  • %Y = year
  • %H = hours
  • %M = minutes
  • %S = seconds
The percentage and colon characters are simply used to delimit the time and date strings. Therefore, to change the general time format specifier to HH:MM Year/Month/Day, you would change this option to the following: %H:%M %Y/%m/%d
     
Disconnected Client Advanced Settings    
Option Value Result
Expire requests this many days after the final period Varies (number) This option allows you specify the number of days that forms remain valid. You may modify this time period as required by your organization. The default number of days for this option is: 28
     
Process at most this many mail messages per check Varies (number) This option allows you to specify a maximum number of Disconnected Client forms that Timesheet will process at any given mail check. You may modify this number as required by your organization. The default maximum for this option is: 10
     
Max number of time periods in advance that user can select Varies (number) This option allows you to control how far in advance users can request Disconnected Client forms. This option is based on the time period assigned to the user in question. Therefore, if your organization uses several radically different time periods, you may need to consider this option carefully to ensure that users who have longer time periods do not have access to forms that are multiple months out. You may modify this time period as required by your organization. The default number of days for this option is: 8
     
Number of entry slots on DC Timesheet Varies (number) This option allows you to specify the number of blank rows that will be available for time entry on each Disconnected Client Time Entry form. You may modify this number as required by your organization. The default number of lines for this option is: 8
     
Number of entry slots on DC Expense sheet Varies (number) This option allows you to specify the number of blank rows that will be available for expense entry on each Disconnected Client Expense Entry form. You may modify this number as required by your organization. The default number of lines for this option is: 8
     
Number of entry slots on DC Project sheet Varies (number) This option allows you to specify the number of blank rows that will be available for project creation on each Disconnected Client Project form. You may modify this number as required by your organization. The default number of lines for this option is: 11
     
Number of entry slots on DC Mileage sheet Varies (number) This option allows you to specify the number of blank rows that will be available for mileage entry on each Disconnected Client mileage Entry form. You may modify this number as required by your organization. The default number of lines for this option is: 8

Time Period Adjustment


Each new installation of Timesheet assigned each user the default Time Period (timesheet), that is comprised of seven (7) days and runs from Sunday through Saturday. If your organization will be using one or more different Time Periods, you will need to assign these periods to the users who will be affected. Time Period Adjustment is available from the main admin screen, under the Application Settings heading. Clicking on this link will take you to the Timesheet Assignment Search screen. Please note: Journyx strongly recommends that you backup your database before proceeding with Time Period reassignment. Instructions for how to backup your database are available from the Journyx web site at the following URL: http://www.journyx.com/jwtfaq.html#backup

Time Period Assignment Search Screen

The first step in assigning/reassigning time periods (timesheets) to your users is to search for the user(s) to be modified. This screen allows you to search for users in one of three ways: Once you have entered your search criteria, click the Search button. Timesheet will then display the Timesheet Assignment Screen.

Timesheet Assignment Screen

After you have performed your search, you should select the user(s) you need to modify by clicking the select box to the left of their names. Then choose the new Time Period to assign to each of the selected users. You will also need to indicate whether this change should be made for the future only or if this change should apply to the entire history for this user. Once you have chosen the users to be modified, indicated which new time period you wish to use, and selected the method of applying this change, click the Assign To Users button. Timesheet will display a popup message advising you to backup your database before proceeding and asking you to confirm that you are ready to proceed. If you are ready, click OK in this popup window. Timesheet will perform the adjustments to the user(s) time periods and the Time Period Assignment screen will be displayed with a green text confirming that the changes have been made.

Accruals

Journyx Timesheet offers a powerful Accruals monitoring system that can be configured to monitor each user's use of sick time, vacation, and any other type of time your organization needs to control. To enter the Accruals control set, the Admin should click on the Accruals link from the main admin page.

Setting Users Accruals

To implement the Accruals feature in Timesheet, the Admin must assign the necessary accrual totals to each user. When you enter the accruals management portion of Timesheet, a complete list of all users existing in Timesheet is displayed. Simply click on of the user names to begin the process of establishing accrual totals for a user. The list below details the accrual assignment process: Please note:Accruals assigned to a user, including the remaining hours for each accrual, appear on his Time Entry Screen for reference.

Once an accrual has been created, the Create User Accruals Screen will refresh, displaying a green text message confirming the creation of a new accrual. Created accruals for an user appear on the Create User Accruals Screen, where they can be deleted if changes are required. Please Note:At this time, Accrual totals cannot be modified directly from this screen. If you need to make changes to a users' accrual totals, you will need to delete that total and set a new one.
To delete an accrual:

Additional help on the accruals portion of Timesheet can be found in the online help documentation available within Timesheet.

Approvals

Timesheet can allow for a complex and robust Timesheet approval process. The installing Admin should consider the approval process that will be required by his organization before beginning to establish a User base or implementing Timesheet.

Creating New Approver Templates

To create the necessary approver templates to be assigned to users, the admin should first create any users (Managers, Project Managers and Admins) who will serve as approvers for timesheets. Next, the admin should enter the Create Approval Templates Screen from the main admin screen via the Create Approver Templates link.

Create Approval Templates Screen
This screen provides the admin with all the necessary tool for the creation of new Approver Templates. The admin should name the new template and specify the number of levels of approval that this template specifies. The admin should then choose a primary and a backup approver for each level of approval from the dropdown menus provide at the top of this screen. Finally, this screen allows parameters for email notifications to be set up for the template that is being created. The admin should select any and all email notification parameters that are desired at this time. Below is a list of the possible parameters and information on what they mean.

Notify users when timesheet is rejected? Selecting "yes" for this field will send the submitting user an email to notify him that his timesheet has been rejected if it has been rejected.
Notify users when a timesheet has completed the approval cycle? Selecting "yes" for this field will send the submitting user an email notifying him that his timesheet has successfully completed the approval process once the final approval has been given.
Notify approver when a timesheet has been submitted for their approval? Selecting "yes" for this field will send an email notification to each level's primary approver that a timesheet has been submitted for their approval.
Notify users X days before a timesheet is due to be submitted. Selecting "yes" for this field will send an email to notify users that they have X days remaining before timesheets must be submitted.

Additionally, the admin must select a number of days between 0 and 7 that this email notification will go out before the due date.
Notify users X days after a timeperiod if the timesheet is not yet submitted. Selecting "yes" for this fields will send a reminder email to users X days after the due date for timesheet submission if they have a timesheet that has not been submitted for the period in question.

Additionally, the admin must select a number of days between 0 and 7 that this email notification will go out after the due date.
Notify approver X days after a timeperiod if the timesheet is not yet submitted. Selecting "yes" for this field will send an email to the approver for each level X days after the due date for timesheet submission to inform them that a user has not yet submitted a timesheet for approval.

Additionally, the admin must select a number of days between 0 and 7 that this email notification will go out after the due date.
Notify backup approver X days after a timeperiod if the timesheet is submitted, but is not yet approved. Selecting "yes" for this field will send an email to the backup approver for each level that they have a timesheet that may need their attention due to lack of response from the primary approver X days from the submission of a timesheet.

Additionally, the admin must select a number of days between 0 and 7 that this email notification will go out after the due date.

Once all desired email parameters have been entered, the admin should click the Create button. The screen will refresh and display a green text message confirming that the new approver template has been created. The newly created template will now be available for assignment to new users in the approver template dropdown in the User Creation and Modification Screen.

Modifying and Deleting Approver Templates

It may prove necessary at times to make changes to or even delete a specific approver template, such as if an approver leaves the organization or email notification needs to be redefined. To modify approver templates, the admin should enter the Modify/Delete Templates screen via the Modify Templates link from the main admin screen.

Modify/Delete Templates Screen
This screen allows an Admin to modify or delete an existing approver template.
To delete a template, the Admin should simply select that template from the list of currently existing templates and click the delete button. Please Note: At this time, deleting a template does not change the current approvers for users who were assigned that template. Users who would be affected by this change will need to be modified directly to put this change into effect.
To modify a template, the Admin should select the template that needs changes and click the modify button. The admin will then be taken to the Modify Template screen, which is the same as the Create Template screen, discussed above. Once the desired changes have been made, the screen will refresh display a green text message confirming that the new approver template has been modified. This message will also indicate the number of users who have been affected by this change.

Assigning an Approver Template to a User

Timesheet provides two unique way to assign approval templates to users. The primary method is to choose a template for each user as he is created, as discussed under Creating New Users, above. In the event that templates were not assigned at the time of user creation, or if template reassignment becomes necessary, the Admin can access the Template Reassignment Screen from the main admin screen via the Template Reassignment link. This link will take the Admin to the Template Reassignment Search Screen, where he can enter the name (or part of a name) of an employee to reassign approval templates to. After the search has completed, the admin will be taken to the actual reassignment page. Here, the admin can select the user(s) to reassign and may then select the template to be used. The Admin should select any users to be reassigned, select the template to be used, and click the use template button. The screen will refresh and display a green text message confirming that the template has been assigned. Optionally, this screen can be used to create a new template if a suitable one does not currently exist. Please Note: If you are using this screen to create a new template, you must also select at least one user for that template to be assigned to or Timesheet will not create the new template. The admin should select the users to be reassigned and then enter the parameters for the new template and then click the create template button. The screen will refresh and display a green text message confirming that the new template has been created and assigned.
Expenses
The Disconnected Client Expense Entry Form appears quite similar to the standard online Timesheet expense entry screen. This form remains true to the user's time period and will display only those projects, expense codes, sources and currencies that the requesting user is allowed to see based upon group membership. The process of entering expense into this form follows standard expense entry procedures exactly.

Any expense entries that were in place for the expense period that is shown by this form are displayed when this form is viewed. Therefore, if forms are requested at some point during a time period, the expenses already logged is not lost. It will be logged in Timesheet when the entire form is submitted.

The process of expense entry for the Disconnected Client expense Entry Form is exactly the same as the process that the user would follow for entering expense when using the standard online Timesheet.

Once expense entries have been made for this open session, the user should simply click the Save Work In Progress button at the bottom of this form. Clicking this button saves all expense entries and stores them locally in a cookie that will continue to hold this form's data until the form is submitted. Users do not need to be connected to the internet to save expense entries. After clicking the Save Work In Progress button, the Disconnected Client will display a popup window confirming the data as saved.

Once all expense entry has been completed for the time period covered by this form and the user is certain that no changes will need to be made, the user should connect to the internet and click the Email Completed Timesheet button at the bottom of this form. The Disconnected Client will then prepare to send the form back to the main Timesheet installation. The Disconnected Client will display a popup window asking the user to confirm that they wish to submit this form. The user may confirm this transmission by clicking the OK button in this window. Additionally, most web browsers will display a second message asking the user to confirm that they wish to submit a form via email. After confirming the transmission of this form, the Disconnected Client will submit the expenses contained in this form to Timesheet, which will then record this expense in the expense entry screen for this user for the appropriate time period.

If a user attempts to submit an offline expense form after it has already been submitted, the Disconnected Client module will display a popup window reminding him that the form in question has already been submitted.

Please Note: Despite the warning provided by Timesheet when a user attempts to submit an already submitted offline form, users can submit these forms multiple times. Multiple submissions will result in doubled records for time, mileage or expense entries. Multiple submissions of project forms will not cause any errors. Please stress the importance of proper form submission practices to all users who will be working with the Disconnected Client module.

Projects
The Disconnected Client Project Creation Form appears quite similar to the standard online Timesheet project creation screen. The process of creating projects using this form follows standard online project creation procedures exactly.

The existing viewable project hierarchy is displayed at the top of this form, providing users with a complete picture of the existing project tree structure. This view is limited to the projects that are viewable by this user based on group membership.

Please Note: Projects created using the offline project creation form will be available for time, mileage and expense tracking immediately, including use by the creating user in his open offline time, mileage and expense forms. However, these projects will not appear as part of the project hierarchy in the currently active project creation form. Further, these projects will not be available in your organization's online Timesheet installation until this project creation form has been submitted and processed. Finally, these projects will not appear in any other users currently open offline forms. These projects will be available to other users only after this project creation form has been submitted and processed by Timesheet.

Once all offline project creation has been completed and the user is certain that no further projects will need to be created, the user should connect to the internet and click the Submit New Projects Email button at the bottom of this form. The Disconnected Client will then prepare to send the form back to the main Timesheet installation. The Disconnected Client will display a popup window asking the user to confirm that they wish to submit this form. The user may confirm this transmission by clicking the OK button in this window. Additionally, most web browsers will display a second message asking the user to confirm that they wish to submit a form via email. After confirming the transmission of this form, the Disconnected Client will submit the projects contained in this form to Timesheet, which will then record these projects in the projects screen of the online Timesheet installation.

If a user attempts to submit an offline project creation form after it has already been submitted, the Disconnected Client module will display a popup window reminding him that the form in question has already been submitted.

Please Note: Despite the warning provided by Timesheet when a user attempts to submit an already submitted offline form, users can submit these forms multiple times. Multiple submissions will result in faulty records. Please stress the importance of proper form submission practices to all users who will be working with the Disconnected Client module.

Expense Tracking In Timesheet 4.5


Journyx Timesheet v4.5 includes powerful tools for expense tracking, approvals and reporting. . Before users begin tracking Expenses, the admin should configure the Currency Conversion Table so that appropriate expense calculations can be made.

Currency Conversion settings, Expenses Entry screens and Expenses Entry Columns Management, Expenses entry and the Expenses Approvals process are all covered in this section.

Currency Conversion Table

Before users begin tracking expenses, the Timesheet administrator should configure the Currency Conversion Table to reflect the actual Currency rates.

Currency Conversion Rates

Expense reporting is dependent upon the existence of Currency Rate Conversions. These conversions are used to convert entered expense amounts into expenses that can be included in expense reports by the Timesheet reporting engine. Each of these Currency Each rate conversions consist of:

The Currency Conversion Maintenance Screen

Currency Conversion Rate configuration is accessed via the Currency Conversion Table link located under the Conversion Tables Maintenance on the main admin screen. Clicking this link will display the Expenses Conversion Maintenance screen, which will be used for the remainder of this process.

The Currency Conversion Maintenance screen is used to:

Each of these functions is described in detail below.

Current Currency Conversion Rates

The top of the Currency Conversion Maintenance screen displays any currently active conversion rates. Each unique combination of 'from' and 'to' currencies can have only one active rate for any time period, i.e., while you can have two concurrent rates for US Dollars if one is for French Francs and on is for Japanese Yen, you cannot have two concurrent rate for US Dollars if both are for the same currency.

The controls available in the Current Conversion Rates portion of this screen are:

New Currency Conversion Rates

The middle portion of the Currency Conversion Maintenance screen provides access to the tools needed to institute new currency conversion rates. Up to three currency conversion rates may be created at one time. To create a new conversion rate:
  1. Select the 'from' currency for the new conversion rate
    The available currencies appear in the drop down menu located under the Convert From Currency column.
  2. Select the 'to' currency for the new conversion rate
    The available currencies appear in the drop down menu located under the Convert From Currency column.
  3. Enter the numerical value for this rate
    The numerical value for the rate in question must be a positive integer. Remember, this rate will determine the exchange rate from the selected 'from' currency to the selected 'to' currency.
  4. Enter the effective start date for this currency conversion rate
    You may enter the effective start date manually, in YYYYMMDD format or you may use the calendar button to select a date from a popup calendar window. If this field is left blank, Timesheet will set today's date as the default effective start date.
  5. Enter the effective end date for this currency conversion rate
    You may enter the effective end date manually, in YYYYMMDD format or you may use the calendar button to select a date from a popup calendar window. If this field is left blank, Timesheet will assume the effective end date to be open and this conversion rate will remain in effect until it is manually closed.
  6. Click the Create Rates button
    Timesheet will refresh the Currency Conversion Maintenance screen and the newly created rate(s) will be displayed in the list of existing currency conversion rates that is located at the top of this screen.

Past Conversion Rates

The bottom portion of the Currency Conversion Maintenance screen provides an interface that allows you to search for history on previous currency conversion rates. These searches are based upon 'from' and 'to' currencies combinations and will return history on only one particular combination at any given time. To search for previous conversion rates:
  1. Select a 'from' currency for this search
  2. Select a 'to' currency for this search
  3. Click the Search button
Timesheet will display the Currency Conversion Maintenance Search Results Screen. This screen will list each previous rate for the 'from' currency/'to' currency combination selected during the search setup. Once you have viewed the desired data, you may click the Return To Currency Conversion Maintenance Screen link at the bottom of this screen to return to the main currency conversion functions.

Expense Entry Screens

Journyx Timesheet v4.5 provides admins with the ability to create, modify and delete Expense Entry Screens that users will access to track their expenses. By default, seven Expense Entry Screens are available within Timesheet; however, there is no limit to the number of screens that may be created. The default Expense Entry Screens are:
  1. Multi-currency
  2. Project Only CA$
  3. Project Only Deutsche Mark
  4. Project Only US$
  5. Project and Expense CA$
  6. Project and Expense Deutsche Mark
  7. Project and Expense US$
Each of these screens can be used as shipped or modified to reflect your organization's needs. The differences between the default Expense Entry Screens are simply a matter of which columns are hidden and which default values are assigned to each of those hidden columns.

The toolset for creation, modification and deletion of Expense Entry Screens is available from the Global Modification/Deletion of Expense Screens screen, which is accessed via the Expense Entry Screens link located under the Users' Entry Interface Management header on the main admin screen. This screen is used for these three functions, each of which is outlined below.

Creating An Expense Entry Screen

To create a new Expense Entry Screen:
  1. Click the Create A New Expense Screen Button
    Timesheet will display the Create/Modify Custom Expense Screen, which will be used for the remainder of this process.
  2. Enter a name for the new Expense entry screen
    Choose a name that will help you identify this screen. Expense Entry Screen names are limited to 64 characters.
  3. Modify the column names
    Timesheet allows you to modify the names of the columns that will be displayed on this Expense Entry Screen. Please Note: Changing the name of a column when creating or modifying a Expense Entry Screen changes the name of that column throughout Timesheet. While this is normally not an important issue, it is critical to note that it is possible to modify the Project column's name in this screen. Modification of the projects column here will have a global impact. Therefore, Journyx recommends that the project column not be renamed via this screen.
  4. Establish the column display order
    Timesheet allows you to change the order in which the dropdown menu columns appear on each Expense Entry Screen. Up to five columns can be displayed on each screen. By default, all columns are set to 'unused' when a new screen is created. Select the desired placement for each column you wish to be displayed on this Expense Entry Screen. Columns can be hidden by leaving their display order set to 'unused.' Unused columns must have a default value established. See below for information on setting default column values. Please Note: Each placement (first, second, etc.) should only be used once for each given screen.
  5. Select the default values for any unused columns
    Any unused columns must have default values established. Additionally, all users who will be using a Expense Entry Screen with hidden columns must have access (via group membership) to every default value that will be used. Finally, setting default values for non-hidden columns has no effect, i.e., setting the default value for the projects column will not affect the order in which values for that column are listed if that column is displayed.
  6. Click the Modify button
    Timesheet will display the Global Modification/Deletion of Expense Screens screen, including a green text message confirming that the Expense Entry Screen in question has been modified.

Modifying Expense Entry Screens

Expense Entry Screens can be modified to account for changes in the way your organization seeks to track expense information. Every option listed above, under Creating An Expense Entry Screen, can be modified as needed. To modify an existing Expense Entry Screen:
  1. Select the Expense Entry Screen to modify
  2. Click the Modify Button
    Timesheet will display the Create/Modify Custom Expense Screen, which will be used for the remainder of this process.
  3. Modify the Attributes of the Expense Entry Screen in question
    Again, each of the attributes listed above, under Creating An Expense Entry Screen, can be modified as needed.
  4. Click the Modify To Values Above button
    Timesheet will display the Global Modification/Deletion of Expense Screens screen, including a green text message confirming that the Expense Entry Screen in question has been modified.

Deleting A Expense Entry Screen

If you need to remove a Expense Entry Screen from Timesheet, simply select the screen in question and click the delete button on the Global Modification/Deletion of Expense Screens screen. Timesheet will refresh the Global Modification/Deletion of Expense Screens screen, displaying a green text message confirming the deletion of the Expense Entry Screen in question.

Expense Entry Screen Columns

Expense Entry Screens in Timesheet v4.5 use three columns that are unique to the Expense entry process: These columns come with certain default values and more can be created to meet your organization's needs. Each of these three columns is discussed in detail below.

Expense Code

Expense Codes are used in the Expense Entry Process to indicate what the expense was actually for. The controls needed to create, modify and delete expense codes are contained within the Global Expense Code Entry and Modification screen, which can be accessed via the Expense Code link under the Expense Entry Columns Management header on the main admin screen. This screen will be used for all functions associated with Expense Code management.

The default expense codes that ship with Timesheet v4.5 are:

Creating An Expense Code
Timesheet allows you to create new expense codes for use by your organization. The interface for creating new reasons is found on the bottom half of the Global Expense Code Entry and Modification screen. The process of creating a new expense code is outlined below:
  1. Enter a name for the new expense code
    The name for each expense code should be a simple and descriptive term that users will be able to understand easily. This field is limited to 60 characters.
  2. Enter a description for the new expense code
    The description for each expense code can be a more in depth explanation of that expense code. This field is limited to 252 characters.
  3. Choose which currently existing Groups should have access to this expense code.
    You may select one or more existing groups to assign the new expense code to automatically. Each new expense code must be assigned manually, through group modification, to any groups not selected during expense code creation.
  4. Indicate automatic assignment to new groups
    Click the checkbox for this option if the new expense code is one that will be used commonly throughout your organization. This option will cause the new expense code to be included automatically in all newly created groups, thereby eliminating the need to add it to new groups manually.
  5. Click the Create New Expense Code(s) button
    Timesheet will refresh the Global Expense Code Entry and Modification screen, displaying a green text message confirming the creation of the new expense code.
Modifying An Expense Code
Timesheet allows you to modify individual existing expense codes to change certain aspects of those expense codes. The modifiable parameters for a reason are: To modify an existing expense code:
  1. Select the expense code(s) in question on the Global Expense Code Entry and Modification screen
  2. Click the Modify button
    Timesheet will display the Global Expense Code Modification screen, which will be used for the remainder of this process.
  3. Modify the description, status, group membership and auto add characteristic of the expense code(s) in question
    Description, Group Membership and Auto Add are discussed above, under expense code creation. Status is a characteristic that determines how Timesheet handles each expense code. There are three status options:
    • Loggable and Reportable
      Loggable and Reportable status represents full functionality for a given expense code. Each expense code with Loggable and Reportable as its status will be available for users to select during Expense Entry and will also be displayed within reports.
    • Reportable Only
      Reportable Only status represents partial functionality for a given expense code. Each expense code with Reportable Only as its status will not be available for users to select during Expense Entry but will be displayed within reports. This status is best used for expense codes that have been discontinued but that still need to be available for historical reporting purposes.
    • Hidden
      Hidden status represents zero functionality for a given expense code. Each expense code with Hidden as its status will not be available for users to select during Expense Entry, nor will records associated with that expense code be displayed within reports. For this reason, Journyx recommends setting discontinued expense codes to Loggable and Reportable rather than Hidden.
  4. Click the perform modifications button
    Timesheet will display the Global Expense Code Entry and Modification screen, displaying a green text message confirming the modification of the expense code(s) in question.
Deleting An Expense Code
Timesheet allows you to delete expense codes if they no longer serve the needs of your organization; however, Journyx strongly recommends modifying these expense codes to have a status of Hidden or Reportable Only rather than deleting. While deleting will not cause database errors, it is non-reversible and may cause unforseen issues in the future. The interface for deleting expense codes is located on the Global Expense Code Entry and Modification screen. The process of deleting expense codes is outlined below:
  1. Select the expense code(s) to be deleted
  2. Click the Delete button
    Timesheet will display a popup window asking you to confirm the deletion of the selected expense codes. If you are certain you wish to delete these expense codes, click OK in this popup window. Timesheet will refresh the Global Expense Code Entry and Modification screen, displaying a green text message confirming the deletion of the expense code(s) in question.
Please Note: Records associated with any expense codes that have been deleted will still be available for reporting; however, the expense code associated with these records will be listed as 'none.'

Currency

Currencies are used in the Expenses Entry Process to indicate the actual form of payment used for expenses. The controls needed to create, modify and delete currencies are contained within the Global Currency Entry and Modification screen, which can be accessed via the Currency link under the Expense Entry Columns Management header on the main admin screen. This screen will be used for all functions associated with currency management.

Timesheet v4.5 ships with thirteen default currencies:

  1. The US Dollar (US$)
  2. The Deutsche Mark (DM)
  3. The Canadian Dollar (CA$)
  4. The French Franc (F)
  5. The Australian Dollar (A$)
  6. The Brazilian Real (R$)
  7. The Euro (EUR)
  8. The Peso (MEX$)
  9. The Japanese Yen (¥)
  10. The Russian Ruble (R)
  11. The Spanish Peseta (Ptas)
  12. The Swiss Franc (SwF)
  13. The UK Pound (£)
Creating A Currency
Timesheet allows you to create new currencies for use by your organization. The interface for creating new currencies is found on the bottom half of the Global Currency Entry and Modification screen. The process of creating a new currency is outlined below:
  1. Enter a name for the new currency
    The name for each currency should be a simple and descriptive term that users will be able to understand easily. This field is limited to 60 characters.
  2. Enter a description for the new currency
    The description for each currency can be a more in depth explanation of that currency. This field is limited to 252 characters.
  3. Choose which currently existing Groups should have access to this currency.
    You may select one or more existing groups to assign the new currency to automatically. Each new currency must be assigned manually, through group modification, to any groups not selected during currency creation.
  4. Indicate automatic assignment to new groups
    Click the checkbox for this option if the new currency is one that will be used commonly throughout your organization. This option will cause the new currency to be included automatically in all newly created groups, thereby eliminating the need to add it to new groups manually.
  5. Click the Create New Currency(s) button
    Timesheet will refresh the Global Currency Entry and Modification screen, displaying a green text message confirming the creation of the new currency.
Modifying A Currency
Timesheet allows you to modify individual existing currencies to change certain aspects of those currencies. The modifiable parameters for a currency are: To modify an existing currency:
  1. Select the currency(s) in question on the Global Currency Entry and Modification screen
  2. Click the Modify button
    Timesheet will display the Global Currency Modification screen, which will be used for the remainder of this process.
  3. Modify the description, status, group membership and auto add characteristic of the Currency(s) in question
    Description, Group Membership and Auto Add are discussed above, under currency creation. Status is a characteristic that determines how Timesheet handles each currency. There are three status options:
    • Loggable and Reportable
      Loggable and Reportable status represents full functionality for a given currency. Each currency with Loggable and Reportable as its status will be available for users to select during Expense Entry and will also be displayed within reports.
    • Reportable Only
      Reportable Only status represents partial functionality for a given currency. Each currency with Reportable Only as its status will not be available for users to select during Expense Entry but will be displayed within reports. This status is best used for currencies that have been discontinued but that still need to be avialble for historical reporting purposes.
    • Hidden
      Hidden status represents zero functionality for a given currency. Each currency with Hidden as its status will not be available for users to select during Expense Entry, nor will records associated with that currency be displayed within reports. For this reason, Journyx recommends setting discontinued currencies to Loggable and Reportable rather than Hidden.
  4. Click the perform modifications button
    Timesheet will display the Global Currency Entry and Modification screen, displaying a green text message confirming the modification of the currency(s) in question.
Deleting A Currency
Timesheet allows you to delete currencies if they no longer serve the needs of your organization; however, Journyx strongly recommends modifying these currencies to have a status of Hidden or Reportable Only rather than deleting. While deleting will not cause database errors, it is non-reversible and may cause unforseen issues in the future. The interface for deleting currencies is located on the Global Currency Entry and Modification screen. The process of deleting currencies is outlined below:
  1. Select the currency(s) to be deleted
  2. Click the Delete button
    Timesheet will display a popup window asking you to confirm the deletion of the selected currencies. If you are certain you wish to delete these currencies, click OK in this popup window. Timesheet will refresh the Global Currency Entry and Modification screen, displaying a green text message confirming the deletion of the currency(s) in question.
Please Note: Records associated with any currencies that have been deleted will still be available for reporting; however, the currency associated with these records will be listed as 'none.'

Source

Sources are used in the Expense Entry Process to provide an explanation for the cause of the expense. The controls needed to create, modify and delete sources are contained within the Global Source Entry and Modification screen, which can be accessed via the source link under the Expenses Entry Columns Management header on the main admin screen. This screen will be used for all functions associated with source management.

The default sources that ship with Timesheet v4.5 are:

Creating A Source
Timesheet allows you to create new sources for use by your organization. The interface for creating new sources is found on the bottom half of the Global Source Entry and Modification screen. The process of creating a new source is outlined below:
  1. Enter a name for the new source
    The name for each source should be a simple and descriptive term that users will be able to understand easily. This field is limited to 60 characters.
  2. Enter a description for the new source
    The description for each source can be a more in depth explanation of that source. This field is limited to 252 characters.
  3. Choose which currently existing Groups should have access to this source.
    You may select one or more existing groups to assign the new source to automatically. Each new source must be assigned manually, through group modification, to any groups not selected during source creation.
  4. Indicate automatic assignment to new groups
    Click the checkbox for this option if the new source is one that will be used commonly throughout your organization. This option will cause the new source to be included automatically in all newly created groups, thereby eliminating the need to add it to new groups manually.
  5. Click the Create New source(s) button
    Timesheet will refresh the Global Source Entry and Modification screen, displaying a green text message confirming the creation of the new source.
Modifying A source
Timesheet allows you to modify individual existing sources to change certain aspects of those sources. The modifiable parameters for a source are: To modify an existing source:
  1. Select the source(s) in question on the Global Source Entry and Modification screen
  2. Click the Modify button
    Timesheet will display the Global Source Modification screen, which will be used for the remainder of this process.
  3. Modify the description, status, group membership and auto add characteristic of the source(s) in question
    Description, Group Membership and Auto Add are discussed above, under source creation. Status is a characteristic that determines how Timesheet handles each source. There are three status options:
    • Loggable and Reportable
      Loggable and Reportable status represents full functionality for a given source. Each source with Loggable and Reportable as its status will be available for users to select during Expense Entry and will also be displayed within reports.
    • Reportable Only
      Reportable Only status represents partial functionality for a given source. Each source with Reportable Only as its status will not be available for users to select during Expense Entry but will be displayed within reports. This status is best used for sources that have been discontinued but that still need to be avialble for historical reporting purposes.
    • Hidden
      Hidden status represents zero functionality for a given source. Each source with Hidden as its status will not be available for users to select during Expense Entry, nor will records associated with that source be displayed within reports. For this reason, Journyx recommends setting discontinued sources to Loggable and Reportable rather than Hidden.
  4. Click the perform modifications button
    Timesheet will display the Global Source Entry and Modification screen, displaying a green text message confirming the modification of the source(s) in question.
Deleting A Source
Timesheet allows you to delete sources if they no longer serve the needs of your organization; however, Journyx strongly recommends modifying these sources to have a status of Hidden or Reportable Only rather than deleting. While deleting will not cause database errors, it is non-reversible and may cause unforseen issues in the future. The interface for deleting sources is located on the Global Source Entry and Modification screen. The process of deleting sources is outlined below:
  1. Select the source(s) to be deleted
  2. Click the Delete button
    Timesheet will display a popup window asking you to confirm the deletion of the selected sources. If you are certain you wish to delete these sources, click OK in this popup window. Timesheet will refresh the Global Source Entry and Modification screen, displaying a green text message confirming the deletion of the source(s) in question.
Please Note: Records associated with any sources that have been deleted will still be available for reporting; however, the source associated with these records will be listed as 'none.'

Entering Expenses in Timesheet

The process of entering expenses into Timesheet is described below. For Expense Entry screens that have certain columns hidden, please disregard references to those hidden columns.
  1. Select the Project for this particular expense from the drop down menu containing Projects
  2. Select the Expense Code for this particular expense from the drop down menu containing Expense Codes
  3. Select the Source for this particular expense from the drop down menu containing Sources
  4. Select the Currency for this particular expense from the drop down menu containing Currencies
  5. Enter Comments relating to this expense, this is typically an identifer such as "Flight 123" or "Lunch with Joe and Jane"
  6. Enter the amount of the actual expense.
    Please Note: Timesheet currently supports expense amounts of up to 9 digits, including the decimal point. Therefore, Timesheet will allow amounts up to 999,999.99 for any particular line item if two decimal places are required.

Expense Approvals

Journyx Timesheet v4.5 allows you to implement a robust expense approval process to effectively manage expenditures across your organization. This approval process functions in very much the same fashion as the time and mileage approvals processes. Approval templates must be created and then assigned to the employees who will be tracking expenses. Once these templates have been assigned, users will be able to submit their expense entry forms for approval to the appropriate approvers with the click of a button. Additionally, automatic email notifications may be established to ensure proper communication regarding expense approvals. The Expense approvals process is described in detail below.

Expense Approval Templates

Before the expense approvals process can be implemented, expense approval templates must be created and assigned to users. The installing Admin should consider the approval process that will be required by his organization before beginning to establish a User base or implementing Timesheet.
Creating New Approver Templates
To create the necessary approver templates to be assigned to users, the admin should first create any users (Managers, Project Managers and Admins) who will serve as approvers for timesheets. Next, the admin should enter the Create Expense Approval Templates Screen from the main admin screen via the Create Expense Approver Templates link which is located under the Expense Approval Process Management header.

Create Expense Approval Templates Screen
This screen provides the admin with all the necessary tools for the creation of new Expense Approver Templates. The admin should name the new template and specify the number of levels of approval that this template specifies. The admin should then choose a primary and a backup approver for each level of approval from the dropdown menus provide at the top of this screen. Finally, this screen allows parameters for email notifications to be set up for the template that is being created. The admin should select any and all email notification parameters that are desired at this time. Below is a list of the possible parameters and information on what they mean.

Notify users when expensesheet is rejected? Selecting "yes" for this field will send the submitting user an email to notify him that his expensesheet has been rejected if it has been rejected.
Notify users when a expensesheet has completed the approval cycle? Selecting "yes" for this field will send the submitting user an email notifying him that his expensesheet has successfully completed the approval process once the final approval has been given.
Notify approver when a expensesheet has been submitted for their approval? Selecting "yes" for this field will send an email notification to each level's primary approver that a expensesheet has been submitted for their approval.
Notify users X days before a timesheet is due to be submitted. Selecting "yes" for this field will send an email to notify users that they have X days remaining before expensesheets must be submitted.

Additionally, the admin must select a number of days between 0 and 7 that this email notification will go out before the due date.
Notify users X days after a timeperiod if the expensesheet is not yet submitted. Selecting "yes" for this fields will send a reminder email to users X days after the due date for expensesheet submission if they have a expensesheet that has not been submitted for the period in question.

Additionally, the admin must select a number of days between 0 and 7 that this email notification will go out after the due date.
Notify approver X days after a timeperiod if the expensesheet is not yet submitted. Selecting "yes" for this field will send an email to the approver for each level X days after the due date for expensesheet submission to inform them that a user has not yet submitted a expensesheet for approval.

Additionally, the admin must select a number of days between 0 and 7 that this email notification will go out after the due date.
Notify backup approver X days after a timeperiod if the expensesheet is submitted, but is not yet approved. Selecting "yes" for this field will send an email to the backup approver for each level that they have a expensesheet that may need their attention due to lack of response from the primary approver X days from the submission of a expensesheet.

Additionally, the admin must select a number of days between 0 and 7 that this email notification will go out after the due date.

Once all desired email parameters have been entered, the admin should click the Create button. The screen will refresh and display a green text message confirming that the new approver template has been created. The newly created template will now be available for assignment to new users in the expense approver template dropdown in the User Creation and Modification Screen.

Modifying and Deleting Approver Templates
It may prove necessary at times to make changes to or even delete a specific approver template, such as if an approver leaves the organization or email notification needs to be redefined. To modify approver templates, the admin should enter the Modify/Delete Expense Templates screen via the Modify Expense Approver Templates link which is located under the Expense Approval Process Management header on the main admin screen.

Modify/Delete Expenses Templates Screen
This screen allows an Admin to modify or delete an existing expense approver template.
To delete a template, the Admin should simply select that template from the list of currently existing templates and click the delete button. Please Note: At this time, deleting a template does not change the current approvers for users who were assigned that template. Users who would be affected by this change will need to be modified directly to put this change into effect.
To modify a template, the Admin should select the template that needs changes and click the modify button. The admin will then be taken to the Modify Expense Template screen, which is the same as the Create Expenses Template screen, discussed above. Once the desired changes have been made, the screen will refresh display a green text message confirming that the Expenses approver template in question has been modified. This message will also indicate the number of users who have been affected by this change.

Assigning an Approver Template to a User
Timesheet provides two unique way to assign expense approval templates to users. The preferred method is to choose a template for each user as he is created, as discussed under Creating New Users, above. In the event that templates were not assigned at the time of user creation, or if template reassignment becomes necessary, the Admin can access the Expense Approval Template Reassignment Screen from the main admin screen via the Expense Template Reassignment link which is available under the Expense Approval Process Management header. This link will take the Admin to the Expense Template Reassignment Search Screen, where he can enter the name (or part of a name) of an employee to reassign Expense approval templates to. After the search has completed, the admin will be taken to the actual reassignment page. Here, the admin can select the user(s) to reassign and may then select the Expense template to be used. The Admin should select any users to be reassigned, select the template to be used, and click the use template button. The screen will refresh and display a green text message confirming that the template has been assigned. Optionally, this screen can be used to create a new template if a suitable one does not currently exist. Please Note: If you are using this screen to create a new template, you must also select at least one user for that template to be assigned to or Timesheet will not create the new template. The admin should select the users to be reassigned and then enter the parameters for the new template and then click the create template button. The screen will refresh and display a green text message confirming that the new template has been created and assigned.

Expense Approvals

Now that the approvals templates have been created and assigned to users, the Expense Approval process can be used to its full extent. Users will now see a Submit Expensesheet button on their Expense Entry Screens. This button should be clicked once a time period for Expense Entry has been completed or when Expense entry is otherwise complete for that period. Clicking this button begins the approval process by queueing the submitted Expensesheet for approval. Additionally, any automated email settings will now begin in regards to the submitted Expensesheet.

Approving Expensesheets
The Expense approval process depends on approvers to view and approve submitted expense sheets. Timesheet v4.5 supports two different types of approvers: regular approvers, consisting of manager and project manager and super approvers which is a role ability of administrators. These different types of approvers have slightly different methods of approving expenses.

Regular approvers have two links available under the Expense Approval Process Management header on their admin screen:

  1. Expensesheet Approval
    This link allows regular approvers to view a list of users who are in groups that the approver himself is in. The user list provides approvers with the ability to view open and submitted expensesheets for each user. Expensesheets that are open (i.e., not submitted for approval) can be viewed but not approved. Expensesheets that have been submitted may be approved via this user list, but the more common approach for regular approvers approving expensesheets is to view Expensesheets Awaiting My Approval.
  2. Expensesheets Awaiting My Approval
    This link will only appear active if at least one expensesheet that the approver is responsible for has been submitted for approval. If this link is active, a number in parenthesis to the right of this link will be displayed. This number indicates the number of submitted expensesheets that are awaiting the approval of this approver. Clicking on this link will display the Expensesheet Approval screen, which is discussed below.

Superapprovers use the same general procedures for expense approval as regular approvers; however, their views are not limited by the group structure; therefore, a superapprover can see all users with open expensesheets when they take the Expensesheet Approval process as discussed above. Further, superapprovers will have all submitted expensesheets included in the count of Expensesheets Awaiting My Approval. In short, a superapprover has access to approve all submitted expensesheets regardless of group membership or approvals process design.

The Expensesheet Approval Screen
This screen provides approvers with the ability to approve or reject submitted expensesheets. Each submitted expensesheet that is the responsibility of the approver who is viewing this screen is displayed in a list at the top of this screen.

To approve these expensesheets, the approver should click the checkbox to the right of each available expensesheet , or click the Select All checkbox at the bottom of the list, and click the Approve button at the bottom of this screen. Timesheet will the display a screen containing a green text message confirming that the selected expensesheets were confirmed.

To reject any of these expensesheets, the approver should click the checkbox to the right of each available expensesheet , or click the Select All checkbox at the bottom of the list, enter a reason for the rejection and then click the Reject button at the bottom of this screen. Timesheet will the display a screen containing a green text message confirming that the selected expensesheets were rejected. Please Note: A reason for rejection must be supplied. Otherwise, Timesheet will display an error message reminding you to supply a rejection reason and the rejection will not take place.

Groups

Journyx Timesheet makes use of complex group structures to organize data and control user access to specific projects, tasks, pay types, bill types, time entry screens, and many other items within Timesheet. Groups may be thought of as sets that contain one of more users and certain items that those users can access. Each user can belong to one or more groups, and each other item can also be linked to one or more groups. Groups are the ultimate control device in Timesheet and as such require particular attention. In addition to groups that the admin creates to establish the order that his organization requires, Timesheet contains one particular group that is consistent across all installations - the All group, which is discussed below.

The All Group

Every installation of Timesheet contains a group named "All." This group contains every single item created within Timesheet. Every non-user item must exist in this group or it may become unusable. Users may be removed from the All group once they have been place into at least one other group. To facilitate these requirements, modification of the All group has been limited by default - without making a change to the Global Preferences of Timesheet (discussed below), only users may be removed from the All group. It is highly recommended that removing users from the All group be the only changes made to it under any circumstances.

Group Creation, Modification and Deletion

The Timesheet administrator must configure any groups that will be required by his organization to organize and maintain Timesheet to meet that organization's needs. After determining what groups will be needed, the Admin should create those groups in the Group Entry and Modification Screen which is available from the main admin screen via the Group link.

Creating Groups

The process of creating Groups is outlined below:

Modifying Groups

Once a group has been created, the Admin must modify that group to add all the users, projects, tasks, et. al., that it will contain. Please Note: A user will have access to any item that is in at least one of the same groups as he is. This rule applies to everything within an installation of Timesheet. The process of modifying groups is outlined below:

Deleting Groups

In the event that you need to delete an existing group in Timesheet, there are several factors that must be considered before proceeding. After consideration has been given to deleting a specific group, you may proceed with the actual process of deleting, described below:

For more information on using groups in Timesheet, please see the online help documentation.

Mileage Tracking In Timesheet 4.5


Journyx Timesheet v4.5 includes powerful tools for milage tracking, approvals and reporting. Mileage functions within Timesheet are closely related to the Expense Tracking processes and mileage expenses are reported along with other expenses in the reporting engine. Before users begin tracking mileage, the admin should configure the Mileage Conversion Table so that appropriate expense calculations can be made.

Mileage Conversion settings, Mileage Entry screens and Mileage Entry Columns Management, Mileage entry and the Mileage Approvals process are all covered in this section.

Mileage records are viewed alongside expense records in Timesheet's expense reports.

Mileage Conversion Table

Before users begin tracking mileage, the Timesheet administrator should configure the Mileage Conversion Table to reflect the actual mileage rates.

Mileage Conversion Rates

Mileage reporting is dependent upon the existence of Mileage Rate Conversions. These conversions are used to convert entered miles into expenses that can be included in expense reports by the Timesheet reporting engine. Each of these Mileage Each rate conversions consist of:

The Mileage Conversion Maintenance Screen

Mileage Conversion Rate configuration is accessed via the Mileage Conversion Table link located under the Conversion Tables Maintenance on the main admin screen. Clicking this link will display the Mileage Conversion Maintenance screen, which will be used for the remainder of this process.

The Mileage Conversion Maintenance screen is used to:

Each of these functions is described in detail below.

Current Mileage Conversion Rates

The top of the Mileage Conversion Maintenance screen displays any currently active conversion rates. Each unique combination of measurement and currency can have only one active rate for any time period, i.e., while you can have two concurrent rates for miles if one is for US$ and on is for DM, you cannot have two concurrent rate for miles if both are for the same currency.

The controls available in the Current Conversion Rates portion of this screen are:

New Mileage Conversion Rates

The middle portion of the Mileage Conversion Maintenance screen provides access to the tools needed to institute new mileage conversion rates. Up to three mileage conversion rates may be created at one time. To create a new conversion rate:
  1. Select the unit of measurement for the new conversion rate
    The available units of measurement appear in the drop down menu located under the Measurement column.
  2. Enter the numerical value for this rate
    The numerical value for the rate in question must be a positive integer. Remember, this rate will determine the amount of the selected currency (see below) that will be charged for each unit of measurement travelled.
  3. Select the currency to be used by this new conversion rate
    The available currencies appear in the drop down menu located under the Currency column.
  4. Enter the effective start date for this currency conversion rate
    You may enter the effective start date manually, in YYYYMMDD format or you may use the calendar button to select a date from a popup calendar window. If this field is left blank, Timesheet will set today's date as the default effective start date.
  5. Enter the effective end date for this currency conversion rate
    You may enter the effective end date manually, in YYYYMMDD format or you may use the calendar button to select a date from a popup calendar window. If this field is left blank, Timesheet will assume the effective end date to be open and this conversion rate will remain in effect until it is manually closed.
  6. Click the Create Rates button
    Timesheet will refresh the Mileage Conversion Maintenance screen and the newly created rate(s) will be displayed in the list of existing mileage conversion rates that is located at the top of this screen.

Past Conversion Rates

The bottom portion of the Mileage Conversion Maintenance screen provides an interface that allows you to search for history on previous mileage conversion rates. These searches are based upon measurement and currency combinations and will return history on only one particular combination at any given time. To search for previous conversion rates:
  1. Select a measurement for this search
  2. Select a currency for this search
  3. Click the Search button
Timesheet will display the Mileage Conversion Maintenance Search Results Screen. This screen will list each previous rate for the measurement/currency combination selected during the search setup. Once you have viewed the desired data, you may click the Return To Mileage Conversion Maintenance Screen link at the bottom of this screen to return to the main mileage conversion functions.

Mileage Entry Screens

Journyx Timesheet v4.5 provides admins with the ability to create, modify and delete Mileage Entry Screens that users will access to track their mileage. By default, only one Mileage Entry Screen is available within Timesheet; however, there is no limit to the number of screens that may be created. The toolset for creation, modification and deletion of Mileage Entry Screens is available from the Global Modification/Deletion of Mileage Screens screen, which is accessed via the Mileage Entry Screens link located under the Users' Entry Interface Management header on the main admin screen. This screen is used for these three functions, each of which is outlined below.

Creating A Mileage Entry Screen

To create a new Mileage Entry Screen:
  1. Click the Create A New Mileage Screen Button
    Timesheet will display the Create/Modify Custom Mileage Screen, which will be used for the remainder of this process.
  2. Enter a name for the new mileage entry screen
    Choose a name that will help you identify this screen. Mileage Entry Screen names are limited to 64 characters.
  3. Modify the column names
    Timesheet allows you to modify the names of the columns that will be displayed on this Mileage Entry Screen. Please Note: Changing the name of a column when creating or modifying a Mileage Entry Screen changes the name of that column throughout Timesheet. While this is normally not an important issue, it is critical to note that it is possible to modify the Project column's name in this screen. Modification of the projects column here will have a global impact. Therefore, Journyx recommends that the project column not be renamed via this screen.
  4. Establish the column display order
    Timesheet allows you to change the order in which the dropdown menu columns appear on each Mileage Entry Screen. Up to five columns can be displayed on each screen. By default, all columns are set to 'unused' when a new screen is created. Select the desired placement for each column you wish to be displayed on this Mileage Entry Screen. Columns can be hidden by leaving their display order set to 'unused.' Unused columns must have a default value established. See below for information on setting default column values. Please Note: Each placement (first, second, etc.) should only be used once for each given screen.
  5. Select the default values for any unused columns
    Any unused columns must have default values established. Additionally, all users who will be using a Mileage Entry Screen with hidden columns must have access (via group membership) to every default value that will be used. Finally, setting default values for non-hidden columns has no effect, i.e., setting the default value for the projects column will not affect the order in which values for that column are listed if that column is displayed.
  6. Click the Modify button
    Timesheet will display the Global Modification/Deletion of Mileage Screens screen, including a green text message confirming that the Mileage Entry Screen in question has been modified.

Modifying Mileage Entry Screens

Mileage Entry Screens can be modified to account for changes in the way your organization seeks to track mileage information. Every option listed above, under Creating A Mileage Entry Screen, can be modified as needed. To modify an existing Mileage Entry Screen:
  1. Select the Mileage Entry Screen to modify
  2. Click the Modify Button
    Timesheet will display the Create/Modify Custom Mileage Screen, which will be used for the remainder of this process.
  3. Modify the Attributes of the Mileage Entry Screen in question
    Again, each of the attributes listed above, under Creating A Mileage Entry Screen, can be modified as needed.
  4. Click the Modify To Values Above button
    Timesheet will display the Global Modification/Deletion of Mileage Screens screen, including a green text message confirming that the Mileage Entry Screen in question has been modified.

Deleting A Mileage Entry Screen

If you need to remove a Mileage Entry Screen from Timesheet, simply select the screen in question and click the delete button on the Global Modification/Deletion of Mileage Screens screen. Timesheet will refresh the Global Modification/Deletion of Mileage Screens screen, displaying a green text message confirming the deletion of the Mileage Entry Screen in question.

Mileage Entry Screen Columns

Mileage Entry Screens in Timesheet v4.5 use three columns that are unique to the mileage entry process: These columns come with certain default values and more can be created to meet your organization's needs. Each of these three columns is discussed in detail below.

Reason

Reasons are used in the Mileage Entry Process to provide an explanation for the distance travelled. The controls needed to create, modify and delete reasons are contained within the Global Reason Entry and Modification screen, which can be accessed via the Reason link under the Mileage Entry Columns Management header on the main admin screen. This screen will be used for all functions associated with Reason management.

The default reasons that ship with Timesheet v4.5 are:

Creating A Reason
Timesheet allows you to create new reasons for use by your organization. The interface for creating new reasons is found on the bottom half of the Global Reason Entry and Modification screen. The process of creating a new reason is outlined below:
  1. Enter a name for the new reason
    The name for each reason should be a simple and descriptive term that users will be able to understand easily. This field is limited to 60 characters.
  2. Enter a description for the new reason
    The description for each reason can be a more in depth explanation of that reason. This field is limited to 252 characters.
  3. Choose which currently existing Groups should have access to this reason.
    You may select one or more existing groups to assign the new reason to automatically. Each new reason must be assigned manually, through group modification, to any groups not selected during reason creation.
  4. Indicate automatic assignment to new groups
    Click the checkbox for this option if the new reason is one that will be used commonly throughout your organization. This option will cause the new reason to be included automatically in all newly created groups, thereby eliminating the need to add it to new groups manually.
  5. Click the Create New Reason(s) button
    Timesheet will refresh the Global Reason Entry and Modification screen, displaying a green text message confirming the creation of the new reason.
Modifying A Reason
Timesheet allows you to modify individual existing reasons to change certain aspects of those reasons. The modifiable parameters for a reason are: To modify an existing reason:
  1. Select the reason(s) in question on the Global Reason Entry and Modification screen
  2. Click the Modify button
    Timesheet will display the Global Reason Modification screen, which will be used for the remainder of this process.
  3. Modify the description, status, group membership and auto add characteristic of the reason(s) in question
    Description, Group Membership and Auto Add are discussed above, under reason creation. Status is a characteristic that determines how Timesheet handles each reason. There are three status options:
  4. Click the perform modifications button
    Timesheet will display the Global Reason Entry and Modification screen, displaying a green text message confirming the modification of the reason(s) in question.
Deleting A Reason
Timesheet allows you to delete reasons if they no longer serve the needs of your organization; however, Journyx strongly recommends modifying these reasons to have a status of Hidden or Reportable Only rather than deleting. While deleting will not cause database errors, it is non-reversible and may cause unforseen issues in the future. The interface for deleting reasons is located on the Global Reason Entry and Modification screen. The process of deleting reasons is outlined below:
  1. Select the reason(s) to be deleted
  2. Click the Delete button
    Timesheet will display a popup window asking you to confirm the deletion of the selected reasons. If you are certain you wish to delete these reasons, click OK in this popup window. Timesheet will refresh the Global Reason Entry and Modification screen, displaying a green text message confirming the deletion of the reason(s) in question.
Please Note: Records associated with any reasons that have been deleted will still be available for reporting; however, the reason associated with these records will be listed as 'none.'

Vehicle

Vehicles are used in the Mileage Entry Process to indicate the method used for travel. The controls needed to create, modify and delete vehicles are contained within the Global Vehicle Entry and Modification screen, which can be accessed via the Vehicle link under the Mileage Entry Columns Management header on the main admin screen. This screen will be used for all functions associated with vehicle management.

There is only one default vehicle that ships with Timesheet v4.5: Vehicle A.

Creating A Vehicle
Timesheet allows you to create new vehicles for use by your organization. The interface for creating new vehicles is found on the bottom half of the Global Vehicle Entry and Modification screen. The process of creating a new vehicle is outlined below:
  1. Enter a name for the new vehicle
    The name for each vehicle should be a simple and descriptive term that users will be able to understand easily. This field is limited to 60 characters.
  2. Enter a description for the new vehicle
    The description for each vehicle can be a more in depth explanation of that vehicle. This field is limited to 252 characters.
  3. Choose which currently existing Groups should have access to this vehicle.
    You may select one or more existing groups to assign the new vehicle to automatically. Each new vehicle must be assigned manually, through group modification, to any groups not selected during vehicle creation.
  4. Indicate automatic assignment to new groups
    Click the checkbox for this option if the new vehicle is one that will be used commonly throughout your organization. This option will cause the new vehicle to be included automatically in all newly created groups, thereby eliminating the need to add it to new groups manually.
  5. Click the Create New Vehicle(s) button
    Timesheet will refresh the Global Vehicle Entry and Modification screen, displaying a green text message confirming the creation of the new vehicle.
Modifying A Vehicle
Timesheet allows you to modify individual existing vehicles to change certain aspects of those vehicles. The modifiable parameters for a vehicle are: To modify an existing vehicle:
  1. Select the vehicle(s) in question on the Global Vehicle Entry and Modification screen
  2. Click the Modify button
    Timesheet will display the Global Vehicle Modification screen, which will be used for the remainder of this process.
  3. Modify the description, status, group membership and auto add characteristic of the Vehicle(s) in question
    Description, Group Membership and Auto Add are discussed above, under vehicle creation. Status is a characteristic that determines how Timesheet handles each vehicle. There are three status options:
  4. Click the perform modifications button
    Timesheet will display the Global Vehicle Entry and Modification screen, displaying a green text message confirming the modification of the vehicle(s) in question.
Deleting A Vehicle
Timesheet allows you to delete vehicles if they no longer serve the needs of your organization; however, Journyx strongly recommends modifying these vehicles to have a status of Hidden or Reportable Only rather than deleting. While deleting will not cause database errors, it is non-reversible and may cause unforseen issues in the future. The interface for deleting vehicles is located on the Global Vehicle Entry and Modification screen. The process of deleting vehicles is outlined below:
  1. Select the vehicle(s) to be deleted
  2. Click the Delete button
    Timesheet will display a popup window asking you to confirm the deletion of the selected vehicles. If you are certain you wish to delete these vehicles, click OK in this popup window. Timesheet will refresh the Global Vehicle Entry and Modification screen, displaying a green text message confirming the deletion of the vehicle(s) in question.
Please Note: Records associated with any vehicles that have been deleted will still be available for reporting; however, the vehicle associated with these records will be listed as 'none.'

Measurement

Measurements are used in the Mileage Entry Process to provide an explanation for the distance travelled. The controls needed to create, modify and delete measurements are contained within the Global Measurement Entry and Modification screen, which can be accessed via the measurement link under the Mileage Entry Columns Management header on the main admin screen. This screen will be used for all functions associated with measurement management.

The default measurements that ship with Timesheet v4.5 are:

Creating A Measurement
Timesheet allows you to create new measurements for use by your organization. The interface for creating new measurements is found on the bottom half of the Global Measurement Entry and Modification screen. The process of creating a new measurement is outlined below:
  1. Enter a name for the new measurement
    The name for each measurement should be a simple and descriptive term that users will be able to understand easily. This field is limited to 60 characters.
  2. Enter a description for the new measurement
    The description for each measurement can be a more in depth explanation of that measurement. This field is limited to 252 characters.
  3. Choose which currently existing Groups should have access to this measurement.
    You may select one or more existing groups to assign the new measurement to automatically. Each new measurement must be assigned manually, through group modification, to any groups not selected during measurement creation.
  4. Indicate automatic assignment to new groups
    Click the checkbox for this option if the new measurement is one that will be used commonly throughout your organization. This option will cause the new measurement to be included automatically in all newly created groups, thereby eliminating the need to add it to new groups manually.
  5. Click the Create New measurement(s) button
    Timesheet will refresh the Global Measurement Entry and Modification screen, displaying a green text message confirming the creation of the new measurement.
Modifying A measurement
Timesheet allows you to modify individual existing measurements to change certain aspects of those measurements. The modifiable parameters for a measurement are: To modify an existing measurement:
  1. Select the measurement(s) in question on the Global Measurement Entry and Modification screen
  2. Click the Modify button
    Timesheet will display the Global Measurement Modification screen, which will be used for the remainder of this process.
  3. Modify the description, status, group membership and auto add characteristic of the measurement(s) in question
    Description, Group Membership and Auto Add are discussed above, under measurement creation. Status is a characteristic that determines how Timesheet handles each measurement. There are three status options:
  4. Click the perform modifications button
    Timesheet will display the Global Measurement Entry and Modification screen, displaying a green text message confirming the modification of the measurement(s) in question.
Deleting A measurement
Timesheet allows you to delete measurements if they no longer serve the needs of your organization; however, Journyx strongly recommends modifying these measurements to have a status of Hidden or Reportable Only rather than deleting. While deleting will not cause database errors, it is non-reversible and may cause unforseen issues in the future. The interface for deleting measurements is located on the Global Measurement Entry and Modification screen. The process of deleting measurements is outlined below:
  1. Select the measurement(s) to be deleted
  2. Click the Delete button
    Timesheet will display a popup window asking you to confirm the deletion of the selected measurements. If you are certain you wish to delete these measurements, click OK in this popup window. Timesheet will refresh the Global Measurement Entry and Modification screen, displaying a green text message confirming the deletion of the measurement(s) in question.
Please Note: Records associated with any measurements that have been deleted will still be available for reporting; however, the measurement associated with these records will be listed as 'none.'

Entering Mileage in Timesheet

The process of entering mileage into Timesheet is described below. For Mileage Entry screens that have certain columns hidden, please disregard references to those hidden columns.
  1. Select the Project for this particular mileage entry from the drop down menu containing Projects
  2. Enter Comments relating to this mileage entry, this is typically an identifer such as "Meeting in Dallas" or "Pick up Steve at airport"
  3. Select the Vehicle for this particular mileage entry from the drop down menu containing Vehicles
  4. Select the Reason for this particular mileage entry from the drop down menu containing Reasons
  5. Select the Measurement for this particular mileage entry from the drop down menu containing Measurements
  6. Enter the amount of the actual mileage for the appropriate date
    Please Note: Timesheet currently supports measurement amounts of up to 5 digits, including the decimal point. Therefore, Timesheet will allow amounts up to 99999 for any particular line item if no decimal places are required.

Mileage Approvals

Journyx Timesheet v4.5 allows you to implement a robust mileage approval process to effectively manage travel expenditures across your organization. This approval process functions in very much the same fashion as the time and expense approvals processes. Approval templates must be created and then assigned to the employees who will be tracking mileage. Once these templates have been assigned, users will be able to submit their mileage entry forms for approval to the appropriate approvers with the click of a button. Additionally, automatic email notifications may be established to ensure proper communication regarding mileage approvals. The mileage approvals process is described in detail below.

Mileage Approval Templates

Before the mileage approvals process can be implemented, mileage approval templates must be created and assigned to users. The installing Admin should consider the approval process that will be required by his organization before beginning to establish a User base or implementing Timesheet.
Creating New Approver Templates
To create the necessary approver templates to be assigned to users, the admin should first create any users (Managers, Project Managers and Admins) who will serve as approvers for timesheets. Next, the admin should enter the Create Mileage Approval Templates Screen from the main admin screen via the Create Mileage Approver Templates link which is located under the Mileage Approval Process Management header.

Create Approval Templates Screen
This screen provides the admin with all the necessary tools for the creation of new Mileage Approver Templates. The admin should name the new template and specify the number of levels of approval that this template specifies. The admin should then choose a primary and a backup approver for each level of approval from the dropdown menus provide at the top of this screen. Finally, this screen allows parameters for email notifications to be set up for the template that is being created. The admin should select any and all email notification parameters that are desired at this time. Below is a list of the possible parameters and information on what they mean.

Notify users when mileagesheet is rejected? Selecting "yes" for this field will send the submitting user an email to notify him that his mileagesheet has been rejected if it has been rejected.
Notify users when a mileagesheet has completed the approval cycle? Selecting "yes: for this field will send the submitting user an email notifying him that his mileagesheet has successfully completed the approval process once the final approval has been given.
Notify approver when a mileagesheet has been submitted for their approval? Selecting "yes" for this field will send an email notification to each level's primary approver that a mileagesheet has been submitted for their approval.
Notify users X days before a time sheet is due to be submitted. Selecting "yes" for this field will send an email to notify users that they have X days remaining before mileagesheets must be submitted.

Additionally, the admin must select a number of days between 0 and 7 that this email notification will go out before the due date.
Notify users X days after a timeperiod if the mileagesheet is not yet submitted. Selecting "yes" for this fields will send a reminder email to users X days after the due date for mileagesheet submission if they have a mileagesheet that has not been submitted for the period in question.

Additionally, the admin must select a number of days between 0 and 7 that this email notification will go out after the due date.
Notify approver X days after a timeperiod if the mileagesheet is not yet submitted. Selecting "yes" for this field will send an email to the approver for each level X days after the due date for mileagesheet submission to inform them that a user has not yet submitted a mileagesheet for approval.

Additionally, the admin must select a number of days between 0 and 7 that this email notification will go out after the due date.
Notify backup approver X days after a timeperiod if the mileagesheet is submitted, but is not yet approved. Selecting "yes" for this field will send an email to the backup approver for each level that they have a mileagesheet that may need their attention due to lack of response from the primary approver X days from the submission of a mileagesheet.

Additionally, the admin must select a number of days between 0 and 7 that this email notification will go out after the due date.

Once all desired email parameters have been entered, the admin should click the Create button. The screen will refresh and display a green text message confirming that the new approver template has been created. The newly created template will now be available for assignment to new users in the mileage approver template dropdown in the User Creation and Modification Screen.

Modifying and Deleting Approver Templates
It may prove necessary at times to make changes to or even delete a specific approver template, such as if an approver leaves the organization or email notification needs to be redefined. To modify approver templates, the admin should enter the Modify/Delete Mileage Templates screen via the Modify Time Approver Templates link which is located under the Modify Time Approver Templates header on the main admin screen.

Modify/Delete Mileage Templates Screen
This screen allows an Admin to modify or delete an existing mileage approver template.
To delete a template, the Admin should simply select that template from the list of currently existing templates and click the delete button. Please Note: At this time, deleting a template does not change the current approvers for users who were assigned that template. Users who would be affected by this change will need to be modified directly to put this change into effect.
To modify a template, the Admin should select the template that needs changes and click the modify button. The admin will then be taken to the Modify Mileage Template screen, which is the same as the Create Mileage Template screen, discussed above. Once the desired changes have been made, the screen will refresh display a green text message confirming that the mileage approver template in question has been modified. This message will also indicate the number of users who have been affected by this change.

Assigning an Approver Template to a User
Timesheet provides two unique way to assign mileage approval templates to users. The preferred method is to choose a template for each user as he is created, as discussed under Creating New Users, above. In the event that templates were not assigned at the time of user creation, or if template reassignment becomes necessary, the Admin can access the Mileage Approval Template Reassignment Screen from the main admin screen via the Mileage Template Reassignment link which is available under the Mileage Approval Process Management header. This link will take the Admin to the Mileage Template Reassignment Search Screen, where he can enter the name (or part of a name) of an employee to reassign mileage approval templates to. After the search has completed, the admin will be taken to the actual reassignment page. Here, the admin can select the user(s) to reassign and may then select the mileage template to be used. The Admin should select any users to be reassigned, select the template to be used, and click the use template button. The screen will refresh and display a green text message confirming that the template has been assigned. Optionally, this screen can be used to create a new template if a suitable one does not currently exist. Please Note: If you are using this screen to create a new template, you must also select at least one user for that template to be assigned to or Timesheet will not create the new template. The admin should select the users to be reassigned and then enter the parameters for the new template and then click the create template button. The screen will refresh and display a green text message confirming that the new template has been created and assigned.

Mileage Approvals

Now that the approvals templates have been created and assigned to users, the Mileage Approval process can be used to its full extent. Users will now see a Submit Mileagesheet button on their Mileage Entry Screens. This button should be clicked once a time period for Mileage Entry has been completed or when mileage entry is otherwise complete for that period. Clicking this button begins the approval process by queueing the submitted mileagesheet for approval. Additionally, any automated email settings will now begin in regards to the submitted mileagesheet.

Approving Mileagesheets
The mileage approval process depends on approvers to view and approve submitted mileage sheets. Timesheet v4.5 supports two different types of approvers: regular approvers, consisting of manager and project manager and super approvers which is a role ability of administrators. These different types of approvers have slightly different methods of approving mileage.

Regular approvers have two links available under the Mileage Approval Process Management header on their admin screen:

  1. Mileagesheet Approval
    This link allows regular approvers to view a list of users who are in groups that the approver himself is in. The user list provides approvers with the ability to view open and submitted mileagesheets for each user. Mileagesheets that are open (i.e., not submitted for approval) can be viewed but not approved. Mileagesheets that have been submitted may be approved via this user list, but the more common approach for regular approvers approving mileagesheets is to view Mileagesheets Awaiting My Approval.
  2. Mileagesheets Awaiting My Approval
    This link will only appear active if at least one mileagesheet that the approver is responsible for has been submitted for approval. If this link is active, a number in parenthesis to the right of this link will be displayed. This number indicates the number of submitted mileage sheets that are awaiting the approval of this approver. Clicking on this link will display the Mileagesheet Approval screen, which is discussed below.

Superapprovers use the same general procedures for mileage approval as regular approvers; however, their views are not limited by the group structure; therefore, a superapprover can see all users with open mileagesheets when they take the Mileagesheet Approval process as discussed above. Further, superapprovers will have all submitted mileagesheets included in the count of Mileagesheets Awaiting My Approval. In short, a superapprover has access to approve all submitted mileagesheets regardless of group membership or approvals process design.

The Mileagesheet Approval Screen
This screen provides approvers with the ability to approve or reject submitted mileagesheets. Each submitted mileagesheet that is the responsibility of the approver who is viewing this screen is displayed in a list at the top of this screen.

To approve these mileagesheets, the approver should click the checkbox to the right of each available mileagesheet , or click the Select All checkbox at the bottom of the list, and click the Approve button at the bottom of this screen. Timesheet will the display a screen containing a green text message confirming that the selected mileagesheets were confirmed.

To reject any of these mileagesheets, the approver should click the checkbox to the right of each available mileagesheet , or click the Select All checkbox at the bottom of the list, enter a reason for the rejection and then click the Reject button at the bottom of this screen. Timesheet will the display a screen containing a green text message confirming that the selected mileagesheets were rejected. Please Note: A reason for rejection must be supplied. Otherwise, Timesheet will display an error message reminding you to supply a rejection reason and the rejection will not take place.

Projects


Journyx Timesheet uses Projects to indicate the object of the multitude of various time, mileage and expense entries created by users. Timesheet allows your organization to create an unlimited number of projects to use for time, expense, and mileage tracking purposes. Timesheet uses a hierarchical project structure, and allows an unlimited number of generations under any specific parent project.

Timesheet v4.5 introduces a new and improved set of Project control tools, with a focus on graphical representation of the Project hierarchy. These new tools help everyone in your organization to visualize the project hierarchy structure and make it even easier to create, modify and delete projects as needed.

The Project Management Screen

The Project Management Screen, which is accessed from the main admin screen via the Projects link located under the Project Management header, serves as the master control panel for all project creation, modification and deletion. This screen may appear in several different ways, depending upon the options selected in the Project Management portion of the Timesheet Global Preferences. By default, this screen will look like the following:

The Project Management Tree, without Enhanced Management Interface or checkbox modification and deletion enabled.

The most common alterations to the appearance of the Project Management Screen are the Enhanced Management Interface modifications, which apply a small number of appearance changes that help the admin better visualize the layout of the Project Management Tree. Additionally, your organization may elect to enable checkbox-based deletion and modification of projects as well. The use of these optional screen enhancements will replace the scissors and pencil icons seen in the above screen shot with checkboxes (as seen below). This set of screen enhancements enables the admin to modify or delete multiple projects at one time.

The Project Management Tree, using the Enhanced Management Interface and Checkbox Modification and Deletion of Projects enabled.

If the Enhanced Management Interface modifications are used, the Project Management Screen will also display the Project Creation Interface at all times. This interface is normally only displayed when the admin is actually creating projects.

The Project Creation Interface as displayed on the Project Management Screen when Enhanced Management Interface options are enabled.

Finally, your organization may have enabled the Project Management "Icon Legend." If so, this list of the Project Management Screen icons and what they mean will be located at the bottom of the Project Management Screen. The icon legend looks like this:

The Project Management Screen Icon Legend

Creating Projects

One of the first actions that should be performed on any new installation of Timesheet is the creation of the various Project that your organization will be using for time, mileage and expense tracking. There are two main processes for creating new projects in Timesheet v4.5, each of which is outlined below.

Creating New Projects Using The "New Project" Icon

You may always create new projects using the "New Project" Icon . To create a new project using the "New Project" icon, simply click on the icon in the New column of the project you intend to be the parent of the new project. This will bring up the New Project screen, which will be used for the remainder of the project creation process, which is described below. By default, up to five new projects may be created at one time. This maximum number of new projects can be modified in the Project Management portion of the Timesheet Global Preferences.
  1. Enter a name for the new project
    Although Timesheet allows up to 252 characters for each project name, Journyx recommends keeping each project name as short as feasibly possible to keep the project dropdown menus manageable.
  2. Choose the type for this new project
    Timesheet supports two type os projects: Projects and Subprojects. In general, even if the subprojects type is available to your organization, the type for nearly all projects created should be project.
  3. Enter a description for the new project
    Timesheet allows up to 252 characters for the description for each project. The description should be used to provide further details on the nature of a given project.
  4. Indicate Auto-Add status for the new project
    If you select yes for this option, this project will be added to every new group that is created in Timesheet. You should only select yes for this option if you are unlikely to have more than a small number of groups that should not have access to this project. Otherwise, you will have to remove this project manually from each group that is not supposed to have access to it.
  5. Enter the total estimated hours for the new project
    Timesheet allows up to 8 digits for each project's estimated hours.
  6. Indicate which currently existing groups should have access to the new project
    Multiple groups can be selected by control-clicking each group you wish to select. You can always change which groups have access to any given project later by modifying that particular group or by modifying that specific project.
  7. Click the Create New button
    Timesheet will display the Project Management Screen, along with a green text message confirming the creation of the new project.

Creating A New Project Using The "Create New Project Interface"

If your organization is using the Enhanced Management Interface options for the Project Management Screen and Project Tree, the Create New Project Interface will be displayed at the bottom of the Project Management Screen at all times. This interface is very similar to the interface seen on the Create New Projects screen; the only difference is the presence of the parent dropdown menu, which is used to select a parent for the new project(s). The process of creating a new project using this interface is outlined below.
  1. Enter a name for the new project
    Although Timesheet allows up to 252 characters for each project name, Journyx recommends keeping each project name as short as feasibly possible to keep the project dropdown menus manageable.
  2. Choose the type for this new project
    Timesheet supports two type of projects: Projects and Subprojects. In general, even if the subprojects type is available to your organization, the type for nearly all projects created should be project.
  3. Enter a description for the new project
    Timesheet allows up to 252 characters for the description for each project. The description should be used to provide further details on the nature of a given project.
  4. Select the parent for the new project
    Unlike creating projects via the "New Project" icon, which allows the creating user to indicate the parent for a new project based on which level the "New Project" icon is selected from, creating new projects using the Create New Project interface requires the creating user to choose a parent project from the dropdown list named "Parent."
  5. Indicate Auto-Add status for the new project
    If you select yes for this option, this project will be added to every new group that is created in Timesheet. You should only select yes for this option if you are unlikely to have more than a small number of groups that should not have access to this project. Otherwise, you will have to remove this project manually from each group that is not supposed to have access to it.
  6. Enter the total estimated hours for the new project
    Timesheet allows up to 8 digits for each project's estimated hours.
  7. Indicate which currently existing groups should have access to the new project
    Multiple groups can be selected by control-clicking each group you wish to select. You can always change which groups have access to any given project later by modifying that particular group or by modifying that specific project.
  8. Click the Create New button
    Timesheet will display the Project Management Screen, along with a green text message confirming the creation of the new project.

Modifying Projects

There may be times when it is necessary to modify information regarding a specific project. Depending on the Project Tree display options your organization is using, the Global Project Modification screen will be accessed via either the "Edit Project" Icon or by using select boxes and clicking the Modify button. If you use the "Edit Project" icon, you will only be able to modify one project at any given time. Check box modification of projects allows you to modify any number of projects at once. Check box modification of projects is an option that can be enabled in the Project Management portion of Timesheet's Global Preferences.

The Global Project Modification Screen

Primary Project Characteristics Modification

Once you have accessed the Global Project Modification Screen, you will be able to make changes to the primary characteristics for the selected project(s). Changes to the extra project fields are covered below, under Extra Project Fields Modification. The following primary characteristics of any given project may be modified:

Extra Project Fields Modification

Each project in Journyx Timesheet has certain default extra fields that may be modified after project creation. Additionally, your organization may create more extra project fields as required. Creation of additional extra project fields is covered below. The default extra project fields that ship with Timesheet v4.5 are: The Extra Project Fields Modification Screen

The Extra Project Fields Modification Screen is the interface for all extra project field modification. This screen is accessed from the Global Project Modification Screen via the Go To Extra Project Fields button.

The process for modifying extra project fields is outlined below.

Deleting Projects

Journyx Timesheet v4.5 allows your organization to delete unused or unneeded projects under certain circumstances. A project that has never had any time, expenses or mileage logged against it may be deleted from the Timesheet database and thereby removed from use. However, if a project has ever been used as part of a time, expense or mileage entry, Timesheet will not allow you to delete that project. These projects should be modified to have a status of "hidden" instead of deleted. Status is covered in detail above, in the Modifying Projects section.

Projects that are eligible for deletion may be deleted in one of two ways, depending on the options that your organization is using for the Project Management Screen. A project that is not eligible for deletion will have the "not modifiable or deletable" icon in place of either the "Delete Project" icon or the checkbox in the Delete column, depending on which GUI options are in use by your organization. Both methods of deletion are outlined below.

Deleting A Project Using the "Delete Project" Icon

If your organization is not using checkbox project deletion, you may simply click the "Delete Project" Icon to the right of the project in question. Timesheet will display a popup window asking you to confirm that you wish to delete the project. If you wish to continue with the deletion process, click the OK box in this popup window. Timesheet will then refresh the Project Management screen and display a green text message confirming the deletion of the selected project. Please Note: You will only be able to delete one project at a time when using the "Delete Project" icon.

Deleting A Project Using Checkbox Project Deletion

If your organization is using checkbox project deletion, you will need to click the checkbox(es) of the project(s) you intend to delete. After you have selected projects for deletion, click the Delete button at the bottom of the Project Tree. Timesheet will a popup window asking you to confirm that you wish to delete the project(s). If you wish to continue with the deletion process, click the OK box in this popup window. Timesheet will then refresh the Project Management screen and display a green text message confirming the deletion of the selected project.

Working With Projects

The project tree on the Project Management Screen provides features beyond creating, modifying and deleting projects. These additional actions are covered below.

Reparenting Projects

The "cut" icon may be used in conjunction with the "paste" icon to reparent projects if GUI reparenting is enabled in the Project Management portion of Timesheet's Global Preferences. To reparent a project graphically:
  1. Click the "cut" icon
    Timesheet will refresh the Project Management Screen, including a green text message indicating that reparenting a project is in process. The "paste" icon will be displayed in place of the "cut" icon for all projects that may serve as the new parent for the "cut" project. Please Note: The "not available" icon will be displayed in place of the "cut" icon for any project that cannot serve as the new parent for the "cut" project. This include the "cut" project itself.
  2. Click the "paste" icon for the project that will serve as the new parent for the "cut" project
    Timesheet will refresh the Project Management Screen, with the Project Tree focused on the newly specified parent project. Please Note: The "cut" icon will again be displayed for all projects that are available for reparenting.
Reparenting Projects Without Using The GUI
If your organization has chosen to disallow the reparenting of projects via the GUI, you may still reparent projects by changing the parent project via the Global Project Modification screen, as discussed above.

Navigating The Project Tree

Journyx Timesheet v4.5 displays your organization's project hierarchy as a tree structure. By default, Timesheet shows the entire project tree, starting from the root level. The "focus" icon is used to change the tree view to start at the level of a specific project.

The Project Tree Zoomed To A Different Level

In the above example, the admin has clicked the "focus" icon to the left of the project Roosevelt and Timesheet has displayed the tree focused on that level. The red link to Root at the top of this screen allows you to return the view to the root level of the project tree. Links like this one will appear for each level above the current view.

This ability to change the focus of the tree view is provided to allow your organization with a better way to navigate the project tree, especially in case that involve a large number of projects.


Project Management Global Preferences

Preferences: Project Management
Editing Projects    
Option Value Result
Allow Checkbox Deletion of Projects? no Disables checkbox deletion of projects. Deletion is only possible through the Delete Icon. Please Note: With this option set to "no" you will only be able to delete one project at any given time.
  yes Enables checkbox deletion of projects. Deletion is only possible though selected one or more projects via checkboxes and clicking the Delete button. Please Note: With this option set to "yes" you will be able to delete multiple projects at one time.
     
Allow Checkbox Modification of Projects? no Disables checkbox modification of projects. Modification is only possible through the Modify Icon. Please Note: With this option set to "no" you will only be able to modify one project at any given time.
  yes Enables checkbox modification of projects. Modification is only possible though selected one or more projects via checkboxes and clicking the Modify button. Please Note: With this option set to "yes" you will be able to modify multiple projects at one time.
     
Allow creation of projects under projects that are hidden? yes Allows the creation of projects under parent projects whose status has been set to "hidden." Please Note: If hidden projects are not displayed in the project tree (see Show Hidden Projects in Tree, below) creating new projects under hidden projects will not be possible.
  no Prevents the creation of projects under parent projects whose status has been set to "hidden."
     
Behavior    
Option Value Result
Always Show The Full Project Tree? yes Timesheet will display the full project tree at all times. Please Note: If this option is set to "yes" then the options "Limit the number of projects on any single page to:" and "Default number of branches to show" are effectively disabled. See below for more information on these options.
  no Timesheet will not display the full project tree. Please Note: If this option is set to "no" then the options "Limit the number of projects on any single page to:" and "Default number of branches to show" are used by Timesheet to determine which portions of the project tree to display. See below for more information on these options.
     
Limit the number of projects (rows) on any single page to: 100 Specifies the maximum number of projects that Timesheet will display on any given Project Management Screen. Please Note: If the "Always Show The Full Project Tree?" option (see above) is set to "yes" then this option will have no effect on the Project Management Screen display.
     
Allow re-parenting of projects through the gui? yes Allows use of the Cut and Paste buttons on the Project Management Screen to change the project hierarchy by moving projects between parents. This option does not supercede the ability to reparent projects via direct project editing.
  no Disallows the use of the Cut and Paste buttons on the Project Management Screen to change the project hierarchy by moving projects between parents. Please Note: If this option is set to "no" the Cut and Paste buttons will no longer appear on the Project Management Screen.
     
View Project "Icon Legend"? no Turns off the legend that describes the functions of each of the icons used in the Project Management Screen.
  yes Turns on the legend that describes each of the icons used in the Project Management Screen.
     
Number of new projects allowed on new project screen:
5 Indicates the maximum number of new projects that may be created at one time when using the Create New Projects functions of Timesheet.
     
Default number of branches to show 3 Indicates the default number of branches of the Project tree to display. Please Note: If the "Always Show The Full Project Tree?" option is set to "yes" then this option is effectively disabled.
     
Show hidden projects in tree? yes Forces Timesheet to display all projects, even those whose status has been set to "hidden" within the Project tree.
  no Forces Timesheet to keep all projects whose status has been set to "hidden" from being displayed in the project tree.
     
Interface    
Option Value Result
Use Enhanced Management Interface no Turns off the UI enhancements to the Project Management Screen. These enhancements include bold dark lines that more clearly separate each section of the project tree as well as a footer for the project tree that displays the same information as the header. Finally, when enabled the Enhanced Management Interface automatically displays the Create New Projects controls at the bottom of the Project Management Screen.
  yes Turns on the UI enhancements to the Project Management Screen. These enhancements include bold dark lines that more clearly separate each section of the project tree as well as a footer for the project tree that displays the same information as the header. Finally, when enabled the Enhanced Management Interface automatically displays the Create New Projects controls at the bottom of the Project Management Screen.
     
Extra Data    
Option Value Result
Let Managers see actual hours? no Turns off the appearance of "Actual Hours" in the Project Tree display for users other than Administrators.
  yes Turns on the appearance of "Actual Hours" in the Project Tree display for users other than Administrators.

Schedules, Population Schemas and Mass Approvals In Timesheet v4.5


Journyx Timesheet v4.5 provides new tools for creating and applying schedules to your users, both individually as well as within the group structure used by your organization. Additionally, these tools also enable mass population and approval of scheduled time entries. These scheduling and population features are described in the following sections.

Schedules

Timesheet 4.5 allows your organization to create pre-defined schedules that consist of various time entries and then apply those schedules to your users either on an individual basis or to groups of users. These schedules can then be implemented by users to prepopulate their Time Entry Screens with the scheduled hours.

Users may have access to any number of schedules, and may even create their own schedules to meet their individual needs. Each user may also have exactly one default schedule assigned to them. This default schedule will automatically fill in the hours it represents on every new timesheet for this user when those timesheets are accessed.

Timesheet 4.5 supports two forms of schedules: Group Schedules and User Schedules. Group Schedules are created by the administrator and assigned to specific groups, whose members may then access these shared schedules as needed. User Schedules can be created by the Timesheet Administrator as well as by other users, managers and project managers. The admin can create these schedules for any user, while a specific user can only create a schedule for himself. Every User Schedule is unique to a specific user and are not available to any other user withing Timesheet.

Group Schedules

Group Schedules are schedules that are created and assigned to your organization's users based upon the group membership associated with those users within Timesheet's group structure. Group Schedules are created and maintained on the Group Schedule Management Screen, which is available from the main admin screen via the Group Schedules link which is located under the Scheduling header.

The Group Schedule Management Screen

This screen provides the admin with access to the controls needed to create and modify group schedules as well as the ability to designate or change the group affiliation of existing schedules. Additionally, this screen includes a graphic representation of information regarding the group assignments of currently existing group schedules.

Creating A Group Schedule
Group schedules are created via the Group Schedule Management Screen. To begin the process of creating a new schedule, click the button on the right of this screen, under the Select An Action section. The process of creating a new group schedule flows through several screens, each of which addresses one or more of the parameters required by a new group schedule. This process is outlined, screen by screen, below.

  1. Choose a Time Period for the new schedule and click
    The first screen in the new Group Schedule creation process requires you to indicate which time period will be used by this schedule. By default, only the standard Weekly time period is available. If you have already created additional time periods, they will be available to select on this screen as well. Please Note: The time period selected for schedule building does not affect the time period used during the time, mileage or expense entry processes. Additionally, a semi-monthly time period will not be effective for the group schedule creation process: since the days of the week and actual dates of a month vary from month to month, Timesheet is unable to correlate schedules created on a semi-monthly time period to the next month.
  2. Enter a Name for the new schedule and click
    The next screen in the new Group Schedule creation process requires you to enter a name for the new schedule. Schedule names may be up to 60 characters in length and should be specific enough to allow users to differentiate once Group Schedule from another in a dropdown menu.
  3. Choose the groups to which this schedule will be assigned and click
    The next screen in the new Group Schedule creation process requires you to specify which groups will have access to the new schedule. You may use the Check All checkbox to select all available groups for the assigning schedule process. Once you have indicated the groups that should have access to the new schedule, you should click the button to make this assignment complete. Timesheet will refresh the Group Schedule Assignment screen, displaying a green text message indicating that the Group schedule has been assigned to the selected groups.

    There are three additional buttons available on this screen:


    • This button takes you to the Schedule/Group Assignment Selection Screen, which is used to select schedules to assign to new groups. This screen is discussed in detail below. Please Note: If you click this button before clicking the button when you first access the New Schedule Group Assignment Screen, group assignment for the new schedule will be lost.

    • This button takes you to the Group Schedule Creation Screen, where you can begin the Group Schedule creation from the top. Please Note: If you click this button before clicking the button when you first access the New Schedule Group Assignment Screen, group assignment for the new schedule will be lost.

    • This button takes you to the Modify Group Schedule Screen, which is used to specify the actual time entries for a Group Schedule. This is the next step in creating a new Group Schedule and is discussed immediately below. Please Note: If you click this button before clicking the button when you first access the New Schedule Group Assignment Screen, group assignment for the new schedule will be lost.
  4. Click the button.
    Timesheet will display the Modify Group Schedule Screen. This screen resembles a standard Time Entry Screen and is used in the same fashion. Simply create the Time Entries that you wish to be part of this schedule and click the button when you have finished. Timesheet will refresh the Modify Group Schedule Screen and display a green text message confirming the modification of the Group Schedule. You will be able to make further modifications to this Group Schedule using this screen immediately, or you may return to this Schedule and make modifications in the future. Modification of existing schedules is covered below.
Once you are satisfied with the new Group Schedule, you may return to the Group Schedule Management Screen to modify existing Group Schedules or to create new Group Schedules by clicking the Return to group schedule screen link at the bottom of this screen.
Modifying Group Schedules' Group Affiliation
In the event that the group affiliation of a Group Schedule must be changed, the Group Schedule Management Screen provides access to tools that enable the admin to modify which groups have access to a particular schedule. These tools are accessed via the button. To change the group affiliation of a Group Schedule:
  1. Click the button
    Timesheet will display the Select Schedule Screen
  2. Select the Group Schedule you wish to modify and click the button
    You may modify only one schedule at any given time. Therefore, you will not be able to select multiple schedules on this screen.
  3. Select the groups that should have access to this Group Schedule
    You may use the Check All checkbox to select all available groups for the assigning schedule process. Once you have indicated the groups that should have access to the new schedule, you should click the button to make this assignment complete. Timesheet will refresh the Group Schedule Assignment screen, displaying a green text message indicating that the Group schedule has been assigned to the selected groups.
Modifying Group Schedules' Time Records
In the event that the time records for a specific Group Schedule must be changed, the Group Schedule Management Screen provides access to tools that enable the admin to modify, add and delete those time records as needed. These tools are accessed via the button. To change the time records of a Group Schedule:

Click the button
Timesheet will display the Modify Schedule Screen. You may use this screen exactly like any other time entry screen to create new time entries or to modify or delete existing time entries. Please Note: To delete an existing time entry, change the actual hours for that entry to zero. That entry will be deleted when you click the button.

When you have finished working with the time entries for the Group Schedule in question, click the button. Timesheet will refresh the Modify Group Schedule Screen and display a green text message confirming the modification of the Group Schedule. You will be able to make further modifications to this Group Schedule using this screen immediately, or you may return to this Schedule and make modifications in the future.

Once you are satisfied with the your changes to this Group Schedule, you may return to the Group Schedule Management Screen to modify other existing Group Schedules or to create new Group Schedules by clicking the Return to group schedule screen link at the bottom of this screen.

Deleting Group Schedules
Timesheet allows for the deletion of Group Schedules via the Modify Group Schedule Screen, which is discussed above. To delete a Group Schedule:
  1. Navigate to the Modify Group Schedule Screen
  2. Select the Group Schedule you intend to delete
  3. Click the button
    Timesheet will refresh the Modify Group Schedule Screen and display a green text message confirming the deletion of the selected Group Schedule.
Please Note: Deleting a Group Schedule cannot be undone. Please delete only those Group Schedules that you are certain your organization will not need in the future.

User Schedules

User Schedules are schedules that are created by or applied to a specific user. These schedules are not available to any other user, regardless of group affiliation. Administrators can create any number of user schedules and apply each one to a specific user across an entire Timesheet installation. All other user roles are able to create schedules for themselves only, and use a different interface for schedule creation than Admins. This section will cover the User Schedule creation process from the admin perspective first, and from the point of view of the other user roles second.
Creating User Schedules: Admin Users
Timesheet Administrators access the User Schedule Creation interface via the User Schedules link which is located under the Scheduling header. The User Schedule creation process takes place across several screens, and each screen is discussed below, in order of use.
  1. The User Search Screen
    This screen is used to search for a user to create a User Schedule for. Timesheet allows you to search by:
    • Project - show users who have access to the selected project(s). To select multiple Projects, CTRL-click each project name in the project list.
    • Group - show users who are members of the selected group(s). To select multiple Groups, CTRL-click each group name in the group list.
    • Name - show users whose name match the string entered. Partial strings are accepted by this field, so that you may search for all users whose names contain that string.
    Once the desired search criteria have been entered, click the button. Timesheet will display the next screen in the User Schedules creation process.
  2. The User Selection Screen
    This screen displays the results of the search performed in the User Search Screen. Each user who met the criteria outlined in the search will be displayed on this screen. If more than fifteen users meet the search parameters, you may use the though and the and buttons above the search results to navigate the results more effectively.

    Once you have located the user for whom you will be creating a new User Schedule, click that user's name. Timesheet will open a new window that contains the User Schedules Management Screen.

  3. The User Schedules Management Screen
    This screen provides access to tools that allow the creation, modification and deletion of User Schedules for the user selected on the User Selection Screen. Additionally, this screen allows a default schedule to be set for the user in question. These tools are divided into two parts:
    • Schedule Management
      This section allows the admin to view the available Group and User Schedules for the selected user. Please Note: Group Schedules viewed on this screen can only be set as th default schedule for the selected user, i.e., they cannot be modified, or deleted via these tools.

      There are four buttons available in this portion of the User Schedules Management Screen:


      • This button will open the Modify User Schedule Screen for the User Schedule selected in the Available Schedules dropdown box at the top of the Schedule Management section of the User Schedules Management Screen. Editing User Schedules is discussed below.

      • This button will delete the User Schedule selected in the Available Schedules dropdown box at the top of the Schedule Management section of the User Schedules Management Screen. Deleting User Schedules is discussed below.

      • This button sets the User Schedule selected in the Available Schedules dropdown box at the top of the Schedule Management section of the User Schedules Management Screen as the default schedule for the selected user. A default schedule is a schedule that will automatically fill in the hours it represents on every new timesheet for this user when those timesheets are accessed. The default schedule for a particular user appears first in the Available Schedules dropdown menu and are marked with an asterisk (*). Please Note: A user may have only one default schedule assigned to him at any given time.

      • This button clears the default schedule for the selected user. This action removes the default assignment of a User Schedule and leaves the selected user open to having a new default schedule assigned to him.
    • Create New Schedules
      This section of the User Schedule Management Screen allows the admin to enter a name for a new schedule and begin the actual process of entering hours into that new User Schedule. To proceed with User Schedule creation, enter a name for the new schedule and click the button. Timesheet will display the Modify User Schedules Screen.
  4. The Create User Schedule Entries Screen
    This screen resembles a standard Time Entry Screen and is used in the same fashion. Simply create the Time Entries that you wish to be part of this schedule and click the button when you have finished. Timesheet will refresh the Create User Schedule Entries Screen and display a green text message confirming the modification of the User Schedule.

    This screen also contains a duplicate of the tools available on the User Schedules Management Screen. These tools may be used to continue working with the schedules of the selected user as needed. Once you have finished working with the schedules for the active user, you may close this second window. Your original browser window should still be open, displaying the original results of the user search you performed at the beginning of the User Schedule Creation process. You may select a different user for User Schedule creation or modification purposes or you may return to the main Timesheet admin screen as desired.

Modifying And Deleting User Schedules: Admin Users
Any User Schedule may be modified by the Timesheet Administrator to change the time entries associated with that schedule or deleted to remove that User Schedule completely from Timesheet. To modify or delete a User Schedule, the Admin should access the User Schedule Management Screen by following the User Schedules link from the main admin screen and performing a User Search as described above. Once the appropriate user has been located, the admin can click on that user's name and he will then be transferred to the User Schedule Management Screen. This screen, as discussed above, provides the admin with access to the tools needed to modify or delete a User Schedule.

To modify a User Schedule:

  1. Select the User Schedule to modify from the dropdown list of available User Schedules
  2. Click the button
  3. Timesheet will display the Modify User Schedules Screen
    This screen functions exactly as the Create User Schedule Entries screen as described above.
  4. Once the desired changes have been made to the selected schedule, click the button
    Timesheet will refresh the Modify User Schedules Screen and display a green text message confirming the modification of the User Schedule.
To delete a User Schedule:
  1. Select the User Schedule to delete from the dropdown list of available User Schedules
  2. Click the button
    Timesheet will refresh the User Schedule Management Screen and the selected User Schedule will no longer be available in the dropdown list of Available Schedules.
Creating User Schedules: Non-Admin Users
While Timesheet Admins are able to create User Schedules for each user within a Timesheet installation, every user can create User Schedules for himself. Located at the bottom of each Time Entry Screen is the User Schedules Control Panel. Non-admin users access the User Schedule creation process via these tools. The functions available though this control panel are quite similar to the tools that admins use on the User Schedules Management Screen.

The process for creating a new User Schedule for non-admin users is described below.

  1. Enter a name for the new schedule
    Schedule names are entered in the text box located in the Create New Schedule portion of the Time Entry Scheduling section of the Time Entry Screen.

    If you would like to use the time entries that are already entered in the currently active Time Entry Screen, check Apply Above Time Records checkbox.

  2. Click the button
    Timesheet will display the Schedule Record Modification Screen. This screen resembles a standard Time Entry Screen and is used in the exact same fashion. Once you have entered the time records that you intend to include in this new schedule, click the button. Timesheet will refresh the Schedule Record Modification screen, including a green text message confirming the changes to the newly created schedule.
After you have created a new schedule, you will be able to use the User Schedules Control Panel at the bottom of the Schedule Record Modification Screen to continue working with schedules. The following actions are available from the Control Panel: Each of these functions is described below.
Modifying And Deleting User Schedules: Non-Admin Users
Each non-admin user may delete or modify the time entries of any User Schedule that he personally created. Modification and Deletion of User Schedules is performed via the User Schedules Control Panel that is located at the bottom of each Time Entry Screen as well as on the Schedule Records Modification Screen.

To modify a User Schedule:

  1. Select the User Schedule to modify from the dropdown list of available User Schedules
  2. Click the button
  3. Timesheet will display the Schedule Records Modification Screen
    This screen is the same as the Schedule Records Modification Screen as described above and function in the same manner.
  4. Once the desired changes have been made to the selected schedule, click the button
    Timesheet will refresh the Schedule Records Modification Screen and display a green text message confirming the modification of the User Schedule.
To delete a User Schedule:
  1. Select the User Schedule to delete from the dropdown list of available User Schedules
  2. Click the button
    Timesheet will refresh, displaying a green text message confirming the deletion of the selected User Schedule. The deleted User Schedule will no longer be available in the dropdown list of Available Schedules.

Using Schedules

Once created, User and Group schedules are available for users to apply to their timesheets. The advantage of schedules is that they represent a group of time entries that are commonly used by groups or individual users. Users apply schedules via the User Schedules Control Panel, which is located at the bottom of each Time Entry Screen.

To apply a schedule to your Time Entry Screen:

  1. Select the schedule to apply
    All available schedules are listed in the Available Schedules dropdown menu located within the User Schedules Control Panel.
  2. Click the button
    Timesheet will refresh your Time Entry Screen and display a green text message confirming that the selected schedule has been loaded. The hours represented by the schedule will now be displayed as part of your timesheet.
    • If you need to make changes to these hours, you may modify or remove them exactly as if you had entered them yourself.
    • If you are satisfied with these hours, click the button.
      Please Note: Loaded schedule hours will not be applied to your timesheet until you click the button.
You may repeat this process as often as needed, loading more than one schedule into your timesheet.
Default Schedules
Timesheet administrators may assign a default schedule to each user within Timesheet. Additionally, each user may select any available schedule to set as his own default. A user's default schedule is automatically loaded into each new timesheet when that timesheet is accessed, as long as no hours are already present within that Timesheet. Just like any other schedule import, these default schedule hours are loaded, but they are not actually stored as part of a timesheet until the user clicks the button. Therefore, default schedule hours can be modified or deleted before being applied to a timesheet. Please Note: A user must have a default schedule set before Population Schemas and Mass Approvals (see below) can be executed for that user.

Timesheet Population Schemas

Journyx Timesheet v4.5 includes tools that allow Administrators to prepopulate users' timesheets with hours. To use the Population Schemas feature of Timesheet, the admin should first create schedules that will be used for population purposes and then create and apply the schemas themselves. While Schedules are discussed in detail in the previous section, this section will focus on the interface for creating and applying Population Schemas to Timesheet users.

The screens that are used for Population Schema creation, assignment and execution are available from the main admin screen via the links located under the Timesheet Population and Mass Approval header.

Please Note: Each user who is to be affected by Population Schemas must have a default schedule assigned to him by the Timesheet Administrator. If a user has access to exactly one schedule, Timesheet will consider that schedule to be the user's default schedule for Population Schema purposes only.

Creating Population Schemas

Each Population Schema consists of an identifer and a number of users who are associated with that schema. To create a new Population Schema, click the Create A Population Schema link on the main admin screen. Timesheet will display the Population Schema Creation Screen.

This screen is divided into the parts: To create a new Population Schema, simply enter a name for the new schema and click the button. Timesheet will refresh the Population Schema Creation Screen and display a green text message confirming the creation of the new Population Schema. Now that the schema has been created, you will need to assign it to one or more users. The process of assigning schemas to users is covered below.

Assigning Schemas To Users

Population Schemas must be assigned to users before they can be implemented. Assigning schemas to users is a two step process: first, the Timesheet Admin should search for the users who will be assigned to the schema in question; second, the Timesheet Admin actually makes the schema assignment. Both steps of this process are described in detail below.

The schema assignment process may be started either via the Assign a Population Schema to Users link, located under the Timesheet Population and Mass Approval header on the main admin screen or by clicking the button that is displayed on each schema-related screen within Timesheet.

Schema Assignment User Search
The first step in the schema assignment process is to search for the users who will be assigned to a particular schema using the User Search Screen. This screen is used to search for users to be assigned to a particular Population Schema. Timesheet allows you to search by: Once the desired search criteria have been entered, click the button. Timesheet will display the Population Schema Assignment Screen.
Population Schema Assignment
The Population Schema Assignment Screen displays the results of the user search performed above. This screen lists a maximum of 25 users at one time; however, each user who matched the criteria specified in the user search is viewable by scrolling though the results via the though and the and buttons located above the search results. To assign a Population Schema to the displayed users, simply select an available schema from the dropdown menu located just below the list of displayed users and click the button.

Timesheet will display the Schema Assignment User Search Screen including a green text message confirming the assignment of the selected Population Schema to the selected users.

Please Note: The schema assignment process does not allow you to select a subset of users from the returned search results. Therefore, each user who matched the search criteria, even those not actively displayed on the Schema Assignment Screen, will be assigned to the selected schema when the button is clicked.

Executing Population Schemas

Once the required Population Schemas have been created and assigned to users, Timesheet is prepared to implement those schemas. Schemas are executed by the Timesheet Admin using the Population Schema Execution Screen. The admin must provide the following information to Timesheet when preparing to execute each schema:

The schema execution process may be started either via the Execute a Population Schema link, located under the Timesheet Population and Mass Approval header on the main admin screen or by clicking the button that is displayed on each schema-related screen within Timesheet.

To execute a Population Schema, enter the information as described above and click the button. Timesheet will refresh and display a green text message indication that the schema is being executed. Additionally, a second window will be momentarily displayed. This window will close itself after a few moments. Finally, Timesheet will send an email report to the specified email address detailing the results of the schema execution.

Population Schema Reports
After a Population Schema has been implemented, Timesheet will email a report on the results of the schema execution to the email address specified when the schema was executed. This report displays a list of the users affected by the Population Schema including: If any errors are encountered during the schema execution, these will also be contained within the emailed report. Potential errors that may be encountered during the execution of a Population Schema are:

Mass Approvals

Timesheet v4.5 allows your organization to execute mass approvals of all open and submitted timesheets that are associated with a particular Population Schema. To utilize the Mass Approvals functionality, the Timesheet administrator must first create and implement Population Schemas for all users who will be subject to mass approvals. While Population Schemas are covered in detail above, this section will focus on the process of performing Mass Approvals. The Mass Approval process generates an email report detailing the results of the mass approval.

The Time Mass Approvals Screen is available from the main admin screen via the Mass Approval Of Populated Timesheets link, located under the Timesheet Population and Mass Approval header or by clicking the button which is found on each screen associated with Population Schemas.

Please Note: Users must have an approval process assigned to them before implementing a Mass Approval of open timesheets.

To execute a Mass Approval of Populated Timesheets:

  1. Select the schema whose populated timesheet will be approved
    All available schemas will be listed in the dropdown menu under the Schema header on the Mass Approvals Screen
  2. Enter the email address to which the Mass Approvals report should be mailed
  3. Click the button.
    Timesheet will refresh and display a green text message indication that the Mass Approval is being executed. Additionally, a second window will be momentarily displayed. This window will close itself after a few moments. Finally, Timesheet will send an email report to the specified email address detailing the results of the Mass Approval execution.

Mass Approval Reports

After a Mass Approval has been executed, Timesheet will email a report on the results of the approval to the email address specified when the Mass Approval was executed. This report displays a list of the users affected by the Population Schema including: If any errors are encountered during the Mass Approvals process, these will also be contained within the emailed report. Potential errors that may be encountered during the execution of a Population Schema are:

Tasks, Pay Types and Bill Types

Journyx Timesheet uses three additional items to further categorize any specific time entry: tasks, pay types, and bill types. Each of these items may be renamed to meet your organization's needs, as discussed below in the Global Preferences section. However, for this portion of this manual the default names will be used.

Tasks

The Task field is used for describing the type of activity on which an employee has spent time. Sales, Development, Support, Consulting, and Management are common examples of Tasks. Timesheet comes standard with several default Tasks. More Tasks can be added and the defaults can be removed. Tasks can be created, modified and deleted from the Global Task Entry and Modification Screen which is available from the main admin screen via the Task link.

Creating Tasks

To create a new Task, please follow the guidelines below:

Modifying Tasks

To modify and existing task, please follow the guidelines below:

Deleting Tasks

There may be situation that require the deletion of a Task. Before you delete a Task, please note that it will be forever removed from the system and this may create orphaned records in the database that could cause errors to occur. If you still need to delete a Task, please follow the guidelines below:

Pay Types

The Pay Type field is used for describing the type of activity on which an employee has spent time in relation to how they should be paid. Pay Types often affect and are affected by Accruals. Vacation, Sick Time, Holidays, and Regular or Standard are common examples of Pay Types. Timesheet comes standard with several default Pay Types. More Pay Types can be added and the defaults can be removed. Pay Types can be created, modified and deleted from the Global Pay Types Entry and Modification Screen which is available from the main admin screen via the Pay Types link.

Creating Pay Types

To create a new Pay Types, please follow the guidelines below:

Modifying Pay Type

To modify and existing Pay Type, please follow the guidelines below:

Deleting Pay Type

There may be situation that require the deletion of a Pay Type. Before you delete a Pay Type, please note that it will be forever removed from the system and this may create orphaned records in the database that could cause errors to occur. If you still need to delete a Pay Type, please follow the guidelines below:

Bill Types

The Bill Type field is used for describing the type of activity on which an employee has spent time in relation to how that time can be billed. Billable and Non-Billable are common examples of Bill Types. Timesheet comes standard with several default Bill Types. More Bill Types can be added and the defaults can be removed. Bill Types can be created, modified and deleted from the Global Bill Types Entry and Modification Screen which is available from the main admin screen via the Bill Types link.

Creating Bill Types

To create a new Bill Types, please follow the guidelines below:

Modifying Bill Type

To modify and existing Bill Type, please follow the guidelines below:

Deleting Bill Type

There may be situation that require the deletion of a Bill Type. Before you delete a Bill Type, please note that it will be forever removed from the system and this may create orphaned records in the database that could cause errors to occur. If you still need to delete a Bill Type, please follow the guidelines below:

Time Entry


Journyx Timesheet provides a straightforward web interface for logging time against specific projects, with each entry containing pertinent information such as what task was being performed and whether or not that particular entry is billable to a customer. The types of additional information are customizable to meet your organization's needs. Customization is discussed in more detail below. This section focusses on configuring Timesheet for time entry and the actual time entry process.

Time Periods

Before users can begin to take advantage of Journyx Timesheet, the system admin must create and assign the Time Periods that your organization will be using for time tracking. A Time Period may be thought of as the equivalent to a pay period. Although these do not necessarily need to match exactly, admins and users typically find it most intuitive if they do. Timesheet ships with one default Time Period: Weekly. This Time Period covers 7 days that run from Sunday through Saturday. If your organization needs to use different Time Periods, Timesheet allows you to create any number of Time Periods to meet those needs.

Time Period Definition

The Time Periods that will be used by your organization must be defined before they can be assigned to users. The Time Period Creation and Deletion Screen is available from the main admin screen via the Time Period Definition link. Timesheet ships with only one default Time Period - the standard Sunday through Saturday weekly period. There is no limit to the number of Time Periods that can be defined and used in Timesheet, however most organizations find that only four or five periods are needed at most. The process of creating a new Time Period is outlined below:
  1. Enter a name for the new Time Period
    Choose a name that provides some description of the time period in question. Example names include:
  2. Choose a type for the new Time Period
  3. Click the Create New Time Period button.
The Time Period Creation and Deletion Screen will refresh and display a green text message confirming the creation of the new Time Period. Additionally, the newly created Time Period will be displayed in the list of currently existing time periods near the top of this screen.

Time Period Deletion

In the event that you need to delete an existing Time Period, simply select the Time Period in question and click the delete button. Timesheet will display a popup window asking you to confirm that you wish to delete the selected Time Period. Please Note: If the time period in question is assigned to any Time Entry Screen, you will receive a red text message that states that the time period could not be removed because it is in use.

Time Entry Screens

Once the Time Periods that your organization will use for time tracking have been created, you can then modify the existing Time Entry Screens to use these time periods or create new screens that will coincide with the time periods. Timesheet ships with ten default Time Entry Screens: Each of these screens is, by default, based on the Weekly time period that ships with Timesheet. All of these Time Entry Screens can be modified to change a large number of options as well as the Time Period associated with them.

Modifying Time Entry Screens

There are a large number of customizable options related to each Time Entry Screen. Each of these is discussed below in greater detail.

General Options    
Option Value Results
Add this screen To all new groups? yes

Selecting "yes" for this setting will cause this Time Entry Screen to be made available by default to any newly created groups. If you are creating a Time Entry Screen that will be used by a majority of your organization, this setting is recommended.
  no Selecting "no" for this setting will create a Time Entry Screen that must be added manually to any group that will be required to access it. If you are creating a Time Entry Screen that will be used by a minority of your organization, this setting is recommended.
     
Should each entry have its own row, or should a grid of dates vs. entry types be displayed? Grid Format A Grid Format Time Entry Screen presents the user with a grid of dates and spaces to enter time for the dates that are displayed. Multiple entries for a given day are possible in this format.
  Entry Format An Entry Format Time Entry Screen presents users with a short list of dropdown menus that allow that user to select the parameters for a specific entry. In this format, each entry is unique and does not appear as part of a day's work. Instead, each entry appears unique.
     
If using Grid Format, exchange rows and columns? no The rows and columns remain in the default configuration.
  yes Rows and columns are exchanged for this Time Entry Screen. Please Note: If you select yes for this option, all references to rows and columns should be considered exchanged for the rest of the Time Entry Screen configuration.
     
Should arrows for moving forward and backward in time be displayed? yes A set of arrows will be displayed that allow users to move between previous and future time periods. Please Note: These arrows move in the same direction that dates are displayed on this screen.
  no  
     
If using Grid Format, should row and column totals be displayed? Both Totals for daily hours worked as well as for each unique combination of Project/Task/Pay Type/Bill Type will be displayed at the bottom and far right of the entry area, respectively.
  Column Totals for daily hours worked will be displayed at the bottom of the entry area
  Row Totals for each unique combination of Project/Task/Pay Type/Bill Type will be displayed at the far right of the entry area
  None Totals will not be displayed
     
Should project descriptions be shown in dropdowns? yes The Project dropdown menu will display both the project name as well as its description.
  no The Project dropdown menu will display project names only
     
Enable Javascript Enhancements? yes Any totals that were selected to be displayed for this screen will update automatically as hours are entered
  no Any totals that were selected to be displayed for this screen will update only after the Save Changes button has been clicked

Time Entry Options    
Option Value Results
Choose a default time period Varies This option is used to define which Time Period this time enrty screen will use. By default, the standard Sun-Sat weekly time period that ships with Timesheet is selected. If you have created different time periods for your organization to use, they will also be available in this dropdown select box.
     
Should time be entered as a number of hours or as start and stop times? Hours Worked Requires users to enter their time as an amount of actual hours worked, i.e., 5:15 or 5.25 (see below for information on entering time as hours and minutes and/or decimal numbers)
  Start/Stop Requires users to use the start/stop button so that Timesheet's internal clock determines the actual hours worked for a specific project. Please Note: For this feature to work properly, the admin must enable the Start/Stop button in the Global Preferences portion of Timesheet, which is discussed in detail below.
     
Should time be entered in a decimal or HH:MM format? Either Allows users to enter time in either HH:MM format or as a decimal string.
  HH:MM Requires users to enter time in HH:MM format (i.e., 5:15 for five hours and fifteen minutes)
  Decimal Requires users to enter time as a decimal string (i.e., 5.25 for five hours and fifteen minutes). Please Note: Timesheet rounds all decimal entries to the closest whole minute; therefore, an entry of 4.13 (4 hours and 7.8 minutes) will translate to 4 hours and 8 minutes.
     
Should the range of days be displayed back from the present, or forward to the present? Forward Displays the time period for this Time Entry Screen as a range of dates that runs from the start of the period to the end (left to right), i.e., a weekly time period that begins on the 3rd of the month will be displayed as running from the 3rd through the 9th. Please Note: The direction you chose here will affect the behavior of the forward and backward arrows if they are present on this screen.
  Back Displays the time period for this Time Entry Screen as a range of dates that runs from the end of the period to the beginning (left to right), i.e., a weekly time period that begins on the 3rd of the month will be displayed as running from the 9th through the 3rd. Please Note: The direction you chose here will affect the behavior of the forward and backward arrows if they are present on this screen.

Row Options    
Option Value Results
How many Blank rows should be displayed? User Preference Displays the number of blank rows for time entry that each user has set in his individual preferences
  Number 1 - 20 Displays a set number (from 1 to 20) of blank rows for time entry
     
Should Memorized Entry rows for the user and group be displayed? Yes Allows memorized time entries to be displayed on this Time Entry Screen
  No Prevents all memorized time entries from being displayed on this time entry screen
     
In what order should time rows be displayed? Current/Memorized/New This layout is recommended for organizations that will be using a small number of specific unique combinations of Project/Task/Pay Type and Bill Type
Causes Timesheet to show entry rows in the following order:
  1. Current Entries - these are entries that have been entered already
  2. Memorized Entries - these are Memorized Time Entries that have been defined by either the individual user or by the administrator and then assigned to particular groups
  3. New Entries - these are "blank" entry rows that have not been modified in any way
  New/Current/Memorized This layout is recommended for organizations that will be using a mid-range number of specific unique combinations of Project/Task/Pay Type and Bill Type
Causes Timesheet to show entry rows in the following order:
  1. New Entries - these are "blank" entry rows that have not been modified in any way
  2. Current Entries - these are entries that have been entered already
  3. Memorized Entries - these are Memorized Time Entries that have been defined by either the individual user or by the administrator and then assigned to particular groups
  New/Memorized/Current This layout is recommended for organizations that will be using a mid-range number of specific unique combinations of Project/Task/Pay Type and Bill Type as well a as selection of Memorized Time Entries
Causes Timesheet to show entry rows in the following order:
  1. New Entries - these are "blank" entry rows that have not been modified in any way
  2. Memorized Entries - these are Memorized Time Entries that have been defined by either the individual user or by the administrator and then assigned to particular groups
  3. Current Entries - these are entries that have been entered already
  Current/New/Memorized This layout is recommended for organizations that will be using a small number of specific unique combinations of Project/Task/Pay Type and Bill Type as well as a selection of Memorized Time Entries
Causes Timesheet to show entry rows in the following order:
  1. Current Entries - these are entries that have been entered already
  2. New Entries - these are "blank" entry rows that have not been modified in any way
  3. Memorized Entries - these are Memorized Time Entries that have been defined by either the individual user or by the administrator and then assigned to particular groups
  Memorized/New/Current This layout is recommended for organizations that will be using a selection of Memorized Time Entries as well as a mid-range number of specific unique combinations of Project/Task/Pay Type and Bill Type
Causes Timesheet to show entry rows in the following order:
  1. Memorized Entries - these are Memorized Time Entries that have been defined by either the individual user or by the administrator and then assigned to particular groups
  2. New Entries - these are "blank" entry rows that have not been modified in any way
  3. Current Entries - these are entries that have been entered already
  Memorized/Current/New This layout is recommended for organizations that will be using a selection of Memorized Time Entries as well as a small number of specific unique combinations of Project/Task/Pay Type and Bill Type
Causes Timesheet to show entry rows in the following order:
  1. Memorized Entries - these are Memorized Time Entries that have been defined by either the individual user or by the administrator and then assigned to particular groups
  2. Current Entries - these are entries that have been entered already
  3. New Entries - these are "blank" entry rows that have not been modified in any way
     
Should the shortcut link to expenses appear on each row of the time entry screen? Yes Enables the dollar sign ( $ ) shortcut link to Expense Entry to the right of each time entry. Please Note: If your organization is not using the expense entry functions of Timesheet, this option should be set to "no"
  No Disables the dollar sign ( $ ) shortcut link to the right of each time entry.

Column Options
Timesheet allows the admin to control certain aspects of the time entry columns for any given Time Entry Screen. The attributes that may be modified are Priority and Default Value. Additionally, the comments column can be set to have a lower maximum number of characters than the default maximum of 252 characters.

Priority

Each column must be assigned a Priority. This Priority defines the order of columns on the Time Entry Screen. A column may be assigned a Priority of zero, which will hide it on the Time Entry screen. A column with a Priority of zero must have a default value assigned. Each Priority other than zero can only be assigned to one column.

Default Value

A default value may be assigned for each column. The default value is only important for a column that has a priority of zero. The default value assigned to a hidden column will be associated with every time entry made from this Time Entry screen. Please Note: The default value for a column does not appear as the default choice for a column that has a priority other than zero. Column options are displayed in alphabetical order and the default choice for a non-hidden column will always be the first alphabetical choice.

Maximum Characters

By default, Timesheet allows a maximum of 252 characters for the comments column for any particular Time Entry Screen. You may choose to specify a lower number of characters as the maximum for any Time Entry screen, but you may not specify a higher number, as 252 is the maximum number of characters that the Timesheet database is designed to hold for this field.

HTML Options Timesheet allows you to define text to be displayed immediately above and below the time entry columns and rows. These fields accept plain text, HTML tags, and a selection of "tricky tags" that pull information directly from the Timesheet database.

You may enter up to 250 characters worth of text, HTML tags or tricky tags in each of the two boxes at the bottom of this screen. The tricky tags available and the information they display are:
<Name> Displays the login ID of the active user
<Authorization> This tag is specifically for use by the Journyx Professional Services team .
<Reserved> This tag is specifically for use by the Journyx Professional Services team .
<Number of Input Records> Displays the number of blank rows that appear on this time enrty screen for the active user. This number may be set globally for the Time Entry screen or may be left to the individual user to specify for himself.
<Number of Output Records> This tag is specifically for use by the Journyx Professional Services team .
<Number of Dates> Displays the number of days contained in the time period upon which this time entry screen is based
<Full Name> Displays the full User Name of the active user
<Default Comment> Displays the default comment that the active user has defined under his preferences tab
<Other Options> This tag is specifically for use by the Journyx Professional Services team .
<Expense Entry GUI in Use> Displays the name of the Expense Entry screen assigned to the active user
<Time Entry GUI in Use> Displays the name of the Time Entry screen assigned to the active user
<Domain ID> Displays the name of the Domain that contains the active user

Users


Roles

Every individual who will access Timesheet is considered a user. Users can have one of several different roles that determine what abilities and access they will have in relation to Timesheet. The default possible roles in Timesheet are: User, Manager, Project Manager, Reporter, Time Keeper, and Admin. Below is a list of the possible roles and a summary of the abilities that each role possesses.

User Creation and Modification

To create and modify users in Timesheet, an admin should enter the User Entry and Modification Screen from the main admin screen. This screen allows an admin access to all the necessary tools for user entry and modification. Existing users are displayed alphabetically in groups of 10 on this page. The navigation buttons at the top of the screen allow the admin to jump quickly between the different pages of users. For example, by pressing the Next 10 button, an admin can "scroll forward" to the next group of 10 users in the list. An admin may also choose to press one of the letters in the navigation portion, which will take him/her to the "top" of the list of users for that letter.

To modify or delete a user, an admin must select that user by clicking the box under the select name column, placing a check mark there to indicate which user(s) are to be modified or deleted. The admin then must click the Modify or Delete button. If a user is being deleted, a pop up window confirming this process will appear. Modification of users is covered below under the Global User Modification Screen.

Additionally, in the User Entry and Modification screen an admin may create up to five new users at a time. The creating admin must enter the Login Name, First Name and Last Name for the user(s) to be added. Additionally, it is at this time that a users' role and approval template are specified. Once all necessary data has been entered, the admin should click the Create New Users button. This will take the admin to the Global User Modification Screen.

Global User Modification Screen
This screen provides admins with the necessary tools to modify and assign the full range of characteristics that apply to users. Authority, Group affiliation, Hidden/Unhidden status, Recs to Input, Days Displayed, Dates in choice list, Full name, Initial Comments, Time Entry Screen for a specific user, Expense Entry Screen for a specific user, and Business Process are all accessible in this screen. Once the desired changes have been made to all selected users, the admin may click the Go To Extra User Fields button or the Perform Modifications button. The Perform Modifications button will activate the specified modifications and return the admin to the User Entry and Modification screen. The Extra User Fields Screen is described below.

Extra User Fields Screen
This screen provides access to the extended user information fields. Timesheet 4.0 ships with the following default values: Phone Number, Employee Type, Email Address, Bill Rate, Rate Period Type, Employee Number, Title, Department, Manager Name, Pay Rate, and Pay Rate Type. The current fields may be edited and additional fields may be added by the admin in the Editing Extra User Fields screen, discussed below. Once the desired changes have been made, the admin should click the Save Changes button, which will then commit the changes and return the admin to the User Entry and Modification screen. If the admin wishes to abandon the changes, he/she should click the Return to User Management link and he/she will be returned to the User Entry and Modification Screen and the changes to the Extra User Fields will not be made.

Custom Roles In Timesheet v4.5


Journyx TimesheetTM v4.5 can be equipped with the Custom Roles optional module. This optional module will allow your organization to create new user roles based on the different role abilities that exist by default within each installation of Timesheet. This section will discuss the concept and processes associated with creating custom roles for use by your organization.

This portion of the Timesheet Owner's Manual is divided into the following sections:

  1. The Custom Roles Interface Screen
    This section will familiarize you with the layout of the Custom Roles Interface Screen.
  2. Description Of Role Abilities
    This section lists and describes each of the individual role abilities in Timesheet.
  3. Creating A Custom Role
    This section describes the process of creating a custom role.
  4. Modifying An Existing Custom Role
    This section explains how to modify an existing custom tole.
  5. Deleting A Custom Role
    This section details the process of deleting a custom role.
  6. Default Roles And The Role Abilities Possessed By Each
    This section provides a quick reference chart that displays the role abilities associated with each of the default roles that come standard with every Journyx Timesheet installation.

I. The Custom Roles Interface Screen

This section should help familiarize you with the Custom Roles Interface Screen. The screen itself is displayed below after one custom role has been created. As you can see, the screen is divided into three sections, each of which is explained immediately below.


The Three Sections Of The Custom Roles Interface Screen

II. Description Of The Role Abilities

Each role within Timesheet consists of a collection of role abilities. These role abilities determine what sort of access each individual who is assigned a specific role will have in relation to the myriad functions that Timesheet is capable of providing. This section lists and describes each of the role abilities within Timesheet v4.5.
Role Ability   Description
Approvals Management    
Approver - Regular   The Approver - Regular role ability allows the approval of Time, Mileage and Expense sheets that have been submitted to the user by others who have this user as their assigned approver.
Approver - Super   The Approver - Super role ability allows the approval of Time, Mileage and Expense sheets that have been submitted by any user within the Timesheet database.
Role Authority    
Authority - Administrator   The Authority - Administratorr role ability provides the ability to execute administrator level functions and system software adjustments, such as license key changes and global preference modifications.
Authority - Manager   The Authority - Manager role ability provides the ability to execute manager level functions, such as password changes and approval template assignment for users who are in at least one common group with the Manager.
Authority - Punch User   The Authority - Punch User role ability provides the ability to use the punch screen interface.
Authority - Reporter   The Authority - Reporter role ability provides limited reporting ability without Time, Mileage or Expense Entry access.
Authority - Timekeeper   The Authority - Timekeeper role provides the ability to enter time records for other users in same group as the user to whom this role has been assigned.
Authority - User   The Authority - User role provides Time, Expense and Milage entry access to the user to whom this role has been assigned.
Button Access    
Button - Admin   Displays the Admin button in the button bar. To create a role that does not have access to the administrative functions associated with that role's Authority, do not assign this role ability to that role.
Button - Details   Displays the Details button in the button bar.
Button - Expenses   Displays the Expenses button in the button bar. To create a role that cannot access Expense Entry screens, do not assign this role ability to that role.
Button - Extra Button   Displays the Extra button, as defined in Timesheet's Global Preferences.
Button - Help   Displays the Help button in the button bar.
Button - Home Button   Displays the Home button in the button bar.
Button - Journals   Displays the Journals button in the button bar. To create a role that cannot access the Journals features of Timesheet, do not assign this role ability to that role.
Button - Logout   Displays the Logout button in the button bar.
Button - Mileage Entry   Displays the Mileage button in the button bar. To create a role that cannot access Mileage Entry screens, do not assign this role ability to that role.
Button - Password   Displays the Password button in the button bar. To create a role that prevents a user from changing his or her own password, do not assign this role ability to that role.
Button - Preference   Displays the Preferences button in the button bar. To create a role that prevents a user from changing his or her own preferences, do not assign this role ability to that role.
Button - Reports   Displays the Reports button in the button bar. To create a role that cannot access the reporting functions of Timesheet, do not assign this role ability to that role.
Button - Time Entry   Displays the Time Entry button in the button bar. To create a role that cannot access Time Entry screens, do not assign this role ability to that role.
Prior Period Adjustments (Corrections)    
Corrections - Expense   This role ability is currently reserved for use by the Journyx Professional Services team.
Corrections - Mileage   This role ability is currently reserved for use by the Journyx Professional Services team.
Corrections - Time   The Corrections - Time role ability provides the user to whom this role ability has been assigned with the ability to make adjustments to previously approved Time Entries. Changes can be made to time records created by any user within the Timesheet database.
Conversions Table Maintenance    
Mileage Conversion - Controller   The Mileage Conversion - Controller role ability provides users whose role contains this role ability with the ability to create and modify Mileage conversion tables.
Currency Conversion - Controller   The Currency Conversion - Controller role ability provides users whose role contains this role ability with the ability to create and modify Currency conversion tables.
Disconnected Client Module Access    
DC - Expense   The DC-Expense role ability provides access to Disconnected Client Expense Entry forms for users whose role has been assigned this role ability. Please Note: To use any DC role abilities, your organization must have purchased the Disconnected Client optional module for Timesheet.
DC - Mileage   The DC-Mileage role ability provides access to Disconnected Client Mileage Entry forms for users whose role has been assigned this role ability. Please Note: To use any DC role abilities, your organization must have purchased the Disconnected Client optional module for Timesheet.
DC - Project   The DC-Project role ability provides access to Disconnected Client Project Creation forms for users whose role has been assigned this role ability. Please Note: To use any DC role abilities, your organization must have purchased the Disconnected Client optional module for Timesheet.
DC - Time   The DC-Time role ability provides access to Disconnected Client Time Entry forms for users whose role has been assigned this role ability. Please Note: To use any DC role abilities, your organization must have purchased the Disconnected Client optional module for Timesheet.
Rate Reporting    
Modify Rate Report   The Modify Rate Report role ability provides users whose role contains this role ability with the ability to modify rate reports.
Run Rate Check Report   The Run Rate Check Report role ability provides users whose role contains this role ability with the ability to run the Rate Check Report in Timesheet.
Run Rate Report    The Run Rate Report role ability provides users whose role contains this role ability with the ability to run all existing rate reports within Timesheet.
Project Controls    
Project - Add   The Project - Add role ability provides access to the Project Creation functions of Timesheet.
Project - Delete   The Project - Delete role ability provides access to the Project Deletion functions of Timesheet.
Project - Modify   The Project - Modify role ability provides access to the Project Modification functions of Timesheet.
SubProject Controls    
Project - Add Sub   The Project - Add role ability provides access to the SubProject Creation functions of Timesheet. Please Note: To use any of the SubProject Controls role abilities, your organization must have purchased the SubProjects expansion module for Timesheet.
Project - Delete Sub   The Project - Delete role ability provides access to the SubProject Deletion functions of Timesheet. Please Note: To use any of the SubProject Controls role abilities, your organization must have purchased the SubProjects expansion module for Timesheet.
Project - Modify Sub   The Project - Modify role ability provides access to the Project Modification functions of Timesheet. Please Note: To use any of the SubProject Controls role abilities, your organization must have purchased the SubProjects expansion module for Timesheet.
Scheduling    
Schedule - Create For Groups   The Schedule - Create For Groups role ability provides access to the Group Schedule Creation functions of Timesheet.
Schedule - Create For Others   The Schedule - Create For Others role ability allows a user whose role includes this ability to create schedules for other users within the Timesheet database.
Schedule - Create For Self   The Schedule - Create For Self role ability allows a user whose role contains this ability to create schedules for him- or herself.
User Controls    
User - Add   The User - Add role ability allows a user whose role includes this ability to create new users within the Timesheet database.
User - Delete   The User - Delete role ability allows a user whose role includes this ability to create delete users from the Timesheet database.
User - Modify   The User - Modify role ability allows a user whose role includes this ability to modify existing users within the Timesheet database.

III. Creating A Custom Role

With the Custom Roles optional module for Journyx Timesheet, your organization can create any number of custom roles to assign to your users. Each user in Timesheet must have a role assigned to him or her, and this role determines what level of access that user will have within Timesheet. Journyx ships a number of default roles with Timesheet; however, we understand that your organization may need one or more different roles to meet your needs. You can use the Custom Roles module to create very specific roles, or, more commonly, to create a new role that blends the abilities of two or more of the existing default roles. The process of creating a new custom role is outlined below.

  1. Enter a name for the new custom role
    Enter a name that will help you identify the new role when you see it in the drop down list of available roles when you create new users. This name may be up to 30 characters.
  2. Enter a description for the new custom role
    Enter a more detailed description of the new role. This description may be up to 60 characters.
  3. Select the role abilities for the new custom role
    Choose the role abilities that you want the new role to encompass. You must choose at least one role ability at the time of role creation. You may add others later by modifying this custom role. To select more than one role ability, simply control-click each ability you wish to add to this role.
  4. Select the Groups that should have access to the new custom role
    Choose the groups that will have the new role as part of their group structure. For more on roles and groups, please see the Groups portion of this manual. To select multiple groups, simply control-click each group you wish to have access to the new custom role.
  5. Select the users who should be assigned the new custom role
    At the time of custom role creation, you can assign this new custom role to one or more users within your organization's Timesheet installation. To assign this role to multiple users, simply control-click each user who should have this role.
  6. Indicate the override status of the new role
    Additionally, you may automatically remove any selected users from all previously assigned roles when you assign the newly created custom role to them, leaving them with just the new role assignment. To do this, click the checkbox under the Remove Selected Users From Previous Roles? checkbox.
  7. Click the Button.
Timesheet will refresh the Custom Roles Interface Screen and display a green text message confirming the creation of the new custom role. Additionally, the newly created role will be listed in the Custom Roles portion of the Custom Roles Interface Screen. The new role is now available for modification or deletion. Finally, this new role is now listed in the role assignment portion of the User creation and modification screens and can be freely assigned to any user in your organization's installation of Timesheet.

IV. Modifying A Custom Role

Custom roles that have been created in your organization's installation of Timesheet can be modified to add or remove role abilities from them.
Please Note: Timesheet will not allow you to modify a role that you yourself are currently a member of. To modify such a role, you will first need to have that role assignment removed from you.

To add or remove role abilities from an existing custom role:

  1. Click the checkbox () to the left of the role or roles you wish to modify.
  2. Control-click the role abilities you wish to add to or remove from the selected custom role(s).
  3. Click the Button.
Timesheet will refresh the Custom Roles Interface Screen, displaying a green text message confirming the modification of the custom roles in question. This modified role(s) are now available for further modification. These roles may now also be assigned to new users. Any changes that have been made to a custom role are immediately in effect for any users who have that role assigned to them.

V. Deleting A Custom Role

Custom roles that have been created in your organization's installation of Timesheet may be deleted if no longer needed and they are not currently assigned to any user. If you attempt to delete a custom role that is assigned to even one user, you will receive the following error message:

This message informs you which roles were not deleted, in the event that you have attempted to delete more than one custom role at a time.

The process of deleting a custom tole is fairly straightforward and is outlined below:

  1. Click the checkbox () to the left of the role or roles you wish to delete.
  2. Click the Button.
  3. Timesheet will display a popup window asking you to confirm that you wish to delete the selected custom role(s). Click the Button.
Timesheet will refresh the Custom Roles Interface Screen, displaying a green text message confirming the deletion of the selected custom roles. The delete custom role(s) are no longer available for use by any user within your organization's installation of Journyx Timesheet.

VI. Default Roles And The Abilities Possessed By Each In Timesheet v4.5

The table below lists each of the default roles within Timesheet v4.5 and marks each ability possessed by those roles with a green bullet yes. This table can be used to compare and contrast the default roles to help you better develop a methodology for creating custom roles.

  Administrator User Manager Project Manager Timekeeper Reporter Punch User DC Access Schedule User
Approvals Management                  
Approver - Regular     yes yes          
Approver - Super yes                
Role Authority                  
Authority - Administrator yes                
Authority - Manager     yes yes          
Authority - Punch User             yes    
Authority - Reporter           yes      
Authority - Timekeeper yes       yes        
Authority - User   yes yes yes yes   yes   yes
Button Access                  
Button - Admin yes yes yes yes yes yes     yes
Button - Details yes yes yes yes   yes     yes
Button - Expenses   yes yes yes         yes
Button - Extra Button yes yes yes yes yes yes     yes
Button - Help yes yes yes yes yes yes     yes
Button - Home Button   yes yes yes yes       yes
Button - Journals yes yes yes yes   yes     yes
Button - Logout yes yes yes yes yes yes yes   yes
Button - Mileage Entry   yes yes yes         yes
Button - Password yes yes yes yes yes yes     yes
Button - Preference yes yes yes yes         yes
Button - Reports yes yes yes yes yes yes     yes
Button - Time Entry   yes yes yes yes       yes
Prior Period Adjustments (Corrections)                  
Corrections - Expense yes                
Corrections - Mileage yes                
Corrections - Time yes                
Conversions Table Maintenance                  
Mileage Conversion - Controller yes                
Currency Conversion - Controller yes                
Disconnected Client Module Access                  
DC - Expense               yes  
DC - Mileage               yes  
DC - Project               yes  
DC - Time               yes  
Rate Reporting                  
Modify Rate Report yes                
Run Rate Check Report yes                
Run Rate Report yes                
Project Controls                  
Project - Add yes     yes          
Project - Delete yes     yes          
Project - Modify yes     yes          
SubProject Controls                  
Project - Add Sub yes yes   yes         yes
Project - Delete Sub yes yes   yes         yes
Project - Modify Sub yes yes   yes         yes
Scheduling                  
Schedule - Create For Groups yes   yes yes yes        
Schedule - Create For Others yes       yes        
Schedule - Create For Self yes               yes
User Controls                  
User - Add yes                
User - Delete yes                
User - Modify yes yes yes yes yes   yes   yes

Disconnected Client Module


Journyx Timesheet v4.5 provides your organization with the ability to allow users who are not connected to the internet or your company intranet to track their time, mileage and expenses. Additionally, users whose roles allow them to create projects may create projects while in a disconnected state as well.

The ability to use Timesheet while not directly connected to the Timesheet server is provided by the Disconnected Client module. The setup and use of this module is discussed fully in this section. Certain settings must be implemented on the server side before this module can be implemented. These configuration issue will be covered first. This document will then describe the disconnected client functionality from the client side, discussing the procedures for using the Disconnected Client module to create projects and track time, mileage and expenses while actually disconnected.

Please Note: For the Disconnected Client module to function properly, an email account capable of sending and receiving emails must be created in your organization's email system for Timesheet. Timesheet uses this account to send outbound DC forms emails and to process incoming DC forms emails. This account must be created and in place before you begin to configure and use the Disconnected Client module. Journyx recommends creating a new mail account named Discon in your organization's email system for this purpose. The password for this account may be anything your organization chooses. The mail account name and password must be entered in the Disconnected Client Basic section of the Global Preferences of Timesheet.

Timesheet Server Configuration

Before the Disconnected Client module can be used, you must access and modify the Disconnected Client portion of Timesheet's Global Preferences to specify the outbound and incoming mail server names and ports. Additionally, you should ensure that each user who will be using the disconnected client features has an email address assigned to him via the User Modification feature of Timesheet. Without an assigned email address, users will be required to enter a valid email address each time they request offline forms.

Global Preferences: Disconnected Client Basic

The Disconnected Client Basic portion of the Global Preferences modification screen provides access to the following settings for the Disconnected Client module: Each of these settings is explained in detail below.
Disconnected Client Basic Settings
Disconnected Client Mail Text Settings
Disconnected Client Mail Sending Settings
Disconnected Client Mail Receiving Settings
After you have made any desired changes to the settings for these options, click the Modify Preference Values button at the bottom of this screen. Timesheet will refresh the Global Preferences/Disconnected Client Basic screen and your changes will now be shown for the values affected.

Global Preferences: Disconnected Client Advanced

The Disconnected Client Advanced portion of the Global Preferences modification screen provides access to the following settings for the Disconnected Client module: Each of these settings is explained in detail below.
Disconnected Client User Visible Text Settings
Disconnected Client Advanced Settings

Users

For the Disconnected Client module to function properly, each user who is expected to have access to Disconnected Client features must meet three requirements:
Assigning An Email Address To A User
  1. Access the user modification screen by clicking the Users link under the User Management header on the main admin screen
  2. Select the user(s) in question
  3. Click the Modify button
  4. On the Global User Modification screen, click the Go To Extra User Fields button
  5. On the Extended User Information Entry and Modification screen, enter the users' email address
  6. Click the Save Changes button
  7. The Extended User Information Entry and Modification screen will refresh, displaying a green text message confirming the modification of records
  8. Repeat as necessary to assign an email address to each user who will be accessing the Disconnected Client features of Timesheet.

Disconnected Client User Management

Once all users who will be accessing the Disconnected Client features of Timesheet v4.5 have been configured to function as DC Users, you will need to access the Disconnected Client User Management Screen via the Disconnected Users Management link at the top of the main admin screen.

The DC User Screen provides the Timesheet Administrator with access to all the controls required to effectively implement and manage a successful Disconnected Client environment in Timesheet v4.5. This screen lists each user who has access to the DC functions of Timesheet and provides the following information for each user:

Using The Disconnected Client Module

The Disconnected Client Module for Journyx Timesheet uses emailed HTML forms to provide users the ability to track time, mileage and expenses while not connected to your organizations' Timesheet server. Additionally, users whose roles allow them to create projects are also able to create projects while disconnected through the use of forms specifically designed for project creation. This section will discuss the process of requesting, working with, and submitting the Disconnected Client forms for each of the four possible disconnected functions.

Please Note: Before the Disconnected Client module will allow users to request forms, each user must access their preference settings via the Preferences button located within the navigation bar that runs across the top and bottom of each screen within Timesheet. Additionally, each user who will be accessing the disconnected client feature must have at least one time record entered into Timesheet before he will be allowed to request disconnected client forms.

The Disconnected Client Form Management Screen

To request Disconnected Client forms, users should follow the Disconnected Client Access link, located under at the top of their admin screen. Timesheet will then display the Disconnected Client Form Management screen, which is used to request Disconnected Client forms, or to monitor open requests and to retire requested forms. Additionally, this screen can be used to make a temporary change to a user's email address for forms mailing purposes.
Outstanding Disconnected Client Requests
The top portion of the Disconnected Client Form Management screen will display information on the outstanding forms associated with each available time period. Each row of the Outstanding Disconnected Client Requests display provides the following information: The last column in each row of this display may be used to retire the batch of forms in that row. Retiring a batch of forms tells Timesheet not to accept any further emails from that batch. Please Note: A batch of forms that has been retired will still be displayed under Outstanding Disconnected Client Requests until the system automatically expires old batches. The exact length of time until Timesheet expires old requests is one of the DC Advanced preferences. The default is 28 days after the last period in the request ends. At that time all requests will be deleted from the system, and no record of the request will be kept. Of course, any actual data submitted by the user from the forms before the expiration time will be kept permanently.

To retire a batch of disconnected client forms, simply select the batch(es) in question and click the Retire These DC Requests button at the bottom of this section.

Choosing Offline Time/Expense/Mileage Forms
The bottom portion of the Disconnected Client Form Management screen provides users the controls needed to request disconnected client forms for time, expense and mileage entry as well as the offline project creation form. Additionally, this section allows the user to specify a different email address for Timesheet to use when sending these forms.

The process of requesting offline forms is outlined below:

  1. Enter an email address for these forms to be mailed to
    Please Note: Entering an email address is only required if the address is different from the address that has been assigned to the user in the extra user fields portion of Timesheet.
  2. Select each form/time period combination for which you would like to receive disconnected client forms
    Please Note: The number of available time periods is determined by your administrator during the Timesheet Disconnected Client Server configuration as discussed above.
  3. Indicate if you would like to receive the offline project creation form in addition to the offline forms for time, expense and mileage
    Please Note: If a user's role does not permit the creation of projects, and your organization has purchased the 'user subprojects' option, requesting a project form will provide them with a form that will allow only the creation of subprojects
  4. Click the Request Forms button at the bottom of this page
  5. Timesheet will display the Building Disconnected Client Email page.
    This page provides information regarding the email that has been sent. The information provided by this page includes:
  6. Click one of the main button bar buttons to return to Timesheet

Working With Disconnected Client Forms

Disconnected Client forms are sent to each requesting user as attachments to a single email message. The forms themselves are HTML files that simulate actual Timesheet pages. Each form's data is stored in a unique cookie that is saved on the computer to which they are sent. Once the email that contains the offline forms has been received, the user can open each form in the web browser of his choice and begin to enter data.

Please Note: While it is perfectly acceptable to launch the forms directly from an email client, Journyx recommends saving each form attachment to your hard drive and working with the forms from that location. This process prevents possible data loss due to unanticipated loss of email. Further, if your organization uses the IMAP mail protocol, saving the email directly to the user's computer guarantees that the attachments will be available when offline rather than remaining on the mail server and thereby defeating the Disconnect Client module's true purpose.

Each of the offline forms functions in almost exactly the same manner as their online counterparts; however, there are just enough differences to warrant a full discussion of how to use them. Each form is discussed in detail below.

Time
The Disconnected Client Time Entry Form appears quite similar to the standard online Timesheet time entry screen. This form remains true to the user's time period and will display only those projects, tasks, pay types and bill types that the requesting user is allowed to see based upon group membership. The process of entering time into this form follows standard time entry procedures exactly.

Any time entries that were in place for the time period that is shown by this form are displayed when this form is viewed. Therefore, if forms are requested at some point during a time period, the time already logged is not lost. It will be logged in Timesheet when the entire form is submitted.

The process of time entry for the Disconnected Client Time Entry Form is exactly the same as the process that the user would follow for entering time when using the standard online Timesheet.

Once time entries have been made for this open session, the user should simply click the Save Work In Progress button at the bottom of this form. Clicking this button saves all time entries and stores them locally in a cookie that will continue to hold this form's data until the form is submitted. Users do not need to be connected to the internet to save time entries. After clicking the Save Work In Progress button, the Disconnected Client will display a popup window confirming the data as saved.

Once all time entry has been completed for the time period covered by this form and the user is certain that no changes will need to be made, the user should connect to the internet and click the Email Completed Timesheet button at the bottom of this form. The Disconnected Client will then prepare to send the form back to the main Timesheet installation. The Disconnected Client will display a popup window asking the user to confirm that they wish to submit this form. The user may confirm this transmission by clicking the OK button in this window. Additionally, most web browsers will display a second message asking the user to confirm that they wish to submit a form via email. After confirming the transmission of this form, the Disconnected Client will submit the hours contained in this form to Timesheet, which will then record this time in the time entry screen for this user for the appropriate time period.

If a user attempts to submit an offline time form after it has already been submitted, the Disconnected Client module will display a popup window reminding him that the form in question has already been submitted.

Please Note: Despite the warning provided by Timesheet when a user attempts to submit an already submitted offline form, users can submit these forms multiple times. Multiple submissions will result in faulty records. Please stress the importance of proper form submission practices to all users who will be working with the Disconnected Client module.

Mileage
The Disconnected Client Mileage Entry Form appears quite similar to the standard online Timesheet Mileage entry screen. This form remains true to the user's time period and will display only those projects, measurements, vehicles and reasons that the requesting user is allowed to see based upon group membership. The process of entering mileage into this form follows standard mileage entry procedures exactly.

Any mileage entries that were in place for the time period that is shown by this form are displayed when this form is viewed. Therefore, if forms are requested at some point during a time period, the mileage already logged is not lost. It will be logged in Timesheet when the entire form is submitted.

The process of mileage entry for the Disconnected Client Mileage Entry Form is exactly the same as the process that the user would follow for entering mileage when using the standard online Timesheet.

Once mileage entries have been made for this open session, the user should simply click the Save Work In Progress button at the bottom of this form. Clicking this button saves all mileage entries and stores them locally in a cookie that will continue to hold this form's data until the form is submitted. Users do not need to be connected to the internet to save mileage entries. After clicking the Save Work In Progress button, the Disconnected Client will display a popup window confirming the data as saved.

Once all mileage entry has been completed for the time period covered by this form and the user is certain that no changes will need to be made, the user should connect to the internet and click the Email Completed Timesheet button at the bottom of this form. The Disconnected Client will then prepare to send the form back to the main Timesheet installation. The Disconnected Client will display a popup window asking the user to confirm that they wish to submit this form. The user may confirm this transmission by clicking the OK button in this window. Additionally, most web browsers will display a second message asking the user to confirm that they wish to submit a form via email. After confirming the transmission of this form, the Disconnected Client will submit the mileage contained in this form to Timesheet, which will then record this mileage in the mileage entry screen for this user for the appropriate time period.

If a user attempts to submit an offline mileage form after it has already been submitted, the Disconnected Client module will display a popup window reminding him that the form in question has already been submitted.

Please Note: Despite the warning provided by Timesheet when a user attempts to submit an already submitted offline form, users can submit these forms multiple times. Multiple submissions will result in faulty records. Please stress the importance of proper form submission practices to all users who will be working with the Disconnected Client module.

Rates & Rules Module


Journyx Timesheet v4.5 provides a robust engine for creating and applying complex payroll and billing rules to time tracked by your organization. The Rates & Rules features are accessible from the Rules & Policies link which is located under the Business Adjustments header on the main admin screen.

Rules and Policies

Rules and Policies are at the very heart of the Rates & Rules module of Timesheet v4.5. Admins create rules that affect how time is handled for payroll or billing purposes. These rules are then combined into policies that are assigned to users within Timesheet. Once these policies have been assigned, each user's time is processed appropriately.

For the Rates & Rules module to function properly, users whose time will be affected by policies must have an hourly pay rate and an hourly bill rate assigned to them in the extra users fields screen, which is accessed when creating or modifying users. Additionally, if your organization intends to use project-based Pay Rates and Bill Rates, you will need to specify those hourly rates for each project in the Extra Project Fields portion of Project creation and modification. Without these rates in place, the Rates & Rules module will not have the appropriate values accessible for the complex mathematic procedures that this module makes use of for rate calculation.

The admin should create rules as needed, with an eye towards the overall polices that will be built from those rules. Each individual user will have only one policy assigned to him within the system. Journyx recommends developing a strategy for Rule and Policy creation that focusses on the primary categories of users within your organization; that is, a strategy that looks at how users are grouped in ways that directly affect their time for payroll and billing purposes. An example of such a strategy would be the creation of policies that relate specifically to Hourly users, who are subject to overtime considerations, and to Exempt (or salaried) users, who are not subject to overtime considerations.

The Create/Edit/Manage Rules and Policies screen is divided into two sections, one specifically for rules, and one specifically for policies. Both sections function similarly, but each one will be discussed separately, to address the complexities of each.

Initially, the only option available for either section is to create a new rule or policy. To begin, simply click the Create New button in the section that you will be working with. Please note: Policies are simply an ordered collection of rules. Therefore, if no rules exist, you will be unable to create any policies.

The next section will look at the actual processes of working rules. Policies will be discussed in the section immediately after Rules.

Working With Rules

Rules are used to specify particular parameters for modifications that should be applied to time records for payroll and/or billing purposes. This section will discuss the creation, modification and deletion of Rules. Each rule is composed of:
Creation of Rules
The process of creating a new rule is outlined below:
  1. Click the Create a Rate Rule button on the Create/Edit/Manage Rules and Policies screen
    Timesheet will display the Create Rate Rule screen. This screen will be used for the remainder of this process.
  2. Enter a name for the new rule
    This name should be unique and help to identify the rule. Examples might include: overtime; double overtime; holiday overtime; weekend; emergency.
  3. Enter a description for the new rule
    This field should be used to describe the rule in more detail. Please Note: This field is limited to 252 characters.
  4. Select a time frame for this rule
    The possible choices for this setting are:
  5. Indicate the Condition for this rule
    The possible choices for this setting are:
  6. Indicate the Trigger Hours for this rule
  7. Indicate the Target for this rule
    The possible choices for this setting are:
  8. Indicate the categories for the new rule. CTRL-click to select multiple items in each list.
  9. Select the Optional Actions for this rule
    The available Optional Actions are:
  10. Click the save button
The Create/Edit/Manage Rules and Policies screen will refresh, displaying a green text message indicating that the new rule has been created. Additionally, the newly created rule will be included in the list of existing rules. The new rule will now be available for editing, copying and deleting.
Editing Rules
If you need to make changes to any existing rules, they can be edited to change any of the following options: To modify the existing rules, simply click the edit button to the right of the rule in question. The Edit Rate Rule screen will be displayed, providing access to make changes to the above mentioned options. The Edit Rate Rule screen functions exactly the same as the Create Rate Rule screen as described above.
Copying Rules
Timesheet provides the ability to copy an existing rule to a new name. This functionality is most commonly used to create a set of similar rules that have only minor differences by copying one rule and then editing it to make the needed changes. To copy a rule, perform the following steps:
  1. Click the Copy button to the right of the rule in question on the Create/Edit/Manage Rules and Policies screen
    Timesheet will display the Copy a Rate Rule to make a new Rate Rule screen. This screen will be used for the remainder of this process
  2. Enter a name for the new rule
  3. Make any desired changes to the rule
  4. Click the Save button
    Timesheet will display the Create/Edit/Manage Rules and Policies screen along with a green text message confirming the creation of a new rule based on the previously existing rule.
Deleting Rules
If you create a rule that you do not need, or a rule that needs such extensive editing that time would be saved by simply deleting it and starting over, Timesheet provides a method for removing rules from the system. To delete an existing rule, simply click the delete button to the right of the name of the rule in question. Timesheet will display a popup window asking you to confirm that you wish to delete the rule. If you wish to proceed, click OK in this window. To abort the deletion process, click the Cancel button. Please Note: If you attempt to delete a rule that is in use by a policy, you will receive the following red text error message:

The following Policy(s) have a reference to the rule you are trying to delete. Please remove all references from Policies prior to deleting a Rule. Policies: [ policy name ]

If the rule you are deleting is not currently in use by any existing policy, the Create/Edit/Manage Rules and Policies screen will refresh, displaying a green text message indicating that the rule in question has been successfully deleted.

Working With Policies

Policies are a logical grouping of rules that are used to make the actual modifications to an employees hours for payroll and billing purposes. Each policy provides for rate modification for payroll as well as the potential for up to three unique billing rate modifications. This section will discuss the creation, modification and deletion of policies as well as the process of assigning policies to individual users.

Each policy is composed of:

Creating Policies
The process of creating a new policy is outlined below:
  1. Click the Create a Policy button on the Create/Edit/Manage Rules and Policies screen
    Timesheet will display the Create a Policy for Rates screen. This screen will be used for the remainder of this process.
  2. Enter a name for the new policy
    This name should be unique and help to identify the target users for this policy. Examples might include: hourly, salary, exempt, non-exempt, contractors and senior staff.
  3. Enter a description for the new policy
    This field should be used to describe the policy in more detail. Please Note: This field is limited to 252 characters.
  4. Specify the Pay Rate Origin for this policy
    Timesheet v4.5 allows your organization to specify whether the pay rate for a specific policy should come from the User or the Project associated with the hours in question. The following options are available for this setting:
  5. Specify the Bill Rate Origin for this policy
    Timesheet v4.5 allows your organization to specify whether the Bill Rate for a specific policy should come from the User or the Project associated with the hours in question. The following options are available for this setting:
  6. Assign rules to this policy
    Although the process of assigning rules to a policy can at first appear to be a daunting task, the procedure itself is relatively simple. Each portion of this process is outlined in detail below. Please Note: Rules within a policy are executed "top to bottom" i.e., the first rule in a policy is applied to the hours first, the second rule is applied second, and so on down the list. This can be particularly important, as the order of mathematical operations can critically affect pay and bill rate amounts. The Rate Check feature, which is discussed below, will help with determining if rules are in the appropriate order.

    Please Note: Each rule in a policy must have at least one operation assigned to it, i.e., every rule must have at least a modification to one rate. If the rule is question does not actually modify the rate, you should simply designate a Rate Modification Type of Add and a Rate Modification Amount of zero.

    1. Edit Order
      This option is most commonly used when editing a policy. By choosing insert, delete, move up or move down you may change the order of rules within the policy being edited. Please see the discussion on editing policies for more detailed information on these tools.
    2. Rule
      These dropdown boxes are used to select the rules that will be used within this policy. For each row, select the rule you would like to apply to hours worked. This rule will be used to determine which hours should be modified by the Payroll and Billing adjustment types and amounts.
    3. Payroll Adjustment Type
      This option determines how the hours affected by this rule are modified for payroll modification.
      • Override replaces the hourly pay rate with the new value specified in the following column, Payroll Adjustment Amount
      • Add increases the hourly pay rate by the amount specified in the following column, Payroll Adjustment Amount
      • Multiply multiplies the hourly pay rate by the amount specified in the following column, Payroll Adjustment Amount
    4. Payroll Adjustment Amount
      This option specifies an amount by which the Payroll rate should be modified. This field accepts positive integers with decimals.
    5. Billing Adjustment Type #1
      This option determines how the hours affected by this rule are modified for the first Billing modification.
      • Override replaces the hourly billing rate with the new value specified in the following column, Billing Adjustment Amount #1
      • Add increases the hourly billing rate by the amount specified in the following column, Billing Adjustment Amount #1
      • Multiply multiplies the hourly billing rate by the amount specified in the following column, Billing Adjustment Amount #1
    6. Billing Adjustment Amount #1
      This option specifies an amount by which the first Billing rate should be modified. This field accepts positive integers with decimals.
    7. Billing Adjustment Type #2
      This option determines how the hours affected by this rule are modified for the first Billing modification.
      • Override replaces the hourly billing rate with the new value specified in the following column, Billing Adjustment Amount #2
      • Add increases the hourly billing rate by the amount specified in the following column, Billing Adjustment Amount #2
      • Multiply multiplies the hourly billing rate by the amount specified in the following column, Billing Adjustment Amount #2
    8. Billing Adjustment Amount #2
      This option specifies an amount by which the first Billing rate should be modified. This field accepts positive integers with decimals.
    9. Billing Adjustment Type #3
      This option determines how the hours affected by this rule are modified for the first Billing modification.
      • Override replaces the hourly billing rate with the new value specified in the following column, Billing Adjustment Amount #3
      • Add increases the hourly billing rate by the amount specified in the following column, Billing Adjustment Amount #3
      • Multiply multiplies the hourly billing rate by the amount specified in the following column, Billing Adjustment Amount #3
    10. Billing Adjustment Amount #3
      This option specifies an amount by which the first Billing rate should be modified. This field accepts positive integers with decimals.
  7. Please Note: Any rule that does not directly affect a pay or bill rate (i.e., an automatic rejection or an automatic accrual rule) must have an actual Adjustment Type and Adjustment Amount associated with that rule. Journyx recommends using either "Add 0" or "Multiply by 1" for these types of rules, as both operations will not affect the rates in question.
  8. Continue adding rules to the policy in question as needed, by repeating the steps above.
  9. Once all the required rules have been added to the policy in question, click the Save button at the bottom of the Create a Policy for Rates screen. The Create/Edit/Manage Rules and Policies screen will be displayed, including a green text message confirming the creation of the new policy.
You may cancel the Policy creation process at any time by clicking the Cancel button at the bottom of the Create a Policy for Rates screen. Clicking Cancel will return you to the Create/Edit/Manage Rules and Policies screen and about the policy you are currently creating.
Editing Policies
If you need to make changes to any existing Policies, they can be edited to change any of the following options: To modify the existing Policies, simply click the edit button to the right of the Policy in question. The Edit a Policy for Rates screen will be displayed, providing access to make changes to the above mentioned options. The Edit a Policy for Rates screen functions exactly the same as the Create Rate Policy screen as described above.

Editing the Order Of Rules Within A Policy
The first dropdown menu in the Edit a Policy for Rates screen provides access to a set of controls for changing the order in which rules are applied within a policy. Although the option to edit the order of rules is available during the initial policy creation process, it is most commonly used during policy editing. The possible order changes, and their effects, are:
Copying Policies
Timesheet provides the ability to copy an existing Policy to a new name. This functionality is most commonly used to create a set of similar Policies that have only minor differences by copying one Policy and then editing it to make the needed changes. To copy a Policy, perform the following steps:
  1. Click the Copy button to the right of the Policy in question on the Create/Edit/Manage Rules and Policies screen
    Timesheet will display the Copy a Policy to Create a new Policy screen. This screen will be used for the remainder of this process
  2. Enter a name for the new Policy
  3. Make any desired changes to the Policy
  4. Click the Save button
    Timesheet will display the Create/Edit/Manage Rules and Policies screen along with a green text message confirming the creation of a new Policy based on the previously existing Policy.
Deleting Policies
If you create a policy that you do not need, or a policy that needs such extensive editing that time would be saved by simply deleting it and starting over, Timesheet provides a method for removing policies from the system. To delete an existing policy, simply click the delete button to the right of the name of the policy in question. Timesheet will display a popup window asking you to confirm that you wish to delete the policy. If you wish to proceed, click OK in this window. To abort the deletion process, click the Cancel button. Please Note: If you attempt to delete a policy that is assigned to one or more users, you will receive the following red text error message:

The following user(s) have a reference to the Policy you are trying to delete. Please remove all references prior to deleting a Policy. Users: [ user login IDs ]

If the policy you are deleting is not currently assigned to one or more users, the Create/Edit/Manage Rules and Policies screen will refresh, displaying a green text message indicating that the rule in question has been successfully deleted.

Policies And Users

Once you have created rules and built policies out of those rules, each user who is subject to the effects of Policies should have a policy assigned to him. Each user can have exactly one policy assigned to him; therefore, policies should be designed and assigned with an eye towards the overall effect required by your organization. As stated before, the most common strategy for Policy assignment is to break your users into discreet categories based upon their employee type, i.e., full-time hourly, exempt (or salaried), contractors, and so forth.

Assigning Policies To Users

Policies are assigned to users via the Assign Policies to Users screen, which is available from the Policy Assignment link which is located under the Business Adjustments header on the main admin screen. The Assign Users to Policies screen will serve as the master control panel for assigning policies to users. This screen, like the User Entry and Modification and several other screens in Timesheet v4.5 lists up to 10 users at one time, as well as providing alphabet search buttons across the top of the screen. Additionally, you may search for users by entering a portion of their names in the Search for Employee Name field and clicking the Search button. Once you have reached the page that lists your desired users, you can begin the policy assignment process, which is outlined below.
  1. Select the user(s) to whom you will be assigning policies
    You may select specific users by clicking the box to the left of their names, or you may select all users displayed on this screen by clicking the Select All box.
  2. Select the policy you intend to assign to the selected users
    The Policy Selection dropdown menu, which contains all available policies, is located immediately to the right of the Assign Users to Policy button
  3. Click the Assign Users to Policy button
    The Assign Policies to Users screen will refresh, displaying a green text message confirming that the policy assignment process was successful for the selected users.
This screen may also be used to change the policy assigned to users. Simply select the user(s) in question, select the new policy and click the Assign Users to Policy button. Again, the screen will refresh, displaying a green text message confirming the change.

Rate Checking

After you have created policies and assigned them to your users, you will want to check the final results of the this process. Timesheet provides a simple interface for determining exactly how the policy assigned to each user affects the pay and bill rates for those users. The Rate Check link, which is located under the Business Adjustments header on the main admin screen, displays the Administrator's Rate Table Sanity Check screen. This screen provides an "at a glance" overview of the maximum and minimum for each user's pay rate as well as each of the three possible bill rates for those users.

This screen, like the Assign Users to Policies screen, lists up to 10 users at one time, as well as providing alphabet search buttons across the top of the screen. Additionally, you may search for users by entering a portion of their names in the Search for Employee Name field and clicking the Search button. Each page displays up to ten users along with the minimum and maximum for their pay rate and for each of their three possible bill rates. If a rate is shown as having a minimum of "-", check to see if an hourly dollar amount has been assigned for that rate for that use in the extra user fields portion of user modification. Without an actual hourly rate assigned for the user(s) in question, Timesheet cannot effectively determine what the minimum and maximum values are for each particular rate category.

If the rates displayed on the Administrator's Rate Table Sanity Check screen appear to be excessively high or low, you may need to modify any policies that are associated with users who are shown to have these suspect rates. Remember, modification of rates by policies is subject to standard mathematical rules as well as the order in which they appear in each policy. The Administrator's Rate Table Sanity Check screen indicates which policy is assigned to each user and provides a link to the Edit a Policy for Rates screen that targets the policy named. Please Note: If you click on the link for a user whose assigned policy is shown as -none- you will receive the following red text error message:

exceptions.IndexError
list index out of range

This message indicates that the user in question does not have a policy assigned to him and therefore you are unable to use this link to jump to the Edit a Policy for Rates screen. In this case, simply assign a policy to these user(s) via the Assign Policies to Users screen as discussed above.

Rate Reports

The Rates & Rules module is completed by the Rate Reports engine, which is available from the main admin screen via the Rate Reports link, located beneath the Expansion Modules Management header. For rate reports to display information, your organization must have the approvals process in place. Additionally, rate reports will only reflect data contained within timesheets that have been submitted for approval, i.e., time records contained within timesheets that are open for time entry will not appear in any rate report.

The primary control center for rate reports is the Manage Rate Reports screen. This screen is used to create, edit, copy, delete and run rate reports.

Initially, there is only one report, named Approval, listed in this screen. This report is directly associated with the Approvals process and is not available to view via the rate reports portion of Timesheet. This report can be modified to affect certain aspects of the display that approvers see when they are viewing a submitted timesheet. Please Note: The date range and user selection portions of this report are locked and changing them in the edit screen will not make actual modifications to the report.

Creating Rate Reports

To use the Rate Reports feature of Timesheet, you will need to create one or more viewable reports. Each Rate Report is composed of: The process of creating Rate Reports is outlined below:
  1. Click the Create a Rate Report button on the Manage Rate Reports screen
    Timesheet will display the Create Rate Report screen, which will be used for the remainder of this process.
  2. Enter a name for the new Rate Report
    This name should be unique and help to identify the rate report.
  3. Enter a description for the new Rate Report
    This field should be used to describe the rate report in more detail. Please Note: This field is limited to 252 characters.
  4. Select the Date Range for this report
    The possible date ranges for rate reports are:
  5. Define the Filter for this report. CTRL-click to select multiple items in each list.
    1. Select the user(s) whose data will be displayed in this report
      Please Note: Leaving this option blank is the same as selecting *All*
    2. Select the project(s) whose data will be displayed in this report
      Please Note: Leaving this option blank is the same as selecting *All*
    3. Select the task(s) whose data will be displayed in this report
      Please Note: Leaving this option blank is the same as selecting *All*
    4. Select the pay type(s) whose data will be displayed in this report
      Please Note: Leaving this option blank is the same as selecting *All*
    5. Select the bill type(s) whose data will be displayed in this report
      Please Note: Leaving this option blank is the same as selecting *All*
  6. Define the Grouping Rules for this report
    Select the primary, secondary and tertiary groupings for this report. The secondary and tertiary groupings are optional. The possible groupings options are: User; Project; Task; Pay Type; Bill Type; Year; Month; Week; Day; Rule. Please Note: No two groupings can be set to the same option. If you have set two grouping options to the same value, you will receive the following red text error message when you attempt to save this report:
    The Grouping Selections for Primary, Secondary, and Tertiary can not be the same. Please change. Thanks!
  7. Define the Content Rules for this report
    Select which rate categories are to be displayed in this report. The rate categories are available for display are: Pay Rate; Bill Rate #1; Bill Rate #2; Bill Rate #3.
  8. Define the Configuration rules for this report
    1. Select which day of the week should be used as the start day for this report
    2. Select the category of timesheet that should be included in this report
  9. Click the Save button
    Timesheet will return to the Manage Rate Reports screen and display a green text message confirming the creation of the new report.

Editing Rate Reports

If you need to make changes to any existing rate reports, they can be edited to change any of the following options: To modify the existing rate reports, simply click the edit button to the right of the rate report in question. The Edit Rate Report screen will be displayed, providing access to make changes to the above mentioned options. The Edit Rate Report screen functions exactly the same as the Create Rate Report screen as described above.

Copying Rate Reports

Timesheet provides the ability to copy an existing rate report to a new name. This functionality is most commonly used to create a set of similar reports that have only minor differences by copying one report and then editing it to make the needed changes. To copy a rate report, perform the following steps:
  1. Click the Copy button to the right of the rate report in question on the Manage Rate Reports screen
    Timesheet will display the Copy a Rate Report to make a new Rate Report screen. This screen will be used for the remainder of this process
  2. Enter a name for the new rate report
  3. Make any desired changes to the rate report
  4. Click the Save button
    Timesheet will display the Manage Rate Reports screen along with a green text message confirming the creation of a new rate report based on the previously existing rate report.

Deleting Rate Reports

If you create a rate report that you do not need, or a rate report that needs such extensive editing that time would be saved by simply deleting it and starting over, Timesheet provides a method for removing rate reports from the system. To delete an existing rate report, simply click the delete button to the right of the name of the rate report in question. Timesheet will display a popup window asking you to confirm that you wish to delete the rate report. If you wish to proceed, click OK in this window. To abort the deletion process, click the Cancel button. The Manage Rate Reports screen will refresh, displaying a green text message indicating that the rate report in question has been successfully deleted.

Running Rate Reports

You can run an existing rate report simply by clicking the Run button to the right of each report listed on the Manage Rate Reports screen. If the report you are viewing is designed in such a way that there are no records that meet its parameters, Timesheet will display a screen indicating that this is the case. This screen will provide a Back button that will return you to the Manage Rate Reports screen.

Credit Card Records And Receipt Image Upload In Timesheet v4.5


Journyx Timesheet v4.5 provides the optional ability to upload credit card records and receipt images into the Timesheet database. These uploaded files are associated directly with the uploading user's expense records. The processes for uploading records and images are described in detail below.

If the Record Uploads and Receipt Images expansion module has been purchased and enabled by your organization, each Expense Entry Screen within Timesheet will have two additional buttons located at the bottom of the screen:

Credit Card Records Upload Interface

To upload Credit Card or other Expense Records into the Timesheet database, a user must access the Credit Card Records Upload Interface by clicking the button on his assigned expense entry screen. Timesheet will open a second browser window and display the Credit Card Transactions Import screen.

Selecting A Records File To Import

The first step in importing a Records File into Timesheet is to select the file you wish to import via the File Import interface on the Credit Card Transactions Import screen. To specify the file to import, click the button on the Credit Card Transactions Import screen.

Timesheet will open a file browser dialog that will allow you to navigate through your computer's file system to select the file to upload. Additionally, you may enter the path to the file to be uploaded by hand by typing that path into the text box to the left of the button.

Once you have indicated the file to import, click the button located beneath the Select File dialog on this screen. Timesheet will then display the Credit Card Transactions Import screen. This screen is used to indicate precisely which records will be imported, as well as to modify the imported records to reflect the Project and Expense Code with which each record should be associated. Finally, Timesheet allows users to enter a comment for each record, exactly as if these records were being created "from scratch" in the normal expense entry process.

Selecting Records To Import
Each record contained withing the imported file is displayed on a separate line on the Credit Card Transactions Import screen. The checkboxes to the left of each record are used to indicate whether or not a specific record should be imported into the Timesheet database. You may use the Check All box at the bottom of this screen to indicate that each displayed record should be imported.
Customizing Imported Records
The Credit Card Transactions Import screen allows users to specify which Project and Expense Code a particular record should be associated with within the Timesheet database as well as adding comments to those records. The dropdown menus available on each line work in the same manner as their equivalents on a standard Expense Entry screen, and the choices contained within each dropdown menu are limited to the Projects and Expense Codes that the importing user has access to via Group affiliation. The Comments field for each record displayed on the Credit Card Transactions Import screen allows users to enter comments of up to 252 characters that are often used to help clarify the actual reason for a particular expense.

User should select the Project and Expense Code and enter comments for each record to be imported in to the Timesheet database.

Saving And Deleting Records
Once a user has specified the necessary information for each record to be imported, that user should click the button. Timesheet will refresh the Credit Card Transactions Import screen and any unselected records will be displayed for modification.

If there are any records contained within the import file that the user does not need to import into the Timesheet database, those records may be selected via the checkboxes for each line and then deleted by clicking the button. Timesheet will refresh the Credit Card Transactions Import screen and any unsaved or undeleted records will be displayed for modification.

Once all transactions from the import file have been saved or deleted, or once a user has finished working with an import file, the user should then click the button at the bottom of the Credit Card Transactions Import screen. Timesheet will then close the secondary window that was used for the Credit Card Record Import process and the user will be returned to his normal Expense Entry Screen.

Receipt Image View And Upload Interface

To upload receipt images into the Timesheet database,a user must access the Receipt Image Upload interface by clicking the button located on his assigned Expense Entry screen. Timesheet will open a second browser window and display the Receipt Picture Import Interface screen.

This screen displays each Expense Entry for the time period covered by the Expense Entry Screen that was used to access it. Information for each record associated with the active time period is displayed along with a link at the far right of each row. There are two possible links for each Expense record:

These links are used to upload and view receipt images, respectively. The functionality of these links is described in detail below.

Uploading Receipt Images

To upload a receipt image into the Timesheet database, the user should click the Upload Receipt Image to the right of a particular Expense Entry on the Receipt Picture Import Interface screen. Timesheet will open a file browser dialog that will allow you to navigate through your computer's file system to select the file to upload. Additionally, you may enter the path to the file to be uploaded by hand by typing that path into the text box to the left of the button.

Once you have indicated the file to import, click the button located beneath the Select File dialog on this screen. Timesheet will then display a confirmation message that the image was successfully uploaded.

To return to the Receipt Picture Import screen, click the button on the confirmation screen. Timesheet will return you to the Receipt Picture Import Interface screen, where you can choose a different record to upload an image for or choose an already uploaded image to view. Additionally, if you are finished working with the image upload process, you may click the button on the Receipt Picture Import Interface screen and Timesheet will close the secondary window that contains the Receipt Picture Import Interface screen and you will be returned to your assigned Expense Entry screen.

Viewing Receipt Images

After a receipt image has been uploaded, that image may be viewed via the Receipt Picture Import Interface screen by clicking on the View Receipt Image link. Timesheet will display the uploaded image for your review. Additionally, Receipt Images may be printed as needed using the print feature of your web browser. When you have finished viewing the receipt image in question, click the button on the Image Display window. Timesheet will return you to the Receipt Picture Import Interface screen, where you can choose a different record to upload an image for or choose an already uploaded image to view. Additionally, if you are finished working with the image upload process, you may click the button on the Receipt Picture Import Interface screen and Timesheet will close the secondary window that contains the Receipt Picture Import Interface screen and you will be returned to your assigned Expense Entry screen.