Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel
Table of Contents
minLevel1
maxLevel6
include
outlinefalse
indent
styledefault
exclude
typelist
class
printablefalse

...

The Users menu includes several options including creating a user in the system, establishing groups that will be linked into group chains (aka workflows) and , API Access Tokens for third-party integration and duplicate user/employee relations..

Users

A "user" is a person that the software is designed for and is using it.   Users   ESS users are assigned one or more Rolesroles.  The roles assigned to the user determines the access that user will have in the ESS system. Please refer to ESS Roles Crosswalk under More Information on Users for the list of available Roles in ESS and their Kiosk counterpart.

Role: For users with District Manager or Admin role. NOTE: District Manager role cannot create a user with Admin role. There is no user self registration yet in ESS. (ESS-246)

Create a User

The username entered when creating the An ESS user account is the username used when logging may be created via the User menu or a user may self-register via the login screen by clicking on Register User. The username entered when creating the user account is the username used when logging into Employee Self Service.

  1. From the Users menu, select 'Users'.

  2. Click

    1. Enter/Select desired user information. Field denoted with a . are required fields.

      1. If the user account being created is for an employee of the district, select the employee by clicking on the drop down arrow under ‘Select Employee’ or enter a name to start filtering on an employee. Once selected it will auto-populate full name and email address from the USPS Employee record. (Primary email address from USPS is pulled by default.)

      2. If user is using Active Directory, enter their active directory username in the ‘Username’ field. Also check the ‘External Authentication’ box.

      3. If user is using DUO or miniOrange, check the ‘Two Factor Authentication’ box.

      4. If the user needs to be synced with Absence Management, check the ‘Sync to Absence Management’ box.

      5. Password Expiration date and time is automatically set when the ‘change password’ option is used.

      6. Select role(s). User Roles are defined under The ‘User’ role will be added by default. If additional roles need to be added to the user, click on the dropdown to select additional role(s). User Roles are defined under ESS/Kiosk Roles Crosswalk under ‘More Information on Users’

  3. Click on to create the user or image-20240307-193245.png to cancel out of the window without saving changes.

...

Info

DUO/miniOrange and Active Directory Information

  • Additional information on how to configure active directory and DUO/miniOrange is located in the Employee Self Service Installation Guide.

...

The User grid allows users to search for existing accounts by clicking in the filter row in the grid columns and entering the desired information. The user may use the moreimage-20241106-142541.pngImage Addedbutton to add or remove columns from the grid.

...

  • image-20240307-195934.png view entire user record.

  • image-20240307-200036.png edit a user record

  • image-20240307-200054.png change a user’s existing password. NOTE: This password option can only be used for local or Two Factor authentication. If you are set up for external authentication, please contact your AD manager.

  • image-20240307-200435.pngImage Removed locks image-20240307-200556.pngImage Added deletes a user account.  The user will not be able to log into the application. A user with Admin or District Manager role can log into the application and access a user’s account in order to unlock it.

  • image-20240307-200519.pngImage Removed unlocks a user account that is currently locked.

  • image-20240307-200556.pngImage Removed deletes a user account.  If a user is part of a groupIf a user is part of a group/group chain and/or has leave requests entered in the system, their user account cannot be deleted. However, their account may be disabled by unchecking the ‘enabled’ box.

  • Bulk Reset Passwords: Allows mass reset of passwords for selected users. Checkmark specific users or use the top checkbox to select all users based on the filter you entered. A pop-up window appears with a grid listing the selected users and when their passwords are set to expire (if applicable). Click ‘Confirm’ to reset their passwords. The Password Expiration date and time will auto-populate in the User’s account forcing the user to reset their password at the ESS login page (by selecting the ‘Forgot Password’ option).

Info

The default setting in System>Configuration>Forgot Password Configuration to change a password is 5 minutes. If using Bulk Reset Passwords and you prefer to extend the time, you may increase the ‘minutes until expiration’ setting to give users more time to reset their password. For example, a Bulk Reset Password is performed at 1:00 PM and the district’s ‘forgot password configuration’ is 30 minutes, the user will receive an automated email with a link to reset their password. The user has exactly 30 minutes from when the email was sent to change it to a permanent password.

...

  • Export Grid Items: Checkmark specific users or use the top checkbox to select all users based on the filter you entered. Click to generate a CSV formatted spreadsheet based on the users you filtered.  For more information on updating user information via a spreadsheet, please refer to the System>Mass Load option.

