Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

Cognition version 9.4.3 introduces greater flexibility, allowing users to request a chosen first name to be displayed across the system while retaining their HR system name for administrative purposes, such as digital acknowledgments.

You'll notice updates to First Name management, including changes in User Administration and User ImportsThis page contains additional information around ‘HR First Names’ and ‘Display First Names.’

For a basic overview of how ‘HR First Name’ and ‘Display First Name’ work, see Display First Names and HR First Names.

Table of Contents
minLevel1
maxLevel6
outlinetruefalse
stylenone
typelist
printabletrue

...

...

First Name

...

  • Source: Automatically set by system processes such as User Import feeds and Mass User Upload feeds.

  • Use: Displays on digital acknowledgments unless configured otherwise.

Display First Name

  • Source: Initially set to match the HR First Name but customizable within the LMS.

  • Use: Appears across the system, except for digital acknowledgments. Can be configured to replace HR First Name on digital acknowledgments.

System Settings

...

Display First Name update requests

Info

These settings can only be modified by your support specialist.

...

System Settings

First Name settings can be found on the Interface tab of System Settings.

...

Enable User Display First Name requests

To allow users to be able to make requests around their Display First name, this setting must first be enabled. Once requests are enabled, you may additionally decide whether or not users can submit requests to use their Display First Name on HR Sign-offs (digital acknowledgments).

Under Approval Options, you may choose whether or not requests must be approved by an Enterprise Administrator or can be automatically approved.

Request Summary Emails

When enabled, reminder digest emails are automatically sent to the desired recipient(s):

...

When a new request is received (within 24 hours)

...

(EA) or whether requests will be approved automatically.

This flexibility lets you balance user autonomy with your organization's naming policies. When you enable EA approval, only Enterprise Administrators can modify ‘Display First Names’ in User Administration, ensuring proper governance of name changes.

Info

To update these settings, contact your support specialist.

Enable Request Summary Emails

Daily Summary emails of outstanding requests can be enabled and sent to one or more specified email addresses. You can set the reminder interval to receive occasional reminders when requests stay open.

User Administration

Adding Users

Automatic processes (User Import feeds, Mass User Upload)

When a user is created uploading new users through a User Import Feed feed or Mass User Upload, the First Name from the feed is applied to imported first name will become both the HR ‘HR First NameName’ and Display ‘Display First Name fieldsName’.

Add New User

...

Typing into the HR First Name field automatically populates the same characters in the Display First Name field.

The Display First Name field can then be left as is or edited to a custom name.

...

Wizard

When manually adding a new user in Cognition, the ‘HR First Name’ automatically populates the ‘Display First Name’ field. Administrators can also enter a ‘Display First Name’ during creation if needed.

...

Updating Users

Automatic processes (User Import feeds, Mass User Upload feeds)

When an existing a user’s First Name in from a User Import Feed or Mass User Upload differs is different from their current HR First Name in the system (an updated value is received):‘HR First Name’, the changes made will depend on whether or not the user’s Display First Name has been previously modified.

  • HR First Name: Always updated to the new value.

  • Display First Name:

    • If the user is not using a custom Display First Name, it is also updatedit hasn’t been modified, it updates automatically.

    • If the user has a custom Display First Name set, it remains unchanged.

...

    • it has been modified, it stays as-is.

Note

To avoid unintentionally overwriting HR First Names, be sure to use HR First Names in Mass User Uploads.

User Administration - Edit User - Information tab

HR ‘HR First NameName’ will only be visible/editable to EAs in User Administration.

When First Name Requests are ON and require EA approval, only EAs can modify Display ‘Display First Names.

A non-EA admin with access to User Administration can only modify a user’s Display ‘Display First NameName’ if First Name Requests do not require EA approval and the student user does not currently have an open request from a time when requests required EA approval.

...

Display Name Requests

If enabled via System Settings, end-users can request updates to their Display First Name and which name appears on digital acknowledgments.

Create Display Name Requests (end users)

To submit a new Display Name request, users can go to their Profile and click I go by a different name.

...

Here the user can request 1 or both of the following options:

  1. An updated Display First Name

  2. Use of their updated Display First Name on HR sign-offs

...

Review Display Name Requests (EAs)

When Display Name requests are enabled and require EA approval, a link to the open requests will appear in the My Tasks widget on the EA dashboard.

Note that the number shown here is only reflective of the number of open requests from active users.

...

Select the Options menu next to an open request and click View request.

...

Approve the appropriate pieces of the request then click Update.

...

Tokens

Tokens are available to map the appropriate fields in both Dynamic Documents and External Data Connections.

...

First Names in Reports

All reports will reference users' by their ‘Display First Names’ by default, including the User Report. EAs have the ability to enable ‘Include HR First Name’ when running the User Report to output users' ‘HR First Names’ as well the name they use on HR sign-offs.

...

Dynamic Documents and Name Fields

For Dynamic Documents and External Data Connections, there are fields for each type of name, so you can control which name shows in the document or is published externally. These tokens include:

  • Display First Name

  • HR First Name

  • Sign-off First Name

  • Last Name

  • Display Full Name

  • HR Full Name

  • Sign-off Full Name

  • Digital Signature

Sign-off Name tokens will pull display the appropriate name used the individual uses for sign-offs based on the individual user’s their setting in User Administration.

Digital Signature tokens will pull also use the appropriate name just like specified by the Sign-off Name tokens setting, but will display as:

Digitally Acknowledged by [Sign-off First Name] [Last Name] on [Date] [Time].

...

Reports

User Report

The User Report will display users' Display First Names by default. EAs will have the ability to enable Include HR First Name when running the User Report to output users' HR First Names as well the name they use on HR sign-offs.

...