== TFS Extension ==
''Author: Matt Hawley''

Web page: http://hgtfshook.codeplex.com/

Repository: https://hg01.codeplex.com/hgtfshook

'''Updated plugin''':
Repository: https://bitbucket.org/AngelEzquerra/hgtf


=== Overview ===
This extension automatically updates Team Foundation Server work items when there's a reference to a work item id inside changesets.

The hook does not change bug status, it currently only adds comments.

=== Configuration ===
To use this extension enable it in the configuration file (hgrc) like this:

{{{
[extensions]
tfs = /path/to/tfs.py

[hooks]
# run the hook on every change that is pushed or pulled in here
incoming.tfs = python:tfs.hook
}}}
The extension is configured through a configuration section. The following keys are recognized in the '''[tfs]''' section:

==== Required Values ====
||'''Key''' ||'''Value''' ||
||host ||The Team Foundation Server URL that you connect with. ||
||user ||The user name used to authenticate with the Team Foundation Server. ||
||password ||The password used to authenticate with the Team Foundation Server. ||


==== Optional Values ====
||'''Key''' ||'''Value''' ||'''Default''' ||
||regexp ||This is the regex that is used to extract work item ids that should be updated when the hook runs. It must contain only one capturing "()" group that surrounds the bug ids. ||(?is)Work ?Items?: (.+)$ ||
||template ||Template to use when formatting the comment added to the work item. This will override the default template used. Keywords include the usual Mercurial keywords. ||Fixed in revision {node|short}. ||


The '''[tfs.columns]''' section is used to specify additional columns that are also written to when updating a work item template.

The '''[tfs.computedColumns]''' section is used to specify additional columns that are computed by the server when updating a work item template. These do not need a value.

==== Example ====
{{{
[tfs]
host = http://myserver:8080
user = DOMAIN\username  
password = myPassword
regexp = (?is)Work ?Items?: (.+)$
template = Fixed in revision {node|short}.

[tfs.columns]
CodePlex.UpdatedBy = user_cp

[tfs.computedColumns]
CodePlex.UpdatedBy =
}}}

=== Usage ===
This extension doesn't need user interaction to run.

----

CategoryExtensionsByOthers