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"

 
(51 intermediate revisions by 2 users not shown)
Line 1: Line 1:
= ATS - Action Tracking System =
+
# [[OSEE/ATS/Users Guide/Intro|Getting Started]]
The [http://www.eclipse.org/osee/documentation/overview/components.php#ats Action Tracking System (ATS)] is a tightly integrated change tracking system that manages changes throughout a product's lifecycle. ATS provides integrated change management to all OSEE applications through user customizable workflows.
+
# [[OSEE/ATS/Users Guide/Views|Views and Editors]]
 
+
# [[OSEE/ATS/Users Guide/Usage|Using ATS]]
== Configuring ATS ==
+
# [[OSEE/ATS/Users Guide/Tips|Tips and Tricks]]
 
+
# [[OSEE/ATS/Users Guide/New|What's New]]
=== Configuring ATS for Multi-Branch committing...===
+
 
+
Branch Configuration Attributes:<br>
+
'''ats.Allow Branch Create''' - activates ability to create working branches from parent<br>
+
'''ats.Allow Branch Commit''' - activates ability to commit working branches to parent<br>
+
'''ats.Parent Branch Id''' - set to the branch id of the branch to create/commit<br>
+
 
+
If [[ATS - Team Definition]] attribute "ats.Team Using Versions" == false, then ATS uses branch configuration attributes from Team Definition.
+
 
+
Else If [[ATS - Team Definition]] attribute "ats.Team Using Versions" == true, then ATS uses branch configuration attributes from targeted [[ATS - Version Artifact]].  This means that the [[ATS - Team Workflow]] must be targeted to a version before branching can occur
+
 
+
=== Configuring ATS for Change Tracking ===
+
 
+
The Action Tracking System (ATS) can be configured for tracking changes made to such things as requirements, software, hardware and facilities.<br><br>
+
 
+
The integrated nature of ATS also allows for the tight configuration management of changes to the artifacts that are stored and managed
+
in OSEE, such as requirements, and provides advanced features that allow for advanced workflow management of these items.<br><br>
+
 
+
OSEE ATS provides a few levels of configuration, from the simple/dynamic configuration that can be created/modified during runtime
+
to a more advanced configuration that requires a separate plugin and release/update.</p>
+
 
+
<ol>
+
  <li>Create a New configuration using the ATS Configuration Wizard</li>
+
  <ol type="lower-alpha">
+
      <li>Select File -> New -> Other -> OSEE ATS -> ATS Configuration</li>
+
      <li>Enter in a unique namespace for your configuration (eg: org.company.code)</li>
+
      <li>Enter in a name for the Team that will be performing the work (eg: Code Team)</li>
+
      <li>Enter in a list of Actionable Items that you want the users to write change requests against. (eg: Editor, Installer, Website)</li>
+
      <li>If Actions are to be grouped and released in versions (or builds), enter a list of versions. (eg: 1.0.0, 1.1.0, 1.2.0)  Otherwise,
+
      this field may be left blank.</li>
+
      <li>If an existing workflow (eg: osee.ats.teamWorkflow) is to be used, enter this as the id.  Otherwise a new workflow will be created.</li>
+
      <li>Upon Selecting Finish, ATS will be configured with the entered information.  You can then select to create a new Action and select
+
      one of the Actionable Items (named above).  This will create a new workflow and assign it to the above Team for processing.</li>
+
      <li>See <a href="../ats/ATS.htm#section8.1">Configure ATS for Change Tracking</a> for more information.</li>
+
  </ol>
+
  <li>Creating a New workflow configuration for existing Team / Actionable Items using the ATS Workflow Configuration Editor</li>
+
  <ol type="lower-alpha">
+
      <li>Select File -> New -> Other -> OSEE ATS -> ATS Workflow Configuration</li>
+
      <li>Enter in a unique namespace for your configuration (eg: org.company.code)</li>
+
      <li>Upon Selecting Finish, ATS will create a simple workflow that can be expanded with new states, transitions and widgets.</li>
+
      <li>This workflow will need to be related to the Team Definition that will use it. 
+
      See <a href="../ats/ATS.htm#section8.1">Configure ATS for Change Tracking</a> for more information.</li>
+
  </ol>
+
  <li>Editing an existing workflow configuration using the ATS Workflow Configuration Editor</li>
+
  <ol type="lower-alpha">
+
      <li>In the Branch Manager, set the Default Working Branch to the Common branh.</li>
+
      <li>In the Artifact Explorer, expand Action Tracking System -> Work Flows and select the workflow to edit.  This will
+
      open the ATS Workflow Configuration Editor.</li>
+
      <li>Workflow can be edited to include new states and transitions.  Double-click state to relate widgets and rules.</li>
+
      <li>Selecting Save will validate the workflow and save the changes to the database.  These changes can be used immediately by Team Definitions
+
      configured to use this workflow.</li>
+
      <li>See <a href="../ats/ATS.htm#section8.1">Configure ATS for Change Tracking</a> for more information.</li>
+
  </ol>
+
  <li>Advanced ATS Configuration via the org.eclipse.osee.ats.config.demo - Although ATS can be configured dynamically in a runtime environment,
+
  advanced configuration, like creating new widgets and rules, can be done through extension points. 
+
  The ats.config.demo plugin is an example of these capabilities.</li>
+
</ol>
+

Latest revision as of 14:15, 16 June 2009

  1. Getting Started
  2. Views and Editors
  3. Using ATS
  4. Tips and Tricks
  5. What's New

Back to the top