Additional User Information

Additional User Information

Additional User Information allows for the storage of useful information about your users. E.g. Birthday, Department, Date of Promotion, contract expiry date etc.

Configuring Additional User Information

To add fields for your user information, click on the 'Additional User Information' button on the side bar under 'TechTime User Management' while on a page that is under Jira's own User Management or 'TechTime Apps' (Confluence). And you will see the page below loaded.

1. Import Information - Bulk Import Additional User Information from a CSV File. See below for more info.
2. Key - Unique value for identifying fields.
3. Name - The name you wish to be visible on the 'Edit Additional Info' screen for users.
4. Type - The input type of this field. Currently 'String' and 'Date' are supported.
5. Order/Delete - Rearrange the ordering of the fields (as displayed on the User's page) or delete one if it is no longer needed (note: data is still maintained incase the key field is re-added, if you want to permanently delete this information uploading a CSV with blank entries for the key before deleting it will work).
6. Add Field - Add extra fields.

Once you are done adding fields do not forget to Save. If you navigate away from this page without saving you will loose your fields.

Viewing User's Additional Information

To view User Management's additional user information values head to the 'Users' page and on:

• Jira: Then click '...' and then 'Additional User Information', or while viewing an individual user click 'Additional User Information'.
• Confluence: Click 'Edit Additional Info'.
  
• Bitbucket: Feature not available.

This will take you to the configuration page for the user where their details can be entered. If no fields have been configured prior to coming to this page then only the name of the user will be shown.

Bulk Importing Attribute Values

If you have many values to import doing it one by one is a time consuming task. Thus, there is the ability to upload a CSV file to bulk import your user attributes values.

Restrictions on Bulk Importing:

1. The CSV file must have the 'username' column.
2. Each field in the imported CSV file must already exist in User Management. If it does not exist, values for that key will not be imported.

3. Dates must be in a year-month-day format, '-' or '/' are accepted.

   Examples
   2024-12-24 ✅
   2024/12/24 ✅
   2024/Jan/01 ✅
   2024/03/1 ✅
   2024/3/1 ✅
   02-24-2023 ❌
   13-05-2034 ❌

User Management will not create missing fields that are listed in the CSV file and not on the Additional User Information page, nor will we create users who are listed in the file but are not a part of your instance. Instead once an import has been run we will display a summary of the results. If there are failures in the importing process e.g. user is not in the instance, field does not exist in User Management, or the date is of an unsupported format. We summarise these so that at a glance you can see if there were any troubles (screenshot below). If you are wanting more details on the issues that occurred during import, you can download the summary file which will list the summary as well as all failures for each user and the reason for it failing.

Below is an example of a valid file for the above image with keys dept and dob.

Note: CSV column headers are case-insensitive.

username,Dept,DOB
doej,Engineering,1980-05-26
jsmith,Accounting,1990-03-16