In order to use an Issue Collector, the collector has to be created and then displayed. First, the actual issue collector that is created within your Orange Tracker project. Second, the issue collector macro that displays the issue collector. This is typically in an Answers page, but an issue collector can be displayed on a web page, or anywhere HTML code can be created. This document will outline the process for creating an issue collector and a few ways on displaying the issue collector.
Project Managers of the Orange Tracker project can create an issue collector.
Once you are in the project you want the issue collector created, select the 'gears' icon to enter the Project Settings
On the left-hand side you'll find a navigation bar, scroll down until you find 'Issue Collectors' and select that link
The following page will display all current issue collectors for that OT project.
At the top right-hand side of the screen, you'll see an 'Add issue collector' button. Click that button to create a new one.
Enter in the following information:
Name: (required) This is the name of the issue collector and this field will not appear in the actual form.
Description: Please enter the main propose of the issue collector and if available, the location page using the issue collector.
Issue Type: (required) Please select the available issue type that will be used when an issue is created from the issue collector. Typically, Service Request is used.
Reporter: (required) Specify the username that will be the default reporter of the issue created. This user must be in the Users role of your OT project to submit the issue.
Match Reporter: Select either of the following:
Collect Browser Info: Select this option to collect meta-information about your browser's statistics, which will be incorporated into issue submitted.
Trigger Text: (required) This field is not used and will not appear on your form.
Trigger Style: Select Custom
Template: Select Custom
Custom fields: Select the fields you want available for the form
Message: Type a message, which appears in the blue information panel along the top of the dialog box.
There are a few ways to display the issue collector.
We have created a macro for quickly deploying an issue collector in your Answers page. When editing the Answers page the the 'Jira Issue Collector Button' macro.
Server URL: Default is 'ot.syr.edu'
Collector ID: Found in the URL of the collector or in the embed HTML code. Eight alpha-numeric, for example:
Populate Logged in User: Prefills the Name and Email fields with the identity of the logged in user from Answers
Append Username to End of Summary:
Get Ticket From Query String:
Ticket Custom Field Name:
Additional Default Field Values:
Button Text: Customize the button text
Button Type: Primary, Secondary, or Subtle. Default is Primary
Button Alignment: Left, center or right. Default is Left
Environment Variable is a function:
The project issue collector will supply you with a code snippet that you can add into your web page to add the issue collector.