A quick and dirty TFS Slack bot. Its quite rushed as it was done between work. It does, however, get the job done.
Open up SlackBotService.exe.config and make the following edits:
<client token="" />- Put your slack bot integration token into the token attribute.
<add name="tfs" projectCollection="" project="" loginMethod="0" accessToken="" username="" password="" searchString="" queryGUID=""/>- Put your project collection into the projectCollection attribute: (e.g.
http://mytfs:8080/tfs/MyCollection) - Fill in the project attribute.
- If using an access token, leave loginMethod="0"
- Get a Personal Access Token and fill that in.
- If using standard domain login (TFS 2015 does not support access tokens) set loginMethod="1"
- Enter your username (including domain if required) into username
- Enter your password into password
- If you wish to use the search functionality, set the following items:
- Set the search string to something unique (e.g. !searchtfs)
- Set the queryGUID to the GUID of a query in your TFS project that will be used for searching.
- Put your project collection into the projectCollection attribute: (e.g.
Open up an elevated developer command prompt and cd to the directory, then run:
installutil /i slackbotservice.exe
net start slackbotservice
Make sure you use an account with access to TFS for the service account. Keep an eye on the Windows event log the first time you run it: it will report status and errors there. Invite your bot to a room and type in a TFS item (e.g. tfs123456).
Note that when installutil prompts for the username you need to put
.\username (more info)
This stuff is beyond alpha so you may need to restart it from time to time.
Getting started with Git and GitHub
- People new to GitHub should consider using GitHub for Windows.
- If you decide not to use GHFW you will need to set up Git and connect to GitHub.
- Fork the TFS Slack Bot repository.
- Finally you should look into git - the simple guide.
Rules for Our Git Repository
- We're here to have fun.
- Seriously, have fun.
- Check out the Code of Conduct.
- No matter how small a contribution is, or how much work it needs, we are grateful.
- The coding standards aren't strict at all, but when in Rome be a Roman: take a look at how the code is written and try to stick to that.
- Just one thing: 4 spaces, not tabs.
TFS Slack Bot is licensed under the MIT license, which can be found in LICENSE.
Additional Restrictions
- We only accept code that is compatible with the MIT license.
- Copying copy-left (e.g. GPL) code is strictly forbidden.