Differences

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

Link to this comparison view

Next revision
Previous revision
75:process_feedback_2 [2020/07/13 10:23] – created fnpk75:process_feedback_2 [2020/07/13 11:13] (current) – removed fnpk
Line 1: Line 1:
-====== Process feedback ====== 
- 
-With this feature, users are able to provide feedback directly while navigating through the process. The feedback is created as a Jira or PTC-ILM item and can be triaged, planned, and tracked within the system. Every generated item contains a link back to the original process element where the feedback was created, so full traceability of process change requests is assured. 
- 
-===== Configuration ===== 
- 
-Changes in the Stages ''config.xml'', metamodel and language properties are required. In general, this configuration looks like the following: 
-<code xml> 
-<?xml version="1.0" encoding="UTF-8" ?> 
-<stages-config> 
- 
-  <!-- Insert this block to your stages config.xml file --> 
- 
-  <feedback-system name=" jira || rtc || redmine || ptcilm "> 
- 
-      <host url="https://some.example.com/feedback-system"> 
- 
-      <!-- 
-       Properties are configuration parameters for the feedback system. 
-       Every feedback system defines its own parameter, which are 
-       e.g. - Username and password for authentication, 
-            - Project name etc. 
-       Properties are configured as key:value pairs as follows 
-      --> 
-      <property name="propertyName" value="propertyValue" /> 
- 
-      <!-- 
-       Attributes define the values, which are visible to the feedback-creator. 
-       Each attribute will be shown in form of a text-box in the feedback widget 
-       and will be sent to the feedback system once the user clicks on "save" in 
-       the Stages Application. 
-       The target attribute of each xml-attribute entry defines, where the values 
-       will be stored in the feedback system. 
-      --> 
-      <attributes> 
-        <attribute ident="description" type="text" target="MyDescriptionField" targetType="MyFieldType" /> 
-      </attributes> 
- 
-      <!-- 
-       System attribute mappings are similar to the attributes but are NOT 
-       visible in the Stages Application. The values for these attributes come 
-       directly from Stages. 
- 
-       Possible "source"-values are: 
-         - elementUrl e.g. https://stages.example.com/stages/index.html#/workspace/200/_vv/(process/activity/_wUV9sBbNHr-aicWx33VsQA) 
-         - workspaceName e.g. "Software Engineering" 
-         - workspacePath e.g. "Company | Software" 
-         - creatorFullname "John Doe" 
-         - creatorUsername "jdoe" 
-      --> 
-      <system-attribute-mappings> 
-        <attribute source="elementUrl" target="MyField" targetType="MyField" targetType="MyFieldType" /> 
-      </system-attribute-mappings> 
-    </host> 
-  </feedback-system> 
-</stages-config> 
- 
- 
-</code> 
- 
-==== Stages config ==== 
- 
-The changes in ''config.xml'' are system specific. Please refer the right manual page: 
- 
-   * [[:75:process_feedback_jira|Jira]] 
-  * [[:75:process_feedback_ptcilm|PTC-ILM]] 
-  * [[:75:process_feedback_redmine|Redmine]] 
-  * [[:75:process_feedback_rtc|Rational Team Concert / IBM Engineering Workflow Management]] 
- 
-==== Stages metamodel ==== 
- 
-The feedback widget must be added to your Stages metamodel. The XML-Element is: 
- 
-<code xml> 
-<widget:feedback/> 
- 
- 
-</code> 
- 
-For adding the widget to the social section, you can adopt it like this: 
- 
-<code xml> 
-<widget:definition id="social"> 
-    <layout:tabbed-card id="info"> 
-        <layout:tab id="feedback" translate="process.feedback"> 
-            <widget:feedback/> 
-        </layout:tab> 
-        <layout:tab id="comments" translate="process.comments"> 
-            <widget:comments/> 
-        </layout:tab> 
-        <layout:tab id="history" translate="process.history"> 
-            <widget:activity-stream translateNone="none" /> 
-        </layout:tab> 
-    </layout:tabbed-card> 
-</widget:definition> 
- 
- 
-</code> 
- 
-==== Stages language properties ==== 
- 
-As last step you have to provide translations for the introduced custom fields. The translation property consists of the prefix ''process.feedback.mapping.''  and the ident you defined in the config.xml file. For the example the translations are: 
- 
-<code properties> 
-process.feedback.mapping.summary = Summary 
-process.feedback.mapping.description = Description 
-process.feedback.mapping.annual_savings = Estimated annual savings 
-process.feedback.mapping.priority = Priority 
- 
- 
-</code> 
- 
-After all, don't forget to execute ''update.bat''  / ''update.sh''  and restart your Stages. 
-