TFS Evolution supports scrum teams with the most important information about their current project during their daily stand-up meeting. The app is based on the integration features of Visual Studio Online like Rest API, OAuth2.0 and Service Hooks.
TFS Evolution is based on Visual Studio Online projects. It uses OAuth 2.0 and the new REST Api to retrieve data from a scrum based team project. This information is prepared for the two different views the app is providing to the scrum team. Some features synchronize data with VSO through service hooks (e.g. work item changed)
Screen one consists of a burndown chart, a sprint progress chart and an event ticker.
The second screen visualizes the team tasks of one sprint as part of a task board. It’s optimized for touch and contains a fast edit mode for remaining work and the assignedTo-Field of the task work item. The remaining work can be edited with a simple touch gesture.
- Register the app for Visual Studio Online (https://app.vssps.visualstudio.com/app/Register)
- Enter your APP_ID and your APP_Secret in OAuthAuthenticator.cs
- Enter your REDIRECT_URI (e.g. https://oss-tfs.azurewebsites.net/authorize )
- Install the app on your device
- Start the app and authenticate with your Microsoft Id and additionally with your alternative credentials
- Connect to your project and start working
- Set up a service hook for your team project in VSO to get automatic updates in the App
- Select “Web Hook” as target service
- Set “Work Item update” as event
- Set “https://oss-tfs.azurewebsites.net/api/event” as service URL. You don’t need to set any basic authentication settings!
Please note: Our web service collects and stores work item data and prepares it for our app. If you do not want your work item data to be stored in our azure storage we highly recommend you to install your own web service. The corresponding source code for deployment can be found in this repositories in the "TFSWebService" directory. To use your own web service you simply have to change the service URL in the app settings and in the service hook settings.
If you want to run your own web service you need to take care of following parts in the TFSWebService solution:
- Set the connection string in web.config (AccountName = name of your azure storage | AccountKey = Access key of your azure storage)
- Set your encryption key and initialization vector in web.config (choose any string you like. it's used to encrypt and decrypt your work item data)
- Publish the TFS web service to your azure website