Groups

...

  • image-20241107-181459.pngImage Added User accounts can be locked via the grid by checkmarking one or more user accounts and clicking image-20241107-181459.pngImage Added. Or when editing a user account, the ‘locked’ field may be checked. The user will not be able to log into the application. Only a user with Admin or District Manager role can unlock a user’s account.

  • image-20241107-181602.pngImage AddedUser accounts can be unlocked via the grid by checkmarking one or more user accounts and clickingimage-20241107-181602.pngImage Added. Or when editing a user account, the ‘unlocked’ field may be checked. Only a user with Admin or District Manager role can unlock a user’s account.

  • Bulk Reset Passwords: Allows mass reset of passwords for selected users. Checkmark specific users or use the top checkbox to select all users based on the filter you entered. A pop-up window appears with a grid listing the selected users and when their passwords are set to expire (if applicable). Click ‘Confirm’ to reset their passwords. The Password Expiration date and time will auto-populate in the User’s account forcing the user to reset their password at the ESS login page (by selecting the ‘Forgot Password’ option).

Info

The default setting in System>Configuration>Forgot Password Configuration to change a password is 5 minutes. If using Bulk Reset Passwords and you prefer to extend the time, you may increase the ‘minutes until expiration’ setting to give users more time to reset their password. For example, a Bulk Reset Password is performed at 1:00 PM and the district’s ‘forgot password configuration’ is 30 minutes, the user will receive an automated email with a link to reset their password. The user has exactly 30 minutes from when the email was sent to change it to a permanent password.

...

  • Export Grid Items: Checkmark specific users or use the top checkbox to select all users based on the filter you entered. Click to generate a CSV formatted spreadsheet based on the users you filtered.  For more information on updating user information via a spreadsheet, please refer to the System>Mass Load option.

...

Groups

Groups are made up of users within the ESS system who are responsible for approving and/or receiving notification of a leave request or Timesheet. Once a group is created, it can be added to a Group Chain.

...

  1. click . Fields denoted with a . are required fields.

  2. Name: Enter the desired name of the Group and description.

  3. Select And/Or:

    1. AND requires all ApproverGroup Member Types to approve the leave request

    2. OR requires only 1 Approver member to approve the leave request

  4. Select the group members to be included. The list to choose from will include active ESS users as well as two unique users:

    1. Supervisor will automatically include the supervisor listed on the user's USPS Position record.

    2. Manager will automatically include users with Leave Manager role in ESS.

    3. NOTE: When adding a Supervisor or Manager group member to a Group, you must use OR option otherwise, it will attempt to flow to ALL supervisors or managers instead of the one specific to this position.

  5. Once a member is selected, click Add to add the member to the grid. It will display their Username, Name and allow you to select their access to the group.

    1. Approver: member is an approver and will be sent an email notification when the leave request needs approval

    2. Read-only Access: member is not an approver but is allowed to view the leave request.

    3. Read-only Access with Notifications: member is not an approver but will be sent an email notification when a leave request is awaiting approval.

  6. Click on to create the leave request group or image-20240307-193245.png to cancel out of the window without saving changes.

...

  • image-20240307-195934.png view entire group record. image-20240307-200036.pngImage Removed edit a group record. When viewing a group, you have the option to ‘edit’ the group or ‘copy to timesheets’ to copy the leave request group record to a timesheet group record.

  • image-20240307-200036.pngImage Added edit a group record. Editing will allow you to add/remove members or update group member type to an existing group.

  • image-20241015-011108.pngImage Added copies the leave request group record to a timesheet group record.

  • image-20240307-200556.png delete a group record.  NOTE: If the group is attached to a Group Chain, you will not be able to delete the group.

...

Timesheet Groups are made up of users within the ESS system who are responsible for approving and/or receiving notification of a leave requestsubmitted timesheet. Once a group is created, it can be added to a Timesheet Group Chain.

Role: For users with Timesheet Manager, District Manager or Admin role.

