Users


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

Users

Role: For users with District Manager or Admin role. NOTE: District Manager role cannot create a user with Admin role.

A "user" is a person that the software is designed for and is using it.   ESS users are assigned one or more roles.  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.

Create a User

An ESS user account 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. 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.

image-20241209-192634.png

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.

Users Grid Options

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.pngbutton to add or remove columns from the grid.

image-20241107-181130.png
  • 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-200556.png deletes a user account.  If 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

  • image-20241107-181459.png User accounts can only be locked via the grid by selecting one or more user accounts and clicking image-20241107-181459.png. Locking a user will prevent them from logging into the application. Only a user with Admin or District Manager role can unlock a user’s account.

  • image-20241107-181602.pngUser accounts can only be unlocked via the grid by selecting one or more user accounts and clickingimage-20241107-181602.png. 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).

Users with the ADMIN role and/or external authenticated users will be excluded from bulk reset password. If selected, a warning message will appear stating ‘Cannot reset local passwords for external or admin users’ and those users will be excluded.

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.

Leave Request Groups

Role: For users with Leave Approval Workflow Manager, District Manager or Admin role.

Create a Leave Request Group

From User>Groups, ensure ‘Leave Request’ is selected

  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 Approver Group 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.

Leave Request 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

  • image-20240307-195934.png view entire 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.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.png 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

Timesheet Groups are made up of users within the ESS system who are responsible for approving and/or receiving notification of a submitted 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.

Create a Timesheet Group

From User>Groups, ensure Timesheet is selected

  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 Approver Group 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

  • 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.png 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.


Group Chains

A Group Chain defines the leave or timesheet approval workflow by linking selected (approver) Groups with specified employees, groups, departments, etc. that are included in the workflow.

Leave Request Group Chains

Role: For users with Leave Approval Workflow Manager, District Manager or Admin role.

Create a Leave Request Group Chain

From User>Groups Chains, ensure Leave Request is selected:

  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:

  • Specific Employees and Positions:

  • Specific Pay Groups

  • Specific Departments Codes

  • Specific Building Codes

  • Specific Sub Category (leave type sub categories)

  1. Once the group chain is set, click ‘Create’ to save it and it will be added to the Group Chains grid.

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. We recommend selecting the more image-20241106-142541.png button to add or remove columns from the grid.

  • image-20240307-195934.png view entire group chain record. When viewing a 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.png 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-20241107-184509.png Matched Positions: Displays a grid of employees (and their positions) who fall under that group chain.

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

  • image-20241015-011108.png 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.

Timesheet Group Chains

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

Create a Timesheet Group Chain

From User>Groups Chains, ensure Timesheet is selected:

  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 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:

  • Specific Employees and Positions:

  • Specific Pay Groups

  • Specific Departments Codes

  • Specific Building Codes

  1. Once the group chain is set, click ‘Create’ to save it and it will be added to the Group Chains grid.

Timesheet Group Chain Grid Options

  • image-20240307-195934.png view entire group chain record. When viewing a group chain, 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.png 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-20241107-184509.png Matched Positions: Displays a grid of employees (and their positions) who fall under that group chain.

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

  • image-20241015-011108.png 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.


API Access Token

API Access Tokens inform the API that the bearer of the token is authorized to access ESS.  It requires an existing ESS user account who needs to integrate with ESS identifying the user (third party) using the application. 

Role: For users with District Manager or Admin role.

Creating an API Access Token

  1. From User>API Access token, click .

  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 to create the API Access Token or image-20240307-193245.png 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

Kiosk/ESS Roles Crosswalk

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

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 and view district leave requests. Also access to Leave Management menu allowing user to maintain absence thresholds, blackout dates, escalated approvals, export leave history, export leave requests and ability to view/generate district leave analysis and 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 or secretary

Leave Calendar by Department Code

Leave Calendar by Department Code

Access to Leave Calendars>District Leave Calendar. Use ‘Filters’ to view staff leave requests on one or more district department codes and/or leave request types).

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 one or more buildings within the 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 for one or more pay groups within the district.

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. By default, the calendar displays all staff leave requests. Use ‘Filters’ to filter one or more leave request types and/or employees.

Superintendent/Superintendent’s Secretary

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 selected. 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 selected. 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

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 Timesheet 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 district timesheets, export district timesheets and generate an overview report of timesheets. Also access to Timesheet Manager allowing user to maintain timesheet escalated approvals, automatic period generation, periods, shifts and timesheet holidays.

District administrative staff member

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.