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:
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:
- Mercurial email = TP email
- Mercurial Name = TP Full Name
- Mercurial name = TP Login
Otherwise, you need to map users:
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:
Now, as you do a Mercurial commit, just add a comment in any of these formats:
|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.
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:
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