hubot-axosoft

A hubot script that helps you quickly grab data from and add new items to Axosoft, an agile project management tool.

Works both in the command line and hubot chat integrations. Tested with:

• Slack

Requirements

You will need an existing hubot installation as well as node/npm.

Installation

In your hubot directory, run:

npm install hubot-axosoft --save

Now add hubot-axosoft to your external-scripts.json:

["hubot-axosoft"]

You will probably need to restart your hubot after doing this. You should now be ready to start using commands wherever you normally interact with hubot.

Setup

Before doing anything else you'll need to authenticate the app with your Axosoft account.

1. Run hubot axosoft set url youraxosofturl.axosoft.com.
2. Run hubot axosoft authenticate and you'll be given a link. Please open this in your browser.
3. You'll now be asked to give hubot-axosoft read and write access to your account, after which you'll get redirected to a page displaying an authentication token (this can take a minute or two).
4. Run hubot axosoft set token TOKEN-GOES-HERE to save the token.
5. Finally, run hubot axosoft setup and hubot will do some behind-the-scenes setup, such as grabbing a list of your projects and retrieving your item type names. Tip: You can re-run this at any time to get fresh data.

Onto the good stuff!

Available interactions

Work log report

hubot axosoft work logs from DAY

Lists work logs submitted on the given day, grouped by user and item. Useful for standups/etc. and generally seeing what your team is up to.

Example usage & supported parameters:

hubot axosoft work logs from today
hubot axosoft work logs from yesterday
hubot axosoft work logs from monday
hubot axosoft work logs from 2015-01-13

Output:

Work logs from 2015-01-13:
Tyler Crammond:
[1234] Make everything awesome - 0.5hr
Total: 0.5hr

James Martin:
[55] Clean up Tyler's code - 1.23hr
Total: 1.23hr

Grand total: 1.73hr

Find feature by ID

hubot axosoft feature ID

Returns some information about the bug with the given ID. If you use a different name for features you should use that name instead.

Example output:

Implement new home page design
Project: Awesome Web App
Description:
Implement Chris' new design for our home page.
URL: https://myurl.axosoft.com/viewitem.aspx?id=99&type=features

Add new feature

hubot add feature "TITLE" to PROJECT

Adds a new feature to the specified project. If you use a different name for features you should use that name instead. Note that your title must be in quotes.

Find bug by ID

hubot axosoft bug ID

Returns some information about the bug with the given ID. If you use a different name for bugs you should use that name instead.

Add new bug

hubot add bug "TITLE" to PROJECT

Adds a new bug to the specified project. If you use a different name for bugs you should use that name instead. Note that your title must be in quotes.

Find ticket by ID

hubot axosoft ticket ID

Returns some information about the bug with the given ID. If you use a different name for tickets you should use that name instead.

Add new ticket

hubot add ticket "TITLE" to PROJECT

Adds a new ticket to the specified project. If you use a different name for tickets you should use that name instead. Note that your title must be in quotes.

Misc.

License: MIT

All trademarks are the property of their respective owners.