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/ATS/Users Guide/Views"

(ATS Operations)
Line 38: Line 38:
 
Select [[Image:email.gif]] to email the ATS Results to an OSEE user
 
Select [[Image:email.gif]] to email the ATS Results to an OSEE user
  
Select [[Image:export.gif]] to export the ATS Results to CSV file
+
Select [[Image:Export_table.gif]] to export the ATS Results to CSV file
  
 
Select [[Image:bug.gif]] to report a bug.
 
Select [[Image:bug.gif]] to report a bug.

Revision as of 16:18, 9 September 2009

Contents

ATS Icons

ATS Objects

Action.gif denotes an Action, the top level object in ATS

Workflow.gif denotes a Team Workflow; moves team through completion of change

Task.gif denotes a Task; lightweight workflow that is performed during Team Workflow states

Version.gif denotes the ATS targeted for release version

R.gif denotes the ATS review

ATS Overlays

Warn.gif warning that something needs to be addressed; open object for more information

OrangeR 8 8.gif released version

YellowN 8 8.gif next release version

Favorite.gif ATS object marked as user's favorite; select "My Favorites" to load all marked

Subscribed.gif ATS object user desires to receive email upon every state transition

WhiteT 8 8.gif ATS object is obtaining estimated hours, percent complete, hours spent and remaining hours from tasks

ATS Operations

Select NewAction.gif to create a new action

Select NewTask.gif to create a new task

Select Refresh.gif to refresh current view

Select Print.gif to print the ATS Results

Select Email.gif to email the ATS Results to an OSEE user

Select Export table.gif to export the ATS Results to CSV file

Select Bug.gif to report a bug.

ATS Configuration

Team.gif denotes a team configured to do work in ATS

AI.gif denotes an Actionable Item that a user can create an Action against

ATS Navigator

Ats navigator.jpg

Purpose

Central location to launch ATS searches, perform quick navigation and kickoff metrics.

How to do it

Double-click any navigation item to kickoff the corresponding search, action, report.

Filter

Filter out all navigation items that contains the entered text. Select the clear action (Clear.gif) to clear out the text and restore all navigation items.

ATS Action View

Ats action view.jpg

Purpose

Shows a graphical representation of the currently open Action or Team Workflow.

How to do it

Double-click open any Action or Team Workflow. Action View will show parent child relationship between Action and it's children Team workflows. Cyan outline show currently

open editor.

ToolTip

Hover over any object to determine information about current state, assignees and work to be done.

Double-Click / Right-Click

Double-Click to open any object in the ATS Editor or right click for more options.

ATS World View

Ats world view.jpg

Purpose

Shows ATS workflow objects including Actions, Team Workflows, Tasks and Reviews that were returned from a search normally performed by the ATS Navigator.

How to do it

Double-click search item from ATS Navigator. ATS World will show that it is loading. Upon return, ATS World will contain all ATS objects from the search. In addition, a plus is shown next to any object. Upon selection, viewer will expand to show all children of the selected object.

Open ATS Action, Team Workflow, Task or Review

Double-click to open any item open in ATS Workflow Editor.

Sorting

Selecting column headers will sort that column. Holding down Ctrl and selecting successive columns will enable multisort. Re-selecting a column will reverse sort that column. The status label at the bottom will show the columns being sorted and which direction the sort is being performed. To remove all sorting, right-click and select "Remove All Sorting".

Bottom Status Line

The bottom status line will show the total number of objects loaded into the table, the total shown and the total selected. It will also show all the sorts and filters that are enabled.

Top Status Line

The top status line will show the name of the search that populated the ATS World View. A warning icon (Warn.gif) will show if the search returned no objects to show.

Filtering

Bottom right of the ATS World shows a filter box that is a quick way to filter by one or two words. Simply type in a string, press enter and ATS World will only show those loaded objects that where one of the visible cells contains the typed text. This is a case insensitive search. Select the clear action (Clear.gif) to clear out the text and restore all loaded actions.

Actions

Select A.gif to load ATS World with all the actions that you have work to do on.

Select Action.gif to create a new Action.

Select Rank.gif to rank actions by deadline date then by priority and annual cost avoidance.

Select Refresh.gif to refresh the current search.

