Tip
If you use a API token to authenticate tot Jira, checkout this branch token-auth-version
This is a project to add tasks from Jira to Things 3
Requires Yosemite because it uses JXA for ease of scripting. It is a fork of the original project jiratotaskmanagers by HackerDude
It has the current functions:
- Sync open Jira issues to a Things3 Project by choise
- Reads DueDate of Jira issue and applys this to the toDo
- Add's all new toDo's to the Today list (schedules todo's for today)
- Supports multible query's (I have it set up to get my Tickets, Releases, Changes etc and drop them in to different lists)
Shortcommings:
- No 2 way sync, you must complete the tasks in Jira
Did you find any of this usefull? Consider buying me a coffe over at BuyMeACoffee
If you are a fan of David Allen's GTD, you probably know how important it is to have only "One Inbox". Many people use something that syncs everywhere, such as Omnifocus or Things.
However for collaboration with others, many techies use Atlassian JIRA. This ends up in a weird "two inboxes" problems, that forces us to schedule our coding life separate from our non-coding life (both work and play).
This I believe leads to tremendous life imbalances. Do I code now, or do I write docs (which are not in JIRA)? On my "What's Next", are my coding tasks included?
JIRA To Things3 is a simple script that you can schedule on your Mac, which create one task for each of your assigned JIRA tasks. You can use cron to "set it and forget it", and get back to One Inbox Bliss.
You may need to use rvm to install a newer ruby. I use 2.1.5, and it's what's specified in the Gemfile.
$ git clone [email protected]:KingOfSpades/JiraToThings3.gitMy first tip is to create a directory to save your config's to. I chose ~/.jira2things for this. You can create a config by using the --config-file=PATH_TO_FILE command, like:
$ /Users/USERNAME/JiraToThings3/jira-to-things3 --config-file=/Users/USERNAME/.jira2things/getTickets.ymlThis will look like this:
Ignoring debase-0.2.5.beta1 because its extensions are not built. Try: gem pristine debase --version 0.2.5.beta1
Ignoring ruby-debug-ide-0.7.2 because its extensions are not built. Try: gem pristine ruby-debug-ide --version 0.7.2
Ignoring unf_ext-0.0.7.6 because its extensions are not built. Try: gem pristine unf_ext --version 0.0.7.6
Config: /Users/USERNAME/.jira2things/getSubTasks.yml
JIRA Url (usually https://yourdomain.atlassian.net):
(you type your JIRA URI)
JIRA Query (leave blank to use assignee = currentUser() order by priority desc ):
(If you don't know JQL, blank should be fine)
Project Name on your Mac's To Do App:
(type the Project name in your Mac's TODO app)
User name:
(your JIRA user name.
Note: If you use OAuth, you still have a user name mapping,
it's in your profile view)
Password:
Store config? (y/n) y
Running JQL:
assignee = currentUser() order by priority desc
Storing password
Storing on /Users/USERNAME/.JiraToThings3/jira_to_things.yml
Got 50 issues that we'll sync with your app
After this, every time you run it it looks like this:
$ /Users/USERNAME/JiraToThings3/jira-to-things3 --config-file=/Users/USERNAME/.jira2things/getTickets.yml Running add_to_things3.jxa
Finished updating 50 tasks in Things.
$ ./jira-to-things
Running JQL:
assignee = currentUser() order by priority desc
Got 999 issues that we'll sync with your app
Running add_to_things.jxa
Finished updating 999 tasks in Things.The default query should show everything assigned to you, open or not (we need to know when it's closed to mark it done). But sometimes this could be a lot of stuff and overwhelm you. If you don't want to overwhelm your Jira you should limit the results by updatedDate. So here's other possibilities:
$ assignee = currentUser() AND updatedDate >= -1wThis query will get all items assigned to you but whill only fetch the items that have been updated in the last week. This keeps the script from crashing the Things3 app with useless data.
JiraToThings3/lib/task_destinations/add_to_omnifocus.jxa:1676:1700: execution error: Error on line 42: Error: Can't get object. (-1728)
This is nearly always a problem with your project or context not existing. Use the --print-config option to see the configuration and make sure your project names and contexts are correct. Go to the appropriate line (42 in this case) to see which variable is wrong for a hint.
Once you've determined what was wrong, --clear-config option to reconfigure, and answer the questions correctly.
/Users/David/.rvm/gems/ruby-2.1.5/gems/jira-ruby-0.1.14/lib/jira/request_client.rb:14:in `request': Unauthorized (JIRA::HTTPError)
This is a JIRA authentication error. We use JIRA basic auth. Clear your config and log in correctly.
Note that if you have never signed in to JIRA using a password (for example, if you use Google Apps login), you need to go to your profile, look at the username and click on "Set Password" to set an initial password. Make sure you can log in to JIRA directly.
You are set up! Now you can put it on a cron line, like this one which sets it to run at office
hours (use crontab -e in Terminal for this):
*/30 7-20 * * * /Users/USERNAME/JiraToThings3/jira-to-things3 --config-file=/Users/USERNAME/.jira2things/getTickets.yml >> /Users/USERNAME/.jira2things/sync.log 2>&1Congratulations! You are done.
This is a weird one. This has to do with the Automation permissions that macOS handles. There is a way to reset them for cron (sudo tccutil restet Cron com.culturedcode.ThingsMac) but this had no effect on my setup. In the end I had to do a NVRAM reset to get my cronjobs working again.
Say you have two or three filters you'd like to get imported with different settings (maybe sub-projects, different contexts for different JIRAs, etc). For this you can use multiple profiles. Simply pass the --config-file option to set up a new yml file. For example:
$ ./jira-to-things --config-file=myopensourceproject.yml
Config: myopensourceproject.yml
JIRA Url (usually https://yourdomain.atlassian.net):The password for your JIRA account will be saved on a file on your computer called
~/.jiratoomnifocus/jira_credentials.yml. It is encrypted using blowfish using a constant key.
As long as both your credentials file are secured as (chmod 700) and owned by the user that will be running it on cron), you should be okay and secure (unless someone breaks into your account, in which case you have bigger problems than your JIRA access!).
If this bothers you, you can set the environment variable JIRA_TO_TASKS_CRYPT_KEY to have the configuration store use a different key. You will need to run -C to clear the config that uses the old key.
Copyright 2009, David Martinez
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.