Firefox > Ubiquity Commands for VersionOne
Ubiquity is a new Mozilla Labs project which provides, via Firefox addon, an extensible command line interface. You can use the VersionOne CLI definition to streamline your interactions with the application.
Commands
- v1setinstance: [url to VersionOne install]. This command needs to be run before any others will work. The full path with trailing / is required. (example: http://www7.v1host.com/mycompany/ )
- v1find: [keyword | name=value | @mine | @open | @current | @closed] (single quotes added) IN [Asset Type: Tasks | Stories | Defects | etc.] ORDERBY [ Order | -Order | Estimate | -Estimate | ToDo | -ToDo | ChangeDate | -ChangeDate ]. Asset constrained find with either simple text match or attribute value match. Check out some advanced find examples.
- v1new: [asset type] IN [Project Name]. Takes you to the creation page for a new story, issue, request, etc with an optional project name.
- v1goto: [pageName] IN [Project Name]. Navigate directly to a page inside the app with an optional project name. Page names correspond to the menu= parameter shown in the URL.
- v1mail: Show your most recent notifications. No support for search terms or sortby (yet).
Getting Ubiquity
Ubiquity is now available from Mozilla Labs.Direct Link to Install (open with Firefox)
Once you have Ubiquity installed (firefox restart required), revisit this page and click the "Subscribe" button in the upper right corner of the screen. If the button is not visible, refresh this page.
Change Notes
- Version 0.3.3: Update to keep up with Ubiquity changes -- fix for "within projectName".
- Version 0.3.2: Added v1faq command
- Version 0.3.1: Added support for Version 9.0 full text search. Hitting enter from v1find will load the simple query term, and optionally the in [Stories|Tasks|Requests|Issues|Tests] term, to the dedicated V1 search page. This option is not available when using where clause filters like ToDo>=2 and it will not maintain sortby arguments.
Advanced Find Examples
Learn more about the API where clause syntax.- v1find @mine : returns stories owned by the querying user
- v1find @open in Issues : returns open issues
- v1find @current : returns stories in current iteration
- v1find @mine @current @open
- v1find ToDo>=2 in Tasks
- v1find @current in workitems sortby order: get current tasks, defects, and stories in the current iteration
- v1find RMA in Stories sortby Order: return stories ordered by Rank
Extending These Scripts or Writing Your Own
This implementation uses the VersionOne Data API via REST. Your additions are welcome!Future Work
Got Ideas for CLI Functions?
Let us know at VersionOneCLI.uservoice.com.Some Command Ideas
- Add in [project] target to v1goto
- Grab from [team]: list unassigned work
- Update [status|progress|estimate] on ...