Select Customize.gif to Customize Table.

Select Bug.gif to Report a Bug.

Result View

Result view.jpg

Purpose

Show reports, errors, metrics and other data in a multi-paged view with print, email and exporting capabilities.

How to do it

This view pops up automatically when OSEE needs to report larger amounts of data to the user.

Actions

Select Print.gif to print the current window. Select Email.gif to email the current results view to an OSEE user. Select Export.gif to export the current table into a comma separated value file.

Mulit-page

Selecting the down arrow will show a list of all pages that have been displayed during the current instance of OSEE running. Selecting from this list will display the previous page.

ATS Workflow Editor

Ats workflow editor workflow tab.jpg

Purpose

Show and edit the workflows configured for use in ATS including Team Workflows, Tasks and Reviews.

How to do it

Double-click open any Action or Team Workflow from ATS World, Search results or ATS Results. The editor will be opened allowing view and edit of workflow.

Workflow Tab

Shows states of workflow, alows entry in current state and provides services to perform actions, see metrics and research information about workflow.

Task Tab

Shows tasks associated with states of workflow. Allows quick editing of task information and allows a quick jump (double-click) to open task in ATS Workflow Editor.

ATS Workflow Editor - Workflow Tab

Ats workflow editor workflow tab.jpg

Purpose

Shows states of workflow, alows entry in current state and provides services to perform actions, see metrics and research information about workflow.

How to do it

Default tab shown when any ATS object is opened in the ATS Editor.

Current State

Shown in the top status bar and in the main window, the current state is the state of the workflow state machine that is running for this ATS object. These workflows can be configured with 3 or 30 state depending on the needs of the program/team that is using it.

Other States

Shows states of workflow, alows entry in current state and provides services to perform actions, see metrics and research information about workflow.

Services

Shows tasks associated with states of workflow. Allows quick editing of task information and allows a quick jump (double-click) to open task in ATS Workflow Editor.

ATS Workflow Editor - Task Tab

Ats workflow editor task tab.jpg

Purpose

Shows tasks associated with states of workflow. Allows quick editing of task information and allows a quick jump (double-click) to open task in ATS Workflow Editor.

How to do it

Select task tab after ATS object is opened in the ATS Editor.

Open Task

Double-click on any task to open in ATS Editor.

Right-click edit

Selecting one or more tasks and right-click produces a menu with selections for editing multiple tasks at a single time.

Alt-Left-Click edit

A quick way to edit a single field in a task is by holding the Alt key down and selecting the cell to edit. This pops up an editor associated with the type of cell selected.

Actions

Select CurrentState.gif to only show tasks related to the current state of the workflow.

Select NewTask.gif to create a new task.

Select RedRemove.gif to delete selected task.

Select Refresh.gif to refresh the current task list.

Select Customize.gif to Customize Table.

Working Branch Widget

This widget allows creation and manipulation of the working branch configured in a Team Workflow. The following options can be performed using this widget.

WorkingBranchWidget.GIF

  1. Working Branch to be created by selecting the "Create Working Branch" icon
  2. Working Branch artifacts to be edited by selecting the "Open in Artifact Explorer" icon
  3. Review of changes on Working Branch by selecting the "Open Change Report" icon
  4. Working Branch to be deleted by selecting the "Delete Working Branch" icon

Commit Manager Widget

This widget allows commit for Working Branch configured in a Team Workflow. The following options can be performed using this widget.

CommitManagerWidget.GIF

Double-click to perform action listed. These include:

  1. Commit Branch allows working branch changes to be committed to the configured branch or branches
  2. Merge Conflicts and Commit allows changes that conflict to be merged and then committed
  3. Show Change Report shows the changes associated with the Working Branch and Merges

ATS Workflow Configuration Editor

ConfigEditor.JPG

Purpose

Give a graphical method to creating / updating ATS Workflow Configurations. This editor also gives easy access, through double-click" to edit the "Work Page Definition" artifact that represent the selected state.

