Processing Mercurial commits via Plugin | Targetprocess - Visual management software

Processing Mercurial commits via Plugin

Mercurial plugin can be used to update entities in TargetProcess. You can update entity states and time spent/remaining as you enter comments when doing a Mercurial commit.

Also, Mercurial integration requires Mercurial Client installed on server side (i.e TortoiseHg).

To set up the Mercurial integration, go to Settings → Plugins, and add a new Mercurial Integration profile:

Processing Mercurial commits via Plugin. Image 1

Note: User name and password must be typed in to "Login" and "Password" fields accordingly - plugin won't connect to repository if password is provided as part of repository URL only.

By default, users in Mercurial and TargetProcess are mapped automatically if one of the following is true:

  1. Mercurial email = TP email
  2. Mercurial Name = TP Full Name
  3. Mercurial name = TP Login

Otherwise, you need to map users:

Processing Mercurial commits via Plugin. Image 2

As soon as the profile is created, TargetProcess will import Mercurial revisions starting from the date you’ve specified. This can take several minutes.
You can track the import status in the log:

Processing Mercurial commits via Plugin. Image 3

Now, as you do a Mercurial commit, just add a comment in any of these formats:

ActionCommit message
Change entity states#ID (or id:ID) state:fixed
Add comments to defect#ID comment: text of your comment here
Add spent time#ID time:1
Add spent and remaining time#ID time:4:8
Update several entities at a time#ID, #ID comment: will not be fixed state: invalid time:0.5
All possible actions#456, #887 state:done time:3:0 comment:whoa! Everything is completed!

Make sure you enter the commit messages as shown above. Neither comments, nor time entries, nor states will update if the format is incorrect. Special words like comment or state are case sensitive, so you cannot use "Comment:" starting with capital "C" in your commit message.

Multi-line comments are not supported at the moment.

Processing Mercurial commits via Plugin. Image 4

In this example, as soon as the commit is done, the status of the entity with ID=584 will be changed to Done, and the comment "Should be included to the current release," spent time = 1 hour and remaining time = 2 hours will be added to the entity.

You can see all the updates from Mercurial in the Source tab:

Mercurial_source_tab

Make sure you enter comments in the correct format as shown above. Neither comments, nor time entries, nor the states will update if the format is incorrect.

Still have a question?

We're here to help! Just contact our friendly support team

Find out more about our APIs, Plugins, Mashups and custom extensions. Join our community of passionate users and even discuss directly with our developers.