Maintenance Manual Bullard Timecard Portal Product Owner: Brian Randlett Team OmniCom Ken Koyanagi Donald Murchison Madeline Lewis-Whitfield Justin Tran Lathsamy Vongsavanh Kameryn Taylor Version 0.3 April 30, 2017
i Table of Contents 1 Introduction... Error! Bookmark not defined. 2 Quick Guide:... Error! Bookmark not defined. 3 Authentication... 1 4 Field Worker Timecard... 2 4.1 Navigation... 2 4.2 Timecard Main View... 3 4.2.1 Viewing Previous Timecard... 3 4.2.2 Viewing Timecard Status... 4 4.2.3 Viewing Timecard for the Day... 5 4.3.4 Add, Edit, Delete Timecard... 6 4.4 Submit Timecard to Scheduler... 12 5 Scheduler Timecard... 14 5.1 Navigation... 14 5.2 Manage Field Employee Timecards... 16 5.2.1 Load Field Employee Timecards... 16 5.2.2 Pending View... 19 5.2.3 Past Due View... 21 5.2.4 Approved View... 22 5.2.5 Export to Excel Spreadsheet... 23 5.3 Manage Users... 25 5.3.1 Users List... 25 5.3.2 Add Users... 26
Bullard Timecard Portal ii 5.4 Edit Application Settings... 28 5.4.1 View, Edit, Delete Job Codes... 28 5.4.2 Add Job Codes... 30 Appendix A: Help Page... 32 Glossary... 32 Contact Information... 33
Bullard Timecard Portal iii List of Tables Table 2: Contact information... 33
Bullard Timecard Portal iv List of Figures Figure 1: Sign-In with approved Google Account [Field Worker] & [Scheduler]... 1 Figure 2: Open Safari [Field Worker]... Error! Bookmark not defined. Figure 3: Timecard Portal in Safari [Field Worker]... Error! Bookmark not defined. Figure 4: Add App to Home Page [Field Worker]... Error! Bookmark not defined. Figure 5: Rename Application [Field Worker]... Error! Bookmark not defined. Figure 6: Collapsed Navigation Options [Field Worker]... 2 Figure 7: Expanded Navigation Options [Field Worker]... 2 Figure 8: Previous Timecard [Field Worker]... 3 Figure 9: Previous Timecard Drop Down Menu [Field Worker]... 3 Figure 10: Timecard Status Open [Field Worker]... 4 Figure 11: Timecard Status Closed [Field Worker]... 4 Figure 12: View Job by Week [Field Worker]... 5 Figure 13: Example Job by Day [Field Worker]... 5 Figure 14: Add Job [Field Worker]... 6 Figure 15: Add Job - Submit [Field Worker]... 7 Figure 16: Edit Job [Field Worker]... 7 Figure 17: Edit Job - Change Value [Field Worker]... 8 Figure 18: Edit Job - New Changes [Field Worker]... 9 Figure 19: Delete Job Button [Field Worker]... 9 Figure 20: Delete Job - Confirmation [Field Worker]... 11 Figure 21: Submit Timecards [Field Worker]... 12 Figure 22: Submit Job Confirmation [Field Worker]... 13 Figure 23: Navigation Hamburger [Scheduler]... 14 Figure 24: Expanded Navigation Options [Scheduler]... 15 Figure 25: Manage Timecard View [Scheduler]... 16 Figure 26: Load Timecard View All Weeks [Scheduler]... 17 Figure 27: Load Timecard - Change Week [Scheduler]... 17
Bullard Timecard Portal v Figure 28: Pending View [Scheduler]... 19 Figure 29: Pending View Approve/Unapproved [Scheduler]... 19 Figure 30: Edit Submitted Field Employee Timecard [Scheduler]... 20 Figure 31: Past Due View [Scheduler]... 21 Figure 32: Approved View [Scheduler]... 22 Figure 33: Example Export Excel... 23 Figure 34: Users List [Scheduler]... 25 Figure 35: Edit User Information [Scheduler]... 25 Figure 36: Add User [Scheduler]... 26 Figure 37: View Job Codes [Scheduler]... 28 Figure 38: Edit Job Codes [Scheduler]... 29 Figure 39: Edit Job Codes - Edit View [Scheduler]... 29 Figure 40: Delete Job Codes [Scheduler]... 30 Figure 41: Add Job Codes [Scheduler]... 30 Figure 42: Help Page - Brian... 32
Bullard Timecard Portal 1 Authentication All authentication for the Bullard Timecard Portal is handled through Google Authentication services. All users whom wish to use the Bullard Timecard Portal will need a Gmail account. Figure 1: Sign-In with approved Google Account [Field Worker] & [Scheduler] Issues: If any issues occur in the authentication process, check the following files: o Bullard Inc -> Web.config 04/30/2017 Page 1
Bullard Timecard Portal 2 2 Field Worker Timecard 2.1 Navigation All navigation for the Bullard Timecard Portal is done from the sidebar. Click on the hamburger icon in the top left corner to expand the navigation options. Figure 2: Collapsed Navigation Options [Field Worker] Figure 3: Expanded Navigation Options [Field Worker] To collapse the navigation options, click anywhere on the screen outside of the sidebar. Issues: If any issues occur when navigating through the fieldworker s side menu, then check the following files: o Bullard Inc -> Views -> Shared -> FieldWorkerFrame.cshtml 04/30/2017 Page 2
Bullard Timecard Portal 3 2.2 Timecard Main View 2.2.1 Viewing Previous Timecard To view your previous timecard, click on the drop down menu and select the week you would like to view in the scroll menu. After selecting the week, select Done on the top right, and then select the CHANGE WEEK button. The timecard(s) for that week will populate within the days of the week. Figure 5: Previous Timecard Drop Down Menu [Field Worker] Figure 4: Previous Timecard [Field Worker] Issues: If any issues occur when viewing different timecard weeks, then check the following files: o Bullard Inc -> Controllers -> TimecardController.cs o Bullard Inc -> Views -> Timecard -> Index.cshtml o API -> Controllers -> WeeksController.cs 04/30/2017 Page 3
Bullard Timecard Portal 4 2.2.2 Viewing Timecard Status The status of the timecard can be viewed on any portion of the timecard application. A status of OPEN means the Field Employee has not submitted their timecard for the current week to the scheduler; regardless of whether or not it past the due date which is Friday at 12pm. (For example, say it is Friday at 12:01 pm and the timecard for the week has not been submitted. The status will show open until the timecard has been submitted.) Figure 6: Timecard Status Open [Field Worker] A status of CLOSED means the Field Employee has submitted their timecard for the current week to the scheduler; regardless of whether or not it past the due date. Figure 7: Timecard Status Closed [Field Worker] 04/30/2017 Page 4
Bullard Timecard Portal 5 2.2.3 Viewing Timecard for the Day To view hours submitted for each day, click on any day of the week. You will then see the job #, hours, miles, lunch, and work performed status code for all timecards submitted on that day. You may submitted multiple timecards per day per week. The total hours and total miles traveled are tallied below the timecard entries. Figure 8: View Job by Week [Field Worker] Figure 9: Example Job by Day [Field Worker] Issues: If any issues occur when viewing different timecard days, then check the following files: o Bullard Inc -> Controllers -> TimecardController.cs o Bullard Inc -> Views -> Timecard -> Index.cshtml o API -> Controllers -> TimesheetsController.cs 04/30/2017 Page 5
Bullard Timecard Portal 6 2.2.4 Add, Edit, Delete Timecard To add a new job, click on the Add button. Figure 10: Add Job [Field Worker] You will then have the option to select a project number, a work performed code, enter hours worked, miles driven to job site, and hours spent on lunch. Once you are done click SUBMIT 04/30/2017 Page 6
Bullard Timecard Portal 7 To edit the timecard click on the Edit button. Figure 11: Add Job - Submit [Field Worker] Figure 12: Edit Job [Field Worker] 04/30/2017 Page 7
Bullard Timecard Portal 8 You will then be directed to a page similar to add timecard however; instead of entering new data, you will be editing the existing data. When you are done click SUBMIT at the bottom of the screen. Figure 13: Edit Job - Change Value [Field Worker] Your new changes will now be reflected in the timecard view. 04/30/2017 Page 8
Bullard Timecard Portal 9 Figure 14: Edit Job - New Changes [Field Worker] To delete a specific timecard, click on the Delete button. Figure 15: Delete Job Button [Field Worker] Issues: 04/30/2017 Page 9
Bullard Timecard Portal 10 If any issues occur when adding timecard jobs,then check the following files: o Bullard Inc -> Controllers -> TimecardController.cs o Bullard Inc -> Views -> Timecard -> EmpJobAdd.cshtml o API -> Controllers -> TimesheetsController.cs If any issues occur when deleting timecard jobs occurs, check the following files: o Bullard Inc -> Controllers -> TimecardController.cs o Bullard Inc -> Views -> Timecard -> EmpJobView.cshtml o API -> Controllers -> TimesheetsController.cs If any issues occur when updating timecard jobs, check the following files: o Bullard Inc -> Controllers -> TimecardController.cs o Bullard Inc -> Views -> Timecard -> EmpJobView.cshtml o Bullard Inc -> Views -> Timecard -> EmpJobEdit.cshtml o API -> Controllers -> TimesheetsController.cs 04/30/2017 Page 10
Bullard Timecard Portal 11 On mobile view, you will not be prompted after clicking delete. On a desktop view however, before you can delete the timecard, you will be prompted to continue. Click OK to delete the timecard. Figure 16: Delete Job - Confirmation [Field Worker] Issues: If the user isn t prompt with a warning message before actual deletion, check the following the files: o Bullard Inc -> Controllers -> TimecardController.cs o Bullard Inc -> Views -> Timecard -> EmpJobView.cshtml 04/30/2017 Page 11
Bullard Timecard Portal 12 2.3 Submit Timecard to Scheduler Once you have finished adding in all your timecards for the week, click the SUBMIT button at the bottom right of the screen. Note: Once you submit your timecard, you will no longer be able to edit or delete your timecards for the week, and the status will change to CLOSED. After which, you will only be able to view the timecard(s) you submitted. You will regain access to add, edit, and delete your timecard(s) when a new week has begun or the scheduler has un-submitted your timecard. Figure 17: Submit Timecards [Field Worker] 04/30/2017 Page 12
Bullard Timecard Portal 13 After clicking submit, you will be prompted if you are sure. Click OK to submit your timecard for the week to the scheduler. Figure 18: Submit Job Confirmation [Field Worker] Issues: If any issues occur when submitting time cards, check the following files: o Bullard Inc -> Controllers -> TimecardController.cs o Bullard Inc -> Views -> Timecard -> EmpJobView.cshtml o API -> Controllers -> TimesheetsController.cs 04/30/2017 Page 13
Bullard Timecard Portal 14 3 Scheduler Timecard 3.1 Navigation All navigation is done from the sidebar. To navigate the application, use the sidebar. Click on the hamburger icon in the top left corner to expand the navigation options. Figure 19: Navigation Hamburger [Scheduler] 04/30/2017 Page 14
Bullard Timecard Portal 15 Figure 20: Expanded Navigation Options [Scheduler] Issues: If any issues occur when navigating through the scheduler s sidemenu, check the following files: o Bullard Inc -> Views -> Shared -> SchedulerFrame.cshtml o API -> Controllers -> ViewController.cs o API -> Controllers -> WeeksController.cs 04/30/2017 Page 15
Bullard Timecard Portal 16 3.2 Manage Field Employee Timecards From the manage Field Employee timecard view you are able to see pending timecards, past due timecards, approved timecards. Timecards in the pending view are timecards that have been submitted by Field Employee s on time (by the deadline, which is Friday at 12pm). Timecards in the past due view are timecards that have not been submitted by the deadline (Friday at 12pm). Timecards in the approved view are timecards that have been reviewed and approved for export. From the manage timecard view you are also able to view the previous weeks timecards and see the status of those timecards for that week. Figure 21: Manage Timecard View [Scheduler] Issues: If any issues occur in the Manage Timecard View then check the following files: o Bullard Inc -> Controllers -> SchedulerController.cs o Bullard Inc -> Views -> Scheduler -> Index.cshtml o API -> Controllers -> ViewController.cs 04/30/2017 Page 16
Bullard Timecard Portal 17 3.2.1 Load Field Employee Timecards To load Field Employee timecards, select the week you would like to view from the drop down menu. Then, select the CHANGE WEEK button. Figure 22: Load Timecard View All Weeks [Scheduler] Figure 23: Load Timecard - Change Week [Scheduler] 04/30/2017 Page 17
Bullard Timecard Portal 18 Issues: If any issues occur with loading different timecard weeks, check the following files: o Bullard Inc -> Controllers -> SchedulerController.cs o Bullard Inc -> Views -> Scheduler -> Index.cshtml o API -> Controllers -> WeeksController.cs 04/30/2017 Page 18
Bullard Timecard Portal 19 3.2.2 Pending View Within the pending view, you are able to view the timecards Field Employees have submitted by the deadline (Friday at 12pm) in the quick view. Clicking on each Field Employee name, you will be able to view all of their submitted timecards for the week and edit them appropriately. Figure 24: Pending View [Scheduler] To approve or unapprove timecards, click on the green check or the red x respectively. Timecards that have been approved will instantly go to the approved view. Timecards that have been unapproved will unsubmit the Field Employees timecard. This action change the Field Employees timecard status back to OPEN and they will be allowed to edit their timecard again. Figure 25: Pending View Approve/Unapproved [Scheduler] 04/30/2017 Page 19
Bullard Timecard Portal 20 To edit timecards click on the blue pencil button next to each timecard. You will then be redirected to the Field Employees timecard view where you can edit work performed, project number, hours, lunch hours, and mileage. Figure 26: Edit Submitted Field Employee Timecard [Scheduler] Issues: If any issues occur with editing, approving and unapproving time cards, then check the following files: o Bullard Inc -> Controllers -> SchedulerController.cs o Bullard Inc -> Views -> Scheduler -> Index.cshtml o API -> Controllers -> ViewController.cs 04/30/2017 Page 20
Bullard Timecard Portal 21 3.2.3 Past Due View Within the past due view, you can view all the Field Employees who did not submit their timecards on time; regardless of whether or not they submitted it after the deadline (Friday at 12pm). The green check in the pending view indicates the Field Employee has submitted the timecard after the deadline. The red x indicates the Field Employee still has not submitted their timecard for the week. Figure 27: Past Due View [Scheduler] If any issues occur with viewing past due time cards, then check the following files: o Bullard Inc -> Controllers -> SchedulerController.cs o Bullard Inc -> Views -> Scheduler -> Index.cshtml o API -> Controllers -> ViewController 04/30/2017 Page 21
Bullard Timecard Portal 22 3.2.4 Approved View Within the approved view, you have the option to view the timecards for the Field Employee, and if necessary, unapproved it sending it back to the pending view. Note: You will not be able to edit Field Employees timecard entries in the approved view. To unapprove previously approved timecards and send the Field Employee timecard back to the pending view click the red x. Figure 28: Approved View [Scheduler] If any issues occur with viewing approved time cards, then check the following files: o Bullard Inc -> Controllers -> SchedulerController.cs o Bullard Inc -> Views -> Scheduler -> Index.cshtml o API -> Controllers -> ViewController.cs 04/30/2017 Page 22
Bullard Timecard Portal 23 3.2.5 Export to Excel Spreadsheet After all timecards have been approved for the week click the Export CSV button to export the data into an excel spreadsheet. When opening the excel spreadsheet in Excel, it is important to note that the data is comma delimited. Figure 29: Example Export Excel 04/30/2017 Page 23
Bullard Timecard Portal 24 Issues: If any issues with export timecards into a csv file, then check the following files: o Bullard Inc -> Controllers -> SchedulerController.cs o Bullard Inc -> Views -> Scheduler -> Index.cshtml o API -> Controllers -> TimesheetsController.cs 04/30/2017 Page 24
Bullard Timecard Portal 25 3.3 Manage Users In order for Field Employees to access the Timecard Portal, they will need to be added as a user. Information needed to add users into the timecard portal are their employee id, account name, email, and phone number. After adding a new user into the portal, you may edit their information from the Users List view. 3.3.1 Users List To view Field Employee information click on the Field Employees name to expand the rows. Figure 30: Users List [Scheduler] After expanding the row, you will have the option to edit their information. To edit user information click on the Edit button. Figure 31: Edit User Information [Scheduler] 04/30/2017 Page 25
Bullard Timecard Portal 26 Issues: If any issues with viewing employee information occurs, then check the following files: o Bullard Inc -> Controllers -> EmployeeController.cs o Bullard Inc -> Views -> Employee -> Index.cshtml o API -> Controllers -> EmployeesController.cs 3.3.2 Add Users To add a new user in the Bullard Timecard Portal, you will need their unique employee id, full name, phone number, email, and username. After entering in this information, click the SUBMIT button. Figure 32: Add User [Scheduler] Issues: If any issue with adding users occur, then check the following files: o Bullard Inc -> Controllers -> EmployeeController.cs o Bullard Inc -> Views -> Scheduler -> AddUsers.cshtml 04/30/2017 Page 26
o API -> Controllers -> EmployeesController.cs Bullard Timecard Portal 27 04/30/2017 Page 27
Bullard Timecard Portal 28 3.4 Edit Application Settings The Settings page allows you to edit the jobs codes Field Employees will use to select from when adding or editing a new timecard. 3.4.1 View, Edit, Delete Job Codes To view job codes in the Bullard Timecard Portal, click on the Job Codes option from the sidebar menu. Figure 33: View Job Codes [Scheduler] 04/30/2017 Page 28
To edit job codes, click the edit option. Bullard Timecard Portal 29 Figure 34: Edit Job Codes [Scheduler] To edit a job code, you will need a job id number, and a job description. After entering a new job code click SUBMIT. Figure 35: Edit Job Codes - Edit View [Scheduler] 04/30/2017 Page 29
To delete a job code, click on the Delete option. Bullard Timecard Portal 30 3.4.2 Add Job Codes Figure 36: Delete Job Codes [Scheduler] To add a job, enter the job id number, and job description. Then, click SUBMIT. Figure 37: Add Job Codes [Scheduler] Issues: If any issues with viewing job codes occur, then check the following files: 04/30/2017 Page 30
Bullard Timecard Portal 31 o Bullard Inc -> Controllers -> SchedulerController.cs o Bullard Inc -> Views -> Scheduler -> Index.cshtml o API -> Controllers -> JobsController.cs If any issues with editing job codes occur, then check the following files: o Bullard Inc -> Controllers -> SchedulerController.cs o Bullard Inc -> Views -> Scheduler -> EditJob.cshtml o API -> Controllers -> JobsController.cs If any issues with adding job codes occur, then check the following files: o Bullard Inc -> Controllers -> SchedulerController.cs o Bullard Inc -> Views -> Scheduler ->AddJob.cshtml o API -> Controllers -> JobsController.cs 04/30/2017 Page 31
Bullard Timecard Portal 32 Appendix A: Help Page Within the Field Employee view and the Administrator view there is a help page if you ever need to contact the developers for help. Figure 38: Help Page Issues: If any issues occur when viewing the help page, then check the following files: o Bullard Inc -> Controllers -> TimecardController.cs o Bullard Inc -> Views -> Shared -> FieldWorkerFrame.cshtml o Bullard Inc -> Views -> Timecard -> Index.cshtml Glossary Scheduler and Administrator are used interchangeably Field Employee and Field Worker are used interchangeably 04/30/2017 Page 32
Bullard Timecard Portal 33 Contact Information Table 1: Contact information Name Email Phone Number Kameryn Taylor kamerynjanai@gmail.com 707-334-9572 Lathsamy Vongsavanh Lathsamyv@gmail.com 530-351-5274 Justin Tran justinmtran@gmail.com 916-320-2854 Madeline Lewis-Whitfield maddz131@gmail.com 559-789-5286 Ken Koyanagi Ken.Koyanagi1@gmail.com 916-717-4642 Donald Murchison donaldmurchison@csus.edu 916-339-4227 04/30/2017 Page 33