How to do it

  • Open editor for a specific workflow:
  • Existing Work Flow Definition Artifact: From Common branch in Artifact Explorer, expand Action Tracking System -> Work Flows and double-click the workflow you wish to edit.
  • From ATS Workflow Editor: Select workflow icon at top right and associated workflow will be opened.
  • New Workflow Configuration: File -> New -> Other -> OSEE ATS -> Workflow Configuration; enter unique namespace for this workflow configuration. (eg: org.<company>.code). This creates a simple workflow to use as a starting place.
  • Create states:
    • Add necessary states to diagram to represent workflow. Note: Only one state is the entry point and the workflow must end at the "Completed" state. The "Cancelled" state is optional, but should be used in most cases.
  • Editing Rules, Widgets and other State attributes: Double-click on any state to open the Artifact in the Artifact Editor.
  • Create transitions:
    • For each state, a single "Default Transition" must be specified. This will be the default state specified as the "next" state in the workflow. Optional transitions to other states can be specified by the "Transition" arrow. The user will have the option of selecting one of these states instead.
    • The "Return Transition" can be specified for valid jumps "back" to previous states. (For example, the user may need to transition back to the "Analyze" state from the "Authorize" state if authorization failed and more analysis is needed.
  • Select a single state and set it's "Start Page" property to "Yes" for the state specified to start the workflow. Only one state can be the start state.
  • Save and test the new workflow configuration:
    • Select Save to persist the changes. Validation will be automatically run (see below)
    • Configure the Team Definition to use the new workflow
    • Create a new Action and test the created workflow

Workflow Configuration - Validation

Validation of a workflow is provided by selecting the check icon and selecting a state, transition or the entire workflow (selecting the white background). This will popup whatever error occurs or a "Validation Success" if all is ok. Note that this same validation will occur during save and will fail if all problems are not resolved.

Work Flow Definition Artifact

Purpose

The Work Flow Definition artifact specifies the workflow that a team moves through to complete an Action. This artifact specifies the states, their transitions and the start state of the workflow. Creation/Editing of this artifact can either be done through the Artifact Editor or using the Workflow Configuration Editor (OSEE 0.6.0 Release and beyond).

How to do it - Configuration Editor

How to do it - Artifact Editor

On the Common branch in the Artifact Editor, Expand "Action Tracking System" and right-click on "Work Flows", select New Child -> Work Flow Definition. Enter a unique namespace name for this workflow (eg: org.<company>.code). In the Artifact Editor, add and set the attributes and relations as below.

  • Attributes
    • Name:[unique namespace, usually the same as the Work Id specified below]
    • osee.wi.Work Id:[unique workflow namespace] - this will preceed each state name specified in the workflow.
    • osee.wi.Parent Work Id:[Work Id of Parent Work Flow Definition] - this will allow this workflow to inherit it's transitions and start state from another workflow. This can not be used with other attributes below
    • osee.wi.Start Page:[namespace.state name] - this specifies the name of the initial state in the workflow
    • osee.wi.Transition:[[from state name];[transition type];[to state name]] - specifies the transition from state to state where
      • [from state name]/[to state name]- unique Work Page Definition Work Id comprised of [namespace].[State Name]
      • [transition type] - one of the following:
        • ToPageAsDefault - Transition is "Default Transition" state
        • ToPage - Transition is optional transition to state
        • ToPageAsReturn - Optional transition to a previously visited state
    • osee.wi.Description:Optional attribute to add description of workflow
  • Relations
    • Work Item.Parent: Relate to any Team Definition configured to use this workflow.

Work Page Definition Artifact

Purpose

The Work Page Definition artifact configures a single state of the Workflow Configuration.

How to do it - ATS Workflow Configuration Editor

The ATS Workflow Configuration Editor will allow the editing of the three main fields of a Work Page Definition Artifact. The remaining fields, and the relations to Work Rules and Work Widgets must be done through the Artifact Editor.

How to do it - Artifact Editor

Work Page Definitions are either stored as children of their Work Flow Definition artifact or under the "Work Pages" folder.

On the Common branch in the Artifact Editor, Expand "Action Tracking System" and right-click on "Work Page", select New Child -> Work Page Definition, or double-click an existing Work Page Definition artifact. Edit the following attributes and relations accordingly.

  • Attributes
    • Name:[unique name matching Work Id below]
    • osee.wi.Work Id:[unique workflow namespace].[Work Page Name] as below.
    • osee.wi.Parent Work Id:[Work Id of Parent Work Page Definition] - this will allow this workflow to inherit it's widgets and rules from another workflow. This can not be used with other attributes below
    • osee.wi.Work Page Name:State Name that the user will see. This can not have any special characters including . in the name.
  • Relations
    • Work Item.Child: Relate to any Rules or Widgets that this state is made of.

Work Rule Widget Artifact

Purpose

The Work Widget Definition artifact specifies a single widget, via xml, that will be displayed on the state page in the ATS Workflow Editor.

How to do it - Artifact Editor

On the Common branch in the Artifact Editor, Expand "Action Tracking System" expand "Work Widget" and double-click any existing Work Widget. Edit the following attributes and relations accordingly.

  • Attributes
    • Name:[unique name matching Work Id below]
    • osee.wi.Work Id:[unique id]
    • osee.wi.Work Description:Simple description explaining what widget is.
    • osee.wi.Work Data: XWidget=[XWidget xml specifying widget]
  • Relations
    • Work Item.Parent: Relate to any Team Definition or Work Page Definition artifacts as appropriate.

Work Rule Definition Artifact

Purpose

The Work Rule Definition artifact specifies a single rule that can be applied to workflow configurations or to Team Definition artifacts. These rules are normally backed by Java code that performs certain tasks like automatically creating new reviews, assigning workflows to specific users or specifying states as allowing create/commit of branches.

How to do it - Artifact Editor

On the Common branch in the Artifact Editor, Expand "Action Tracking System" expand "Work Rule" and double-click any existing Work Rule. Edit the following attributes and relations accordingly.

  • Attributes
    • Name:[unique name matching Work Id below]
    • osee.wi.Work Id:[unique workflow namespace].[Work Page Name] as below.
    • osee.wi.Work Description:Simple description explaining what rule does.
    • osee.wi.Work Data:Key/Value pares of information used by rule.
  • Relations
    • Work Item.Parent: Relate to any Team Definition or Work Page Definition artifacts as appropriate.

Mass Artifact Editor

Purpose

The Mass Artifact Editor allows the easy view of multiple artifact along with their attributes. This editor can be viewed from right-click off Artifact Explorer, Search Results page, or via ATS action. Single cells can be edited via Alt-Left-Mouse-Click. After editing any number of artifacts shown, the save button persists this data.

Note: This editor will close upon switch of default branch unless the editor is tied to the common branch.

Actions

Select Refresh.gif to refresh the contents.

Select Customize.gif to Customize Table.

Select Bug.gif to Report a Bug.

Table Customization

Purpose

Customize the table to show desired columns, widths with specified sorting and filters. Enables loading of both personal and global customizations and provides the ability to select a customization as the default customization to be loaded upon startup.

Select Customization

Lists current personal and global customizations to be selected from. Double-click to automatically load selected customizationa and close dialog.

  • "-- Table Default --" - Show the default customization for this table.
  • "-- Current --" - Show the current customization as set from table alterations.
  • "Other" - Shows a stored customization available for loading.

Select Customization - Icons / Overlays

  • Customize.gif Customization.
  • CustomizeD.gif Default customization loaded up restart.
  • CustomizeG.gif Global customization available to all users.

Select Customization - Buttons

  • Load - Loads the currently selected customization.
  • Load+Close - Loads the selected customization and closes the dialog.
  • Set as Default - Sets the currently selected customization as the default to load upon restart.
  • Delete - Deletes the currently selected customization.

Configure Customization

Allows for the selected customization to be configured, loaded and saved.

  • Hidden Columns - Shows the columns that are available to be displays but configured as hidden.
  • Visible Columns - Show the columns that are configured to be displayed for this customization.
  • (x) - shows the currently configured width of the column
  • Sorter - xml representation of the column order to sort by
  • Text Filter - shows the configured text filter to be applied for this customization. Enter as string.

Configure Customization - Buttons

  • Load - Loads the configured customization.
  • Load+Close - Loads the configured customization and closes the dialog.
  • Rename - Allows the user to define an alternate name for the column.
  • Save - Saves the configured customization as personal or global (if permissions allow).

Back to the top