The link feedback is a generic adapter for feedback system with issue collector functionality. The Stages user is redirected via special Link to the feedback system. The user will typically see a form to create the issue. Some fields in this form will be filled out beforehand by Stages.
To enable the following configuration section must be added in the conf/config.xml
:
<stages-config> <!-- Insert this block to your stages config.xml file --> <feedback-systems> <feedback-system name="link"> <host url="https://collector.example.com/CreateIssue?project=%{project}&issuetype=%{issuetype}&issueCreator=%{reporter}&returnUrl=%{url}" ident="link1" displayName="Example Link"> <property name="project" value="DefaultProject" /> <property name="issuetype" value="Feedback" /> <system-attribute-mappings> <attribute source="creatorUsername" target="reporter" /> <attribute source="elementUrl" target="url" /> </system-attribute-mappings> </host> </feedback-system> </feedback-systems> </stages-config>
Stages will take the url
value from the host
configuration and will replace the variables. In the example above the variables are:
%{project}
%{issuetype}
%{reporter}
%{url}
As you can see: The first two variables will be replaced with values from properties. The last two variables will be replaced with values from system-attribute-mappings
.
The letter &
in the URL must be replaced by &
in the xml file.
With the configured URL
https://collector.example.com/CreateIssue?issueCreator=%{reporter}&project=example
and the system attribute mapping
<system-attribute-mappings> <attribute source="creatorUsername" target="reporter" /> </system-attribute-mappings>
Stages will lead the stages user “JohnDoe” to the site
https://collector.example.com/CreateIssue?issueCreator=JohnDoe&project=example
targetType
(Default): The value will be URL-EncodedtargetType=“raw”
): The value will not be encoded. This is unsafe but can be useful in some edge cases.