Information Technology Support
Page tree

Overview

There are a number of ways to integrate forms into Orange Tracker (OT) in order to submit issue tickets. Using forms to submit issues in your OT project can help you customize the data being sent from your customers. This can produce a uniform issue with the required data that your team needs to complete the task. This document will outline the tools and general process for setting up a form to submit into OT.

If you need further assistance in setting up any of these processes for your OT project, please let us know at aascsys@syr.edu

Form Tools

Frevvo

Frevvo has the ability to email the form to your Orange Tracker project. By using your OT project's email address, the form can create an issue ticket for your team.

At the top of the form there is a book icon: A picture of the book icon is shown This icon controls what happens to the form data. Click this in order click on the "Email data to a specified address".

An Email Submission window will be displayed. Please enter your project email address into the To: field.

Also, if you capture the netid or email address for the user, you can use it in the From: field. This allows OT to use this data and make that user the Reporter of the issue, eliminating your OT Consultants to choose the Reporter once the issue is created.

A screenshot of the setting where the email can be set is shown

The next screen will allow you to edit the Subject and Message of the email being sent. You can enter any form data you capture by using {itemName}. For example, if you have a checkbox item named "chkboxDevices", you may use {chkboxDevices} in your Message window to display the value/s the user selected.

Once complete, select the Finish button to finish the setup.

Qualtrics

Qualtrics has the ability to email the form to your Orange Tracker project. Qualtrics also can utilize Orange Tracker's API calls to create an issue. The API allows you to be more custom with creating the issue. Assigning the issue, adding attachments, and selecting components are just a few items you can do with the API.

Email

Using the Tools pull-down and select Triggers, and Email Triggers.

A screenshot of the customizable Qualtrics email form is shown

Enter in the OT project email address into the To Email Address: field.

If you capture the netid or email address for the user, you can use it in the Reply-To Email: field. This allows OT to use this data and make that user the Reporter of the issue.

You can add any data from Qualtrics into the Message of the email, including the question asked and the answers selected by the user.

API

API calls use Orange Tracker's built-in functions to create a ticket. This function allows issues to be created with additional fields, like components and custom fields.

Within Qualtrics, a Web Service is created to make the API call to Orange Tracker. This is typically done after the End of Survey block. A service account must be set up with the Orange Tracker team to use for this form.

You'll need to use an URL to Orange Tracker and the service account.

Body parameters will need to be formatted correctly.


Outside of the Components field, these are the required fields in order to create an issue.

This API function also allows creating an SSO Authentication to capture the username, first name, last name, and email address from the user's Shibboleth account. This allows the form to capture user information and auto-populate fields instead of asking the user for their username, when the SSO already has it.

In order to use this API functions, you'll need to contact ITS at aascsys@syr.edu. We will help set up these features within your form and ensure the information is set up.


Issue Collector

Issue Collectors are built into Orange Tracker and allow the form to be used in Answers or your department web page. Issue Collectors use your projects create screen as a form to create the issue. Custom fields are available as well. Issue Collectors can automatically capture the user as well so user information does not need to be entered.

A screenshot of the issue collector setup fields are shown

Issue Collectors are typically used within Answers pages but can also be used within a webpage.

To set up an Issue Collector, please contact ITS at aascsys@syr.edu