Information Technology Support
Page tree

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.

Creating an 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:

Add issue collector

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:

  • Always use Issue Reporter — Select this option to ensure that the default issue reporter you specify above, will always be the reporter of issues created by submission of the form.
  • Attempt to match user session of submitter or submitter email address — select this option if you want the reporter of an issue created by submission of the form.

Collect Browser Info: Select this option to collect meta-information about your browser's statistics, which will be incorporated into issue submitted.

Trigger

Trigger Text: (required) This field is not used and will not appear on your form.

Trigger Style: Select Custom

Issue collector form

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.

Display the Issue Collector

There are a few ways to display the issue collector.

Display an Issue Collector in Answers

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:

  • Browser URL: https://ot.syr.edu/secure/ViewCollector!default.jspa?projectKey=AASCSYS&collectorId=a0c45db9
  • Embedded HTML code: collectorId=a0c45db9

Populate Logged in User: Prefills the Name and Email fields with the identity of the logged in user from Answers

Default Summary:

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

  • Primary - Colored button
  • Secondary - Outlined button with colored link
  • Subtle - No outline button until hovered with colored link

Button AlignmentLeft, center or right. Default is Left

Environment Variable is a function:

Display an Issue Collector in a Web Page

The project issue collector will supply you with a code snippet that you can add into your web page to add the issue collector.

  • No labels