Community
Thumb_plugin

Workflow Function: Linked Work Items Set Field

 Set fields in linked Work Items under specific conditions. This allows you for example to delegate status information to parent items.Example: an implementation task is changed to "done" and as result a custom field in the linked requirement will be set to "implemented". In that way you can see on high level items the status of related tasks.

Description

The workflow plugin allows you to automatically set string or enum fields of linked Work Items. It can copy enum values to the linked Work Item.  You can define that a field is set only if a specific condition is met (value of other string/enum fields)
Scenario: If a subtask of type implementation is closed set a custom field like implementation status: of the parent Requirement to implemented  (states of subitems can be made visible in parent. Child tasks can be closed in any order).

Attributes which can be set

 

Attribute name Description Example Allowed values required
setStringField Set value of defined string field in linked workitem
First entry = field name
Second entry =field value
setStringField =implementationStatus,implemented any string No
FieldHasValue Condition: Only if field has specific value perform a setValue or copy operation fieldHasValue =implementation Any string, if you check an enumeration field you should use enum.id No
onlyForTheseItemTypes Function is only performed for listed item types onlyForTheseItemTypes =task,requirement work item types defined in project (e.g. requirement, task …).  You must specify the work item id. No
copyEnumValueTo Copy enum value from current item to linked item in specified field.
First entry = fromfield (selected WI)
Second entry =tofield (linked WI)
copyEnumValueTo=resolution,resolution Works for enum fields only No
link.roles or
 back.link.roles
Process only linked items of that type
Process only backlinked items of that type
link.roles=parent
or
Back.link.roles=parent
Valid link types in configuration Yes

 

Example Scenario

When child task of type implementation is closed copy resolution field value into requirement field implementation
Example scenario will only work when you have created a custom field for task with name tasktype and a corresponding enumeration.

This can be done in task-custom-fields.xml.

<?xml version="1.0" encoding="UTF-8"?>
<fields>
   <field id="tasktype" type="enum:tasktype" name="Task Type" description=""/>
 </fields>

And tasktype-enum.xml
<?xml version="1.0" encoding="UTF-8"?>
<enumeration>
   <option id="implementation" name="Implementation"  sortOrder="1"/>
   <option id="testspec" name="Test Specification" sortOrder="2"/>
   <option id="userdoc" name="User Documentation" sortOrder="3"/>
   <option id="analysis" name="Analysis" sortOrder="4"/>
</enumeration>

 

Installation

Copy the jar file into Polarion/polarion/plugins directory and restart Polarion.

The function appears in the list when you configure the workflow functions for your workflow action.

Information

Vendor Tim Pence (Siemens PLM)
Published Version 1.0.7 - January 2014
Categories
Products
Price Free
273 Downloads
Community Supported Extension This extension is not supported by Siemens PLM.
Requirements Polarion ALM or Polarion Requirements server.