Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
maxLevel1

Overview

You can configure configure Jtest  DTP DTP Engine to collect authorship data during analysis to facilitate task assignment. The data can be sent to the DTP server where additional analysis components, such as the Process Intelligence Engine (PIE), can be leveraged to facilitate defect remediation and development optimization. 

You can configure configure Jtest  to to assign authorship based on information from source control, XML files that directly map sources to authors, and/or the current local user. 

Conditional Content
product: (jtest)
product: (jtest)
sv-attr:0A01020401598D973E6641760F8AF4E50A01020401598D973E671AAA268425A3

You can also use the @author Javadoc tag. 

About Authorship Configuration Priority

Authorship priority is determined by reading the settings in the .properties configuration file from top to bottom. If multiple authorship sources are used, the following order of precedence is used:

Conditional Content
product: (jtest)
product: (jtest)
sv-attr:0A01020401598D973E6641760F8AF4E50A01020401598D973E671AAA268425A3
  1. information from source control 
  2. XML map file
  3. @author tags 
  4. current user 

If one of the selected options does not determine an author 

Conditional Content
product: (jtest)
product: (jtest)
sv-attr:0A01020401598D973E6641760F8AF4E50A01020401598D973E671AAA268425A3

(for instance, the @author tag was selected but the file does not have an @author tag)

, authorship will be determined based on the next option selected. If an author cannot be determined, the user is set as "unknown". Likewise, if none of these options is selected, the user is set as "unknown."

...

Code Block
scope.local=[true or false]
scope.scontrol=[true or false]
scope.xmlmap=[true or false]
Conditional Content
product: (jtest)
product: (jtest)
sv-attr:0A01020401598D973E6641760F8AF4E50A01020401598D973E671AAA268425A3
Code Block
scope.local=[true or false]
scope.scontrol=[true or false]
scope.xmlmap=[true or false]
scope.javadoc=[true or false]

Additional Authorship Configurations

...

Code Block
authors.shared.path=[path to file]

Anchor
CreatingAuthorshipXMLMapFiles
CreatingAuthorshipXMLMapFiles
Creating Authorship XML Map Files

The <authorship> element contains indicates the beginning of the mapping information.

...

Code Block
<?xml version="1.0" encoding="UTF-8" ?>
  <!DOCTYPE authorship (View Source for full doctype...)> 
    <authorship>
      <!-- assigns all files named: "foo/src/SomeClass.java" to "author1" --> 
      <file author="author1" path="foo/src/SomeClass.java" />
Wildcard ExpressionDescription
Conditional Content
product: (jtest)
product: (jtest)
sv-attr:0A01020401598D973E6641760F8AF4E50A01020401598D973E671AAA268425A3

?oo/src/SomeClass.java

Assigns all files that have names starting with any character (except /) and ends with "oo/src/"
**.csAssigns all *.cs files in any directory
**/src/**Assigns every file whose path has a folder named "src"
src/**Assigns all files located in directory "src"
src/**/Test*Assigns all files in directory "src" whose name starts with "Test" (e.g., "src/some/other/dir/TestFile.c")
Info
titleThe mapping order matters!

The mapping file is read from top to bottom, so beginning with the most specific mapping ensures that authorship will map to the correct files.