Restful integrations for Jira.

Welcome to the world of integrations!

With RINT, RESTful integrations for Jira, you can easily create no-code automated REST-integrations to extend and integrate with Jira.

Since RINT integrations can be triggered from either an issue event, scheduled job or (coming soon) a post function the possibilities are endless. RINT REST Request actions can also be chained, using the response from the previous RINT REST request action as input for the chained integration(s).

Getting started

Getting started is easy. Once installed, the RINT user interface is available for the administrator at the add-ons page. (Cog → add-ons)

Click the REST-integrations link underneath the RESTFUL INTEGRATOR section to get started.

User interface

Create a new RINT REST Request action by clicking the "CREATE" button

The user interface has 3 sections; Configuration, Triggers, and Execution Log.

Configuration

In this section, you will set up most of the RINT configuration.

Setting	Explanation
NAME	Name of the RINT integration
Parent action	Specify a parent RINT Integration. Makes this integration a child to the parent. A child will be executed after successful execution of the parent.
Method	HTTP Method
Url	Target endpoint URL
Authentication Method	Currently supported auth. methods. Basic Auth Bearer token Parent - Uses the same authentication as the parent integration Only applicable for child integrations.
Headers	Specifies the request headers required for the target endpoint.
Description	Generic description of what this integration does.
Body	REST body for the RINT integration REST request
Variables	Variables are only available for child integrations. This allows you to specify variables based on the parent REST response. Variables are configured by using JSONPath expressions. Read more about this in the chapter "Defining variables" All variables defined will be available in the variable scope that can be used when defining the urls, headers and body. Read more of this in the chapter "Using variables"

Triggers

You must specify a trigger for your RINT integration in order to wake up the integration.

There are two kinds of triggers for your application:

Issue events

Select the Jira issue event types that you wish your RINT integration to trigger on

Optional: Specify a JQL condition that must evaluate in order for your RINT integration to trigger

Scheduled jobs

Specify a Cron expression that will trigger your integration. Cron expressions are of Quartz format. Hint: Use an online cron maker, ie: http://www.cronmaker.com/

Optional. Specify a JQL context scope for the RINT integration to work on.

Post functions

Coming soon. Post function triggers are currently not supported.

Enable integration

New RINT integrations will be enabled by default. If you wish to disable an integration this can be done in the Triggers section.

NOTE

Child integrations are always triggered by the parent application and cannot have a trigger defined.

Execution log

Once a RINT integration has been executed you will find the output in the execution log section. This is useful for debugging/monitoring for an application.

Testing an action

Testing an action is easy. Make sure the action is saved, then click the "Test" button.

Enter an issue key for your RINT integration action scope if the action(s) require an issue to work upon. Ie. if there are variable substitutions that refer to an issue. Example: {{issue.key}} in the URL, body, headers.

Chained child actions

See the section "Chained actions".

User Guide