How to create and (de)activate Jira users

This simplified use case shows how new Jira users can be created, deactivated and reactivated in a local or remote Jira instance with the help of Teamworkx Issue Publisher for Jira. For this, each new user is represented as an issue within a designated Jira project. The necessary web requests to create, deactivate and reactivate the users are executed by three Issue Publisher operations. While most of the used functionality here has been available since version 9.3.0 of the Issue Publisher, some of the advanced error handling capabilities have only been available since version 11.4.0.

Server Connection

The Jira server you want to create users in has to be set up in the Server section of the Issue Publisher Configuration. You can configure the local Jira or a different one here. If an application link to the target Jira server has already been set up you can use that one, instead of setting up a custom connection.

Open

Fields

In order to create a new user the following information is required: 

• Email address

• Full name

• Username

Hence, you need to think about which Jira (custom) fields you want to use in the new user issue to gather the required information. In this example, we use the Summary field to set the Full name of the new user and the custom field Email to set the Email address and Username.

Open

Create User

Template

Set up a new Web Request Template to create the Jira user.

Operation

Set up a new Single Issue Operation for Create User and add the following steps:

1. Add the first step using the Send web request action with your new Create Jira User template. As Server choose the one where you want to create the new users and ensure you check Skip Status Code Validation and select Ignore for Error Handling for the next step to be called.

   
   
   

2. Create the second step using the Create a comment action to add a comment to your user issue stating whether the request was successful or not.

   There are obviously various reasons why the creation of a new user could fail. The following template for a comment provides distinct statements for the successful creation of a new user as well as potential errors. As far as possible the error messages from the response are included as well.
   #if($stringUtils.startsWith($response.getContent(), "{")) ## handle a JSON response #set($responseMap = $responseHelper.getJsonAsMap($response)) #if($stringUtils.isNotBlank($responseMap.get("name"))) The user $responseMap.get("name") was successfully created. #else There was a problem while creating the user: #if($collectionHelper.isNotEmpty($responseMap.get("errorMessages"))) Error Messages: $stringUtils.join($responseMap.get("errorMessages"), "; ") #end #if($responseMap.get("errors") && ! $responseMap.get("errors").isEmpty()) Errors: $stringUtils.join($responseMap.get("errors").values(), "; ") #end #end #else ## handle a non-JSON response There was a problem while creating the user. See log file for details. #end

Deactivate User

Template

Set up a new Web Request Template to deactivate the Jira user.

Operation

Set up a new Single Issue Operation for Deactivate User and add the following steps:

1. Add the first step using the Send web request action with your new Deactivate Jira User template. As Server choose the one where you want to deactivate the users and ensure you check Skip Status Code Validation and select Ignore for Error Handling for the next step to be called. 

   
   
   

2. Create the second step using the Create a comment action to add a comment to your user issue stating whether the request was successful or not.

   The following template for a comment provides distinct statements for the successful deactivation of a new user as well as for an error.
   #if($stringUtils.startsWith($response.getContent(), "{")) ## handle a JSON response #set($responseMap = $responseHelper.getJsonAsMap($response)) #if($stringUtils.isNotBlank($responseMap.get("name"))) The user was deactivated. #else There was a problem while deactivating the user: #if($collectionHelper.isNotEmpty($responseMap.get("errorMessages"))) Error Messages: $stringUtils.join($responseMap.get("errorMessages"), "; ") #end #if($responseMap.get("errors") && ! $responseMap.get("errors").isEmpty()) Errors: $stringUtils.join($responseMap.get("errors").values(), "; ") #end #end #else ## handle a non-JSON response There was a problem while deactivating the user. See log file for details. #end

Activate User

Template

Set up a new Web Request Template to activate the Jira user.