...

  1. click . Fields denoted with a . are required fields.

  2. Name: Enter the desired name of the Group and description.

  3. Select And/Or:

    1. AND requires all ApproverGroup Member Types to approve the timesheet

    2. OR requires only 1 Approver member to approve the timesheet

  4. Select the group members to be included. The list to choose from will include active ESS users as well as two unique users:

    1. Supervisor will automatically include the supervisor listed on the user's USPS Position record.

    2. Manager will automatically include users with Leave Manager role in ESS.

    3. NOTE: When adding a Supervisor or Manager group member to a Group, you must use OR option, otherwise, it will attempt to flow to ALL supervisors or managers instead of the one specific to this position.

  5. Once a member is selected, click Add to add the member to the grid. It will display their Username, Name and allow you to select their access to the group.

    1. Approver: member is an approver and will be sent an email notification when the timesheet needs approval

    2. Read-only Access: member is not an approver but is allowed to view the timesheet.

    3. Read-only Access with Notifications: member is not an approver but will be sent an email notification when a timesheet is awaiting approval.

  6. Click on to create the group or image-20240307-193245.png to cancel out of the window without saving changes.

...

Timesheet Groups Grid Options

The Groups grid allows the user to filter group information by clicking in the filter row in the grid columns and entering in the desired search query(insert image of TS Group Grid)

...

  • image-20240307-195934.png view entire group record. When viewing a group, you have the option to ‘edit’ the group or ‘copy to leave requests’ to copy the timesheet group record to a leave request group record.

  • image-20240307-200036.png edit a group record. Editing will allow you to add/remove members or update group member type to an existing group.

  • image-20241015-011108.pngImage Added copies the timesheet group record to a leave request group record

  • image-20240307-200556.png delete a group record.  NOTE: If the group is attached to a Group Chain, you will not be able to delete the group.

...

  1. click . Fields denoted with a . are required fields.

  2. Name: Enter the desired name of the Group Chain and description.

  3. Priority: Must be specified to determine the order of the workflow for each group chain. If two or more groups have the same priority number, it then goes in alphabetical order based on the chain name.

  4. Select and drag Available (Approval) Groups from the left to the right (Selected) groups area.

  5. Once the approval groups are in the proper order, select the

  6. Specific Leave Types you want included in the group chain. If left blank, all leave types will be included:

  7. You have the option of including one or more of the following to be included in the workflow:

...

Leave Request Group Chain Grid Options

...

The Groups Chain grid allows the user to filter group chain information by clicking in the filter row in the grid columns and entering in the desired search query. The user may also use the more image-20241106-142541.pngImage Added button to add or remove columns from the grid.

...

  • image-20240307-195934.png view entire group chain record. image-20240307-200036.pngImage Removed edit When viewing a group chain. NOTE: If you edit the original settings of the group chain , you have the option to ‘edit’ the group chain, 'copy to timesheets’ to copy the leave request group chain record to a timesheet group chain record or click on matched employees to produce a grid of employees (and their positions) who fall under that group chain (aka workflow).

  • image-20240307-200036.pngImage Added edit a group chain. NOTE: If you edit the original settings of the group chain so that it is no longer applies to any outstanding leave requests tied to this group chain, you will receive an error message and the changes will not take place. Otherwise, if the edit was successful, it will restart the workflow on the leave request and the leave request’s approval trail will display ‘Group Chain Edited’.image-20240503-202030.pngImage Removed or image-20240503-202044.pngImage Removed

  • image-20241107-184509.pngImage Added Matched Positions: Displays a grid of employees (and their positions) who fall under that group chain.

  • image-20240503-202030.pngImage Added or image-20240503-202044.pngImage Added allow you to reorder the priority of the district existing workflows. Group priority can be shared (meaning you can assign the same prior priority number to multiple group chains. It will flow by priority first and then alphabetically by group chain name).

  • image-20241015-011108.pngImage Added copies the leave request group chain to a timesheet group chain

  • image-20240307-200556.png delete a group chain.  If you attempt to delete a group chain that contain outstanding leave requests, if another applicable group chain exist (i.e. 'catch all' group chain), the workflow for the leave request will restart. Otherwise, you will receive an error message and you will not be able to delete the group chain.

...

Role: For users with Timesheet Manager, District Manager or Admin role. (insert image of timesheet group chain creation)

...

Create a Timesheet Group Chain

...

  1. click . Fields denoted with a . are required fields.

  2. Name: Enter the desired name of the Group Chain and description.

  3. Priority: Must be specified to determine the order of the workflow for each group chainSelect and drag Available (Approval) Groups from the . If two or more groups have the same priority number, it then goes in alphabetical order based on the chain name.

  4. Select and drag Available (Approval) Groups from the left to the right (Selected) groups area.

  5. Once the approval groups are in the proper order, select the Specific Timesheet Options you want included in the group chain. If left blank, all appointment types will be included:

  6. You have the option of including one or more of the following to be included in the workflow:

