...
Bulk Edit Request Participant is a Userscript that allow Admins to add and remove a Request Participants Participant to all issues from a JQL search.
Note |
---|
This Userscript is still being created. What you see here is a draft documentation of how it’s intended to work once it reaches version 1.0.0. |
<img>
...
Download/installation URL:
https://bitbucket.org/jira-admin-userscripts/jaus/raw/master/src/…jaus-bulk-edit-request-participant.user.js
Use cases
This Userscript was meant for Admins to bulk add or remove Request Participants from issues (if Jira Service Management is installed).
This is particularly interesting if you have a public-facing Jira Service Management instance and users leave their respective organizations. If this info reaches you, it’d be interesting to remove such user from all the tickets they’re a participant (so they don’t keep access to the issues data like comments and attachments).
...
The Userscript works on the “issues/?jql=” search screen:
...
Usage
Press the JAUS button on the top or the access key “u” so the Reorder Status box shows up.
…
Mechanics
…Bulk Edit Request Participant box shows up.
For Server/DC you must provide the Request Participant’s username
. For Cloud, it's the accountId
.
The Userscript searches for the provided user as soon as the field’s blurred (you click or “tab” out of it). If the user’s found, it renders a green tick next to it or a warning icon otherwise.
Once you press in “Update issues!” the Userscript will fire a request for each issue, wait 5 seconds then reload the page. It’s nice if you select the “Request Participant” column to show in the search results so you can see the changes right then.
Notice only 50 issues get updated at a time, so you may need to run it a few times.
Note |
---|
If you plan on replacing a Request Participant for another, it’s best if you first add the new participant then remove the old one. This makes is easier as the JQL you may use could look like the one below and you wouldn’t loose the results after the current participant’s removed:
|
Also keep in mind all JAUS Userscripts are MVPs. This means the main focus is on the basic functionality. You may expect some visual glitches if going-back-and-forth, resizing the screen or switching from field to field too quickly, etc. Also the error feedback is very basic to non-existent: some errors just prevent the execution going forward and not show a message.
Mechanics
The Userscript makes use of the following REST API endpoints:
GET rest/api/2/user
GET rest/api/2/search
POST rest/servicedeskapi/request/<issue-key>/participant
DELETE rest/servicedeskapi/request/<issue-key>/participant
It first searches for the user once the field’s blurred.
Then it searches the issues with the provided JQL.
For each issue returned, it fires a request to add (POST) or remove (DELETE) the user from the Request Participant field.
After some 5 seconds, the whole page is reloaded. You may search for those issues to confirm if the operation was successful.
Repository
JAUS Bulk Edit Request Participant’s source code is hosted in BitBucket:…
Notice that to download/install we advise the /raw/
URL.
...
Please select the Component jaus-bulk-edit-reorderrequest-statusparticipant
.
Roadmap
…
Known issues
Please submit them through JAUS Help Portal!
...
JAUS feature request
…