Home

TFS ASAP – User Guide

1. Figure 5 Event Viewer Application View with Filter Automated Servicing and Administration Platform TFS ASAP User Guide Page 12 of 48 ye TFSASAP 4 Using TFS ASAP Automations 4 1 General Each configuration needs to be done on all TFS app tiers with TFS ASAP installed The actual rules that are executed by TFS ASAP can be configured in an XML file The XML file itself is loaded at runtime Autonseron TSI NRBR BEGIR NNN 907BO1DD4B86 DisplayName Current Work Automation name AIT ASAP Automation TriggeredAutoma tions WorkItemAutomations Common Configuration CurrentWorkAutomationConfiguration AIT ASAP Au tomation TriggeredAutomations WorkItemAutomations Common gt lt CUrrentWork gt Custom Current Work lt Current work ES Optional SoystemeChangedDare used by default gt gt gt lt WorkDate gt Custom current WorkDate lt WorkDate gt lt RemainingWork gt Microsoft VSTS Scheduling RemainingWork lt RemainingWork gt lt CompletedWork gt Microsoft VSTS Scheduling CompletedWork lt CompletedWork gt 12 Optional sderau in Waw gt HiboreUNme nouns HibonrcUnm lt Automation gt The configuration file contains sections for each automation Every automation configuration has the following parameters e ID A unique ID used to identify the automation e DisplayName The name of the automation shown on the management website e Name The fully qualified class name of the configuration object tha
2. Global List Editors group are not evaluated A Global List Editors group must not exist it is optional The group must be created via TFS web access The Global List Editors group of a team project collection only gives the permission to edit team projects which are not assigned to any team project Automated Servicing and Administration Platform TFS ASAP User Guide Page 44 of 48 ye TFSASAP Figure 24 shows how the User LessPriviliges gains editing permission for the global list of TFS ASAP on the team project Fabrikam Fiber Screenshot taken from the security page of TFS web access Control Panel FabrikamFiberCollection gt FabrikamFiber overview iterations security services se ad FabrikamFiber gt Global List Editors Edit Create TFS group permissions members member of EN Add oe Search 4 TFS Groups Build Administrators LessPriviliges VSALMILessPriviliges Contributors Global List Editors Froject Administrators Figure 24 Editing Permission global lists 6 4 Configuration If it should be permitted to create and or delete global lists in TFS ASAP The system provides a configuration via two keys SelfService GlobalList DenyDeleting for denying deleting global lists and Se fService GlobalList DenyCreating for denying creating global lists These keys resides inside C Program Files AIT TFS ASAP Management web config and in
3. gt lt WorkItemTypeFilters gt lt ExternalLinkFilters FilterType excludeAll gt lt hank lumrns lt LinkColumn RefName System ID gt lt LinkColumn RefName System WorkItemType gt lt LinkColumn RefName System Title gt lt LinkColumn RefName System AssignedTo gt lt LinkColumn RefName System State gt lt LinkColumn LinkAttribute System Links Comment gt lt 7 hamk 6 Lumns gt himks omerolOoktons gt lt Control gt lt rele 7 Upload all of your changes to the team projects you want Suspect Links to be enabled for For more information see hitp msdn microsoft com en us library vstudio ms243782 aspx 4 3 12 Destroy Work Item Automation The destroy work item automation is used to tidy up your project There are several situations where work items were created which are no longer needed This automation will help you to delete this kind of work item Based on a user defined work item query the artifacts to delete will be selected and deleted afterwards Configuration is as follows lt Automation ID D805F0BO F633 4816 8D7E 4A62F554CA0B DisplayName Destroy Work Items name AIT ASAP Automation ScheduledAutomations Common Configuration DestroyWorkItemsAutomation Configuration AIT ASAP Automation ScheduledAutomations Common gt Schedule StartDate 10 1 2011 RecurringFrequency 86400 gt lt Query gt Select System ID FROM WorkItems where System TeamProject project and
4. 4 3 4 Current Work Automation This automation allows time tracking for persons who work with a work item It automatically adds the current work to the completed work field Therefore the completed work field should be disabled and can only be changed through the automation or influenced through the current work field With further adjustments and as soon as the user has entered a value in the current work field another field for choosing the date appears The user can now enter the date he d like to use to track the current work To actually see who was working when on this item an overview can be given by a time sheet report Automated Servicing and Administration Platform TFS ASAP User Guide Page 21 of 48 ye TFSASAP DETAILS Current Work 3 Work Date 12 03 2013 Remaining Work d Completed Work pe Backlog Priority Kone Lr W Li a EE 35 EN l2 3 Current Work OoOo Activity 4 5 6 7 8931 Remaining Work 9 Area EE LEMAINIAG VED 18 19 MN 2 23 MM ae 2 25 26 27 28 5 30 21 Completed Work 11 HISTORY LIM j Be ee Backlog Priority Activity VOE VOUT CO Mini IL TIK kr Figure 7 Only Current Work and Remaining Work can be edited Work Date only shows when Current Work entered Iteration all to Filter Area all Mo Filter j of 1 4 dan E Qa A 100 Find Next WorkOverview Helps you track booked work per person and work item Indicates recently booked work 013 Repor
5. ATTACHMENTS ASSOCIATED AUTOMATION Id Outcome Test Plan Test Suite Test Suite State 100000 NotApplicable Plan 3 Suite 1 1 Query suite InProgress 100000 Failed Plan 1 Suite 1 3 Sub Suite 1 3 1 InProgress 100000 Passed Plan 1 Suite 1 1 Query suite InProgress 100000 Passed Plan 2 Suite 1 1 Query suite InProgress 2013 AIT GmbH amp Co KG Figure 19 Sample test case form In order to use the view within the test case work item you have to adapt the work item type defintion of the test case work item type as follows lt WORKITEMTYPE name Test Case gt Per lt FORM gt lt Layout gt ea lt TabGroup gt less Tab Label Latest Results gt lt Control Type WebpageControl LabelPosition Top gt lt WebpageControlOptions AllowScript true ReloadOnParamChange true gt lt Link UrlRoot http lt TFS gt 8080 wie UrlPath lt ColLectionName gt TestResults LatestTestResults gt lt Param Index 0 Value System Id Type Current gt lt Link gt lt WebpageControlOptions gt lt Control gt lt Tab gt Automated Servicing and Administration Platform TFS ASAP User Guide Page 37 of 48 ye TFSASAP Please replace lt TFS gt and lt CollectionName gt with the values that fit your TFS instance and team project collection 5 2 2 Work Item Extensions Hierarchy Links can be displayed as a list within the work item form However only one level can be displayed resp two levels on
6. Application Source TFS ASAP Number of events 9 484 Application Date and Time da amp Security Waring 10 04 2015 08 15 14 TFS ASAP E Setup error 10 04 2015 08 15 14 TFS ASAP l System 10 04 2015 08 15 08 TFS ASAP A Forwarded Events 10 04 2015 08 15 08 p I Applications and Services Lo 09 04 2015 21 31 45 IS Subscriptions 09 04 2015 21 31 45 09 04 2015 21 31 28 09 04 2015 21 31 28 09 04 2015 21 17 14 09 04 2015 21 17 14 09 04 2015 21 16 58 C Critical C Waming C Verbose C Eror 0 information Eventlogs ppicton Eventsources fs OOOO Inchudes Excludes Event IDs Enter ID numbers and or ID ranges separated by commas To exclude criteria type a minus sign first For example 1 3 5 99 76 lt All Event IDs gt Task catego seee rt FITTE EE T Attach Task To This Event Ga Copy d bed Save Selected Events can install or repair the component on the A description for Event ID 1000 from source TFS ASAP cannot be found Ether the q local computer if the event originated on another computer the display information had to be saved 0 2015 08 15 14 20 Waming An error occured while processing change ASAPD as failed mascane recnuere ic nrecent het the maccane ic not frund in the ctrinn maccane tahle Log Name Application Source TFS ASAP Logged 10 04 2015 OR 1514 Event ID 1000 Task Category None Keywords Classic
7. System State Closed lt Query gt lt Automation gt Where elements have the following meaning Xml Element Query A work item query language WIQL statement that is used to query work item data from the work item store The set of work items returned will be deleted Please note that all work items covered by the provided work item query will be deleted from your TFS server Therefore you should configure the query with care because once the work items are deleted they cannot be recovered The operation is irreversible Automated Servicing and Administration Platform TFS ASAP User Guide Page 34 of 48 ye TFSASAP 4 3 13 Custom Automations Enterprise edition customers can implement their own automations TFS ASAP provide a C interface for custom automations that can leverage the complete mechanism of TFS ASAP including the job model that allows for load balancing as well as inheritance of existing base automations Make sure to build against the binaries currently installed by TFS ASAP Standard edition users will not be able to load custom plugins Only automations signed by AIT will be loaded However there are two options 1 Buy an Enterprise license www itsasap com order html or 2 Send your automation idea or implementation to AIT we provide an individual offer of integrating that in future versions of TFS ASAP www ifsasap com contact html 5 Using TFS ASAP Extensions Automated Servicing and
8. Administration Platform TFS ASAP User Guide Page 35 of 48 ye TFSASAP 5 1 Available Extensions This automation needs customization in the process template The default process templates provided with TFS aren t working with this automation This automation needs additional configuration in order to work correctly Otherwise you might get errors Extension Name Deseription Hense Custom Config Detalls Work Item Extensions Latest Test Results Work Item Extensions Hierarchy Work Item Extensions Query Work Item Extensions TimeSheet Automated Servicing and Administration Platform Provides a web page view of the latest test results of a particular test case work item in all test plans suites URL http lt TFS gt 8080 wie lt CoLLectionName gt TestResults LatestTestResults lt TestCa seId gt This web page can be integrated into work items using the web page control See details section for further information Provides a web page view of the complete hierarchy of the work item all parent and child items as well as siblings optional URL http lt TFS gt 8080 wie lt ColLectionName gt workItems Hierarchy lt WorkItemId gt optional parameter includesiblings true This web page can be integrated into work items using the web page control See details section for further information Provides a web page view of a list of work items based on a configured query e g all bugs created
9. Aggregation 4 FabrikamFiberCollection Completed Work Aggregation FabrikamFiber Original Estimate Aggregation 4 TailspinToysCollection ages Work Item State Aggregation Tailspin Toys Current Work Automation Suspect Links Scheduled Automations Consistency Check Daily Status Mail 2 Collections 2 Projects Figure 1 TFS ASAP s management website Automated Servicing and Administration Platform TFS ASAP User Guide Page 4 of 48 ye TFSASAP 2 2 Edition Comparison TFS ASAP is provided in different editions You can see the included functionality of each edition in the comparison chart below One License per App Tier 1 XX Unlimited App Tiers pp MX Future Updatesincluded 1 X X X Rule Numeric Aggregation J X lt X gt i mr Ss ini i Ss i Ws Rule Consistency check Rule Classification Copy her Rule Numeric Calculation Rule Advanced Numeric Calculation Eg i DM Mias i i Le Create your own plugins pp Rule Suspect Links 2 3 General Overview The purpose of the TFS ASAP is to provide a stable platform that can be used to implement all kinds of automations running on TFS app tiers Parts of TFS ASAP are implemented as an extension for the official TFS Server extensions API Therefore this plugin is deployed directly into the TFS server process The plugin is responsible for creating a registration for all event types for which the platform shall execute
10. Instead of URL postfix tfs use asap in order to open the management website manually Ce http localhost 3080 f AT http localhost2080 a5ap 3 If your TFS ASAP installation was successful and the TFS Service is running you should see the management web site of TFS ASAP Automated Servicing and Administration Platform TFS ASAP User Guide Page 8 of 48 Ar TFSASAP 2 7 License Activation To use your installation of TFS ASAP you have to activate your license Otherwise none of your automations are working 1 To activate your license use the main menu Licensing link rer I ASA P Licensing Automated Servicing amp E EEEE Administration Platform 2 Click Activate License ae j P Y Activate License License Agreements Om aten yaf vic n a If you do not see the Activate License button you may not have the right permissions You must be a member of the Team Foundation Administrators role in order to be able to activate the license 3 Follow the given instructions to activate your license a Accept License Agreements b Enter Paste your license e The license will be validated automatically e If your license Is valid the license activation button will be enabled e If your license Is invalid an error message will be shown c Click Activate License Activate License Activate License Please enter license Key ere mmm 3 han CEEOL EE EY lt xml 1 0 di tf 8 g
11. aggregation see the following possible values for the configuration Xml Element SourceField The reference name for the source field of a work item DestinationField The reference name for the destination field of a work item LinkType The link type between work items for which this automation is meant work item Name of the link at the source work item This name appears when you add links to the source work item ReverseName Name of the link at the target work item This ened name appears when a listing of the links at the target work item appears ReverseName ChildStates Defines for which source states and when to process the automation Defines the All All work items in one state scope for Any which the state Any of the work items is in that state are checked State The states on which the automation should be processed The state changes which should be made to the destination Field OnRuleEnter Defines the state the parent should be changed to if the child conditions are true Workltem Type uses reference names of work items and filters the work items for which the state change is valid is a wildcard and means all types of work item references OnRuleLeave Defines the state the parent should be changed to if the child conditions are not true Workltem Type uses reference names of work items and filters the work items for which the state change is valid is a wildcard and means all types of work item references
12. an JL Work Item Type Title Assigned State Remaining Work a Requirement Reg Julia Iyiana Proposeg a1 Task aski Julia Iyiana Active E g3 Task T2 5ubOfTi Julia Ilyiana Closed 3 Tl SubOfTL Juliathviana gt 4 3 1 2 Completed Work Aggregation This automation aggregates the field Completed Work Aggregation It works similar to the Remaining Work Aggregation Automation 4 3 1 3 Original Estimate Aggregation This automation aggregates the field Original Estimate It works similar to the Remaining Work Aggregation Automation 4 3 2 Boolean Aggregation Boolean Aggregation means that values of linked work items which contain Boolean values Yes No or True False can be aggregated For Boolean aggregations the available aggregations are AND and OR Configuration for boolean aggregations is as follows lt Automation ID DDFCFE4C 3834 4AA9 B271 D090AB57B175 DisplayName Blocked Aggregation name AIT ASAP Automation TriggeredAutomations WorkItemAutomations Common Configuration Boolea nAggregationAutomationConfiguration AIT ASAP Automation TriggeredAutomations WorkItemAutomations Common gt lt SoureerveldMaeros kn Vols 6MMi Bilocked 7Sourcer te ld Dest mnac Lone tole Miierocore Vole CMMI Blocked lt Destrmar tone lela lt LinkType ReferenceName System LinkTypes Hierarchy ForwardName Child ReverseName Parent gt lt AggregateValuesTo gt Parent lt AggregateValuesTo gt lt Defaul
13. have to be processed Therefore the full consistency check will not be executed automatically Furthermore the full consistency check is triggered per automation and not for all automations per se The full consistency check can be triggered using the management website using the Run Now button Once the run now button is pressed a new dialog will appear In this dialog you can select for which automations a full consistency check shall be executed Automated Servicing and Administration Platform TFS ASAP User Guide Page 25 of 48 ye TFSASAP Far WD Scheduled Automations Consistency Check x Daily Status Mail x Figure 13 Run Now Button 4 3 7 Classification Copy This automation copies the value of a specified Area Path level to a custom field within the same work item This way custom work item rules can be configured based on the selected Area Path which is not possible out of the box in TFS For instance you could have the AssignedTo field set to a default value based on the Area Path selected The automation will copy the first level Area Path value into a custom field Custom Subproject Custom work item rules are configured for the AssignedTo field lt Automation ID 4CFEBE51 441C 4715 AF9 9B83B12117DC DisplayName Classification Automation name AIT ASAP Automation TriggeredAutomations WorkItemAutomations Extended Configurations ClassificationAutomationConfiguration AIT ASAP Automation Tr
14. lt SourceField gt Microsoft VSTS Scheduling OriginalEstimate lt SourceField gt lt DestinationField gt Microsoft VSTS Scheduling OriginalEstimate lt DestinationField gt lt LinkType ReferenceName System LinkTypes Hierarchy ForwardName Child ReverseName Pare ne lt AggregateValuesTo gt Parent lt AggregateValuesTo gt lt DefaultValue gt 0 lt DefaultValue gt lt Operation gt Add lt Operation gt lt Autona tLon gt With the following Xml elements Xml Element SourceField The reference name for the source field of the source work item DestinationField The reference name for the destination field of the destination work item LinkType The link type to follow for aggregation AggregateValuesTo The link direction name to aggregate values to DefaultValue The default value in case the aggregated numeric value is nota number or null The operation for aggregation Add or Mul 4 3 1 1 Remaining Work Aggregation This automation aggregates the content of the field Remaining Work of a work item The aggregation process keeps on going up the tree from leafs till the root an JL Work Item Type Title Assigned State Remaining Work S Requirement Reg Julia Iyiana Proposed gl Task Taskl Julia Thyiana Active 30 g3 Task T2 5ubOfTi Juliathviana Closed 30 Fl T1 SubOT1 Julia Dyiana 100 Automated Servicing and Administration Platform TFS ASAP User Guide Page 18 of 48 ye TFSASAP
15. member in a process template If you already have a special group for e g Manager These group can be assigned here So only at one time you need to care about this matter You can perform the workflow for other team project Each of these team projects now have their own predefined global lists which the can change to their needs In this scenario the items of the global lists Meeting Type FabrikamFiber and Replication System FabrikamFiber So the manager of the FabrikamFiber team project can add its wished item telephone conference without asking a team project collection administrator Automated Servicing and Administration Platform TFS ASAP User Guide Page 47 of 48 yA TFSASAP TFS ASAP is provided by AIT Applied Information Technologies GmbH amp Co KG Postal address A Leitzstr 45 70469 Stuttgart Amtsgericht Stuttgart HRA 725452 General Partner AIT Verwaltungs GmbH Amtsgericht Stuttgart HRB 734136 CEO Lars Roith IBAN DE80 61191310 0664310001 SWIFT GENODES1VBP Phone 49 711 49066 430 Fax 49 711 49066 440 Email support tfsasap com Internet www aitgmbh de 2015 AIT GmbH amp Co KG This document is protected by German copyright laws and may only be reproduces modified or extended with the written consent of the authors All Rights reserved Automated Servicing and Administration Platform TFS ASAP User Guide Page 48 of 48
16. name AIT ASAP Automation TriggeredAutomations WorkItemAuto mations Extended Configurations AdvancedNumericCalculationAutomationConfiguration AIT ASAP Automation TriggeredAutomations WorkItemAutomations Extended gt lt DestinationField MaxValue 3000 gt Custom IssueRank lt DestinationField gt lt SourceFields Operation Mul gt lt SourceField ThresholdOperator GreaterEqual Threshold 10 gt Custom IssueSeverity lt SourceField gt lt SourceField Severity 2 0 gt Custom IssueFrequency lt SourceField gt lt SourceField gt Custom IssueRelevance lt SourceField gt lt SourceFields gt lt Automation gt Xml Element Description Destination The destination field for the result of the calculaiton Field MaxValue Specifies the maximum value which is applied to optional the field when a Treshold of a source field has been reached SourceFields This Element contains the sourcefields which and specefices the operation Operation Specifies the operator Possible values are Add Addition e Mul Multiplication e Sub Subtraction Automated Servicing and Administration Platform TFS ASAP User Guide Page 30 of 48 ye TFSASAP SourceField A single source field used for the operation ThresholdOperator Specifies the comparison operator for the value optional of the source field and the trheshold Possible values are e Equal Greater GreaterEqual Smaller Smal
17. to subtract the current work value from add the current work value to id the history comment that is created for each change In order to enable this automation several process template customizations have to be done 1 Download the work item type definitions and report definitions for Current Work 2 Upload all of your changes to the team projects you want Current Work to be enabled for For more information see http msdn microsoft com en us library vstudio ms243782 aspx 4 3 5 Remaining Work Automation The project task board is one of the most important tools during an iteration to discuss the current state and the upcoming tasks It is often used to directly reduce Remaining Work values i e during the daily standup meeting If the team uses a process template that also tracks Completed Work e g to find deviations between the original estimation and actual work each team member has to set Completed Work on task level as well For instance if Remaining Work was 10h and Completed Work was 4h and user reduces Remaining Work by 7h to 3h the other field values remain the same see Figure 9 and Figure 10 AlT Demos MSF CMMI v2013 3 2 Team Iteration 0 posseenesseg Backlog Board Capacity PROPOSED 13 h ACTIVE 13h RESOLVED 4 Requirement 1 11h Task 2 6 Thomas R mmler Thomas R 4 Requirement 2 Task 5 15h Task 4 as R mmler 5 Thomas R mmler 7 Thomas R mmler Figure 9 Changing
18. to relevant Contents lt HELPTEXT lt ALLOWEDVALUES gt lt LISTITEM valpe vves n gt lt ALLOWEDVALUES gt 2 LDS lt FIELD name Suspected refname Custom Suspected type String gt lt HELPTEXT gt Determines whether the work item is still suspected Set back to empty after you have checked and adopted the changes lt HELPTEXT gt lt ALLOWEDVALUES gt lt LISTITEM value Yes gt lt ALLOWEDVALUES gt lt FIELD gt 5 Add the following form changes to the affected work item type definitions Group lt Columm PercentnidehN gt 50 gt lt Control Type FieldControl FieldName Custom AutoSuspect Label Auto Suspect LabelPosition Left gt lt Column gt lt Columm PercentWwidrn 50 gt lt Control Type FieldControl FieldName Custom Suspected Label Suspected LabelPosition Left gt lt Column gt lt Group gt 6 Optionally add the following form changes to the tabgroup of the affected work item type definition lt Tab Label Suspects gt Automated Servicing and Administration Platform TFS ASAP User Guide Page 33 of 48 ye TFSASAP lt Control Type LinksControl Name Suspects Label Suspected LabelPosition Top gt lt Limnksteonrrologperions lt WorkItemLinkFilters FilterType include gt lt Filter LinkType Custom Suspects gt lt WorkItemLinkFilters gt lt WorkItemTypeFilters FilterType include gt lt Filter WorkItemType Requirement
19. S gt lt HELPTEXT gt The type of the review meeting lt HELPTEXT gt lt FIELD gt Table 2 Global lists in the Master Process Template lt FIELD name Meeting Type refname Microsoft VSTS CMMI MeetingType type Strin g gt lt ALLOWEDVALUES gt lt GLOBALLIST name Meeting Type TeamProjectName gt lt ALLOWEDVALUES gt lt HELPTEXT gt The type of the review meeting lt HELPTEXT gt lt FIELD gt Table 3 Global lists in the modified process template After preparing our MPT we can create team projects from it Let s say we want to create a team project with the name FabrikamFiber The specific workflow can be the following 1 Get the Master Process Template a Replaces all occurrences of TeamProjectName with FabrikamFiber 2 Get the global list from TFS Automated Servicing and Administration Platform TFS ASAP User Guide Page 46 of 48 ye TFSASAP a Extracts the global lists matching your pattern 3 Replace the pattern with the specific name of the global lists 4 Create the global lists with a TFS ASAP b Viaa script 5 Upload the modified Master Process Template with a meaningful name 6 Create a team project with this modified process template lf you now assigned users the Global List Editors group inside the team project FabikamFiber they can edit the global list with the TFS ASAP without being collection administrators Hint You can also create groups and assign
20. TFS ASAP User Guide 29 04 2015 Ea ye TFSASAP Table of Contents jE 100 EEE 4 2 Getting started With TFS ASAP wi scccasccssccunssesdaseeciiasaessasGanpesdiscapesesenssccassapeseseassecicsanoaued 4 2 AR 120100 10 g ME EE e E 4 22 ENTEN 5 2 3 General Overview rrrnrrnrarnrrnnnrnrannnrnnnrnnnnrnnnnsnnnnnennansennnnennansnnnnnennnsennnssennnnennassennnee 5 LA NAN caus R 6 2 4 1 Technical Requirements rrrnnrnnnrnnnrnnnrnnnrnnnrnnnrnnnrnnnrnnnennnennnennnennnrnnnennnennnennne 6 2 4 2 Administrative Requirements cccccccscccseccsceceeeceeeceeeceeeceeeceeesseeceeeceeeneeenes 6 24 3 ANSE AIGM aS 7 Ze TES MIO CNG EEE 8 2 EG eal 00215 gt EEE ee ee eee eee eee 8 2 HECA IVAU NN NN 9 FOSEN TFSASAP ssccctacepssctesapcastosasecesdcapecniseagesendsaceca ceapeceneranespiceanesanteapeeaeceusecs 10 3 1 Central ASAP Control Page Home rrrnrrnnnnnnnnnnennannnnnnnennnnenvnnnennnnennanennnnnennnnennnn 10 32 Enable Disable AUTOMAUNONS 4 een 10 3 3 Manually Triggering Scheduled Automations rrrrnnrrnnnnvnnnnrrrnnrennnrrnnnrrennnrennnnennnn 11 3 4 Activation of Tracing and Logging cccccceecceeeceeeeeeeceeeeeeeseeeseeeseeeseeeseeeneeeneeenes 11 4 Using TFS ASAP Automations rrrarrnnnrenanrrrnnevnnrnnnnennnnennnnnrnnrnnnnennnrnnnnennarennennnsennsene 13 6 CO A E E ee E E EEN 13 4 1 1 Connguration OC ANON EE 13 4 1 2 Automation Trigger TYPe S cccccccceeccsecceeeseeeseeeeeeeeeeeseeeeeesee
21. and Administration Platform TFS ASAP User Guide Page 40 of 48 Ar TFSASAP Automation this would be Custom CurrentWork If you don t use this automation it could be Microsoft VSTS Scheduling Completedwork instead dateField The reference name of the field which contains the date information for which the tracked effort applies In case of the Current Work AutomationCurrent Work Automation this would be Custom CurrentWorkDate If you don t use this automation it could be System ChangedDate instead The textual representation of the unit used E g h for hours or d for days This is only a label in the results table and not used for any calculations Automated Servicing and Administration Platform TFS ASAP User Guide Page 41 of 48 ye TFSASAP 6 Using TFS ASAP global lists In TFS management of global lists is only possible on collection level The user has to be a member of the collection level administrators to add change and remove global lists Global lists are visible to the whole collection A limitation to a specific team project is not possible out of the box With TFS ASAP it is possible to assign global lists to team projects and to edit them the user must not have edit project collection information rights 6 1 Assigning a global list The algorithm of assigning a global list to either a team project or team project collection works as following It searches for the last occurring of Unico
22. at the same day URL http lt TFS gt 8080 wie lt Col LectionName gt workItems Query lt WorkItemId gt Title lt T itle gt amp Query lt wiql query gt This web page can be integrated into work items using the web page control See details section for further information Provides a web page view of all time bookings for a specific work item per date and user URL http lt TFS gt 8080 wie lt Col LectionName gt WorkItems TimeSheet lt WorkItemId gt This web page can be integrated into work items using the web page control See details section for further information TFS ASAP User Guide Page 36 of 48 Standard or Enterprise Basic Standard or Enterprise Basic Standard or Enterprise Basic Standard or Enterprise ye TFSASAP 5 2 Out Of The Box Extensions 5 2 1 Work Item Extensions Latest Test Results Usually test cases do not provide a direct view on their test results Test cases can be used in multiple test plans and suites and hence test results might be different This ASAP extension provides an easy to integrate view on all latest results of all appearances of a particular test case in any test plan within the collection Test Case 5 A test case on 5 0 IA test case Iteration Default STATUS DETAILS Assigned To Administrator Automation status Not Automated State Design Area Default Priority 2 E STEPS SUMMARY TESTED BACKLOG ITEMS 7 LATEST RESULTS LINES 1
23. automations In order to execute the actual automations asynchronously the plugin is also responsible for the persistence of the change events and the dispatching of the change events to the TFS Job Agent The TFS web services which are hosted by the IIS are only supposed to execute direct user interactions In order to execute recurring or long running jobs asynchronously TFS offers the TFS Job Agent TFS ASAP extends the TFS Job Agent to execute the actual automations asynchronously The job agent extension is responsible to load the stored change events from the database and finally dispatch all the events to the corresponding automation objects Automated Servicing and Administration Platform TFS ASAP User Guide Page 5 of 48 ye TFSASAP During the initialization phase the TFS ASAP will create a new Database on the TFS Data Tier This database is used to temporarily store all received notification events so that the job agent extension can pick up the change events asynchronously This enables consistent job execution even in cases of server reboots or other interruptions of TFS services TFS App Tier 1 TFS App Tier 2 IIS Program Dir ASAP TFS Services Automations LY Triggers ASAP Plugin 5 Delegate OCESS TFS Job Agent TFS Job 3 AddJob Queue Windows Service 2 Access configuration TFS Data Tier ASAP DB Load balancing the TFS jobs is part of TFS features App tier selection is no
24. aving After editing or creating global lists these changes has to be committed to TFS ASP A click on the Save menu item on top of the page performs this action Deleting It is also possible to delete a global list Therefore you have to click on the Trash button inside the top right corner of the global list This action is immediate it is not possible to get the global list back However a confirmation is shown before effectively deleting the global list 6 3 Rights Because TFS ASAP introduces an additional team project layer in the global lists You can restrict the access to them via rights These rights are View and Edit The permission concept of TFS is not overridden So if a user has got the proper permissions the user can still access the information via the TFS API Viewing In opposite of TFS the user needs only Generic Read Permission View project level information for the corresponding level to view the global lists A user needs explicit view right to see the global lists of the team project and the node of the tree This means if the user has got edit rights but not the view rights The user will not see the team project and its global lists Editin fa a wants to edit or create a global list the identity must either have Generic Write Permission Edit project level information or must be inside the Global List Editors in the team project collection or in the team project The permissions inside the
25. de U 0020 U 002D in the name of the global list If the text after this position matches the name of a team project the global list is assigned to this matched team project Otherwise it is assigned to the team project collection So if a team project was deleted but its global lists not the global list are assigned to the team project collection 6 2 Exploring After clicking on the Global Lists menu item you can explore the global lists in the tree on the left gt Gaal A Automations Global Lists Licensing Automated Servicing amp S88 EE Administration Platform Global lists which do not belong to any team project are displayed in the not assigned node in the tree as you can see in Figure 23 Global Lists Tree Automated Servicing and Administration Platform TFS ASAP User Guide Page 42 of 48 ye TFSASAP PA TFSASAP y TFS Global Lists Configure Global Lists for all TFS team projects 4 FabrikamFiberCollection Special Project FabrikamFiber 4 TailspinToysCollection Tailspin Toys 2 Collections 6 Projects Figure 23 Global Lists Tree There are five actions you can perform in TFS ASAP Reloading the current creating a global list view saving deleting and editing global lists These actions are described in the next sub chapters 7X I oe a Reload Viewing If you want to view global lists of a specific team project or team project collection without navigating in the tree Just e
26. e WebpageControl LabelPosition Top gt lt WebpageControlOptions AllowScript true ReloadOnParamChange true gt lt Link UrlRoot http lt TFS gt 8080 UrlPath wie lt CollectionName gt WorkItems Query Title SameArea amp amp Que ry select system id system title from workitems where system areapath under system areapat 1 gt lt Param Index Value System Id Type Current gt lt Param Index 1 Value System areapath Type Current gt lt Link gt lt WebpageControlOptions gt lt Control gt lt Tab gt Foxe Please replace lt TFS gt and lt CollectionName gt with the values that fit your TFS instance and team project collection Additionally you have to substitute the lt Title gt and lt WQIL gt accordingly The provided WIQL query will be executed against TFS The fields defined in the select clause will be shown in the result set Additionally you can use the custom macro Automated Servicing and Administration Platform TFS ASAP User Guide Page 39 of 48 ye TFSASAP DisplayNameW ithoutWhiteSpaces for any field to match with the selected work item field values e g AreaPath will match the System AreaPath 5 2 4 Work Item Extensions Timesheet As users track their work in work items an overview is necessary for any bookings that happened in a work item The Current Work Automation helps users to book efforts for specific dates past present future The timeshee
27. e Aggregation Tracks the work and automatically assign it to a date Current Work Remaining Work Increases completed work when remaining work is decreased Automated Servicing and Administration Platform WI Changed ma TFS ASAP User Guide Page 15 of 48 Completed Work Aggregation Work item P1 has two children C1 and C2 C1 has 20h in field completed work C2 has 10h in field completed work P1 is automatically set to 30h Blocked Aggregation sets the Blocked field of parent work item to Yes in case at least one child is set to Yes N N Work Item State Aggregation 4 3 3 Work item P1 has to children C1 and C2 All items are in state active C1 and C2 are set to the state Closed P1 is automatically set to the state Resolved Current Work Automation Track efforts with Current Work and Work Date for a distinct date not only for current date Remaining Work Automation Task item P1 has Remaining Work set to 10h and Completed Work set to 4h Remaining Work is reduced by 7h to 3h Completed Work is automatically set to 11h 4 3 5 Classification Copies a specified Copy Area Path level to a custom field in order to work with rules based on Area Path Scheduled Email Sends a query result Query Report list via mail on a daily basis Numeric Executes numerical Calculation calculations for values from different fields Into one field within the same work Item S
28. e level in each link direction Especially for hierarchy link types a view on the full hierarchy is particularly useful The hierarchy work item extension provides a web page which displays the complete hierarchy within which a particular work item is contained Product Backlog Item 17 Another separate PBI ae en Kling POP J DESCRIPTION STORYBOARDS TEST CASES TASES ACCEPTANCE CRITERIA HISTORY HIERARCHY LINKS 3 ATTACHM Feature 15 Another tree Product Backlog Item 16 Product Backlog Item 17 Another separate PBI Product Backlog Item 18 A sub story Product Backlog Item 19 A second story Task 20 A task 2013 AIT GmbH amp Co KG Figure 20 Sample work item form In order to use the view within a work item you have to adapt the work item type defintion as follows lt WORKITEMTYPE name gt ere lt FORM gt lt Layout gt re lt TabGroup gt ESA lt Tab Label Hierarchy gt lt Control Type WebpageControl LabelPosition Top gt lt WebpageControlOptions AllowScript true ReloadOnParamChange true gt lt Link UrlRoot http lt TFS gt 8080 wie UrlPath lt ColLectionName gt WorkItems Hierarchy includeSiblings false gt lt Param Index Value System Id Type Current gt lt Link gt lt WebpageControlOptions gt lt Control gt lt Tab gt Please replace lt TFS gt and lt CollectionName gt with the values that fit your TFS instance and team project collect
29. e work item on which this automation can be used RemainingWork The reference name for the Remaining Work field of a work item CompletedWork The reference name for the Completed Work field of a work item used to add the difference between old and new Remaining work value to 4 3 6 Consistency Check The Consistency Check is used to ensure that all the information which is applied by an automation is in a consistent state There are two modes Incremental Consistency Checks based on a schedule Full consistency checks that can be triggered manually via management website 4 3 6 1 Incremental Consistency Check The Consistency Check handles all failed events or events which haven t been processed due to service interruptions validation errors or alike Those failed events are still kept within TFS ASAP database Based on a schedule the incremental consistency check will pick up the failed automations and issues a re execution Typically the incremental consistency check gets executed once per day The schedule itself can be configured if a higher or lower frequency is desired 4 3 6 2 Full Consistency Check The full consistency check is used to ensure that the information is in a consistent state without being dependent on events Typically the full consistency check is used to provide an initial population of aggregated values for instance The execution of a full consistency check is a length operation because many artifacts may
30. eeeeseeeeseeeeeeeeseeeesaeeseueesaeesseeeseeeseeessneesaes 36 52 MOTER Extensions re 37 5 2 1 Work Item Extensions Latest Test Results rrrrnrrnnrrennrrnnnrrnnvrrnnrrrnnrennvnn 37 5 2 2 Work Item Extensions Hierarchy rrnrennnennnennnrvnnevnnnnnnrnnnnnnnrnnnennnennnennnennnen 38 5 2 38 Work Item Extensions Query rrrrrrrnrrnnnnrnrrnnnnronrnnnnnnnrnnnnnennrnnnnsnnrnnnnsnnnnnsnee 39 9 2 4 Work Item Extensions Timesheet rrrnnrennnnnnnnannvnnnevennnnnnanennnnnennanennnnnenn 40 6 Using TFS ASAP global lists vr 42 O AS N 600189 EE E 42 O2 ENON eee EEE SN 42 Oo AON EE 44 oA CONIO EEE 45 6 5 Working with Process Templates ccccccceccceeeceeeeeeeseeeseeeseeeseeeseeeseeeseeeseeesaeess 46 Automated Servicing and Administration Platform TFS ASAP User Guide Page 3 of 48 ye TFSASAP 1 Overview TFS ASAP is a reliable platform for advanced administration and extensions of Microsoft s Team Foundation Server It serves as a central management location for server side event based and scheduled automations such as aggregations as well as administrative extensions such as self service team project creation and configuration web pages TFS ASAP is a proven product that will be continuously adapted for future updates and releases of TFS Please contact us for more information about the subscription and maintenance options You will find contact details at the end of the document This documentatio
31. ent Req Julia lhyiana Proposed Task Taski Julia lhyiana Active T1 subOtT1 Julia Thyviana T2 subQtT1 Julia Iyiana Requirement Req Task Taski Task T1 subOtT1 Julia Thyviana Task T subQtT1 Julia Iyiana Closed Figure 6 Sample hierarchy with aggregated state value Resolved after all children have been set to Closed lt Automation ID 0FED142F FAA4 4DE2 9D96 E88BF397571F DisplayName Aggreate Work Item State CMMI name AIT ASAP Automation Trigger edAutomations WorkItemAutomations Extended Configurations StateAggregationAutomationConfigurat ion AIT ASAP Automation TriggeredAutomations WorkItemAutomations Extended gt lt SourceField gt System State lt SourceField gt lt DestinationField gt System State lt DestinationField gt lt LinkType ReferenceName System LinkTypes Hierarchy ForwardName Child ReverseName Pare nel gt lt AggregateValuesTo gt Parent lt AggregateValuesTo gt lt ChildStates Scope gt Aal1 lt State gt Closed lt State gt lt State gt Resolved lt State gt lt ChildStates gt NEPPE lt OnRuleEnter gt lt State WorkItemType gt Resolved lt State gt lt OnRuleEnter gt lt OnRuleLeave gt lt State WorkItemType gt Active lt State gt lt OnRuleLeave gt lt NewParentState gt Automation Automated Servicing and Administration Platform TFS ASAP User Guide Page 20 of 48 Aae TFSASAP To adjust the configuration or add another
32. equencey The recurring frequency in seconds lt Automation ID 824K6030 F57B 11E0 8E4D 8B204924019B DisplayName Daily Status Mail name AIT ASAP Automation ScheduledAutomations Common Configuration EmailAlertsAutomationConfiguration AIT ASAP Automation ScheduledAutomati ons Common gt lt Schedule StartDate 10 1 2011 RecurringFrequency 86400 gt lt MailMessage Subject COLLECTION SPROJECT S Daily Status Mails gt lt Query Header My Work Items gt Select System ID System WorkItemType System State stem Title FROM WorkItems where System TeamProject project and System AssignedTo order by System Stace System Workrcemtypoel NS vesten rd Query Sy me lt AUtOmatlon gt Automated Servicing and Administration Platform TFS ASAP User Guide Page 14 of 48 4 2 Available Automations ye TFSASAP This automation needs customization in the process template The default process templates provided with TFS aren t working with this automation I This automation needs additional configuration in order to work correctly Otherwise you might get errors Automation Name Automation Example Trigger Custom Config _ Samples _ Numeric Aggregation Aggregation of numeric field across hierarchies with operations Add Multiply Aggregation of Boolean values Yes No or True False with operations And Or Aggregation of states over related work items Boolean Aggregation Stat
33. ervicing and Administration Platform TFS ASAP User Guide Page 29 of 48 ye TFSASAP 4 3 10 Advanced Numeric Calculation Advanced Numeric Calculation is an extended version of Numeric Calculation For further information see the previous chapter This calculation provides the same functionality of calculation within a work item combined with the functionality of using a severity anda threshold for source fields E g assume that there are three fields within an issue work item to calculate an issue rank Severity Frequency Relevance and Issue Rank The Issue Rank represents the rank calculated by multiplying all the other fields The source field values are all within the range from 0 to 10 The maximum multiplication result would be 1000 10 3 Using a severity of 2 for the field Frequency raises the maximum results 10 10 2 10 to 2000 and weights this field doubled compared to the others For a certain frequency the issues might be ranked higher That is where the source field threshold can be used and the maximum value of the source field ISSUE RANKING Severity Frequency 2 Y Relevance 1 T Lal Lal La rt C on Figure 16 Example 1 Severity of Advanced Numeric Calculation ISSUE RANKING ssue Rank 3000 Figure 17 Example 2 Threshold of Advanced Numeric Calculation Configuration is as follows lt Automation ID E29D B4F 6B35 4D8B 85F7 66B922E1C232 DisplayName Issue Ranking
34. ery built in TraceListener can be used to write log information In this case we are using the Windows Event Viewer Open Windows Logs gt Application File Action View Help 9 2m al E Event Viewer Local Application Number of events 16 393 Actions D Custom Views Y Filtered Log Applicatiorc Source TFS ASAP Number of events 9 484 Application a 4 Windows Logs fe Application Level Date and Time Source Event ID Task Category amp Open Saved Log le Security Warn ng 10 04 2015 08 15 14 TFS ASAP 1000 None W Creste Custom View F Setup Or TFS ASAP 1000 None import a I om A Waming TFS ASAP 1000 None Forwarded Eveni Miro TFS ASAP 1000 None lear Log amp Applications and Se L Waming TFS ASAP 1000 None gt p V Fiter Current Log eecripto Biro TFS ASAP 1000 None lear Filter Waming TFS ASAP 1000 None T Properti i Bir TFS ASAP 1000 None w Find Waming TFS ASAP 1000 None Oro TFS ASAP 1000 None hed Save Filtered Log File As L Waming TFS ASAP 1000 None Attach a Task To this Log Dir TFS ASAP 1000 None T Save Filter to Custom View A Waming TES ASAP 1000 None L Waming TFS ASAP 1000 None Bin TFS ASAP 1000 None C Refresh A Warming TFS ASAP 1000 None E Hep A Waming TFS ASAP 1000 None Ber TFS ASAP 1000 None Event 1000 TFS ASAP A Waming TFS ASAP 1000 None T Event Properties krene TES ASAD 1000 Meme r gt Attach Task To This Event Event 1000 TFS ASAP x Copy m ld S
35. eseeeseeeteeeseeens 13 4 2 Available Automations cccccccceeccceecccececeuecceeeceucecsueesueecsueeceeeseueessuesseeessesenanes 15 49 OVER NNN 18 4 3 1 Numeric Aggregation rrnnnrnnnrnnnennnrnnnrnnnrnnnrnnnrnnnrnnnrnnnrnnnrnnnrnnnrnnnennnennnrnnnennn 18 4 3 2 Boolean Aggregation ccccccseccseecseecseeceeeseeceeceeeseeeseeeseeeseeeseeeseeeseeesaeess 19 EG gt 810 11010 2 1116 9 EEE NE 20 4 3 4 Current Work Automation rrranrrnnnrrvrnnrrnnnnrrrnnrnnnnnenrnnnennnnennnnrnnnnnennnenennnnen 21 4 3 5 Remaining Work Automation ranennnonnnennnrnnnevnnrnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnen 23 4936 Consistency Neck 44444444 25 4 3 7 Classification CODY eccsceccccscorascetesscncaxnsdancadonedeccantnassadoeudaceuntanededmeadaataneceseancs 26 438 Daly Status Mall EEE 26 4 3 9 Numeric Calculation cccccccccccseececeeeeeeeeeeseeeesseeeeseeesseeeeseeeesseeeeseeeetaeeeas 29 4 3 10 Advanced Numeric Calculation ccccccccccceececeseeeseeeeseeeesseeeeseeeeseeeesseeeees 30 AoT SUSPECT EE 31 Automated Servicing and Administration Platform TFS ASAP User Guide Page 2 of 48 ye TFSASAP 4 3 12 Destroy Work Item Automation rranennnrnnnrnnnevnnrvnnennnnnnnennnennnennnnnnnennnennnennnen 34 4318 GusomAuomalbhSu anantendtisnaieb meme inaina tira ieaiaia 35 5 Uomo TFSA AP ELEM O oor eters geen ane cerca sieasene S 35 5 1 Available Ext nSions cccccccsecccsececeeee
36. eve Selected Events General Details G Refresh The description for Event ID 1000 from source TFS ASAP cannot be found Either the component that raises this event is not installed on your local computer or the installation is corrupted You can install or repair the component on the A 7 Help local computer if the event originated on another computer the display information had to be saved with the event The following information was included with the event 04 10 2015 06 15 14 20 Warning An error occured while processing change ASAPDemoCollection Microsoft TeamFoundation Workitem Tracking Server WorkiterChangedEvent Marking event as failed the mastene reenisre it mrecent hit the mmeccams i not frend in the chine meccane tahle Log Name Apphcation Source TFS ASAP Logged 10 04 2015 08 15 14 Event ID 1000 Task Category None Level Warning Keywords Classic User N A Computer tfs2013 OpCod More information Event Log Online Helg Figure 4 Event Viewer Application View Then set the Filter to TFS ASAP You should see all Events on Warning and Error Level triggered by TFS ASAP Automated Servicing and Administration Platform TFS ASAP User Guide Page 11 of 48 Ar TFSASAP Automated Servicing amp o E E E Administration Platform File Action View Help e mir I Event Viewer Local Application b 3 Custom Views a 4 Ol Windows Logs Y Filtered Log
37. i aspx pcguid 61c145e9 f9f7 4da7 9cf7 5e412c64b08c amp id 12621 lt TeamWebAccessUri gt lt Fields gt lt Field gt lt DisplayName gt Assigned To lt DisplayName gt lt ReferenceName gt System AssignedTo lt ReferenceName gt lt Value gt Jon Doe lt Value gt lt Field gt lt Field gt lt DisplayName gt Title lt DisplayName gt lt ReferenceName gt System Title lt ReferenceName gt lt Value gt This is a title lt Value gt lt Field gt lt Fields gt lt WorkItem gt lt WorkItem gt lt WorkItemID gt 12622 lt WorkItemID gt lt TeamWebAccessUri gt http yourserver 8080 tfs web wi aspx pcguid 61c145e9 f9f7 4da7 9cf7 5e412c64b08c amp id 12622 lt TeamWebAccessUri gt lt Fields gt lt Field gt lt DisplayName gt Assigned To lt DisplayName gt lt ReferenceName gt System AssignedTo lt ReferenceName gt lt Value gt Jon Doe lt Value gt lt Field gt lt Field gt lt DisplayName gt Title lt DisplayName gt lt ReferenceName gt System Title lt ReferenceName gt lt vValue gt This is a second VENNE Automated Servicing and Administration Platform TFS ASAP User Guide Page 28 of 48 ye TFSASAP lt Field gt lt Fields gt lt WorkItem gt lt WorkItems gt lt QueryResult gt lt QueryResults gt lt Report gt 4 3 9 Numeric Calculation Numeric Calculation can be used in order to process numeric calculation on fields within the same work item Currently only the following n
38. ields before changing Remaining Work AlT Demos MSF CMMI v2013 3 2 Team Iteration 0 peccccccccog Backlog Board Capacity PROPOSED 13 h ACTIVE 11h RESOLVED 4 Requirement 1 s Task2 Task 1 9h pr 6 Thomas Riimmler 3 Thomas R mmler H iE i 4 Requirement 2 e l Task5 Task 3 Task 4 15h 7 Thomas R mmler 3 Thomas R mmler 5 Thomas R mmler Figure 12 Task Board and Effort fields after changing Remaining Work TFS ASAP and TFS ASAP Online is taking care of calculating Completed Work field in the happy day scenario Hence in most cases the developer only has to maintain Remaining Automated Servicing and Administration Platform TFS ASAP User Guide Page 24 of 48 ye TFSASAP Work without any further manual effort This reduces manual work and avoids mistakes and inconsistencies Configuration lt Automation ID 1B93867D C01C 447B 9646 EF3DQ 3E5A2C5 DisplayName Remaining Work Automation CMMI and Agile name AIT ASAP Automation TriggeredAutomations WorkItemAutomations Common Configuration RemainingWorkA utomationConfiguration AIT ASAP Automation TriggeredAutomations WorkItemAutomations Common gt lt WorkItemType gt Task lt WorkItemType gt lt RemainingWork gt Microsoft VSTS Scheduling RemainingWork lt RemainingWork gt lt CompletedWork gt Microsoft VSTS Scheduling CompletedWork lt CompletedWork gt lt Automation gt The configuration elements are described below Xml Element WorkltemType The type of th
39. iggeredAutomations WorkItemAutomations Extended gt lt ClassificationField gt System AreaPath lt ClassificationField gt lt ClassificationMappings gt lt ClassificationMapping Index 2 DestinationFieldName Custom SubProject gt lt ClassificationMappings gt lt BlacklistedClassificationPaths gt lt BlacklistClassificationPath gt SomeArea OldArea lt BlacklistClassificationPath gt lt BlacklistedClassificationPaths gt lt Automation gt The configuration elements are described below which should be used to classify path should be copied to ClassificationMapping The single mapping which level should be copied to which field BlacklistedClassificationPaths Contains all paths which should be ignored blacklisted BlacklistClassificationPath The specific blacklisted path 4 3 8 Daily Status mail This scheduled automation sends an email with a list of work items based on a configurable work item query to users in case of at least one matching work item This way a daily status mail with all open task assigned to an individual user can be sent Only a single configuration is necessary to accomplish that No individual user alerts need to be configured and only a single mail is sent per day not per work item change The following sample exposes how such a mail looks like Automated Servicing and Administration Platform TFS ASAP User Guide Page 26 of 48 Pe IFSASAP TailSpinToysCollection My Open Tas
40. int the license agreement at any time choose the menu item License Agreements on the home page The license agreement will be shown with an option for printing it Automated Servicing and Administration Platform TFS ASAP User Guide Page 9 of 48 ye TFSASAP 3 Administering TFS ASAP 3 1 Central ASAP Control Page Home The management web site offers options to configure automations on team project collection level on team project level and on individual rule level within each team project Basically you can enable or disable the automations at each level mentioned JN SE y imon stration Platform EENEN AM TFS Projects Configure Team Project Tailspin Toys G Configure TFS ASAP Automation for all TFS team projects Trigger based Automations p Remaining Work Aggregation 4 FabrikamFiberCollection M Completed Work Aggregation FabrikamFiber Original Estimate Aggregation FabrikamFiberProj2 aiii Work Item State Aggregation 4 TailspinToysCollection Current Work Automation Tailspin Toys Proj2 Suspect Links v Tailspin Toys ji Scheduled Automations Consistency Check Daily Status Mail 2 Collections 4 Projects Figure 3 ASAP management website Home 3 2 Enable Disable Automations On the left hand side the side bar displays all the TFS team projects grouped by their team project collection Using the On Off Buttons the automations can be switched on or off at the according level If you d like to act
41. ion The includeSiblings parameters defines how the hierarchy Is queried false Only shows the direct parents and all children of the selected work item true Searches the root work item and shows the whole hierarhcy Automated Servicing and Administration Platform TFS ASAP User Guide Page 38 of 48 ye TFSASAP 5 2 3 Work Item Extensions Query Work item forms can contain a list of linked work items such as Related Work Items However sometimes other relations need to be shown For instance within a bug a user wants to easily see all other bugs created at the same day for the same product Bug 2 Build failure in build Manual_20130709 2 di A aie tees w i alt i F it st 4 J Kling IE STEPS TO REPRODUCE SYSTEM RELATED WORK ITEMS TEST CASES TASKS ACCEPTANCE CRITERIA HISTORY LINES ATTACH Related Work Items 4 ID Work Item Type Assigned To State Created Date 1 Product Backlog Item New 09 07 2013 14 09 44 3 Task To Do 07 11 2013 17 29 58 4 Task To Do 07 11 2013 17 30 18 5 Test Case Administrator Design 14 12 2013 23 33 20 2013 AIT GmbH amp Co KG Figure 21 Sample work item form This can be achieved using the work item extensions query In order to use the view within a work item you have to adapt the work item type defintion as follows lt WORKITEMTYPE name gt isse lt FORM gt lt Layout gt Pera lt TabGroup gt eng lt Tab Label Related Work Items gt Control Typ
42. ivate or deactivate all automations for only a particular project you can do this by using the button behind the project name In order to enable disable the automations on collection level you have to be a member of the TFS group Project Collection Administrators By selecting a project an overview is shown with all automations and their configuration for the selected project According to the logic of the automation activation for projects you can control the activation of an individual automation for the selected project Blue The Automation is enabled Orange The Automation is deactivated because it is disabled at a higher level i TFS team project or team project collection F Grey The Automation is disabled Automated Servicing and Administration Platform TFS ASAP User Guide Page 10 of 48 ye TFSASAP 3 3 Manually Triggering Scheduled Automations Scheduled Automations are only running in a certain timespan To force an update of the work items it is possible to manually trigger the particular automations Choose the automation you d like to trigger and press Run now Scheduled Automations Consistency Check Run now F Daily Status Mail Run now p a 3 4 Activation of Tracing and Logging TFS ASAP offers comprehensive logging and tracing support The logging and tracing support of the automation service platform is built on top of the standard NET Framework tracing and logging mechanisms Therefore ev
43. ks Thorsten Dralle Sent Do 07 11 7013 13 49 To Thorsten Dralle Project Collection Team Project Generated For Generation Date TailspinToysCollection Tailspin Toys Annie Herriman 01 11 2013 12 00 05 Work Item Query My Open Tasks Area Path 34 Tailspin Toys Website Active Design web front end for viewing all open orders 35 Tailspin Toys Website Active Design web front end for viewing customer details 36 Tailspin Toys Website Active Implement web front end for viewing customer details 37 Tailspin Toys Website Active Design web front end for modifying an open order Figure 14 Mail Notification Configuration is as follows lt Automation ID 824E6030 F57B 11E0 8E4D 8B204924019B DisplayName Daily Status Mail name AIT ASAP Automation ScheduledAutomations Common Configuration EmailAlertsAutomationConfi guration AIT ASAP Automation ScheduledAutomations Common gt lt Schedule StartDate 10 1 2011 RecurringFrequency 86400 gt lt MailMessage Subject COLLECCION SPROJEGT Daily Status Mais gt lt Query Header My Work Items gt Select System ID System WorkItemType System State System Title FROM WorkItems WHERE System TeamProject project and System AssignedTo me order by System State System WorkItemType System Id lt Query gt lt ExcludedAccount Name Jon Doe gt lt ExcludedAccount Name Jane Doe gt oll Maw NOt i ere OS lt 7 lt 5 luk lt Ai Oma ota Xml Eleme
44. l kinds of issue classification numbers to get a ranking ge TFSASAP Automation Name Automation Example Suspect Links Marks work items as Suspected Requirements WI Changed Y 4 3 11 suspected in case of In case of changes to relevant requirements relevant changes in fields description title all child and affected linked work items work items will be marked as suspected er is the custom Suspected field will be set o Yes and a link of type suspected by is ed Custom Enterprise Build your own automations WI Changed Y Separate Automation edition only or guide scheduled Automated Servicing and Administration Platform TFS ASAP User Guide Page 17 of 48 ye TFSASAP 4 3 Out Of The Box Automations 4 3 1 Numeric Aggregation Numeric Aggregation means that the values of linked work items are aggregated in a certain way For numeric aggregations the available aggregations are ADDITION and MULTIPLCATION This can be used to adding up all sub items to parent items for example estimated work of several child tasks to their parent requirement Configuration for numeric aggregations is as follows lt AuctcomacLon LD 1 DDR GS NE Se D090AB57B174 DisplayName Aggregate Original Estimate name AIT ASAP Automation TriggeredAu tomations WorkItemAutomations Common Configuration NumericAggregationAutomationConfiguration ATT ASAP Automation TriggeredAutomations WorkItemAutomations Common gt
45. lerEqual and NotSet e NotSet is the default value means no threshold comparison will be performed optional comparison The default value is 1 Severity Gives the possibility to wight a source field within optional the calculation by multiplying its value with the specified severity if the destination field is also of type double Otherwise rounding errors might occur D Double based values should only be used 4 3 11 Suspect Links Assume a requirements hierarchy broken down into three levels Someone changes the description of a higher level requirement The suspected links automation now sets lower level requirements into the suspected state that can easily be queried and navigated First a custom Suspected field will be set to Yes see 1 in image below Second links of type Suspected by will be created connecting the original source of change and suspected work items see 2 in image below This way a change impact analysis can easily be accomplished following the links from the changed requirement or querying all Suspected Yes requirements The behavior can be toggled by the user By setting the Auto Suspect field to empty see 3 in image below it will not be suspected in case of changes in the parent work item Automated Servicing and Administration Platform TFS ASAP User Guide Page 31 of 48 Ar TFSASAP Savequey U Requirement 31 A new safety requirement Design
46. n contains all information which is required to successfully use TFS ASAP Automated Servicing and Administration Platform ASAP is a platform to extend the functionality of Microsoft s Visual Studio Team Foundation Server TFS without the need for client side installations The main function is to provide work items in TFS with additional rules which can interact with linked work items Additional extensions help administering and extending TFS further and are subject to separate documentation The purpose of this documentation is to give instructions about how to use TFS ASAP Therefore it lists all functions and explains some necessary details of the platform 2 Getting started with TFS ASAP 2 1 Introduction TFS ASAP uses the TFS Background jobs to process particular automations To manage the rules which are called automations TFS ASAP provides a management web site which is hosted within the TFS Web Services via IIS The management website is shown below Ja re Alt http localhost 8080 asap P ad x AT TES ASAP Pris TE 3 E Willkommen bei Team Fo 29 FF Intranet Portal 3 FF Customer Portal X TFS FF Web Access EG TFS FF Project Portal UV Tailspin Toys X TFS TT Web Access AT TFS ASAP WVU Automated Servicing amp mmm OB amp Administration Platforn TFS Projects Configure Team Project FabrikamFiber G Configure TFS ASAP Automation for all TFS team projects Trigger based Automations p Remaining Work
47. nt MailMessage The subject used for the mail The following placeholder will be substituted COLLECTION The collection Name PROJECT The project Name A work item query language WIQL statement that is used to query work item data from the work item store It is possible to define multiple query elements The table header for every single WIQL Automated Servicing and Administration Platform TFS ASAP User Guide Page 27 of 48 ge TFSASAP a e Optional can define multiple elements to execlude multiple accounts Optional has been returned or not XSLT Optional Defines an XML transformation that is used to format the mail As outlined above a XSL transformation is used to generate the final mail format The input data for the XML transform uses the following xml ol versions lO tenceding uEt o gt Kepore lt ServerName gt yourserver lt ServerName gt lt CollectionName gt DefaultCollection lt CollectionName gt lt Collection ri gt htto yourservyer 8080 rTs DefaulrtColleccion lt Collection ri gt lt ProjectName gt TeamProject lt ProjectName gt lt ReportTine 1 112013 12 00 05 lt 7 ReporelTime gt lt User gt Jon Doe lt User gt lt QueryResults gt lt QueryResult gt lt QueryName gt lt QueryName gt lt QueryString gt lt QueryString gt lt WorkItems gt lt WorkItem gt lt WorkItemID gt 12621 lt WorkItemID gt lt TeamWebAccessUri gt http yourserver 8080 tfs web w
48. nter http tfs 8080 asap SelfService GlobalLists Index lt optional CollectionName gt lt optional Tea mProject gt in the location bar of the browser and hit enter You can also view global lists by browsing the tree Reloading It is possible to reload the current view by a click on Reload menu item Editing After browsing to a team project you can edit the items of a global list by clicking on the pen button now you can rename the items If you want to stop editing click on the augmented edit button You can also mark item as deleted if you leave its name empty or click on the trash button in the row of this item You can revive the item if you click on the augmented trash button Automated Servicing and Administration Platform TFS ASAP User Guide Page 43 of 48 ye TFSASAP Once a global list is submitted it is not possible to rename it If you want to rename the global list you have to delete it and create a new global list with the wanted name and the same items Creating You can create a new global list by clicking on the new menu item Until you save the global lists of the current view it is the only possibility to change the name of a global list Add new items New items can be added to a global list with the buttons The button on the right in the header of the global list adds an item in the beginning of the list Wheras the button in the row of item adds an item below this item S
49. remaining work using the Task Board Automated Servicing and Administration Platform TFS ASAP User Guide Page 23 of 48 ye TFSASAP EFFORT HOURS Original Estimate 14 Remaining work 3 Completed work 4 Figure 10 Inconsistent effort fields As the screenshot above unveils completed work field is still set to 4h If the user had no impediments so that Completed Work shall be increased by the same value the Remaining Work difference manual action by the user is needed Otherwise the fields are inconsistent and hence worthless for downstream analysis This automation simplifies updating of the time fields In case when Remaining Work value is decreased and Completed Work value is not manually updated Completed Work is automatically increased with the value of the difference between old and new Remaining Work values For example if Remaining Work was 10h and Completed Work was 4h and user reduces Remaining Work by 7h to 3h and leave Completed Work unchanged Completed Work will be updated with the difference 7h and will have the value 11h 4h 7h see Figure 11 and Figure 12 AlT Demos MSF CMMI v2013 3 2 Team Iteration 0 pocccscoaces Backlog Board PROPOSED 13h ACTIVE 18h RESOLVED 4 Requirement 1 e Task2 Task 1 FFORT HOURS 16h i Original Estimate 6 Thomas Riimmler 10 Thomas R mmler a Requirement2 Task5 Task 3 Task 4 15h 7 Thomas R mmler 3 Thomas Rimmler 5 Thomas R mmler Figure 11 Task Board and Effort f
50. rom this template Later we will see why it is advisable not do this However the sources of the MPT should be stored in a save place preferably inside the version control system of TFS TVF or git Let s say you want to define two global lists for each team project which should be adaptable a Meeting Type with the items offline and online b Replication System with the items System A System B and System C Unfortunately in process templates it is not possible to deploy global lists So we store the wanted global lists Priority and Replication System as global lists itself However a pattern is appended to the names of each global list This pattern can be TeamProjectName Reasons for this pattern are TFS ASAP assigns global lists to a team project with the divider the tailing text is chosen because and are forbidden characters for the name of a team project In this case the names are Priority TeamProjectName and Replication System TeamProjectName Now the MPT can be adapted at the position where the global list templates should be replaced with the correct global list A comparison of the Meeting Type global list inside the MPT and after the modification is shown in Table 2 and Table 3 lt FIELD name Meeting Type refname Microsoft VSTS CMMI MeetingType type Strin g gt lt ALLOWEDVALUES gt lt GLOBALLIST name Meeting Type TeamProjectName gt lt ALLOWEDVALUE
51. side the element appSettings Each value is a Boolean and the default value is false Each key is optional and case sensitive If the instance of TFS is a multiple app tier environment the configuration has to be deployed on each app tier Example The following snippet Table 1 shows how creating and deleting global lists can be denied lt configuration gt lt more configuration here gt lt appSettings gt lt more configuration here gt lt add key SelfService Globallist DenyDeleting value true gt lt add key SelfService Globallist DenyCreating value true gt lt more configuration here gt lt appSettings gt lt more configuration here gt lt configuration gt Table 1 Configuration global lists Automated Servicing and Administration Platform TFS ASAP User Guide Page 45 of 48 ye TFSASAP 6 5 Working with Process Templates In the previous sections you experienced how to work with global lists inside TFS ASAP Often project managers want to add new items to a global list Because for example the selection inside a field of a work item should match their needs This chapters shows you how this can be accomplished with the minimal possible effort First you create a Master Process Template MPT which serves as a meta template for the new team projects This MPT must not be published as a process template It has the advantages that nobody can create a team project f
52. t Automation Where elements have the following meaning Xml Element MonitoredFields The fields of the work item which are monitored for changes and cause linked work items to become suspected The reference name for field of a work item MonitoredLinks The link names which are followed to identify suspected items The reference name for field of a work item SuspectLink The link name of the suspected link which is created from changed to suspected work items with forward and reverse Automated Servicing and Administration Platform TFS ASAP User Guide Page 32 of 48 ye TFSASAP name mame 4 AutoSuspectFieldName Reference name of the field which contains the AutoSuspect value SuspectedFieldName Reference name of the field which will be set to Yes for suspected items In order to enable this automation several process template customizations have to be done 3 Create a file Suspects xml which includes the link type definition lt xml version 1 0 encoding gt utt 8 gt lt LinkTypes gt lt LinkType ReferenceName Custom Suspects ForwardName Suspects ReverseName Suspected By Topology Dependency gt lt LinkTypes gt 4 Add the following field definitions to the affected work item type definitions lt FIELD name Auto Suspect refname Custom AutoSuspect type String gt lt HELPTEXT gt Determines whether you want TFS to create links to affected items in case of Changes
53. t ai lt DigestValue gt vPq9d5FIsiEJtV3rBqUOtqV2VFc lt DigestValue gt ee A lt l Pleace replace all placeholder to generate a valid license i RERTENCE gt i lt l License Id is set automatically while singing the license Signedinfo gt f License Id 683cdd97 9ed9 4c6f a70a 3ca5dd95f956 Edition Enterprise xml lt SignatureValue gt i f i lt Licensee gt ii lt Keylnfo gt lt FirstName gt lt I CDATAJAIT gt lt FirstName gt lt KeyValue gt i lt LastName gt lt CDATAJEnterprise User gt lt LastName gt lt RSAKeyValue gt f i lt Company gt lt CDATAJAIT GmbH amp Co KG J gt lt Company gt lt Modulus gt a lt i p IL lt Street gt lt CDATA Leitzstrake 45 gt lt Street gt lt Exponent gt AQAB lt Exponent gt lt ZipCode gt lt I CDATA 70469 gt lt ZipCode gt lt RSAKeyValue gt lt City gt lt CDATA Stuttgart gt lt YCity gt i i lt gt lt 1 gt lt gt i lt KeyValue gt Country I CDATA Germany gt lt Country i i i lt Licensee gt E lt Keylnfo gt E tm i i lt LicensedFeatures gt AL AE f i i p i4 mW i 7 Mm License is not valid EEE EEE EEE VEE NUE v vuu e voveo The provided license with the ID KKK GE ee E has been terminated Please contact the support to issue a new license Accept License Agreements V Activate License Accept License Agreements Me Activate License License is valid 4 If you d like to pr
54. t influenced by TFS ASAP Figure 2 TFS ASAP technical schema 2 4 Installation 2 4 1 Technical Requirements e Windows OS with Visual Studio Team Foundation Server installed 2 4 2 Administrative Requirements e Knowledge about the usage and customization of work items e Administrative permissions both on all TFS app tier machines and in TFS Team Foundation Administrative Console Users e Sysadmin role in TFS data tier SQL Server this is the default for Team Foundation Administrative Console Users but could be changed by your SQL admin e An sa user in SQL Server that is sysadmin and dbowner of master database can be deactivated Automated Servicing and Administration Platform TFS ASAP User Guide Page 6 of 48 JA TFSASAP mate Q utom E ervicin 19 or dministratic Sn PI atfo en 2 4 3 Installation Process TFS ASAP needs to be installed and licensed on all TFS app tiers separately During the setup process a short interruption of TFS services will occur All current connections to TFS will be cancelled Since TFS works based on a transactional data access model no inconsistencies will appear due to the interruption However all of your running builds may be aborted Start the TFS installation and follow instructions 1 Launch TFS ASAP msi TFS ASAP mei 2 Go through the setup wizard read and accept the license agreement and provide the credentials for your TFSSERVICE account ig TFS ASAP Set
55. t has to be loaded e The inner XML will be injected into the automation configuration object to provide the configuration values You should only change the inner configuration values in Standard edition Do not edit the attributes ID DisplayName or Name of the Automation element This is only supported in Enterprise edition 4 1 1 Configuration Location The configurations for the automations can be found under the following path on each TFS app tier ProgramFiles AIT TFS ASAP Automation e AutomationsConfig xmi All trigger based automations e ScheduledAutomationsConfig xml All scheduled Automations 4 1 2 Automation Trigger Types Trigger Based Trigger based automations are processed when a work item has been changed and the conditions of any automation are met By changing a work item a server side event is fired Automated Servicing and Administration Platform TFS ASAP User Guide Page 13 of 48 ye TFSASAP TFS ASAP is notified about this event and checks the changes and the conditions whether certain automations have to be processed scheduled These automations are processed automatically in a specified time interval The recurring frequency is defined in the configuration files for the automation Every available scheduled automation must have additional properties Scheduled The actual schedule for the automation o StartDate The first time when the scheduled automations shall be started o RecuringFr
56. t work item extension lets you view a table of all bookings for a particular work item Task 6 Task 1 Area La es re DESCRIPTION HISTORY TIMESHEET LINKS ATTACHMENTS 16 12 2013 17 12 2013 18 12 2013 19 12 2013 Brian Keller 2h 4h 3h Administrator 15h 45h 2013 AIT GmbH amp Co KG Abbrechen Figure 22 Sample work item form This can be achieved using the work item extensions timesheet In order to use the view within a work item you have to adapt the work item type defintion as follows lt WORKITEMTYPE name gt PEPY lt FORM gt lt Layout gt pec lt TabGroup gt EET lt Tab Label Time Sheet gt lt Control Type WebpageControl LabelPosition Top gt lt WebpageControlOptions AllowScript true ReloadOnParamChange true gt lt Link UrlRoot http lt TFS gt 8080 wie UrlPath lt ColLlLectionName gt WorkItems TimeSheet workField Custom CurrentWork amp amp dateField Custom CurrentWorkDate amp amp unit h gt lt Param Index 0 Value System Id Type Current gt lt Link gt lt WebpageControlOptions gt lt Control gt lt Tab gt Please replace lt IFS gt and lt CollectionName gt with the values that fit your TFS instance and team project collection The URL contains several parameters which are described below The reference name of the field containing the effort information In case of the Current Work AutomationCurrent Work Automated Servicing
57. tValue gt No lt DefaultValue gt lt Operation gt Or lt Operation gt lt Automation gt With the following Xml elements Xml Element SourceField The reference name for the source field of the source work item DestinationField The reference name for the destination field of the destination work item LinkType The link type to follow for aggregation AggregateValuesTo The link direction name to aggregate values to DefaultValue The default value in case the aggregated Boolean value is not a Boolean The operation for aggregation And or Or 4 3 2 1 Blocked Aggregation This can be used to aggregate values from child items to their parent item For example if all subtasks are set to Blocked Yes the parent task also automatically changes to Blocked Yes Automated Servicing and Administration Platform TFS ASAP User Guide Page 19 of 48 ye TFSASAP 4 3 3 State Aggregation 4 3 3 1 Active Closed State Aggregation This automation aggregates the field State of work items To aggregate as expected it needs to be configured by the user The shipped default configuration aggregates the states Active and Closed to its parent work items For example if the last child of a work item T1 SubOfT 1 is changed to state Closed the parent Task1 will automatically be set to Resolved If any child gets reactivated also the parent will be changed back to active Requirem
58. ted By Title cwog CW10 Cwi E cw 20 03 21 03 2203 Cw13 Brian Keller 3h E Julia Ilyiana Sh 39 h 43 h od h 12 h 123345670890 12354567690 1234567 Another one Do something Test Test Task 2 Test Task 3 Test Task Current Work vet another task vet another test vet another tests Figure 8 Time sheet report Atomene NR BENENE 907BO1DD4B86 DisplayName Current Work Automation name AIT ASAP Automation TriggeredAutoma tions WorkItemAutomations Common Configuration CurrentWorkAutomationConfiguration AIT ASAP Au tomation TriggeredAutomations WorkItemAutomations Common gt Current Nork Custom CurcentWork lt Currenrtnork lt gt Optional System ChangedDare used by default gt lt WorkDate gt Custom CurrentWorkDate lt WorkDate gt lt RemainingWork gt Microsoft VSTS Scheduling RemainingWork lt RemainingWork gt lt CompletedWork gt Microsoft VSTS Scheduling CompletedWork lt CompletedWork gt Optional detaulrg Vaw gt lt mrroOrtUnit gt hours lt s BirortUniLT gt lt Automation gt Automated Servicing and Administration Platform TFS ASAP User Guide Page 22 of 48 ye TFSASAP The configuration elements are described below Xml Element CurrentWork The reference name for the current work field of a work item user input WorkDate The reference name for the work date field of a work item user input RemainingWork The reference name for the Remaining Work field of a work item used
59. umeric operations are supported Addition Multiplication and Subtraction E g assume that there are three fields within a Task work item analysis effort implementation effort and test effort An effort field shall be filled with the sum of all three fields CATEGORIZED EFFORT Analyse Effort 1 Implement Effort 2 Test Effort 3 Total Effort Figure 15 Example Numeric Calculation with Addition Configuration is as follows lt Automation ID 2B477204 592D 41DC 8202 B985EF77E8DE DisplayName Effort Addition name AIT ASAP Automation TriggeredAutomations WorkItemAu tomations Extended Configurations NumericCalculationAutomationConfiguration AIT ASAP Automation Trigg eredAutomations WorkItemAutomations Extended gt lt DestinationField gt Custom TotalEffort lt DestinationField gt lt SourceFields Operation Add gt lt SourceField gt Custom AnalyseEffort lt SourceField gt lt SourceField gt Custom ImplementEffort lt SourceField gt lt SourceField gt Custom TestEffort lt SourceField gt lt SourceFields gt lt Automation gt Xml Element Destination Field The destination field for the result of the calculaiton SourceFields This Element contains the sourcefields which and specefices the operation Operation Specifies the operator Possible values are e Add Addition e Mul Multiplication e Sub Subtraction SourceField A single source field used for the operation Automated S
60. up 11 30 0 0 TFS ASAP App Pool Credentials for the app pool Specify the logon account for the TFS ASAP service tfsservice J TFS ASAP Setup Completed the TFS ASAP Setup Wizard Click the Finish button to exit the Setup Wizard 3 Navigate to the management website by following the instructions of the next section Automated Servicing and Administration Platform TFS ASAP User Guide Page 7 of 48 ye TFSASAP 2 5 TFS Updates TFS ASAP will be partially uninstalled during TFS update installations You need to make sure that you to have the current setup of TFS ASAP available prior to any TFS updates Due to the easy no parameter deployments TFS ASAP will not work correctly after a TFS update installation You will need to uninstall TFS ASAP before any TFS update and install the current version of TFS ASAP after the TFS update has finished in order to have everything working correctly 2 6 First Usage Initially after installing TFS ASAP all automations are disabled by default Therefore TFS ASAP has to be configured for usage The configuration values can be changed using the management website 1 To reach the management website you can use the link which is installed at the desktop or the start menu called TFS ASAP Management TFS ASAP Management 2 It s opening your web browser and entering the URL under which your TFS is running in this sample TFS is running under localhost
61. upported Addition Multiplication and Subtraction Advanced Extends the numeric Numeric calculation with source Calculation field severity and threshold Automated Servicing and Administration Platform Ar TFSASAP EEE Automation Example Consistency Incremental or full Check consistency check for the automation rules Consistency Check Scheduled N N 4 3 6 This automation ensures a consistent state of or Manually all work items that might be inconsistent due to unfired events or blocking changes It checks for such events and retries execution incremental check It s also possible to do a full consistency check which reprocesses the chosen automation for all work items Y Y 4 3 7 Area Path Copy WI Changed Set the AssignedTo field to a default value based on the Area Path selected The automation will copy the first level Area Path value into a custom field Custom Subproject Custom work item rules are configured for the AssignedTo field Daily Status Mail Scheduled sends a daily mail to each user that shows or Manually the list of all open tasks in all projects of TFS Only in case at least one work item matches the query the mail is sent Analyze Implement Test Efforts WI Changed Y Y 4 3 9 Sum up efforts of separate fields for analysis implementation and test efforts into completed work Issue Ranking Calculated WI Changed 4 3 10 TFS ASAP User Guide Page 16 of 48 Multiplies severa
62. without Parent Feature Requireme 4 new safety requirement Feature Requireme Design Element 2 es NFR Requireme i Title A new safety requirement Design Element 1 es NFR Requireme STATUS Task Task Assigned To Administrator tate Review 5 Reason Review Failed Auto Suspect Yes h PLANNING Priority 1 Highest Severity Safety relevant DETAILS REVIEW ANALYSIS IMPLEMENTATION 2 SUSPECTS 2 CH Suspected Requirements b x e LIE ID Work Item Tit 4 Suspects 2 32 Requireme Design Element 1 Requireme Design Element 2 Figure 18 Sample hierarchy and suspect links and fields Configuration is as follows lt Automation ID CA5S15A36 95EB 465C 8209F 6596 28311925 DisplayName Suspect Links name AIT ASAP Automation TriggeredAutomations WorkItemAutomations Extended Configurations Sus pectLinksAutomationConfiguration AIT ASAP Automation TriggeredAutomations WorkItemAutomations Extended gt lt MonitoredFields gt lt Field gt System Title lt Field gt lt Field gt System Description lt Field gt lt MonitoredFields gt lt MonitoredLinks gt lt MonitoredLink gt Child lt MonitoredLink gt lt MonitoredLinks gt lt SuspectLink ReferenceName Custom Suspects ForwardName Suspects ReverseName Suspected BE lt AutoSuspectFieldName gt Custom AutoSuspect lt AutoSuspectFieldName gt lt SuspectedFieldName gt Custom Suspected lt SuspectedFieldName gt l

TFS ASAP – User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents

TFS ASAP &ndash; User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents

TFS ASAP – User Guide