...

Timesheet Group Chain Grid Options

...

  • image-20240307-195934.png view entire group chain record. image-20240307-200036.pngImage Removed edit When viewing a group chain. NOTE: If you edit the original settings of the group chain so that it is no longer applies to any outstanding timesheets tied to this group chain, you will receive an error message and the changes will not take place. Otherwise, if the edit was successful, it will restart the , you have the option to ‘edit’ the group chain, 'copy to leave requests’ to copy the timesheet group chain record to a leave request group chain record or click on matched employees to produce a grid of employees (and their positions) who fall under that group chain (aka workflow).

  • image-20240307-200036.pngImage Added edit a group chain. NOTE: If you edit the original settings of the group chain so that it is no longer applies to any outstanding timesheets tied to this group chain, you will receive an error message and the changes will not take place. Otherwise, if the edit was successful, it will restart the workflow on the timesheet and the timesheet’s approval trail will display ‘Group Chain Edited’.image-20240503-202030.pngImage Removed or image-20240503-202044.pngImage Removed allow you to reorder the priority of the district

  • image-20241107-184509.pngImage Added Matched Positions: Displays a grid of employees (and their positions) who fall under that group chain.

  • image-20240503-202030.pngImage Added or image-20240503-202044.pngImage Added allow you to reorder the priority of the district existing workflows. Group priority can be shared (meaning you can assign the same prior priority number to multiple group chains. It will flow by priority first and then alphabetically by group chain name.)

  • image-20241015-011108.pngImage Added copies the timesheet group chain to a leave request group chain

  • image-20240307-200556.png delete a group chain.  If you attempt to delete a group chain that contain outstanding timesheets, if another applicable group chain exist (i.e. 'catch all' group chain), the workflow for the timesheet will restart. Otherwise, you will receive an error message and you will not be able to delete the group chain.

...

Creating an API Access Token

  1. From User>API Access token, click Image Removed.

  2. Created by, date and time will auto fill

  3. Select the existing User account created for the third-party vendor along with a description.

  4. Click Image Removed to create the API Access Token or image-20240307-193245.pngImage Removed to cancel out of the window without saving changes.

...

  1. User>API Access token, click Image Added.

  2. Created by, date and time will auto fill

  3. Select the existing User account created for the third-party vendor along with a description.

  4. Click Image Added to create the API Access Token or image-20240307-193245.pngImage Added to cancel out of the window without saving changes.

...

Duplicate User/Employee Relations

The Duplicate Users/Employee Relations grid will displays any ESS users who have the same (USPS) employee number. You have the option to export the grid information to a spreadsheet via the ‘Export to CSV’ option.

...

Example: In the image above, both ESS usernames ‘testdupblevins’ and ‘rblevins’ reported using the same Employee Number (ANON349). To confirm, in the User grid, filter for both users and review their employee number. If they both have the same employee number, determine which user account has the correct number and update accordingly.

...

eview each user account

If the user is creating a new user the correct way and entering from the Create drop down option, then we should never need to use the duplicate user grid.

no two users can have the same usps employee assigned to them.

...

More Information on Users

...

Users may be assigned one or more roles. All users by default will be assigned the ‘User’ role. Listed below are the available Roles in ESS, it’s Kiosk counterpart, definition and example of the role. Please refer to the ESS Menu Options by ESS Role document in the appendix for an overview of the menu options available to a user based on their ESS role(s).

ESS Role

Kiosk Role

Definition

Example of who may be assigned role

User

N/A

User access is standard ESS access. All users in ESS will, by default, be granted the User role.

All district staff regardless of additional roles assigned.

Admin

Kiosk Administrator

Access to all functions of ESS.

ITC staff, district tech and/or district administrative staff member

District Manager

District Kiosk Administrator

Access to all functions of ESS with the exception of creating, editing or deleting users with Admin role.

District tech and/or administrative staff member

Announcement Board Manager

Announcement Board Administrator

Access to Announcement Manager which allow user to maintain district wide announcements which are displayed on the Home screen

District tech and/or administrative staff member

Custom Link Manager

District Link Administrator

