Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "OSEE/Tutorial"

(Code Team Workflow)
(Other Attributes)
 
(46 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
This page is being adapted from [http://www.eclipse.org/osee/OSEE_eclipsecon2009_tutorial_slides.pdf this presentation].
 
This page is being adapted from [http://www.eclipse.org/osee/OSEE_eclipsecon2009_tutorial_slides.pdf this presentation].
 +
 +
It is recommended that this tutorial be viewed in a roughly half-width browser window.
  
 
==Requirements==
 
==Requirements==
Line 41: Line 43:
  
 
==Initialization==
 
==Initialization==
 +
 +
<!-- TODO this is obsolete -->
  
 
===Launch Application Server===
 
===Launch Application Server===
Line 82: Line 86:
 
In addition, certain tasks will need to be performed off Code Team Workflow.
 
In addition, certain tasks will need to be performed off Code Team Workflow.
  
==Requirements Search==
+
==Dramatis Personae==
  
 +
; Joe Smith
 +
: Project Engineer (Requirements and Code)
 +
; Alex Kay
 +
: Project Manager
 +
; Kay Jones
 +
: Test Engineer
 +
 +
==Requirements Search==
 +
[[Image:SelectBranch.png|thumbnail|The '''Select Branch''' dialog]]
 +
[[Image:QuickSearch.png|thumbnail|right|The '''Quick Search''' view]]
 
* Switch to the Define perspective ('''Window &gt; Open Perspective &gt; Define''').
 
* Switch to the Define perspective ('''Window &gt; Open Perspective &gt; Define''').
 
* In the Artifact Explorer, click '''Select Branch...'''
 
* In the Artifact Explorer, click '''Select Branch...'''
Line 89: Line 103:
 
** Click "OK"
 
** Click "OK"
 
* Search for Item:
 
* Search for Item:
** Click on the '''Quick Search''' view
+
** Click on the '''Quick Search''' view  
 
** Select the "SAW_Bld_2" branch
 
** Select the "SAW_Bld_2" branch
 
** Enter "robot object" in the search string text box
 
** Enter "robot object" in the search string text box
Line 112: Line 126:
 
*** Here, we can see how the "Robot Object" software requirement relates to other artifacts.
 
*** Here, we can see how the "Robot Object" software requirement relates to other artifacts.
  
==Code Team Workflow==
+
==Requirements Team Workflow==
  
 
We want to create an action against the "Robot Object Requirement."  
 
We want to create an action against the "Robot Object Requirement."  
 
+
[[Image:3-CreateATSAction.Png|thumb|right|400px|The '''Create ATS Action''' Sequence]]
 
* Switch to the ATS Perspective ('''Window &gt; Open Perspective &gt; ATS''').
 
* Switch to the ATS Perspective ('''Window &gt; Open Perspective &gt; ATS''').
 
* Click on the New Action icon ([[Image:NewAction.gif]]) in the '''ATS Navigator'''.
 
* Click on the New Action icon ([[Image:NewAction.gif]]) in the '''ATS Navigator'''.
Line 127: Line 141:
 
*** '''Priority''': "3"
 
*** '''Priority''': "3"
 
*** '''User Community''': "Program_1"
 
*** '''User Community''': "Program_1"
** Click '''Finish'''. Joe Smith will automatically be assigned to team lead.
+
** Click '''Finish'''. This will generate a Requirements Team Workflow for the necessary requirements changes. Joe Smith will automatically be assigned the position of Team Lead.
  
===Code Workflow Endorsement===
+
===Endorse===
  
 
The Requirements Team Lead (Joe) has approved the Requirement Team Workflow and wants to transition to analysis.
 
The Requirements Team Lead (Joe) has approved the Requirement Team Workflow and wants to transition to analysis.
Line 137: Line 151:
 
** This is where the lead would normally assign another user to complete the work; however, we will not change the assigned user for the demo.
 
** This is where the lead would normally assign another user to complete the work; however, we will not change the assigned user for the demo.
  
===Code Workflow Analysis===
+
===Analyze===
 
+
[[Image:7-ActionableItemsLink.png|right|thumb|'''Actionable Items''' hyperlink location (artificially highlighted)]]
 +
[[Image:6-ImpactedActionableItems.Png|left|thumb|150px|Selecting Actionable Items impacted by the Requirements change]]
 
Here, Joe (as the Requirements Developer) wants to analyze the action.
 
Here, Joe (as the Requirements Developer) wants to analyze the action.
  
 
* Input "Fix It" as the '''Proposed Resolution'''
 
* Input "Fix It" as the '''Proposed Resolution'''
 +
* Set '''Estimated Hours''' to "2.5".
 
* As this change will impact Code as well as Test, we will add corresponding workflows for each.
 
* As this change will impact Code as well as Test, we will add corresponding workflows for each.
** Click on the '''Actionable Items''' hyperlink
+
** Click on the '''Actionable Items''' hyperlink  
 
** Select "SAW Code"
 
** Select "SAW Code"
 
** Select "SAW Test"
 
** Select "SAW Test"
Line 149: Line 165:
 
* Transition to "Authorize".
 
* Transition to "Authorize".
  
===Code Workflow Authorization===
+
===Authorize===
  
 
Here, the Requirements Team Lead (Joe again) authorizes the Action.
 
Here, the Requirements Team Lead (Joe again) authorizes the Action.
Line 161: Line 177:
 
*** Click '''OK'''
 
*** Click '''OK'''
  
====Preparing the Decision Review====
+
====Decision Review====
 +
 
 +
=====Prepare=====
  
 
Here, the Requirements Lead prepares the review:
 
Here, the Requirements Lead prepares the review:
Line 171: Line 189:
 
* Transition the review to "Decision"
 
* Transition the review to "Decision"
  
====Approving the change====
+
=====Complete=====
  
 
First, Alex Kay has to check his assigned work.
 
First, Alex Kay has to check his assigned work.
Line 178: Line 196:
 
* From Alex Kay's '''User's World''', select the "Decision Review"
 
* From Alex Kay's '''User's World''', select the "Decision Review"
 
* Alex Kay decides "yes;" we will simulate this with a '''Privileged Edit'''.
 
* Alex Kay decides "yes;" we will simulate this with a '''Privileged Edit'''.
** Click the Privileged Edit icon (second from the right).
+
** Click the Privileged Edit icon ([[Image:5-PrivilegedEdit.png]]).
 
** Click '''Override and Edit'''.
 
** Click '''Override and Edit'''.
 
** Select "Yes" as the '''Decision'''.
 
** Select "Yes" as the '''Decision'''.
 
** Transition the Review to "Completed".
 
** Transition the Review to "Completed".
  
====Completing the Authorization====
+
===Authorize (cont'd)===
  
 
Note that before Alex Kay had completed the decision review, Joe was not able to transition to the next state.
 
Note that before Alex Kay had completed the decision review, Joe was not able to transition to the next state.
  
* Set '''Estimated Hours''' to "2.5".
 
 
* Transition to "Implement".
 
* Transition to "Implement".
  
 
==Implementing a Change==
 
==Implementing a Change==
 
+
[[Image:10-SelectWorkingBranch.png|right|frame|Locating the Working Branch]]
* From the Implement State, select the '''Create Working Branch''' icon (the leftmost icon).
+
[[Image:11-MSWordEdit.Png|right|frame|Location of '''MS Word Edit''']]
* Using the '''Artifact Explorer''', navigate to and right click the "Robot Object" software requirement.
+
[[Image:13-ViewWordChangeReport.Png|right|thumb|The '''Word Change Report''' highlights changes to the parent branch in red]]
** From the context menu, select '''Open With &gt; Artifact Editor'''.
+
* From the Implement State, select the '''Create Working Branch''' icon ([[Image:9-CreateWorkingBranchIcon.Png]]), then click '''OK'''.
 +
* In the '''Artifact Explorer''', click '''Select Branch'''.
 +
** Select the working branch just created. Its author is "Joe Smith" and its comment field reads "New Branch from SAW_Bld_2" (see image).
 +
** Navigate to and right click the "Robot Object" software requirement.
 +
*** Alternatively, you can perform a '''Quick Search''', but you must remember to specify the working branch again or the parent branch will be searched instead.
 +
** From the context menu, select '''Open With &gt; Artifact Editor'''.  
 
* Under the '''Attributes''' tab, change '''Qualification Method''' to "Inspection" and save the file ('''File &gt; Save''').
 
* Under the '''Attributes''' tab, change '''Qualification Method''' to "Inspection" and save the file ('''File &gt; Save''').
* From the '''Artifact Editor''''s toolbar, select '''Open With &gt; MS Word Edit''', and, if prompted, specify that Word is to open the file as an XML document.
+
* From the '''Artifact Editor''''s toolbar, select '''Open With &gt; MS Word Edit''' (see image), and, if prompted, specify that Word is to open the file as an XML document.
 
** Insert into the document the next "Need more information here."
 
** Insert into the document the next "Need more information here."
 
** Save and close the document. The '''Artifact Editor''''s Word Template Content Attribute should update accordingly.
 
** Save and close the document. The '''Artifact Editor''''s Word Template Content Attribute should update accordingly.
* Switch to the '''Workflow Editor''' and select the "Show Change Report" icon from the toolbar above the '''Commit Manager'''.
+
* Switch to the '''Workflow Editor''' and select the "Show Change Report" icon ([[Image:12-ShowChangeReportIcon.png]]) from the toolbar immediately above the '''Commit Manager'''.
* From the '''Change Report View''', right click on the "Robot Object" Software Requirement and select '''View Word Change Report'''.  
+
* From the '''Change Report View''', right click on the "Robot Object" Software Requirement and select '''View Word Change Report'''. If prompted, specify that the document should be opened as XML. A document similar to the one shown on the right should appear, highlighting the differences between the versions of the Artifact found in the parent branch and the working branch.
 +
* When finished, close MS Word.
 
* Double click the working branch in the '''Commit Manager''' to apply changes to the parent branch.
 
* Double click the working branch in the '''Commit Manager''' to apply changes to the parent branch.
 
* Transition to "Complete".
 
* Transition to "Complete".
  
==Code Team Workflow Endorsement==
+
==Code Team Workflow==
 +
 
 +
Begin by opening the Code Workflow. This can be found using the '''Show all Team Workflows''' view found in the '''ATS Navigator'''. The Workflow in question has the title "Robot Object requirement needs more detail" and is in the Endorse state with priority 2.
 +
 
 +
===Endorse===
  
* Reopen the Code Team Workflow.
 
 
* Enter "A234532" as the '''Work Package'''.
 
* Enter "A234532" as the '''Work Package'''.
 
* Transition to "Analyze".
 
* Transition to "Analyze".
  
===Code Team Workflow Analysis===
+
===Analyze===
  
* For '''Estimated Hours, enter "10".
+
* For '''Estimated Hours''', enter "10". <!-- TODO metrics -->
 
* Click on the '''Tasks''' tab at the bottom of the View.
 
* Click on the '''Tasks''' tab at the bottom of the View.
** Add a Task by clicking on the '''New Task''' icon on the toolbar.
+
** Add a Task by clicking on the '''New Task''' icon ([[Image:15-NewTaskIcon.Png]]) on the toolbar.
 
** In the '''Create New Task''' dialog, enter "Do the first thing".
 
** In the '''Create New Task''' dialog, enter "Do the first thing".
 
** Click '''OK''' to close the dialog.
 
** Click '''OK''' to close the dialog.
Line 222: Line 248:
 
* The above steps can be repeated to add additional tasks as needed.
 
* The above steps can be repeated to add additional tasks as needed.
 
* Transition each task to the "Completed" state.
 
* Transition each task to the "Completed" state.
** Note that the workflow cannot be advanced until all tasks associated  
+
** Note that the workflow cannot be advanced until all tasks associated with the Analyze state have been Completed.
with the Analyze state have been Completed.
+
 
* Transition the code team workflow to Authorize.
 
* Transition the code team workflow to Authorize.
  
===Test Team Workflow Endorsement===
+
==Test Team Workflow==
  
 
Here, the Test Lead (Joe) estimates the work required for the test team workflow.  
 
Here, the Test Lead (Joe) estimates the work required for the test team workflow.  
  
* Open the Test Team Workflow. If it is not open, you can search for it:
+
* Open the Test Team Workflow. If necessary, you can search for it in the same manner as the Code Workflow.
** In the '''ATS Navigator''', enter the filter "workflow".
+
** Open '''Show all Team Workflows'''.
+
** In this view, filter by the word "test". Several results should appear; select the one presently in the "Endorse" state.
+
 
* Since Kay Jones, the assignee for this workflow, is not in today, Joe will need to get edit privileges to transition the workflow.
 
* Since Kay Jones, the assignee for this workflow, is not in today, Joe will need to get edit privileges to transition the workflow.
 
** Click on the Privileged Edit icon (second from the right) and click on '''Override and Edit''' in the resulting dialog box.
 
** Click on the Privileged Edit icon (second from the right) and click on '''Override and Edit''' in the resulting dialog box.
 
* Transition to the "Analyze" state.
 
* Transition to the "Analyze" state.
 
* Set '''Estimated Hours''' to "25".
 
* Set '''Estimated Hours''' to "25".
 +
<!-- TODO need to transition here so metrics show up correctly? -->
  
 
==Metrics==
 
==Metrics==
 +
There are a number of different ways to extract / view metrics through OSEE ATS.
  
"What this place needs is some metrics!" Alex Kay, as Manager, needs a status report.
+
===ATS Metrics Attributes===
 +
ATS workflows have metrics attributes available
 +
*ats.Estimated Completion Date
 +
*ats.Estimated Hours
 +
*ats.Estimated Release Date
 +
*ats.Created Date
 +
*ats.Completed Date
 +
*ats.Cancelled Date
 +
*ats.Start Date
 +
*ats.End Date
 +
*ats.Percent Complete
 +
Created, Completed and Cancelled dates are set automatically as the workflow moves through it's lifecycle. Other attributes can be set through the Workflow Editor, World Editor or REST calls
  
 +
===ATS Workflow Editor===
 +
The Workflow editor has Percent Complete (editable), Estimated Hours (editable), Total Hours Spent (computed) and Remaining Hours (computed).  The Team Workflow Percent Complete is broken into 2 values xx/yy (if applicable).  The xx will show the Percent Complete for the viewed workflow.  The yy value will show a roll-up computed percent complete of Team Workflow, Tasks and Reviews.
 +
 +
===ATS Log===
 +
Each workflow has an ats.Log that automatically stores events like transitions, assignees and state hours spent.  This log can be accessed via the ATS State Manager and used to generate/export historical events in the lifecycle of the workflows.
 +
 +
===ATS Metrics Tab===
 +
"What this place needs is some metrics!" Alex Kay, as Manager, needs a status report.
 +
[[Image:16-RedisplayAsWorkflows.png|right|'''Re-display as WorkFlows'''|thumb]]
 +
[[Image:17-Metrics.png|left|thumb|Sample metrics]]
 
* From the '''ATS Navigator''', select "My World".
 
* From the '''ATS Navigator''', select "My World".
* Click the rightmost icon on the toolbar to bring up a context menu. Select '''Re-display as WorkFlows'''.
+
* Click the rightmost icon on the toolbar to bring up a context menu. Select '''Re-display as WorkFlows'''. * Click on the '''Metrics''' tab (at the bottom) to open the Metrics Page.
* Click on the '''Metrics''' tab (at the bottom) to open the Metrics Page.
+
 
* Set '''Estimated Release Date''' to two days from now.
 
* Set '''Estimated Release Date''' to two days from now.
 +
Joe Smith will finish on time, as the estimate of remaining hours in his workflows is well within the remaining time to release; Kay Jones, on the other hand, won't make it.
 
<!-- What is supposed to come up here?? The proper entries for "Estimated Hours" and "Additional Hours Spent" in the previous steps need to be reviewed -->
 
<!-- What is supposed to come up here?? The proper entries for "Estimated Hours" and "Additional Hours Spent" in the previous steps need to be reviewed -->
 +
</br>
 +
 +
===Peer Review Metrics===
 +
Out of the box, OSEE Review provides the "Generate Participation Report" which can be run for any OSEE user.  This will show what peer reviews a user has done.
 +
 +
===Other Attributes===
 +
As with all of OSEE, other attributes can be added to workflows to store any data necessary for other metrics and added to  the Workflow Editor and World Editor.
  
 
==Peer Review==
 
==Peer Review==

Latest revision as of 11:33, 4 June 2019

This page is being adapted from this presentation.

It is recommended that this tutorial be viewed in a roughly half-width browser window.

Requirements

System Requirements

OSEE requires a system with at least 1GB of RAM running JRE 1.6 or higher. Microsoft Office is useful for the demo.

Eclipse Dependencies

The following Eclipse dependencies are required, although it is easiest to simply use the Ganymede Eclipse install.

  • Eclipse 3.4.2 SDK
  • org.eclipse.gef
  • org.eclipse.draw2d
  • org.eclipse.birt
  • org.eclipse.datatools

Installation

Database

Install PostgreSQL using the following settings:

  • Default install path and data directory
  • Password "Postgre1"
  • Port 5432
  • Default locale
  • On the final screen, ensure that "Launch Stack Builder" is not selected

After saving the database password using pgadmin, run the osee_db_setup script, which is located under the "PostgreSql" folder.

More on PostgreSQL installation

Java Runtime Environment (JRE)

Ensure that the directory in which the JRE is installed is in the path by typing "java --version" at a command prompt.

OSEE Client

Extract and launch Eclipse. From the update manager, install the update sites located under "OseeClient":

  • org.eclipse.osee_integration_build_incubation.zip
  • osee.add.ons.updatesite.zip osee.add.ons.updatesite.zip

Initialization

Launch Application Server

Execute the osee_app_server script located under "OseeApplicationServer" and wait until the server finishes the start up procedure before closing the console.

Database Initialization

In a command prompt, change to the Eclipse install directory and execute the following command:

eclipsec -application org.eclipse.osee.framework.database.configClient -vmargs -Xmx512m
-Dosee.log.default=INFO -Dosee.application.server=http://localhost:8089
-Dosee.authentication.protocol=trustAll -Dosee.prompt.on.db.init=false
-Dosee.choice.on.db.init="OSEE Demo Database"

Once db init closes, type "exit" in the server console.

Populate Demo Data

Launch the Application Server and then the OSEE client with the following command:

eclipse -vmargs -Xmx512m
-Dosee.application.server=http://localhost:8089
-Dosee.authentication.protocol=demo

Switch to the ATS perspective (Window > Open Perspective > ATS); in the ATS Navigator window, enter "Populate" as the filter and press Enter, then double click on the "Populate Demo Actions" item.

Case Study

Scenario

User Joe Smith finds a problem in a requirement impacting multiple teams, namely Code, Test, Website, and IT. Multiple reviews will be needed:

  • Decision Review (off Code Team Workflow)
  • Peer Review (off Test Team Workflow)

In addition, certain tasks will need to be performed off Code Team Workflow.

Dramatis Personae

Joe Smith
Project Engineer (Requirements and Code)
Alex Kay
Project Manager
Kay Jones
Test Engineer

Requirements Search

The Select Branch dialog
The Quick Search view
  • Switch to the Define perspective (Window > Open Perspective > Define).
  • In the Artifact Explorer, click Select Branch...
    • Select "SAW_Bld_2"
    • Click "OK"
  • Search for Item:
    • Click on the Quick Search view
    • Select the "SAW_Bld_2" branch
    • Enter "robot object" in the search string text box
    • Check the Match Word Order option
    • Check the All Match Locations option
    • Click the search button

Exploring the requirement

The search results will be listed in a tree or list view with match locations. We want to explore the robot object requirement. From the search result list (not tree),

  • Right click on the "Robot Object" software requirement
  • Select each of the following from the pop-up menu individually
    • Reveal Artifact in Explorer
    • Resource History
    • Open With > Artifact Editor
      • Open the Attribute tab
      • Open the Relation tab
    • Open with > MS Word Preview
      • Convert file from XML Document
    • Sky Walker
      • Here, we can see how the "Robot Object" software requirement relates to other artifacts.

Requirements Team Workflow

We want to create an action against the "Robot Object Requirement."

The Create ATS Action Sequence
  • Switch to the ATS Perspective (Window > Open Perspective > ATS).
  • Click on the New Action icon (NewAction.gif) in the ATS Navigator.
    • Fill in the Create ATS Action Dialog
      • Enter "Robot Object requirement needs more detail" as the Title
      • Select "SAW Requirements" (under "SAW CSCI") as the Actionable Item
      • Click Next
    • Fill in the fields as follows:
      • Description: "See title"
      • Change Type: "Problem"
      • Priority: "3"
      • User Community: "Program_1"
    • Click Finish. This will generate a Requirements Team Workflow for the necessary requirements changes. Joe Smith will automatically be assigned the position of Team Lead.

Endorse

The Requirements Team Lead (Joe) has approved the Requirement Team Workflow and wants to transition to analysis.

  • Set the Target Version to SAW_Bld_2.
  • Change Priority to 2.
  • Transition to the "Analyze" state.
    • This is where the lead would normally assign another user to complete the work; however, we will not change the assigned user for the demo.

Analyze

Actionable Items hyperlink location (artificially highlighted)
Selecting Actionable Items impacted by the Requirements change

Here, Joe (as the Requirements Developer) wants to analyze the action.

  • Input "Fix It" as the Proposed Resolution
  • Set Estimated Hours to "2.5".
  • As this change will impact Code as well as Test, we will add corresponding workflows for each.
    • Click on the Actionable Items hyperlink
    • Select "SAW Code"
    • Select "SAW Test"
    • Click OK. The Action View will now show new workflows. Email notifications have been sent to the team leads.
  • Transition to "Authorize".

Authorize

Here, the Requirements Team Lead (Joe again) authorizes the Action.

  • Input "A324324A" as the Work Package.
  • Since the Team Lead needs concurrence from Kay (the Manager), a decision review is needed.
    • Click the Add Decision Review hyperlink.
    • Fill-in the Create Decision Review dialog:
      • Review Title: "Any Problems with authorizing this?"
      • Associated state: "Authorize"
      • Click OK

Decision Review

Prepare

Here, the Requirements Lead prepares the review:

  • Set Review Blocks to "Transition"
  • Set Estimated Hours to 3
  • Click Assignee(s)
    • Select "Alex Kay"
  • Transition the review to "Decision"
Complete

First, Alex Kay has to check his assigned work.

  • In the ATS Navigator, double click on My World and select Alex Kay as the user.
  • From Alex Kay's User's World, select the "Decision Review"
  • Alex Kay decides "yes;" we will simulate this with a Privileged Edit.
    • Click the Privileged Edit icon (5-PrivilegedEdit.png).
    • Click Override and Edit.
    • Select "Yes" as the Decision.
    • Transition the Review to "Completed".

Authorize (cont'd)

Note that before Alex Kay had completed the decision review, Joe was not able to transition to the next state.

  • Transition to "Implement".

Implementing a Change

Locating the Working Branch
Location of MS Word Edit
The Word Change Report highlights changes to the parent branch in red
  • From the Implement State, select the Create Working Branch icon (9-CreateWorkingBranchIcon.Png), then click OK.
  • In the Artifact Explorer, click Select Branch.
    • Select the working branch just created. Its author is "Joe Smith" and its comment field reads "New Branch from SAW_Bld_2" (see image).
    • Navigate to and right click the "Robot Object" software requirement.
      • Alternatively, you can perform a Quick Search, but you must remember to specify the working branch again or the parent branch will be searched instead.
    • From the context menu, select Open With > Artifact Editor.
  • Under the Attributes tab, change Qualification Method to "Inspection" and save the file (File > Save).
  • From the Artifact Editor's toolbar, select Open With > MS Word Edit (see image), and, if prompted, specify that Word is to open the file as an XML document.
    • Insert into the document the next "Need more information here."
    • Save and close the document. The Artifact Editor's Word Template Content Attribute should update accordingly.
  • Switch to the Workflow Editor and select the "Show Change Report" icon (12-ShowChangeReportIcon.png) from the toolbar immediately above the Commit Manager.
  • From the Change Report View, right click on the "Robot Object" Software Requirement and select View Word Change Report. If prompted, specify that the document should be opened as XML. A document similar to the one shown on the right should appear, highlighting the differences between the versions of the Artifact found in the parent branch and the working branch.
  • When finished, close MS Word.
  • Double click the working branch in the Commit Manager to apply changes to the parent branch.
  • Transition to "Complete".

Code Team Workflow

Begin by opening the Code Workflow. This can be found using the Show all Team Workflows view found in the ATS Navigator. The Workflow in question has the title "Robot Object requirement needs more detail" and is in the Endorse state with priority 2.

Endorse

  • Enter "A234532" as the Work Package.
  • Transition to "Analyze".

Analyze

  • For Estimated Hours, enter "10".
  • Click on the Tasks tab at the bottom of the View.
    • Add a Task by clicking on the New Task icon (15-NewTaskIcon.Png) on the toolbar.
    • In the Create New Task dialog, enter "Do the first thing".
    • Click OK to close the dialog.
  • Double click on the new task to open the Task Editor.
    • Click on Assignee(s) to assign a different user (it doesn't matter which user). Enter the Estimated Hours.
    • Close the Task Editor.
  • The above steps can be repeated to add additional tasks as needed.
  • Transition each task to the "Completed" state.
    • Note that the workflow cannot be advanced until all tasks associated with the Analyze state have been Completed.
  • Transition the code team workflow to Authorize.

Test Team Workflow

Here, the Test Lead (Joe) estimates the work required for the test team workflow.

  • Open the Test Team Workflow. If necessary, you can search for it in the same manner as the Code Workflow.
  • Since Kay Jones, the assignee for this workflow, is not in today, Joe will need to get edit privileges to transition the workflow.
    • Click on the Privileged Edit icon (second from the right) and click on Override and Edit in the resulting dialog box.
  • Transition to the "Analyze" state.
  • Set Estimated Hours to "25".

Metrics

There are a number of different ways to extract / view metrics through OSEE ATS.

ATS Metrics Attributes

ATS workflows have metrics attributes available

  • ats.Estimated Completion Date
  • ats.Estimated Hours
  • ats.Estimated Release Date
  • ats.Created Date
  • ats.Completed Date
  • ats.Cancelled Date
  • ats.Start Date
  • ats.End Date
  • ats.Percent Complete

Created, Completed and Cancelled dates are set automatically as the workflow moves through it's lifecycle. Other attributes can be set through the Workflow Editor, World Editor or REST calls

ATS Workflow Editor

The Workflow editor has Percent Complete (editable), Estimated Hours (editable), Total Hours Spent (computed) and Remaining Hours (computed). The Team Workflow Percent Complete is broken into 2 values xx/yy (if applicable). The xx will show the Percent Complete for the viewed workflow. The yy value will show a roll-up computed percent complete of Team Workflow, Tasks and Reviews.

ATS Log

Each workflow has an ats.Log that automatically stores events like transitions, assignees and state hours spent. This log can be accessed via the ATS State Manager and used to generate/export historical events in the lifecycle of the workflows.

ATS Metrics Tab

"What this place needs is some metrics!" Alex Kay, as Manager, needs a status report.

Re-display as WorkFlows
Sample metrics
  • From the ATS Navigator, select "My World".
  • Click the rightmost icon on the toolbar to bring up a context menu. Select Re-display as WorkFlows. * Click on the Metrics tab (at the bottom) to open the Metrics Page.
  • Set Estimated Release Date to two days from now.

Joe Smith will finish on time, as the estimate of remaining hours in his workflows is well within the remaining time to release; Kay Jones, on the other hand, won't make it. </br>

Peer Review Metrics

Out of the box, OSEE Review provides the "Generate Participation Report" which can be run for any OSEE user. This will show what peer reviews a user has done.

Other Attributes

As with all of OSEE, other attributes can be added to workflows to store any data necessary for other metrics and added to the Workflow Editor and World Editor.

Peer Review

Joe, a Code Developer, has realized that he needs a peer review for Analysis.

  • Add a Peer-To-Peer Review
    • Click on the Add Peer to Peer Review hyperlink, which can be found near the bottom of the page by "Analyze" State Reviews.
    • In the Add Peer to Peer Review dialog, select the "Analyze" state and click OK.
  • Add Reviewers
    • Click on the New Role icon (in the toolbar in the upper right of the Role pane, it is the leftmost icon) twice to add two new reviewers.
    • Set one of the roles to "Author" and the other to "Reviewer".
      • Edit the Role field by clicking on the field while pressing the ALT key.
  • Set Location to "That.java; This.java"
  • Set Blocking to "Transition"
  • Set Estimated Hours to "2"
  • Transition to "Review"

Tool Team Workflow

Joe realizes that the change will affect the Tools Team.

  • Select the "Actionable Items" hyperlink from the top of the SAW Code Workflow.
    • Select "Website" (under "Tools") from the Add Impacted Actionable Items dialog.
  • Workflows are created for the Website Team.

Back to the top