Stages Documentation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Last revisionBoth sides next revision
75:process_feedback_codebeamer [2021/03/19 16:28] – mnwm75:process_feedback_codebeamer [2021/03/22 12:42] – [CodeBeamer config.xml] prnr
Line 3: Line 3:
 First of all, create a CodeBeamer project where the feedback will be collected. If you want to collect more information than the summary and a description, you have to create a new tracker and add additional fields to it. Further information to creating and customizing trackers can be found at [[https://codebeamer.com/cb/wiki/23424|here]]. First of all, create a CodeBeamer project where the feedback will be collected. If you want to collect more information than the summary and a description, you have to create a new tracker and add additional fields to it. Further information to creating and customizing trackers can be found at [[https://codebeamer.com/cb/wiki/23424|here]].
  
-To configure Stages, the id of the target tracker is required. For custom fields, the customField ids are required. There are several ways to find them out, see below (under Configuration.xml - How to get the project, tracker and field id).+To configure Stages, the id of the target tracker is required. For custom fields, the customField ids are required. There are several ways to find them out (see below Configuration.xml - How to get the project, tracker and field id).
  
 Stages uses the CodeBeamer REST interface with Swagger V3 to create the trackerItem. [[https://codebeamer.com/cb/wiki/11631738|See here]] for more information. Stages uses the CodeBeamer REST interface with Swagger V3 to create the trackerItem. [[https://codebeamer.com/cb/wiki/11631738|See here]] for more information.
 +
  
 ===== CodeBeamer config.xml ===== ===== CodeBeamer config.xml =====
Line 21: Line 22:
       <property name="password" value="secret" />       <property name="password" value="secret" />
  
-      <!-- Define the tracker where the item should be created in --> +      <!-- Define the tracker (with the trackerId and the correspoinding keyName) where the item should be created in  --> 
-      <property name="trackerId" value="1234" /> +      <property name="trackerId" value="2267" /> 
-      <property name="keyName" value="ABC" />+      <property name="keyName" value="TASK" />
  
       <!-- The summary field will always be available and is automatically mapped to the CodeBeamer name field -->       <!-- The summary field will always be available and is automatically mapped to the CodeBeamer name field -->
Line 78: Line 79:
  
 The ''trackerId'' of the targeted tracker. The ''keyName'' (short name) of the targeted tracker. The ''trackerId'' of the targeted tracker. The ''keyName'' (short name) of the targeted tracker.
-==== Configuration.xml - Mandatory fields ====+==== Mandatory fields ====
  
-For all issues, the fields name and description are mandatory. Name is automatically configured and will display the summary text. Description has to be configured as followed:+For all issues, the fields name and description are mandatory. Name is automatically configured and will display the summary text. Description has to be configured in the configuration.xml as followed:
  
 <code xml> <code xml>
-<property name="user" value="user" /> +<attributes> 
-<property name="password" value="secret" />+        <!-- map the stages-description (ident) into the codebeamer-description (target) --> 
 +        <attribute ident="description" type="text" target="description" /> 
 +</attributes>
  
  
 </code> </code>
-==== Configuration.xml - How to get the project, tracker and field id ====+ 
 + 
 +==== How to get the project, tracker and field id ====
  
 === Version 1: Via REST commands === === Version 1: Via REST commands ===
Line 122: Line 127:
   * CustomFields: Base Number is 10000, add the displayed number to get the field id.   * CustomFields: Base Number is 10000, add the displayed number to get the field id.
   * ChoiceField: Base Number is 1000, add the displayed number to get the field id.   * ChoiceField: Base Number is 1000, add the displayed number to get the field id.
 +
  
 ==== Supported CodeBeamer Tracker Fields and Types ==== ==== Supported CodeBeamer Tracker Fields and Types ====