Versions Compared

Version Old Version 3 New Version Current
Changes made by

Sharmendra Vishwakarma

Sharmendra Vishwakarma

Saved on

Key

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

1. Overview

At present, JIRA doesn't have feature to import multiple Users in the Jira Cloud.

1.1 Business Requirement

Business needs a plugin for Atlassian Cloud to import User in bulk.

1.2 Pre-requisites

  1. Jira Software as well as Jira Service Desk (Plugin is compatible with JSD too) should be installed and licensed.

  2. There should be some data, in terms of availability of Users and Groups in Jira.

  3. The CSV to import users should have appropriate headers and there should not be spelling mistakes. (Test what happens when there are spelling mistakes)

  4. CSV User Importer for Jira Add-on should be installed.

  5. CSV User Importer for Jira Add-on functions in two different type of license: Understand the different options available when using Trial Version and when using the Paid version of the plugin.

2. Proposed Solution

Plugin is intended to provides the facility to create/import multiple Users in Jira Internal directory using CSV import. Out of the box (OOB) Jira does not provide this feature.

3. Solution Description

3.1 v1 Features

  • CSV User Importer for Jira is for Jira Admins who wants to create mutiple Users in Jira from a single page without toggling between different Jira pages.

  • Plugin has one page "Import Users" in the Jira Admin page

  • Import Users

    • Import Users page displays the option to upload CSV file to Jira. 

    • The User can upload the CSV file with User attributes such as groups, Username, display name and email id.

    • Once the file is selected the page displays the Field mapping so the username, groups, display name, Email can be mapped to appropriate CSV columns.

    • After the mapping, the users are created and the page displays the upload status of the each user with their user details. 

3.2 User and Roles 

Jira Administrator privileges are required to install/access the plugin.

3.3 CSV Template

3.3.1 Columns/Headers

Username,Full Name, Email Address, Group name.

3.3.2 Sample File

...



4. Plugin Details (Pagewise)


Sr.No#

Plugin Page (Within Jira)

Feature

1

Installation

One should be able to install plugin from Marketplace

One should be able to Upload an Obr

2

License

Trial License will work

Paid version License will work

3

Trial License

License conditions for 30 days trial user version :

  • The Trail version allows to create 15 users per upload and will disable after 3 CSV file uploads.

  • In total 45 users can be created using trail version by uploading 3 CSV files with 15 users each.

  • To utilize complete functionality of "CSV User Import”, licensed version is needed.

4

Paid License

No restriction on the no of users created and the number of CSV file uploads.

5

Manage Add-Ons Page

A section for CSV User Import should get added, which will display Import Users

6

Import User

  • This page shows option to upload a CSV file from internal directory

  • When No file is added it displays as No file Chosen

  • One a file is chosen and uploaded it's name appears

  • After clicking "Next" the field mapping page shows which has the Jira Fields which has to be matched with the CSV column fields.

  • After Clicking "Create Users" we get the Imported User status which displays the status of our upload for each users.

5. References


Reference to the User Manual to Install and simulate Test Cases:


Glossary

Admin/Jira Admin : User with administrative privileges.

CSV : Comma-Separated Value (File Format)