SmartTFS User Manual
Contents
1. Connect to TFS The Smart Way Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved a Tt a 75 4 48 TFSMobileApp 9 Requirements 3 Tasks 12 out of 12 out of Changesets D 42 tfsdemouser outlook com Powered by Canarys www ecanarys com Canarys Quality is our Mantra UKAS MANAGEMENT SYSTEMS 61647 A 0001 UK En New Business Enquiries Callon 1 609 945 0771 Email CIH Company Brochure Product Support Thank you for choosing SmartTFS To get the latest product updates get support online or for more information about the topics covered in this manual visit the Support website at http www ecanarys com products smarttfs Phone US only 1 609 945 0771 Email tech support ecanarys com Product Trademarks SmartTFS the SmartTFS logo and Connect to TFS The Smart Way are trademarks and or registered trademarks of Canarys Automations Pvt Ltd and or its subsidiaries in the United States and or other countries Information is subject to change without notice Other brand and product names are registered trademarks or trademarks of their respective holders Canarys Automations Pvt Ltd All rights reserved No part of this publication may be reproduced transmitted transcribed stored in a retrieval system or translated into any language in any form or by any means without the written permission of Canarys Automations Pvt Ltd Statement of Use To2. application pool that this service is going to be used is set to use Net 4 0 framework os Application Pools This page lets you view and manage the list of application pools on the server Application pools are associated with worker processes contain one or more applications and provide isolation among different applications Filter Go Show All Group by ASP NET v4 0 Started v4 0 Integrated 4 Applicatic E ASP NET v4 0 Cl Started v4 0 Classic Applicatic p Classic NET App Started v2 0 Classic Applicatic Nei DefaultAppPool Started v2 0 Integrated Applicatic i Microsoft Team F Started v4 0 Integrated LocalSer Tr Microsoft Team F Started v4 0 Integrated LocalSer TfsoData Started v2 0 Integrated Applicatic Advanced Settings B x NET Framework Version bd Ts Managed Pipeline Mode Integrated Name TfsOData Queue Length 1000 Start Automatically True E CPU Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Program Space Configure TFS OData Services Troubleshooting Common Issues Two common errors seen when building and deploying OData services are HTTP 500 and 404 Here are the most common causes and what to do about them HTTP 500 Internal Server Error after new deployment Permissions ensure application pool identity running deployed service has appropriate permission to database HTTP 404 You may have deployed the schema
3. but not the data OData services return a 4 04 when you query by primary keys that don t exist For example you would get this error if testing with the following which asks for a product with a key of 843 when the data has not been deployed Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Program Space Configure TFS OData Services References References Configure TFS OData Services http www tfsagilepoker com HowTo Win8 ConfigureTfsOdataServices OData Service for Team Foundation Server v2 htto www microsoft com en us download details aspx id 36230 Deploying OData Services using IIS amp SQL Server http msdn microsoft com en us data gg192995 aspx Team Foundation Server OData API https tfsodata visualstudio com What is the OData protocol OData Home http www odata orq Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved How To Tasks wil 77 4 54 J Q Connect to Team Project EndPoint https tfsodata visualstudio com DefaultCollection Domain tfsmobileappdemo User Name demouser Password Save Powered by Canarys www ecanarys com 5 all 76 5 49 Smart TFS C How to configure SmartTFS on the device Tap the SmartTFS after installation Tap the Settings option e Projects Fill in the details relevant to your Team Project Settings EndPoint Type the URL to point to your TFS Server Domain Type the D
4. systems OData has been embraced by numerous developers for building great device specific applications OData is accessible from any device and application stack which supports HTTP requests Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Introduction What does SmartTFS do Using SmartTFS you can Connect to your Team Projects on the Team Foundation Server in premise on cloud Track the progress of the project on the Home Screen Track the requirements and its workflow status Track the tasks from the project resource level Track the bugs at the resource level Track the Changesets at the resource level Track the build summary at the Team Project level Track the overall project status across all Team Projects How to get SmartTFS Canarys SmartTFS is a smart way to connect to Team Foundation Server and track the project progress on the move You can download the app and follow the simple instructions to install it on your Team Foundation Server See more details about this app at our website http www ecanarys com products smarttfs Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Introduction How much does SmartTFS cost SmartTFS for mobile devices is available for free How to install SmartTFS Download SmartTFS from the product download page Follow the standard installation procedure for any Android App How do we ensure the security of your data in SmartTFS The app
5. FS app to navigate between Team Projects Build Determine the latest build status Success Partial Success or Failed Requirements Tasks and Bugs Determine the requirements tasks bugs and work status Changesets Determine the latest Changesets and work Status Tap the Refresh icon to refresh the dashboard snapshot Prerequisite Configure SmartTFS after installation B il 75 4 48 J TFSMobileApp Build Status Requirements 3 out of 3 Tasks 12 out of 12 out of Changesets 9 42 tfsdemouser outlook com Powered by Canarys WWW eCanarys com Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved 77 4 55 P S Note The TFS server you are trying to connect must have OData Services configured Settings The following details are required to configure SmartTFS app to connect to Team Foundation Server 2010 2012 Endpoint The URL to point to your TFS Server For e g https tfsodata visualstudio com TFS AppsCollection Domain The Domain name for your network User Name Your User Name to access your TFS Server Password The password relevant to the User Name This configuration settings is stored locally and used every time to connect to Team Foundation Server Tap on the settings icon on the top bar to change any of the details and tap save button to confirm the change Selecting a Project Tap on Drawer
6. Studio Development Server To test locally single click on the project to verify SSL settings are enabled Virtual path Copy the SSL URL value to the clipboard G iind i Nene Create Virtual Directory Paste it into the Project URL setting in the ODataTFS Web project properties C Override application root URL http localhost 10042 _ Use Custom Web Server Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Program Space Configure TFS OData Services How to configure SmartTFS on the in premise server Wits hy cabal acti tu https ecalhest DefaulhCofection Presects projecthiame Buis Run the project Buld Definitions https cast DefaulhCollection Projects projecthame BuldDefinition It will launch IE and prompt you to continue past the invalid SSL Changesets http localhost De faulhCollection Changesets https ecalhent DefauliCobection Projects rajecthamne Changesets https ecalhest DefaultCofoction tranches path Ohangesets Click continue and the TFS OData page will tps locates Defadtcokection Bus Project prisme Definition Duke Mumbar Bukhari Chargesa d S P ay Changs Neipe bcahos t befall olection Cantet Cs 1 angis branche Nr 2 l hbcaners 1 De land cac tte dr anche If you scroll half way down you will see several queries you can run https bcaiest DelaudtColection Fretects priame Branches Workitems https bohot Delm
7. eam Foundation Service subdomain added in service code during runtime Example local endpoint https tfs 80808 tfs lt WorkItemTrackingCacheRoot can be modified to change the location of the TFS OM cache cadd key WorkItemTrackingCacheRoot value C TFSOMCache lt appSettings gt lt bindings gt lt webHttpBinding gt ivedMessageSize 157286486 ma ringContentLength 157286460 lt binding gt lt webhttpBinding gt lt bindings gt lt system serviceModel gt Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Program Space Configure TFS OData Services How to configure SmartTFS on the in l Properties ix premise server ODataTFS Web Project Properties v To test locally single click on the project to aa j verify SSL settings are enabled Always Start When Debug True Copy the SSL URL value to the clipboard Anonymous Authenticatic Enabled Managed Pipeline Mode Integrated Paste it into the Project URL setting in the Project File ODataTFS Web csproj ODataTFS Web project properties 7 SSL Enabled True SSL URL https localhost 44301 Windows Authentication Disabled Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Program Space Configure TFS OData Services Servers How to configure SmartTFS on the in premise server Apply server settings to all users store in project file C Use Visual
8. for optionally installing this service in Azure sual Studi Name Computer OS C ODataForTFSV2 3 0 code tified amp nuget amp ODataTFS Cloud ODataTFS ConsoleClient amp ODataTFS Model amp ODataTFS Model Tests amp ODataTFS Web amp packages 17 2013 11 23 AM File folde d References 1 17 2013 10 26 AM trite Open the ODataTFS Solution in the Code 52 ODataTES Cloud sin 1 17 2013 11 05AM Microsoft Visual folder 5 fg ODataTFS sin 1 17 2013 11 05 AR soft Visual S J ODataTFS Tests sin 4 1 121105 AM Microsoft Visual Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Program Space Configure TFS OData Services How to configure SmartTFS on the in premise server From the ODataTFS Web project open the Web config file to set the TFS Connection Modfiy the ODataTFS TfsServer appSetting to point to your TFS Server TFS OData Service uses basic authentication to pass the username and password to the TFS Server This passes those values as plain text so it is highly encouraged to use HTTPS The remaining steps assume you are configuring this to use HTTPS If you are not or want to use it for testing Change the Transport security to TransportCredentialOnly lt appset t ings gt lt add key ODataTFS AuthProvider value Microsoft Samples DPE ODataTFS Web Infrastructure TFSAuthProvider gt lt 1 TFS endpoint goes here j d 44 m for T
9. i obection Work tems https beaet Dafad oloction But Project priame Definitions Buhddef Mumbar Bulttm Warnnems Test returning a list of work items sees aie EER https ecathest DefautColection Projects projectame Workitems htipes l hotel De fauttOobiectinens Ouar tend ki Work iter Attachments https cathost Do faudCokoction wark tems H Attadiments Links Weipa hocalvest Default oc tion Workers 11 inks Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Program Space Configure TFS OData Services How to configure SmartTFS on the in ge p rem i se serve r You are viewing a feed that contains frequently updated content When you subscribe to a feed it is added to the Common Feed List Updated information from the feed programs Learn more about feeds d Subscribe to this feed Update the URL to something similar to the following Create new user https localhost 44301 DefaultCollection Workltems Branding Wednesday March 13 2013 2 13 35 Ph Adjust accordingly if your collection name server name or port is different test Wednesday March 13 2013 8 49 59 Ah This should display a list of work items in a format similar to a RSS ATOM feed Welcome Page should display Wednesday March 13 2013 amp 31 16 AM New User Creation Wednesday March 13 2013 amp 30 34 Ah Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Program Space C
10. icon the three lines in top right corner of blue bar to see the drawer menu screen Tap on Projects to see the list of projects accessible with the current credentials provided in the settings screen Tap the project to see the home Powered by Canarys www ecanarys com
11. improve internal design operational function and or reliability Canarys reserves the right to make changes to the products described in this document without notice Canarys does not assume any liability that may occur due to the use or application of the product s described herein Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Contents Program Introduction Space Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Introduction What is SmartTFS for mobile devices SmartTFS is a smart way to connect to your Team Foundation Server in premise on cloud Authorized team members can quickly connect to their Team Projects using the OData Service on SmartTFS and track their project progress easily on the go SmartTFS provides a quick access intuitive layouts easy navigation and drill down data widgets to access the real time information on your tasks requirements bugs Changesets and build summary reports You can track your project progress on the move Which devices does SmartTFS support You can install SmartTFS on Android mobile phones and tablets operating systems How does SmartTFS works SmartTFS for mobile devices allows you to access data you stored on Team Foundation Server in premise on cloud using OData Service OData Service model provides a great solution work with data from Team Foundation Server on multiple device types such as smartphones and tablets and operating
12. is color tile to view the tasks status Active ee Resolved or Closed Bugs Tap this color tile to view the bug status New Changesets Active or Resolved 5 Changesets Tap this color tile to view the Changesets E T E ordered by latest Tap the Refresh icon to refresh the dashboard snapshot Powered by Canarys www ecanarys com Powered by Canarys www ecanarys com Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved How To Tasks How to track the Requirements and workflow status of the Team project Tap the Team Project to connect Tap the Requirements tile You will see the requirements sorted by latest entry first Tap the Requirement You will see the work item info Prerequisite Configure SmartTFS after installation O FA il 75 4 48 DER Requirements 3 out of 3 TFSMobileApp Build Status Tasks 12 out of 12 out of Changesets 9 42 tfsdemouser outlook com Powered by Canarys www ecanarys com lt Requirements 76 w 4 51 Customer can find the nearest New martinn russell Customer can look up television New martinn russell Customer can sign up for emails New martinn russell Powered by S Canarys www eCanarys com Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved D Al 76 Gl 4 51 311 Title Customer can find the nearest App support location Project Name TFSM
13. obileApp Type Product Backlog Item Priority Severity AssignedTo martinn russell Powered by Canarys www ecanarys com How To Tasks How to track the Tasks from the project level Tap the Home option Tap the Team Project to connect Tap the Tasks tile You will see the tasks sorted by latest entry first Tap the Task You will see the Task work item info Prerequisite Configure SmartTFS after installation O FA all 75 4 48 OO Requirements 3 out of 3 WL elt am l i TFSMobileApp Build Status Tasks 12 out of 12 out of Changesets s 42 tfsdemouser outlook com Powered by Canarys www ecanarys com Powered by Canarys wil 76 4 52 Create database for branch office To Do phillipp flores outlook com Design implementation of feature To Do martinn russell Review design of feature To Do harry butlerr outlook com Create UI for feature To Do phillipp flores outlook com Create data sync to network To Do phillipp flores outlook com Design implementation of feature Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved www eCanarys com an im OB lt Workltem Info 76 BA 4 52 ID 312 Title Create database for branch office location lookup Project Name TFSMobileApp Type Task Priority Severity AssignedTo phillipp flores outlook com Powered by Canar
14. omain name User Name Type the User Name already registered in your TFS Server Password Type the password relevant to the User Name Tap the Save button to confirm the authentication You will see the TFS Collections screen next Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved How To Tasks How to connect to my Team Project Tap the Home button You will see the TFS Collection Home Screen Tap the Home option You will see the TFS Team Projects Tap the Team Project to connect You will see the Team project dashboard Prerequisite Configure SmartTFS after installation A Home Projects Settings OF all 76 5 49 7 O il 77 4 55 O 5 ail 75 4 48 Requirements 3 out of Changesets s 42 tfsdemouser outlook com Powered by Canarys Powered by Canarys Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved How To Tasks Prerequisite Configure SmartTFS after installation How to track the progress of the Team project il 77 0 4 55 AC amp il 75 4 48 Projects ou SOn USE RO SO Tap the Team Project to connect TFSMobileApp Build Status You will see a dashboard of current work in progress TFSNavisionApp Build Info Tap this color tile to view the build status Succeeded or Failed Requirements Tap this color tile to view the requirements work status Approved or New Tasks Tap th
15. onfigure TFS OData Services How to configure SmartTFS on the in 2 x premise server Site name Application pool TfsOData i TfsoData set Now that you have it running locally Content Directory deploy it to any IIS server in your network Physical path or again you can host this in Azure see readme documentation included with OData Service for TFS v2 download Create a website specify a local folder set the SSL to the appropriate server Make sure to configure a trusted SSL certificate or TFS Agile Poker will return an error Ensure the application pool that this service is going to be used is set to use Net 4 0 framework Ic inetpub tfsodatawwwroot ve Pass through authentication Connect as Test Settings IP address Port y al Unassigned 443 Host name SSL certificate Not selected IY Start Web site immediately Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Program Space Configure TFS OData Services How to configure SmartTFS on the in premise server Now that you have it running locally deploy it to any IIS server in your network or again you can host this in Azure see readme documentation included with OData Service for TFS v2 download Create a website specify a local folder set the SSL to the appropriate server Make sure to configure a trusted SSL certificate or TFS Agile Poker will return an error Ensure the
16. rtTFS after installation O FA il 75 amp 4 48 OO Requirements 3 out of 3 adin elt P i a TFSMobileApp Build Status Tasks 12 out of 12 out of Changesets 9 42 tfsdemouser outlook com Powered by Canarys www ecanarys com A wil 76 4 50 wl mG 2m T i il lt Builds Calculator_DefaultBuild_201 Z 54 sec tfsdemo user Calculator_DefaultBuild_201 Z 51 sec tfsdemo user Powered by Canarys www ecanarys com Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved a a OR lt Build Status 76 4 50 Project Name TFSMobileApp Build Definition Calculator_DefaultBuild Build Number Calculator_DefaultBuild_20140514 1 Build Status Failed Last Changed By LOCAL AUTHORITY Elastic Build tfsmobileappdemo Errors Cannot write to the output file C a src obj Debug Calculator Calculator resources Access to the path C a src obj Debug Calculator Calculator resources is denied Cannot write to the output file C a src obj Debug Calculator Properties Resources resources Access to the path C a src obj Debug Calculator Properties Resources Powered by Canarys www ecanarys com How To Tasks How to use Help Tap the Team Project to connect Tap the Help icon for more information Settings How to configure SmartTFS app to connect to another Team Foundation Server Selecting a Project How to use SmartT
17. uses SSL protocols to transfer data through both In Premise and On Cloud TFS Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Program Space Configure TFS OData Services How to configure SmartTFS on the in premise server Primarily You require an OData service to access the Team Foundation Server through SmartTFS Team Foundation Server 2010 and 2012 can be configured to support the TFS OData Services By default the only supported connectivity to TFS is through the client object model This is essentially a wrapper around that API Follow these steps to configure TFS OData Services for your on premises TFS implementation To deploy the OData service you will need the following e Microsoft NET Framework 4 5 e Team Foundation Server 2012 Update 1 Object Model Installer included as part of ODataTFS Web project IS7orlater with ASP NET installed this means Windows 7 and up Windows Server 2008 and up e SSL certificate to secure HTTPS endpoint if deploying publically e Windows Azure account optional Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved Program Space Configure TFS OData Services How to configure SmartTFS on the in premise server New folder Download the OData Service for Team Foundation Server v2 and run the executable to unpack the files to a local folder The folder contains a readme document that is also helpful for installing and includes steps
18. ys www ecanarys com How To Tasks How to track the Changesets from the project level Tap the Team Project to connect Tap the Changesets tile You will see the Changesets sorted by latest entry first Tap the Changesets You will see the work item info Prerequisite Configure SmartTFS after installation a TT FA wil 75 amp 4 48 A wil 76 4 53 a k tf A FA wil 76 4 54 TFSMobileApp 9 amp lt Changesets lt Changeset Info Build Status Regui t tfsdemouser outlook com ID a 42 2014 05 14 03 54 06 PM 42 3 Branch 41 tfsdemouser outlook com out of 3 2014 05 14 03 49 31 PM Owner 40 tfsdemouser outlook com tfsdemouser outlook com ESS 2014 05 13 05 08 07 PM 1 2 Commiter tfsdemouser outlook com tfsdemouser outlook com Autor Sree 3 9 2014 05 13 05 08 05 PM Creation Date 2014 05 14 03 54 06 PM 38 tfsdemouser outlook com 2014 05 13 05 08 03 PM han Changesets Comment 42 tfsdemouser outlook com Powered by Canarys www ecanarys com Powered by Canarys www ecanarys com Powered by Canarys www ecanarys com Copyright 2014 Canarys Automations Pvt Ltd All Rights Reserved How To Tasks How to track the Build summary from the project level Tap the Team Project to connect Tap the Build Info tile You will see the Build summary sorted by latest entry first Tap the Build result You will see the build status info Prerequisite Configure Sma
Download Pdf Manuals
Related Search