Access to Manage Custom Links which allows user to maintain district’s custom links which are displayed on the Home screen.

District tech and/or administrative staff member

Leave Manager

Leave Administrator

Access to manager-related options under Leave Requests in order to elevate, view and export district leave requests. Also access to Leave Management which controls blackout dates, escalated approvals, creation of sub categories and view staff leave expense reports.

District administrative staff member

Leave Approval Workflow Manager

Leave Approval Automated Work Flow Administrator

Ability to create/maintain Groups and Group Chains (under Users) for leave approval workflows.

District administrative staff member

Leave Calendar by Building

Leave Calendar - by Building

Access to Leave Calendars>District Leave Calendar. Use ‘Filters’ to view staff leave requests within the same building(s) as your position(s).

District building principal

Leave Calendar by Department Code

Leave Calendar by Department Code

Access to Leave Calendars>District Leave Calendar. Use ‘Filters’ to view staff leave requests within the same department code(s) as your position(s).

District department head (i.e. cafeteria or maintenance supervisor)

Leave Calendar by District Building

Leave Calendar by District Building

Access to Leave Calendars>District Leave Calendar. Use ‘Filters’ to view staff leave requests for all buildings within district.

District superintendent or staff member who needs to see leave for multiple buildings within district

Leave Calendar by Pay Group

Leave Calendar by Pay Group

Access to Leave Calendars>District Leave Calendar. Use ‘Filters’ to view staff leave requests within the same pay group(s) as your position(s).

District staff member who needs to view leave requests based on pay group.

Leave Calendar for District Staff

Leave Calendar for District Staff

Access to Leave Calendars>District Leave Calendar. Use ‘Filters’ to view staff leave requests for selected employees.

Superintendent

Leave Request Approver

N/A

Ability to View/Approve staff leave requests via Home screen or Leave Request Approval option

District supervisors, principals, etc. who are in a supervisor role

Leave Supervisor for Staff

Leave Calendar for Supervisor Staff

Access to Leave Requests>View Supervised Leave and Leave Calendars>Supervisor Leave Calendar in order to view staff’s leave requests

District supervisors, principals, etc. who are in a supervisor role

Metrics API

Data Change Manager

HR Administrator

Access to Data Change Management which allows user to maintain employees' data change requests and post changes to USPS

District administrative staff member/Treasurer’s office

Substitute Coordinator

Substitute Coordinator

Access to Sub Coordinator which allows ability to enter substitute information for any submitted leave request where substitute needed is checkmarked. The role also grants access to Leave Requests>View District Leave

District administrative position

Substitute Coordinator - Read Only

Substitute Coordinator - View Only

Read-only access to Sub Coordinator for all submitted leave requests where substitute needed is checkmarked. The role also grants access to Leave Requests>View District Leave

Staff member who needs access to substitute info but doesn’t assign them

Substitute Coordinator by Building

Substitute Coordinator by Building

Not currently in use

Substitute Coordinator by Building - Read Only

Substitute Coordinator by Building - View Only

Not currently in use

Substitute Coordinator by Department Code

Substitute Coordinator by Department Code

Substitute Coordinator by Pay Group

Substitute Coordinator by Pay Group

Not currently in use

Substitute Coordinator by Pay Group

Substitute Coordinator by Pay Group

Not currently in use

Timesheet Approval Workflow Manager

Ability to create/maintain Groups and Group Chains (under Users) for timesheet workflows.

District administrative staff member

Timesheet Approver

Ability to View/Approve staff timesheets via Home screen or Timesheet Approval option. Access to Timesheets>Supervisor Timesheets Leave in order to view staff’s timesheets

District supervisors, principals, etc. who are in a supervisor role

Timesheet Manager

Access to manager-related options under Timesheets in order to view and export district timesheets. Also access to Timesheet Manager which controls escalated approvals, automatic period generation and creation of periods and shifts.

District administrative staff member

Timesheet Supervisor for Staff

Access to Timesheets>Supervisor Timesheets Leave in order to view staff’s timesheets

District supervisors, principals, etc. who are in a supervisor role

Whitelist Manager

N/A

Access to Manage Whitelist which maintains trusted websites that display on the custom links area of the Home screen. If a website has been whitelisted, they will be directed to the new site on click; whereas a URL that is not whitelisted, a dialog will appear to warn the user they are navigating to a new site.

District administrative or technical position.